WCSTOK(3)

NOMBRE
wcstok - divide una cadena de caracteres anchos en tokens

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.

La búsqueda comienza en wcs, si wcs no es NULL, o en *ptr, si wcs es NULL. Primero, cualquier carácter ancho delimitador se salta, es decir, el puntero avanza más allá de cualquier carácter 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 ningún token y guarda un valor apropiado en *ptr. Así, las sucesivas llamadas a wcstok continuarán devolviendo NULL. En otro caso, la función wcstok reconoce el comienzo de un token y devuelve un puntero a él, pero antes de hacerlo termina en cero el token reemplazando el siguiente carácter ancho que aparece en delim por un carácter (L'\0'), y actualiza *ptr para que las sucesivas llamadas continúen buscando tras el final del token reconocido.

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

CONFORME A
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)

COLOFÓN
Esta página es parte de la versión 5.13 del proyecto Linux man-pages. Puede encontrar una descripción del proyecto, información sobre cómo informar errores y la última versión de esta página en https://www.kernel.org/doc/man-pages/.

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>..