.\" -*- coding: UTF-8 -*-
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\" %%%LICENSE_END
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH WCSTOK 3 "9 Junio 2020" GNU "Manual del Programador de Linux"
.SH NOMBRE
wcstok \- divide una cadena de caracteres anchos en tokens
.SH SINOPSIS
.nf
\fB#include <wchar.h>\fP
.PP
\fBwchar_t *wcstok(wchar_t *\fP\fIwcs\fP\fB, const wchar_t *\fP\fIdelim\fP\fB, wchar_t **\fP\fIptr\fP\fB);\fP
.fi
.SH DESCRIPCIÓN
La función \fBwcstok\fP() es el equivalente de caracteres anchos de la función
\fBstrtok\fP(3), con el argumento añadido para hacerlo seguro en un entorno
multihilo. Se puede usar para dividir una cadena de caracteres anchos \fIwcs\fP
en tokens, donde un token se define como una subcadena que no contenga
ningún carácter ancho de \fIdelim\fP.
.PP
La búsqueda comienza en \fIwcs\fP, si \fIwcs\fP no es NULL, o en \fI*ptr\fP, si
\fIwcs\fP 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 \fIdelim\fP.  Si ahora se alcanza el final de la cadena de caracteres
anchos, \fBwcstok\fP devuelve NULL, para indicar que no se ha encontrado ningún
token y guarda un valor apropiado en \fI*ptr\fP.  Así, las sucesivas llamadas a
\fBwcstok\fP continuarán devolviendo NULL. En otro caso, la función \fBwcstok\fP
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 \fIdelim\fP por un carácter (L\(aq\e0\(aq), y actualiza \fI*ptr\fP
para que las sucesivas llamadas continúen buscando tras el final del token
reconocido.
.SH "VALOR DEVUELTO"
La función \fBwcstok\fP() devuelve a un puntero al siguiente token, o NULL si
no se encuentran más token.
.SH ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase
\fBattributes\fP(7).
.TS
allbox;
lb lb lb
l l l.
Interfaz	Atributo	Valor
T{
\fBwcstok\fP()
T}	Seguridad del hilo	Multi\-hilo seguro
.TE
.SH "CONFORME A"
POSIX.1\-2001, POSIX.1\-2008, C99.
.SH NOTAS
La cadena de caracteres anchos original \fIwcs\fP se modifica de forma
destructiva durante la operación.
.SH EJEMPLOS
El siguiente código realiza un bucle sobre los tokens contenidos en una
cadena de caracteres anchos.
.PP
.EX
wchar_t *wcs = ...;
wchar_t *token;
wchar_t *state;
for (token = wcstok(wcs, " \et\en", &state);
    token != NULL;
    token = wcstok(NULL, " \et\en", &state)) {
    ...
}
.EE
.SH "VÉASE TAMBIÉN"
\fBstrtok\fP(3), \fBwcschr\fP(3)
.SH COLOFÓN
Esta página es parte de la versión 5.10 del proyecto Linux
\fIman\-pages\fP. 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/.
.PP
.SH 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>
.
.PP
Esta traducción es documentación libre; lea la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
o posterior con respecto a las condiciones de copyright.
No existe NINGUNA RESPONSABILIDAD.
.PP
Si encuentra algún error en la traducción de esta página del manual, envíe un
correo electrónico a
.MT debian-l10n-spanish@lists.debian.org
.ME .