strtok, strtok_s

Tokeniza una cadena de bytes terminada en nulo.

1. ↑ Aún puede formarse un token en una llamada posterior con una cadena separadora diferente.
2. ↑ No se pueden formar más tokens en llamadas posteriores.

Parámetros

Valor de retorno

Nota

Esta función es destructiva: escribe los caracteres ' \0 ' en los elementos de la cadena str . En particular, un literal de cadena no puede usarse como primer argumento de strtok .

Cada llamada a strtok modifica una variable estática: no es seguro para hilos.

A diferencia de la mayoría de otros tokenizadores, los delimitadores en strtok pueden ser diferentes para cada token subsiguiente, e incluso pueden depender del contenido de los tokens anteriores.

La función strtok_s difiere de la función POSIX strtok_r al protegerse contra el almacenamiento fuera de la cadena que se está tokenizando, y al verificar restricciones de tiempo de ejecución. La firma de Microsoft CRT strtok_s coincide con esta definición POSIX strtok_r , no con la de C11 strtok_s .

Ejemplo

#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <string.h>
int main(void)
{
    char input[] = "A bird came down the walk";
    printf("Parsing the input string '%s'\n", input);
    char* token = strtok(input, " ");
    while (token)
    {
        puts(token);
        token = strtok(NULL, " ");
    }
    printf("Contents of the input string now: '");
    for (size_t n = 0; n < sizeof input; ++n)
        input[n] ? putchar(input[n]) : fputs("\\0", stdout);
    puts("'");
#ifdef __STDC_LIB_EXT1__
    char str[] = "A bird came down the walk";
    rsize_t strmax = sizeof str;
    const char* delim = " ";
    char* next_token;
    printf("Parsing the input string '%s'\n", str);
    token = strtok_s(str, &strmax, delim, &next_token);
    while (token)
    {
        puts(token);
        token = strtok_s(NULL, &strmax, delim, &next_token);
    }
    printf("Contents of the input string now: '");
    for (size_t n = 0; n < sizeof str; ++n)
        str[n] ? putchar(str[n]) : fputs("\\0", stdout);
    puts("'");
#endif
}

Parsing the input string 'A bird came down the walk'
A
bird
came
down
the
walk
Contents of the input string now: 'A\0bird\0came\0down\0the\0walk\0'
Parsing the input string 'A bird came down the walk'
A
bird
came
down
the
walk
Contents of the input string now: 'A\0bird\0came\0down\0the\0walk\0'

Referencias

Véase también