VERSION
version v1.2.3SYNOPSIS
$cursor = $coll->find( $filter );
$result = $cursor->result;
while ( $doc = $result->next ) {
process_doc($doc)
}
DESCRIPTION
This class defines an iterator against a query result. It automatically fetches additional results from the originating mongod/mongos server on demand.For backwards compatibility reasons, MongoDB::Cursor encapsulates query parameters and generates a "MongoDB::QueryResult" object on demand. All iterators on "MongoDB::Cursor" delegate to "MongoDB::QueryResult" object.
Retrieving this object and iterating on it directly will be slightly more efficient.
USAGE
Error handling
Unless otherwise explicitly documented, all methods throw exceptions if an error occurs. The error types are documented in MongoDB::Error.To catch and handle errors, the Try::Tiny and Safe::Isa modules are recommended:
Cursor destruction
When a "MongoDB::QueryResult" object is destroyed, a cursor termination request will be sent to the originating server to free server resources.METHODS
has_next
if ( $response->has_next ) { ... }
Returns true if additional documents are available. This will attempt to get another batch of documents from the server if necessary.
next
while ( $doc = $result->next ) { process_doc($doc) }
Returns the next document or "undef" if the server cursor is exhausted.
batch
while ( @batch = $result->batch ) { for $doc ( @batch ) { process_doc($doc); } }
Returns the next batch of documents or an empty list if the server cursor is exhausted.
all
@docs = $result->all;
Returns all documents as a list.
AUTHORS
- David Golden <[email protected]>
- Mike Friedman <[email protected]>
- Kristina Chodorow <[email protected]>
- Florian Ragwitz <[email protected]>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2016 by MongoDB, Inc..This is free software, licensed under:
The Apache License, Version 2.0, January 2004