(PHP 5, PHP 7)
substr_compare — Comparación segura a nivel binario de dos o más strings desde un índice hasta una longitud de caracteres dada
$main_str
, string $str
, int $offset
[, int $length
[, bool $case_insensitivity = FALSE
]] ) : int
substr_compare() compara main_str
desde la posición offset con str
hasta la cantidad length de caracteres.
main_strEl string principal a comparar.
strEl string secundario a comparar.
offsetLa posición de inicio para la comparación. Si es negativa, se comienza a contar desde el final del string.
length
La longitud de la comparación. El valor predeterminado es el que sea mayor entre la
longitud de str comparado con la longitud de
main_str menos el
offset.
case_insensitivity
Si case_insensitivity es TRUE, la comparación
no considera el uso de mayúsculas y minúsculas.
Devuelve < 0 si main_str, desde la posición
offset, es menor que str, >
0 si es mayor que str, y 0 si son iguales.
Si offset es igual o mayor que la longitud de
main_str, o length se
establece y es menor que 1 (antes de PHP 5.5.11),
substr_compare() muestra una advertencia y devuelve
FALSE.
| Versión | Descripción |
|---|---|
| 5.5.11 |
length ahora puede ser 0.
|
| 5.1.0 |
Se añadió la posibilidad de usar un offset negativo.
|
Ejemplo #1 Un ejemplo de 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); // advertencia
?>