Provided by: manpages-fr_1.67.0-1_all bug

NOM

       wcstok - Extraire des mots d’une chaîne de caractères larges.

SYNOPSIS

       #include <wchar.h>

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

DESCRIPTION

       La  fonction  wcstok  est l’équivalent pour les caractères larges de la
       fonction  strtok,  avec  un  argument  supplémentaire   permettant   de
       l’employer  dans  un  contexte  multithreads.   On peut l’utiliser pour
       découper la chaîne de caractères larges  wcs  en  éléments  syntaxiques
       (tokens),  définis  comme  des sous-chaîne ne contenant aucun caractère
       large contenu dans la chaîne delim.

       La recherche démarre en wcs, si wcs n’est pas NULL, ou en *ptr  si  wcs
       est NULL.  D’abord tous les caractères larges délimiteurs sont ignorés,
       c’est à dire que le pointeur est placé au-delà de tous  les  caractères
       se  trouvant  dans  delim.  Si la fin de la chaîne est atteinte, wcstok
       renvoie NULL pour indiquer qu’aucun mot n’a été trouvé, et stocke  dans
       *ptr  une  valeur qui forcera les éventuels appels suivants de wcstok à
       renvoyer NULL.  Sinon, la fonction considère  avoir  atteint  le  début
       d’un  mot,  et renvoie un pointeur dessus après l’avoir fait suivre par
       un L’\0’ (en remplaçant le premier caractère se trouvant  dans  delim).
       Elle  met  à  jour  le  pointeur *ptr pour qu’un nouvel appel de wcstok
       continue la recherche à la suite du mot trouvé.

VALEUR RENVOYÉE

       La fonction wcstok renvoie un pointeur sur le mot suivant, ou  NULL  si
       aucun mot n’a été trouvé.

NOTES

       La  chaîne  de  caractères larges wcs originale est modifiée de manière
       destructrice durant l’opération.

EXEMPLE

       Le code suivant parcourt les mots contenus dans la chaîne de caractères
       larges.

       wchar_t * wcs = ...;
       wchar_t * token;
       wchar_t * etat;
       for (token = wcstok (wcs, " \t\n", & etat);
            token != NULL;
            token = wcstok (NULL, " \t\n", & etat)) {
         ...
       }

CONFORMITÉ

       ISO/ANSI C, UNIX98

VOIR AUSSI

       strtok(3), wcschr(3)

TRADUCTION

       Christophe Blaess, 2000-2003.