value.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 <cstdlib>
#include <memory>
#include <type_traits>
 
#include <bsoncxx/document/value-fwd.hpp>
 
#include <bsoncxx/array/view.hpp>
#include <bsoncxx/document/view.hpp>
#include <bsoncxx/stdx/type_traits.hpp>
 
#include <bsoncxx/config/prelude.hpp>
 
namespace bsoncxx {
namespace v_noabi {
namespace document {
 
class value {
   public:
    using deleter_type = void(BSONCXX_ABI_CDECL*)(std::uint8_t*);
    using unique_ptr_type = std::unique_ptr<uint8_t[], deleter_type>;
 
    BSONCXX_ABI_EXPORT_CDECL() value(std::uint8_t* data, std::size_t length, deleter_type dtor);
 
    BSONCXX_ABI_EXPORT_CDECL() value(unique_ptr_type ptr, std::size_t length);
 
    explicit BSONCXX_ABI_EXPORT_CDECL() value(document::view view);
 
    ~value() = default;
 
    BSONCXX_ABI_EXPORT_CDECL() value(const value&);
    BSONCXX_ABI_EXPORT_CDECL(value&) operator=(const value&);
 
    value(value&&) = default;
    value& operator=(value&&) = default;
 
    template <typename T, detail::requires_not_t<int, std::is_same<T, array::view>> = 0>
    explicit value(const T& t) : value({}) {
        to_bson(t, *this);
    }
    template <typename T>
    value& operator=(const T& t) {
        *this = value{t};
        return *this;
    }
 
    BSONCXX_ABI_EXPORT_CDECL(document::view::const_iterator) cbegin() const;
 
    BSONCXX_ABI_EXPORT_CDECL(document::view::const_iterator) cend() const;
 
    BSONCXX_ABI_EXPORT_CDECL(document::view::const_iterator) begin() const;
 
    BSONCXX_ABI_EXPORT_CDECL(document::view::const_iterator) end() const;
 
    BSONCXX_ABI_EXPORT_CDECL(document::view::const_iterator) find(stdx::string_view key) const;
 
    BSONCXX_ABI_EXPORT_CDECL(element) operator[](stdx::string_view key) const;
 
    BSONCXX_ABI_EXPORT_CDECL(const std::uint8_t*) data() const;
 
    BSONCXX_ABI_EXPORT_CDECL(std::size_t) length() const;
 
    BSONCXX_ABI_EXPORT_CDECL(bool) empty() const;
 
    document::view view() const noexcept {
        // Silence false positive with g++ 10.2.1 on Debian 11.
        BSONCXX_PUSH_WARNINGS();
        BSONCXX_DISABLE_WARNING(GCC("-Wmaybe-uninitialized"));
        return document::view{static_cast<uint8_t*>(_data.get()), _length};
        BSONCXX_POP_WARNINGS();
    }
 
    operator document::view() const noexcept {
        return view();
    }
 
    template <typename T>
    T get() {
        T temp{};
        from_bson(temp, this->view());
        return temp;
    }
 
    template <typename T>
    void get(T& t) {
        from_bson(t, this->view());
    }
 
    BSONCXX_ABI_EXPORT_CDECL(unique_ptr_type) release();
 
    BSONCXX_ABI_EXPORT_CDECL(void) reset(document::view view);
 
   private:
    unique_ptr_type _data;
    std::size_t _length{0};
};
 
 
inline bool operator==(const value& lhs, const value& rhs) {
    return (lhs.view() == rhs.view());
}
 
inline bool operator!=(const value& lhs, const value& rhs) {
    return !(lhs == rhs);
}
 
 
}  // namespace document
}  // namespace v_noabi
}  // namespace bsoncxx
 
namespace bsoncxx {
namespace document {
 
using ::bsoncxx::v_noabi::document::operator==;
using ::bsoncxx::v_noabi::document::operator!=;
 
}  // namespace document
}  // namespace bsoncxx
 
#include <bsoncxx/config/postlude.hpp>
 
 
#if defined(BSONCXX_PRIVATE_DOXYGEN_PREPROCESSOR)
 
namespace bsoncxx {
namespace document {
 
inline bool operator==(const v_noabi::document::value& lhs, const v_noabi::document::value& rhs);
 
inline bool operator!=(const v_noabi::document::value& lhs, const v_noabi::document::value& rhs);
 
}  // namespace document
}  // namespace bsoncxx
 
#endif  // defined(BSONCXX_PRIVATE_DOXYGEN_PREPROCESSOR)