MongoDB C++ Driver  mongocxx-3.10.2
Classes | Enumerations | Functions
mongocxx::v_noabi Namespace Reference

Entities declared in this namespace do not have a stable ABI. More...

Classes

class  bulk_write
 Class representing a batch of write operations that can be sent to the server as a group. More...
 
class  change_stream
 Class representing a MongoDB change stream. More...
 
class  client
 Class representing a client connection to MongoDB. More...
 
class  client_encryption
 Class supporting operations for MongoDB Client-Side Field Level Encryption. More...
 
class  client_session
 Use a session for a sequence of operations, optionally with either causal consistency or snapshots. More...
 
class  collection
 Class representing server side document groupings within a MongoDB database. More...
 
class  cursor
 Class representing a pointer to the result set of a query on a MongoDB server. More...
 
class  database
 Class representing a MongoDB database. More...
 
class  authentication_exception
 Class representing an exception during authentication. More...
 
class  bulk_write_exception
 Class representing an exception during a bulk write operation. More...
 
class  exception
 A class to be used as the base class for all mongocxx exceptions. More...
 
class  gridfs_exception
 Class representing an error encountered when attempting to perform the requested GridFS operation. More...
 
class  logic_error
 Class representing an exception caused by using the mongocxx API improperly. More...
 
class  operation_exception
 Class representing an exception received from a MongoDB server. More...
 
class  query_exception
 Class representing an exception during a query operation. More...
 
class  write_exception
 Class representing an exception during a write operation. More...
 
class  hint
 Class representing a hint to be passed to a database operation. More...
 
class  index_model
 Class representing an index on a MongoDB server. More...
 
class  index_view
 Class representing a MongoDB index view. More...
 
class  instance
 Class representing an instance of the MongoDB driver. More...
 
class  logger
 The interface that all user-defined loggers must implement. More...
 
class  pipeline
 Class representing a MongoDB aggregation pipeline. More...
 
class  pool
 A pool of client objects associated with a MongoDB deployment. More...
 
class  read_concern
 A class to represent the read concern. More...
 
class  read_preference
 Class representing a preference for how the driver routes read operations to members of a replica set or to a sharded cluster. More...
 
class  search_index_model
 Class representing a search index on a MongoDB server. More...
 
class  search_index_view
 Class representing a MongoDB search index view. More...
 
class  uri
 Class representing a MongoDB connection string URI. More...
 
class  validation_criteria
 Class representing criteria for document validation, to be applied to a collection. More...
 
class  write_concern
 Class representing the server-side requirement for reporting the success of a write operation. More...
 

Enumerations

enum class  error_code : std::int32_t {
  k_cannot_recreate_instance = 1 , k_invalid_client_object , k_invalid_collection_object , k_invalid_database_object ,
  k_invalid_parameter , k_ssl_not_supported , k_unknown_read_concern , k_unknown_write_concern ,
  k_server_response_malformed , k_invalid_uri , k_invalid_gridfs_bucket_object , k_invalid_gridfs_uploader_object ,
  k_invalid_gridfs_downloader_object , k_gridfs_stream_not_open , k_gridfs_upload_requires_too_many_chunks , k_gridfs_file_not_found ,
  k_gridfs_file_corrupted , k_instance_destroyed , k_cannot_create_session , k_invalid_session ,
  k_invalid_transaction_options_object , k_create_resource_fail , k_invalid_search_index_model , k_invalid_search_index_view
}
 Enum representing the various error types that can occur during driver usage. More...
 
enum class  server_error_code : std::int32_t
 Enum representing the various errors types that can be returned from the server. More...
 
enum class  log_level
 The log level of a message passed to a mongocxx::v_noabi::logger.
 
enum class  write_type {
  k_insert_one , k_delete_one , k_delete_many , k_update_one ,
  k_update_many , k_replace_one
}
 Enum representing the the types of write operations that can be performed. More...
 

Functions

const std::error_category & error_category ()
 Get the error_category for mongocxx library exceptions. More...
 
std::error_code make_error_code (error_code error)
 Translate a mongocxx::v_noabi::error_code into a std::error_code. More...
 
const std::error_category & server_error_category ()
 Get the error_category for mongocxx library exceptions. More...
 
std::error_code make_error_code (server_error_code error)
 Translate a mongocxx::v_noabi::server_error_code into a std::error_code. More...
 
