downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

substr_count> <strtr
[edit] Last updated: Fri, 24 Feb 2012

view this page in

substr_compare

(PHP 5)

substr_compareA comparação binária entre duas strings de um offset até o limite do comprimento de caracteres

Descrição

int substr_compare ( string $main_str , string $str , int $offset [, int $length [, bool $case_insensitivity = false ]] )

substr_compare() compara main_str da posição offset com str até length caracteres.

Parâmetros

main_str

A string principal a ser comparada.

str

A segunda string a ser comparada.

offset

A posição inicial para a comparação. Se negativo, inicia contando da final da string.

length

O comprimento da comparação. O valor padrão é o maior comprimento entre o comprimento de str comparado com o comprimento de main_str menos o offset.

case_insensitivity

Se case_insensitivity é TRUE, a comparação é case insensitive.

Valor Retornado

Retorna < 0 se main_str da posição offset em diante é menor que str, > 0 se ela é maior que str, e 0 se elas são iguais. Se offset é igual ou maior que o comprimento de main_str e length é setado e menor que 1, substr_compare() dispara um warning e retorna FALSE.

Histórico

Versão Descrição
5.1.0 Adicionada a possibilidade de usar offset negativo.

Exemplos

Exemplo #1 Exemplo da substr_compare()

<?php
echo substr_compare("abcde""bc"12); // 0
echo substr_compare("abcde""de", -22); // 0
echo substr_compare("abcde""bcg"12); // 0
echo substr_compare("abcde""BC"12true); // 0
echo substr_compare("abcde""bc"13); // 1
echo substr_compare("abcde""cd"12); // -1
echo substr_compare("abcde""abc"51); // warning
?>



add a note add a note User Contributed Notes substr_compare
sleek 22-May-2005 11:07
Modified version of the original posted function. Use this one:

<?php
if (!function_exists('substr_compare')) {
    function
substr_compare($main_str, $str, $offset, $length = NULL, $case_insensitivity = false) {
       
$offset = (int) $offset;

       
// Throw a warning because the offset is invalid
       
if ($offset >= strlen($main_str)) {
           
trigger_error('The start position cannot exceed initial string length.', E_USER_WARNING);
            return
false;
        }

       
// We are comparing the first n-characters of each string, so let's use the PHP function to do it
       
if ($offset == 0 && is_int($length) && $case_insensitivity === true) {
            return
strncasecmp($main_str, $str, $length);
        }

       
// Get the substring that we are comparing
       
if (is_int($length)) {
           
$main_substr = substr($main_str, $offset, $length);
           
$str_substr = substr($str, 0, $length);
        } else {
           
$main_substr = substr($main_str, $offset);
           
$str_substr = $str;
        }

       
// Return a case-insensitive comparison of the two strings
       
if ($case_insensitivity === true) {
            return
strcasecmp($main_substr, $str_substr);
        }

       
// Return a case-sensitive comparison of the two strings
       
return strcmp($main_substr, $str_substr);
    }
}
?>

 
show source | credits | stats | sitemap | contact | advertising | mirror sites