Class representing a MongoDB index view. More...

#include <index_view.hpp>

Detailed Description

Class representing a MongoDB index view.

Member Function Documentation

◆ create_many() [1/2]

bsoncxx::v_noabi::document::value mongocxx::v_noabi::index_view::create_many	(	const client_session &	session,
		const std::vector< index_model > &	indexes,
		const options::index_view &	options = `options::index_view{}`
	)

Adds a container of indexes to the collection.

Parameters

session	The mongocxx::v_noabi::client_session with which to perform the operation.
indexes	std::vector containing index models describing the indexes being created.
options	Optional arguments for the overall operation, see mongocxx::v_noabi::options::index_view.

Returns: The result document sent back by the server as if the createIndexes command was run from the shell.

Exceptions

Throws operation_exception for any errors encountered by the server or if max_time_ms option is present and the operation exceeds the time limit.

See also: https://www.mongodb.com/docs/manual/reference/method/cursor.maxTimeMS/

◆ create_many() [2/2]

bsoncxx::v_noabi::document::value mongocxx::v_noabi::index_view::create_many	(	const std::vector< index_model > &	indexes,
		const options::index_view &	options = `options::index_view{}`
	)

Adds a container of indexes to the collection.

Parameters

indexes	std::vector containing index models describing the indexes being created.
options	Optional arguments for the overall operation, see mongocxx::v_noabi::options::index_view.

Returns: The result document sent back by the server as if the createIndexes command was run from the shell.

Exceptions

Throws operation_exception for any errors encountered by the server or if max_time_ms option is present and the operation exceeds the time limit.

See also: https://www.mongodb.com/docs/manual/reference/method/cursor.maxTimeMS/

◆ create_one() [1/4]

stdx::optional< std::string > mongocxx::v_noabi::index_view::create_one	(	const bsoncxx::v_noabi::document::view_or_value &	keys,
		const bsoncxx::v_noabi::document::view_or_value &	index_options = `{}`,
		const options::index_view &	options = `options::index_view{}`
	)

Creates an index.

A convenience method that calls create_many.

Parameters

keys	A document containing the index keys and their corresponding index types.
index_options	A document containing set of options that controls the creation of the index. See https://www.mongodb.com/docs/manual/reference/method/db.collection.createIndex/.
options	Optional arguments for the overall operation, see mongocxx::v_noabi::options::index_view.

Returns: An optional containing the name of the created index. If and index with the same keys already exists, an empty optional is returned.

Exceptions

Throws operation_exception for any errors encountered by the server or if max_time_ms option is present and the operation exceeds the time limit.

See also: https://www.mongodb.com/docs/manual/reference/method/db.collection.createIndex/

◆ create_one() [2/4]

stdx::optional< std::string > mongocxx::v_noabi::index_view::create_one	(	const client_session &	session,
		const bsoncxx::v_noabi::document::view_or_value &	keys,
		const bsoncxx::v_noabi::document::view_or_value &	index_options = `{}`,
		const options::index_view &	options = `options::index_view{}`
	)

Creates an index.

A convenience method that calls create_many.

Parameters

session	The mongocxx::v_noabi::client_session with which to perform the operation.
keys	A document containing the index keys and their corresponding index types.
index_options	A document containing set of options that controls the creation of the index. See https://www.mongodb.com/docs/manual/reference/method/db.collection.createIndex/.
options	Optional arguments for the overall operation, see mongocxx::v_noabi::options::index_view.

Returns: An optional containing the name of the created index. If and index with the same keys already exists, an empty optional is returned.

Exceptions

Throws operation_exception for any errors encountered by the server or if max_time_ms option is present and the operation exceeds the time limit.

See also: https://www.mongodb.com/docs/manual/reference/method/db.collection.createIndex/

◆ create_one() [3/4]

stdx::optional< std::string > mongocxx::v_noabi::index_view::create_one	(	const client_session &	session,
		const index_model &	index,
		const options::index_view &	options = `options::index_view{}`
	)

