substr_compare
(PHP 5)
substr_compare — Comparación de 2 cadenas, segura con material binario, opcionalmente insensible a mayúsculas y minúsculas, a partir de un desplazamiento, y hasta un número límite de caracteres
Descripción
substr_compare() compara cadena_principal desde la posición desplazamiento con cadena hasta tantos caracteres como el valor de longitud .
Lista de parámetros
- cadena_principal
-
- cadena
-
- desplazamiento
-
La posición de inicio para la comparación. Si es un valor negativo, comienza contando desde el final de la cadena.
- longitud
-
La longitud de la comparación.
- insensibilidad_mayusculas
-
Si insensibilidad_mayusculas es TRUE, la comparación es insensible a mayúsculas y minúsculas.
Valores retornados
Devuelve < 0 si cadena_principal desde la posición desplazamiento es menor que cadena , > 0 si es mayor que cadena , y 0 si son iguales. Si longitud es igual o mayor que la longitud de cadena_principal y longitud se define, substr_compare() imprime una advertencia y devuelve FALSE.
Registro de cambios
| Versión | Descripción |
|---|---|
| 5.1.0 | Se agregó la posibilidad de usar un desplazamiento negativo. |
Ejemplos
Example#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
?>