Команда ReQL: next

Синтаксис команды

cursor.next([wait=True])

Описание

Получить следующий элемент в курсоре.

Необязательный аргумент wait указывает, ожидать ли следующего доступного элемента и как долго:

• True: Ожидать неопределённо долго (по умолчанию).
• False: Не ожидать вообще. Если данные немедленно доступны, они будут возвращены; если они недоступны, будет поднято исключение ReqlTimeoutError.
• число: Ожидать до указанного числа секунд, пока данные не станут доступны, после чего будет поднято исключение ReqlTimeoutError.

Поведение next будет идентичным поведению False, None или числу 0.

Вызов next в первый раз для курсора предоставляет первый элемент курсора. Если набор данных исчерпан (например, вы извлекли все документы из таблицы), при вызове next будет поднято исключение ReqlCursorEmpty.

Пример: Получить следующий элемент.

cursor = r.table('superheroes').run(conn)
doc = cursor.next()

Пример: Получить следующий элемент в потоке изменений, ожидая до пяти секунд.

cursor = r.table('superheroes').changes().run(conn)
doc = cursor.next(wait=5)

Примечание: Последовательности RethinkDB могут быть итерированы через интерфейс Python Iterable. Стандартный способ получения всех результатов — использование цикла for…in или list().