(PHP 4, PHP 5, PHP 7, PHP 8)
range — Create an array containing a range of elements
Create an array containing a range of elements.
If both start
and end
are strings, and step
is int the produced array will be a sequence of bytes. Otherwise, the produced array will be a sequence of numbers.
The sequence is increasing if start
is less than equal to end
. Otherwise, the sequence is decreasing.
Returns a sequence of elements as an array with the first element being start
going up to end
, with each value of the sequence being step
values apart.
The last element of the returned array is either end
or the previous element of the sequence, depending on the value of step
.
If both start
and end
are strings, and step
is int the produced array will be a sequence of bytes, generally latin ASCII characters.
If at least one of start
, end
, or step
is float the produced array will be a sequence of float.
Otherwise, the produced array will be a sequence of int.
step
is 0
, a ValueError is thrown. start
, end
, or step
is not is_finite(), a ValueError is thrown. step
is negative, but the produced range is increasing (i.e. $start <= $end
), a ValueError is thrown. start
or end
is the empty string ''
, an E_WARNING
is emitted and the empty string will be interpreted as 0
. start
or end
non-numeric string with more than one byte, an E_WARNING
is emitted. start
or end
is a string that is implicitly cast to an int because the other boundary value is a number, an E_WARNING
is emitted. step
is a float, and start
and end
are non-numeric string, an E_WARNING
is emitted. Version | Description |
---|---|
8.3.0 | If both start and end are strings then range() will now always produce an array of bytes. Previously if one of the boundary values was a numeric string, then the other boundary value was implicitly cast to int. |
8.3.0 | An E_WARNING is now emitted if start or end is a string that is implicitly cast to int because the other boundary value is a number. |
8.3.0 | An E_WARNING is now emitted if start or end is a non-numeric string with more than one byte. |
8.3.0 | An E_WARNING is now emitted if start or end is the empty string. |
8.3.0 | If step is a float with no fractional part, it will be interpreted as an int. |
8.3.0 | A ValueError is now thrown if step is negative when producing an increasing range. |
8.3.0 | A ValueError is now thrown if step is not finite. |
8.3.0 | A TypeError is now thrown if start or end is an array, object, or resource. Previously they were implicitly cast to int. |
Example #1 range() examples
<?php
echo implode(', ', range(0, 12)), PHP_EOL;
echo implode(', ', range(0, 100, 10)), PHP_EOL;
echo implode(', ', range('a', 'i')), PHP_EOL;
echo implode(', ', range('c', 'a')), PHP_EOL;
echo implode(', ', range('A', 'z')), PHP_EOL;
?>
The above example will output:
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100 a, b, c, d, e, f, g, h, i c, b, a A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z, [, \, ], ^, _, `, a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z