MongoDB::QueryResult(3pm) - phpMan

MongoDB::QueryResult(3pm)      User Contributed Perl Documentation      MongoDB::QueryResult(3pm)

NAME
       MongoDB::QueryResult - An iterator for Mongo query results

VERSION
       version v2.2.2

SYNOPSIS
           $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.

   Multithreading
       NOTE: Per threads documentation, use of Perl threads is discouraged by the maintainers of
       Perl and the MongoDB Perl driver does not test or provide support for use with threads.

       Iterators are cloned in threads, but not reset.  Iterating from multiple threads will give
       unpredictable results.  Only iterate from a single thread.

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
       o   David Golden <david AT mongodb.com>

       o   Rassi <rassi AT mongodb.com>

       o   Mike Friedman <friedo AT friedo.com>

       o   Kristina Chodorow <k.chodorow AT gmail.com>

       o   Florian Ragwitz <rafl AT debian.org>

COPYRIGHT AND LICENSE
       This software is Copyright (c) 2020 by MongoDB, Inc.

       This is free software, licensed under:

         The Apache License, Version 2.0, January 2004

perl v5.30.3                                2020-08-15                  MongoDB::QueryResult(3pm)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-12-12 16:50 @3.145.32.95 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)