Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
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> >>.