MBSRTOWCS(3) | NetBSD Library Functions Manual | MBSRTOWCS(3) |
size_t
mbsrtowcs(wchar_t * restrict pwcs, const char ** restrict s, size_t n, mbstate_t * restrict ps);
Each character will be converted as if mbrtowc(3) is continuously called.
After conversion, if pwcs is not a null pointer, the pointer object pointed to by s is a null pointer (if the conversion is stopped due to reaching a nul byte) or the first byte of the character just after the last character converted.
If pwcs is not a null pointer and the conversion is stopped due to reaching a nul byte, the mbsrtowcs() places the state object pointed to by ps to an initial state after the conversion has taken place.
The behaviour of mbsrtowcs() is affected by the LC_CTYPE category of the current locale.
These are the special cases:
Calling any other functions in Standard C Library (libc, -lc) never changes the internal state of mbsrtowcs(), which is initialized at startup time of the program.
February 4, 2002 | NetBSD 5.99 |