Comparación segura a nivel binario de dos o más strings desde un desplazamiento, hasta una longitud de caracteres

Descripción

int substr_compare ( string $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.

Parámetros

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.

Valores devueltos

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.

Historial de cambios

Versión	Descripción
5.1.0	Added the possibility to use a negative `offset`.

Ejemplos

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
?>