wcstok, wcstok_s

• Si str ! = NULL , l'appel est traité comme le premier appel à wcstok pour cette chaîne large particulière. La fonction recherche le premier caractère large qui n'est pas contenu dans delim .

• Si aucun caractère large de ce type n'est trouvé, il n'y a aucun jeton dans str , et la fonction retourne un pointeur nul.
• Si un tel caractère large est trouvé, il constitue le début du jeton . La fonction recherche ensuite à partir de ce point le premier caractère large qui est contenu dans delim .

• Si aucun caractère large de ce type n'est trouvé, str ne contient qu'un seul jeton, et les appels futurs à wcstok retourneront un pointeur nul.
• Si un tel caractère large est trouvé, il est remplacé par le caractère large nul L ' \0 ' et l'état de l'analyseur (généralement un pointeur vers le caractère large suivant) est stocké dans l'emplacement fourni par l'utilisateur * ptr .

• La fonction retourne ensuite le pointeur vers le début du jeton.

• Si str == NULL , l'appel est traité comme un appel subséquent à wcstok : la fonction continue là où elle s'était arrêtée lors de l'invocation précédente avec le même * ptr . Le comportement est le même que si le pointeur vers le caractère large qui suit le dernier jeton détecté est passé comme str .

Paramètres

Valeur de retour

Retourne un pointeur vers le début du jeton suivant ou un pointeur nul s'il n'y a plus de jetons.

Note

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

Contrairement à strtok , wcstok ne met pas à jour le stockage statique : il stocke l'état de l'analyseur à l'emplacement fourni par l'utilisateur.

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

L'implémentation de wcstok_s dans le Windows CRT n'est pas conforme à la norme C, il s'agit simplement d'un alias pour wcstok .

Exemple

#include <stdio.h>
#include <wchar.h>
int main(void)
{
    wchar_t input[] = L"A bird came down the walk";
    printf("Parsing the input string '%ls'\n", input);
    wchar_t* buffer;
    wchar_t* token = wcstok(input, L" ", &buffer);
    while (token)
    {
        printf("%ls\n", token);
        token = wcstok(NULL, L" ", &buffer);
    }
    printf("Contents of the input string now: '");
    for (size_t n = 0; n < sizeof input / sizeof *input; ++n)
        input[n] ? printf("%lc", input[n]) : printf("\\0");
    puts("'");
}

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