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.
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.65 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> ».