Ordena um array pelas chaves em ordem crescente

Descrição

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

Ordena o array pelas chaves em ordem crescente.

Note:
Se dois elementos são comparados como iguais, eles mantêm sua ordem original. Antes do PHP 8.0.0, sua ordem relativa no array ordenado era indefinida.

Note:
Redefine o ponteiro interno do array para o primeiro elemento.

Parâmetros

array

O array de entrada.

flags

O segundo parâmetro opcional flags pode ser usado para modificar o comportamento da ordenação usando estes valores:

Flags dos tipos de ordenação:

SORT_REGULAR - compara os elementos normalmente; os detalhes são descritos na seção operadores de comparação
SORT_NUMERIC - compara os elementos numericamente
SORT_STRING - compara os elementos como strings
SORT_LOCALE_STRING - compara os elementos como strings, com base na localidade atual. A localidade pode ser alterada usando setlocale()
SORT_NATURAL - compara os elementos como strings usando "ordenação natural" como natsort()
SORT_FLAG_CASE - pode ser combinada (usando o operador bit a bit OR) com SORT_STRING ou SORT_NATURAL para ordenar strings sem fazer distinção entre maiúsculas e minúsculas

Valor Retornado

Sempre retorna true.

Registro de Alterações

Versão	Descrição
8.2.0	O tipo do retorno agora é `true`; anteriormente, era bool.
8.2.0	Esta função agora faz comparação numérica de string com a constante `SORT_REGULAR` usando as regras padrão do PHP 8.

Exemplos

Example #1 Exemplo da ksort()

<?php
$frutas = array("d"=>"limão", "a"=>"laranja", "b" =>"banana", "c"=>"maçã");
ksort($frutas);
foreach ($frutas as $chave => $valor) {
    echo "$chave = $valor\n";
}
?>

O exemplo acima produzirá:

a = laranja
b = banana
c = maçã
d = limão

Example #2 ksort() com chaves int

<?php
$a = [0 => 'Primeiro', 2 => 'Último', 1 => 'Intermediário'];
var_dump($a);
ksort($a);
var_dump($a);
?>

O exemplo acima produzirá:

array(3) {
  [0]=>
  string(5) "Primeiro"
  [2]=>
  string(4) "Último"
  [1]=>
  string(6) "Intermediário"
}
array(3) {
  [0]=>
  string(5) "Primeiro"
  [1]=>
  string(6) "Intermediário"
  [2]=>
  string(4) "Último"
}

Veja Também

sort() - Ordena um array em ordem ascendente
krsort() - Ordena um array pelas chaves em ordem descrescente
Comparação entre as funções de ordenação de array