strstr − Rechercher une sous-chaîne.

#include <string.h>

char *strstr (const char *meule_de_foin, const char *aiguille);

#define _GNU_SOURCE

#include <string.h>

char *strcasestr(const char *meule_de_foin, const char *aiguille);

La fonction strstr() cherche la première occurrence de la sous-chaîne aiguille au sein de la chaîne meule_de_foin. Les caractères « \0 » de fin ne sont pas comparés.

La fonction strcasestr() est la même que strstr(), sauf qu’elle ignore la case des deux arguments.

Ces fonctions renvoient un pointeur sur le début de la sous-chaîne, ou NULL si celle-ci n’est pas trouvée.

Des versions antérieures de la bibliothèque C de Linux, (4.5.26 par exemple) n’autorisent pas un argument aiguille vide pour strstr(). Des versions plus récentes (comme la 4.6.27) fonctionnent correctement, et renvoient meule_de_foin si la chaîne aiguille est vide.

La fonction strstr() est conforme à C89 et C99. La fonction strcasestr() est une extension non standard.

index(3), memchr(3), rindex(3), strcasecmp(3), strchr(3), strpbrk(3), strsep(3), strspn(3), strtok(3), wcsstr(3)

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 10 novembre 1996 et révisée le 14 août 2006.

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 strstr ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.