Collator::asort

collator_asort

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

Collator::asort -- collator_asort — Ordena array mantendo associação de índice

Descrição

Estilo orientado a objetos

public Collator::asort(array &$array, int $flags = Collator::SORT_REGULAR): bool

Estilo procedural

collator_asort(Collator $object, array &$array, int $flags = Collator::SORT_REGULAR): bool

Esta função ordena um array de forma que seus índices mantenham as correlações com os elementos aos quais estão associados. Isto é usado principalmente ao ordenar arrays associativos onde a ordem real dos elementos é significativa. Elementos dos arrays terão a ordenação conforme as regras atuais da localidade.

Equivalente à função padrão do PHP asort().

Parâmetros

object

Objeto Collator.

array

Array de strings a ordenar.

flags

Tipo de ordenação opcional, um dos seguintes:

O valor padrão de flags é Collator::SORT_REGULAR. Também é usado se um valor inválido de flags tiver sido especificado.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

Example #1 Exemplo de collator_asort()

<?php
$coll = collator_create( 'en_US' );
$arr = array(
     'a' => '100',
     'b' => '50',
     'c' => '7'
);
collator_asort( $coll, $arr, Collator::SORT_NUMERIC );
var_export( $arr );

collator_asort( $coll, $arr, Collator::SORT_STRING );
var_export( $arr );
?>

O exemplo acima produzirá:

array (
  'c' => '7',
  'b' => '50',
  'a' => '100',
)array (
  'a' => '100',
  'b' => '50',
  'c' => '7',
)

Veja Também