Knowledge baseExam Center
ENEnglish
Choose language13

CKTIS / PHP

range()

Create an ascending or descending sequence as an 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

Create an ascending or descending sequence as an array. The end appears only when the step reaches it exactly. Single-byte letter endpoints produce a character sequence. A zero step raises ValueError; large ranges allocate every element. Since PHP 8.3 two single-byte string endpoints, including digits, produce string elements. A negative step in an ascending range throws ValueError. Longer nonnumeric string endpoints emit E_WARNING and only their first bytes count.

Signature

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

Example output

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

Examples

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

Result

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

Sources