Class representing the optional arguments to a MongoDB create index operation. More...

#include <index.hpp>

Classes
class	base_storage_options
	Base class representing the optional storage engine options for indexes. More...

class	wiredtiger_storage_options
	Class representing the optional WiredTiger storage engine options for indexes. More...

Public Member Functions
void	background (bool background)
	Whether or not to build the index in the background so that building the index does not block other database activities.

const stdx::optional< bool > &	background () const
	The current background setting.

void	unique (bool unique)
	Whether or not to create a unique index so that the collection will not accept insertion of documents where the index key or keys match an existing value in the index.

const stdx::optional< bool > &	unique () const
	The current unique setting.

void	name (bsoncxx::string::view_or_value name)
	The name of the index.

const stdx::optional< bsoncxx::string::view_or_value > &	name () const
	The current name setting.

void	sparse (bool sparse)
	Whether or not to create a sparse index.

const stdx::optional< bool > &	sparse () const
	The current sparse setting.

void	storage_options (std::unique_ptr< base_storage_options > storage_options)
	Optionally used only in MongoDB 3.0.0 and higher.

void	storage_options (std::unique_ptr< wiredtiger_storage_options > storage_options)

void	expire_after_seconds (std::int32_t expire_after_seconds)
	Set a value, in seconds, as a TTL to control how long MongoDB retains documents in this collection.

const stdx::optional< std::int32_t > &	expire_after_seconds () const
	The current expire_after_seconds setting.

void	version (std::int32_t v)
	Sets the index version.

const stdx::optional< std::int32_t > &	version () const
	The current index version.

void	weights (bsoncxx::document::view weights)
	For text indexes, sets the weight document.

const stdx::optional< bsoncxx::document::view > &	weights () const
	The current weights setting.

void	default_language (bsoncxx::string::view_or_value default_language)
	For text indexes, the language that determines the list of stop words and the rules for the stemmer and tokenizer.

const stdx::optional< bsoncxx::string::view_or_value > &	default_language () const
	The current default_language setting.

void	language_override (bsoncxx::string::view_or_value language_override)
	For text indexes, the name of the field, in the collection’s documents, that contains the override language for the document.

const stdx::optional< bsoncxx::string::view_or_value > &	language_override () const
	The current name of the field that contains the override language for text indexes.

void	partial_filter_expression (bsoncxx::document::view partial_filter_expression)
	Sets the document for the partial filter expression for partial indexes.

const stdx::optional< bsoncxx::document::view > &	partial_filter_expression () const
	The current partial_filter_expression setting.

void	twod_sphere_version (std::uint8_t twod_sphere_version)
	For 2dsphere indexes, the 2dsphere index version number.

const stdx::optional< std::uint8_t > &	twod_sphere_version () const
	The current twod_sphere_version setting.

void	twod_bits_precision (std::uint8_t twod_bits_precision)
	For 2d indexes, the precision of the stored geohash value of the location data.

const stdx::optional< std::uint8_t > &	twod_bits_precision () const
	The current precision of the stored geohash value of the location data.

void	twod_location_min (double twod_location_min)
	For 2d indexes, the lower inclusive boundary for the longitude and latitude values.

const stdx::optional< double > &	twod_location_min () const
	The current lower inclusive boundary for the longitude and latitude values.

void	twod_location_max (double twod_location_max)
	For 2d indexes, the upper inclusive boundary for the longitude and latitude values.

const stdx::optional< double > &	twod_location_max () const
	The current upper inclusive boundary for the longitude and latitude values.

void	haystack_bucket_size (double haystack_bucket_size)
	For geoHaystack indexes, specify the number of units within which to group the location values; i.e.

const stdx::optional< double > &	haystack_bucket_size () const
	The current haystack_bucket_size setting.

Detailed Description

Class representing the optional arguments to a MongoDB create index operation.

See also: http://docs.mongodb.org/manual/reference/method/db.collection.createIndex/#options

Member Function Documentation

◆ background() [1/2]

const stdx::optional< bool > & mongocxx::options::index::background ( ) const

The current background setting.

Returns: The current background.

◆ background() [2/2]

void mongocxx::options::index::background ( bool background )

Whether or not to build the index in the background so that building the index does not block other database activities.

The default is to build indexes in the foreground

