Php/docs/collator.getsortkey

• PHP Manual
• Collator
• Get sorting key for a string

Collator::getSortKey

collator_get_sort_key

(PHP 5 >= 5.3.2, PHP 7, PECL intl >= 1.0.3)

Collator::getSortKey -- collator_get_sort_key — Get sorting key for a string

说明

面向对象风格

public Collator::getSortKey ( string $str ) : string|false

过程化风格

collator_get_sort_key ( Collator $coll , string $str ) : string|false

Return collation key for a string. Collation keys can be compared directly instead of strings, though are implementation specific and may change between ICU library versions. Sort keys are generally only useful in databases or other circumstances where function calls are extremely expensive.

参数

coll

Collator object.

str

The string to produce the key from.

返回值

Returns the collation key for the string, 或者在失败时返回 false.

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

更新日志

版本	说明
5.3.15, 5.4.5	Sort keys do no longer contain any NUL bytes.

范例

Example #1 collator_get_sort_key()example

<?php$s1 = 'Hello';$coll = collator_create('en_US');$res  = collator_get_sort_key($coll, $s1);echo bin2hex($res);?>

以上例程的输出类似于：

3832404046010901dc08

参见

• collator_sort() - Sort array using specified collator
• collator_sort_with_sort_keys() - Sort array using specified collator and sort keys