NOM
strsep - Extraction de mots d’une chaîne
SYNOPSIS
#include <string.h>
char *strsep(char **stringp, const char *dlim);
Exigences de macros de test de fonctionnalités pour la glibc (voir
feature_test_macros(7)) :
strsep() : _BSD_SOURCE
Si *stringp est NULL, la fonction strsep() renvoie NULL et ne fait rien
d’autre. Sinon, cette fonction prend le premier élément lexical (token)
dans la chaîne *stringp où les éléments sont séparés par les symboles
contenus dans dlim. Le mot renvoyé est terminé par un caractère nul
’\0´ (en écrasant le séparateur) et *stringp est mis à jour pour
pointer après le mot. Dans le cas où aucun séparateur n’est trouvé,
l’élément extrait est constitué de toute la chaîne *stringp, et
*stringp vaut NULL.
VALEUR RENVOYÉE
La fonction strsep() renvoie un pointeur sur l’élément lexical extrait,
c’est-à-dire la valeur originelle de *stringp.
CONFORMITÉ
4.4BSD.
NOTES
La fonction strsep() a été introduite en remplacement de strtok(3), qui
ne peut pas traiter les champs vides. Néanmoins, strtok(3) est conforme
à C89/C99 et est donc plus portable.
BOGUES
Faites attention quand vous utilisez cette fonction. Si vous
l’utilisez, prenez note des informations suivantes :
* Cette fonction modifie son premier argument.
* Cette fonction ne peut pas être utilisée avec des chaînes constantes.
* Cette fonction ne doit pas être invoquée sur une chaîne constante.
VOIR AUSSI
index(3), memchr(3), rindex(3), strchr(3), strpbrk(3), strspn(3),
strstr(3), strtok(3)
COLOPHON
Cette page fait partie de la publication 3.23 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
Cette page de manuel a été traduite et mise à jour par Christophe
Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Nicolas François
<nicolas.francois@centraliens.net> et l’équipe francophone de
traduction de Debian.
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> ».