wcstok(3)                  Library Functions Manual                  wcstok(3)

NOM
       wcstok - Scinder en sequences une chaine de caracteres larges

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <wchar.h>

       wchar_t *wcstok(wchar_t *restrict wcs, const wchar_t *restrict delim,
                       wchar_t **restrict 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
       scinder la chaine de caracteres larges wcs en sequences definies 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'aucune sequence n'a ete trouvee, 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'une sequence et renvoie un pointeur dessus apres l'avoir
       fait suivre d'un caractere large nul (L'\0') (en remplacant le premier
       caractere large se trouvant dans delim). Elle met a jour le pointeur
       *ptr pour qu'un nouvel appel de wcstok() continue la recherche a la
       suite d'une sequence trouvee.

VALEUR RENVOYEE
       La fonction wcstok() renvoie un pointeur sur la sequence suivante ou
       NULL si aucune sequence n'a ete trouvee.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +---------------------------------+--------------------------+---------+
       |Interface                        | Attribut                 | Valeur  |
       +---------------------------------+--------------------------+---------+
       |wcstok()                         | Securite des threads     | MT-Safe |
       +---------------------------------+--------------------------+---------+
STANDARDS
       C11, POSIX.1-2008.

HISTORIQUE
       POSIX.1-2001, C99.

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

EXEMPLES
       Le code suivant parcourt les sequences (token) contenues 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)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org>, Jean-Baptiste Holcroft <jean-baptiste@holcroft.fr>
       et Gregoire Scano <gregoire.scano@malloc.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                      wcstok(3)