Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / PHP

range()

Vytvoří pole se vzestupnou nebo sestupnou posloupností.

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

Syntaxe

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

Vytvoří pole se vzestupnou nebo sestupnou posloupností. Konec se objeví pouze tehdy, když na něj krok přesně dopadne. Jednobajtová písmena vytvoří řadu znaků. Nulový krok vyvolá ValueError a velký rozsah zabere paměť pro všechny prvky. Od PHP 8.3 dvě jednobajtové řetězcové meze, i číslice, vytvoří řetězce. Záporný krok ve vzestupném rozsahu vyvolá ValueError. Delší nečíselné řetězce způsobí E_WARNING a počítají se jen jejich první bajty.

Signatura

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

Výstup příkladu

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

Příklady

<?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]);

Výsledek

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

Zdroje