Parameters

background Whether or not to build the index in the background.

See also: https://docs.mongodb.org/manual/tutorial/build-indexes-in-the-background/

◆ default_language() [1/2]

const stdx::optional< bsoncxx::string::view_or_value > & mongocxx::options::index::default_language ( ) const

The current default_language setting.

Returns: The current default_language.

◆ default_language() [2/2]

void mongocxx::options::index::default_language ( bsoncxx::string::view_or_value default_language )

For text indexes, the language that determines the list of stop words and the rules for the stemmer and tokenizer.

Parameters

default_language The default language used when creating text indexes.

◆ expire_after_seconds() [1/2]

const stdx::optional< std::int32_t > & mongocxx::options::index::expire_after_seconds ( ) const

The current expire_after_seconds setting.

Returns: The current expire_after_seconds.

◆ expire_after_seconds() [2/2]

void mongocxx::options::index::expire_after_seconds ( std::int32_t expire_after_seconds )

Set a value, in seconds, as a TTL to control how long MongoDB retains documents in this collection.

Parameters

expire_after_seconds The amount of time, in seconds, to retain documents.

See also: https://docs.mongodb.org/manual/core/index-ttl/

◆ haystack_bucket_size() [1/2]

const stdx::optional< double > & mongocxx::options::index::haystack_bucket_size ( ) const

The current haystack_bucket_size setting.

Returns: The current haystack_bucket_size.

◆ haystack_bucket_size() [2/2]

void mongocxx::options::index::haystack_bucket_size ( double haystack_bucket_size )

For geoHaystack indexes, specify the number of units within which to group the location values; i.e.

group in the same bucket those location values that are within the specified number of units to each other.

See also: https://docs.mongodb.org/manual/core/geohaystack/

Parameters

haystack_bucket_size The geoHaystack bucket size.

◆ language_override() [1/2]

const stdx::optional< bsoncxx::string::view_or_value > & mongocxx::options::index::language_override ( ) const

The current name of the field that contains the override language for text indexes.

Returns: The name of the field that contains the override language for text indexes.

◆ language_override() [2/2]

void mongocxx::options::index::language_override ( bsoncxx::string::view_or_value language_override )

For text indexes, the name of the field, in the collection’s documents, that contains the override language for the document.

Parameters

language_override The name of the field that contains the override language for text indexes.

◆ name() [1/2]

const stdx::optional< bsoncxx::string::view_or_value > & mongocxx::options::index::name ( ) const

The current name setting.

Returns: The current name.

◆ name() [2/2]

void mongocxx::options::index::name ( bsoncxx::string::view_or_value name )

The name of the index.

Parameters

name	The name of the index.

◆ partial_filter_expression() [1/2]

const stdx::optional< bsoncxx::document::view > & mongocxx::options::index::partial_filter_expression ( ) const

The current partial_filter_expression setting.

Returns: The current partial_filter_expression.

◆ partial_filter_expression() [2/2]

void mongocxx::options::index::partial_filter_expression ( bsoncxx::document::view partial_filter_expression )

Sets the document for the partial filter expression for partial indexes.

Parameters

partial_filter_expression The partial filter expression document.

◆ sparse() [1/2]

const stdx::optional< bool > & mongocxx::options::index::sparse ( ) const

The current sparse setting.

Returns: The current sparse setting.

◆ sparse() [2/2]

void mongocxx::options::index::sparse ( bool sparse )

Whether or not to create a sparse index.

Sparse indexes only reference documents with the indexed fields.

Parameters

sparse Whether or not to create a sparse index.

See also: https://docs.mongodb.org/manual/core/index-sparse/

◆ storage_options() [1/2]

void mongocxx::options::index::storage_options ( std::unique_ptr< base_storage_options > storage_options )

Optionally used only in MongoDB 3.0.0 and higher.

Specifies the storage engine options for the index.

Parameters

storage_options The storage engine options for the index.

◆ storage_options() [2/2]

void mongocxx::options::index::storage_options ( std::unique_ptr< wiredtiger_storage_options > storage_options )

Todo:: document this method

◆ twod_bits_precision() [1/2]

const stdx::optional< std::uint8_t > & mongocxx::options::index::twod_bits_precision ( ) const

The current precision of the stored geohash value of the location data.

