range

(PHP 4, PHP 5)

range — Erstellt ein Array mit einem Bereich von Elementen

Beschreibung

array range ( mixed $low , mixed $high [, number $step ] )

range() gibt ein Array mit Elementen im Bereich von low bis high zurück. Wenn low > high, wird die Sequenz von high nach low sein.

Hinweis: Neuer Parameter
Der optionale Parameter step wurde in 5.0.0 eingeführt.

Ist ein step Wert angegeben, wird es Schrittweite zwischen den Elementen in der Sequenz verwendet. step sollte als positive Zahl angegeben werden. Ist step nicht angegeben, wird automatisch der Wert 1 angenommen.

Beispiel #1 range()


<?php
// array(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12)
foreach(range(0, 12) as $number) {
    echo $number;
}

// Der Parameter step wurde in PHP 5.0.0 eingeführt
// array(0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100)
foreach(range(0, 100, 10) as $number) {
    echo $number;
}

// Die Verwendung von Zeichenfolgen wurde in 4.1.0 eingeführt
// array('a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i');
foreach(range('a', 'i') as $letter) {
    echo $letter;
}
// array('c','b','a');
foreach(range('c', 'a') as $letter) {
    echo $letter;
}
?>

Hinweis:
Vor der Version 4.1.0 hat die Funktion range() nur aufsteigende Integer Arrays erstellt. Die Unterstützung für Zeichenfolgen und Arrays in absteigender Reihenfolge wurde in 4.1.0 hinzugefügt. Werte mit Zeichenfolgen sind auf eine Länge von 1 limitiert. Wird eine Länge größer als 1 eingegeben, wird nur das erste Zeichen verwendet.

Achtung

In den PHP Versionen 4.1.0 bis 4.3.2 werden numerische Zeichenfolgen von range() als Strings, und nicht als integer gesehen. Stattdessen werden diese für Zeichenfolgen genutzt, z.B. wird "4242" als "4" betrachtet.

Siehe auch shuffle(), array_fill() und foreach.