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(3), avec un
       argument supplémentaire permettant de l'employer dans un contexte multithread. 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înes 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 caractère large nul (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é.

ATTRIBUTS

   Multithreading (voir pthreads(7))
       La fonction wcstok() est sûre dans un contexte multithread.

CONFORMITÉ

       C99.

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)) {
           ...
       }

VOIR AUSSI

       strtok(3), wcschr(3)

COLOPHON

       Cette page fait partie de la publication 3.57 du projet man-pages Linux. Une description du projet et des
       instructions    pour    signaler    des    anomalies    peuvent     être     trouvées     à     l'adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Christophe       Blaess       <http://www.blaess.fr/christophe/>      (1996-2003),      Alain      Portal
       <http://manpagesfr.free.fr/> (2003-2006). Nicolas François  et  l'équipe  francophone  de  traduction  de
       Debian (2006-2009).

       Veuillez  signaler  toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par
       un rapport de bogue sur le paquet manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
       <section> <page_de_man> ».

GNU                                             18 novembre 2013                                       WCSTOK(3)