Php/docs/collator.compare

• PHP Manual
• Collator
• Compare two Unicode strings

Collator::compare

collator_compare

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

Collator::compare -- collator_compare — Compare two Unicode strings

说明

面向对象风格

public Collator::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 str1 is greater than str2 ;
• 0 if str1 is equal to str2;
• -1 if str1 is less than str2 .

On error bool false is returned.

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

范例

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

以上例程会输出：

s1 is greater than s2

参见

• collator_sort() - Sort array using specified collator