strtok, strtok_s

Tokenise une chaîne d'octets terminée par un caractère nul.

1. ↑ Un jeton peut encore être formé lors d'un appel ultérieur avec une chaîne de séparation différente.
2. ↑ Aucun autre jeton ne peut être formé lors des appels ultérieurs.

Paramètres

Valeur de retour

Note

Cette fonction est destructive : elle écrit les caractères ' \0 ' dans les éléments de la chaîne str . En particulier, un littéral de chaîne ne peut pas être utilisé comme premier argument de strtok .

Chaque appel à strtok modifie une variable statique : n'est pas thread-safe.

Contrairement à la plupart des autres tokenizers, les délimiteurs dans strtok peuvent être différents pour chaque token subséquent, et peuvent même dépendre du contenu des tokens précédents.

La fonction strtok_s diffère de la fonction POSIX strtok_r en se protégeant contre le stockage en dehors de la chaîne en cours de tokenisation, et en vérifiant les contraintes d'exécution. La signature CRT Microsoft strtok_s correspond à cette définition POSIX strtok_r , et non à celle du C11 strtok_s .

Exemple

#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'

Références

Voir aussi