Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
wcstok(3)
Edit
PageHistory
Diff
Info
LikePages
WCSTOK !!!WCSTOK NAME SYNOPSIS DESCRIPTION RETURN VALUE NOTES EXAMPLE CONFORMING TO SEE ALSO ---- !!NAME wcstok - split wide-character string into tokens !!SYNOPSIS __#include __''wcs''__, const wchar_t *__''delim''__, wchar_t **__''ptr''__); __ !!DESCRIPTION The __wcstok__ function is the wide-character equivalent of the __strtok__ function, with an added argument to make it multithread-safe. It can be used to split a wide-character string ''wcs'' into tokens, where a token is defined as a substring not containing any wide-characters from ''delim''. The search starts at ''wcs'', if ''wcs'' is not NULL, or at ''*ptr'', if ''wcs'' is NULL. First, any delimiter wide-characters are skipped, i.e. the pointer is advanced beyond any wide-characters which occur in ''delim''. If the end of the wide-character string is now reached, __wcstok__ returns NULL, to indicate that no tokens were found, and stores an appropriate value in ''*ptr'', so that subsequent calls to __wcstok__ will continue to return NULL. Otherwise, the __wcstok__ function recognizes the beginning of a token and returns a pointer to it, but before doing that, it zero-terminates the token by replacing the next wide-character which occurs in ''delim'' with a L'0' character, and it updates ''*ptr'' so that subsequent calls will continue searching after the end of recognized token. !!RETURN VALUE The __wcstok__ function returns a pointer to the next token, or NULL if no further token was found. !!NOTES The original ''wcs'' wide-character string is destructively modified during the operation. !!EXAMPLE The following code loops over the tokens contained in a wide-character string. wchar_t *wcs = ...; wchar_t *token; wchar_t *state; for (token = wcstok(wcs, !!CONFORMING TO ISO/ANSI C, UNIX98 !!SEE ALSO strtok(3), wcschr(3) ----
One page links to
wcstok(3)
:
Man3w
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
