stripos

Description

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

Returns the numeric position of the first occurrence of needle in the haystack string. Unlike strpos(), stripos() is case-insensitive.

Note that the needle may be a string of one or more characters.

If needle is not found, stripos() will return boolean FALSE.

警告

本函数可能返回布尔值 FALSE，但也可能返回一个与 FALSE 等值的非布尔值，例如 0 或者 ""。请参阅布尔类型章节以获取更多信息。应使用 === 运算符来测试本函数的返回值。

例子 1. stripos() examples
<?php $findme = 'a'; $mystring1 = 'xyz'; $mystring2 = 'ABC'; $pos1 = stripos($mystring1, $findme); $pos2 = stripos($mystring2, $findme); // Nope, 'a' is certainly not in 'xyz' if ($pos1 === false) { echo "The string '$findme' was not found in the string '$mystring1'"; } // Note our use of ===. Simply == would not work as expected // because the position of 'a' is the 0th (first) character. if ($pos2 !== false) { echo "We found '$findme' in '$mystring2' at position $pos2"; } ?>

If needle is not a string, it is converted to an integer and applied as the ordinal value of a character.

The optional offset parameter allows you to specify which character in haystack to start searching. The position returned is still relative to the beginning of haystack.

注: 本函数可安全用于二进制对象。

add a note User Contributed Notes

dazzle
16-Aug-2006 10: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 07: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 04: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 10: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
03-Oct-2004 01: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
31-May-2004 01: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