(PHP 4, PHP 5)

range — Создать массив, содержащий диапазон элементов

Описание

array range ( number $low, number $high [, number $step] )

range() возвращает массив элементов с low по high, включительно. Если low > high, последовательность будет убывающей.

New parameter: Дополнительный параметр step был добавлен в PHP 5.0.0.

Если указан параметр step, он будет использоваться как инкремент между элементами последовательности. step должен быть положительным числом. Если step не указан, он принимает значение по умолчанию 1.


Примеры использования range()

<?php
// array(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12)
foreach (range(0, 12) as $number) {
echo
$number;
}

// Параметр step был добавлен в 5.0.0
// array(0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100)
foreach (range(0, 100, 10) as $number) {
echo
$number;
}

// Использование последовательности знаков было добавлено в версии 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;
}
?>

Замечание: До появления PHP 4.1.0, range() создавала только массивы, содержащие диапазон чисел в порядке возрастания. Поддержка последовательностей знаков и создания диапазона в порядке убывания была добавлена в версии 4.1.0. Диапазон знаков можно задать только при помощи строки из одного знака. Если длина такой строки будет более одного знака, будет использован первый знак.

Предостережение

В PHP версий с 4.1.0 по 4.3.2, range() рассматривал числовые строки именно как строки, а не числа. Вместо них использовалась последовательность знаков. Например, "4242" трактовалось "4".

См. также shuffle(), array_fill() и foreach.