MongoDB::QueryResult3pm

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.

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.