PHPKonf 2020 Online

Collator::getSortKey

collator_get_sort_key

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

Collator::getSortKey -- collator_get_sort_keyGet sorting key for a string

Descrição

Estilo orientado à objeto

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

Estilo procedural

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.

Parâmetros

coll

Collator object.

str

The string to produce the key from.

Valor Retornado

Returns the collation key for the string, ou FALSE em caso de falha.

Aviso

Esta função pode retornar o booleano FALSE, mas também pode retornar um valor não-booleano que pode ser avaliado como FALSE, como 0 ou "". Leia a seção em Booleanos para maiores informações. Utilize o operador === para testar o valor retornado por esta função.

Changelog

Versão Descrição
5.3.15, 5.4.5 Sort keys do no longer contain any NUL bytes.

Exemplos

Exemplo #1 collator_get_sort_key()example

<?php
$s1 
'Hello';

$coll collator_create('en_US');
$res  collator_get_sort_key($coll$s1);

echo 
bin2hex($res);
?>

O exemplo acima irá imprimir algo similar à:


3832404046010901dc08

Veja Também

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top