20#include <bsoncxx/builder/basic/array.hpp>
21#include <bsoncxx/builder/basic/document.hpp>
22#include <bsoncxx/builder/basic/kvp.hpp>
23#include <bsoncxx/builder/concatenate.hpp>
24#include <bsoncxx/document/view_or_value.hpp>
25#include <bsoncxx/oid.hpp>
26#include <bsoncxx/stdx/optional.hpp>
27#include <bsoncxx/string/view_or_value.hpp>
28#include <mongocxx/bulk_write.hpp>
29#include <mongocxx/change_stream.hpp>
30#include <mongocxx/client_session.hpp>
31#include <mongocxx/cursor.hpp>
32#include <mongocxx/index_view.hpp>
33#include <mongocxx/model/insert_one.hpp>
34#include <mongocxx/options/aggregate.hpp>
35#include <mongocxx/options/bulk_write.hpp>
36#include <mongocxx/options/change_stream.hpp>
37#include <mongocxx/options/count.hpp>
38#include <mongocxx/options/delete.hpp>
39#include <mongocxx/options/distinct.hpp>
40#include <mongocxx/options/estimated_document_count.hpp>
41#include <mongocxx/options/find.hpp>
42#include <mongocxx/options/find_one_and_delete.hpp>
43#include <mongocxx/options/find_one_and_replace.hpp>
44#include <mongocxx/options/find_one_and_update.hpp>
45#include <mongocxx/options/index.hpp>
46#include <mongocxx/options/index_view.hpp>
47#include <mongocxx/options/insert.hpp>
48#include <mongocxx/options/replace.hpp>
49#include <mongocxx/options/update.hpp>
50#include <mongocxx/pipeline.hpp>
51#include <mongocxx/read_concern.hpp>
52#include <mongocxx/read_preference.hpp>
53#include <mongocxx/result/bulk_write.hpp>
54#include <mongocxx/result/delete.hpp>
55#include <mongocxx/result/insert_many.hpp>
56#include <mongocxx/result/insert_one.hpp>
57#include <mongocxx/result/replace_one.hpp>
58#include <mongocxx/result/update.hpp>
59#include <mongocxx/write_concern.hpp>
61#include <mongocxx/config/prelude.hpp>
64MONGOCXX_INLINE_NAMESPACE_BEGIN
96 class _empty_doc_tag {
97 _empty_doc_tag() =
default;
138 explicit operator
bool() const noexcept;
162 const options::aggregate& options = options::aggregate());
187 const options::aggregate& options = options::aggregate());
246 MONGOCXX_INLINE stdx::optional<result::bulk_write> write(
271 MONGOCXX_INLINE stdx::optional<result::bulk_write> write(
302 template <
typename container_type>
303 MONGOCXX_INLINE stdx::optional<result::bulk_write>
bulk_write(
329 template <
typename container_type>
330 MONGOCXX_INLINE stdx::optional<result::bulk_write>
bulk_write(
332 const container_type& writes,
362 template <
typename write_model_iterator_type>
363 MONGOCXX_INLINE stdx::optional<result::bulk_write>
bulk_write(
364 write_model_iterator_type begin,
365 write_model_iterator_type end,
392 template <
typename write_model_iterator_type>
393 MONGOCXX_INLINE stdx::optional<result::bulk_write>
bulk_write(
395 write_model_iterator_type begin,
396 write_model_iterator_type end,
723 const bsoncxx::stdx::optional<mongocxx::write_concern>&
write_concern = {});
1002 std::initializer_list<_empty_doc_tag> update,
1086 std::initializer_list<_empty_doc_tag> update,
1159 template <
typename container_type>
1160 MONGOCXX_INLINE stdx::optional<result::insert_many> insert_many(
1184 template <
typename container_type>
1185 MONGOCXX_INLINE stdx::optional<result::insert_many> insert_many(
1187 const container_type& container,
1215 template <
typename document_view_iterator_type>
1216 MONGOCXX_INLINE stdx::optional<result::insert_many> insert_many(
1217 document_view_iterator_type begin,
1218 document_view_iterator_type end,
1242 template <
typename document_view_iterator_type>
1243 MONGOCXX_INLINE stdx::optional<result::insert_many> insert_many(
1245 document_view_iterator_type begin,
1246 document_view_iterator_type end,
1311 bool drop_target_before_rename =
false,
1312 const bsoncxx::stdx::optional<write_concern>&
write_concern = {});
1337 bool drop_target_before_rename =
false,
1338 const bsoncxx::stdx::optional<write_concern>&
write_concern = {});
1511 std::initializer_list<_empty_doc_tag> update,
1592 std::initializer_list<_empty_doc_tag> update,
1670 std::initializer_list<_empty_doc_tag> update,
1751 std::initializer_list<_empty_doc_tag> update,
1861 MONGOCXX_PRIVATE std::int64_t _count(
const client_session* session,
1865 MONGOCXX_PRIVATE std::int64_t _count_documents(
const client_session* session,
1875 MONGOCXX_PRIVATE stdx::optional<result::delete_result> _delete_many(
1880 MONGOCXX_PRIVATE stdx::optional<result::delete_result> _delete_one(
1890 MONGOCXX_PRIVATE
void _drop(
1892 const bsoncxx::stdx::optional<mongocxx::write_concern>&
write_concern);
1898 MONGOCXX_PRIVATE stdx::optional<bsoncxx::document::value> _find_one(
1903 MONGOCXX_PRIVATE stdx::optional<bsoncxx::document::value> _find_one_and_delete(
1908 MONGOCXX_PRIVATE stdx::optional<bsoncxx::document::value> _find_one_and_replace(
1914 MONGOCXX_PRIVATE stdx::optional<bsoncxx::document::value> _find_one_and_update(
1920 MONGOCXX_PRIVATE stdx::optional<result::insert_one> _insert_one(
1925 MONGOCXX_PRIVATE
void _rename(
1928 bool drop_target_before_rename,
1929 const bsoncxx::stdx::optional<class write_concern>&
write_concern);
1931 MONGOCXX_PRIVATE stdx::optional<result::replace_one> _replace_one(
1936 MONGOCXX_PRIVATE stdx::optional<result::replace_one> _replace_one(
1942 MONGOCXX_PRIVATE stdx::optional<result::update> _update_one(
1948 MONGOCXX_PRIVATE stdx::optional<result::update> _update_many(
1959 class bulk_write _init_insert_many(const options::insert& options,
1962 void _insert_many_doc_handler(class bulk_write& writes,
1963 bsoncxx::builder::basic::array& inserted_ids,
1964 bsoncxx::document::view doc) const;
1966 stdx::optional<result::insert_many> _exec_insert_many(
1967 class bulk_write& writes, bsoncxx::builder::basic::array& inserted_ids);
1969 template <typename document_view_iterator_type>
1970 MONGOCXX_PRIVATE stdx::optional<result::insert_many> _insert_many(
1971 const client_session* session,
1972 document_view_iterator_type begin,
1973 document_view_iterator_type end,
1974 const options::insert& options);
1976 class MONGOCXX_PRIVATE impl;
1978 MONGOCXX_PRIVATE impl& _get_impl();
1979 MONGOCXX_PRIVATE const impl& _get_impl() const;
1981 std::unique_ptr<impl> _impl;
1984MONGOCXX_INLINE stdx::optional<result::bulk_write> collection::write(
1985 const model::write& write, const options::bulk_write& options) {
1986 return create_bulk_write(options).append(write).execute();
1989MONGOCXX_INLINE stdx::optional<result::bulk_write> collection::write(
1991 return create_bulk_write(session, options).append(write).execute();
1994template <
typename container_type>
1995MONGOCXX_INLINE stdx::optional<result::bulk_write> collection::bulk_write(
1997 return bulk_write(requests.begin(), requests.end(), options);
2000template <
typename container_type>
2001MONGOCXX_INLINE stdx::optional<result::bulk_write> collection::bulk_write(
2003 const container_type& requests,
2005 return bulk_write(session, requests.begin(), requests.end(), options);
2008template <
typename write_model_iterator_type>
2009MONGOCXX_INLINE stdx::optional<result::bulk_write> collection::bulk_write(
2010 write_model_iterator_type begin,
2011 write_model_iterator_type end,
2013 auto writes = create_bulk_write(options);
2014 std::for_each(begin, end, [&](
const model::write& current) { writes.append(current); });
2015 return writes.execute();
2018template <
typename write_model_iterator_type>
2019MONGOCXX_INLINE stdx::optional<result::bulk_write> collection::bulk_write(
2021 write_model_iterator_type begin,
2022 write_model_iterator_type end,
2024 auto writes = create_bulk_write(session, options);
2025 std::for_each(begin, end, [&](
const model::write& current) { writes.append(current); });
2026 return writes.execute();
2029template <
typename container_type>
2030MONGOCXX_INLINE stdx::optional<result::insert_many> collection::insert_many(
2032 return insert_many(container.begin(), container.end(), options);
2035template <
typename container_type>
2036MONGOCXX_INLINE stdx::optional<result::insert_many> collection::insert_many(
2038 const container_type& container,
2040 return insert_many(session, container.begin(), container.end(), options);
2043template <
typename document_view_iterator_type>
2044MONGOCXX_INLINE stdx::optional<result::insert_many> collection::_insert_many(
2047 document_view_iterator_type begin,
2048 document_view_iterator_type end,
2051 auto writes = _init_insert_many(options, session);
2053 _insert_many_doc_handler(writes, inserted_ids, doc);
2055 return _exec_insert_many(writes, inserted_ids);
2058template <
typename document_view_iterator_type>
2059MONGOCXX_INLINE stdx::optional<result::insert_many> collection::insert_many(
2060 document_view_iterator_type begin,
2061 document_view_iterator_type end,
2063 return _insert_many(
nullptr, begin, end, options);
2066template <
typename document_view_iterator_type>
2067MONGOCXX_INLINE stdx::optional<result::insert_many> collection::insert_many(
2069 document_view_iterator_type begin,
2070 document_view_iterator_type end,
2072 return _insert_many(&session, begin, end, options);
2075MONGOCXX_INLINE_NAMESPACE_END
2078#include <mongocxx/config/postlude.hpp>
A traditional builder-style interface for constructing a BSON array.
Definition array.hpp:35
A read-only BSON document that owns its underlying buffer.
Definition value.hpp:34
A read-only, non-owning view of a BSON document.
Definition view.hpp:33
Class representing a view-or-value variant type for strings.
Definition view_or_value.hpp:36
Class representing a batch of write operations that can be sent to the server as a group.
Definition bulk_write.hpp:43
Class representing a MongoDB change stream.
Definition change_stream.hpp:34
Use a session for a sequence of operations, optionally with either causal consistency or snapshots.
Definition client_session.hpp:40
Class representing server side document groupings within a MongoDB database.
Definition collection.hpp:83
collection() noexcept
Default constructs a collection object.
stdx::optional< result::update > update_many(const client_session &session, bsoncxx::document::view_or_value filter, std::initializer_list< _empty_doc_tag > update, const options::update &options=options::update())
Updates multiple documents matching the provided filter in this collection.
void write_concern(class write_concern wc)
Sets the write_concern for this collection.
stdx::optional< result::update > update_one(const client_session &session, bsoncxx::document::view_or_value filter, const pipeline &update, const options::update &options=options::update())
Updates a single document matching the provided filter in this collection.
stdx::optional< bsoncxx::document::value > find_one_and_replace(const client_session &session, bsoncxx::document::view_or_value filter, bsoncxx::document::view_or_value replacement, const options::find_one_and_replace &options=options::find_one_and_replace())
Finds a single document matching the filter, replaces it, and returns either the original or the repl...
stdx::optional< result::replace_one > replace_one(bsoncxx::document::view_or_value filter, bsoncxx::document::view_or_value replacement, const options::replace &options=options::replace{})
Replaces a single document matching the provided filter in this collection.
stdx::optional< result::replace_one > replace_one(const client_session &session, bsoncxx::document::view_or_value filter, bsoncxx::document::view_or_value replacement, const options::replace &options=options::replace{})
Replaces a single document matching the provided filter in this collection.
change_stream watch(const options::change_stream &options={})
Gets a change stream on this collection with an empty pipeline.
stdx::optional< bsoncxx::document::value > find_one_and_update(bsoncxx::document::view_or_value filter, bsoncxx::document::view_or_value update, const options::find_one_and_update &options=options::find_one_and_update())
Finds a single document matching the filter, updates it, and returns either the original or the newly...
index_view indexes()
Gets an index_view to the collection.
stdx::optional< bsoncxx::document::value > find_one_and_update(bsoncxx::document::view_or_value filter, std::initializer_list< _empty_doc_tag > update, const options::find_one_and_update &options=options::find_one_and_update())
Finds a single document matching the filter, updates it, and returns either the original or the newly...
stdx::optional< result::insert_one > insert_one(const client_session &session, bsoncxx::document::view_or_value document, const options::insert &options={})
Inserts a single document into the collection.
stdx::optional< result::delete_result > delete_many(const client_session &session, bsoncxx::document::view_or_value filter, const options::delete_options &options=options::delete_options())
Deletes all matching documents from the collection.
stdx::optional< bsoncxx::document::value > find_one(const client_session &session, bsoncxx::document::view_or_value filter, const options::find &options=options::find())
Finds a single document in this collection that match the provided filter.
stdx::optional< bsoncxx::document::value > find_one_and_update(const client_session &session, bsoncxx::document::view_or_value filter, bsoncxx::document::view_or_value update, const options::find_one_and_update &options=options::find_one_and_update())
Finds a single document matching the filter, updates it, and returns either the original or the newly...
void rename(bsoncxx::string::view_or_value new_name, bool drop_target_before_rename=false, const bsoncxx::stdx::optional< write_concern > &write_concern={})
Rename this collection.
bsoncxx::document::value create_index(bsoncxx::document::view_or_value keys, bsoncxx::document::view_or_value index_options={}, options::index_view operation_options=options::index_view{})
Creates an index over the collection for the provided keys with the provided options.
stdx::optional< result::update > update_one(bsoncxx::document::view_or_value filter, bsoncxx::document::view_or_value update, const options::update &options=options::update())
Updates a single document matching the provided filter in this collection.
stdx::optional< result::update > update_many(const client_session &session, bsoncxx::document::view_or_value filter, const pipeline &update, const options::update &options=options::update())
Updates multiple documents matching the provided filter in this collection.
cursor distinct(bsoncxx::string::view_or_value name, bsoncxx::document::view_or_value filter, const options::distinct &options=options::distinct())
Finds the distinct values for a specified field across the collection.
cursor list_indexes() const
Returns a list of the indexes currently on this collection.
void read_preference(class read_preference rp)
Sets the read_preference for this collection.
stdx::optional< bsoncxx::document::value > find_one_and_delete(const client_session &session, bsoncxx::document::view_or_value filter, const options::find_one_and_delete &options=options::find_one_and_delete())
Finds a single document matching the filter, deletes it, and returns the original.
std::int64_t estimated_document_count(const options::estimated_document_count &options=options::estimated_document_count())
Returns an estimate of the number of documents in the collection.
stdx::optional< bsoncxx::document::value > find_one_and_delete(bsoncxx::document::view_or_value filter, const options::find_one_and_delete &options=options::find_one_and_delete())
Finds a single document matching the filter, deletes it, and returns the original.
change_stream watch(const client_session &session, const options::change_stream &options={})
change_stream watch(const client_session &session, const pipeline &pipe, const options::change_stream &options={})
Gets a change stream on this collection.
stdx::optional< bsoncxx::document::value > find_one_and_update(bsoncxx::document::view_or_value filter, const pipeline &update, const options::find_one_and_update &options=options::find_one_and_update())
Finds a single document matching the filter, updates it, and returns either the original or the newly...
void rename(const client_session &session, bsoncxx::string::view_or_value new_name, bool drop_target_before_rename=false, const bsoncxx::stdx::optional< write_concern > &write_concern={})
Rename this collection.
stdx::optional< result::delete_result > delete_one(bsoncxx::document::view_or_value filter, const options::delete_options &options=options::delete_options())
Deletes a single matching document from the collection.
std::int64_t count_documents(bsoncxx::document::view_or_value filter, const options::count &options=options::count())
Counts the number of documents matching the provided filter.
stdx::optional< bsoncxx::document::value > find_one_and_replace(bsoncxx::document::view_or_value filter, bsoncxx::document::view_or_value replacement, const options::find_one_and_replace &options=options::find_one_and_replace())
Finds a single document matching the filter, replaces it, and returns either the original or the repl...
cursor distinct(const client_session &session, bsoncxx::string::view_or_value name, bsoncxx::document::view_or_value filter, const options::distinct &options=options::distinct())
Finds the distinct values for a specified field across the collection.
stdx::optional< result::update > update_one(bsoncxx::document::view_or_value filter, std::initializer_list< _empty_doc_tag > update, const options::update &options=options::update())
Updates a single document matching the provided filter in this collection.
stdx::optional< result::update > update_many(bsoncxx::document::view_or_value filter, const pipeline &update, const options::update &options=options::update())
Updates multiple documents matching the provided filter in this collection.
stdx::optional< result::delete_result > delete_one(const client_session &session, bsoncxx::document::view_or_value filter, const options::delete_options &options=options::delete_options())
Deletes a single matching document from the collection.
std::int64_t count_documents(const client_session &session, bsoncxx::document::view_or_value filter, const options::count &options=options::count())
Counts the number of documents matching the provided filter.
stdx::optional< bsoncxx::document::value > find_one_and_update(const client_session &session, bsoncxx::document::view_or_value filter, const pipeline &update, const options::find_one_and_update &options=options::find_one_and_update())
Finds a single document matching the filter, updates it, and returns either the original or the newly...
void drop(const bsoncxx::stdx::optional< mongocxx::write_concern > &write_concern={})
Drops this collection and all its contained documents from the database.
stdx::optional< result::update > update_many(bsoncxx::document::view_or_value filter, bsoncxx::document::view_or_value update, const options::update &options=options::update())
Updates multiple documents matching the provided filter in this collection.
stdx::optional< result::update > update_one(const client_session &session, bsoncxx::document::view_or_value filter, std::initializer_list< _empty_doc_tag > update, const options::update &options=options::update())
Updates a single document matching the provided filter in this collection.
stdx::optional< result::delete_result > delete_many(bsoncxx::document::view_or_value filter, const options::delete_options &options=options::delete_options())
Deletes all matching documents from the collection.
stdx::optional< result::update > update_many(bsoncxx::document::view_or_value filter, std::initializer_list< _empty_doc_tag > update, const options::update &options=options::update())
Updates multiple documents matching the provided filter in this collection.
bsoncxx::document::value create_index(const client_session &session, bsoncxx::document::view_or_value keys, bsoncxx::document::view_or_value index_options={}, options::index_view operation_options=options::index_view{})
Creates an index over the collection for the provided keys with the provided options.
change_stream watch(const pipeline &pipe, const options::change_stream &options={})
Gets a change stream on this collection.
void read_concern(class read_concern rc)
Sets the read_concern for this collection.
stdx::optional< bsoncxx::document::value > find_one(bsoncxx::document::view_or_value filter, const options::find &options=options::find())
Finds a single document in this collection that match the provided filter.
stdx::optional< result::update > update_one(const client_session &session, bsoncxx::document::view_or_value filter, bsoncxx::document::view_or_value update, const options::update &options=options::update())
Updates a single document matching the provided filter in this collection.
void drop(const client_session &session, const bsoncxx::stdx::optional< mongocxx::write_concern > &write_concern={})
Drops this collection and all its contained documents from the database.
cursor find(const client_session &session, bsoncxx::document::view_or_value filter, const options::find &options=options::find())
Finds the documents in this collection which match the provided filter.
stdx::optional< bsoncxx::document::value > find_one_and_update(const client_session &session, bsoncxx::document::view_or_value filter, std::initializer_list< _empty_doc_tag > update, const options::find_one_and_update &options=options::find_one_and_update())
Finds a single document matching the filter, updates it, and returns either the original or the newly...
stdx::optional< result::update > update_one(bsoncxx::document::view_or_value filter, const pipeline &update, const options::update &options=options::update())
Updates a single document matching the provided filter in this collection.
cursor find(bsoncxx::document::view_or_value filter, const options::find &options=options::find())
Finds the documents in this collection which match the provided filter.
stdx::string_view name() const
Returns the name of this collection.
stdx::optional< result::update > update_many(const client_session &session, bsoncxx::document::view_or_value filter, bsoncxx::document::view_or_value update, const options::update &options=options::update())
Updates multiple documents matching the provided filter in this collection.
stdx::optional< result::insert_one > insert_one(bsoncxx::document::view_or_value document, const options::insert &options={})
Inserts a single document into the collection.
cursor list_indexes(const client_session &session) const
Returns a list of the indexes currently on this collection.
Class representing a pointer to the result set of a query on a MongoDB server.
Definition cursor.hpp:36
Class representing a MongoDB database.
Definition database.hpp:43
Class representing a MongoDB index view.
Definition index_view.hpp:35
Class representing a MongoDB update operation that replaces a single document.
Definition replace_one.hpp:31
Models a single write operation within a mongocxx::bulk_write.
Definition write.hpp:37
Class representing the optional arguments to a MongoDB aggregation operation.
Definition aggregate.hpp:39
Class representing the optional arguments to a MongoDB bulk write.
Definition bulk_write.hpp:31
Class representing MongoDB change stream options.
Definition change_stream.hpp:39
Class representing the optional arguments to mongocxx::collection::count_documents.
Definition count.hpp:37
Class representing the optional arguments to a MongoDB delete operation.
Definition delete.hpp:32
Class representing the optional arguments to a MongoDB distinct command.
Definition distinct.hpp:35
Class representing the optional arguments to mongocxx::collection::estimated_document_count.
Definition estimated_document_count.hpp:33
Class representing the optional arguments to a MongoDB find_and_modify delete operation.
Definition find_one_and_delete.hpp:35
Class representing the optional arguments to a MongoDB find_and_modify replace operation.
Definition find_one_and_replace.hpp:37
Class representing the optional arguments to a MongoDB find_and_modify update operation.
Definition find_one_and_update.hpp:38
Class representing the optional arguments to a MongoDB query.
Definition find.hpp:37
Class representing optional arguments to IndexView operations.
Definition index_view.hpp:31
Class representing the optional arguments to a MongoDB insert operation.
Definition insert.hpp:32
Class representing the optional arguments to a MongoDB replace operation.
Definition replace.hpp:34
Class representing the optional arguments to a MongoDB update operation.
Definition update.hpp:34
Class representing a MongoDB aggregation pipeline.
Definition pipeline.hpp:38
A class to represent the read concern.
Definition read_concern.hpp:54
Class representing a preference for how the driver routes read operations to members of a replica set...
Definition read_preference.hpp:63
Class representing the server-side requirement for reporting the success of a write operation.
Definition write_concern.hpp:56
Top level namespace for the MongoDB C++ driver.
Definition bulk_write.hpp:24