MBRLEN(3) | Library Functions Manual | MBRLEN(3) |
mbrlen
, mbrlen_l
— get number of bytes in a character
(restartable)
Standard C Library (libc, -lc)
#include
<wchar.h>
size_t
mbrlen
(const char *restrict s,
size_t n, mbstate_t *restrict
ps);
#include <wchar.h>
#include <xlocale.h>
size_t
mbrlen_l
(const char *restrict s,
size_t n, mbstate_t *restrict
ps, locale_t loc);
The
mbrlen
()
function inspects at most n bytes, pointed to by
s, to determine the number of bytes needed to complete
the next multibyte character.
The mbstate_t argument,
ps, is used to keep track of the shift state. If it is
NULL
,
mbrlen
()
uses an internal, static mbstate_t object, which is
initialized to the initial conversion state at program startup.
It is equivalent to:
mbrtowc(NULL, s, n, ps);
Except that, when ps is a
NULL
pointer,
mbrlen
()
uses its own static, internal mbstate_t object to keep
track of the shift state.
Although the
mbrlen
()
function uses the current locale, the
mbrlen_l
()
function may be passed a locale directly. See
xlocale(3) for more information.
The mbrlen
() functions returns:
L'\0'
).mbrlen
() returns the number of bytes
used to complete the multibyte character.A function that calculates the number of characters in a multibyte character string:
size_t nchars(const char *s) { size_t charlen, chars; mbstate_t mbs; chars = 0; memset(&mbs, 0, sizeof(mbs)); while ((charlen = mbrlen(s, MB_CUR_MAX, &mbs)) != 0 && charlen != (size_t)-1 && charlen != (size_t)-2) { s += charlen; chars++; } return (chars); }
The mbrlen
() function will fail if:
The mbrlen
() function conforms to
ISO/IEC 9899:1999
(“ISO C99”).
April 7, 2004 | macOS 14.6 |