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 #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î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().

stripslashes

stripcslashes

Last updated: Fri, 11 Apr 2008

add a note User Contributed Notes
stripos

Ysangkok
06-Mar-2008 04:44


@henke:



No. It does NOT make a warning if the needle isn't found. This is false.

henke at henke37 dot cjb dot net
09-Dec-2007 07:48


This function will raise a warning if the needle was not found. Be sure to use @ to suppress it if you want the strpos like behavior of only returning false.

hpavon at gmail dot com
19-Jul-2007 09:54


To shane_at_51smith-dot-nl

Fine but not useful if you want to use stripos 3rd param òffset´ for instance to find all occurences of `needle´.

Again rchillet and heavyraptor solution is best though you'd better keep to-lowercase strings outside the function if you're planning to loop through `haystack´ like this:



$lower_haystack = strtolower($haystack);

$lower_needle = strtolower($needle);

$offset = 0;

//... looping over haystack

while ($offset !== false) {

    $offset = strpos($lower_haystack, $lower_needle, $offset);

    //... some funny stuff here

}



Using rchillet-heavyraptor function here would slow down performance. Solution: don't invent any function

shane_at_51smith-dot-nl
03-Jul-2007 09:46


Yet another stripos for php4 alternative:

<?php

function stripos($haystack, $needle){

    return strpos($haystack, stristr( $haystack, $needle ));

}

$strTest = "The brown fox jumped over the Fence";

echo stripos($strTest, 'fence');//30

?>

grf at post dot cz
20-Mar-2007 01:57


(i'm very sorry for some mistakes in my yesterday's post :'[ )



this would to work with any language, i hope.

tested on czech (eastern europe) lang.



<?php

/****************************************

*    SAFE HIGHLIGHT

****************************************/

/**

 * function finds and encase every string in a $needleArr array with

 * strings $shearLft (from the left side) and $shearRgt (guess from which

 * side).

 * already encased needles are IGNORED for any other step, so order

 * of needles in $needleArr is pretty important.

 * 

 * function is searching needles in case-insensitive mode,

 * but case in the subject is saved.

 * 

 * can you do it better? so, do it.

 *

 * @param array $needleArr array of needles

 * @param string $shearLft left shear

 * @param string $shearRgt right shear

 * @param string $subject subject

 * @param string $encoding encoding ('utf-8' is default)

 * 

 * @author griffin

 */

function safeHighlight( $needleArr, $shearLft, $shearRgt, $subject, $encoding = 'utf-8')

{

    

    // encoding

    $e = $encoding;

    

    // oh, no needles

    if( !is_array( $needleArr))

        return $subject;

        

    // empty keys throw-off, only unique, reindex

    $nA = array_values(

            array_unique(

                array_diff( $needleArr, array(''))

            )

        );

    

    // needle count

    if( !($nC = count( $nA)))

        return $subject; // nothing to hl

        

    // shear length

    if( !(($rLL = mb_strlen( $rL = $shearLft, $e))

    + ($rRL = mb_strlen( $rR = $shearRgt, $e))))

        return $subject; // no shears

    

    // subject length

    if( !($sL = mb_strlen( $s = $subject, $e)))

        return null; // empty subject

        

    // subject in lowercase (we need to aviod

    // using mb_stripos due to PHP version)

    $sW = mb_strtolower( $s, $e);

    

    // masking ~ 0=not changed, 1=changed

    $m = str_repeat( '0', $sL);

    

    // loop for each needle

    for( $n=0; $n<$nC; $n++)

    {

        

        // needle string loWercase

        $nW = mb_strtolower( $nA[ $n], $e);

        

        $o = 0; // offset

        $nL = mb_strlen( $nW, $e); // needle length



        // search needle

        while( false !== ($p = mb_strpos( $sW, $nW, $o, $e)))

        {

            // oh hurrey, needle found on $p position

            

            // is founded needle already modified? (in full-length)

            for( $q=$p; $q<($p+$nL); $q++)

                if( $m[ $q])

                {

                    // ai, caramba. already modified, jump over

                    $o+= $nL;

                    

                    // continue for while() loop - not for for() loop!

                    continue 2;

                }

            

            // explode subject and mask into three parts

            // partA|needle|partB

            $sE[0] = mb_substr( $s, 0, $p, $e);

            $sE[1] = mb_substr( $s, $p, $nL, $e);

            $sE[2] = mb_substr( $s, $p+$nL, $sL-$p-$nL, $e);

            

            // mask

            // partA|partB (needle not needed)

            $mE[0] = mb_substr( $m, 0, $p, $e);

            $mE[1] = mb_substr( $m, $p+$nL, $sL-$p-$nL, $e);

            

            // apply shears

            $sE[1] = $rL.$sE[1].$rR;

            

            // update sunject length

            $sL+= $rLL + $rRL;

            

            // update mask

            $m = $mE[0] . str_repeat( '1', $rLL + $nL + $rRL) . $mE[1];

            

            // implode into a subject

            $s = implode( $sE);

            

            // update lowercase subject

            $sW = mb_strtolower( $s, $e);

            

            // increase offset

            $o+= $rLL + $nL + $rRL;

            

            // end of string reached

            if( $o>=$sL)

                break;

            

        } // while()

        

    } // for( $n=0; $n<$nC; $n++)

    

    // oouu yeaaa, kick the subject out of the function

    return $s;

    

} // function safeHighlight()

/****************************************

*    END: SAFE HIGHLIGHT

****************************************/

?>

dazzle
16-Aug-2006 04:20


I recommend using the solution by rchillet for <PHP5



michiels solution is quite slow if you use it for long strings or call it many times.

michiel at mb-it dot nl
10-Jul-2006 01:03


Since the stripos-function is PHP5-only, the function below could give PHP4-users the same functionallity:



function stripos($string,$word)

{

   $retval = false;

   for($i=0;$i<=strlen($string);$i++)

   {

       if (strtolower(substr($string,$i,strlen($word))) == strtolower($word))

       {

           $retval = true;

       }

   }

   return $retval;

}

rchillet at hotmail dot com
28-Apr-2006 10:45


improvement the function of heavyraptor with int offset parametre. 



if (!function_exists("stripos")) {

  function stripos($str,$needle,$offset=0)

  {

      return strpos(strtolower($str),strtolower($needle),$offset);

  }

}

heavyraptor
21-Mar-2006 03:59


If you're using PHP < 5, you can use this alternate function, same thing like stripos:



<?php

if (!function_exists("stripos")) {

  function stripos($str,$needle) {

   return strpos(strtolower($str),strtolower($needle));

  }

}

?>



Such a logical function but I hope it helps ...

sim
02-Oct-2004 07:17


Just to be explicit, the position index returned by strpos starts at 0, not 1. e.g. strpos('abc','a') returns 0.

aidan at php dot net
30-May-2004 07:36


This functionality is now implemented in the PEAR package PHP_Compat.



More information about using this function without upgrading your version of PHP can be found on the below link:



http://pear.php.net/package/PHP_Compat

add a note

stripslashes

stripcslashes

Last updated: Fri, 11 Apr 2008