Руководство по PHP
Пред. |  | След.

# range

(PHP 3 >= 3.0.8, 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.

Пример 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.

Пред. | Начало | След.
prev | Уровень выше | reset