Returns: The precision of the stored geohash value of the location data.

◆ twod_bits_precision() [2/2]

void mongocxx::options::index::twod_bits_precision ( std::uint8_t twod_bits_precision )

For 2d indexes, the precision of the stored geohash value of the location data.

Parameters

twod_bits_precision The precision of the stored geohash value.

◆ twod_location_max() [1/2]

const stdx::optional< double > & mongocxx::options::index::twod_location_max ( ) const

The current upper inclusive boundary for the longitude and latitude values.

Returns: The upper inclusive boundary for the longitude and latitude values.

◆ twod_location_max() [2/2]

void mongocxx::options::index::twod_location_max ( double twod_location_max )

For 2d indexes, the upper inclusive boundary for the longitude and latitude values.

Parameters

twod_location_max The upper inclusive boundary.

◆ twod_location_min() [1/2]

const stdx::optional< double > & mongocxx::options::index::twod_location_min ( ) const

The current lower inclusive boundary for the longitude and latitude values.

Returns: The lower inclusive boundary for the longitude and latitude values.

◆ twod_location_min() [2/2]

void mongocxx::options::index::twod_location_min ( double twod_location_min )

For 2d indexes, the lower inclusive boundary for the longitude and latitude values.

Parameters

twod_location_min The lower inclusive boundary.

◆ twod_sphere_version() [1/2]

const stdx::optional< std::uint8_t > & mongocxx::options::index::twod_sphere_version ( ) const

The current twod_sphere_version setting.

Returns: The current twod_sphere_version.

◆ twod_sphere_version() [2/2]

void mongocxx::options::index::twod_sphere_version ( std::uint8_t twod_sphere_version )

For 2dsphere indexes, the 2dsphere index version number.

Version can be either 1 or 2.

Parameters

twod_sphere_version The 2dsphere index version number.

◆ unique() [1/2]

const stdx::optional< bool > & mongocxx::options::index::unique ( ) const

The current unique setting.

Returns: The current unique.

◆ unique() [2/2]

void mongocxx::options::index::unique ( bool unique )

Whether or not to create a unique index so that the collection will not accept insertion of documents where the index key or keys match an existing value in the index.

Parameters

unique Whether or not to create a unique index.

See also: https://docs.mongodb.org/manual/core/index-unique/

◆ version() [1/2]

const stdx::optional< std::int32_t > & mongocxx::options::index::version ( ) const

The current index version.

Returns: The current index version.

◆ version() [2/2]

void mongocxx::options::index::version ( std::int32_t v )

Sets the index version.

Parameters

version The index version.

◆ weights() [1/2]

const stdx::optional< bsoncxx::document::view > & mongocxx::options::index::weights ( ) const

The current weights setting.

Returns: The current weights.

◆ weights() [2/2]

void mongocxx::options::index::weights ( bsoncxx::document::view weights )

For text indexes, sets the weight document.

The weight document contains field and weight pairs.

Parameters

weights The weight document for text indexes.

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

src/mongocxx/options/index.hpp

Classes

Public Member Functions

Detailed Description

Member Function Documentation

◆ background() [1/2]

◆ background() [2/2]

◆ default_language() [1/2]

◆ default_language() [2/2]

◆ expire_after_seconds() [1/2]

◆ expire_after_seconds() [2/2]

◆ haystack_bucket_size() [1/2]

◆ haystack_bucket_size() [2/2]

◆ language_override() [1/2]

◆ language_override() [2/2]

◆ name() [1/2]

◆ name() [2/2]

◆ partial_filter_expression() [1/2]

◆ partial_filter_expression() [2/2]

◆ sparse() [1/2]

◆ sparse() [2/2]

◆ storage_options() [1/2]

◆ storage_options() [2/2]

◆ twod_bits_precision() [1/2]

◆ twod_bits_precision() [2/2]

◆ twod_location_max() [1/2]

◆ twod_location_max() [2/2]

◆ twod_location_min() [1/2]

◆ twod_location_min() [2/2]

◆ twod_sphere_version() [1/2]

◆ twod_sphere_version() [2/2]

◆ unique() [1/2]

◆ unique() [2/2]

◆ version() [1/2]

◆ version() [2/2]

◆ weights() [1/2]

◆ weights() [2/2]