Class representing the server-side requirement for reporting the success of a write operation. More...

#include <write_concern.hpp>

Public Types
enum	level
	A class to represent the special case values for write_concern::nodes. More...

Public Member Functions
	write_concern ()
	Constructs a new write_concern.

	write_concern (const write_concern &)
	Copy constructs a write_concern.

write_concern &	operator= (const write_concern &)
	Copy assigns a write_concern.

	write_concern (write_concern &&) noexcept
	Move constructs a write_concern.

write_concern &	operator= (write_concern &&) noexcept
	Move assigns a write_concern.

	~write_concern ()
	Destroys a write_concern.

void	journal (bool journal)
	Sets the journal parameter for this write concern. More...

void	nodes (std::int32_t confirm_from)
	Sets the number of nodes that are required to acknowledge the write before the operation is considered successful. More...

void	acknowledge_level (level confirm_level)
	Sets the acknowledge level. More...

void	majority (std::chrono::milliseconds timeout)
	Requires that a majority of the nodes in a replica set acknowledge a write operation before it is considered a success. More...

void	tag (stdx::string_view tag)
	Sets the name representing the server-side getLastErrorMode entry containing the list of nodes that must acknowledge a write operation before it is considered a success. More...

void	timeout (std::chrono::milliseconds timeout)
	Sets an upper bound on the time a write concern can take to be satisfied. More...

bool	journal () const
	Gets the current status of the journal parameter. More...

stdx::optional< std::int32_t >	nodes () const
	Gets the current number of nodes that this write_concern requires operations to reach. More...

stdx::optional< level >	acknowledge_level () const
	Gets the current acknowledgment level. More...

stdx::optional< std::string >	tag () const
	Gets the current getLastErrorMode that is required by this write_concern. More...

bool	majority () const
	Gets whether the majority of nodes is currently required by this write_concern. More...

std::chrono::milliseconds	timeout () const
	Gets the current timeout for this write_concern. More...

Detailed Description

Class representing the server-side requirement for reporting the success of a write operation.

The strength of the write concern setting determines the level of guarantees that you will receive from MongoDB regarding write durability.

Weaker requirements that provide fewer guarantees report on success quickly while stronger requirements that provide greater guarantees will take longer (or potentially forever, if the write_concern's requirements are not satisfied and no timeout is set).

MongoDB drivers allow for different levels of write concern to better address the specific needs of applications. Clients may adjust write concern to ensure that the most important operations persist successfully to an entire MongoDB deployment. However, for other less critical operations, clients can adjust the write concern to ensure better performance rather than persistence to the entire deployment.

See also: http://docs.mongodb.org/manual/core/write-concern/

Member Enumeration Documentation

enum mongocxx::write_concern::level

strong

A class to represent the special case values for write_concern::nodes.

See also: http://docs.mongodb.org/manual/reference/write-concern/#w-option

Member Function Documentation

void mongocxx::write_concern::acknowledge_level ( level confirm_level )

Sets the acknowledge level.

See also: http://docs.mongodb.org/manual/reference/write-concern/#w-option

Parameters

confirm_level Either level::k_unacknowledged, level::k_default, or level::k_majority.

Note: the acknowledge level of level::k_tag is set automatically when a tag is set.

Warning: Setting this to level::k_unacknowledged disables write acknowledgment and all other write concern options.

Exceptions

mongocxx::exception for an unknown confirm_level.

stdx::optional<level> mongocxx::write_concern::acknowledge_level ( ) const

Gets the current acknowledgment level.

This value will be unset iff the nodes value is set instead. This is set by default.

See also: http://docs.mongodb.org/manual/reference/write-concern/#w-option

Returns: The acknowledgment level.

void mongocxx::write_concern::journal ( bool journal )

Sets the journal parameter for this write concern.

Parameters

journal If true confirms that the mongod instance has written the data to the on-disk journal before reporting a write operations was successful. This ensures that data is not lost if the mongod instance shuts down unexpectedly.

bool mongocxx::write_concern::journal ( ) const

Gets the current status of the journal parameter.

Returns: true if journal is required, false if not.

void mongocxx::write_concern::majority ( std::chrono::milliseconds timeout )

Requires that a majority of the nodes in a replica set acknowledge a write operation before it is considered a success.

A timeout is required when setting this write concern.

Parameters

timeout The amount of time to wait before the write operation times out if it cannot reach the majority of nodes in the replica set.

Exceptions

mongocxx::logic_error for an invalid timeout value.

bool mongocxx::write_concern::majority ( ) const

Gets whether the majority of nodes is currently required by this write_concern.

Returns: The current majority setting.

void mongocxx::write_concern::nodes ( std::int32_t confirm_from )

Sets the number of nodes that are required to acknowledge the write before the operation is considered successful.

Write operations will block until they have been replicated to the specified number of servers in a replica set.

Parameters

confirm_from The number of replica set nodes that must acknowledge the write.

Warning: Setting the number of nodes to 0 disables write acknowledgment and all other write concern options.; Setting the number of nodes required to an amount greater than the number of available nodes will cause writes using this write concern to block forever if no timeout is set.

stdx::optional<std::int32_t> mongocxx::write_concern::nodes ( ) const

Gets the current number of nodes that this write_concern requires operations to reach.

This value will be unset iff the acknowledge_level is set instead. This is unset by default.

See also: http://docs.mongodb.org/manual/reference/write-concern/#w-option

Returns: The number of required nodes.

void mongocxx::write_concern::tag ( stdx::string_view tag )

Sets the name representing the server-side getLastErrorMode entry containing the list of nodes that must acknowledge a write operation before it is considered a success.

Note: the acknowledge level of level::k_tag is set automatically when a tag is set.

Parameters

tag	The string representing on of the "getLastErrorModes" in the replica set configuration.

stdx::optional<std::string> mongocxx::write_concern::tag ( ) const

Gets the current getLastErrorMode that is required by this write_concern.

Returns: The current getLastErrorMode.

void mongocxx::write_concern::timeout ( std::chrono::milliseconds timeout )

Sets an upper bound on the time a write concern can take to be satisfied.

If the write concern cannot be satisfied within the timeout, the operation is considered a failure.

Parameters

timeout The timeout (in milliseconds) for this write concern.

Exceptions

mongocxx::logic_error for an invalid timeout value.

std::chrono::milliseconds mongocxx::write_concern::timeout ( ) const

Gets the current timeout for this write_concern.

Returns: Current timeout in milliseconds.

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

src/mongocxx/write_concern.hpp

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

Member Function Documentation