array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'collator.construct.php', 1 => 'Collator::__construct', 2 => 'Cria um agrupador (Collator)', ), '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', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Collator::__construct

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

Collator::__construct — Cria um agrupador (Collator)

Descrição

public Collator::__construct(string $locale)

Cria uma nova instância de 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

Exemplo #1 Exemplo de Collator::__construct()

<?php
$coll = new Collator('en_CA');
?>

Veja Também