Manuel PHP
PrécédentSuivant

stripos

(PHP 5 CVS only)

stripos --  Rercherche la position d'une occurence dans une chaîne, sans tenir compte de la casse

Description

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

stripos() retourne la position numérique de la première occurence 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 exacte de cette fonction.

Exemple 1. 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&icirc;ne '$findme' n'a pas &eacute;t&eacute; trouv&eacute;e dans la cha&icirc;ne '$mystring'";
}

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

Si needle n'est pas une chaîne, elle est convertie 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.

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

PrécédentSommaireSuivant
stripcslashesNiveau supérieurstripslashes