MongoDB C++ Driver mongocxx-3.11.0
|
#include <mongocxx/v_noabi/mongocxx/instance.hpp>
Class representing an instance of the MongoDB driver.
The constructor and destructor initialize and shut down the driver, respectively. Therefore, an instance must be created before using the driver and must remain alive until all other mongocxx objects are destroyed. After the instance destructor runs, the driver may not be used.
Exactly one instance must be created in a given program. Not constructing an instance or constructing more than one instance in a program are errors, even if the multiple instances have non-overlapping lifetimes.
The following is a correct example of using an instance in a program, as the instance is kept alive for as long as the driver is in use:
An example of using instance incorrectly might look as follows:
For examples of more advanced usage of instance, see examples/mongocxx/instance_management.cpp
.
Public Member Functions | |
instance () | |
Creates an instance of the driver. | |
instance (instance &&) noexcept | |
Move constructs an instance of the driver. | |
instance (std::unique_ptr< logger > logger) | |
Creates an instance of the driver with a user provided log handler. | |
~instance () | |
Destroys an instance of the driver. | |
instance & | operator= (instance &&) noexcept |
Move assigns an instance of the driver. | |
Static Public Member Functions | |
static instance & | current () |
Returns the current unique instance of the driver. If an instance was explicitly created, that will be returned. If no instance has yet been created, a default instance will be constructed and returned. If a default instance is constructed, its destruction will be sequenced according to the rules for the destruction of static local variables at program exit (see http://en.cppreference.com/w/cpp/utility/program/exit). | |
mongocxx::v_noabi::instance::instance | ( | ) |
Creates an instance of the driver.
mongocxx::v_noabi::instance::instance | ( | std::unique_ptr< logger > | logger | ) |
Creates an instance of the driver with a user provided log handler.
logger | The logger that the driver will direct log messages to. |
mongocxx::v_noabi::logic_error | if an instance already exists. |
|
noexcept |
Move constructs an instance of the driver.
mongocxx::v_noabi::instance::~instance | ( | ) |
Destroys an instance of the driver.
|
static |
Returns the current unique instance of the driver. If an instance was explicitly created, that will be returned. If no instance has yet been created, a default instance will be constructed and returned. If a default instance is constructed, its destruction will be sequenced according to the rules for the destruction of static local variables at program exit (see http://en.cppreference.com/w/cpp/utility/program/exit).
Note that, if you need to configure the instance in any way (e.g. with a logger), you cannot use this method to cause the instance to be constructed. You must explicitly create an properly configured instance object. You can, however, use this method to obtain that configured instance object.
Move assigns an instance of the driver.