Creates an index.

A convenience method that calls create_many.

Parameters

session	The mongocxx::v_noabi::client_session with which to perform the operation.
index	Index_model describing the index being created.
options	Optional arguments for the overall operation, see mongocxx::v_noabi::options::index_view.

Returns: An optional containing the name of the created index. If and index with the same keys already exists, an empty optional is returned.

Exceptions

Throws operation_exception for any errors encountered by the server or if max_time_ms option is present and the operation exceeds the time limit.

See also: https://www.mongodb.com/docs/manual/reference/method/cursor.maxTimeMS/

◆ create_one() [4/4]

stdx::optional< std::string > mongocxx::v_noabi::index_view::create_one	(	const index_model &	index,
		const options::index_view &	options = `options::index_view{}`
	)

Creates an index.

A convenience method that calls create_many.

Parameters

index	Index_model describing the index being created.
options	Optional arguments for the overall operation, see mongocxx::v_noabi::options::index_view.

Returns: An optional containing the name of the created index. If and index with the same keys already exists, an empty optional is returned.

Exceptions

Throws operation_exception for any errors encountered by the server or if max_time_ms option is present and the operation exceeds the time limit.

See also: https://www.mongodb.com/docs/manual/reference/method/cursor.maxTimeMS/

◆ drop_all() [1/2]

void mongocxx::v_noabi::index_view::drop_all	(	const client_session &	session,
		const options::index_view &	options = `options::index_view{}`
	)

Drops all indexes in the collection.

Parameters

session	The mongocxx::v_noabi::client_session with which to perform the drop.
options	Optional arguments for the overall operation, see mongocxx::v_noabi::options::index_view.

Exceptions

Throws operation_exception for any errors encountered by the server or if max_time_ms option is present and the operation exceeds the time limit.

See also: https://www.mongodb.com/docs/manual/reference/method/cursor.maxTimeMS/

◆ drop_all() [2/2]

void mongocxx::v_noabi::index_view::drop_all ( const options::index_view & options = options::index_view{} )

Drops all indexes in the collection.

Parameters

options Optional arguments for the overall operation, see mongocxx::v_noabi::options::index_view.

Exceptions

Throws operation_exception for any errors encountered by the server or if max_time_ms option is present and the operation exceeds the time limit.

See also: https://www.mongodb.com/docs/manual/reference/method/cursor.maxTimeMS/

◆ drop_one() [1/6]

void mongocxx::v_noabi::index_view::drop_one	(	const bsoncxx::v_noabi::document::view_or_value &	keys,
		const bsoncxx::v_noabi::document::view_or_value &	index_options = `{}`,
		const options::index_view &	options = `options::index_view{}`
	)

Attempts to drop a single index from the collection given the keys and options.

Parameters

keys	A document containing the index keys and their corresponding index types. If no name option is present in the options, a name based on the keys will be used.
index_options	(optional) A document containing set of options used to create the index. Only the name field will be used from here, and if it is not included, a name based on they keys will be used.
options	Optional arguments for the overall operation, see mongocxx::v_noabi::options::index_view.

Exceptions

Throws	bsoncxx::v_noabi::exception if "name" key is present in options but is not a string.
Throws	operation_exception for any errors encountered by the server or if max_time_ms option is present and the operation exceeds the time limit.
Throws	logic_error if "*" is passed in for the index name

See also: https://www.mongodb.com/docs/manual/reference/method/cursor.maxTimeMS/

◆ drop_one() [2/6]

void mongocxx::v_noabi::index_view::drop_one	(	const client_session &	session,
		const bsoncxx::v_noabi::document::view_or_value &	keys,
		const bsoncxx::v_noabi::document::view_or_value &	index_options = `{}`,
		const options::index_view &	options = `options::index_view{}`
	)

Attempts to drop a single index from the collection given the keys and options.

Parameters

