strpos

Manuel PHP
Précédent		Suivant

Description

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

strpos() retourne la position numérique de la première occurence de needle dans la chaîne haystack. Contrairement à strrpos(), needle peut être une chaîne.

Si needle n'est pas trouvée, retourne FALSE.

Note : Il est facile de confondre la valeur de retour "caractère trouvé à la position 0 et "caractère introuvable". Voici comment faire la différence :
<?php
// PHP 4.0b3 et plus récent :
$pos = strpos("b", $mystring);
if ($pos === FALSE) { // note: trois signes égal
    // non trouvé
}
// versions plus anciennes que 4.0b3:
$pos = strpos("b", $mystring);
if (is_string($pos) && !$pos) {
    // non trouvé
}
?>
	    

Si needle n'est pas une chaîne, elle est convertie en entier, et utilisée comme la valeur ASCII d'un caractère.

L'argument optionnel offset permet de préciser le caractère à partir duquel chercher, dans haystack. La position doit être relative au début de la chaîne haystack.

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