Sort the entries by value

# ArrayObject::asort

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

ArrayObject::asort — Sort the entries by value

### 说明

public function ArrayObject::asort(int `$flags` = `SORT_REGULAR`): true

Sorts the entries in ascending order, such that its keys maintain their correlation with the values they are associated with.

This is used mainly when sorting associative arrays where the actual element order is significant.

> 注意: 如果两个成员完全相同，那么它们将保持原来的顺序。 在 PHP 8.0.0 之前，它们在排序数组中的相对顺序是未定义的。

### 参数

`flags`
  可选的第二个参数 `flags` 可以用以下值改变排序的行为：

  排序类型标记：

  - `SORT_REGULAR` - 正常比较单元 详细描述参见 比较运算符 章节
  - `SORT_NUMERIC` - 单元被作为数字来比较
  - `SORT_STRING` - 单元被作为字符串来比较
  - `SORT_LOCALE_STRING` - 根据当前的区域（locale）设置来把单元当作字符串比较，可以用 setlocale() 来改变。
  - `SORT_NATURAL` - 和 natsort() 类似对每个单元以“自然的顺序”对字符串进行排序。
  - `SORT_FLAG_CASE` - 能够与 `SORT_STRING` 或 `SORT_NATURAL` 合并（OR 位运算），不区分大小写排序字符串。

### 返回值

总是返回 `true`。

### 更新日志

版本 | 说明
--- | ---
8.2.0 | 现在返回类型为 `true`；之前是 bool。

### 示例

示例 #1 ArrayObject::asort() example

    <?php
    $fruits = array("d" => "lemon", "a" => "orange", "b" => "banana", "c" => "apple");
    $fruitArrayObject = new ArrayObject($fruits);
    $fruitArrayObject->asort();

    foreach ($fruitArrayObject as $key => $val) {
        echo "$key = $val\n";
    }
    ?>

以上示例会输出：

    c = apple
    b = banana
    d = lemon
    a = orange

The fruits have been sorted in alphabetical order, and the key associated with each entry has been maintained.

### 参见

- ArrayObject::ksort() - Sort the entries by key
- ArrayObject::natsort() - Sort entries using a "natural order" algorithm
- ArrayObject::natcasesort() - Sort an array using a case insensitive "natural order" algorithm
- ArrayObject::uasort() - Sort the entries with a user-defined comparison function and maintain key association
- ArrayObject::uksort() - Sort the entries by keys using a user-defined comparison function
- asort() - 对数组进行升序排序并保持索引关系

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open