Class representing an input iterator of documents in a MongoDB cursor result set. More...

#include <cursor.hpp>

Public Types
using	value_type = bsoncxx::v_noabi::document::view
	std::iterator_traits

Public Member Functions
const bsoncxx::v_noabi::document::view &	operator* () const
	Dereferences the view for the document currently being pointed to.

const bsoncxx::v_noabi::document::view *	operator-> () const
	Accesses a member of the dereferenced document currently being pointed to.

iterator &	operator++ ()
	Pre-increments the iterator to move to the next document.

void	operator++ (int)
	Post-increments the iterator to move to the next document.

Detailed Description

Class representing an input iterator of documents in a MongoDB cursor result set.

All non-end iterators derived from the same mongocxx::v_noabi::cursor move in lock-step. Dereferencing any non-end() iterator always gives the first remaining document in the cursor. Incrementing one non-end iterator is equivalent to incrementing them all.

An iterator is 'exhausted' when no documents are available. An end-iterator is always exhausted. A non-end iterator is exhausted when the originating mongocxx::v_noabi::cursor has no more documents. When an iterator is exhausted, it must not be dereferenced or incremented.

For iterators of a tailable cursor, calling cursor.begin() may revive an exhausted iterator so that it no longer compares equal to the end-iterator.

Member Function Documentation

◆ operator++() [1/2]

iterator & mongocxx::v_noabi::cursor::iterator::operator++ ( )

Pre-increments the iterator to move to the next document.

Exceptions

mongocxx::v_noabi::query_exception if the query failed

◆ operator++() [2/2]

void mongocxx::v_noabi::cursor::iterator::operator++ ( int )

Post-increments the iterator to move to the next document.

Exceptions

mongocxx::v_noabi::query_exception if the query failed

Friends And Related Symbol Documentation

◆ operator!=

bool operator!=	(	const iterator &	,
		const iterator &
	)

friend

Compare two iterators for (in)-equality.

Iterators compare equal if they point to the same underlying cursor or if both are exhausted.

◆ operator==

bool operator==	(	const iterator &	,
		const iterator &
	)