wcstok(3)

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
C11, POSIX.1-2008.

HISTORIAL
POSIX.1-2001, 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.