- ru
- Language: en
- Documentation version: latest
Функция range
Функция range возвращает неизменяемую последовательность чисел в виде объекта range.
Синтаксис функции:
range(stop)
range(start, stop[, step])
Параметры функции:
start - с какого числа начинается последовательность. По умолчанию - 0
stop - до какого числа продолжается последовательность чисел. Указанное число не включается в диапазон
step - с каким шагом растут числа. По умолчанию 1
Функция range хранит только информацию о значениях start, stop и step и вычисляет значения по мере необходимости. Это значит, что независимо от размера диапазона, который описывает функция range, она всегда будет занимать фиксированный объем памяти.
Самый простой вариант range - передать только значение stop:
In [1]: range(5)
Out[1]: range(0, 5)
In [2]: list(range(5))
Out[2]: [0, 1, 2, 3, 4]
Если передаются два аргумента, то первый используется как start, а второй - как stop:
In [3]: list(range(1, 5))
Out[3]: [1, 2, 3, 4]
И чтобы указать шаг последовательности надо передать три аргумента:
In [4]: list(range(0, 10, 2))
Out[4]: [0, 2, 4, 6, 8]
In [5]: list(range(0, 10, 3))
Out[5]: [0, 3, 6, 9]
С помощью range можно генерировать и убывающие последовательности чисел:
In [6]: list(range(10, 0, -1))
Out[6]: [10, 9, 8, 7, 6, 5, 4, 3, 2, 1]
In [7]: list(range(5, -1, -1))
Out[7]: [5, 4, 3, 2, 1, 0]
Для получения убывающей последовательности надо использовать отрицательный шаг и соответственно указать start - большим числом, а stop - меньшим.
В убывающей последовательности шаг тоже может быть разным:
In [8]: list(range(10, 0, -2))
Out[8]: [10, 8, 6, 4, 2]
Функция поддерживает отрицательные значения start и stop:
In [9]: list(range(-10, 0, 1))
Out[9]: [-10, -9, -8, -7, -6, -5, -4, -3, -2, -1]
In [10]: list(range(0, -10, -1))
Out[10]: [0, -1, -2, -3, -4, -5, -6, -7, -8, -9]
Объект range поддерживает все операции, которые поддерживают последовательности в Python, кроме сложения и умножения.
Проверка, входит ли число в диапазон, который описывает range:
In [11]: nums = range(5)
In [12]: nums
Out[12]: range(0, 5)
In [13]: 3 in nums
Out[13]: True
In [14]: 7 in nums
Out[14]: False
Note
Начиная с версии Python 3.2, эта проверка выполняется за постоянное время (O(1)).
Можно получить конкретный элемент диапазона:
In [15]: nums = range(5)
In [16]: nums[0]
Out[16]: 0
In [17]: nums[-1]
Out[17]: 4
Range поддерживает срезы:
In [18]: nums = range(5)
In [19]: nums[1:]
Out[19]: range(1, 5)
In [20]: nums[:3]
Out[20]: range(0, 3)
Можно получить длину диапазона:
In [21]: nums = range(5)
In [22]: len(nums)
Out[22]: 5
А также минимальный и максимальный элемент:
In [23]: nums = range(5)
In [24]: min(nums)
Out[24]: 0
In [25]: max(nums)
Out[25]: 4
Кроме того, объект range поддерживает метод index:
In [26]: nums = range(1, 7)
In [27]: nums.index(3)
Out[27]: 2