wcstok man page on Scientific

Man page or keyword search:  
man Server   26626 pages
apropos Keyword Search (all sections)
Output format
Scientific logo
[printable version]

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

NAME
       wcstok - split wide-character string into tokens

SYNOPSIS
       #include <wchar.h>

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

DESCRIPTION
       The wcstok() function is the wide-character equivalent of the strtok(3)
       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, that  is,  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 recogā€
       nized token.

RETURN VALUE
       The wcstok() function returns a pointer to the next token, or  NULL  if
       no further token was found.

CONFORMING TO
       C99.

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

SEE ALSO
       strtok(3), wcschr(3)

COLOPHON
       This  page  is  part of release 3.22 of the Linux man-pages project.  A
       description of the project, and information about reporting  bugs,  can
       be found at http://www.kernel.org/doc/man-pages/.

GNU				  1999-07-25			     WCSTOK(3)
[top]

List of man pages available for Scientific

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net