MongoDB::QueryResult - An iterator for Mongo query results
version v0.999.998.5
$cursor = $coll->find( $filter ); $result = $cursor->result; while ( $doc = $result->next ) { process_doc($doc) }
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.
MongoDB::QueryResult
MongoDB::Cursor
Retrieving this object and iterating on it directly will be slightly more efficient.
Unless otherwise explictly 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:
When a MongoDB::QueryResult object is destroyed, a cursor termination request will be sent to the originating server to free server resources.
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.
while ( $doc = $result->next ) { process_doc($doc) }
Returns the next document or undef if the server cursor is exhausted.
undef
@docs = $result->all;
Returns all documents as a list.
David Golden <david@mongodb.com>
Mike Friedman <friedo@mongodb.com>
Kristina Chodorow <kristina@mongodb.com>
Florian Ragwitz <rafl@debian.org>
This software is Copyright (c) 2015 by MongoDB, Inc..
This is free software, licensed under:
The Apache License, Version 2.0, January 2004
To install MongoDB, copy and paste the appropriate command in to your terminal.
cpanm
cpanm MongoDB
CPAN shell
perl -MCPAN -e shell install MongoDB
For more information on module installation, please visit the detailed CPAN module installation guide.