Split wide-character string into tokens.
A sequence of calls to this function breaks the wide-character string pointed to by pWs into a sequence of tokens, each of which is delimited by a wide-character code from the wide-character string pointed to by pDelimit. The tokens that are returned are the character strings between the delimitors pass in by pDelimit (which can be different on each call).
On Windows this function is NOT thread safe. On Unix each thread must have created their own CI18n object in order for the call to this function to be thread safe.
- Parameters
-
pWs | [ in ] Pointer to string to parse, a new parse is started when this is not null |
pDelimit | [ in ] Pointer to a string containing a list of delimitors |
pResult | [ out ] Pointer to the found token, NULL if no match found |
- Returns
Success | P6R::eOk | |
Failure | P6R::eNoMemory | Insufficient memory to make a copy of pWs. |
P6R::eFail | Unable to continue to parse string. |
P6R::eNotInitialized | A successful call to initialize was not made before this call. |