cursorNext {rethinker}

Pull next object from a cursor

Description

Pulls a datum from a given cursor, sending continuation queries when needed.

Usage

cursorNext(cursor, inBatch = FALSE)

Arguments

cursor

Cursor to pull from; a result of r()$...$run(...).

inBatch

If set to TRUE, enables batch mode, i.e., returning the whole local cache (this is usually NOT the whole data available under cursor) rather than a single result. Values other than TRUE or FALSE are invalid.

Value

In a default mode, a list representing the returned response JSON, or NULL if no data is available. In a batch mode, list of such lists representing the whole cache (which may be empty, corresponding to default mode's NULL).

Note

When this function empties local cache, it may ask RethinkDB for more data and hence block. Use isCursorEmpty to decide if it makes sense to call cursorNext. In case you don't need any more answers for the query, close cursor with close method.

Author(s)

Miron B. Kursa