MongoDB C++ Driver  mongocxx-3.10.2
All Classes Namespaces Functions Typedefs Enumerations Enumerator Friends Pages
error_code.hpp
1 // Copyright 2015 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 <cstdint>
18 #include <system_error>
19 
20 #include <bsoncxx/exception/error_code-fwd.hpp>
21 
22 #include <bsoncxx/config/prelude.hpp>
23 
24 namespace bsoncxx {
25 namespace v_noabi {
26 
30 enum class error_code : std::int32_t {
33 
36 
39 
42 
45 #define BSONCXX_ENUM(name, value) k_need_element_type_k_##name,
46 #include <bsoncxx/enums/type.hpp>
47 #undef BSONCXX_ENUM
49  k_need_key,
50 
53 
56 
57  // Attempted to view or extract a document when a key was still awaiting a matching value.
58  k_unmatched_key_in_builder,
59 
62 
65 
68 
69  // This type is unused and deprecated.
70  k_failed_converting_bson_to_json,
71 
74 
77 
80 
83 
86 
89 
92 
95 
97 #define BSONCXX_ENUM(name, value) k_cannot_append_##name,
98 #include <bsoncxx/enums/type.hpp>
99 #undef BSONCXX_ENUM
100  k_cannot_append_utf8 = k_cannot_append_string,
101  k_need_element_type_k_utf8 = k_need_element_type_k_string,
102  // Add new constant string message to error_code.cpp as well!
103 };
104 
110 BSONCXX_API const std::error_category& BSONCXX_CALL error_category();
111 
118 BSONCXX_INLINE std::error_code make_error_code(error_code error) {
119  return {static_cast<int>(error), error_category()};
120 }
121 
122 } // namespace v_noabi
123 } // namespace bsoncxx
124 
125 namespace bsoncxx {
126 
127 using ::bsoncxx::v_noabi::error_category;
128 using ::bsoncxx::v_noabi::make_error_code;
129 
130 } // namespace bsoncxx
131 
132 #include <bsoncxx/config/postlude.hpp>
133 
134 namespace std {
135 
136 // Specialize is_error_code_enum so we get simpler std::error_code construction
137 template <>
138 struct is_error_code_enum<bsoncxx::v_noabi::error_code> : public true_type {};
139 
140 } // namespace std
error_code
Enum representing the various error types that can occur while operating on BSON values.
Definition: error_code.hpp:30
@ k_no_array_to_close
An array was closed while no array was open.
@ k_cannot_append_key_in_sub_array
A new key was appended while building a subarray.
@ k_cannot_begin_appending_document
Failed to begin appending a BSON document to a BSON document or array.
@ k_cannot_close_document_in_sub_array
A subdocument was closed while building a subarray.
@ k_need_key
No key was provided when one was needed.
@ k_unset_element
An empty element was accessed.
@ k_json_parse_failure
A JSON document failed to parse.
@ k_internal_error
BSON data could not be processed, but no specific reason was available.
@ k_cannot_perform_array_operation_on_document
An array operation was performed while building a document.
@ k_invalid_bson_type_id
Invalid type.
@ k_cannot_perform_document_operation_on_array
A document operation was performed while building an array.
@ k_cannot_end_appending_array
Failed to complete appending an array to a BSON document or array.
@ k_invalid_decimal128
A Decimal128 string failed to parse.
@ k_no_document_to_close
A document was closed while no document was open.
@ k_cannot_begin_appending_array
Failed to begin appending an array to a BSON document or array.
@ k_invalid_oid
An Object ID string failed to parse.
@ k_cannot_close_array_in_sub_document
A subarray was closed while building a subdocument.
@ k_invalid_binary_subtype
Invalid binary subtype.
@ k_cannot_end_appending_document
Failed to complete appending a BSON document to a BSON document or array.
const std::error_category & error_category()
Get the error_category for exceptions originating from the bsoncxx library.
std::error_code make_error_code(error_code error)
Translate a bsoncxx::v_noabi::error_code into a std::error_code.
Definition: error_code.hpp:118
The top-level namespace for bsoncxx library entities.
Definition: element-fwd.hpp:19