Provided by: manpages-fr-dev_3.17.1-1_all bug

NOM

       memchr,  memrchr,  rawmemchr  -  Rechercher  un caractère dans une zone
       mémoire.

SYNOPSIS

       #include <string.h>

       void *memchr(const void *s, int c, size_t n);

       void *memrchr(const void *s, int c, size_t n);

       void *rawmemchr(const void *s, int c);

   Exigences de  macros  de  test  de  fonctionnalités  pour  la  glibc  (voir
   feature_test_macros(7)) :

       rawmemchr() : _GNU_SOURCE

DESCRIPTION

       La  fonction  memchr() examine les n premiers octets de la zone mémoire
       pointée par  s  à  la  recherche  du  caractère  c.  Le  premier  octet
       correspondant   à   c   (interprété  comme  un  unsigned  char)  arrête
       l’opération.

       La fonction memrchr() travaille comme memchr(), sauf qu’elle  recherche
       en  arrière  depuis  la fin de la zone de n octets pointée par s plutôt
       que depuis le début.

       La  fonction  rawmemchr()  est  semblable  à  memchr() :  est   suppose
       (c’est-à-dire  le  développeur en est sûr) que le caractère c se trouve
       quelque part dans la chaîne s et fait ainsi une recherche optimisée  du
       caractère c (c’est-à-dire, pas de vérification de l’octet nul de fin ou
       d’un paramètre n pour limiter la  longueur  de  la  recherche).  Si  le
       caractère c ne se trouve pas dans la chaîne s, alors rawmemchr() pourra
       continuer en dehors de la chaîne et le  résultat  n’est  pas  spécifié.
       L’appel suivant est une manière rapide pour trouver le caractère nul de
       fin d’une chaîne :

           char *p = rawmemchr(s, '\0');

VALEUR RENVOYÉE

       Les fonctions memchr() et memrchr() renvoient un pointeur  sur  l’octet
       correspondant,  ou  NULL si le caractère n’est pas présent dans la zone
       de mémoire concernée.

       La fonction rawmemchr() renvoie un pointeur sur l’octet  correspondant,
       s’il  est  trouvé.  Si  aucun  caractère correspondant n’est trouvé, le
       résultat n’est pas spécifié.

VERSIONS

       rawmemchr() a été introduite dans la glibc dans sa version 2.1.

       memrchr() a été introduite dans la glibc dans sa version 2.2.

CONFORMITÉ

       La  fonction  memchr()  se  conforme  à  SVr4,  BSD 4.3,  C89,  C99  et
       POSIX.1-2001.

       La  fonction  memrchr()  est  une  extension  GNU  disponible depuis la
       glibc2.1.91.

       La fonction rawmemrchr() est une extension  GNU  disponible  depuis  la
       glibc 2.1.

VOIR AUSSI

       index(3),  rindex(3),  strchr(3),  strpbrk(3),  strrchr(3),  strsep(3),
       strspn(3), strstr(3), wmemchr(3)

COLOPHON

       Cette page fait partie de  la  publication  3.17  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 Florentin Duneau <fduneau@gmail.com> 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> ».

                                 11 août 2008                        MEMCHR(3)