# ArrayObject::ksort

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

ArrayObject::ksort — Trie un tableau par clé

### Description

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

Trie les éléments par clé, en conservant la relation avec les éléments. C'est le tri classique sur les tableaux associatifs.

> Note:

> Si deux membres se comparent comme égaux, ils maintiennent leur ordre original. Antérieur à PHP 8.0.0, leur ordre relatif dans le tableau trié n'est pas défini.

### Liste de paramètres

`flags`

  Le deuxième paramètre optionnel `flags` peut être utilisé pour modifier le comportement de tri en utilisant ces valeurs :

  Type de drapeaux de tri :

  - `SORT_REGULAR` - compare les éléments normalement; les détails sont décrits dans la section des opérateurs de comparaison
  - `SORT_NUMERIC` - compare les éléments numériquement
  - `SORT_STRING` - compare les éléments comme des chaînes de caractères
  - `SORT_LOCALE_STRING` - compare les éléments comme des chaînes de caractères, basé sur la locale courante. Ceci utilise la locale, qui peut être changée en utilisant setlocale()
  - `SORT_NATURAL` - compare les éléments comme des chaînes de caractères utilisant "l'ordre naturel" comme natsort()
  - `SORT_FLAG_CASE` - peut être combiné (OU bit à bit) avec `SORT_STRING` ou `SORT_NATURAL` pour trier les chaînes sans tenir compte de la casse

### Valeurs de retour

Retourne toujours `true`.

### Historique

Version | Description
--- | ---
8.2.0 | Le type de retour est maintenant `true`, auparavant il était bool.

### Exemples

Exemple #1 Exemple avec ArrayObject::ksort()

`<?php
$fruits = array("d" => "citron", "a" => "orange", "b" => "banane", "c" => "pomme");
$fruitArrayObject = new ArrayObject($fruits);
$fruitArrayObject->ksort();
foreach ($fruitArrayObject as $key => $val) {
echo "$key = $val\n";
}
?>`

L'exemple ci-dessus va afficher :

    a = orange
    b = banane
    c = pomme
    d = citron

### Voir aussi

- ArrayObject::asort() - Trie les éléments par valeur
- ArrayObject::natsort() - Trie les éléments avec un tri naturel
- ArrayObject::natcasesort() - Trie un tableau en utilisant le tri naturel sans la casse
- ArrayObject::uasort() - Trie les éléments avec une fonction utilisateur
- ArrayObject::uksort() - Trie les éléments par clé avec une fonction utilisateur
- ksort() - Trie un tableau en fonction des clés en ordre croissant