(PHP 5)
substr_compare — Comparación segura a nivel binario de dos o más cadenas desde un índice, hasta una longitud dada de caracteres
$main_str
, string $str
, int $offset
[, int $length
[, bool $case_insensitivity = false
]] )
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 negativo, 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
es insensible a 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, substr_compare() muestra una advertencia y devuelve
FALSE.
| Versión | Descripción |
|---|---|
| 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
?>