# Collator::compare

# collator_compare

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

Collator::compare -- collator_compare — Comparar dos cadenas Unicode

### Descripción

Estilo orientado a objetos

public Collator::compare(string `$str1`, string `$str2`): int

Estilo por procedimientos

collator_compare(Collator `$coll`, string `$str1`, string `$str2`): int

Compara dos cadenas Unicode según las normas de cotejo.

### Parámetros

`coll`

  Un objeto Collator.

`str1`

  La primera cadena a comparar.

`str2`

  La segunda cadena a comparar.

### Valores devueltos

Devuelve el resultado de la comparación:

- 1 si `str1` es mayor que `str2` ;

- 0 si `str1` es igual a `str2`;

- -1 si `str1` es menor que `str2` .

En caso de error es devuelto el valor `false` de tipo boolean.
Advertencia

Esta función puede devolver el valor booleano `false`, pero también puede devolver un valor no booleano que se evalúa como `false`. Por favor lea la sección sobre Booleanos para más información. Use el operador === para comprobar el valor devuelto por esta función.

### Ejemplos

Ejemplo #1 Ejemplo de collator_compare()

`<?php
$s1 = 'Hola';
$s2 = 'hola';
$coll = collator_create( 'en_US' );
$res = collator_compare( $coll, $s1, $s2 );
if ($res === false) {
echo collator_get_error_message( $coll );
} else if( $res > 0 ) {
echo "s1 es mayor que s2\n";
} else if( $res < 0 ) {
echo "s1 es menor que s2\n";
} else {
echo "s1 es igual a s2\n";
}
?>`

El resultado del ejemplo sería:

s1 es mayor que s2

### Ver también

- collator_sort() - Ordenar un array usando cotejador especificado