stripos

(PHP 5)

stripos — Encontra a primeira ocorrencia de uma string sem diferenciar maiúsculas e minúsculas

Descrição

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

Retorna a posição numerica da primeira ocorrencia de needle na string haystack. Diferentemente de strpos(), stripos() não diferencia maiúsculas e minúsculas.

Note que o parâmetro needle deve ser uma string de um ou mais caracteres.

Se needle não for encontrada, stripos() irá retornar boolean FALSE.

Aviso

Esta função pode retornar o booleano FALSE, mas também pode retornar um valor não-booleano que pode ser avaliado como FALSE, como 0 ou "". Leia a seção em Booleanos para maiores informações. Utilize o operador === para testar o valor retornado por esta função.

Exemplo #1 Exemplos stripos()


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

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

// 'a' certamente não esta em 'xyz'
if ($pos1 === false) {
    echo "A string '$findme' não foi encontrada na string '$mystring1'";
}

// Note o nosso uso de  ===. Simples == não funcionaria como o esperado
// porque a posição de 'a' é 0 (primeiro) caractere.
if ($pos2 !== false) {
    echo "Nós encontramos '$findme' em '$mystring2' na posição $pos2";
}
?>

Se needle não é uma string, é convertida para um inteiro e aplicado o valor do caractere.

O parâmetro opcional offset permite a você especificar apartir de qual caractere em haystack a procura começa. A posição retornada ainda é relativa ao inicio de haystack.

Veja também strpos(), strrpos(), strrchr(), substr(), stristr(), strripos(), strstr() e stri_replace().

add a note User Contributed Notes stripos

emperorshishire at gmail dot com 24-Feb-2009 07: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 04: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


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


?>

add a note