Provided by:
manpages-es_1.55-9_all 
NOMBRE
strtok, strtok_r - extraen un token de una cadena
SINOPSIS
#include <string.h>
char *strtok(char *s, const char *delim);
char *strtok_r(char *s, const char *delim, char **ptrptr);
DESCRIPCIÓN
Un ‘token’ es una cadena de caracteres no vacía que no está en la
cadena delim, seguida por \0 o por un caracter que está en delim.
La función strtok() puede usarse para analizar (parse) la cadena s en
tokens. La primera llamada a strtok() debería tener s como primer
argumento. Llamadas subsiguientes deberían tener el primer argumento
puesto a NULL. Cada llamada devuelve un puntero al siguiente token, o
NULL cuando no se pueden encontrar más tokens.
Si un token termina con un delimitador, este caracter de delimitación
es sobreescrito con un \0 y se guarda un puntero al siguiente caracter
para la siguiente llamada a strtok(). La cadena de delimitación delim
puede ser diferente para cada llamada.
La función strtok_r() es una versión reentrante de la función strtok()
, que en lugar de usar su propio buffer estático, requiere uno
previamente reservado por el usuario. Este puntero, el parámetro ptrptr
, debe ser el mismo mientras se analiza la misma línea.
FALLOS
Nunca use estas funciones. Si lo hace, tenga en cuenta que:
Estas funciones modifican su primer argumento.
Estas funciones no pueden ser usadas con constantes de cadena.
La identidad del carácter delimitador se pierde.
La función strtok() usa un buffer estático mientras analiza la
línea, por lo que no es hilo-seguro. Use strtok_r() si este
asunto le preocupa.
VALOR DEVUELTO
La función strtok() devuelve un puntero al siguiente token, o NULL si
no hay más tokens.
CONFORME A
strtok()
SVID 3, POSIX, BSD 4.3, ISO 9899
strtok_r()
POSIX.1c
VÉASE TAMBIÉN
index(3), memchr(3), rindex(3), strchr(3), strpbrk(3), strsep(3),
strspn(3), strstr(3)