wcstok - divide una cadena de caracteres anchos en tokens
Biblioteca Estándar C (
libc,
-lc)
#include <wchar.h>
wchar_t *wcstok(wchar_t *restrict wcs, const wchar_t *restrict delim,
wchar_t **restrict ptr);
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.
La función
wcstok() devuelve a un puntero al siguiente token, o
NULL si no se encuentran más token.
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 |
POSIX.1-2001, POSIX.1-2008, C99.
La cadena de caracteres anchos original
wcs se modifica de forma
destructiva durante la operación.
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)) {
...
}
strtok(3),
wcschr(3)
La traducción al español de esta página del manual fue
creada por Pedro Pablo Fábrega <
[email protected]> y Juan
Piernas <
[email protected]>
Esta traducción es documentación libre; lea la
GNU
General Public License Version 3 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
[email protected]