mblen(3int)

Name

mblen − determines the number of bytes comprising a multibyte character

Syntax

#include <stdlib.h>

int mblen (s, n)
const char *s;
size_t n;

Arguments

s The s argument is a pointer to the multibyte character string.

n The n argument is the maximum number of bytes in s that are examined.

Description

If s is not a null pointer, the mblen function determines the number of bytes comprising the multibyte character pointed to by s. The mblen function is equivalent to:

(mbtowc((wchar_t *)0, s, n);)

This function is affected by the LC_CTYPE category of the current locale.

Return Values

If s is a null pointer, the mblen function returns a zero value. If s is not a null pointer, the mblen function returns:

•0 (if s points to the null character)

•The number of bytes that comprise the multibyte character (if the next n or fewer bytes form a valid multibyte character)

•
-1 (if they do not form a valid multibyte character)

Museum