collection.hpp

Go to the documentation of this file.

// Copyright 2009-present MongoDB, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
 
#pragma once
 
#include <mongocxx/collection-fwd.hpp> // IWYU pragma: export
 
//
 
#include <mongocxx/v1/collection.hpp> // IWYU pragma: export
 
#include <algorithm>
#include <cstdint>
#include <initializer_list>
#include <string> // IWYU pragma: keep: backward compatibility, to be removed.
#include <utility>
 
#include <mongocxx/bulk_write-fwd.hpp>
#include <mongocxx/client_encryption-fwd.hpp> // IWYU pragma: keep: backward compatibility, to be removed.
#include <mongocxx/database-fwd.hpp>          // IWYU pragma: keep: backward compatibility, to be removed.
 
#include <bsoncxx/builder/basic/array.hpp>
#include <bsoncxx/builder/basic/document.hpp> // IWYU pragma: keep: backward compatibility, to be removed.
#include <bsoncxx/builder/basic/kvp.hpp>      // IWYU pragma: keep: backward compatibility, to be removed.
#include <bsoncxx/builder/concatenate.hpp>    // IWYU pragma: keep: backward compatibility, to be removed.
#include <bsoncxx/document/value.hpp>
#include <bsoncxx/document/view_or_value.hpp>
#include <bsoncxx/oid.hpp> // IWYU pragma: keep: backward compatibility, to be removed.
#include <bsoncxx/stdx/optional.hpp>
#include <bsoncxx/stdx/string_view.hpp>
#include <bsoncxx/string/view_or_value.hpp>
 
#include <mongocxx/bulk_write.hpp>
#include <mongocxx/change_stream.hpp>
#include <mongocxx/client_session.hpp>
#include <mongocxx/cursor.hpp>
#include <mongocxx/index_view.hpp>
#include <mongocxx/model/insert_one.hpp> // IWYU pragma: keep: backward compatibility, to be removed.
#include <mongocxx/model/write.hpp>
#include <mongocxx/options/aggregate.hpp>
#include <mongocxx/options/bulk_write.hpp>
#include <mongocxx/options/change_stream.hpp>
#include <mongocxx/options/count.hpp>
#include <mongocxx/options/delete.hpp>
#include <mongocxx/options/distinct.hpp>
#include <mongocxx/options/estimated_document_count.hpp>
#include <mongocxx/options/find.hpp>
#include <mongocxx/options/find_one_and_delete.hpp>
#include <mongocxx/options/find_one_and_replace.hpp>
#include <mongocxx/options/find_one_and_update.hpp>
#include <mongocxx/options/index.hpp> // IWYU pragma: keep: backward compatibility, to be removed.
#include <mongocxx/options/index_view.hpp>
#include <mongocxx/options/insert.hpp>
#include <mongocxx/options/replace.hpp>
#include <mongocxx/options/update.hpp>
#include <mongocxx/pipeline.hpp>
#include <mongocxx/read_concern.hpp>
#include <mongocxx/read_preference.hpp>
#include <mongocxx/result/bulk_write.hpp>
#include <mongocxx/result/delete.hpp>
#include <mongocxx/result/insert_many.hpp>
#include <mongocxx/result/insert_one.hpp>
#include <mongocxx/result/replace_one.hpp>
#include <mongocxx/result/update.hpp>
#include <mongocxx/search_index_view.hpp>
#include <mongocxx/write_concern.hpp>
 
#include <mongocxx/config/prelude.hpp>
 
namespace mongocxx {
namespace v_noabi {

class collection {
   private:
    v1::collection _coll;
 
    //
    // Utility class supporting the convenience of {} meaning an empty bsoncxx::v_noabi::document.
    //
    // Users may not use this class directly.
    //
    // In places where driver methods take this class as a parameter, passing {} will
    // translate to a default-constructed bsoncxx::v_noabi::document::view_or_value,
    // regardless of other overloads taking other default-constructible types
    // for that parameter. This class avoids compiler ambiguity with such overloads.
    //
    // See collection::update_one for an example of such overloads.
    //
    class _empty_doc_tag {};
 
   public:
    collection() noexcept {}

    collection(collection&& other) noexcept = default;

    collection& operator=(collection&& other) noexcept = default;

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE() collection(collection const& other);

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(collection&) operator=(collection const& other);

    ~collection() = default;

    /* explicit(false) */ collection(v1::collection collection) : _coll{std::move(collection)} {}

