(PHP 5)
substr_compare — Comparación segura a nivel binario de dos o más strings desde un desplazamiento, hasta una longitud 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_str
El string principal a ser comparado.
str
El string secundario a ser comparado.
offset
La posición de inicio para la comparación. Si es negativo, comienza a contar desde el final del string.
length
La longitud de la comparación. El valor por defecto es el que sea mayor entre el
largo de str
comparado con el largo 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 |
Added the possibility to use a negative offset .
|
Ejemplo #1 Ejemplos 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); // warning
?>