Ksort()

ksort

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

ksort — Sortera en array efter nyckel i stigande ordning

Beskrivning

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

Sorterar en array på plats efter nycklar i stigande ordning.

Notera:

Om två medlemmar jämförs som lika behåller de sin ursprungliga ordning. Före PHP 8.0.0 var deras relativa ordning i den sorterade arrayen odefinierad.

Notera:

Återställer arrayens interna pekare till det första elementet.

Parametrar

array

Den input-array som ska sorteras.

flags

En valfri andra parameter flags kan användas för att modifiera sorteringsbeteendet med dessa värden:

Sorteringstypflaggor:

SORT_REGULAR

Jämför objekt normalt; detaljerna beskrivs i avsnittet om jämförelseoperatorer

SORT_NUMERIC

Jämför objekt numeriskt

SORT_STRING

Jämför objekt som strängar

SORT_LOCALE_STRING

Jämför objekt som strängar, baserat på aktuell lokalisering. Det använder lokaliseringen, som kan ändras med setlocale()

SORT_NATURAL

Jämför objekt som strängar med "naturlig ordning" som natsort()

SORT_FLAG_CASE

Kan kombineras (bitvis OR) med SORT_STRING eller SORT_NATURAL för att sortera strängar skiftlägesokänsligt

Returvärden

Returnerar alltid true.

Ändringslogg

Version Beskrivning

8.2.0 Returtypen är nu true; tidigare var det bool.

8.2.0 Denna funktion gör nu numerisk strängjämförelse under SORT_REGULAR enligt de standardregler som finns i PHP 8.

Exempel

Exempel #1 ksort()-exempel

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

Exemplet ovan kommer att skriva ut:

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

Exempel #2 ksort() med int nycklar

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

Exemplet ovan kommer att skriva ut:

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

Se även

sort() - Sortera en array i stigande ordning

krsort() - Sortera en array efter nyckel i fallande ordning

Jämförelse av arraysorteringsfunktioner