    explicit operator v1::collection() && {
        return std::move(_coll);
    }

    explicit operator v1::collection() const& {
        return _coll;
    }

    explicit MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE() operator bool() const noexcept;

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::cursor)
    aggregate(v_noabi::pipeline const& pipeline, v_noabi::options::aggregate const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::cursor)
    aggregate(
        v_noabi::client_session const& session,
        v_noabi::pipeline const& pipeline,
        v_noabi::options::aggregate const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::bulk_write)
    create_bulk_write(v_noabi::options::bulk_write const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::bulk_write)
    create_bulk_write(v_noabi::client_session const& session, v_noabi::options::bulk_write const& options = {});

    bsoncxx::v_noabi::stdx::optional<v_noabi::result::bulk_write> write(
        v_noabi::model::write const& write,
        v_noabi::options::bulk_write const& options = {}) {
        return this->create_bulk_write(options).append(write).execute();
    }

    bsoncxx::v_noabi::stdx::optional<v_noabi::result::bulk_write> write(
        v_noabi::client_session const& session,
        v_noabi::model::write const& write,
        v_noabi::options::bulk_write const& options = {}) {
        return this->create_bulk_write(session, options).append(write).execute();
    }

    template <typename container_type>
    bsoncxx::v_noabi::stdx::optional<v_noabi::result::bulk_write> bulk_write(
        container_type const& writes,
        v_noabi::options::bulk_write const& options = {}) {
        return this->bulk_write(writes.begin(), writes.end(), options);
    }

    template <typename container_type>
    bsoncxx::v_noabi::stdx::optional<v_noabi::result::bulk_write> bulk_write(
        v_noabi::client_session const& session,
        container_type const& writes,
        v_noabi::options::bulk_write const& options = {}) {
        return this->bulk_write(session, writes.begin(), writes.end(), options);
    }

    template <typename write_model_iterator_type>
    bsoncxx::v_noabi::stdx::optional<v_noabi::result::bulk_write> bulk_write(
        write_model_iterator_type begin,
        write_model_iterator_type end,
        v_noabi::options::bulk_write const& options = {}) {
        auto writes = create_bulk_write(options);
        std::for_each(begin, end, [&](model::write const& current) { writes.append(current); });
        return writes.execute();
    }

