Provided by: manpages-es_1.55-10_all bug

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)