Collator::asort

collator_asort

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

Collator::asort -- collator_asortOrdena 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:

  • Collator::SORT_REGULAR - compara os itens normalmente (não altera os tipos)

  • Collator::SORT_NUMERIC - compara os itens numericamente

  • Collator::SORT_STRING - compara os itens como strings

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

Exemplo #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

add a note add a note

User Contributed Notes 1 note

up
-1
alix dot axel at NOSPAM dot gmail dot com
13 years ago
For those of you who are looking for a way to integrate natural sorting with the UCA rules this hack seems to work:

<?php

$array
= array
(
   
'1', '100',
   
'al', 'be',
   
'Alpha', 'Beta',
   
'Álpha', 'Àlpha', 'Älpha',
   
'かたかな',
   
'img1.png', 'img2.png',
   
'img10.png', 'img20.png'
);

echo
'<pre>';
print_r(sortIntl($array, true));
echo
'</pre>';

function
sortIntl($array, $natural = true)
{
   
$data = $array;

    if (
$natural === true)
    {
       
$data = preg_replace_callback('~([0-9]+)~', 'natsortIntl', $data);
    }

   
collator_asort(collator_create('root'), $data);

    return
array_intersect_key($array, $data);
}

function
natsortIntl($number)
{
    return
sprintf('%032d', $number);
}

?>

Output:

Array
(
    [0] => 1
    [1] => 100
    [2] => al
    [3] => be
    [4] => Alpha
    [5] => Beta
    [6] => Álpha
    [7] => Àlpha
    [8] => Älpha
    [9] => かたかな
    [10] => img1.png
    [11] => img2.png
    [12] => img10.png
    [13] => img20.png
)
To Top