Unix/Linux Go Back    

RedHat 9 (Linux i386) - man page for wcstok (redhat section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

WCSTOK(3)			    Linux Programmer's Manual				WCSTOK(3)

       wcstok - split wide-character string into tokens

       #include <wchar.h>

       wchar_t *wcstok(wchar_t *wcs, const wchar_t *delim, wchar_t **ptr);

       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-char-
       acters 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.

       The wcstok function returns a pointer to the next token, or NULL if no further  token  was

       The original wcs wide-character string is destructively modified during the operation.

       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, " \t\n", &state);
	    token != NULL;
	    token = wcstok(NULL, " \t\n", &state)) {

       ISO/ANSI C, UNIX98

       strtok(3), wcschr(3)

GNU					    1999-07-25					WCSTOK(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 07:44 PM.