array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'collator.construct.php', 1 => 'Collator::__construct', ), 'up' => array ( 0 => 'class.collator.php', 1 => 'Collator', ), 'prev' => array ( 0 => 'collator.compare.php', 1 => 'Collator::compare', ), 'next' => array ( 0 => 'collator.create.php', 1 => 'Collator::create', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/intl/collator/construct.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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');
?>