Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

range()

Tworzy tablicę rosnącego lub malejącego ciągu.

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

Składnia

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

Tworzy tablicę rosnącego lub malejącego ciągu. Koniec pojawia się tylko wtedy, gdy krok trafi w niego dokładnie. Jednobajtowe litery tworzą ciąg znaków. Zerowy krok powoduje ValueError, a duży zakres zajmuje pamięć na wszystkie elementy. Od PHP 8.3 dwie jednobajtowe granice tekstowe, również cyfry, tworzą elementy tekstowe. Ujemny krok rosnącego zakresu wywołuje ValueError. Dłuższe nienumeryczne napisy powodują E_WARNING i liczą się tylko pierwsze bajty.

Sygnatura

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

Wynik przykładu

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

Przykłady

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

Wynik

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

Źródła