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   (consultez
   feature_test_macros(7)) :

       strsep() : _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

   Multithreading (voir pthreads(7))
       La fonction strsep() est sûre dans un contexte multithread.

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 3.65 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

       Depuis   2010,   cette   traduction   est   maintenue   à   l'aide   de    l'outil    po4a
       <http://po4a.alioth.debian.org/>  par l'équipe de traduction francophone au sein du projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe   Blaess   <http://www.blaess.fr/christophe/>   (1996-2003),    Alain    Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Nicolas  François  et  l'équipe francophone de
       traduction de Debian (2006-2009).

       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> ».