stdx::string_view to_string (log_level level)
 Returns a stringification of the given log level. More...
 

Detailed Description

Entities declared in this namespace do not have a stable ABI.

Enumeration Type Documentation

◆ error_code

enum mongocxx::v_noabi::error_code : std::int32_t
strong

Enum representing the various error types that can occur during driver usage.

Enumerator
k_cannot_recreate_instance 

More than one mongocxx::v_noabi::instance has been created.

k_invalid_client_object 

A default-constructed or moved-from mongocxx::v_noabi::client object has been used.

k_invalid_collection_object 

A default-constructed or moved-from mongocxx::v_noabi::collection object has been used.

k_invalid_database_object 

A default-constructed or moved-from mongocxx::v_noabi::database object has been used.

k_invalid_parameter 

An invalid or out-of-bounds parameter was provided.

k_ssl_not_supported 

An SSL operation was used without SSL support being built.

k_unknown_read_concern 

An unknown read concern level was set.

k_unknown_write_concern 

An unknown write concern level was set.

k_server_response_malformed 

The server returned a malformed response.

k_invalid_uri 

An invalid MongoDB URI was provided.

k_invalid_gridfs_bucket_object 

A default-constructed or moved-from mongocxx::v_noabi::gridfs::bucket object has been used.

k_invalid_gridfs_uploader_object 

A default-constructed or moved-from mongocxx::v_noabi::gridfs::uploader object has been used.

k_invalid_gridfs_downloader_object 

A default-constructed or moved-from mongocxx::v_noabi::gridfs::downloader object has been used.

k_gridfs_stream_not_open 

A mongocxx::v_noabi::gridfs::uploader object was not open for writing, or a mongocxx::v_noabi::gridfs::downloader object was not open for reading.

k_gridfs_upload_requires_too_many_chunks 

A mongocxx::v_noabi::gridfs::uploader object has exceeded the maximum number of allowable GridFS chunks when attempting to upload the requested file.

k_gridfs_file_not_found 

The requested GridFS file was not found.

k_gridfs_file_corrupted 

A GridFS file being operated on was discovered to be corrupted.

k_instance_destroyed 

The mongocxx::v_noabi::instance has been destroyed.

k_cannot_create_session 

mongocxx::v_noabi::client.create_session failed to create a mongocxx::v_noabi::client_session.

k_invalid_session 

A failure attempting to pass a mongocxx::v_noabi::client_session to a method.

k_invalid_transaction_options_object 

A moved-from mongocxx::v_noabi::options::transaction object has been used.

◆ server_error_code

enum mongocxx::v_noabi::server_error_code : std::int32_t
strong

Enum representing the various errors types that can be returned from the server.

As this list changes over time, this is just a placeholder for an Int32 error code value from the server.

◆ write_type

Enum representing the the types of write operations that can be performed.

Enumerator
k_insert_one 

Inserting a single document into a collection.

k_delete_one 

Deleting a single document from a collection.

k_delete_many 

Delete one or more documents from a collection.

k_update_one 

Update a single document in a collection.

k_update_many 

Update one or more documents in a collection.

k_replace_one 

Replace a single document in a collection with a new one.

Function Documentation

◆ error_category()

const std::error_category& mongocxx::v_noabi::error_category ( )

Get the error_category for mongocxx library exceptions.

Returns
The mongocxx error_category

◆ make_error_code() [1/2]

std::error_code mongocxx::v_noabi::make_error_code ( error_code  error)

Translate a mongocxx::v_noabi::error_code into a std::error_code.

Parameters
errorA mongocxx::v_noabi::error_code
Returns
A std::error_code

◆ make_error_code() [2/2]

std::error_code mongocxx::v_noabi::make_error_code ( server_error_code  error)

Translate a mongocxx::v_noabi::server_error_code into a std::error_code.

Parameters
errorA mongocxx::v_noabi::error_code
Returns
A std::error_code

◆ server_error_category()

const std::error_category& mongocxx::v_noabi::server_error_category ( )

Get the error_category for mongocxx library exceptions.

Returns
The mongocxx error_category

◆ to_string()

stdx::string_view mongocxx::v_noabi::to_string ( log_level  level)

Returns a stringification of the given log level.

Parameters
levelThe type to stringify.
Returns
a std::string representation of the type.