stripos

(PHP 5)

stripos --  Find position of first occurrence of a case-insensitive string

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.

注: 本函數可安全用於二進位對象。

See also strpos(), strrpos(), strrchr(), substr(), stristr(), strstr(), strripos() and str_ireplace().