wcstok, wcstok_s

wchar_t* wcstok( wchar_t* str, const wchar_t* delim, wchar_t** ptr );

wchar_t* wcstok( wchar_t*  restrict str, const wchar_t* restrict delim,
                 wchar_t** restrict ptr );

wchar_t* wcstok_s( wchar_t* restrict str, rsize_t* restrict strmax,
                   const wchar_t* restrict delim, wchar_t** restrict ptr);

• Si str != NULL n'est pas nul, 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 du tout, et la fonction renvoie un pointeur nul.
• Si un tel caractère large est trouvé, c'est 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 n'a qu'un seul jeton, et les appels futurs à wcstok renverront 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 renvoie alors le pointeur vers le début du jeton

• Si str == NULL est nul, l'appel est traité comme un appel ultérieur à wcstok : la fonction continue là où elle s'est 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

Renvoie 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 caractères L'\0' 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 dans l'emplacement fourni par l'utilisateur.

Contrairement à la plupart des autres tokeniseurs, les délimiteurs dans wcstok peuvent être différents pour chaque jeton suivant, et peuvent même dépendre du contenu des jetons précédents.

L'implémentation de wcstok_s dans le CRT de Windows est incompatible avec la norme C, ce n'est qu'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