STRCHR(3)

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 présentes dans SVr4, BSD 4.3, C89 et 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 17 juillet 2008.

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.