(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
Collator::__construct — Cria um agrupador (Collator)
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.
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.
Exemplo #1 Exemplo de Collator::__construct()
<?php
$coll = new Collator('en_CA');
?>