# Collator::asort

# collator_asort

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

Collator::asort -- collator_asort — Tri 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é si une valeur invalide de `flags` a été fournit.

### 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() - Tri un tableau et ses clés avec une collation