Back to top

ReQL command: list

Command syntax

list(cursor)

Description

Retrieve all results as a list.

RethinkDB sequences can be iterated through via the Python Iterable interface; to coerce a cursor into a list, use the Python list() class constructor.

Example: For small result sets it may be more convenient to process them at once as an array.

cursor = r.table('users').run()
users = list(cursor)
process_results(users)

The equivalent query with a for loop would be:

cursor = r.table('users').run()
for doc in cursor:
    process_results(doc)

Note: Because a feed is a cursor that never terminates, using list with a feed will never return. Use for or next instead. See the changes command for more information on feeds.

Get more help

Couldn't find what you were looking for?