# ksort

(PHP 4, PHP 5, PHP 7, PHP 8)

ksort — Trie un tableau en fonction des clés en ordre croissant

### Description

ksort(array `&$array`, int `$flags` = `SORT_REGULAR`): true

Trie `array` sur place suivant les clés en ordre croissant.

> 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.

> Note:

> Réinitialise le pointeur interne du tableau au premier élément.

### Liste de paramètres

`array`

  Le tableau d'entrée.

`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.
8.2.0 | Cette fonction effectue désormais une comparaison de chaînes numériques sous `SORT_REGULAR` en utilisant les règles standard de PHP 8.

### Exemples

Exemple #1 Exemple avec ksort()

`<?php
$fruits = array("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
ksort($fruits);
foreach ($fruits as $key => $val) {
echo "$key = $val\n";
}
?>`

L'exemple ci-dessus va afficher :

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

Exemple #2 ksort() avec des clés int

`<?php
$a = [0 => 'First', 2 => 'Last', 1 => 'Middle'];
var_dump($a);
ksort($a);
var_dump($a);
?>`

L'exemple ci-dessus va afficher :

    array(3) {
      [0]=>
      string(5) "First"
      [2]=>
      string(4) "Last"
      [1]=>
      string(6) "Middle"
    }
    array(3) {
      [0]=>
      string(5) "First"
      [1]=>
      string(6) "Middle"
      [2]=>
      string(4) "Last"
    }

### Voir aussi

- sort() - Trie un tableau en ordre croissant
- krsort() - Trie un tableau en fonction des clés en ordre décroissant
- Les fonctions de tri des tableaux