Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       wcstok - Extraire des mots d'une chaine de caracteres larges

SYNOPSIS

       #include <wchar.h>

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

DESCRIPTION

       La  fonction wcstok() est l'equivalent pour les caracteres larges de la
       fonction strtok(3),  avec  un  argument  supplementaire  permettant  de
       l'employer  dans  un  contexte  multithread.  On  peut  l'utiliser pour
       decouper la chaine de caracteres larges  wcs  en  elements  syntaxiques
       (tokens),  definis  comme des sous-chaines ne contenant aucun caractere
       large contenu dans la chaine delim.

       La recherche demarre en wcs si wcs n'est pas NULL, ou en  *ptr  si  wcs
       est  NULL. D'abord tous les caracteres larges delimiteurs sont ignores,
       c'est-a-dire que le pointeur est place au-dela de tous  les  caracteres
       se  trouvant  dans delim. Si la fin de la chaine est atteinte, wcstok()
       renvoie NULL pour indiquer qu'aucun mot n'a ete trouve, et stocke  dans
       *ptr une valeur qui forcera les eventuels appels suivants de wcstok() a
       renvoyer NULL. Sinon, la fonction considere avoir atteint le debut d'un
       mot,  et  renvoie  un  pointeur dessus apres l'avoir fait suivre par un
       L'\0' (en remplacant le premier caractere se trouvant dans delim). Elle
       met  a  jour  le  pointeur  *ptr  pour  qu'un  nouvel appel de wcstok()
       continue la recherche a la suite du mot trouve.

VALEUR RENVOY'EE

       La fonction wcstok() renvoie un pointeur sur le mot suivant, ou NULL si
       aucun mot n'a ete trouve.

CONFORMIT'E

       C99.

NOTES

       La  chaine  de  caracteres larges wcs originale est modifiee de maniere
       destructrice durant l'operation.

EXEMPLE

       Le code suivant parcourt les mots contenus dans la chaine de caracteres
       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.27 du projet man-pages
       Linux. Une description du projet et des instructions pour signaler  des
       anomalies       peuvent       etre       trouvees      a      l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

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

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

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

       Vous  pouvez  toujours avoir acces a la version anglaise de ce document
       en utilisant la commande << man -L C <section> <page_de_man> >>.