    template <typename write_model_iterator_type>
    bsoncxx::v_noabi::stdx::optional<v_noabi::result::bulk_write> bulk_write(
        v_noabi::client_session const& session,
        write_model_iterator_type begin,
        write_model_iterator_type end,
        v_noabi::options::bulk_write const& options = {}) {
        auto writes = create_bulk_write(session, options);
        std::for_each(begin, end, [&](model::write const& current) { writes.append(current); });
        return writes.execute();
    }

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(std::int64_t)
    count_documents(bsoncxx::v_noabi::document::view_or_value filter, v_noabi::options::count const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(std::int64_t)
    count_documents(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::options::count const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(std::int64_t)
    estimated_document_count(v_noabi::options::estimated_document_count const& options = {});

    bsoncxx::v_noabi::document::value create_index(
        bsoncxx::v_noabi::document::view_or_value keys,
        bsoncxx::v_noabi::document::view_or_value index_options = {},
        v_noabi::options::index_view operation_options = {}) {
        using namespace bsoncxx::v_noabi::builder::basic;
 
        auto const name_opt = this->indexes().create_one(keys, index_options, operation_options);
 
        return name_opt ? make_document(kvp("name", *name_opt)) : make_document();
    }

    bsoncxx::v_noabi::document::value create_index(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value keys,
        bsoncxx::v_noabi::document::view_or_value index_options = {},
        v_noabi::options::index_view operation_options = {}) {
        using namespace bsoncxx::v_noabi::builder::basic;
 
        auto const name_opt = this->indexes().create_one(session, keys, index_options, operation_options);
 
        return name_opt ? make_document(kvp("name", *name_opt)) : make_document();
    }

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::delete_result>)
    delete_many(bsoncxx::v_noabi::document::view_or_value filter, v_noabi::options::delete_options const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::delete_result>)
    delete_many(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::options::delete_options const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::delete_result>)
    delete_one(bsoncxx::v_noabi::document::view_or_value filter, v_noabi::options::delete_options const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::delete_result>)
    delete_one(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::options::delete_options const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::cursor)
    distinct(
        bsoncxx::v_noabi::string::view_or_value name,
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::options::distinct const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::cursor)
    distinct(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::string::view_or_value name,
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::options::distinct const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(void)
    drop(
        bsoncxx::v_noabi::stdx::optional<v_noabi::write_concern> const& write_concern = {},
        bsoncxx::v_noabi::document::view_or_value collection_options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(void)
    drop(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::stdx::optional<v_noabi::write_concern> const& write_concern = {},
        bsoncxx::v_noabi::document::view_or_value collection_options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::cursor)
    find(bsoncxx::v_noabi::document::view_or_value filter, v_noabi::options::find const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::cursor)
    find(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::options::find const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::document::value>)
    find_one(bsoncxx::v_noabi::document::view_or_value filter, v_noabi::options::find const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::document::value>)
    find_one(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::options::find const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::document::value>)
    find_one_and_delete(
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::options::find_one_and_delete const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::document::value>)
    find_one_and_delete(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::options::find_one_and_delete const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::document::value>)
    find_one_and_replace(
        bsoncxx::v_noabi::document::view_or_value filter,
        bsoncxx::v_noabi::document::view_or_value replacement,
        v_noabi::options::find_one_and_replace const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::document::value>)
    find_one_and_replace(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        bsoncxx::v_noabi::document::view_or_value replacement,
        v_noabi::options::find_one_and_replace const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::document::value>)
    find_one_and_update(
        bsoncxx::v_noabi::document::view_or_value filter,
        bsoncxx::v_noabi::document::view_or_value update,
        v_noabi::options::find_one_and_update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::document::value>)
    find_one_and_update(
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::pipeline const& update,
        v_noabi::options::find_one_and_update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::document::value>)
    find_one_and_update(
        bsoncxx::v_noabi::document::view_or_value filter,
        std::initializer_list<_empty_doc_tag> update,
        v_noabi::options::find_one_and_update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::document::value>)
    find_one_and_update(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        bsoncxx::v_noabi::document::view_or_value update,
        v_noabi::options::find_one_and_update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::document::value>)
    find_one_and_update(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::pipeline const& update,
        v_noabi::options::find_one_and_update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::document::value>)
    find_one_and_update(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        std::initializer_list<_empty_doc_tag> update,
        v_noabi::options::find_one_and_update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::insert_one>)
    insert_one(bsoncxx::v_noabi::document::view_or_value document, v_noabi::options::insert const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::insert_one>)
    insert_one(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value document,
        v_noabi::options::insert const& options = {});

    template <typename container_type>
    bsoncxx::v_noabi::stdx::optional<v_noabi::result::insert_many> insert_many(
        container_type const& container,
        v_noabi::options::insert const& options = {}) {
        return this->insert_many(container.begin(), container.end(), options);
    }

    template <typename container_type>
    bsoncxx::v_noabi::stdx::optional<v_noabi::result::insert_many> insert_many(
        v_noabi::client_session const& session,
        container_type const& container,
        v_noabi::options::insert const& options = {}) {
        return this->insert_many(session, container.begin(), container.end(), options);
    }

    template <typename document_view_iterator_type>
    bsoncxx::v_noabi::stdx::optional<v_noabi::result::insert_many> insert_many(
        document_view_iterator_type begin,
        document_view_iterator_type end,
        v_noabi::options::insert const& options = {}) {
        return this->_insert_many(nullptr, begin, end, options);
    }

    template <typename document_view_iterator_type>
    bsoncxx::v_noabi::stdx::optional<v_noabi::result::insert_many> insert_many(
        v_noabi::client_session const& session,
        document_view_iterator_type begin,
        document_view_iterator_type end,
        v_noabi::options::insert const& options = {}) {
        return this->_insert_many(&session, begin, end, options);
    }

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::cursor) list_indexes() const;

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::cursor) list_indexes(v_noabi::client_session const& session) const;

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::string_view) name() const;

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(void)
    rename(
        bsoncxx::v_noabi::string::view_or_value new_name,
        bool drop_target_before_rename = false,
        bsoncxx::v_noabi::stdx::optional<v_noabi::write_concern> const& write_concern = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(void)
    rename(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::string::view_or_value new_name,
        bool drop_target_before_rename = false,
        bsoncxx::v_noabi::stdx::optional<v_noabi::write_concern> const& write_concern = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(void) read_concern(v_noabi::read_concern rc);

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::read_concern) read_concern() const;

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(void) read_preference(v_noabi::read_preference rp);

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::read_preference) read_preference() const;

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::replace_one>)
    replace_one(
        bsoncxx::v_noabi::document::view_or_value filter,
        bsoncxx::v_noabi::document::view_or_value replacement,
        v_noabi::options::replace const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::replace_one>)
    replace_one(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        bsoncxx::v_noabi::document::view_or_value replacement,
        v_noabi::options::replace const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::update>)
    update_many(
        bsoncxx::v_noabi::document::view_or_value filter,
        bsoncxx::v_noabi::document::view_or_value update,
        v_noabi::options::update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::update>)
    update_many(
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::pipeline const& update,
        v_noabi::options::update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::update>)
    update_many(
        bsoncxx::v_noabi::document::view_or_value filter,
        std::initializer_list<_empty_doc_tag> update,
        v_noabi::options::update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::update>)
    update_many(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        bsoncxx::v_noabi::document::view_or_value update,
        v_noabi::options::update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::update>)
    update_many(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::pipeline const& update,
        v_noabi::options::update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::update>)
    update_many(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        std::initializer_list<_empty_doc_tag> update,
        v_noabi::options::update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::update>)
    update_one(
        bsoncxx::v_noabi::document::view_or_value filter,
        bsoncxx::v_noabi::document::view_or_value update,
        v_noabi::options::update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::update>)
    update_one(
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::pipeline const& update,
        v_noabi::options::update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::update>)
    update_one(
        bsoncxx::v_noabi::document::view_or_value filter,
        std::initializer_list<_empty_doc_tag> update,
        v_noabi::options::update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::update>)
    update_one(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        bsoncxx::v_noabi::document::view_or_value update,
        v_noabi::options::update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::update>)
    update_one(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        v_noabi::pipeline const& update,
        v_noabi::options::update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::update>)
    update_one(
        v_noabi::client_session const& session,
        bsoncxx::v_noabi::document::view_or_value filter,
        std::initializer_list<_empty_doc_tag> update,
        v_noabi::options::update const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(void) write_concern(v_noabi::write_concern wc);

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::write_concern) write_concern() const;

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::index_view) indexes();

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::change_stream) watch(
        v_noabi::options::change_stream const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::change_stream)
    watch(v_noabi::client_session const& session, v_noabi::options::change_stream const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::change_stream)
    watch(v_noabi::pipeline const& pipe, v_noabi::options::change_stream const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::change_stream)
    watch(
        v_noabi::client_session const& session,
        v_noabi::pipeline const& pipe,
        v_noabi::options::change_stream const& options = {});

    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::search_index_view) search_indexes();
 
    class internal;
 
   private:
    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(v_noabi::bulk_write)
    _init_insert_many(v_noabi::options::insert const& options, v_noabi::client_session const* session);
 
    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(void)
    _insert_many_doc_handler(
        v_noabi::bulk_write& writes,
        bsoncxx::v_noabi::builder::basic::array& inserted_ids,
        bsoncxx::v_noabi::document::view doc) const;
 
    MONGOCXX_ABI_EXPORT_CDECL_UNSTABLE(bsoncxx::v_noabi::stdx::optional<v_noabi::result::insert_many>)
    _exec_insert_many(v_noabi::bulk_write& writes, bsoncxx::v_noabi::builder::basic::array& inserted_ids);
 
    template <typename document_view_iterator_type>
    bsoncxx::v_noabi::stdx::optional<v_noabi::result::insert_many> _insert_many(
        v_noabi::client_session const* session,
        document_view_iterator_type begin,
        document_view_iterator_type end,
        v_noabi::options::insert const& options) {
        bsoncxx::v_noabi::builder::basic::array inserted_ids;
        auto writes = _init_insert_many(options, session);
        std::for_each(begin, end, [&inserted_ids, &writes, this](bsoncxx::v_noabi::document::view doc) {
            _insert_many_doc_handler(writes, inserted_ids, doc);
        });
        return _exec_insert_many(writes, inserted_ids);
    }
};
 
} // namespace v_noabi
} // namespace mongocxx
 
namespace mongocxx {
namespace v_noabi {

inline v_noabi::collection from_v1(v1::collection v) {
    return {std::move(v)};
}

inline v1::collection to_v1(v_noabi::collection v) {
    return v1::collection{std::move(v)};
}
 
} // namespace v_noabi
} // namespace mongocxx
 
#include <mongocxx/config/postlude.hpp>