.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH wcstok 3 "15 juin 2024" "Pages du manuel de Linux 6.9.1" 
.SH NOM
wcstok \- Scinder en séquences une chaîne de caractères larges
.SH BIBLIOTHÈQUE
Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP)
.SH SYNOPSIS
.nf
\fB#include <wchar.h>\fP
.P
\fBwchar_t *wcstok(wchar_t *restrict \fP\fIwcs\fP\fB, const wchar_t *restrict \fP\fIdelim\fP\fB,\fP
\fB                wchar_t **restrict \fP\fIptr\fP\fB);\fP
.fi
.SH DESCRIPTION
La fonction \fBwcstok\fP() est l'équivalent pour les caractères larges de la
fonction \fBstrtok\fP(3), avec un argument supplémentaire permettant de
l'employer dans un contexte multithread. On peut l'utiliser pour scinder la
chaîne de caractères larges \fIwcs\fP en séquences définies comme des
sous\-chaînes ne contenant aucun caractère large contenu dans la chaîne
\fIdelim\fP.
.P
The search starts at \fIwcs\fP, if \fIwcs\fP is not NULL, or at \fI*ptr\fP, if \fIwcs\fP
is NULL.  First, any delimiter wide\-characters are skipped, that is, the
pointer is advanced beyond any wide\-characters which occur in \fIdelim\fP.  If
the end of the wide\-character string is now reached, \fBwcstok\fP()  returns
NULL, to indicate that no tokens were found, and stores an appropriate value
in \fI*ptr\fP, so that subsequent calls to \fBwcstok\fP()  will continue to return
NULL.  Otherwise, the \fBwcstok\fP()  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 \fIdelim\fP with
a null wide character (L\[aq]\[rs]0\[aq]), and it updates \fI*ptr\fP so that
subsequent calls will continue searching after the end of recognized token.
.SH "VALEUR RENVOYÉE"
La fonction \fBwcstok\fP() renvoie un pointeur sur la séquence suivante ou NULL
si aucune séquence n'a été trouvée.
.SH ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interface	Attribut	Valeur
T{
.na
.nh
\fBwcstok\fP()
T}	Sécurité des threads	MT\-Safe
.TE
.SH STANDARDS
C11, POSIX.1\-2008.
.SH HISTORIQUE
POSIX.1\-2001, C99.
.SH NOTES
La chaîne de caractères larges \fIwcs\fP originale est modifiée de manière
destructrice durant l'opération.
.SH EXEMPLES
Le code suivant parcourt les séquences (token) contenues dans la chaîne de
caractères larges.
.P
.EX
wchar_t *wcs = ...;
wchar_t *token;
wchar_t *state;
for (token = wcstok(wcs, L" \[rs]t\[rs]n", &state);
    token != NULL;
    token = wcstok(NULL, L" \[rs]t\[rs]n", &state)) {
    ...
}
.EE
.SH "VOIR AUSSI"
\fBstrtok\fP(3), \fBwcschr\fP(3)
.PP
.SH TRADUCTION
La traduction française de cette page de manuel a été créée par
Christophe Blaess <https://www.blaess.fr/christophe/>,
Stéphan Rafin <stephan.rafin@laposte.net>,
Thierry Vignaud <tvignaud@mandriva.com>,
François Micaux,
Alain Portal <aportal@univ-montp2.fr>,
Jean-Philippe Guérard <fevrier@tigreraye.org>,
Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>,
Julien Cristau <jcristau@debian.org>,
Thomas Huriaux <thomas.huriaux@gmail.com>,
Nicolas François <nicolas.francois@centraliens.net>,
Florentin Duneau <fduneau@gmail.com>,
Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,
Denis Barbier <barbier@debian.org>,
David Prévot <david@tilapin.org>,
Jean-Baptiste Holcroft <jean-baptiste@holcroft.fr>
et
Grégoire Scano <gregoire.scano@malloc.fr>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .