.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\" Modified Sat Jul 24 18:00:10 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Mon Jan 20 12:04:18 1997 by Andries Brouwer (aeb@cwi.nl)
.\" Modified Tue Jan 23 20:23:07 2001 by Andries Brouwer (aeb@cwi.nl)
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH strsep 3 "20 juillet 2023" "Pages du manuel de Linux 6.05.01" 
.SH NOM
strsep \- Extraction de séquence d'une chaîne
.SH BIBLIOTHÈQUE
Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP)
.SH SYNOPSIS
.nf
\fB#include <string.h>\fP
.PP
\fBchar *strsep(char **restrict \fP\fIstringp\fP\fB, const char *restrict \fP\fIdelim\fP\fB);\fP
.fi
.PP
.RS -4
Exigences de macros de test de fonctionnalités pour la glibc (consulter
\fBfeature_test_macros\fP(7))\ :
.RE
.PP
\fBstrsep\fP()\ :
.nf
    Depuis la glibc 2.19 :
        _DEFAULT_SOURCE
    glibc 2.19 et antérieures :
        _BSD_SOURCE
.fi
.SH DESCRIPTION
Si \fI*stringp\fP est NULL, la fonction \fBstrsep\fP() renvoie NULL et ne fait
rien d'autre. Dans le cas contraire, cette fonction recherche la première
séquence (token) de la chaîne \fI*stringp\fP qui est délimitée par l'un des
octets de la chaîne \fIdelim\fP. La séquence renvoyée est terminée en écrasant
le séparateur avec un octet NULL («\ \e0\ ») et \fI*stringp\fP est mis à jour
pour pointer après la séquence. Dans le cas où aucun séparateur n'est
trouvé, la séquence extraite est constituée de toute la chaîne \fI*stringp\fP,
et \fI*stringp\fP vaut NULL.
.SH "VALEUR RENVOYÉE"
La fonction \fBstrsep\fP() renvoie un pointeur sur la séquence, c'est\-à\-dire la
valeur originelle de \fI*stringp\fP.
.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
\fBstrsep\fP()
T}	Sécurité des threads	MT\-Safe
.TE
.sp 1
.SH STANDARDS
None.
.SH HISTORIQUE
4.4BSD.
.PP
La fonction \fBstrsep\fP() a été introduite en remplacement de \fBstrtok\fP(3),
qui ne peut pas traiter les champs vides. Néanmoins, \fBstrtok\fP(3) est
conforme à C89/C99 et est donc plus portable.
.SH BOGUES
Faites attention quand vous utilisez cette fonction. Si vous l'utilisez,
prenez note des informations suivantes\ :
.IP \- 3
Cette fonction modifie son premier argument.
.IP \-
Cette fonction ne peut pas être utilisée avec des chaînes constantes.
.IP \-
L’identité du caractère délimiteur est perdue.
.SH EXEMPLES
Le programme ci\-dessous est un portage d'un programme trouvé dans
\fBstrtok\fP(3), qui néanmoins n'adandonne pas délimiteurs multiples ou de
séquences vides\ :
.PP
.in +4n
.EX
$\fB ./a.out \[aq]a/bbb///cc;xxx:yyy:\[aq] \[aq]:;\[aq] \[aq]/\[aq]\fP
1: a/bbb///cc
         \-\-> a
         \-\-> bbb
         \-\->
         \-\->
         \-\-> cc
2: xxx
         \-\-> xxx
3: yyy
         \-\-> yyy
4:
         \-\->
.EE
.in
.SS "Source du programme"
.\" SRC BEGIN (strsep.c)
\&
.EX
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
\&
int
main(int argc, char *argv[])
{
    char *token, *subtoken;
\&
    if (argc != 4) {
        fprintf(stderr, "Usage: %s string delim subdelim\en", argv[0]);
        exit(EXIT_FAILURE);
    }
\&
    for (unsigned int j = 1; (token = strsep(&argv[1], argv[2])); j++) {
        printf("%u: %s\en", j, token);
\&
        while ((subtoken = strsep(&token, argv[3])))
            printf("\et \-\-> %s\en", subtoken);
    }
\&
    exit(EXIT_SUCCESS);
}
.EE
.\" SRC END
.SH "VOIR AUSSI"
\fBmemchr\fP(3), \fBstrchr\fP(3), \fBstring\fP(3), \fBstrpbrk\fP(3), \fBstrspn\fP(3),
\fBstrstr\fP(3), \fBstrtok\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>
et
Frédéric Hantrais <fhantrais@gmail.com>
.
.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 .