Collator::__construct
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
Collator::__construct — Cria um agrupador (Collator)
Parâmetros
locale
-
A localidade cujas regras de agrupamento devem ser usadas. Valores especiais para localidades podem ser passadas - se uma string vazia for passada, as regras de agrupamento da localidade padrão serão usadas. Se
"root"
for passado, as regras » UCA serão usadas.O atributo
locale
é tipicamente o mais importante para ordenação e correspondências corretas, conforme expectativas do usuário em diferentes países e regiões. A ordenação » UCA padrão ordenará somente poucas línguas como holandês e português corretamente ("corretamente" significa de acordo com a expectativa normal para os usuários da língua). Em outras situações, é necessário fornecer a localidade para a UCA para agrupar adequadamente o texto para uma língua específica. Portanto, uma localidade precisa ser informada para que seja escolhido um agrupador que tenha sido corretamente elaborado para aquela localidade. A escolha de uma localidade irá predefinir automaticamente os valores de todos os atributos para algo que seja razoável para a localidade. Por isso, na maior parte do tempo os outros atributos não precisam ser definidos explicitamente. Em alguns casos, a escolha de localidade fará diferença em desempenho de comparação de strings e/ou em comprimento de chave de ordenação.
Erros/Exceções
Retorna um objeto "vazio" em caso de erro. User as funções intl_get_error_code() e/ou intl_get_error_message() para descobrir o que ocorreu.
Exemplos
Example #1 Exemplo de Collator::__construct()
<?php
$coll = new Collator('en_CA');
?>