Provided by: manpages-es_1.55-3_all bug

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)