1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" Traducida por Pedro Pablo Fbrega <pfabrega@arrakis.es>
.\" Esto es documentacin libre; puede redistribuirla y/o
.\" modificarla bajo los trminos de la Licencia Pblica General GNU
.\" publicada por la Free Software Foundation; bien la versin 2 de
.\" la Licencia o (a su eleccin) cualquier versin posterior.
.\"
.\" Referencias consultadas:
.\" cdigo fuente y manual de glibc-2 GNU
.\" referencia de la bibliote C Dinkumware http://www.dinkumware.com/
.\" Especificaciones Single Unix de OpenGroup http://www.UNIX-systems.org/onl
.\"
.\" Translation revised Wed Aug 2 2000 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH WCSTOK 3 "25 julio 1999" "GNU" "Manual del Programador Linux"
.SH NOMBRE
wcstok \- divide una cadena de caracteres anchos en tokens
.SH SYNOPSIS
.nf
.B #include <wchar.h>
.sp
.BI "wchar_t *wcstok (wchar_t *" wcs ", const wchar_t *" delim ", wchar_t **" ptr );
.fi
.SH DESCRIPCIN
La funcin \fBwcstok\fP es el equivalente de caracteres anchos de
la funcin \fBstrtok\fP, con el argumento aadido 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 ningn carcter ancho de \fIdelim\fP.
.PP
La bsqueda comienza en \fIwcs\fP, si \fIwcs\fP no es NULL, o en \fI*ptr\fP,
si \fIwcs\fP es NULL. Primero, cualquier carcter ancho delimitador se
salta, es decir, el puntero avanza ms all de cualquier carcter 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 ningn token y guarda un valor apropiado en \fI*ptr\fP.
As, las sucesivas llamadas a \fBwcstok\fP continuarn devolviendo
NULL. En otro caso, la funcin \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
carcter ancho que aparece en \fIdelim\fP por un carcter
L'\\0' y actualiza \fI*ptr\fP para que las sucesivas
llamadas continen buscando tras el final del token reconocido.
.SH "VALOR DEVUELTO"
La funcin \fBwcstok\fP devuelve a un puntero al siguiente token,
o NULL si no se encuentran ms token.
.SH NOTAS
La cadena de caracteres anchos original \fIwcs\fP
se modifica de forma destructiva durante la operacin.
.SH EJEMPLO
El siguiente cdigo realiza un bucle sobre los tokens
contenidos en una cadena de caracteres anchos.
.sp
.nf
wchar_t *wcs = ...;
wchar_t *token;
wchar_t *state;
for (token = wcstok(wcs, " \\t\\n", &state);
token != NULL;
token = wcstok(NULL, " \\t\\n", &state)) {
...
}
.fi
.SH "CONFORME A"
ISO/ANSI C, UNIX98
.SH "VASE TAMBIN"
.BR strtok "(3), " wcschr (3)
|
