wcstok(3)                  Library Functions Manual                  wcstok(3)

NOMBRE
       wcstok - divide una cadena de caracteres anchos en tokens

BIBLIOTECA
       Biblioteca Estandar C (libc, -lc)

SINOPSIS
       #include <wchar.h>

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

DESCRIPCION
       La funcion wcstok() es el equivalente de caracteres anchos de la
       funcion strtok(3), 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.

       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 funcion wcstok() devuelve a un puntero al siguiente token, o NULL si
       no se encuentran mas token.

ATRIBUTOS
       Para obtener una explicacion de los terminos usados en esta seccion,
       vease attributes(7).

       +-----------------------------+--------------------+-------------------+
       |Interfaz                     | Atributo           | Valor             |
       +-----------------------------+--------------------+-------------------+
       |wcstok()                     | Seguridad del hilo | Multi-hilo seguro |
       +-----------------------------+--------------------+-------------------+
ESTANDARES
       C11, POSIX.1-2008.

HISTORIAL
       POSIX.1-2001, C99.

NOTAS
       La cadena de caracteres anchos original wcs se modifica de forma
       destructiva durante la operacion.

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

VEASE TAMBIEN
       strtok(3), wcschr(3)

TRADUCCION
       La traduccion al espanol de esta pagina del manual fue creada por Pedro
       Pablo Fabrega <pfabrega@arrakis.es> y Juan Piernas
       <piernas@ditec.um.es>

       Esta traduccion es documentacion 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 algun error en la traduccion de esta pagina del manual,
       envie un correo electronico a <debian-l10n-spanish@lists.debian.org>.

Paginas de manual de Linux 6.06 31 Octubre 2023                      wcstok(3)