Collator::asort

collator_asort

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

Collator::asort -- collator_asort — Trie un tableau en conservant les clés, avec une collation

Description

Style orienté objet

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

Style procédural

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

Cette fonction trie un tableau en maintenant l'association entre les clés et les valeurs. Elle sert surtout à trier des tableaux associatifs, où l'ordre des éléments est important. Les éléments seront triés en fonction des conventions locales.

Équivalent de la fonction PHP standard asort().

Liste de paramètres

object

Objet Collator.

array

tableau de chaînes à trier.

flags

Type de tri, optionnel, choisi parmi les constantes suivantes :

Collator::SORT_REGULAR : compare les éléments normalement (pas de changement de type).
Collator::SORT_NUMERIC : compare les éléments numériquement.
Collator::SORT_STRING : compare les éléments littéralement.

La valeur par défaut de flags est Collator::SORT_REGULAR. Cette valeur est aussi utilisée si une valeur invalide de flags a été fournie.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Exemples

Exemple #1 Exemple avec 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 );
?>

L'exemple ci-dessus va afficher :

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

Voir aussi

Constantes Collator
collator_sort() - Trie un tableau avec une collation
collator_sort_with_sort_keys() - Trie un tableau et ses clés avec une collation