Collator::compare
(PHP 5 >= 5.3.0, PHP 7, PECL intl >= 1.0.0)
Collator::compare -- collator_compare — Compare two Unicode strings
Description
Object oriented style
public int Collator::compare ( string $str1 , string $str2 )
Procedural style
int collator_compare ( Collator $coll , string $str1 , string $str2 )
Compare two Unicode strings according to collation rules.
Parameters
coll
Collator object.
str1
The first string to compare.
str2
The second string to compare.
Return Values
Return comparison result:
- 1 if
str1
is greater thanstr2
;
- 0 if
str1
is equal tostr2
;
- -1 if
str1
is less thanstr2
. On error booleanFALSE
is returned. WarningThis function may return BooleanFALSE
, but may also return a non-Boolean value which evaluates toFALSE
. Please read the section on Booleans for more information. Use the === operator for testing the return value of this function.ExamplesExample #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"; } ?>?The above example will output:? s1 is greater than s2See Also
- collator_sort() - Sort array using specified collator
← Collator::asort
Collator::__construct →
? 1997–2017 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
本文档系腾讯云开发者社区成员共同维护,如有问题请联系 cloudcommunity@tencent.com