stripos

(PHP 5)

stripos — Recherche la première occurrence dans une chaîne, sans tenir compte de la casse

Description

int stripos ( string $haystack, string $needle [, int $offset] )

Retourne la position numérique de la première occurrence de needle dans la chaîne haystack . Contrairement à strpos() , stripos() est insensible à la casse. Et, contrairement à strrpos() , cette fonction peut prendre une chaîne complète comme paramètre needle et cette chaîne complète sera utilisée pour la recherche.

Si le paramètre needle n'est pas trouvé, strpos() retournera FALSE .

AVERTISSEMENT

Cette fonction peut retourner FALSE , mais elle peut aussi retourner une valeur équivalent à FALSE , utilisable dans une condition if simple. Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.

Exemple 2626. Exemples avec stripos()

<?php
$findme    
'a' ;
$mystring1  'xyz' ;
$mystring2  'ABC' ;

$pos1  stripos ( $mystring1 $findme );
$pos2  stripos ( $mystring2 $findme );

// Non, 'a' ne fait pas partie de 'xyz'
if ( $pos1  ===  false ) {
    echo 
"La chaîne '$findme' n'a pas été trouvée dans la chaîne '$mystring'" ;
}

// Notez l'utilisation de ===.  Un simple == ne donnerait pas le résultat escompté
// car la lettre 'a' est à la position 0th (la première).
if ( $pos2  !==  false ) {
    echo 
"La chaîne '$findme' a été trouvée dans la chaîne '$mystring'" ;
    echo 
" à la position $pos" ;
}
?>

Si needle n'est pas une chaîne, il est converti en entier, et utilisé comme caractère de code ASCII correspondant.

Le paramètre optionnel offset vous permet de spécifier à partir de quel caractère dans haystack vous souhaitez commencer la recherche. La position retournée sera toujours relative au début de la chaîne haystack .

Note: Cette fonction gère les chaînes binaires.

Voir aussi strpos() , strrpos() , strrchr() , substr() , stristr() , strstr() , strripos() et str_ireplace() .