strchr

Autres langues

Langue: fr

Version: 19 mai 2006 (mandriva - 01/05/08)

Autres sections - même nom

Section: 3 (Bibliothèques de fonctions)

NOM

strchr, strrchr, strchrnul - Rechercher un caractère dans une chaîne

SYNOPSIS

 #include <string.h>
 
 char *strchr (const char *s, int c);
 
 char *strrchr (const char *s, int c);
 
 #define _GNU_SOURCE
 #include <string.h>
 
 char *strchrnul(const char *s, int c);
 

DESCRIPTION

La fonction strchr() renvoie un pointeur sur la première occurrence du caractère c dans la chaîne s.

La fonction strrchr() renvoie un pointeur sur la dernière occurrence du caractère c dans la chaîne s.

La fonction strchrnul() est comme strchr() excepté que si c n'est pas trouvé dans s, elle renvoie un pointeur sur l'octet nul à la fin de s, plutôt que NULL.

Pour ces fonctions, « caractère » signifie « octet » ; elles ne marchent pas avec des caractères larges ou multi-octets.

VALEUR RENVOYÉE

Les fonctions strchr() et strrchr() renvoient un pointeur sur le caractère correspondant, ou NULL si le caractère n'a pas été trouvé.

La fonction strchrnul() renvoie un pointeur sur le caractère mis en correspondance, ou bien un pointeur sur l'octet nul de fin de s (c'est-à-dire, s+strlen(s)) si le caractère n'est pas trouvé.

CONFORMITÉ

strchr() et strrchr() sont dans SVr4, BSD 4.3, C89, C99. strchrnul() est une extension GNU.

VOIR AUSSI

index(3), memchr(3), rindex(3), strlen(3), strpbrk(3), strsep(3), strspn(3), strstr(3), strtok(3), wcschr(3), wcsrchr(3), feature_test_macros(7)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 9 novembre 1996 et révisée le 19 novembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 strchr ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.