NOM
strsep - Extraction de mots d’une chaîne
SYNOPSIS
#include <string.h>
char *strsep(char **stringp, const char *délim);
Exigences de macros de test de fonctionnalités pour la glibc (consulter feature_test_macros(7)) :
strsep():
Since glibc 2.19:
_DEFAULT_SOURCE
Glibc 2.19 and earlier:
_BSD_SOURCE
DESCRIPTION
Si *stringp est NULL, la fonction strsep() renvoie NULL et ne fait rien d’autre. Dans le cas contraire, cette fonction recherche le premier élément lexical (token) de la chaîne *stringp qui est délimité par l’un des octets de la chaîne delim. Le mot renvoyé est terminé en écrasant le séparateur avec un octet nul (« \0 ») 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.
ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter attributes(7).
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), string(3), strpbrk(3), strspn(3), strstr(3), strtok(3)
COLOPHON
Cette page fait partie de la publication 5.07 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies et la dernière version de cette page, peuvent être trouvées à l’adresse https://www.kernel.org/doc/man-pages/.
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 [AT] laposte.net>, Thierry Vignaud <tvignaud [AT] mandriva.com>, François Micaux, Alain Portal <aportal [AT] univ-montp2.fr>, Jean-Philippe Guérard <fevrier [AT] tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon [AT] wanadoo.fr>, Julien Cristau <jcristau [AT] debian.org>, Thomas Huriaux <thomas.huriaux [AT] gmail.com>, Nicolas François <nicolas.francois [AT] centraliens.net>, Florentin Duneau <fduneau [AT] gmail.com>, Simon Paillard <simon.paillard [AT] resel.fr>, Denis Barbier <barbier [AT] debian.org>, David Prévot <david [AT] tilapin.org> et Frédéric Hantrais <fhantrais [AT] gmail.com>
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n’y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à <debian-l10n-french [AT] lists.org>.