Cadenas
PHP Manual

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

int substr_compare ( string $cadena_principal , string $cadena , int $desplazamiento [, int $longitud [, bool $insensibilidad_mayusculas ]] )

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"12); // 0
echo substr_compare("abcde""de", -22); // 0
echo substr_compare("abcde""bcg"12); // 0
echo substr_compare("abcde""BC"12true); // 0
echo substr_compare("abcde""bc"13); // 1
echo substr_compare("abcde""cd"12); // -1
echo substr_compare("abcde""abc"51); // advertencia
?>


Cadenas
PHP Manual