mblen(3int) 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 function determines the number of bytes comprising the multibyte character pointed to by s. The 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 function returns a zero value. If s is not a null pointer, the function returns:
o 0 (if s points to the null character)
o The number of bytes that comprise the multibyte character (if the next n or fewer bytes form a valid multibyte character)
o
-1 (if they do not form a valid multibyte character)
See Also
mbtowc(3int), mbstowcs(3int), setlocale(3int), wctomb(3int), wcstombs(3int)
mblen(3int)
