STRSTR(3)

NOM
strstr, strcasestr - Rechercher une sous-chaîne

SYNOPSIS
#include <string.h>

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

#define _GNU_SOURCE         /* Consultez feature_test_macros(7) */

#include <string.h>

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

DESCRIPTION
La fonction strstr() cherche la première occurrence de la sous-chaîne aiguille au sein de la chaîne meule_de_foin. Les octets nuls (« \0 ») finaux ne sont pas comparés. La fonction strcasestr() est identique à strstr(), mais elle ignore la casse de ses arguments.

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

ATTRIBUTS

  Multithreading (voir pthreads(7))
La fonction strstr() est sûre dans un contexte multithread.

La fonction strcasestr() est sûre dans un contexte multithread avec exceptions. Elle peut être utilisée de manière sûre tant que setlocale(3) n'est pas appelée pour modifier les paramètres régionaux pendant son exécution.

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

BOGUES
Des versions antérieures de la bibliothèque C de Linux (4.5.26 par exemple), n'autorisent pas un argument aiguille vide dans 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.

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

COLOPHON
Cette page fait partie de la publication 3.70 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
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <http://manpagesfr.free.fr/> (2003-2006). Nicolas François et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <perkamon-fr@traduc.org>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».