mongo.cursor.destroy: Release resources attached to a cursor
In jonkatz2/rmongodb: R-MongoDB driver

Description Usage Arguments Details Value See Also Examples

mongo.cursor.destroy(cursor) is used to release resources attached to a cursor on both the client and server.

1	mongo.cursor.destroy(cursor)

cursor

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

Note that mongo.cursor.destroy(cursor) may be called before all records of a result set are iterated through (for example, if a desired record is located in the result set).

Although the 'destroy' functions in this package are called automatically by garbage collection, this one in particular should be called as soon as feasible when finished with the cursor so that server resources are freed.

TRUE if successful; otherwise, FALSE (when an error occurs during sending the Kill Cursor operation to the server). in either case, the cursor should not be used for further operations.

mongo.find,
mongo.cursor,
mongo.cursor.next,
mongo.cursor.value.

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.destroy(cursor))
    mongo.cursor.destroy(cursor)
}