Class representing a hint to be passed to a database operation. More...

#include <hint.hpp>

Public Member Functions
	hint (bsoncxx::v_noabi::document::view_or_value index)
	Constructs a new hint.

	hint (bsoncxx::v_noabi::string::view_or_value index)
	Constructs a new hint.

bsoncxx::v_noabi::types::bson_value::view	to_value () const
	Returns a types::bson_value::view representing this hint.

	operator bsoncxx::v_noabi::types::bson_value::view () const
	Returns a types::bson_value::view representing this hint.

Related Symbols
(Note that these are not member symbols.)
bool	operator== (std::string index, const hint &index_hint)
	Convenience methods to compare for equality against an index name.

bool	operator== (bsoncxx::v_noabi::document::view index, const hint &index_hint)
	Convenience methods to compare for equality against an index document.

Detailed Description

Class representing a hint to be passed to a database operation.

Constructor & Destructor Documentation

◆ hint() [1/2]

mongocxx::v_noabi::hint::hint ( bsoncxx::v_noabi::document::view_or_value index )

Constructs a new hint.

Note: this constructor is purposefully not explicit, to allow conversion from either document::view or document::value to view_or_value.

Parameters

index Document view or value representing the index to be used.

◆ hint() [2/2]

mongocxx::v_noabi::hint::hint ( bsoncxx::v_noabi::string::view_or_value index )

explicit

Constructs a new hint.

Parameters

index String representing the name of the index to be used.

Member Function Documentation

◆ operator bsoncxx::v_noabi::types::bson_value::view()

mongocxx::v_noabi::hint::operator bsoncxx::v_noabi::types::bson_value::view ( ) const

Returns a types::bson_value::view representing this hint.

Returns: Hint, as a types::bson_value::view. The caller must ensure that the returned object not outlive the hint object that it was created from.

◆ to_value()

bsoncxx::v_noabi::types::bson_value::view mongocxx::v_noabi::hint::to_value ( ) const

Returns a types::bson_value::view representing this hint.

Returns: Hint, as a types::bson_value::view. The caller must ensure that the returned object not outlive the hint object that it was created from.

Friends And Related Symbol Documentation

◆ operator!=() [1/2]

bool operator!=	(	const hint &	index_hint,
		bsoncxx::v_noabi::document::view	index
	)

Return true if this hint contains an index document that matches.

◆ operator!=() [2/2]

bool operator!=	(	const hint &	index_hint,
		std::string	index
	)

Return true if this hint contains an index name that matches.

◆ operator==() [1/4]

bool operator==	(	bsoncxx::v_noabi::document::view	index,
		const hint &	index_hint
	)

Return true if this hint contains an index document that matches.

◆ operator== [2/4]

bool operator==	(	const hint &	index_hint,
		bsoncxx::v_noabi::document::view	index
	)

friend

Compare this hint to a string for (in)-equality.

◆ operator== [3/4]

bool operator==	(	const hint &	index_hint,
		std::string	index
	)