Provided by:
manpages-es_1.55-10_all 
NOMBRE
wcstok - divide una cadena de caracteres anchos en tokens
SYNOPSIS
#include <wchar.h>
wchar_t *wcstok (wchar_t *wcs, const wchar_t *delim, wchar_t **ptr);
DESCRIPCI'ON
La funcion wcstok es el equivalente de caracteres anchos de la funcion
strtok, con el argumento anadido para hacerlo seguro en un entorno
multihilo. Se puede usar para dividir una cadena de caracteres anchos
wcs en tokens, donde un token se define como una subcadena que no
contenga ningun caracter ancho de delim.
La busqueda comienza en wcs, si wcs no es NULL, o en *ptr, si wcs es
NULL. Primero, cualquier caracter ancho delimitador se salta, es decir,
el puntero avanza mas alla de cualquier caracter ancho que aparezca en
delim. Si ahora se alcanza el final de la cadena de caracteres anchos,
wcstok devuelve NULL, para indicar que no se ha encontrado ningun token
y guarda un valor apropiado en *ptr. Asi, las sucesivas llamadas a
wcstok continuaran devolviendo NULL. En otro caso, la funcion wcstok
reconoce el comienzo de un token y devuelve un puntero a el, pero antes
de hacerlo termina en cero el token reemplazando el siguiente caracter
ancho que aparece en delim por un caracter L'\0' y actualiza *ptr para
que las sucesivas llamadas continuen buscando tras el final del token
reconocido.
VALOR DEVUELTO
La funcion wcstok devuelve a un puntero al siguiente token, o NULL si
no se encuentran mas token.
OBSERVACIONES
La cadena de caracteres anchos original wcs se modifica de forma
destructiva durante la operacion.
EJEMPLO
El siguiente codigo realiza un bucle sobre los tokens contenidos en una
cadena de caracteres anchos.
wchar_t *wcs = ...;
wchar_t *token;
wchar_t *state;
for (token = wcstok(wcs, " \t\n", &state);
token != NULL;
token = wcstok(NULL, " \t\n", &state)) {
...
}
CONFORME A
ISO/ANSI C, UNIX98
V'EASE TAMBI'EN
strtok(3), wcschr(3)