Convert a character string to a wide-character string (restartable)
This function converts a sequence of characters beginning in the conversion state described by the pMbs from the buffer indirectly pointed to by pSrc into a wide character string. If pMbs is NULL, then this function uses its own internal mbstate_t object, which is initialised at program startup to the initial conversion state.
- Parameters
-
pDst | [ out ] Pointer to the buffer to write the resulting wide character string. |
dstSize | [ in ] Maximum number of wide characters to place in pDst. |
pSrc | [ in ] Pointer to a pointer to multibyte character string to convert. If the conversion is successful, then this pointer is modified to the address just past the last character converted (if any). |
pMbs | [ in ] Pointer to object set up by a call to mbsinit(). |
pResultSize | [ out ] If function is successful, then this parameter is assigned the number of multibyte characters successfully converted, not including the terminating null character. |
- Returns
Success | P6R::eOk | |
Failure | P6R::eFail | Unable to perform the conversion. |
P6R::eNotInitialized | A successful call to initialize was not made before this call. |