Provided by: manpages-es_1.55-10_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'ON

       Un  `token'  es  una  cadena  de  caracteres no vacia que no esta en la
       cadena delim, seguida por \0 o por un caracter que esta en delim.

       La funcion strtok() puede usarse para analizar (parse) la cadena  s  en
       tokens.  La  primera  llamada  a  strtok()  deberia tener s como primer
       argumento. Llamadas subsiguientes deberian tener  el  primer  argumento
       puesto  a  NULL. Cada llamada devuelve un puntero al siguiente token, o
       NULL cuando no se pueden encontrar mas tokens.

       Si un token termina con un delimitador, este caracter  de  delimitacion
       es  sobreescrito con un \0 y se guarda un puntero al siguiente caracter
       para la siguiente llamada a strtok(). La cadena de  delimitacion  delim
       puede ser diferente para cada llamada.

       La  funcion strtok_r() es una version reentrante de la funcion strtok()
       , que en  lugar  de  usar  su  propio  buffer  estatico,  requiere  uno
       previamente reservado por el usuario. Este puntero, el parametro ptrptr
       , debe ser el mismo mientras se analiza la misma linea.

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 caracter delimitador se pierde.

              La funcion strtok() usa un buffer estatico mientras  analiza  la
              linea,  por  lo  que  no  es hilo-seguro. Use strtok_r() si este
              asunto le preocupa.

VALOR DEVUELTO

       La funcion strtok() devuelve un puntero al siguiente token, o  NULL  si
       no hay mas tokens.

CONFORME A

       strtok()
              SVID 3, POSIX, BSD 4.3, ISO 9899

       strtok_r()
              POSIX.1c

V'EASE TAMBI'EN

       index(3),   memchr(3),  rindex(3),  strchr(3),  strpbrk(3),  strsep(3),
       strspn(3), strstr(3)