range
(PHP 4, PHP 5)
range — Create an array containing a range of elements
Description
Create an array containing a range of elements.
Parameters
-
start -
First value of the sequence.
-
end -
The sequence is ended upon reaching the
endvalue. -
step -
If a
stepvalue is given, it will be used as the increment between elements in the sequence.stepshould be given as a positive number. If not specified,stepwill default to 1.
Return Values
Returns an array of elements from start to
end, inclusive.
Changelog
| Version | Description |
|---|---|
| 5.0.0 |
The optional step parameter was added.
|
| 4.1.0 to 4.3.2 | In PHP versions 4.1.0 through 4.3.2, range() sees numeric strings as strings and not integers. Instead, they will be used for character sequences. For example, "4242" is treated as "4". |
| 4.1.0 | Prior to PHP 4.1.0, range() only generated incrementing integer arrays. Support for character sequences and decrementing arrays was added in 4.1.0. Character sequence values are limited to a length of one. If a length greater than one is entered, only the first character is used. |
Examples
Example #1 range() examples
<?php
// array(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12)
foreach (range(0, 12) as $number) {
echo $number;
}
// The step parameter was introduced in 5.0.0
// array(0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100)
foreach (range(0, 100, 10) as $number) {
echo $number;
}
// Use of character sequences introduced in 4.1.0
// array('a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i');
foreach (range('a', 'i') as $letter) {
echo $letter;
}
// array('c', 'b', 'a');
foreach (range('c', 'a') as $letter) {
echo $letter;
}
?>
0044 203 3971 555 (UK)