MBRTOWC(3) | Library Functions Manual | MBRTOWC(3) |
size_t
mbrtowc(wchar_t * restrict pwc, const char * restrict s, size_t n, mbstate_t * restrict ps);
If s points to a valid character and the character corresponds to a nul wide character, then the mbrtowc() places the mbstate_t object pointed to by ps to an initial conversion state.
Unlike mbtowc(3), the mbrtowc() may accept the byte sequence pointed to by s not forming a complete multibyte character but which may be part of a valid character. In this case, this function will accept all such bytes and save them into the conversion state object pointed to by ps. They will be used at subsequent calls of this function to restart the conversion suspended.
The behaviour of mbrtowc() is affected by the LC_CTYPE category of the current locale.
These are the special cases:
In this case, mbrtowc() ignores pwc and n, and is equivalent to the following call:
mbrtowc(NULL, "", 1, ps);
Calling any other functions in Standard C Library (libc, -lc) never changes the internal state of mbrtowc(), which is initialized at startup time of the program.
February 4, 2002 | NetBSD 6.1 |