Loading

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

       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() :  elle  suppose
       (c’est-à-dire  que  le  développeur  en  est sûr) que le caractère c se
       trouve 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()
       pourrait continuer la recherche  après  la  fin  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 rawmemchr() est une  extension  GNU  disponible  depuis  la
       glibc2.1.

VOIR AUSSI

       ffs(3),   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.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 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> ».

                                 21 avril 2009                       MEMCHR(3)