Collator::compare

collator_compare

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

Collator::compare -- collator_compareCompare two Unicode strings

Descrizione

Stile orientato agli oggetti

public Collator::compare(string $string1, string $string2): int|false

Stile procedurale

collator_compare(Collator $object, string $string1, string $string2): int|false

Compare two Unicode strings according to collation rules.

Elenco dei parametri

object

Collator object.

string1

The first string to compare.

string2

The second string to compare.

Valori restituiti

Return comparison result:

  • 1 if string1 is greater than string2 ;

  • 0 if string1 is equal to string2;

  • -1 if string1 is less than string2 .

Returns false on failure.

Avviso

Questa funzione può restituire il Booleano false, ma può anche restituire un valore non-Booleano valutato come false. Fare riferimento alla sezione Booleans per maggiori informazioni. Usare l'operatore === per controllare il valore restituito da questa funzione.

Esempi

Example #1 collator_compare() example

<?php
$s1
= 'Hello';
$s2 = 'hello';

$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 is greater than s2\n";
} else if(
$res < 0 ) {
echo
"s1 is less than s2\n";
} else {
echo
"s1 is equal to s2\n";
}
?>

Il precedente esempio visualizzerà:


s1 is greater than s2

Example #2 Comparing strings without diacritics or case-sensitivity

<?php
$c
= new Collator( 'en' );
$c->setStrength( Collator::PRIMARY );

if (
$c->compare( 'Séan', 'Sean' ) == 0 )
{
echo
"The same\n";
}

Il precedente esempio visualizzerà:


The same

This example instructs the collator to compare with only taking the base characters into account. The documentation for Collator->setStrength() explains the different strengths.

Vedere anche: