Manuel PHP
PrécédentSuivant

strpos

(PHP 3, PHP 4 )

strpos --  Trouve la position 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 occurence de needle dans la chaîne de caractères haystack. Contrairement à la fonction strrpos(), celle-ci peut prendre une chaîne de caractères complète comme paramètre needle et cette chaîne sera utilisée en totalité.

Si needle n'est pas trouvée, la fonction retourne 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. Exemple avec strpos()

<?php
  $mystring = 'abc';
  $findme   = 'a';
  $pos = strpos($mystring, $findme);

// Notez l'utilisation de ===.  Un simple == ne donnerait pas le r&eacute;sultat escompt&eacute;
// car la lettre 'a' est &agrave; la position 0 (la premi&egrave;re).
  if ($pos === false) {
    echo "La cha&icirc;ne '$findme' n'a pas &eacute;t&eacute; trouv&eacute;e dans la cha&icirc;ne '$mystring'";
  } else {
    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 strrpos(), stripos(), strripos(), strrchr(), substr(), stristr() et strstr().

PrécédentSommaireSuivant
strncmpNiveau supérieurstrrchr