session	The mongocxx::v_noabi::client_session with which to perform the drop.
keys	A document containing the index keys and their corresponding index types. If no name option is present in the options, a name based on the keys will be used.
index_options	(optional) A document containing set of options used to create the index. Only the name field will be used from here, and if it is not included, a name based on they keys will be used.
options	Optional arguments for the overall operation, see mongocxx::v_noabi::options::index_view.

Exceptions

Throws	bsoncxx::v_noabi::exception if "name" key is present in options but is not a string.
Throws	operation_exception for any errors encountered by the server or if max_time_ms option is present and the operation exceeds the time limit.
Throws	logic_error if "*" is passed in for the index name

See also: https://www.mongodb.com/docs/manual/reference/method/cursor.maxTimeMS/

◆ drop_one() [3/6]

void mongocxx::v_noabi::index_view::drop_one	(	const client_session &	session,
		const index_model &	index,
		const options::index_view &	options = `options::index_view{}`
	)

Attempts to drop a single index from the collection given an index model.

Parameters

session	The mongocxx::v_noabi::client_session with which to perform the drop.
index	An index model describing the index being dropped.
options	Optional arguments for the overall operation, see mongocxx::v_noabi::options::index_view.

Exceptions

Throws	bsoncxx::v_noabi::exception if "name" key is present in options but is not a string.
Throws	operation_exception for any errors encountered by the server or if max_time_ms option is present and the operation exceeds the time limit.
Throws	logic_error if "*" is passed in for the index name

See also: https://www.mongodb.com/docs/manual/reference/method/cursor.maxTimeMS/

◆ drop_one() [4/6]

void mongocxx::v_noabi::index_view::drop_one	(	const client_session &	session,
		stdx::string_view	name,
		const options::index_view &	options = `options::index_view{}`
	)

Drops a single index by name.

Parameters

session	The mongocxx::v_noabi::client_session with which to perform the drop.
name	The name of the index being dropped.
options	Optional arguments for the overall operation, see mongocxx::v_noabi::options::index_view.

Exceptions

Throws	operation_exception for any errors encountered by the server or if max_time_ms option is present and the operation exceeds the time limit.
Throws	logic_error if "*" is passed in for the index name.

See also: https://www.mongodb.com/docs/manual/reference/method/cursor.maxTimeMS/

◆ drop_one() [5/6]

void mongocxx::v_noabi::index_view::drop_one	(	const index_model &	index,
		const options::index_view &	options = `options::index_view{}`
	)

Attempts to drop a single index from the collection given an index model.

Parameters

index	An index model describing the index being dropped.
options	Optional arguments for the overall operation, see mongocxx::v_noabi::options::index_view.

Exceptions

Throws	bsoncxx::v_noabi::exception if "name" key is present in options but is not a string.
Throws	operation_exception for any errors encountered by the server or if max_time_ms option is present and the operation exceeds the time limit.
Throws	logic_error if "*" is passed in for the index name

See also: https://www.mongodb.com/docs/manual/reference/method/cursor.maxTimeMS/

◆ drop_one() [6/6]

void mongocxx::v_noabi::index_view::drop_one	(	stdx::string_view	name,
		const options::index_view &	options = `options::index_view{}`
	)

Drops a single index by name.

Parameters

name	The name of the index being dropped.
options	Optional arguments for the overall operation, see mongocxx::v_noabi::options::index_view.

Exceptions

Throws	operation_exception for any errors encountered by the server or if max_time_ms option is present and the operation exceeds the time limit.
Throws	logic_error if "*" is passed in for the index name.

See also: https://www.mongodb.com/docs/manual/reference/method/cursor.maxTimeMS/

◆ list()

cursor mongocxx::v_noabi::index_view::list ( const client_session & session )

Returns a cursor over all the indexes.

Parameters

session The mongocxx::v_noabi::client_session with which to perform the list operation.

The documentation for this class was generated from the following file:

src/mongocxx/include/mongocxx/v_noabi/mongocxx/index_view.hpp