1#ifndef SIMDJSON_ELEMENT_INL_H
2#define SIMDJSON_ELEMENT_INL_H
4#include "simdjson/dom/base.h"
5#include "simdjson/dom/element.h"
6#include "simdjson/dom/document.h"
7#include "simdjson/dom/object.h"
8#include "simdjson/internal/tape_type.h"
10#include "simdjson/dom/object-inl.h"
11#include "simdjson/error-inl.h"
12#include "simdjson/jsonpathutil.h"
22simdjson_inline simdjson_result<dom::element>::simdjson_result() noexcept
23 : internal::simdjson_result_base<dom::element>() {}
24simdjson_inline simdjson_result<dom::element>::simdjson_result(dom::element &&value) noexcept
25 : internal::simdjson_result_base<dom::element>(std::forward<dom::element>(value)) {}
26simdjson_inline simdjson_result<dom::element>::simdjson_result(
error_code error) noexcept
27 : internal::simdjson_result_base<dom::element>(error) {}
28inline simdjson_result<dom::element_type> simdjson_result<dom::element>::type() const noexcept {
29 if (error()) {
return error(); }
34simdjson_inline
bool simdjson_result<dom::element>::is() const noexcept {
35 return !error() && first.is<T>();
39 if (error()) {
return error(); }
40 return first.get<T>();
44 if (error()) {
return error(); }
45 return first.get<T>(value);
48simdjson_inline simdjson_result<dom::array> simdjson_result<dom::element>::get_array() const noexcept {
49 if (error()) {
return error(); }
50 return first.get_array();
52simdjson_inline simdjson_result<dom::object> simdjson_result<dom::element>::get_object() const noexcept {
53 if (error()) {
return error(); }
54 return first.get_object();
56simdjson_inline simdjson_result<const char *> simdjson_result<dom::element>::get_c_str() const noexcept {
57 if (error()) {
return error(); }
58 return first.get_c_str();
60simdjson_inline simdjson_result<size_t> simdjson_result<dom::element>::get_string_length() const noexcept {
61 if (error()) {
return error(); }
62 return first.get_string_length();
64simdjson_inline simdjson_result<std::string_view> simdjson_result<dom::element>::get_string() const noexcept {
65 if (error()) {
return error(); }
66 return first.get_string();
68simdjson_inline simdjson_result<int64_t> simdjson_result<dom::element>::get_int64() const noexcept {
69 if (error()) {
return error(); }
70 return first.get_int64();
72simdjson_inline simdjson_result<uint64_t> simdjson_result<dom::element>::get_uint64() const noexcept {
73 if (error()) {
return error(); }
74 return first.get_uint64();
76simdjson_inline simdjson_result<double> simdjson_result<dom::element>::get_double() const noexcept {
77 if (error()) {
return error(); }
78 return first.get_double();
80simdjson_inline simdjson_result<bool> simdjson_result<dom::element>::get_bool() const noexcept {
81 if (error()) {
return error(); }
82 return first.get_bool();
85simdjson_inline
bool simdjson_result<dom::element>::is_array() const noexcept {
86 return !error() && first.is_array();
88simdjson_inline
bool simdjson_result<dom::element>::is_object() const noexcept {
89 return !error() && first.is_object();
91simdjson_inline
bool simdjson_result<dom::element>::is_string() const noexcept {
92 return !error() && first.is_string();
94simdjson_inline
bool simdjson_result<dom::element>::is_int64() const noexcept {
95 return !error() && first.is_int64();
97simdjson_inline
bool simdjson_result<dom::element>::is_uint64() const noexcept {
98 return !error() && first.is_uint64();
100simdjson_inline
bool simdjson_result<dom::element>::is_double() const noexcept {
101 return !error() && first.is_double();
103simdjson_inline
bool simdjson_result<dom::element>::is_number() const noexcept {
104 return !error() && first.is_number();
106simdjson_inline
bool simdjson_result<dom::element>::is_bool() const noexcept {
107 return !error() && first.is_bool();
110simdjson_inline
bool simdjson_result<dom::element>::is_null() const noexcept {
111 return !error() && first.is_null();
114simdjson_inline simdjson_result<dom::element> simdjson_result<dom::element>::operator[](std::string_view key)
const noexcept {
115 if (error()) {
return error(); }
118simdjson_inline simdjson_result<dom::element> simdjson_result<dom::element>::operator[](
const char *key)
const noexcept {
119 if (error()) {
return error(); }
122simdjson_inline simdjson_result<dom::element> simdjson_result<dom::element>::at_pointer(
const std::string_view json_pointer)
const noexcept {
123 if (error()) {
return error(); }
124 return first.at_pointer(json_pointer);
126simdjson_inline simdjson_result<dom::element> simdjson_result<dom::element>::at_path(
const std::string_view json_path)
const noexcept {
129 return at_pointer(json_pointer);
132simdjson_inline simdjson_result<std::vector<dom::element>> simdjson_result<dom::element>::at_path_with_wildcard(
const std::string_view json_path)
const noexcept {
133 if (error()) {
return error(); }
134 return first.at_path_with_wildcard(json_path);
137#ifndef SIMDJSON_DISABLE_DEPRECATED_API
138[[deprecated(
"For standard compliance, use at_pointer instead, and prefix your pointers with a slash '/', see RFC6901 ")]]
139simdjson_inline simdjson_result<dom::element> simdjson_result<dom::element>::at(
const std::string_view json_pointer)
const noexcept {
140SIMDJSON_PUSH_DISABLE_WARNINGS
141SIMDJSON_DISABLE_DEPRECATED_WARNING
142 if (error()) {
return error(); }
143 return first.at(json_pointer);
144SIMDJSON_POP_DISABLE_WARNINGS
147simdjson_inline simdjson_result<dom::element> simdjson_result<dom::element>::at(
size_t index)
const noexcept {
148 if (error()) {
return error(); }
149 return first.at(index);
151simdjson_inline simdjson_result<dom::element> simdjson_result<dom::element>::at_key(std::string_view key)
const noexcept {
152 if (error()) {
return error(); }
153 return first.at_key(key);
155simdjson_inline simdjson_result<dom::element> simdjson_result<dom::element>::at_key_case_insensitive(std::string_view key)
const noexcept {
156 if (error()) {
return error(); }
157 return first.at_key_case_insensitive(key);
160#if SIMDJSON_EXCEPTIONS
162simdjson_inline simdjson_result<dom::element>::operator bool() const noexcept(false) {
165simdjson_inline simdjson_result<dom::element>::operator
const char *()
const noexcept(
false) {
166 return get<const char *>();
168simdjson_inline simdjson_result<dom::element>::operator std::string_view() const noexcept(false) {
169 return get<std::string_view>();
171simdjson_inline simdjson_result<dom::element>::operator uint64_t() const noexcept(false) {
172 return get<uint64_t>();
174simdjson_inline simdjson_result<dom::element>::operator int64_t() const noexcept(false) {
175 return get<int64_t>();
177simdjson_inline simdjson_result<dom::element>::operator double() const noexcept(false) {
178 return get<double>();
180simdjson_inline simdjson_result<dom::element>::operator dom::array() const noexcept(false) {
181 return get<dom::array>();
183simdjson_inline simdjson_result<dom::element>::operator dom::object() const noexcept(false) {
184 return get<dom::object>();
187simdjson_inline dom::array::iterator simdjson_result<dom::element>::begin() const noexcept(false) {
188 if (error()) {
throw simdjson_error(error()); }
189 return first.begin();
191simdjson_inline dom::array::iterator simdjson_result<dom::element>::end() const noexcept(false) {
192 if (error()) {
throw simdjson_error(error()); }
204simdjson_inline
element::element(
const internal::tape_ref &_tape) noexcept : tape{_tape} { }
207 SIMDJSON_DEVELOPMENT_ASSERT(tape.usable());
208 auto tape_type = tape.tape_ref_type();
213 SIMDJSON_DEVELOPMENT_ASSERT(tape.usable());
216 }
else if(tape.is_false()) {
222 SIMDJSON_DEVELOPMENT_ASSERT(tape.usable());
223 switch (tape.tape_ref_type()) {
224 case internal::tape_type::STRING: {
225 return tape.get_c_str();
232 SIMDJSON_DEVELOPMENT_ASSERT(tape.usable());
233 switch (tape.tape_ref_type()) {
234 case internal::tape_type::STRING: {
235 return tape.get_string_length();
242 SIMDJSON_DEVELOPMENT_ASSERT(tape.usable());
243 switch (tape.tape_ref_type()) {
244 case internal::tape_type::STRING:
245 return tape.get_string_view();
251 SIMDJSON_DEVELOPMENT_ASSERT(tape.usable());
252 if(simdjson_unlikely(!tape.is_uint64())) {
253 if(tape.is_int64()) {
254 int64_t result = tape.next_tape_value<int64_t>();
258 return uint64_t(result);
262 return tape.next_tape_value<int64_t>();
265 SIMDJSON_DEVELOPMENT_ASSERT(tape.usable());
266 if(simdjson_unlikely(!tape.is_int64())) {
267 if(tape.is_uint64()) {
268 uint64_t result = tape.next_tape_value<uint64_t>();
270 if (result > uint64_t((std::numeric_limits<int64_t>::max)())) {
273 return static_cast<int64_t
>(result);
277 return tape.next_tape_value<int64_t>();
280 SIMDJSON_DEVELOPMENT_ASSERT(tape.usable());
290 if(simdjson_unlikely(!tape.is_double())) {
291 if(tape.is_uint64()) {
292 return double(tape.next_tape_value<uint64_t>());
293 }
else if(tape.is_int64()) {
294 return double(tape.next_tape_value<int64_t>());
299 return tape.next_tape_value<
double>();
302 SIMDJSON_DEVELOPMENT_ASSERT(tape.usable());
303 switch (tape.tape_ref_type()) {
304 case internal::tape_type::START_ARRAY:
311 SIMDJSON_DEVELOPMENT_ASSERT(tape.usable());
312 switch (tape.tape_ref_type()) {
313 case internal::tape_type::START_OBJECT:
322 return get<T>().get(value);
326simdjson_warn_unused simdjson_inline
error_code element::get<element>(
element &value)
const noexcept {
332 error = get<T>(value);
337 auto result = get<T>();
338 return !result.error();
343template<>
inline simdjson_result<const char *> element::get<const char *>() const noexcept {
return get_c_str(); }
344template<>
inline simdjson_result<std::string_view> element::get<std::string_view>() const noexcept {
return get_string(); }
345template<>
inline simdjson_result<int64_t> element::get<int64_t>() const noexcept {
return get_int64(); }
346template<>
inline simdjson_result<uint64_t> element::get<uint64_t>() const noexcept {
return get_uint64(); }
347template<>
inline simdjson_result<double> element::get<double>() const noexcept {
return get_double(); }
348template<>
inline simdjson_result<bool> element::get<bool>() const noexcept {
return get_bool(); }
360 return tape.is_null_on_tape();
363#if SIMDJSON_EXCEPTIONS
365inline element::operator bool() const noexcept(false) {
return get<bool>(); }
366inline element::operator
const char*()
const noexcept(
false) {
return get<const char *>(); }
367inline element::operator std::string_view() const noexcept(false) {
return get<std::string_view>(); }
368inline element::operator uint64_t() const noexcept(false) {
return get<uint64_t>(); }
369inline element::operator int64_t() const noexcept(false) {
return get<int64_t>(); }
370inline element::operator double() const noexcept(false) {
return get<double>(); }
371inline element::operator
array() const noexcept(false) {
return get<array>(); }
372inline element::operator
object() const noexcept(false) {
return get<object>(); }
375 return get<array>().begin();
378 return get<array>().end();
390inline bool is_pointer_well_formed(std::string_view json_pointer)
noexcept {
391 if (simdjson_unlikely(json_pointer[0] !=
'/')) {
394 size_t escape = json_pointer.find(
'~');
395 if (escape == std::string_view::npos) {
398 if (escape == json_pointer.size() - 1) {
401 if (json_pointer[escape + 1] !=
'0' && json_pointer[escape + 1] !=
'1') {
408 SIMDJSON_DEVELOPMENT_ASSERT(tape.usable());
409 switch (tape.tape_ref_type()) {
410 case internal::tape_type::START_OBJECT:
412 case internal::tape_type::START_ARRAY:
415 if (!json_pointer.empty()) {
416 if (is_pointer_well_formed(json_pointer)) {
429 SIMDJSON_DEVELOPMENT_ASSERT(tape.usable());
431 switch (tape.tape_ref_type()) {
432 case internal::tape_type::START_OBJECT:
434 case internal::tape_type::START_ARRAY:
437 return std::vector<element>{};
444 return at_pointer(json_pointer);
446#ifndef SIMDJSON_DISABLE_DEPRECATED_API
447[[deprecated(
"For standard compliance, use at_pointer instead, and prefix your pointers with a slash '/', see RFC6901 ")]]
450 auto std_pointer = (json_pointer.empty() ?
"" :
"/") + std::string(json_pointer.begin(), json_pointer.end());
451 return at_pointer(std_pointer);
456 return get<array>().at(index);
459 return get<object>().at_key(key);
462 return get<object>().at_key_case_insensitive(key);
465 return tape.json_index < other.tape.json_index;
468 return tape.json_index == other.tape.json_index;
471inline bool element::dump_raw_tape(std::ostream &out)
const noexcept {
472 SIMDJSON_DEVELOPMENT_ASSERT(tape.usable());
473 return tape.doc->dump_raw_tape(out);
477inline std::ostream& operator<<(std::ostream& out,
element_type type) {
480 return out <<
"array";
482 return out <<
"object";
484 return out <<
"int64_t";
486 return out <<
"uint64_t";
488 return out <<
"double";
490 return out <<
"string";
492 return out <<
"bool";
494 return out <<
"null";
496 return out <<
"unexpected content!!!";
simdjson_result< std::vector< element > > at_path_with_wildcard(std::string_view json_path) const noexcept
Adds support for JSONPath expression with wildcards '*'.
simdjson_result< element > at_pointer(std::string_view json_pointer) const noexcept
Get the value associated with the given JSON pointer.
bool is_object() const noexcept
Whether this element is a json object.
bool is_double() const noexcept
Whether this element is a json number that fits in a double.
simdjson_inline element_type type() const noexcept
The type of this element.
bool is_number() const noexcept
Whether this element is a json number.
simdjson_result< T > get() const noexcept
Get the value as the provided type (T).
simdjson_result< const char * > get_c_str() const noexcept
Cast this element to a null-terminated C string.
bool operator<(const element &other) const noexcept
operator< defines a total order for element allowing to use them in ordered C++ STL containers
simdjson_result< element > at_pointer(const std::string_view json_pointer) const noexcept
Get the value associated with the given JSON pointer.
simdjson_result< double > get_double() const noexcept
Cast this element to a double floating-point.
simdjson_inline bool is() const noexcept
Tell whether the value can be cast to provided type (T).
simdjson_result< element > at_key_case_insensitive(std::string_view key) const noexcept
Get the value associated with the given key in a case-insensitive manner.
void tie(T &value, error_code &error) &&noexcept
Get the value as the provided type (T), setting error if it's not the given type.
simdjson_result< bool > get_bool() const noexcept
Cast this element to a bool.
bool is_string() const noexcept
Whether this element is a json string.
simdjson_result< element > at_key(std::string_view key) const noexcept
Get the value associated with the given key.
dom::array::iterator end() const noexcept(false)
Iterate over each element in this array.
simdjson_result< array > get_array() const noexcept
Cast this element to an array.
simdjson_result< size_t > get_string_length() const noexcept
Gives the length in bytes of the string.
simdjson_inline element() noexcept
Create a new, invalid element.
simdjson_result< uint64_t > get_uint64() const noexcept
Cast this element to an unsigned integer.
dom::array::iterator begin() const noexcept(false)
Iterate over each element in this array.
simdjson_result< element > at(const std::string_view json_pointer) const noexcept
Version 0.4 of simdjson used an incorrect interpretation of the JSON Pointer standard and allowed the...
simdjson_result< int64_t > get_int64() const noexcept
Cast this element to a signed integer.
simdjson_result< object > get_object() const noexcept
Cast this element to an object.
bool is_uint64() const noexcept
Whether this element is a json number that fits in an unsigned 64-bit integer.
simdjson_result< element > operator[](std::string_view key) const noexcept
Get the value associated with the given key.
bool is_int64() const noexcept
Whether this element is a json number that fits in a signed 64-bit integer.
bool is_null() const noexcept
Whether this element is a json null.
simdjson_result< element > at_path(std::string_view json_path) const noexcept
Get the value associated with the given JSONPath expression.
simdjson_result< std::string_view > get_string() const noexcept
Cast this element to a string.
bool is_array() const noexcept
Whether this element is a json array.
bool operator==(const element &other) const noexcept
operator== allows to verify if two element values reference the same JSON item
bool is_bool() const noexcept
Whether this element is a json true or false.
simdjson_result< std::vector< element > > at_path_with_wildcard(std::string_view json_path) const noexcept
Adds support for JSONPath expression with wildcards '*'.
simdjson_result< element > at_pointer(std::string_view json_pointer) const noexcept
Get the value associated with the given JSON pointer.
element_type
The actual concrete type of a JSON element This is the type it is most easily cast to with get<>.
@ UINT64
uint64_t: any integer that fits in uint64_t but not int64_t
@ DOUBLE
double: Any number with a "." or "e" that fits in double.
The top level simdjson namespace, containing everything the library provides.
error_code
All possible errors returned by simdjson.
@ INCORRECT_TYPE
JSON element has a different type than user expected.
@ NO_SUCH_FIELD
JSON field not found in object.
@ NUMBER_OUT_OF_RANGE
JSON number does not fit in 64 bits.
@ INVALID_JSON_POINTER
Invalid JSON pointer syntax.
std::string json_path_to_pointer_conversion(std::string_view json_path)
Converts JSONPath to JSON Pointer.
The result of a simdjson operation that could fail.
simdjson_warn_unused simdjson_inline error_code get(T &value) &&noexcept
Move the value to the provided variable.