字符串函数
在线手册：中文 英文
PHP手册

stripos

(PHP 5)

stripos — 查找字符串首次出现的位置（不区分大小写）

说明

int stripos ( string $haystack , string $needle [, int $offset = 0 ] )

返回在字符串 haystack 中 needle 首次出现的数字位置。

与 strpos() 不同，stripos() 不区分大小写。

参数

haystack

在该字符串中查找。

needle

注意 needle 可以是一个单字符或者多字符的字符串。

如果 needle 不是一个字符串，那么它将被转换为整型并被视为字符顺序值。

offset

可选的 offset 参数允许你指定从 haystack 中的哪个字符开始查找。返回的位置数字值仍然相对于 haystack 的起始位置。

返回值

如果未发现 needle，stripos() 将返回布尔型 FALSE。

Warning

此函数可能返回布尔值 FALSE，但也可能返回等同于 FALSE 的非布尔值，例如 0 或 ""(空串)。请阅读 布尔类型章节以获取更多信息。应使用 === 运算符 来测试此函数的返回值。

范例

Example #1 stripos() 范例

<?php
$findme    = 'a';
$mystring1 = 'xyz';
$mystring2 = 'ABC';

$pos1 = stripos($mystring1, $findme);
$pos2 = stripos($mystring2, $findme);

// 'a' 当然不在 'xyz' 中
if ($pos1 === false) {
    echo "The string '$findme' was not found in the string '$mystring1'";
}

// 注意这里使用的是 ===。简单的 == 不能像我们期望的那样工作，
// 因为 'a' 的位置是 0（第一个字符）。
if ($pos2 !== false) {
    echo "We found '$findme' in '$mystring2' at position $pos2";
}
?>

注释

Note: 此函数可安全用于二进制对象。

参见

字符串函数
在线手册：中文 英文
PHP手册
PHP手册 - N: 查找字符串首次出现的位置（不区分大小写）

用户评论:

emperorshishire at gmail dot com (25-Feb-2009 03:31)

I found myself needing to find the first position of multiple needles in one haystack.  So I wrote this little function:

<?php
function multineedle_stripos($haystack, $needles, $offset=0) {
    foreach($needles as $needle) {
        $found[$needle] = stripos($haystack, $needle, $offset);
    }
    return $found;
}

// It works as such:
$haystack = "The quick brown fox jumps over the lazy dog.";
$needle = array("fox", "dog", ".", "duck")
var_dump(multineedle_stripos($haystack, $needle));
/* Output:
   array(3) {
     ["fox"]=>
     int(16)
     ["dog"]=>
     int(40)
     ["."]=>
     int(43)
     ["duck"]=>
     bool(false)
   }
*/
?>

grf at post dot cz (20-Mar-2007 12:57)

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
****************************************/
?>