Collator::compare()

collator_compare

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

Compare two Unicode strings

说明

面向对象风格
publicCollator::compare(string $str1,string $str2): int

过程化风格
collator_compare(Collator$coll,string $str1,string $str2): int

Compare two Unicode strings according to collation rules.

参数

$coll

Collator object.

$str1

The first string to compare.

$str2

The second string to compare.

返回值

Return comparison result:

• 1 if$str1isgreaterthan$str2;

• 0 if$str1isequalto$str2;

• -1 if$str1islessthan$str2.

Warning

此函数可能返回布尔值FALSE，但也可能返回等同于FALSE的非布尔值。请阅读布尔类型章节以获取更多信息。应使用===运算符来测试此函数的返回值。

范例

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";
}
?>

以上例程会输出：

参见

• collator_sort() Sort array using specified collator