MongoDB C++ Driver  mongocxx-3.9.0
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/config/prelude.hpp>
21 
22 namespace bsoncxx {
23 inline namespace v_noabi {
27 enum class error_code : std::int32_t {
30 
33 
36 
39 
42 #define BSONCXX_ENUM(name, value) k_need_element_type_k_##name,
43 #include <bsoncxx/enums/type.hpp>
44 #undef BSONCXX_ENUM
46  k_need_key,
47 
50 
53 
54  // Attempted to view or extract a document when a key was still awaiting a matching value.
55  k_unmatched_key_in_builder,
56 
59 
62 
65 
66  // This type is unused and deprecated.
67  k_failed_converting_bson_to_json,
68 
71 
74 
77 
80 
83 
86 
89 
92 
94 #define BSONCXX_ENUM(name, value) k_cannot_append_##name,
95 #include <bsoncxx/enums/type.hpp>
96 #undef BSONCXX_ENUM
97  k_cannot_append_utf8 = k_cannot_append_string,
98  k_need_element_type_k_utf8 = k_need_element_type_k_string,
99  // Add new constant string message to error_code.cpp as well!
100 };
101 
107 BSONCXX_API const std::error_category& BSONCXX_CALL error_category();
108 
115 BSONCXX_INLINE std::error_code make_error_code(error_code error) {
116  return {static_cast<int>(error), error_category()};
117 }
118 
119 } // namespace v_noabi
120 } // namespace bsoncxx
121 
122 #include <bsoncxx/config/postlude.hpp>
123 
124 namespace std {
125 // Specialize is_error_code_enum so we get simpler std::error_code construction
126 template <>
127 struct is_error_code_enum<bsoncxx::error_code> : public true_type {};
128 } // namespace std
error_code
Enum representing the various error types that can occur while operating on BSON values.
Definition: error_code.hpp:27
@ 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::error_code into a std::error_code.
Definition: error_code.hpp:115
The top-level namespace for bsoncxx library entities.
Definition: element.hpp:24