Convert a multibyte-character string into a wide-character string (restartable)
#include <wchar.h> size_t mbsrtowcs( wchar_t * dst, const char ** src, size_t n, mbstate_t * ps );
- A pointer to a buffer where the function can store the wide-character string.
- The string of multibyte characters that you want to convert.
- The maximum number of wide characters to store in the buffer that dst points to.
- An internal pointer that lets mbsrtowcs() be a restartable
if ps is NULL, mbsrtowcs() uses its
own internal variable.
You can call mbsinit() to determine the status of this variable.
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The mbsrtowcs() function converts a string of multibyte characters pointed to by src into the corresponding wide characters pointed to by dst, to a maximum of n wide characters, including the terminating NULL character.
The function converts each character as if by a call to mbtowc() and stops early if:
- a sequence of bytes doesn't conform to a valid character
- converting the next character would exceed the limit of n wide characters
This function is affected by LC_TYPE.
- Failure; invalid wide-character code.
- Success; the number of total characters successfully converted, not including the terminating NULL character.
- Invalid character sequence.
- The ps argument points to an invalid object.