simdjson 4.2.3
Ridiculously Fast JSON
Loading...
Searching...
No Matches
array.h
1#ifndef SIMDJSON_GENERIC_ONDEMAND_ARRAY_H
2
3#ifndef SIMDJSON_CONDITIONAL_INCLUDE
4#define SIMDJSON_GENERIC_ONDEMAND_ARRAY_H
5#include "simdjson/generic/ondemand/base.h"
6#include "simdjson/generic/implementation_simdjson_result_base.h"
7#include "simdjson/generic/ondemand/value_iterator.h"
8#include <vector>
9#endif // SIMDJSON_CONDITIONAL_INCLUDE
10
11namespace simdjson {
12namespace SIMDJSON_IMPLEMENTATION {
13namespace ondemand {
14
18class array {
19public:
25 simdjson_inline array() noexcept = default;
26
32 simdjson_inline simdjson_result<array_iterator> begin() noexcept;
38 simdjson_inline simdjson_result<array_iterator> end() noexcept;
54 simdjson_inline simdjson_result<size_t> count_elements() & noexcept;
64 simdjson_inline simdjson_result<bool> is_empty() & noexcept;
75 inline simdjson_result<bool> reset() & noexcept;
104 inline simdjson_result<value> at_pointer(std::string_view json_pointer) noexcept;
105
119 inline simdjson_result<value> at_path(std::string_view json_path) noexcept;
120
128 inline simdjson_result<std::vector<value>> at_path_with_wildcard(std::string_view json_path) noexcept;
129
134 simdjson_inline simdjson_result<std::string_view> raw_json() noexcept;
135
143 simdjson_inline simdjson_result<value> at(size_t index) noexcept;
144
145#if SIMDJSON_SUPPORTS_CONCEPTS
153 template <typename T>
154 simdjson_warn_unused simdjson_inline error_code get(T &out)
155 noexcept(custom_deserializable<T, array> ? nothrow_custom_deserializable<T, array> : true) {
156 static_assert(custom_deserializable<T, array>);
157 return deserialize(*this, out);
158 }
165 template <typename T>
166 simdjson_inline simdjson_result<T> get()
167 noexcept(custom_deserializable<T, value> ? nothrow_custom_deserializable<T, value> : true)
168 {
169 static_assert(std::is_default_constructible<T>::value, "The specified type is not default constructible.");
170 T out{};
171 SIMDJSON_TRY(get<T>(out));
172 return out;
173 }
174#endif // SIMDJSON_SUPPORTS_CONCEPTS
175protected:
179 simdjson_warn_unused simdjson_inline error_code consume() noexcept;
180
188 static simdjson_inline simdjson_result<array> start(value_iterator &iter) noexcept;
197 static simdjson_inline simdjson_result<array> start_root(value_iterator &iter) noexcept;
206 static simdjson_inline simdjson_result<array> started(value_iterator &iter) noexcept;
207
215 simdjson_inline array(const value_iterator &iter) noexcept;
216
222 value_iterator iter{};
223
224 friend class value;
225 friend class document;
226 friend struct simdjson_result<value>;
227 friend struct simdjson_result<array>;
228 friend class array_iterator;
229};
230
231} // namespace ondemand
232} // namespace SIMDJSON_IMPLEMENTATION
233} // namespace simdjson
234
235namespace simdjson {
236
237template<>
238struct simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array> : public SIMDJSON_IMPLEMENTATION::implementation_simdjson_result_base<SIMDJSON_IMPLEMENTATION::ondemand::array> {
239public:
240 simdjson_inline simdjson_result(SIMDJSON_IMPLEMENTATION::ondemand::array &&value) noexcept;
241 simdjson_inline simdjson_result(error_code error) noexcept;
242 simdjson_inline simdjson_result() noexcept = default;
243
246 inline simdjson_result<size_t> count_elements() & noexcept;
247 inline simdjson_result<bool> is_empty() & noexcept;
248 inline simdjson_result<bool> reset() & noexcept;
249 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at(size_t index) noexcept;
250 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at_pointer(std::string_view json_pointer) noexcept;
251 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at_path(std::string_view json_path) noexcept;
252 simdjson_inline simdjson_result<std::vector<SIMDJSON_IMPLEMENTATION::ondemand::value>> at_path_with_wildcard(std::string_view json_path) noexcept;
253 simdjson_inline simdjson_result<std::string_view> raw_json() noexcept;
254#if SIMDJSON_SUPPORTS_CONCEPTS
255 // TODO: move this code into object-inl.h
256
257 template<typename T>
258 simdjson_inline simdjson_result<T> get() noexcept {
259 if (error()) { return error(); }
260 if constexpr (std::is_same_v<T, SIMDJSON_IMPLEMENTATION::ondemand::array>) {
261 return first;
262 }
263 return first.get<T>();
264 }
265 template<typename T>
266 simdjson_warn_unused simdjson_inline error_code get(T& out) noexcept {
267 if (error()) { return error(); }
268 if constexpr (std::is_same_v<T, SIMDJSON_IMPLEMENTATION::ondemand::array>) {
269 out = first;
270 } else {
271 SIMDJSON_TRY( first.get<T>(out) );
272 }
273 return SUCCESS;
274 }
275#endif // SIMDJSON_SUPPORTS_CONCEPTS
276};
277
278} // namespace simdjson
279
280#endif // SIMDJSON_GENERIC_ONDEMAND_ARRAY_H
simdjson_inline simdjson_result< value > at(size_t index) noexcept
Get the value at the given index.
Definition array-inl.h:234
value_iterator iter
Iterator marking current position.
Definition array.h:222
simdjson_inline simdjson_result< bool > is_empty() &noexcept
This method scans the beginning of the array and checks whether the array is empty.
Definition array-inl.h:120
simdjson_result< std::vector< value > > at_path_with_wildcard(std::string_view json_path) noexcept
Get all values matching the given JSONPath expression with wildcard support.
Definition array-inl.h:173
simdjson_result< value > at_pointer(std::string_view json_pointer) noexcept
Get the value associated with the given JSON pointer.
Definition array-inl.h:131
static simdjson_inline simdjson_result< array > start(value_iterator &iter) noexcept
Begin array iteration.
Definition array-inl.h:61
simdjson_inline simdjson_result< array_iterator > begin() noexcept
Begin array iteration.
Definition array-inl.h:79
simdjson_inline array() noexcept=default
Create a new invalid array.
simdjson_inline simdjson_result< size_t > count_elements() &noexcept
This method scans the array and counts the number of elements.
Definition array-inl.h:107
simdjson_result< value > at_path(std::string_view json_path) noexcept
Get the value associated with the given JSONPath expression.
Definition array-inl.h:167
static simdjson_inline simdjson_result< array > start_root(value_iterator &iter) noexcept
Begin array iteration from the root.
Definition array-inl.h:68
static simdjson_inline simdjson_result< array > started(value_iterator &iter) noexcept
Begin array iteration.
Definition array-inl.h:73
simdjson_warn_unused simdjson_inline error_code consume() noexcept
Go to the end of the array, no matter where you are right now.
Definition array-inl.h:88
simdjson_inline simdjson_result< std::string_view > raw_json() noexcept
Consumes the array and returns a string_view instance corresponding to the array as represented in JS...
Definition array-inl.h:94
simdjson_inline simdjson_result< array_iterator > end() noexcept
Sentinel representing the end of the array.
Definition array-inl.h:85
simdjson_result< bool > reset() &noexcept
Reset the iterator so that we are pointing back at the beginning of the array.
Definition array-inl.h:127
An ephemeral JSON value returned during iteration.
Definition value.h:22
The top level simdjson namespace, containing everything the library provides.
Definition base.h:8
error_code
All possible errors returned by simdjson.
Definition error.h:19
@ SUCCESS
No error.
Definition error.h:20
The result of a simdjson operation that could fail.
Definition error.h:280
simdjson_inline error_code error() const noexcept
The error.
Definition error-inl.h:168
simdjson_warn_unused simdjson_inline error_code get(T &value) &&noexcept
Move the value to the provided variable.
Definition error-inl.h:163