# Collator::asort

# collator_asort

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

Collator::asort -- collator_asort — Ordenar un array manteniendo la relación de índices

### Descripción

Estilo orientado a objetos

public Collator::asort(array `&$arr`, int `$sort_flag` = ?): bool

Estilo por procedimientos

collator_asort(Collator `$coll`, array `&$arr`, int `$sort_flag` = ?): bool

Esta función ordena un array de forma que sus índices mantienen su correlación con los elementos del array a los que están asociados. Se usa principalmente en la ordenación de arrays asociativos donde el orden real de los elementos es significativo. Los elementos del array estarán ordenados según las normas actuales regionales.

Es equivalente al estándar de PHP asort().

### Parámetros

`coll`

  Un objeto Collator.

`arr`

  El array de cadenas a ordenar.

`sort_flag`

  El tipo de ordenación opcional, uno de los siguientes:

  - `Collator::SORT_REGULAR` - comparar los elementos de forma normal (no cambia los tipos)

  - `Collator::SORT_NUMERIC` - comparar los elementos de forma numérica

  - `Collator::SORT_STRING` - comparar los elementos como cadenas

  El valor predeterminado de $sort_flag value es `Collator::SORT_REGULAR`. También se utiliza si se ha especificado un valor no válido para $sort_flag.

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error.

### Ejemplos

Ejemplo #1 Ejemplo 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 );
?>`

El resultado del ejemplo sería:

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

### Ver también

- Las constantes de Collator
- collator_sort() - Ordenar un array usando cotejador especificado
- collator_sort_with_sort_keys() - Ordenar un array usando el cotejador y las claves de ordenación especificados