Manuel PHP
Précédent |  | Suivant

# strpos

(PHP 3 <= 3.0.18, PHP 4 >= 4.0.0)

strpos -- Recherche la première occurrence d'un caractère dans une chaîne.

## Description

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

strpos() retourne la position numérique de la première occurrence 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($machaine, "b");
>       if ($pos === FALSE) { // note: trois signes égal
>         // non trouvé
>       }
>       // versions plus anciennes que 4.0b3:
>       $pos = strpos("b", $machaine);
>       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(), strchr(), substr(), stristr() et strstr().

Précédent | Sommaire | Suivant
str_pad | Niveau supérieur | strrchr