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);
}
}
?>
substr_compare
(PHP 5)
substr_compare — A comparação binária entre duas strings de um offset até o limite do comprimento de caracteres
Descrição
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", 1, 2); // 0
echo substr_compare("abcde", "de", -2, 2); // 0
echo substr_compare("abcde", "bcg", 1, 2); // 0
echo substr_compare("abcde", "BC", 1, 2, true); // 0
echo substr_compare("abcde", "bc", 1, 3); // 1
echo substr_compare("abcde", "cd", 1, 2); // -1
echo substr_compare("abcde", "abc", 5, 1); // warning
?>
