rmongodb (version 1.8.0)

mongo.cursor.next: Advance a cursor to the next record

Description

mongo.cursor.next(cursor) is used to step to the first or next record.

Usage

mongo.cursor.next(cursor)

Arguments

cursor

(mongo.cursor) A mongo.cursor object returned from mongo.find().

Value

TRUE if there is a next record; otherwise, FALSE.

Details

mongo.cursor.value(cursor) may then be used to examine it.

See Also

mongo.find, mongo.cursor, mongo.cursor.value, mongo.cursor.destroy.

Examples

mongo <- mongo.create()
if (mongo.is.connected(mongo)) {
    buf <- mongo.bson.buffer.create()
    mongo.bson.buffer.append(buf, "city", "St. Louis")
    query <- mongo.bson.from.buffer(buf)

    # Find the first 1000 records in collection people
    # of database test where city == "St. Louis"
    cursor <- mongo.find(mongo, "test.people", query, limit=1000L)
    # Step though the matching records and display them
    while (mongo.cursor.next(cursor))
        print(mongo.cursor.value(cursor))
    mongo.cursor.destroy(cursor)
}