MongoDB C++ Driver  mongocxx-3.10.2
element.hpp
1 // Copyright 2014 MongoDB Inc.
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14 
15 #pragma once
16 
17 #include <cstddef>
18 #include <cstdint>
19 
20 #include <bsoncxx/array/element-fwd.hpp>
21 #include <bsoncxx/array/view-fwd.hpp>
22 #include <bsoncxx/types/bson_value/view-fwd.hpp>
23 
24 #include <bsoncxx/document/element.hpp>
25 
26 #include <bsoncxx/config/prelude.hpp>
27 
28 namespace bsoncxx {
29 namespace v_noabi {
30 namespace array {
31 
39 class element : private document::element {
40  public:
41  element();
42 
43  using document::element::operator bool;
44 
46 
69 
71 
72  using document::element::operator[];
73 
79 
80  private:
81  friend ::bsoncxx::v_noabi::array::view;
82 
83  BSONCXX_PRIVATE explicit element(const std::uint8_t* raw,
84  std::uint32_t length,
85  std::uint32_t offset,
86  std::uint32_t keylen);
87 
88  BSONCXX_PRIVATE explicit element(const stdx::string_view key);
89 };
90 
100 BSONCXX_API bool BSONCXX_CALL operator==(const element& elem, const types::bson_value::view& v);
101 BSONCXX_API bool BSONCXX_CALL operator==(const types::bson_value::view& v, const element& elem);
105 
115 BSONCXX_API bool BSONCXX_CALL operator!=(const element& elem, const types::bson_value::view& v);
116 BSONCXX_API bool BSONCXX_CALL operator!=(const types::bson_value::view& v, const element& elem);
120 
121 } // namespace array
122 } // namespace v_noabi
123 } // namespace bsoncxx
124 
125 namespace bsoncxx {
126 namespace array {
127 
128 using ::bsoncxx::v_noabi::array::operator==;
129 using ::bsoncxx::v_noabi::array::operator!=;
130 
131 } // namespace array
132 } // namespace bsoncxx
133 
134 #include <bsoncxx/config/postlude.hpp>
A variant view type that accesses values in serialized BSON arrays.
Definition: element.hpp:39
bool operator==(const element &elem, const types::bson_value::view &v)
Convenience methods to compare for equality against a bson_value.
bool operator!=(const element &elem, const types::bson_value::view &v)
Convenience methods to compare for equality against a bson_value.
A variant view type that accesses values in serialized BSON documents.
Definition: element.hpp:45
std::uint32_t keylen() const
Getter for the element's key length.
types::b_codewscope get_codewscope() const
Getter for elements of the b_codewscope type.
types::b_code get_code() const
Getter for elements of the b_code type.
types::b_null get_null() const
Getter for elements of the b_null type.
types::b_binary get_binary() const
Getter for elements of the b_binary type.
types::b_regex get_regex() const
Getter for elements of the b_regex type.
stdx::string_view key() const
Getter for the element's key.
types::b_symbol get_symbol() const
Getter for elements of the b_symbol type.
types::b_array get_array() const
Getter for elements of the b_array type.
types::b_document get_document() const
Getter for elements of the b_document type.
std::uint32_t length() const
Getter for length of the raw bson bytes the element points to.
std::uint32_t offset() const
Getter for the offset into the raw bson bytes the element points to.
types::b_undefined get_undefined() const
Getter for elements of the b_undefined type.
bsoncxx::v_noabi::type type() const
Getter for the type of the element.
types::b_bool get_bool() const
Getter for elements of the b_bool type.
types::b_dbpointer get_dbpointer() const
Getter for elements of the b_dbpointer type.
types::b_oid get_oid() const
Getter for elements of the b_oid type.
types::bson_value::view get_value() const
Getter for a types::bson_value::view variant wrapper of the value portion of the element.
types::b_double get_double() const
Getter for elements of the b_double type.
types::b_date get_date() const
Getter for elements of the b_date type.
types::b_int32 get_int32() const
Getter for elements of the b_int32 type.
types::b_timestamp get_timestamp() const
Getter for elements of the b_timestamp type.
types::b_string get_utf8() const
Getter for elements of the b_string type.
const std::uint8_t * raw() const
Getter for the raw bson bytes the element points to.
types::b_int64 get_int64() const
Getter for elements of the b_int64 type.
types::b_minkey get_minkey() const
Getter for elements of the b_minkey type.
types::b_maxkey get_maxkey() const
Getter for elements of the b_maxkey type.
types::b_string get_string() const
Getter for elements of the b_string type.
types::b_decimal128 get_decimal128() const
Getter for elements of the b_decimal128 type.
A view-only variant that can contain any BSON type.
Definition: view.hpp:41
The top-level namespace for bsoncxx library entities.
Definition: element-fwd.hpp:19