WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

range()

Erstellt eine auf- oder absteigende Folge als Array.

Version: PHP 8.4; repository runtime, production runtime not attested

Syntax

range(string|int|float $start, string|int|float $end, int|float $step = 1): array

Erstellt eine auf- oder absteigende Folge als Array. Der Endwert erscheint nur, wenn die Schrittweite ihn genau trifft. Einbyte-Buchstaben erzeugen eine Zeichenfolge. Schrittweite null löst ValueError aus, große Bereiche belegen Speicher für jedes Element. Seit PHP 8.3 ergeben zwei einbyteige Stringgrenzen, auch Ziffern, Stringelemente. Ein negativer Schritt im aufsteigenden Bereich löst ValueError aus. Längere nichtnumerische Strings lösen E_WARNING aus, nur ihre ersten Bytes zählen.

Signatur

range(string|int|float $start, string|int|float $end, int|float $step = 1): array

Ausgabe des Beispiels

[[5,3,1],["a","c","e"]]
ValueError
[["3","4","5"],["a"],[true,true],"ValueError"]

Beispiele

<?php
echo json_encode([range(5,0,2),range("a","e",2)]), PHP_EOL;
try { range(1,2,0); } catch (ValueError $e) { echo "ValueError"; }
$warnings=[]; set_error_handler(function($n) use (&$warnings){$warnings[]=$n===E_WARNING;return true;});
$bytes=range("ab","ac"); restore_error_handler();
try{range(1,5,-2);}catch(ValueError $e){$negative=get_class($e);}
echo PHP_EOL,json_encode([range("3","5"),$bytes,$warnings,$negative]);

Ergebnis

[[5,3,1],["a","c","e"]]
ValueError
[["3","4","5"],["a"],[true,true],"ValueError"]

Quellen