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.

       The search starts at wcs, if wcs is not NULL, or at *ptr, if wcs is
       NULL.  First, any delimiter wide-characters are skipped, that is, the
       pointer is advanced beyond any wide-characters which occur in delim.
       If the end of the wide-character string is now reached, wcstok()
       returns NULL, to indicate that no tokens were found, and stores an
       appropriate value in *ptr, so that subsequent calls to wcstok()  will
       continue to return NULL.  Otherwise, the wcstok()  function recognizes
       the beginning of a token and returns a pointer to it, but before doing
       that, it zero-terminates the token by replacing the next wide-character
       which occurs in delim with a null wide character (L'\0'), and it
       updates *ptr so that subsequent calls will continue searching after the
       end of recognized token.

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 *state;
       for (token = wcstok(wcs, L" \t\n", &state);
           token != NULL;
           token = wcstok(NULL, L" \t\n", &state)) {
           ...
       }

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.9.1   15 juin 2024                        wcstok(3)