LRANGE

LRANGE

LRANGE key start stop

Доступно с версии:

1.0.0

Временная сложность:

O(S+N), где S — расстояние от начального смещения до HEAD для коротких списков, от ближайшего конца (HEAD или TAIL) для длинных списков; и N — количество элементов в указанном диапазоне.

Категории ACL:

@read, @list, @slow,

Возвращает указанные элементы списка, хранящегося по адресу key. Смещения start и stop — индексы с нуля, где 0 — первый элемент списка (голова списка), 1 — следующий элемент и так далее.

Эти смещения также могут быть отрицательными числами, указывающими смещения, начинающиеся с конца списка. Например, -1 — последний элемент списка, -2 — предпоследний и так далее.

Совместимость с функциями диапазона в различных языках программирования

Обратите внимание, что если у вас есть список чисел от 0 до 100, LRANGE list 0 10 вернёт 11 элементов, то есть крайний правый элемент включается. Это может или может не совпадать с поведением функций, связанных с диапазонами, в вашем выбранном языке программирования (подумайте о Range.new, Array#slice в Ruby или функции range() в Python).

Индексы вне диапазона

Индексы вне диапазона не приведут к ошибке. Если start больше, чем конец списка, возвращается пустой список. Если stop больше, чем фактический конец списка, Redis обработает его как последний элемент списка.

Возврат

Массивный ответ: список элементов в заданном диапазоне.

Примеры

RPUSH mylist "one"
RPUSH mylist "two"
RPUSH mylist "three"
LRANGE mylist 0 0
LRANGE mylist -3 2
LRANGE mylist -100 100
LRANGE mylist 5 10