Scroll to navigation

STRSTR(3) Manuel du programmeur Linux 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.65 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 à <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> ».
22 janvier 2014 GNU