ReQL command: toList

Command syntax

cursor.toList()

Description

Retrieve all results from a cursor as a list.

RethinkDB cursors can be iterated through via the Java Iterable and Iterator interfaces; to coerce a cursor into a list, use toList.

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

Cursor cursor = r.table("users").run(conn);
List users = cursor.toList();
processResults(users);

The equivalent query with a for loop would be:

Cursor cursor = r.table("users").run(conn);
for (Object doc : cursor) {
    processResults(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.

Related commands

• next
• for
• close (cursor)

Get more help

Couldn't find what you were looking for?

• Ask a question on Stack Overflow
• Chat with us and our community on Slack
• Talk to the team on IRC on #[email protected] — via Webchat
• Ping @rethinkdb on Twitter
• Post an issue on the documentation issue tracker on GitHub