NOMBRE

       wcstok - divide una cadena de caracteres anchos en tokens

BIBLIOTECA

       Biblioteca Estándar C (libc, -lc)

SINOPSIS

       #include <wchar.h>

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

DESCRIPCIÓN

       La función wcstok() es el equivalente de caracteres anchos de la función strtok(3), con el
       argumento añadido 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 ningún carácter ancho de 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 null wide character (L'\0'), and it updates
       *ptr so that subsequent calls will continue searching after the end of recognized token.

VALOR DEVUELTO

       La función wcstok() devuelve a un puntero al siguiente token, o NULL si no  se  encuentran
       más token.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

       ┌────────────────────────────────────────────────┬────────────────────┬───────────────────┐
       │Interfaz                                        │ Atributo           │ Valor             │
       ├────────────────────────────────────────────────┼────────────────────┼───────────────────┤
       │wcstok()                                        │ Seguridad del hilo │ Multi-hilo seguro │
       └────────────────────────────────────────────────┴────────────────────┴───────────────────┘

ESTÁNDARES

       POSIX.1-2001, POSIX.1-2008, C99.

NOTAS

       La  cadena  de  caracteres anchos original wcs se modifica de forma destructiva durante la
       operación.

EJEMPLOS

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

VÉASE TAMBIÉN

       strtok(3), wcschr(3)

TRADUCCIÓN

       La  traducción  al  español  de  esta página del manual fue creada por Pedro Pablo Fábrega
       <pfabrega@arrakis.es> y Juan Piernas <piernas@ditec.um.es>

       Esta traducción es documentación libre; lea  la  GNU  General  Public  License  Version  3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  o posterior con respecto a las condiciones de
       copyright.  No existe NINGUNA RESPONSABILIDAD.

       Si encuentra algún error en la traducción de esta  página  del  manual,  envíe  un  correo
       electrónico a ⟨debian-l10n-spanish@lists.debian.org⟩.