(PHP 4, PHP 5, PHP 7, PHP 8)
ksort — Ordena um array pelas chaves em ordem crescente
Ordena o array pelas chaves
em ordem crescente.
Nota:
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.
Nota:
Redefine o ponteiro interno do array para o primeiro elemento.
arrayO 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
Sempre retorna true.
| 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.
|
Exemplo #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
Exemplo #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"
}