- Returns
- The value of the field, or NO_SUCH_FIELD if the field is not in the object.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
-Definition at line 161 of file value-inl.h.
+Definition at line 163 of file value-inl.h.
@@ -721,7 +762,7 @@ template<typename T >Definition at line 91 of file value-inl.h.
+Definition at line 93 of file value-inl.h.
@@ -753,7 +794,7 @@ SUCCESS If the parse succeeded and the out parameter was set to the value.Definition at line 30 of file value-inl.h.
+Definition at line 32 of file value-inl.h.
@@ -785,7 +826,7 @@ INCORRECT_TYPE If the JSON value is not an array.Definition at line 75 of file value-inl.h.
+Definition at line 77 of file value-inl.h.
@@ -817,7 +858,7 @@ INCORRECT_TYPE if the JSON value is not true or false.Definition at line 57 of file value-inl.h.
+Definition at line 59 of file value-inl.h.
@@ -849,7 +890,7 @@ INCORRECT_TYPE If the JSON value is not a valid floating-point number. INCORRECT_TYPE If the JSON value is not a valid floating-point number. -Definition at line 60 of file value-inl.h.
+Definition at line 62 of file value-inl.h.
@@ -881,7 +922,7 @@ INCORRECT_TYPE If the JSON value is not a valid floating-point number. INCORRECT_TYPE If the JSON value is not a 64-bit integer. -Definition at line 69 of file value-inl.h.
+Definition at line 71 of file value-inl.h.
@@ -913,7 +954,7 @@ INCORRECT_TYPE If the JSON value is not a 64-bit integer.Definition at line 72 of file value-inl.h.
+Definition at line 74 of file value-inl.h.
@@ -948,7 +989,7 @@ INCORRECT_TYPE If the JSON value is not a 64-bit integer.You must check the type before accessing the value: it is an error to call "get_int64()" when number.get_number_type() is not number_type::signed_integer and when number.is_int64() is false.
Performance note: this is designed with performance in mind. When calling 'get_number()', you scan the number string only once, determining efficiently the type and storing it in an efficient manner.
-Definition at line 196 of file value-inl.h.
+Definition at line 198 of file value-inl.h.
@@ -982,7 +1023,7 @@ INCORRECT_TYPE If the JSON value is not a 64-bit integer.This function requires processing the number string, but it is expected to be faster than get_number().get_number_type() because it is does not parse the number value.
- Returns
- the type of the number
Definition at line 193 of file value-inl.h.
+Definition at line 195 of file value-inl.h.
@@ -1014,7 +1055,7 @@ INCORRECT_TYPE If the JSON value is not a 64-bit integer.Definition at line 33 of file value-inl.h.
+Definition at line 35 of file value-inl.h.
@@ -1048,7 +1089,7 @@ INCORRECT_TYPE If the JSON value is not an object.Definition at line 44 of file value-inl.h.
+Definition at line 46 of file value-inl.h.
@@ -1084,7 +1125,7 @@ INCORRECT_TYPE if the JSON value is not a string.Definition at line 47 of file value-inl.h.
+Definition at line 49 of file value-inl.h.
@@ -1130,7 +1171,7 @@ template<typename string_type >Performance: This method may be slower than get_string() or get_string(bool) because it may need to allocate memory. We recommend you avoid allocating an std::string unless you need to.
- Returns
- INCORRECT_TYPE if the JSON value is not a string. Otherwise, we return SUCCESS.
Definition at line 51 of file value-inl.h.
+Definition at line 53 of file value-inl.h.
@@ -1162,7 +1203,7 @@ template<typename string_type >Definition at line 63 of file value-inl.h.
+Definition at line 65 of file value-inl.h.
@@ -1194,7 +1235,7 @@ INCORRECT_TYPE If the JSON value is not a 64-bit unsigned integer.Definition at line 66 of file value-inl.h.
+Definition at line 68 of file value-inl.h.
@@ -1228,7 +1269,7 @@ INCORRECT_TYPE If the JSON value is not a 64-bit unsigned integer.Definition at line 54 of file value-inl.h.
+Definition at line 56 of file value-inl.h.
@@ -1260,7 +1301,7 @@ INCORRECT_TYPE if the JSON value is not a string.Performance note: if you call this function systematically before parsing a number, you may have fallen for a performance anti-pattern.
- Returns
- true if the number if negative.
Definition at line 190 of file value-inl.h.
+Definition at line 192 of file value-inl.h.
@@ -1290,7 +1331,7 @@ INCORRECT_TYPE if the JSON value is not a string.Checks whether the value is a negative number.
- Returns
- true if the number if negative.
Definition at line 186 of file value-inl.h.
+Definition at line 188 of file value-inl.h.
@@ -1323,7 +1364,7 @@ INCORRECT_TYPE if the JSON value is not a string.Definition at line 78 of file value-inl.h.
+Definition at line 80 of file value-inl.h.
@@ -1354,7 +1395,7 @@ INCORRECT_TYPE If the JSON value begins with 'n' and is not 'null'.Returns false when there it is an array or object.
- Returns
- true if the type is string, number, null, Boolean @error TAPE_ERROR when the JSON value is a bad token like "}" "," or "alse".
Definition at line 179 of file value-inl.h.
+Definition at line 181 of file value-inl.h.
@@ -1390,7 +1431,7 @@ INCORRECT_TYPE If the JSON value begins with 'n' and is not 'null'. -Definition at line 100 of file value-inl.h.
+Definition at line 102 of file value-inl.h.
@@ -1426,7 +1467,7 @@ INCORRECT_TYPE If the JSON value begins with 'n' and is not 'null'. -Definition at line 121 of file value-inl.h.
+Definition at line 123 of file value-inl.h.
@@ -1462,7 +1503,7 @@ INCORRECT_TYPE If the JSON value begins with 'n' and is not 'null'. -Definition at line 112 of file value-inl.h.
+Definition at line 114 of file value-inl.h.
@@ -1498,7 +1539,7 @@ INCORRECT_TYPE If the JSON value begins with 'n' and is not 'null'. -Definition at line 109 of file value-inl.h.
+Definition at line 111 of file value-inl.h.
@@ -1534,7 +1575,7 @@ INCORRECT_TYPE If the JSON value begins with 'n' and is not 'null'. -Definition at line 103 of file value-inl.h.
+Definition at line 105 of file value-inl.h.
@@ -1572,7 +1613,7 @@ INCORRECT_TYPE If the JSON value begins with 'n' and is not 'null'. -Definition at line 118 of file value-inl.h.
+Definition at line 120 of file value-inl.h.
@@ -1610,7 +1651,7 @@ INCORRECT_TYPE If the JSON value begins with 'n' and is not 'null'. -Definition at line 115 of file value-inl.h.
+Definition at line 117 of file value-inl.h.
@@ -1640,7 +1681,7 @@ template<class T >The programmer is responsible for providing an implementation of get<T> for the type T.
- Returns
- An instance of type T
Definition at line 97 of file value-inl.h.
+Definition at line 99 of file value-inl.h.
@@ -1676,7 +1717,7 @@ template<class T > -Definition at line 106 of file value-inl.h.
+Definition at line 108 of file value-inl.h.
@@ -1706,7 +1747,7 @@ template<class T >Get a string_view pointing at this value in the JSON document.
If this element is an array or an object, it consumes the array or the object and returns a string_view instance corresponding to the array as represented in JSON. It points inside the original document. If this element is a scalar (string, number, Boolean, null), it returns what raw_json_token() would return.
-Definition at line 204 of file value-inl.h.
+Definition at line 206 of file value-inl.h.
@@ -1748,7 +1789,7 @@ template<class T >See also value::raw_json().
-Definition at line 200 of file value-inl.h.
+Definition at line 202 of file value-inl.h.
@@ -1779,7 +1820,7 @@ template<class T >Start a value at the current position.
(It should already be started; this is just a self-documentation method.)
-Definition at line 23 of file value-inl.h.
+Definition at line 25 of file value-inl.h.
@@ -1811,7 +1852,7 @@ template<class T >NOTE: If you're only expecting a value to be one type (a typical case), it's generally better to just call .get_double, .get_string, etc. and check for INCORRECT_TYPE (or just let it throw an exception).
- Returns
- The type of JSON value (json_type::array, json_type::object, json_type::string, json_type::number, json_type::boolean, or json_type::null). @error TAPE_ERROR when the JSON value is a bad token like "}" "," or "alse".
Definition at line 175 of file value-inl.h.
+Definition at line 177 of file value-inl.h.
diff --git a/classsimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand_1_1value.js b/classsimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand_1_1value.js index 88db77ae1..78ff7f28f 100644 --- a/classsimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand_1_1value.js +++ b/classsimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand_1_1value.js @@ -3,6 +3,7 @@ var classsimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand_ [ "value", "classsimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand_1_1value.html#ab96f6c19a1866863a110e8bcc93e0392", null ], [ "value", "classsimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand_1_1value.html#a7188b9843c2b3b3050c54b52d5b6886f", null ], [ "at", "classsimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand_1_1value.html#acc369e813e7cf4a97564bb0d85f76db3", null ], + [ "at_path", "classsimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand_1_1value.html#a6f6c6d98a3605c8e04cad16fce05c16c", null ], [ "at_pointer", "classsimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand_1_1value.html#aadd2f646a3231d407948bf5f3da46528", null ], [ "begin", "classsimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand_1_1value.html#a88d1cdc3124965d707754af4fcfae7f9", null ], [ "count_elements", "classsimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand_1_1value.html#a481e2b0b216d29038ddca3242a7047ad", null ], diff --git a/classsimdjson_1_1dom_1_1parser.html b/classsimdjson_1_1dom_1_1parser.html index 0aab5f6ce..a1c3a8dcb 100644 --- a/classsimdjson_1_1dom_1_1parser.html +++ b/classsimdjson_1_1dom_1_1parser.html @@ -404,11 +404,11 @@ simdjson_inline simLoad a JSON document from a file and return a reference to it.
dom::parser parser; const element doc = parser.load("jsonexamples/twitter.json");
The function is eager: the file's content is loaded in memory inside the parser instance and immediately parsed. The file can be deleted after the parser.load call.
+
IMPORTANT: Document Lifetime
The JSON document still lives in the parser: this is the most efficient way to parse JSON documents because it reuses the same buffers, but you must use the document before you destroy the parser or call parse() again.
Moving the parser instance is safe, but it invalidates the element instances. You may store the parser instance without moving it by wrapping it inside an unique_ptr instance like so: std::unique_ptr<dom::parser> parser(new dom::parser{});.
+
Parser Capacity
If the parser's current capacity is less than the file length, it will allocate enough capacity to handle it (up to max_capacity).
- Parameters
-
@@ -467,7 +467,7 @@ Parser Capacity
It is similar to the function
loadexcept that instead of parsing into the internaldocumentinstance associated with the parser, it allows the user to provide a document instance.dom::parser parser; dom::document doc; element doc_root = parser.load_into_document(doc, "jsonexamples/twitter.json");
The function is eager: the file's content is loaded in memory inside the parser instance and immediately parsed. The file can be deleted after the
-parser.load_into_documentcall.+
IMPORTANT: Document Lifetime
After the call to load_into_document, the parser is no longer needed.
The JSON document lives in the document instance: you must keep the document instance alive while you navigate through it (i.e., used the returned value from load_into_document). You are encourage to reuse the document instance many times with new data to avoid reallocations:
@@ -531,20 +531,20 @@ IMPORTANT: Document LifetimeThe file is loaded in memory and can be safely deleted after the
parser.load_many(path)function has returned. The memory is held by theparserinstance.The function is lazy: it may be that no more than one JSON document at a time is parsed. And, possibly, no document many have been parsed when the
parser.load_many(path)function returned.If there is a UTF-8 BOM, the parser skips it.
-+
Format
The file must contain a series of one or more JSON documents, concatenated into a single buffer, separated by whitespace. It effectively parses until it has a fully valid document, then starts parsing the next document at that point. (It does this with more parallelism and lookahead than you might think, though.)
Documents that consist of an object or array may omit the whitespace between them, concatenating with no separator. documents that consist of a single primitive (i.e. documents that are not arrays or objects) MUST be separated with whitespace.
The documents must not exceed batch_size bytes (by default 1MB) or they will fail to parse. Setting batch_size to excessively large or excesively small values may impact negatively the performance.
-+
Error Handling
All errors are returned during iteration: if there is a global error such as memory allocation, it will be yielded as the first result. Iteration always stops after the first error.
As with all other simdjson methods, non-exception error handling is readily available through the same interface, requiring you to check the error before using the document:
dom::parser parser; dom::document_stream docs; auto error = parser.load_many(path).get(docs); if (error) { cerr << error << endl; exit(1); } for (auto doc : docs) { std::string_view title; if ((error = doc["title"].get(title)) { cerr << error << endl; exit(1); } cout << title << endl; }
-+
Threads
When compiled with SIMDJSON_THREADS_ENABLED, this method will use a single thread under the hood to do some lookahead.
-+
Parser Capacity
If the parser's current capacity is less than batch_size, it will allocate enough capacity to handle it (up to max_capacity).
- Parameters
-
@@ -704,11 +704,11 @@ Parser Capacity
Parse a JSON document and return a temporary reference to it.
dom::parser parser; element doc_root = parser.parse(buf, len);
The function eagerly parses the input: the input can be modified and discarded after the
-parser.parse(buf, len)call has completed.+
IMPORTANT: Document Lifetime
The JSON document still lives in the parser: this is the most efficient way to parse JSON documents because it reuses the same buffers, but you must use the document before you destroy the parser or call parse() again.
Moving the parser instance is safe, but it invalidates the element instances. You may store the parser instance without moving it by wrapping it inside an
-unique_ptrinstance like so:std::unique_ptr<dom::parser> parser(new dom::parser{});.+
REQUIRED: Buffer Padding
The buffer must have at least SIMDJSON_PADDING extra allocated bytes. It does not matter what those bytes are initialized to, as long as they are allocated. These bytes will be read: if you using a sanitizer that verifies that no uninitialized byte is read, then you should initialize the SIMDJSON_PADDING bytes to avoid runtime warnings.
If realloc_if_needed is true (the default), it is assumed that the buffer does not have enough padding, and it is copied into an enlarged temporary buffer before parsing. Thus the following is safe:
@@ -716,7 +716,7 @@ REQUIRED: Buffer PaddingIf you set realloc_if_needed to false (e.g., parser.parse(json, json_len, false)), you must provide a buffer with at least SIMDJSON_PADDING extra bytes at the end. The benefit of setting realloc_if_needed to false is that you avoid a temporary memory allocation and a copy.
The padded bytes may be read. It is not important how you initialize these bytes though we recommend a sensible default like null character values or spaces. For example, the following low-level code is safe:
const char *json = R"({"key":"value"})"; const size_t json_len = std::strlen(json); std::unique_ptr<char[]> padded_json_copy{new char[json_len + SIMDJSON_PADDING]}; std::memcpy(padded_json_copy.get(), json, json_len); std::memset(padded_json_copy.get() + json_len, '\0', SIMDJSON_PADDING); simdjson::dom::parser parser; simdjson::dom::element element = parser.parse(padded_json_copy.get(), json_len, false);
-+
Parser Capacity
If the parser's current capacity is less than len, it will allocate enough capacity to handle it (up to max_capacity).
- Parameters
-
@@ -788,7 +788,7 @@ Parser Capacity
It is similar to the function
parseexcept that instead of parsing into the internaldocumentinstance associated with the parser, it allows the user to provide a document instance.dom::parser parser; dom::document doc; element doc_root = parser.parse_into_document(doc, buf, len);
The function eagerly parses the input: the input can be modified and discarded after the
-parser.parse(buf, len)call has completed.+
IMPORTANT: Document Lifetime
After the call to parse_into_document, the parser is no longer needed.
The JSON document lives in the document instance: you must keep the document instance alive while you navigate through it (i.e., used the returned value from parse_into_document). You are encourage to reuse the document instance many times with new data to avoid reallocations:
@@ -864,23 +864,23 @@ IMPORTANT: Document LifetimeThe following is safe:
auto json = "[\"temporary data"]"_padded; auto docs = parser.parse_many(json); for (element doc : docs) { cout << std::string(doc["title"]) << endl; }
If there is a UTF-8 BOM, the parser skips it.
-+
Format
The buffer must contain a series of one or more JSON documents, concatenated into a single buffer, separated by whitespace. It effectively parses until it has a fully valid document, then starts parsing the next document at that point. (It does this with more parallelism and lookahead than you might think, though.)
documents that consist of an object or array may omit the whitespace between them, concatenating with no separator. documents that consist of a single primitive (i.e. documents that are not arrays or objects) MUST be separated with whitespace.
The documents must not exceed batch_size bytes (by default 1MB) or they will fail to parse. Setting batch_size to excessively large or excesively small values may impact negatively the performance.
-+
Error Handling
All errors are returned during iteration: if there is a global error such as memory allocation, it will be yielded as the first result. Iteration always stops after the first error.
As with all other simdjson methods, non-exception error handling is readily available through the same interface, requiring you to check the error before using the document:
dom::parser parser; dom::document_stream docs; auto error = parser.load_many(path).get(docs); if (error) { cerr << error << endl; exit(1); } for (auto doc : docs) { std::string_view title; if ((error = doc["title"].get(title)) { cerr << error << endl; exit(1); } cout << title << endl; }
-+
REQUIRED: Buffer Padding
The buffer must have at least SIMDJSON_PADDING extra allocated bytes. It does not matter what those bytes are initialized to, as long as they are allocated. These bytes will be read: if you using a sanitizer that verifies that no uninitialized byte is read, then you should initialize the SIMDJSON_PADDING bytes to avoid runtime warnings.
-+
Threads
When compiled with SIMDJSON_THREADS_ENABLED, this method will use a single thread under the hood to do some lookahead.
-+
Parser Capacity
If the parser's current capacity is less than batch_size, it will allocate enough capacity to handle it (up to max_capacity).
- Parameters
-
diff --git a/dir_7796bb4b727f918c96faee1bdd50e49a.js b/dir_7796bb4b727f918c96faee1bdd50e49a.js
index 147cfc99c..fcf57c628 100644
--- a/dir_7796bb4b727f918c96faee1bdd50e49a.js
+++ b/dir_7796bb4b727f918c96faee1bdd50e49a.js
@@ -15,6 +15,8 @@ var dir_7796bb4b727f918c96faee1bdd50e49a =
[ "field.h", "field_8h_source.html", null ],
[ "json_iterator-inl.h", "json__iterator-inl_8h_source.html", null ],
[ "json_iterator.h", "json__iterator_8h_source.html", null ],
+ [ "json_path_to_pointer_conversion-inl.h", "json__path__to__pointer__conversion-inl_8h_source.html", null ],
+ [ "json_path_to_pointer_conversion.h", "json__path__to__pointer__conversion_8h_source.html", null ],
[ "json_type-inl.h", "json__type-inl_8h_source.html", null ],
[ "json_type.h", "json__type_8h_source.html", null ],
[ "logger-inl.h", "logger-inl_8h_source.html", null ],
diff --git a/field_8h_source.html b/field_8h_source.html
index a3feaf341..664800fd1 100644
--- a/field_8h_source.html
+++ b/field_8h_source.html
@@ -155,7 +155,7 @@ $(document).ready(function(){initNavTree('field_8h_source.html',''); initResizab
The result of a simdjson operation that could fail.Definition: implementation_simdjson_result_base.h:35- + diff --git a/files.html b/files.html index cca9de8fc..9b1514462 100644 --- a/files.html +++ b/files.html @@ -153,26 +153,28 @@ $(document).ready(function(){initNavTree('files.html',''); initResizable(); }); - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + diff --git a/functions.html b/functions.html index ac05d0e7a..ac0ae2c1c 100644 --- a/functions.html +++ b/functions.html @@ -131,6 +131,12 @@ $(document).ready(function(){initNavTree('functions.html',''); initResizable(); : simdjson::dom::element , simdjson::dom::object +Definition: raw_json_string.h:192
- at_path() +: simdjson::SIMDJSON_IMPLEMENTATION::ondemand::array +, simdjson::SIMDJSON_IMPLEMENTATION::ondemand::document +, simdjson::SIMDJSON_IMPLEMENTATION::ondemand::object +, simdjson::SIMDJSON_IMPLEMENTATION::ondemand::value +
- at_pointer() : simdjson::dom::array , simdjson::dom::element diff --git a/functions_func.html b/functions_func.html index f342b2dee..177e1fe4f 100644 --- a/functions_func.html +++ b/functions_func.html @@ -131,6 +131,12 @@ $(document).ready(function(){initNavTree('functions_func.html',''); initResizabl : simdjson::dom::element , simdjson::dom::object
+- at_path() +: simdjson::SIMDJSON_IMPLEMENTATION::ondemand::array +, simdjson::SIMDJSON_IMPLEMENTATION::ondemand::document +, simdjson::SIMDJSON_IMPLEMENTATION::ondemand::object +, simdjson::SIMDJSON_IMPLEMENTATION::ondemand::value +
- at_pointer() : simdjson::dom::array , simdjson::dom::element diff --git a/generic_2ondemand_2array-inl_8h_source.html b/generic_2ondemand_2array-inl_8h_source.html index c56453c17..a842ea198 100644 --- a/generic_2ondemand_2array-inl_8h_source.html +++ b/generic_2ondemand_2array-inl_8h_source.html @@ -256,71 +256,128 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2array-inl_8h_source - - - - - - - - - - - - + + + +
169 return "-1"; // This is just a sentinel value, the caller should check for this and return an error.+ + + + + + + + - - - - - - - - - - - - - - - - - -196 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::begin() noexcept {- - - -200 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::end() noexcept {- - - -204 simdjson_inline simdjson_result<size_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::count_elements() & noexcept {- - - -208 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::is_empty() & noexcept {- - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + -212 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::at(size_t index) noexcept {- - - -216 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::at_pointer(std::string_view json_pointer) noexcept {- - - -220 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::raw_json() noexcept {- - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +249 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::begin() noexcept {+ + + +253 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::end() noexcept {+ + + +257 simdjson_inline simdjson_result<size_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::count_elements() & noexcept {+ + + +261 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::is_empty() & noexcept {+ + + +265 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::at(size_t index) noexcept {+ + + +269 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::at_pointer(std::string_view json_pointer) noexcept {+ + + +273 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::at_path(std::string_view json_path) noexcept {+ + + +277 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array>::raw_json() noexcept {+ + + + + +-A forward-only JSON array.Definition: array_iterator.h:23- +simdjson_inline simdjson_result< value > at(size_t index) noexceptGet the value at the given index.Definition: array-inl.h:166+simdjson_inline simdjson_result< value > at(size_t index) noexceptGet the value at the given index.Definition: array-inl.h:219simdjson_inline simdjson_result< bool > is_empty() &noexceptThis method scans the beginning of the array and checks whether the array is empty.Definition: array-inl.h:119simdjson_result< value > at_pointer(std::string_view json_pointer) noexceptGet the value associated with the given JSON pointer.Definition: array-inl.h:130@@ -328,6 +385,7 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2array-inl_8h_sourcestatic simdjson_inline simdjson_result< array > start(value_iterator &iter) noexceptBegin array iteration.Definition: array-inl.h:60simdjson_inline array() noexcept=defaultCreate a new invalid array.simdjson_inline error_code consume() noexceptGo to the end of the array, no matter where you are right now.Definition: array-inl.h:87+simdjson_inline simdjson_result< size_t > count_elements() &noexceptThis method scans the array and counts the number of elements.Definition: array-inl.h:106simdjson_result< value > at_path(std::string_view json_path) noexceptGet the value associated with the given JSON path.Definition: array-inl.h:213static simdjson_inline simdjson_result< array > start_root(value_iterator &iter) noexceptBegin array iteration from the root.Definition: array-inl.h:67static simdjson_inline simdjson_result< array > started(value_iterator &iter) noexceptBegin array iteration.Definition: array-inl.h:72diff --git a/generic_2ondemand_2array_8h_source.html b/generic_2ondemand_2array_8h_source.html index 98dd72060..f737e75fe 100644 --- a/generic_2ondemand_2array_8h_source.html +++ b/generic_2ondemand_2array_8h_source.html @@ -114,58 +114,62 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2array_8h_source.htm - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + - -simdjson_inline simdjson_result< std::string_view > raw_json() noexceptConsumes the array and returns a string_view instance corresponding to the array as represented in JS...Definition: array-inl.h:93180 struct simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array> : public SIMDJSON_IMPLEMENTATION::implementation_simdjson_result_base<SIMDJSON_IMPLEMENTATION::ondemand::array> {- - - - + + + + + + -186 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> begin() noexcept;-187 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> end() noexcept;- - - -191 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at(size_t index) noexcept;-192 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at_pointer(std::string_view json_pointer) noexcept;- - - - - + + + + + + + +193 struct simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array> : public SIMDJSON_IMPLEMENTATION::implementation_simdjson_result_base<SIMDJSON_IMPLEMENTATION::ondemand::array> {+ + + + - +199 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> begin() noexcept;+200 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> end() noexcept;+ + + +204 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at(size_t index) noexcept;+205 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at_pointer(std::string_view json_pointer) noexcept;+206 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at_path(std::string_view json_path) noexcept;+ + + + + + +-A forward-only JSON array.Definition: array_iterator.h:23- +simdjson_inline simdjson_result< value > at(size_t index) noexceptGet the value at the given index.Definition: array-inl.h:166+simdjson_inline simdjson_result< value > at(size_t index) noexceptGet the value at the given index.Definition: array-inl.h:219simdjson_inline simdjson_result< bool > is_empty() &noexceptThis method scans the beginning of the array and checks whether the array is empty.Definition: array-inl.h:119simdjson_result< value > at_pointer(std::string_view json_pointer) noexceptGet the value associated with the given JSON pointer.Definition: array-inl.h:130@@ -173,6 +177,7 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2array_8h_source.htmstatic simdjson_inline simdjson_result< array > start(value_iterator &iter) noexceptBegin array iteration.Definition: array-inl.h:60simdjson_inline array() noexcept=defaultCreate a new invalid array.simdjson_inline error_code consume() noexceptGo to the end of the array, no matter where you are right now.Definition: array-inl.h:87+simdjson_inline simdjson_result< size_t > count_elements() &noexceptThis method scans the array and counts the number of elements.Definition: array-inl.h:106simdjson_result< value > at_path(std::string_view json_path) noexceptGet the value associated with the given JSON path.Definition: array-inl.h:213static simdjson_inline simdjson_result< array > start_root(value_iterator &iter) noexceptBegin array iteration from the root.Definition: array-inl.h:67static simdjson_inline simdjson_result< array > started(value_iterator &iter) noexceptBegin array iteration.Definition: array-inl.h:72@@ -184,7 +189,7 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2array_8h_source.htmsimdjson_inline simdjson_result< std::string_view > raw_json() noexceptConsumes the array and returns a string_view instance corresponding to the array as represented in JS...Definition: array-inl.h:93The result of a simdjson operation that could fail.Definition: implementation_simdjson_result_base.h:35- + diff --git a/generic_2ondemand_2base_8h_source.html b/generic_2ondemand_2base_8h_source.html index a84e48bdd..527a7840b 100644 --- a/generic_2ondemand_2base_8h_source.html +++ b/generic_2ondemand_2base_8h_source.html @@ -132,7 +132,7 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2base_8h_source.htmlDefinition: array_iterator.h:78-A forward-only JSON array.Definition: array_iterator.h:23+A document_reference is a thin wrapper around a document reference instance.Definition: document.h:639A document_reference is a thin wrapper around a document reference instance.Definition: document.h:653A forward-only stream of documents.Definition: document_stream.h:79diff --git a/generic_2ondemand_2document-inl_8h_source.html b/generic_2ondemand_2document-inl_8h_source.html index 2c6a6b704..f16ad50f0 100644 --- a/generic_2ondemand_2document-inl_8h_source.html +++ b/generic_2ondemand_2document-inl_8h_source.html @@ -100,879 +100,910 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2document-inl_8h_sou - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -A JSON field (key/value pair) in an object.Definition: field.h:2269 // Make sure we start any arrays or objects before returning, so that start_root_<object/array>()- - -72 // It is the convention throughout the code that the macro `SIMDJSON_DEVELOPMENT_CHECKS` determines whether- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -138 simdjson_inline simdjson_result<std::string_view> document::get_string(bool allow_replacement) noexcept {- - - -142 simdjson_inline error_code document::get_string(string_type& receiver, bool allow_replacement) noexcept {- - - - - - - - - - - - - - - -158 template<> simdjson_inline simdjson_result<array> document::get() & noexcept { return get_array(); }-159 template<> simdjson_inline simdjson_result<object> document::get() & noexcept { return get_object(); }-160 template<> simdjson_inline simdjson_result<raw_json_string> document::get() & noexcept { return get_raw_json_string(); }-161 template<> simdjson_inline simdjson_result<std::string_view> document::get() & noexcept { return get_string(false); }-162 template<> simdjson_inline simdjson_result<double> document::get() & noexcept { return get_double(); }-163 template<> simdjson_inline simdjson_result<uint64_t> document::get() & noexcept { return get_uint64(); }-164 template<> simdjson_inline simdjson_result<int64_t> document::get() & noexcept { return get_int64(); }-165 template<> simdjson_inline simdjson_result<bool> document::get() & noexcept { return get_bool(); }-166 template<> simdjson_inline simdjson_result<value> document::get() & noexcept { return get_value(); }- -168 template<> simdjson_inline simdjson_result<raw_json_string> document::get() && noexcept { return get_raw_json_string(); }-169 template<> simdjson_inline simdjson_result<std::string_view> document::get() && noexcept { return get_string(false); }-170 template<> simdjson_inline simdjson_result<double> document::get() && noexcept { return std::forward<document>(*this).get_double(); }-171 template<> simdjson_inline simdjson_result<uint64_t> document::get() && noexcept { return std::forward<document>(*this).get_uint64(); }-172 template<> simdjson_inline simdjson_result<int64_t> document::get() && noexcept { return std::forward<document>(*this).get_int64(); }-173 template<> simdjson_inline simdjson_result<bool> document::get() && noexcept { return std::forward<document>(*this).get_bool(); }-174 template<> simdjson_inline simdjson_result<value> document::get() && noexcept { return get_value(); }- - - - - - - - - - - - - - - - -191 simdjson_inline document::operator std::string_view() noexcept(false) { return get_string(false); }-192 simdjson_inline document::operator raw_json_string() noexcept(false) { return get_raw_json_string(); }- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -228 simdjson_inline simdjson_result<value> document::find_field_unordered(std::string_view key) & noexcept {- - -231 simdjson_inline simdjson_result<value> document::find_field_unordered(const char *key) & noexcept {- - - - - - - - - - - - - - - - - - - - - - - - -256 return std::string_view(reinterpret_cast<const char*>(starting_point), size_t(final_point - starting_point));- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -289 return std::string_view(reinterpret_cast<const char*>(_iter.peek_start()), _iter.peek_start_length());- - -292 simdjson_inline simdjson_result<value> document::at_pointer(std::string_view json_pointer) noexcept {- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -332 simdjson_inline simdjson_result<size_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::count_elements() & noexcept {- - - -336 simdjson_inline simdjson_result<size_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::count_fields() & noexcept {- - - -340 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::at(size_t index) & noexcept {- - - -344 simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::rewind() noexcept {- - - - -349 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::begin() & noexcept {- - - -353 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::end() & noexcept {- - -356 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::find_field_unordered(std::string_view key) & noexcept {- - - -360 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::find_field_unordered(const char *key) & noexcept {- - - -364 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator[](std::string_view key) & noexcept {- - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +71 // Make sure we start any arrays or objects before returning, so that start_root_<object/array>()+ + +74 // It is the convention throughout the code that the macro `SIMDJSON_DEVELOPMENT_CHECKS` determines whether+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +140 simdjson_inline simdjson_result<std::string_view> document::get_string(bool allow_replacement) noexcept {+ + + +144 simdjson_inline error_code document::get_string(string_type& receiver, bool allow_replacement) noexcept {+ + + + + + + + + + + + + + + +160 template<> simdjson_inline simdjson_result<array> document::get() & noexcept { return get_array(); }+161 template<> simdjson_inline simdjson_result<object> document::get() & noexcept { return get_object(); }+162 template<> simdjson_inline simdjson_result<raw_json_string> document::get() & noexcept { return get_raw_json_string(); }+163 template<> simdjson_inline simdjson_result<std::string_view> document::get() & noexcept { return get_string(false); }+164 template<> simdjson_inline simdjson_result<double> document::get() & noexcept { return get_double(); }+165 template<> simdjson_inline simdjson_result<uint64_t> document::get() & noexcept { return get_uint64(); }+166 template<> simdjson_inline simdjson_result<int64_t> document::get() & noexcept { return get_int64(); }+167 template<> simdjson_inline simdjson_result<bool> document::get() & noexcept { return get_bool(); }+168 template<> simdjson_inline simdjson_result<value> document::get() & noexcept { return get_value(); }+ +170 template<> simdjson_inline simdjson_result<raw_json_string> document::get() && noexcept { return get_raw_json_string(); }+171 template<> simdjson_inline simdjson_result<std::string_view> document::get() && noexcept { return get_string(false); }+172 template<> simdjson_inline simdjson_result<double> document::get() && noexcept { return std::forward<document>(*this).get_double(); }+173 template<> simdjson_inline simdjson_result<uint64_t> document::get() && noexcept { return std::forward<document>(*this).get_uint64(); }+174 template<> simdjson_inline simdjson_result<int64_t> document::get() && noexcept { return std::forward<document>(*this).get_int64(); }+175 template<> simdjson_inline simdjson_result<bool> document::get() && noexcept { return std::forward<document>(*this).get_bool(); }+176 template<> simdjson_inline simdjson_result<value> document::get() && noexcept { return get_value(); }+ + + + + + + + + + + + + + + + +193 simdjson_inline document::operator std::string_view() noexcept(false) { return get_string(false); }+194 simdjson_inline document::operator raw_json_string() noexcept(false) { return get_raw_json_string(); }+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +230 simdjson_inline simdjson_result<value> document::find_field_unordered(std::string_view key) & noexcept {+ + +233 simdjson_inline simdjson_result<value> document::find_field_unordered(const char *key) & noexcept {+ + + + + + + + + + + + + + + + + + + + + + + + +258 return std::string_view(reinterpret_cast<const char*>(starting_point), size_t(final_point - starting_point));+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +291 return std::string_view(reinterpret_cast<const char*>(_iter.peek_start()), _iter.peek_start_length());+ + +294 simdjson_inline simdjson_result<value> document::at_pointer(std::string_view json_pointer) noexcept {+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +351 simdjson_inline simdjson_result<size_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::count_elements() & noexcept {+ + + +355 simdjson_inline simdjson_result<size_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::count_fields() & noexcept {+ + + +359 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::at(size_t index) & noexcept {+ + + +363 simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::rewind() noexcept {+ + + -368 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator[](const char *key) & noexcept {+368 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::begin() & noexcept {- + -372 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::find_field(std::string_view key) & noexcept {- - - -376 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::find_field(const char *key) & noexcept {- - - -380 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_array() & noexcept {- - - -384 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_object() & noexcept {- - - -388 simdjson_inline simdjson_result<uint64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_uint64() noexcept {- - - -392 simdjson_inline simdjson_result<uint64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_uint64_in_string() noexcept {- - - -396 simdjson_inline simdjson_result<int64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_int64() noexcept {- - - -400 simdjson_inline simdjson_result<int64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_int64_in_string() noexcept {- - - -404 simdjson_inline simdjson_result<double> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_double() noexcept {- - - -408 simdjson_inline simdjson_result<double> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_double_in_string() noexcept {- - - -412 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_string(bool allow_replacement) noexcept {- - - - -417 simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_string(string_type& receiver, bool allow_replacement) noexcept {- - - -421 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_wobbly_string() noexcept {- - - -425 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::raw_json_string> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_raw_json_string() noexcept {- - - -429 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_bool() noexcept {- - - -433 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_value() noexcept {- - - -437 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::is_null() noexcept {- - - - - -443 simdjson_inline simdjson_result<T> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get() & noexcept {- - - - -448 simdjson_inline simdjson_result<T> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get() && noexcept {- - +372 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::end() & noexcept {+ + +375 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::find_field_unordered(std::string_view key) & noexcept {+ + + +379 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::find_field_unordered(const char *key) & noexcept {+ + + +383 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator[](std::string_view key) & noexcept {+ + + +387 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator[](const char *key) & noexcept {+ + + +391 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::find_field(std::string_view key) & noexcept {+ + + +395 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::find_field(const char *key) & noexcept {+ + + +399 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_array() & noexcept {+ + + +403 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_object() & noexcept {+ + + +407 simdjson_inline simdjson_result<uint64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_uint64() noexcept {+ + + +411 simdjson_inline simdjson_result<uint64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_uint64_in_string() noexcept {+ + + +415 simdjson_inline simdjson_result<int64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_int64() noexcept {+ + + +419 simdjson_inline simdjson_result<int64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_int64_in_string() noexcept {+ + + +423 simdjson_inline simdjson_result<double> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_double() noexcept {+ + + +427 simdjson_inline simdjson_result<double> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_double_in_string() noexcept {+ + + +431 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_string(bool allow_replacement) noexcept {+ + + + +436 simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_string(string_type& receiver, bool allow_replacement) noexcept {+ + + +440 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_wobbly_string() noexcept {+ + + +444 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::raw_json_string> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_raw_json_string() noexcept {+ + + +448 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_bool() noexcept {+ + - -453 simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get(T &out) & noexcept {- - - - -458 simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get(T &out) && noexcept {- - - - -463 template<> simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get<SIMDJSON_IMPLEMENTATION::ondemand::document>() & noexcept = delete;-464 template<> simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get<SIMDJSON_IMPLEMENTATION::ondemand::document>() && noexcept {- - - -468 template<> simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get<SIMDJSON_IMPLEMENTATION::ondemand::document>(SIMDJSON_IMPLEMENTATION::ondemand::document &out) & noexcept = delete;-469 template<> simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get<SIMDJSON_IMPLEMENTATION::ondemand::document>(SIMDJSON_IMPLEMENTATION::ondemand::document &out) && noexcept {- - - - - -475 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::json_type> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::type() noexcept {- - - - -480 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::is_scalar() noexcept {- - - - - -486 simdjson_inline bool simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::is_negative() noexcept {- - - - -491 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::is_integer() noexcept {- - - - -496 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::number_type> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_number_type() noexcept {- - - - -501 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::number> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_number() noexcept {- - - - - - -508 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator SIMDJSON_IMPLEMENTATION::ondemand::array() & noexcept(false) {- - - -512 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator SIMDJSON_IMPLEMENTATION::ondemand::object() & noexcept(false) {- - - -516 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator uint64_t() noexcept(false) {- - - -520 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator int64_t() noexcept(false) {- - +452 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_value() noexcept {+ + + +456 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::is_null() noexcept {+ + + + + +462 simdjson_inline simdjson_result<T> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get() & noexcept {+ + + + +467 simdjson_inline simdjson_result<T> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get() && noexcept {+ + + + +472 simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get(T &out) & noexcept {+ + + + +477 simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get(T &out) && noexcept {+ + + + +482 template<> simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get<SIMDJSON_IMPLEMENTATION::ondemand::document>() & noexcept = delete;+483 template<> simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get<SIMDJSON_IMPLEMENTATION::ondemand::document>() && noexcept {+ + + +487 template<> simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get<SIMDJSON_IMPLEMENTATION::ondemand::document>(SIMDJSON_IMPLEMENTATION::ondemand::document &out) & noexcept = delete;+488 template<> simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get<SIMDJSON_IMPLEMENTATION::ondemand::document>(SIMDJSON_IMPLEMENTATION::ondemand::document &out) && noexcept {+ + + + + +494 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::json_type> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::type() noexcept {+ + + + +499 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::is_scalar() noexcept {+ + + + + +505 simdjson_inline bool simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::is_negative() noexcept {+ + + + +510 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::is_integer() noexcept {+ + + + +515 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::number_type> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_number_type() noexcept {+ + + + +520 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::number> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::get_number() noexcept {+ + -524 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator double() noexcept(false) {- - - -528 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator std::string_view() noexcept(false) {- - - -532 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator SIMDJSON_IMPLEMENTATION::ondemand::raw_json_string() noexcept(false) {- - - -536 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator bool() noexcept(false) {- - - -540 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator SIMDJSON_IMPLEMENTATION::ondemand::value() noexcept(false) {- - - - - - -547 simdjson_inline simdjson_result<const char *> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::current_location() noexcept {- - + + + +527 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator SIMDJSON_IMPLEMENTATION::ondemand::array() & noexcept(false) {+ + + +531 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator SIMDJSON_IMPLEMENTATION::ondemand::object() & noexcept(false) {+ + + +535 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator uint64_t() noexcept(false) {+ + + +539 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator int64_t() noexcept(false) {+ + + +543 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator double() noexcept(false) {+ + + +547 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator std::string_view() noexcept(false) {+ + - -552 simdjson_inline bool simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::at_end() const noexcept {- - - - - -558 simdjson_inline int32_t simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::current_depth() const noexcept {- - - - -563 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::raw_json_token() noexcept {- - - - -568 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::at_pointer(std::string_view json_pointer) noexcept {- - - - - - +551 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator SIMDJSON_IMPLEMENTATION::ondemand::raw_json_string() noexcept(false) {+ + + +555 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator bool() noexcept(false) {+ + + +559 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::operator SIMDJSON_IMPLEMENTATION::ondemand::value() noexcept(false) {+ + + + + + +566 simdjson_inline simdjson_result<const char *> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::current_location() noexcept {+ + + + +571 simdjson_inline bool simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::at_end() const noexcept {+ + + - - - - - - - -584 simdjson_inline simdjson_result<array> document_reference::get_array() & noexcept { return doc->get_array(); }-585 simdjson_inline simdjson_result<object> document_reference::get_object() & noexcept { return doc->get_object(); }-600 simdjson_inline simdjson_result<uint64_t> document_reference::get_uint64() noexcept { return doc->get_root_value_iterator().get_root_uint64(false); }-601 simdjson_inline simdjson_result<uint64_t> document_reference::get_uint64_in_string() noexcept { return doc->get_root_value_iterator().get_root_uint64_in_string(false); }-602 simdjson_inline simdjson_result<int64_t> document_reference::get_int64() noexcept { return doc->get_root_value_iterator().get_root_int64(false); }-603 simdjson_inline simdjson_result<int64_t> document_reference::get_int64_in_string() noexcept { return doc->get_root_value_iterator().get_root_int64_in_string(false); }-604 simdjson_inline simdjson_result<double> document_reference::get_double() noexcept { return doc->get_root_value_iterator().get_root_double(false); }-605 simdjson_inline simdjson_result<double> document_reference::get_double_in_string() noexcept { return doc->get_root_value_iterator().get_root_double(false); }-606 simdjson_inline simdjson_result<std::string_view> document_reference::get_string(bool allow_replacement) noexcept { return doc->get_root_value_iterator().get_root_string(false, allow_replacement); }- -608 simdjson_inline error_code document_reference::get_string(string_type& receiver, bool allow_replacement) noexcept { return doc->get_root_value_iterator().get_root_string(receiver, false, allow_replacement); }-609 simdjson_inline simdjson_result<std::string_view> document_reference::get_wobbly_string() noexcept { return doc->get_root_value_iterator().get_root_wobbly_string(false); }-610 simdjson_inline simdjson_result<raw_json_string> document_reference::get_raw_json_string() noexcept { return doc->get_root_value_iterator().get_root_raw_json_string(false); }-611 simdjson_inline simdjson_result<bool> document_reference::get_bool() noexcept { return doc->get_root_value_iterator().get_root_bool(false); }-612 simdjson_inline simdjson_result<value> document_reference::get_value() noexcept { return doc->get_value(); }-613 simdjson_inline simdjson_result<bool> document_reference::is_null() noexcept { return doc->get_root_value_iterator().is_root_null(false); }-614 template<> simdjson_inline simdjson_result<array> document_reference::get() & noexcept { return get_array(); }-615 template<> simdjson_inline simdjson_result<object> document_reference::get() & noexcept { return get_object(); }-616 template<> simdjson_inline simdjson_result<raw_json_string> document_reference::get() & noexcept { return get_raw_json_string(); }-617 template<> simdjson_inline simdjson_result<std::string_view> document_reference::get() & noexcept { return get_string(false); }-618 template<> simdjson_inline simdjson_result<double> document_reference::get() & noexcept { return get_double(); }-619 template<> simdjson_inline simdjson_result<uint64_t> document_reference::get() & noexcept { return get_uint64(); }-620 template<> simdjson_inline simdjson_result<int64_t> document_reference::get() & noexcept { return get_int64(); }-621 template<> simdjson_inline simdjson_result<bool> document_reference::get() & noexcept { return get_bool(); }-622 template<> simdjson_inline simdjson_result<value> document_reference::get() & noexcept { return get_value(); }- - - - -627 simdjson_inline document_reference::operator object() & noexcept(false) { return object(*doc); }-628 simdjson_inline document_reference::operator uint64_t() noexcept(false) { return get_uint64(); }- - -631 simdjson_inline document_reference::operator std::string_view() noexcept(false) { return std::string_view(*doc); }-632 simdjson_inline document_reference::operator raw_json_string() noexcept(false) { return get_raw_json_string(); }- - - -636 simdjson_inline simdjson_result<size_t> document_reference::count_elements() & noexcept { return doc->count_elements(); }-637 simdjson_inline simdjson_result<size_t> document_reference::count_fields() & noexcept { return doc->count_fields(); }-638 simdjson_inline simdjson_result<value> document_reference::at(size_t index) & noexcept { return doc->at(index); }-639 simdjson_inline simdjson_result<array_iterator> document_reference::begin() & noexcept { return doc->begin(); }-640 simdjson_inline simdjson_result<array_iterator> document_reference::end() & noexcept { return doc->end(); }-641 simdjson_inline simdjson_result<value> document_reference::find_field(std::string_view key) & noexcept { return doc->find_field(key); }-642 simdjson_inline simdjson_result<value> document_reference::find_field(const char *key) & noexcept { return doc->find_field(key); }-643 simdjson_inline simdjson_result<value> document_reference::operator[](std::string_view key) & noexcept { return (*doc)[key]; }-644 simdjson_inline simdjson_result<value> document_reference::operator[](const char *key) & noexcept { return (*doc)[key]; }-645 simdjson_inline simdjson_result<value> document_reference::find_field_unordered(std::string_view key) & noexcept { return doc->find_field_unordered(key); }-646 simdjson_inline simdjson_result<value> document_reference::find_field_unordered(const char *key) & noexcept { return doc->find_field_unordered(key); }-647 simdjson_inline simdjson_result<json_type> document_reference::type() noexcept { return doc->type(); }-648 simdjson_inline simdjson_result<bool> document_reference::is_scalar() noexcept { return doc->is_scalar(); }-649 simdjson_inline simdjson_result<const char *> document_reference::current_location() noexcept { return doc->current_location(); }-650 simdjson_inline int32_t document_reference::current_depth() const noexcept { return doc->current_depth(); }- -652 simdjson_inline simdjson_result<bool> document_reference::is_integer() noexcept { return doc->get_root_value_iterator().is_root_integer(false); }-653 simdjson_inline simdjson_result<number_type> document_reference::get_number_type() noexcept { return doc->get_root_value_iterator().get_root_number_type(false); }-654 simdjson_inline simdjson_result<number> document_reference::get_number() noexcept { return doc->get_root_value_iterator().get_root_number(false); }-655 simdjson_inline simdjson_result<std::string_view> document_reference::raw_json_token() noexcept { return doc->raw_json_token(); }-656 simdjson_inline simdjson_result<value> document_reference::at_pointer(std::string_view json_pointer) noexcept { return doc->at_pointer(json_pointer); }-657 simdjson_inline simdjson_result<std::string_view> document_reference::raw_json() noexcept { return doc->raw_json();}- - - - - - - - - -667 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::simdjson_result(SIMDJSON_IMPLEMENTATION::ondemand::document_reference value, error_code error)-668 noexcept : implementation_simdjson_result_base<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>(std::forward<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>(value), error) {}- - -671 simdjson_inline simdjson_result<size_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::count_elements() & noexcept {- - - -675 simdjson_inline simdjson_result<size_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::count_fields() & noexcept {- - - -679 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::at(size_t index) & noexcept {- - - -683 simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::rewind() noexcept {- - - - -688 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::begin() & noexcept {- - - -692 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::end() & noexcept {- - -695 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::find_field_unordered(std::string_view key) & noexcept {+577 simdjson_inline int32_t simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::current_depth() const noexcept {+ + + + +582 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::raw_json_token() noexcept {+ + + + +587 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::at_pointer(std::string_view json_pointer) noexcept {+ + + + +592 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document>::at_path(std::string_view json_path) noexcept {+ + + + + + + + + + + + + + +607 simdjson_inline simdjson_result<array> document_reference::get_array() & noexcept { return doc->get_array(); }+608 simdjson_inline simdjson_result<object> document_reference::get_object() & noexcept { return doc->get_object(); }+623 simdjson_inline simdjson_result<uint64_t> document_reference::get_uint64() noexcept { return doc->get_root_value_iterator().get_root_uint64(false); }+624 simdjson_inline simdjson_result<uint64_t> document_reference::get_uint64_in_string() noexcept { return doc->get_root_value_iterator().get_root_uint64_in_string(false); }+625 simdjson_inline simdjson_result<int64_t> document_reference::get_int64() noexcept { return doc->get_root_value_iterator().get_root_int64(false); }+626 simdjson_inline simdjson_result<int64_t> document_reference::get_int64_in_string() noexcept { return doc->get_root_value_iterator().get_root_int64_in_string(false); }+627 simdjson_inline simdjson_result<double> document_reference::get_double() noexcept { return doc->get_root_value_iterator().get_root_double(false); }+628 simdjson_inline simdjson_result<double> document_reference::get_double_in_string() noexcept { return doc->get_root_value_iterator().get_root_double(false); }+629 simdjson_inline simdjson_result<std::string_view> document_reference::get_string(bool allow_replacement) noexcept { return doc->get_root_value_iterator().get_root_string(false, allow_replacement); }+ +631 simdjson_inline error_code document_reference::get_string(string_type& receiver, bool allow_replacement) noexcept { return doc->get_root_value_iterator().get_root_string(receiver, false, allow_replacement); }+632 simdjson_inline simdjson_result<std::string_view> document_reference::get_wobbly_string() noexcept { return doc->get_root_value_iterator().get_root_wobbly_string(false); }+633 simdjson_inline simdjson_result<raw_json_string> document_reference::get_raw_json_string() noexcept { return doc->get_root_value_iterator().get_root_raw_json_string(false); }+634 simdjson_inline simdjson_result<bool> document_reference::get_bool() noexcept { return doc->get_root_value_iterator().get_root_bool(false); }+635 simdjson_inline simdjson_result<value> document_reference::get_value() noexcept { return doc->get_value(); }+636 simdjson_inline simdjson_result<bool> document_reference::is_null() noexcept { return doc->get_root_value_iterator().is_root_null(false); }+637 template<> simdjson_inline simdjson_result<array> document_reference::get() & noexcept { return get_array(); }+638 template<> simdjson_inline simdjson_result<object> document_reference::get() & noexcept { return get_object(); }+639 template<> simdjson_inline simdjson_result<raw_json_string> document_reference::get() & noexcept { return get_raw_json_string(); }+640 template<> simdjson_inline simdjson_result<std::string_view> document_reference::get() & noexcept { return get_string(false); }+641 template<> simdjson_inline simdjson_result<double> document_reference::get() & noexcept { return get_double(); }+642 template<> simdjson_inline simdjson_result<uint64_t> document_reference::get() & noexcept { return get_uint64(); }+643 template<> simdjson_inline simdjson_result<int64_t> document_reference::get() & noexcept { return get_int64(); }+644 template<> simdjson_inline simdjson_result<bool> document_reference::get() & noexcept { return get_bool(); }+645 template<> simdjson_inline simdjson_result<value> document_reference::get() & noexcept { return get_value(); }+ + + + +650 simdjson_inline document_reference::operator object() & noexcept(false) { return object(*doc); }+651 simdjson_inline document_reference::operator uint64_t() noexcept(false) { return get_uint64(); }+ + +654 simdjson_inline document_reference::operator std::string_view() noexcept(false) { return std::string_view(*doc); }+655 simdjson_inline document_reference::operator raw_json_string() noexcept(false) { return get_raw_json_string(); }+ + + +659 simdjson_inline simdjson_result<size_t> document_reference::count_elements() & noexcept { return doc->count_elements(); }+660 simdjson_inline simdjson_result<size_t> document_reference::count_fields() & noexcept { return doc->count_fields(); }+661 simdjson_inline simdjson_result<value> document_reference::at(size_t index) & noexcept { return doc->at(index); }+662 simdjson_inline simdjson_result<array_iterator> document_reference::begin() & noexcept { return doc->begin(); }+663 simdjson_inline simdjson_result<array_iterator> document_reference::end() & noexcept { return doc->end(); }+664 simdjson_inline simdjson_result<value> document_reference::find_field(std::string_view key) & noexcept { return doc->find_field(key); }+665 simdjson_inline simdjson_result<value> document_reference::find_field(const char *key) & noexcept { return doc->find_field(key); }+666 simdjson_inline simdjson_result<value> document_reference::operator[](std::string_view key) & noexcept { return (*doc)[key]; }+667 simdjson_inline simdjson_result<value> document_reference::operator[](const char *key) & noexcept { return (*doc)[key]; }+668 simdjson_inline simdjson_result<value> document_reference::find_field_unordered(std::string_view key) & noexcept { return doc->find_field_unordered(key); }+669 simdjson_inline simdjson_result<value> document_reference::find_field_unordered(const char *key) & noexcept { return doc->find_field_unordered(key); }+670 simdjson_inline simdjson_result<json_type> document_reference::type() noexcept { return doc->type(); }+671 simdjson_inline simdjson_result<bool> document_reference::is_scalar() noexcept { return doc->is_scalar(); }+672 simdjson_inline simdjson_result<const char *> document_reference::current_location() noexcept { return doc->current_location(); }+673 simdjson_inline int32_t document_reference::current_depth() const noexcept { return doc->current_depth(); }+ +675 simdjson_inline simdjson_result<bool> document_reference::is_integer() noexcept { return doc->get_root_value_iterator().is_root_integer(false); }+676 simdjson_inline simdjson_result<number_type> document_reference::get_number_type() noexcept { return doc->get_root_value_iterator().get_root_number_type(false); }+677 simdjson_inline simdjson_result<number> document_reference::get_number() noexcept { return doc->get_root_value_iterator().get_root_number(false); }+678 simdjson_inline simdjson_result<std::string_view> document_reference::raw_json_token() noexcept { return doc->raw_json_token(); }+679 simdjson_inline simdjson_result<value> document_reference::at_pointer(std::string_view json_pointer) noexcept { return doc->at_pointer(json_pointer); }+680 simdjson_inline simdjson_result<value> document_reference::at_path(std::string_view json_path) noexcept { return doc->at_path(json_path); }+681 simdjson_inline simdjson_result<std::string_view> document_reference::raw_json() noexcept { return doc->raw_json();}+ + + + + + + + + +691 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::simdjson_result(SIMDJSON_IMPLEMENTATION::ondemand::document_reference value, error_code error)+692 noexcept : implementation_simdjson_result_base<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>(std::forward<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>(value), error) {}+ + +695 simdjson_inline simdjson_result<size_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::count_elements() & noexcept {- + -699 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::find_field_unordered(const char *key) & noexcept {+699 simdjson_inline simdjson_result<size_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::count_fields() & noexcept {- + -703 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator[](std::string_view key) & noexcept {+703 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::at(size_t index) & noexcept {- + -707 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator[](const char *key) & noexcept {- - - -711 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::find_field(std::string_view key) & noexcept {- - - -715 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::find_field(const char *key) & noexcept {- - +707 simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::rewind() noexcept {+ + + + +712 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::begin() & noexcept {+ + + +716 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::end() & noexcept {+ -719 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_array() & noexcept {+719 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::find_field_unordered(std::string_view key) & noexcept {- + -723 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_object() & noexcept {+723 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::find_field_unordered(const char *key) & noexcept {- + -727 simdjson_inline simdjson_result<uint64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_uint64() noexcept {- - +727 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator[](std::string_view key) & noexcept {+ + -731 simdjson_inline simdjson_result<uint64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_uint64_in_string() noexcept {- - +731 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator[](const char *key) & noexcept {+ + -735 simdjson_inline simdjson_result<int64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_int64() noexcept {- - +735 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::find_field(std::string_view key) & noexcept {+ + -739 simdjson_inline simdjson_result<int64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_int64_in_string() noexcept {- - +739 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::find_field(const char *key) & noexcept {+ + -743 simdjson_inline simdjson_result<double> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_double() noexcept {- - +743 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_array() & noexcept {+ + -747 simdjson_inline simdjson_result<double> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_double_in_string() noexcept {- - +747 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_object() & noexcept {+ + -751 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_string(bool allow_replacement) noexcept {- - +751 simdjson_inline simdjson_result<uint64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_uint64() noexcept {+ + - -756 simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_string(string_type& receiver, bool allow_replacement) noexcept {- - - -760 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_wobbly_string() noexcept {- - - -764 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::raw_json_string> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_raw_json_string() noexcept {- - - -768 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_bool() noexcept {- - - -772 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_value() noexcept {- - - -776 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::is_null() noexcept {- - - -780 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::json_type> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::type() noexcept {- - +755 simdjson_inline simdjson_result<uint64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_uint64_in_string() noexcept {+ + + +759 simdjson_inline simdjson_result<int64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_int64() noexcept {+ + + +763 simdjson_inline simdjson_result<int64_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_int64_in_string() noexcept {+ + + +767 simdjson_inline simdjson_result<double> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_double() noexcept {+ + + +771 simdjson_inline simdjson_result<double> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_double_in_string() noexcept {+ + + +775 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_string(bool allow_replacement) noexcept {+ + + + +780 simdjson_inline error_code simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_string(string_type& receiver, bool allow_replacement) noexcept {+ + -784 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::is_scalar() noexcept {+784 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_wobbly_string() noexcept {- + -788 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::is_negative() noexcept {+788 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::raw_json_string> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_raw_json_string() noexcept {- + -792 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::is_integer() noexcept {+792 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_bool() noexcept {- + -796 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::number_type> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_number_type() noexcept {+796 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_value() noexcept {- + -800 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::number> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_number() noexcept {+800 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::is_null() noexcept {- + - -805 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator SIMDJSON_IMPLEMENTATION::ondemand::array() & noexcept(false) {- - - -809 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator SIMDJSON_IMPLEMENTATION::ondemand::object() & noexcept(false) {- - - -813 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator uint64_t() noexcept(false) {- - - -817 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator int64_t() noexcept(false) {- - - -821 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator double() noexcept(false) {- - - -825 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator std::string_view() noexcept(false) {- - - -829 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator SIMDJSON_IMPLEMENTATION::ondemand::raw_json_string() noexcept(false) {+804 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::json_type> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::type() noexcept {+ + + +808 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::is_scalar() noexcept {+ + + +812 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::is_negative() noexcept {+ + + +816 simdjson_inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::is_integer() noexcept {+ + + +820 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::number_type> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_number_type() noexcept {+ + + +824 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::number> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::get_number() noexcept {+ + + + +829 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator SIMDJSON_IMPLEMENTATION::ondemand::array() & noexcept(false) {-833 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator bool() noexcept(false) {+833 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator SIMDJSON_IMPLEMENTATION::ondemand::object() & noexcept(false) {-837 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator SIMDJSON_IMPLEMENTATION::ondemand::value() noexcept(false) {+837 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator uint64_t() noexcept(false) {- - -843 simdjson_inline simdjson_result<const char *> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::current_location() noexcept {- - - - -848 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::raw_json_token() noexcept {- - - - -853 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::at_pointer(std::string_view json_pointer) noexcept {- - +841 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator int64_t() noexcept(false) {+ + + +845 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator double() noexcept(false) {+ + + +849 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator std::string_view() noexcept(false) {+ + + +853 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator SIMDJSON_IMPLEMENTATION::ondemand::raw_json_string() noexcept(false) {+ + - - - - - +857 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator bool() noexcept(false) {+ + + +861 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::operator SIMDJSON_IMPLEMENTATION::ondemand::value() noexcept(false) {+ + + + + +867 simdjson_inline simdjson_result<const char *> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::current_location() noexcept {+ + + + +872 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::raw_json_token() noexcept {+ + + + +877 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::at_pointer(std::string_view json_pointer) noexcept {+ + + + +882 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference>::at_path(std::string_view json_path) noexcept {+ + + + + + + + +-static simdjson_inline simdjson_result< array > start_root(value_iterator &iter) noexceptBegin array iteration from the root.Definition: array-inl.h:67-simdjson_inline simdjson_result< uint64_t > get_uint64() noexceptThe document_reference instances are used primarily/solely for streams of JSON documents.Definition: document-inl.h:600-simdjson_inline simdjson_result< value > at(size_t index) &noexceptGet the value at the given index in the array.Definition: document-inl.h:211-simdjson_inline int32_t current_depth() const noexceptReturns the current depth in the document if in bounds.Definition: document-inl.h:43-simdjson_inline simdjson_result< array_iterator > begin() &noexceptBegin array iteration.Definition: document-inl.h:215-simdjson_inline simdjson_result< size_t > count_fields() &noexceptThis method scans the object and counts the number of key-value pairs.Definition: document-inl.h:204-simdjson_inline simdjson_result< std::string_view > get_string(bool allow_replacement=false) noexceptCast this JSON value to a string.Definition: document-inl.h:138-simdjson_warn_unused simdjson_inline simdjson_result< number > get_number() noexceptAttempt to parse an ondemand::number.Definition: document-inl.h:282-bool is_alive() noexceptSome unrecoverable error conditions may render the document instance unusable.Definition: document-inl.h:52-simdjson_inline simdjson_result< bool > get_bool() noexceptCast this JSON value to a bool.Definition: document-inl.h:151-simdjson_inline simdjson_result< object > get_object() &noexceptCast this JSON value to an object.Definition: document-inl.h:107-simdjson_inline simdjson_result< uint64_t > get_uint64() noexceptCast this JSON value to an unsigned integer.Definition: document-inl.h:120+simdjson_inline bool is_negative() noexceptChecks whether the document is a negative number.Definition: document-inl.h:270+simdjson_inline simdjson_result< uint64_t > get_uint64() noexceptThe document_reference instances are used primarily/solely for streams of JSON documents.Definition: document-inl.h:623+simdjson_inline simdjson_result< value > at(size_t index) &noexceptGet the value at the given index in the array.Definition: document-inl.h:213+simdjson_inline int32_t current_depth() const noexceptReturns the current depth in the document if in bounds.Definition: document-inl.h:45+simdjson_inline simdjson_result< array_iterator > begin() &noexceptBegin array iteration.Definition: document-inl.h:217+simdjson_inline simdjson_result< size_t > count_fields() &noexceptThis method scans the object and counts the number of key-value pairs.Definition: document-inl.h:206+simdjson_inline simdjson_result< std::string_view > get_string(bool allow_replacement=false) noexceptCast this JSON value to a string.Definition: document-inl.h:140+simdjson_warn_unused simdjson_inline simdjson_result< number > get_number() noexceptAttempt to parse an ondemand::number.Definition: document-inl.h:284+bool is_alive() noexceptSome unrecoverable error conditions may render the document instance unusable.Definition: document-inl.h:54+simdjson_inline simdjson_result< bool > get_bool() noexceptCast this JSON value to a bool.Definition: document-inl.h:153+simdjson_inline simdjson_result< object > get_object() &noexceptCast this JSON value to an object.Definition: document-inl.h:109+simdjson_inline simdjson_result< uint64_t > get_uint64() noexceptCast this JSON value to an unsigned integer.Definition: document-inl.h:122simdjson_inline bool is_negative() noexceptChecks whether the document is a negative number.Definition: document-inl.h:272-simdjson_inline document() noexcept=defaultCreate a new invalid document.-simdjson_inline simdjson_result< std::string_view > raw_json_token() noexceptGet the raw JSON for this token.Definition: document-inl.h:287-simdjson_inline simdjson_result< uint64_t > get_uint64_in_string() noexceptCast this JSON value (inside string) to an unsigned integer.Definition: document-inl.h:123-simdjson_inline simdjson_result< bool > is_null() noexceptChecks if this JSON value is null.Definition: document-inl.h:154-simdjson_inline simdjson_result< int64_t > get_int64() noexceptCast this JSON value to a signed integer.Definition: document-inl.h:126-simdjson_inline simdjson_result< value > at_pointer(std::string_view json_pointer) noexceptGet the value associated with the given JSON pointer.Definition: document-inl.h:292-simdjson_inline simdjson_result< json_type > type() noexceptGet the type of this JSON value.Definition: document-inl.h:259+simdjson_inline simdjson_result< array_iterator > end() &noexceptSentinel representing the end of the array.Definition: document-inl.h:218+simdjson_inline simdjson_result< std::string_view > raw_json_token() noexceptGet the raw JSON for this token.Definition: document-inl.h:289+simdjson_inline simdjson_result< uint64_t > get_uint64_in_string() noexceptCast this JSON value (inside string) to an unsigned integer.Definition: document-inl.h:125+simdjson_inline simdjson_result< bool > is_null() noexceptChecks if this JSON value is null.Definition: document-inl.h:156+simdjson_inline simdjson_result< int64_t > get_int64() noexceptCast this JSON value to a signed integer.Definition: document-inl.h:128+simdjson_inline simdjson_result< value > at_pointer(std::string_view json_pointer) noexceptGet the value associated with the given JSON pointer.Definition: document-inl.h:294+simdjson_inline simdjson_result< json_type > type() noexceptGet the type of this JSON value.Definition: document-inl.h:261simdjson_inline simdjson_result< array_iterator > end() &noexceptSentinel representing the end of the array.Definition: document-inl.h:220-simdjson_inline simdjson_result< T > get() &noexceptGet this value as the given type.Definition: document.h:181- -simdjson_inline simdjson_result< double > get_double_in_string() noexceptCast this JSON value (inside string) to a double.Definition: document-inl.h:135- -simdjson_inline simdjson_result< double > get_double() noexceptCast this JSON value to a double.Definition: document-inl.h:132-void rewind() noexceptReset the iterator inside the document instance so we are pointing back at the beginning of the docum...Definition: document-inl.h:31-simdjson_inline simdjson_result< std::string_view > raw_json() noexceptConsumes the document and returns a string_view instance corresponding to the document as represented...Definition: document-inl.h:247-simdjson_inline simdjson_result< value > find_field_unordered(std::string_view key) &noexceptLook up a field by name on an object, without regard to key order.Definition: document-inl.h:228-simdjson_inline simdjson_result< int64_t > get_int64_in_string() noexceptCast this JSON value (inside string) to a signed integer.Definition: document-inl.h:129-simdjson_inline simdjson_result< size_t > count_elements() &noexceptThis method scans the array and counts the number of elements.Definition: document-inl.h:197-simdjson_inline simdjson_result< value > get_value() noexceptCast this JSON value to a value when the document is an object or an array.Definition: document-inl.h:68-simdjson_inline simdjson_result< value > find_field(std::string_view key) &noexceptLook up a field by name on an object (order-sensitive).Definition: document-inl.h:222- -simdjson_inline simdjson_result< number_type > get_number_type() noexceptDetermine the number type (integer or floating-point number) as quickly as possible.Definition: document-inl.h:278-simdjson_inline simdjson_result< bool > is_scalar() noexceptChecks whether the document is a scalar (string, number, null, Boolean).Definition: document-inl.h:263-simdjson_inline simdjson_result< std::string_view > get_wobbly_string() noexceptCast this JSON value to a string.Definition: document-inl.h:145-bool at_end() const noexceptReturns true if this document has been fully parsed.Definition: document-inl.h:47-simdjson_inline simdjson_result< array > get_array() &noexceptCast this JSON value to an array.Definition: document-inl.h:103-simdjson_inline simdjson_result< bool > is_integer() noexceptChecks whether the document is an integer number.Definition: document-inl.h:274-simdjson_result< const char * > current_location() const noexceptReturns the current location in the document if in bounds.Definition: document-inl.h:39+simdjson_inline simdjson_result< raw_json_string > get_raw_json_string() noexceptCast this JSON value to a raw_json_string.Definition: document-inl.h:148+simdjson_inline simdjson_result< double > get_double_in_string() noexceptCast this JSON value (inside string) to a double.Definition: document-inl.h:137+ +simdjson_inline simdjson_result< value > at_path(std::string_view json_path) noexceptGet the value associated with the given JSON path.Definition: document-inl.h:312+ +simdjson_inline simdjson_result< double > get_double() noexceptCast this JSON value to a double.Definition: document-inl.h:134+void rewind() noexceptReset the iterator inside the document instance so we are pointing back at the beginning of the docum...Definition: document-inl.h:33+simdjson_inline simdjson_result< std::string_view > raw_json() noexceptConsumes the document and returns a string_view instance corresponding to the document as represented...Definition: document-inl.h:249+simdjson_inline simdjson_result< value > find_field_unordered(std::string_view key) &noexceptLook up a field by name on an object, without regard to key order.Definition: document-inl.h:230+simdjson_inline simdjson_result< int64_t > get_int64_in_string() noexceptCast this JSON value (inside string) to a signed integer.Definition: document-inl.h:131+simdjson_inline simdjson_result< size_t > count_elements() &noexceptThis method scans the array and counts the number of elements.Definition: document-inl.h:199+simdjson_inline simdjson_result< value > get_value() noexceptCast this JSON value to a value when the document is an object or an array.Definition: document-inl.h:70+simdjson_inline simdjson_result< value > find_field(std::string_view key) &noexceptLook up a field by name on an object (order-sensitive).Definition: document-inl.h:224+ +simdjson_inline simdjson_result< number_type > get_number_type() noexceptDetermine the number type (integer or floating-point number) as quickly as possible.Definition: document-inl.h:280+simdjson_inline simdjson_result< bool > is_scalar() noexceptChecks whether the document is a scalar (string, number, null, Boolean).Definition: document-inl.h:265+simdjson_inline simdjson_result< std::string_view > get_wobbly_string() noexceptCast this JSON value to a string.Definition: document-inl.h:147+bool at_end() const noexceptReturns true if this document has been fully parsed.Definition: document-inl.h:49+simdjson_inline simdjson_result< array > get_array() &noexceptCast this JSON value to an array.Definition: document-inl.h:105+simdjson_inline simdjson_result< bool > is_integer() noexceptChecks whether the document is an integer number.Definition: document-inl.h:276+simdjson_result< const char * > current_location() const noexceptReturns the current location in the document if in bounds.Definition: document-inl.h:41simdjson_inline simdjson_result< raw_json_string > get_raw_json_string() noexceptCast this JSON value to a raw_json_string.Definition: document-inl.h:150A forward-only JSON object field iterator.Definition: object.h:17A string escaped per JSON rules, terminated with quote (").Definition: raw_json_string.h:36@@ -985,7 +1016,7 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2document-inl_8h_souAn ephemeral JSON value returned during iteration.Definition: value.h:18- +@ OUT_OF_ORDER_ITERATIONtried to iterate an array or object out of order (checked when SIMDJSON_DEVELOPMENT_CHECKS=1)Definition: error.h:45diff --git a/generic_2ondemand_2document_8h_source.html b/generic_2ondemand_2document_8h_source.html index 2b30d3317..f72f3e881 100644 --- a/generic_2ondemand_2document_8h_source.html +++ b/generic_2ondemand_2document_8h_source.html @@ -200,295 +200,303 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2document_8h_source. - - - - - - - - - - - - - - - - - + + + + + + - - - - - - - - - - - - - - - - - -simdjson_warn_unused simdjson_inline error_code get(T &value) &&noexceptMove the value to the provided variable.Definition: error-inl.h:126644 simdjson_inline document_reference& operator=(const document_reference &other) noexcept = default;- - - - - - - - - -654 simdjson_inline simdjson_result<std::string_view> get_string(bool allow_replacement = false) noexcept;- -656 simdjson_inline error_code get_string(string_type& receiver, bool allow_replacement = false) noexcept;- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -712 struct simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document> : public SIMDJSON_IMPLEMENTATION::implementation_simdjson_result_base<SIMDJSON_IMPLEMENTATION::ondemand::document> {- - - - - - -719 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array> get_array() & noexcept;-720 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object> get_object() & noexcept;- - - - - - -727 simdjson_inline simdjson_result<std::string_view> get_string(bool allow_replacement = false) noexcept;- -729 simdjson_inline error_code get_string(string_type& receiver, bool allow_replacement = false) noexcept;- -731 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::raw_json_string> get_raw_json_string() noexcept;- - - - - - - - - - - - - - - - - - - - - - - - -756 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at(size_t index) & noexcept;-757 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> begin() & noexcept;-758 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> end() & noexcept;-759 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field(std::string_view key) & noexcept;-760 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field(const char *key) & noexcept;-761 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> operator[](std::string_view key) & noexcept;-762 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> operator[](const char *key) & noexcept;-763 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field_unordered(std::string_view key) & noexcept;-764 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field_unordered(const char *key) & noexcept;- - - - - - - -772 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::number_type> get_number_type() noexcept;-773 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::number> get_number() noexcept;- - -777 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at_pointer(std::string_view json_pointer) noexcept;- - - - - - - - - - -788 struct simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference> : public SIMDJSON_IMPLEMENTATION::implementation_simdjson_result_base<SIMDJSON_IMPLEMENTATION::ondemand::document_reference> {- -790 simdjson_inline simdjson_result(SIMDJSON_IMPLEMENTATION::ondemand::document_reference value, error_code error) noexcept;- - - -794 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array> get_array() & noexcept;-795 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object> get_object() & noexcept;- - - - - - -802 simdjson_inline simdjson_result<std::string_view> get_string(bool allow_replacement = false) noexcept;- -804 simdjson_inline error_code get_string(string_type& receiver, bool allow_replacement = false) noexcept;- -806 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::raw_json_string> get_raw_json_string() noexcept;- - - - - - - - - - - - - - - - - - -825 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at(size_t index) & noexcept;-826 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> begin() & noexcept;-827 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> end() & noexcept;-828 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field(std::string_view key) & noexcept;-829 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field(const char *key) & noexcept;-830 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> operator[](std::string_view key) & noexcept;-831 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> operator[](const char *key) & noexcept;-832 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field_unordered(std::string_view key) & noexcept;-833 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field_unordered(const char *key) & noexcept;- - - - - - -840 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::number_type> get_number_type() noexcept;-841 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::number> get_number() noexcept;- - -845 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at_pointer(std::string_view json_pointer) noexcept;- - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +658 simdjson_inline document_reference& operator=(const document_reference &other) noexcept = default;+ + + + + + + + + +668 simdjson_inline simdjson_result<std::string_view> get_string(bool allow_replacement = false) noexcept;+ +670 simdjson_inline error_code get_string(string_type& receiver, bool allow_replacement = false) noexcept;+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +728 struct simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document> : public SIMDJSON_IMPLEMENTATION::implementation_simdjson_result_base<SIMDJSON_IMPLEMENTATION::ondemand::document> {+ + + + + + +735 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array> get_array() & noexcept;+736 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object> get_object() & noexcept;+ + + + + + +743 simdjson_inline simdjson_result<std::string_view> get_string(bool allow_replacement = false) noexcept;+ +745 simdjson_inline error_code get_string(string_type& receiver, bool allow_replacement = false) noexcept;+ +747 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::raw_json_string> get_raw_json_string() noexcept;+ + + + + + + + + + + + + + + + + + + + + + + + +772 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at(size_t index) & noexcept;+773 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> begin() & noexcept;+774 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> end() & noexcept;+775 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field(std::string_view key) & noexcept;+776 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field(const char *key) & noexcept;+777 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> operator[](std::string_view key) & noexcept;+778 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> operator[](const char *key) & noexcept;+779 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field_unordered(std::string_view key) & noexcept;+780 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field_unordered(const char *key) & noexcept;+ + + + + + + +788 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::number_type> get_number_type() noexcept;+789 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::number> get_number() noexcept;+ + +793 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at_pointer(std::string_view json_pointer) noexcept;+794 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at_path(std::string_view json_path) noexcept;+ + + + + + + + + + +805 struct simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::document_reference> : public SIMDJSON_IMPLEMENTATION::implementation_simdjson_result_base<SIMDJSON_IMPLEMENTATION::ondemand::document_reference> {+ +807 simdjson_inline simdjson_result(SIMDJSON_IMPLEMENTATION::ondemand::document_reference value, error_code error) noexcept;+ + + +811 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array> get_array() & noexcept;+812 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object> get_object() & noexcept;+ + + + + + +819 simdjson_inline simdjson_result<std::string_view> get_string(bool allow_replacement = false) noexcept;+ +821 simdjson_inline error_code get_string(string_type& receiver, bool allow_replacement = false) noexcept;+ +823 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::raw_json_string> get_raw_json_string() noexcept;+ + + + + + + + + + + + + + + + + + +842 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at(size_t index) & noexcept;+843 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> begin() & noexcept;+844 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::array_iterator> end() & noexcept;+845 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field(std::string_view key) & noexcept;+846 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field(const char *key) & noexcept;+847 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> operator[](std::string_view key) & noexcept;+848 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> operator[](const char *key) & noexcept;+849 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field_unordered(std::string_view key) & noexcept;+850 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field_unordered(const char *key) & noexcept;+ + + + + + +857 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::number_type> get_number_type() noexcept;+858 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::number> get_number() noexcept;+ + +862 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at_pointer(std::string_view json_pointer) noexcept;+863 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at_path(std::string_view json_path) noexcept;+ + + + + +-A forward-only JSON array.Definition: array_iterator.h:23-A document_reference is a thin wrapper around a document reference instance.Definition: document.h:639+simdjson_inline simdjson_result< uint64_t > get_uint64() noexceptThe document_reference instances are used primarily/solely for streams of JSON documents.Definition: document-inl.h:600+A document_reference is a thin wrapper around a document reference instance.Definition: document.h:653simdjson_inline simdjson_result< uint64_t > get_uint64() noexceptThe document_reference instances are used primarily/solely for streams of JSON documents.Definition: document-inl.h:623-A forward-only stream of documents.Definition: document_stream.h:79- -simdjson_inline simdjson_result< value > at(size_t index) &noexceptGet the value at the given index in the array.Definition: document-inl.h:211-simdjson_inline int32_t current_depth() const noexceptReturns the current depth in the document if in bounds.Definition: document-inl.h:43-simdjson_inline simdjson_result< array_iterator > begin() &noexceptBegin array iteration.Definition: document-inl.h:215-simdjson_inline simdjson_result< size_t > count_fields() &noexceptThis method scans the object and counts the number of key-value pairs.Definition: document-inl.h:204-simdjson_inline simdjson_result< std::string_view > get_string(bool allow_replacement=false) noexceptCast this JSON value to a string.Definition: document-inl.h:138-simdjson_warn_unused simdjson_inline simdjson_result< number > get_number() noexceptAttempt to parse an ondemand::number.Definition: document-inl.h:282-bool is_alive() noexceptSome unrecoverable error conditions may render the document instance unusable.Definition: document-inl.h:52-simdjson_inline simdjson_result< bool > get_bool() noexceptCast this JSON value to a bool.Definition: document-inl.h:151-simdjson_inline simdjson_result< object > get_object() &noexceptCast this JSON value to an object.Definition: document-inl.h:107-simdjson_inline simdjson_result< uint64_t > get_uint64() noexceptCast this JSON value to an unsigned integer.Definition: document-inl.h:120+simdjson_inline bool is_negative() noexceptChecks whether the document is a negative number.Definition: document-inl.h:270+ +simdjson_inline simdjson_result< value > at(size_t index) &noexceptGet the value at the given index in the array.Definition: document-inl.h:213+simdjson_inline int32_t current_depth() const noexceptReturns the current depth in the document if in bounds.Definition: document-inl.h:45+simdjson_inline simdjson_result< array_iterator > begin() &noexceptBegin array iteration.Definition: document-inl.h:217+simdjson_inline simdjson_result< size_t > count_fields() &noexceptThis method scans the object and counts the number of key-value pairs.Definition: document-inl.h:206+simdjson_inline simdjson_result< std::string_view > get_string(bool allow_replacement=false) noexceptCast this JSON value to a string.Definition: document-inl.h:140+simdjson_warn_unused simdjson_inline simdjson_result< number > get_number() noexceptAttempt to parse an ondemand::number.Definition: document-inl.h:284+bool is_alive() noexceptSome unrecoverable error conditions may render the document instance unusable.Definition: document-inl.h:54+simdjson_inline simdjson_result< bool > get_bool() noexceptCast this JSON value to a bool.Definition: document-inl.h:153+simdjson_inline simdjson_result< object > get_object() &noexceptCast this JSON value to an object.Definition: document-inl.h:109+simdjson_inline simdjson_result< uint64_t > get_uint64() noexceptCast this JSON value to an unsigned integer.Definition: document-inl.h:122simdjson_inline bool is_negative() noexceptChecks whether the document is a negative number.Definition: document-inl.h:272-simdjson_inline document() noexcept=defaultCreate a new invalid document.-simdjson_inline simdjson_result< std::string_view > raw_json_token() noexceptGet the raw JSON for this token.Definition: document-inl.h:287-simdjson_inline simdjson_result< uint64_t > get_uint64_in_string() noexceptCast this JSON value (inside string) to an unsigned integer.Definition: document-inl.h:123-simdjson_inline simdjson_result< bool > is_null() noexceptChecks if this JSON value is null.Definition: document-inl.h:154-simdjson_inline simdjson_result< int64_t > get_int64() noexceptCast this JSON value to a signed integer.Definition: document-inl.h:126-simdjson_inline simdjson_result< value > at_pointer(std::string_view json_pointer) noexceptGet the value associated with the given JSON pointer.Definition: document-inl.h:292-simdjson_inline simdjson_result< json_type > type() noexceptGet the type of this JSON value.Definition: document-inl.h:259+simdjson_inline simdjson_result< array_iterator > end() &noexceptSentinel representing the end of the array.Definition: document-inl.h:218+simdjson_inline simdjson_result< std::string_view > raw_json_token() noexceptGet the raw JSON for this token.Definition: document-inl.h:289+simdjson_inline simdjson_result< uint64_t > get_uint64_in_string() noexceptCast this JSON value (inside string) to an unsigned integer.Definition: document-inl.h:125+simdjson_inline simdjson_result< bool > is_null() noexceptChecks if this JSON value is null.Definition: document-inl.h:156+simdjson_inline simdjson_result< int64_t > get_int64() noexceptCast this JSON value to a signed integer.Definition: document-inl.h:128+simdjson_inline simdjson_result< value > at_pointer(std::string_view json_pointer) noexceptGet the value associated with the given JSON pointer.Definition: document-inl.h:294+simdjson_inline simdjson_result< json_type > type() noexceptGet the type of this JSON value.Definition: document-inl.h:261simdjson_inline simdjson_result< array_iterator > end() &noexceptSentinel representing the end of the array.Definition: document-inl.h:220-simdjson_inline simdjson_result< T > get() &noexceptGet this value as the given type.Definition: document.h:181- -simdjson_inline simdjson_result< double > get_double_in_string() noexceptCast this JSON value (inside string) to a double.Definition: document-inl.h:135- -simdjson_inline simdjson_result< double > get_double() noexceptCast this JSON value to a double.Definition: document-inl.h:132-void rewind() noexceptReset the iterator inside the document instance so we are pointing back at the beginning of the docum...Definition: document-inl.h:31-simdjson_inline simdjson_result< std::string_view > raw_json() noexceptConsumes the document and returns a string_view instance corresponding to the document as represented...Definition: document-inl.h:247-simdjson_inline simdjson_result< value > find_field_unordered(std::string_view key) &noexceptLook up a field by name on an object, without regard to key order.Definition: document-inl.h:228-simdjson_inline simdjson_result< int64_t > get_int64_in_string() noexceptCast this JSON value (inside string) to a signed integer.Definition: document-inl.h:129-simdjson_inline simdjson_result< size_t > count_elements() &noexceptThis method scans the array and counts the number of elements.Definition: document-inl.h:197-simdjson_inline simdjson_result< value > get_value() noexceptCast this JSON value to a value when the document is an object or an array.Definition: document-inl.h:68-simdjson_inline simdjson_result< value > find_field(std::string_view key) &noexceptLook up a field by name on an object (order-sensitive).Definition: document-inl.h:222- -simdjson_inline simdjson_result< number_type > get_number_type() noexceptDetermine the number type (integer or floating-point number) as quickly as possible.Definition: document-inl.h:278-simdjson_inline simdjson_result< bool > is_scalar() noexceptChecks whether the document is a scalar (string, number, null, Boolean).Definition: document-inl.h:263-simdjson_inline simdjson_result< std::string_view > get_wobbly_string() noexceptCast this JSON value to a string.Definition: document-inl.h:145-bool at_end() const noexceptReturns true if this document has been fully parsed.Definition: document-inl.h:47+simdjson_inline simdjson_result< array > get_array() &noexceptCast this JSON value to an array.Definition: document-inl.h:103+simdjson_inline simdjson_result< double > get_double_in_string() noexceptCast this JSON value (inside string) to a double.Definition: document-inl.h:137+ +simdjson_inline simdjson_result< value > at_path(std::string_view json_path) noexceptGet the value associated with the given JSON path.Definition: document-inl.h:312+ +simdjson_inline simdjson_result< double > get_double() noexceptCast this JSON value to a double.Definition: document-inl.h:134+void rewind() noexceptReset the iterator inside the document instance so we are pointing back at the beginning of the docum...Definition: document-inl.h:33+simdjson_inline simdjson_result< std::string_view > raw_json() noexceptConsumes the document and returns a string_view instance corresponding to the document as represented...Definition: document-inl.h:249+simdjson_inline simdjson_result< value > find_field_unordered(std::string_view key) &noexceptLook up a field by name on an object, without regard to key order.Definition: document-inl.h:230+simdjson_inline simdjson_result< int64_t > get_int64_in_string() noexceptCast this JSON value (inside string) to a signed integer.Definition: document-inl.h:131+simdjson_inline simdjson_result< size_t > count_elements() &noexceptThis method scans the array and counts the number of elements.Definition: document-inl.h:199+simdjson_inline simdjson_result< value > get_value() noexceptCast this JSON value to a value when the document is an object or an array.Definition: document-inl.h:70+simdjson_inline simdjson_result< value > find_field(std::string_view key) &noexceptLook up a field by name on an object (order-sensitive).Definition: document-inl.h:224+ +simdjson_inline simdjson_result< number_type > get_number_type() noexceptDetermine the number type (integer or floating-point number) as quickly as possible.Definition: document-inl.h:280+simdjson_inline simdjson_result< bool > is_scalar() noexceptChecks whether the document is a scalar (string, number, null, Boolean).Definition: document-inl.h:265+simdjson_inline simdjson_result< std::string_view > get_wobbly_string() noexceptCast this JSON value to a string.Definition: document-inl.h:147+bool at_end() const noexceptReturns true if this document has been fully parsed.Definition: document-inl.h:49simdjson_inline simdjson_result< array > get_array() &noexceptCast this JSON value to an array.Definition: document-inl.h:105-simdjson_inline error_code get(T &out) &noexceptGet this value as the given type.-simdjson_inline simdjson_result< bool > is_integer() noexceptChecks whether the document is an integer number.Definition: document-inl.h:274-simdjson_result< const char * > current_location() const noexceptReturns the current location in the document if in bounds.Definition: document-inl.h:39+simdjson_inline simdjson_result< raw_json_string > get_raw_json_string() noexceptCast this JSON value to a raw_json_string.Definition: document-inl.h:148+simdjson_inline simdjson_result< bool > is_integer() noexceptChecks whether the document is an integer number.Definition: document-inl.h:276+simdjson_result< const char * > current_location() const noexceptReturns the current location in the document if in bounds.Definition: document-inl.h:41simdjson_inline simdjson_result< raw_json_string > get_raw_json_string() noexceptCast this JSON value to a raw_json_string.Definition: document-inl.h:150A JSON field (key/value pair) in an object.Definition: field.h:22A forward-only JSON object field iterator.Definition: object.h:17@@ -498,12 +506,12 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2document_8h_source.A string escaped per JSON rules, terminated with quote (").Definition: raw_json_string.h:36The result of a simdjson operation that could fail.Definition: implementation_simdjson_result_base.h:35- +A type representing a JSON number.Definition: json_type.h:32Definition: array_iterator.h:78- +Definition: json_type.h:150- +Definition: raw_json_string.h:192diff --git a/generic_2ondemand_2document__stream-inl_8h_source.html b/generic_2ondemand_2document__stream-inl_8h_source.html index ad602614d..3aac230e1 100644 --- a/generic_2ondemand_2document__stream-inl_8h_source.html +++ b/generic_2ondemand_2document__stream-inl_8h_source.html @@ -488,7 +488,7 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2document__stream-insimdjson_warn_unused simdjson_inline error_code get(T &value) &&noexceptMove the value to the provided variable.Definition: error-inl.h:126size_t truncated_bytes() const noexceptAfter iterating through the stream, this method returns the number of bytes that were not parsed at t...Definition: document_stream-inl.h:141simdjson_inline iterator begin() noexceptStart iterating the documents in the stream.Definition: document_stream-inl.h:190- +simdjson_inline document_stream() noexceptConstruct an uninitialized document_stream.Definition: document_stream-inl.h:117diff --git a/generic_2ondemand_2object-inl_8h_source.html b/generic_2ondemand_2object-inl_8h_source.html index 12fb53e41..05e9eefb2 100644 --- a/generic_2ondemand_2object-inl_8h_source.html +++ b/generic_2ondemand_2object-inl_8h_source.html @@ -244,110 +244,127 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2object-inl_8h_sourc - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + - - -The top level simdjson namespace, containing everything the library provides.Definition: base.h:8196 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::simdjson_result(SIMDJSON_IMPLEMENTATION::ondemand::object &&value) noexcept-197 : implementation_simdjson_result_base<SIMDJSON_IMPLEMENTATION::ondemand::object>(std::forward<SIMDJSON_IMPLEMENTATION::ondemand::object>(value)) {}-198 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::simdjson_result(error_code error) noexcept- - -201 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::begin() noexcept {- - - -205 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::end() noexcept {- - - -209 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::find_field_unordered(std::string_view key) & noexcept {- - + + + + + + + + + + +204 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::simdjson_result(SIMDJSON_IMPLEMENTATION::ondemand::object &&value) noexcept+205 : implementation_simdjson_result_base<SIMDJSON_IMPLEMENTATION::ondemand::object>(std::forward<SIMDJSON_IMPLEMENTATION::ondemand::object>(value)) {}+206 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::simdjson_result(error_code error) noexcept+ + +209 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::begin() noexcept {+ + -213 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::find_field_unordered(std::string_view key) && noexcept {- -215 return std::forward<SIMDJSON_IMPLEMENTATION::ondemand::object>(first).find_field_unordered(key);+213 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object_iterator> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::end() noexcept {+ + -217 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::operator[](std::string_view key) & noexcept {+217 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::find_field_unordered(std::string_view key) & noexcept {- + -221 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::operator[](std::string_view key) && noexcept {+221 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::find_field_unordered(std::string_view key) && noexcept {- +223 return std::forward<SIMDJSON_IMPLEMENTATION::ondemand::object>(first).find_field_unordered(key);-225 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::find_field(std::string_view key) & noexcept {+225 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::operator[](std::string_view key) & noexcept {- + -229 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::find_field(std::string_view key) && noexcept {+229 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::operator[](std::string_view key) && noexcept {- + - -234 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::at_pointer(std::string_view json_pointer) noexcept {- - - - -239 inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::reset() noexcept {- - - - -244 inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::is_empty() noexcept {- - - - -249 simdjson_inline simdjson_result<size_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::count_fields() & noexcept {- - - - -254 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::raw_json() noexcept {- - - - +233 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::find_field(std::string_view key) & noexcept {+ + + +237 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::find_field(std::string_view key) && noexcept {+ + + + +242 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::at_pointer(std::string_view json_pointer) noexcept {+ + + + +247 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::at_path(+ + + + + + + +255 inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::reset() noexcept {+ + + - +260 inline simdjson_result<bool> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::is_empty() noexcept {+ + + + +265 simdjson_inline simdjson_result<size_t> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::count_fields() & noexcept {+ + + + +270 simdjson_inline simdjson_result<std::string_view> simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object>::raw_json() noexcept {+ + + + + +A forward-only JSON object field iterator.Definition: object.h:17simdjson_inline object() noexcept=defaultCreate a new invalid object.simdjson_inline simdjson_result< value > find_field_unordered(std::string_view key) &noexceptLook up a field by name on an object, without regard to key order.Definition: object-inl.h:18simdjson_inline simdjson_result< std::string_view > raw_json() noexceptConsumes the object and returns a string_view instance corresponding to the object as represented in ...Definition: object-inl.h:95-simdjson_inline simdjson_result< value > find_field(std::string_view key) &noexceptLook up a field by name on an object (order-sensitive).Definition: object-inl.h:42+simdjson_result< bool > is_empty() &noexceptThis method scans the beginning of the object and checks whether the object is empty.Definition: object-inl.h:179simdjson_result< bool > is_empty() &noexceptThis method scans the beginning of the object and checks whether the object is empty.Definition: object-inl.h:187-simdjson_inline error_code consume() noexceptGo to the end of the object, no matter where you are right now.Definition: object-inl.h:69+simdjson_result< bool > reset() &noexceptReset the iterator so that we are pointing back at the beginning of the object.Definition: object-inl.h:186+simdjson_result< bool > reset() &noexceptReset the iterator so that we are pointing back at the beginning of the object.Definition: object-inl.h:194simdjson_result< value > at_path(std::string_view json_path) noexceptGet the value associated with the given JSON path.Definition: object-inl.h:167-simdjson_result< value > at_pointer(std::string_view json_pointer) noexceptGet the value associated with the given JSON pointer.Definition: object-inl.h:127+simdjson_inline simdjson_result< size_t > count_fields() &noexceptThis method scans the object and counts the number of key-value pairs.Definition: object-inl.h:167simdjson_inline simdjson_result< size_t > count_fields() &noexceptThis method scans the object and counts the number of key-value pairs.Definition: object-inl.h:175A string escaped per JSON rules, terminated with quote (").Definition: raw_json_string.h:36An ephemeral JSON value returned during iteration.Definition: value.h:18diff --git a/generic_2ondemand_2object_8h_source.html b/generic_2ondemand_2object_8h_source.html index f3bdc414f..b933bf349 100644 --- a/generic_2ondemand_2object_8h_source.html +++ b/generic_2ondemand_2object_8h_source.html @@ -120,60 +120,64 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2object_8h_source.ht - - - - - - - - - - - - - -The top level simdjson namespace, containing everything the library provides.Definition: base.h:8199 simdjson_warn_unused simdjson_inline error_code find_field_raw(const std::string_view key) noexcept;+ + + + + + - - - - - - - - - - + + + + + + + - +212 simdjson_warn_unused simdjson_inline error_code find_field_raw(const std::string_view key) noexcept;- -215 struct simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object> : public SIMDJSON_IMPLEMENTATION::implementation_simdjson_result_base<SIMDJSON_IMPLEMENTATION::ondemand::object> {- - - - + + + + + + -221 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object_iterator> begin() noexcept;-222 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object_iterator> end() noexcept;-223 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field(std::string_view key) & noexcept;-224 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field(std::string_view key) && noexcept;-225 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field_unordered(std::string_view key) & noexcept;-226 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field_unordered(std::string_view key) && noexcept;-227 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> operator[](std::string_view key) & noexcept;-228 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> operator[](std::string_view key) && noexcept;-229 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at_pointer(std::string_view json_pointer) noexcept;- - - - - - - - - - + + + + + + + +228 struct simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object> : public SIMDJSON_IMPLEMENTATION::implementation_simdjson_result_base<SIMDJSON_IMPLEMENTATION::ondemand::object> {+ + + + + +234 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object_iterator> begin() noexcept;+235 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::object_iterator> end() noexcept;+236 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field(std::string_view key) & noexcept;+237 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field(std::string_view key) && noexcept;+238 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field_unordered(std::string_view key) & noexcept;+239 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> find_field_unordered(std::string_view key) && noexcept;+240 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> operator[](std::string_view key) & noexcept;+241 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> operator[](std::string_view key) && noexcept;+242 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at_pointer(std::string_view json_pointer) noexcept;+243 simdjson_inline simdjson_result<SIMDJSON_IMPLEMENTATION::ondemand::value> at_path(std::string_view json_path) noexcept;+ + + + + + + + + + +@@ -181,17 +185,18 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2object_8h_source.htA forward-only JSON object field iterator.Definition: object.h:17simdjson_inline simdjson_result< value > find_field_unordered(std::string_view key) &noexceptLook up a field by name on an object, without regard to key order.Definition: object-inl.h:18simdjson_inline simdjson_result< std::string_view > raw_json() noexceptConsumes the object and returns a string_view instance corresponding to the object as represented in ...Definition: object-inl.h:95-simdjson_inline simdjson_result< value > find_field(std::string_view key) &noexceptLook up a field by name on an object (order-sensitive).Definition: object-inl.h:42+simdjson_result< bool > is_empty() &noexceptThis method scans the beginning of the object and checks whether the object is empty.Definition: object-inl.h:179simdjson_result< bool > is_empty() &noexceptThis method scans the beginning of the object and checks whether the object is empty.Definition: object-inl.h:187-simdjson_inline error_code consume() noexceptGo to the end of the object, no matter where you are right now.Definition: object-inl.h:69+simdjson_result< bool > reset() &noexceptReset the iterator so that we are pointing back at the beginning of the object.Definition: object-inl.h:186+simdjson_result< bool > reset() &noexceptReset the iterator so that we are pointing back at the beginning of the object.Definition: object-inl.h:194simdjson_result< value > at_path(std::string_view json_path) noexceptGet the value associated with the given JSON path.Definition: object-inl.h:167-simdjson_result< value > at_pointer(std::string_view json_pointer) noexceptGet the value associated with the given JSON pointer.Definition: object-inl.h:127+simdjson_inline simdjson_result< size_t > count_fields() &noexceptThis method scans the object and counts the number of key-value pairs.Definition: object-inl.h:167simdjson_inline simdjson_result< size_t > count_fields() &noexceptThis method scans the object and counts the number of key-value pairs.Definition: object-inl.h:175An ephemeral JSON value returned during iteration.Definition: value.h:18The top level simdjson namespace, containing everything the library provides.Definition: base.h:8The result of a simdjson operation that could fail.Definition: implementation_simdjson_result_base.h:35- + diff --git a/generic_2ondemand_2serialization-inl_8h_source.html b/generic_2ondemand_2serialization-inl_8h_source.html index 11b0272b9..74c9546c8 100644 --- a/generic_2ondemand_2serialization-inl_8h_source.html +++ b/generic_2ondemand_2serialization-inl_8h_source.html @@ -319,7 +319,7 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2serialization-inl_8 -Definition: object_iterator.h:58+A document_reference is a thin wrapper around a document reference instance.Definition: document.h:639A document_reference is a thin wrapper around a document reference instance.Definition: document.h:653A forward-only JSON object field iterator.Definition: object.h:17diff --git a/generic_2ondemand_2serialization_8h_source.html b/generic_2ondemand_2serialization_8h_source.html index 8a3caba57..b3154fe7e 100644 --- a/generic_2ondemand_2serialization_8h_source.html +++ b/generic_2ondemand_2serialization_8h_source.html @@ -135,7 +135,7 @@ $(document).ready(function(){initNavTree('generic_2ondemand_2serialization_8h_so -An ephemeral JSON value returned during iteration.Definition: value.h:18+A document_reference is a thin wrapper around a document reference instance.Definition: document.h:639A document_reference is a thin wrapper around a document reference instance.Definition: document.h:653A forward-only JSON object field iterator.Definition: object.h:17diff --git a/json__path__to__pointer__conversion-inl_8h_source.html b/json__path__to__pointer__conversion-inl_8h_source.html new file mode 100644 index 000000000..76801ce1f --- /dev/null +++ b/json__path__to__pointer__conversion-inl_8h_source.html @@ -0,0 +1,172 @@ + + + + + + + +An ephemeral JSON value returned during iteration.Definition: value.h:18simdjson: include/simdjson/generic/ondemand/json_path_to_pointer_conversion-inl.h Source File + + + + + + + + + + + + + + + + +++ + +++ + + + + + + ++ +
++ + +
+ +simdjson + 3.6.4 ++Ridiculously Fast JSON++ ++ +++ + ++ ++ +++++json_path_to_pointer_conversion-inl.h+++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +++ + diff --git a/json__path__to__pointer__conversion_8h_source.html b/json__path__to__pointer__conversion_8h_source.html new file mode 100644 index 000000000..2ccd0c540 --- /dev/null +++ b/json__path__to__pointer__conversion_8h_source.html @@ -0,0 +1,121 @@ + + + + + + + +-
+
+
- Generated by
1.9.1
+
simdjson: include/simdjson/generic/ondemand/json_path_to_pointer_conversion.h Source File + + + + + + + + + + + + + + + + +++ + +++ + + + + + + ++ +
++ + ++ +simdjson + 3.6.4 ++Ridiculously Fast JSON++ ++ +++ + ++ ++ +++++json_path_to_pointer_conversion.h+++ + + + + + + + + + + + + + + + +++ + diff --git a/md_doc_basics.html b/md_doc_basics.html index 154c45fdc..372ba9596 100644 --- a/md_doc_basics.html +++ b/md_doc_basics.html @@ -113,6 +113,7 @@ $(document).ready(function(){initNavTree('md_doc_basics.html',''); initResizable-
+
+
- Generated by 1.9.1
+
- Minifying JSON strings without parsing
- UTF-8 validation (alone)
- JSON Pointer
+- JSON Path (subset)
- Error Handling
- Error Handling Examples without Exceptions
- Disabling Exceptions @@ -820,7 +821,7 @@ JSON Pointer
- The specification states that an implementation may set limits on the size of texts that it accepts. The simdjson library limits single JSON documents to 4 GiB. It will refuse to parse a JSON document larger than 4294967295 bytes. (This limitation does not apply to streams of JSON documents, only to single JSON documents.)
- The specification states that an implementation may set limits on the maximum depth of nesting. By default, the simdjson will refuse to parse documents with a depth exceeding 1024.
ondemand::parser parser;auto cars = parser.iterate(cars_json);cout << cars.at_pointer("/0/tire_pressure/1") << endl; // Prints 39.9-A JSON Path is a sequence of segments each starting with the '/' character. Within arrays, an integer index allows you to select the indexed node. Within objects, the string value of the key allows you to select the value. If your keys contain the characters '/' or '~', they must be escaped as '~1' and '~0' respectively. An empty JSON Path refers to the whole document.
+A JSON Pointer path is a sequence of segments each starting with the '/' character. Within arrays, a zero-based integer index allows you to select the indexed node. Within objects, the string value of the key allows you to select the value. If your keys contain the characters '/' or '~', they must be escaped as '~1' and '~0' respectively. An empty JSON Pointer Path refers to the whole document.
For multiple JSON pointer queries on a document, one can call
at_pointermultiple times.{c++}auto cars_json = R"( [@@ -890,8 +891,33 @@ JSON Pointerstd::cout << doc.at_pointer("/k2") << std::endl; // Prints truedoc.rewind(); // Need to manually rewind to be able to use find_field properly from start of documentstd::cout << doc.find_field("k0") << std::endl; // Prints 27-When the JSON path is the empty string (
+"") applied to a scalar document (lone string, number, Boolean or null), a SCALAR_DOCUMENT_AS_VALUE error is returned because scalar document cannot be represented asvalueinstances. You can check that a document is a scalar with the methodscalar().When the JSON Pointer Path is the empty string (
"") applied to a scalar document (lone string, number, Boolean or null), a SCALAR_DOCUMENT_AS_VALUE error is returned because scalar document cannot be represented asvalueinstances. You can check that a document is a scalar with the methodscalar().+JSON Path
+The simdjson library now supports a subset of JSON Path through the
+at_path()method, allowing you to reach further into the document in a single call. The subset of JSON path that is implemented is the subset that is trivially convertible into the JSON Pointer format, using.to access a field and[]to access a specific index.This implementation relies on
+at_path()converting its argument to JSON Pointer and then callingat_pointer, which makes use ofrewindto reset the parser at the beginning of the document. Hence, it invalidates all previously parsed values, objects and arrays: make sure to consume the values between each call toat_path.Consider the following example:
+{c++}+auto cars_json = R"( [+{ "make": "Toyota", "model": "Camry", "year": 2018, "tire_pressure": [ 40.1, 39.9, 37.7, 40.4 ] },+{ "make": "Kia", "model": "Soul", "year": 2012, "tire_pressure": [ 30.1, 31.0, 28.6, 28.7 ] },+{ "make": "Toyota", "model": "Tercel", "year": 1999, "tire_pressure": [ 29.8, 30.0, 30.2, 30.5 ] }+] )"_padded;+ondemand::parser parser;+auto cars = parser.iterate(cars_json);+cout << cars.at_path("[0].tire_pressure[1]") << endl; // Prints 39.9+A call to
+at_path(json_path)can result in any of the errors that are returned by theat_pointermethod and if the conversion ofjson_pathto json pointer fails, it will lead to ansimdjson::INVALID_JSON_POINTERerror.{c++}+auto cars_json = R"( [+{ "make": "Toyota", "model": "Camry", "year": 2018, "tire_pressure": [ 40.1, 39.9, 37.7, 40.4 ] },+{ "make": "Kia", "model": "Soul", "year": 2012, "tire_pressure": [ 30.1, 31.0, 28.6, 28.7 ] },+{ "make": "Toyota", "model": "Tercel", "year": 1999, "tire_pressure": [ 29.8, 30.0, 30.2, 30.5 ] }+] )"_padded;+ondemand::parser parser;+auto cars = parser.iterate(cars_json);+ASSERT_ERROR(cars.at_path("[0].tire_presure[1").get(x), INVALID_JSON_POINTER); // Fails on conversion to json pointer, since last square bracket was not properly closed.+ASSERT_ERROR(cars.at_path("[0].incorrect_field[1]").get(x), NO_SUCH_FIELD); // Conversion to json pointer succeeds, but fails on at_pointer() since the path is invalid.+Error Handling
Error handing with exception and a single try/catch clause makes the code simple, but it gives you little control over errors. For easier debugging or more robust error handling, you may want to consider our exception-free approach.
The entire simdjson API is usable with and without exceptions. All simdjson APIs that can fail return
@@ -1002,7 +1028,7 @@ Error Handlingsimdjson_result<T>, which is a <value, error_code> pair. You can retrieve the value with .get() without generating an exception, like so:std::cout << identifier << std::endl;}The
-atmethod can only be called once on an array. It cannot be used to iterate through the values of an array.+
Error Handling Examples without Exceptions
This is how the example in "Using the Parsed JSON" could be written using only error code checking (without exceptions):
{c++}@@ -1089,11 +1115,11 @@ Error Handling Examples without Exceptionsstd::cout << intvalue;}}-+
Disabling Exceptions
The simdjson can be build with exceptions entirely disabled. It checks the
__cpp_exceptionsmacro at compile time. Even if exceptions are enabled in your compiler, you may still disable exceptions specifically for simdjson, by settingSIMDJSON_EXCEPTIONSto0(false) at compile-time when building the simdjson library. If you are building with CMake, to ensure you don't write any code that uses exceptions, you compile withSIMDJSON_EXCEPTIONS=OFF. For example, if including the project via cmake:target_compile_definitions(simdjson PUBLIC SIMDJSON_EXCEPTIONS=OFF)-+
Exceptions
Users more comfortable with an exception flow may choose to directly cast the
simdjson_result<T>to the desired type:{c++}@@ -1130,7 +1156,7 @@ Exceptions<< doc.current_location() << " in " << json_string << std::endl;}}-+
Current location in document
Sometimes, it might be helpful to know the current location in the document during iteration. This is especially useful when encountering errors. The
current_location()method on adocumentinstances makes it easy to identify common JSON errors. Users can call thecurrent_location()method on a valid document instance to retrieve aconst char *pointer to the current location in the document. This method also works even after an error has invalidated the document and the parser (e.g.TAPE_ERROR,INCOMPLETE_ARRAY_OR_OBJECT). When the input was apadding_stringor another null-terminated source, then you may use theconst char *pointer as a C string. As an example, consider the following example where we used the exception-free simdjson interface:{c++}@@ -1194,7 +1220,7 @@ Current location in document}}The
-current_location()method requires a validdocumentinstance. If theiteratefunction fails to return a valid document, then you cannot usecurrent_location()to identify the location of an error in the input string. The errors reported byiteratefunction include EMPTY if no JSON document is detected, UTF8_ERROR if the string is not a valid UTF-8 string, UNESCAPED_CHARS if a string contains control characters that must be escaped and UNCLOSED_STRING if there is an unclosed string in the document. We do not provide location information for these errors.+
Checking for trailing content
The parser validates all parsed content, but your code may exhaust the content while not having processed the entire document. Thus, as a final optional step, you may call
at_end()on the document instance. If it returnsfalse, then you may conclude that you have trailing content and that your document is not valid JSON. You may then usedoc.current_location()to obtain a pointer to the start of the trailing content.{C++}@@ -1210,7 +1236,7 @@ Checking for trailing contentstd::cerr << "trailing content at byte index " << doc.current_location() - json.data() << std::endl;}The
-at_end()method is equivalent todoc.current_location().error() == simdjson::SUCCESSbut more convenient.+
Rewinding
In some instances, you may need to go through a document more than once. For that purpose, you may call the
rewind()method on the document instance. It allows you to restart processing from the beginning without rescanning all of the input data again. It invalidates all values, objects and arrays that you have created so far (including unescaped strings).In the following example, we print on the screen the number of cars in the JSON input file before printout the data.
@@ -1233,7 +1259,7 @@ Rewinding}Performance note: the On Demand front-end does not materialize the parsed numbers and other values. If you are accessing everything twice, you may need to parse them twice. Thus the rewind functionality is best suited for cases where the first pass only scans the structure of the document.
Both arrays and objects have a similar method
-reset(). It is similar to the documentrewind()method, except that it does not rewind the internal string buffer. Thus you should consume values only once even if you can iterate through the array or object more than once. If you unescape a string within an array more than once, you have unsafe code.+
Newline-Delimited JSON (ndjson) and JSON lines
When processing large inputs (e.g., in the context of data engineering), engineers commonly serialize data into streams of multiple JSON documents. That is, instead of one large (e.g., 2 GB) JSON document containing multiple records, it is often preferable to write out multiple records as independent JSON documents, to be read one-by-one.
The simdjson library also supports multithreaded JSON streaming through a large file containing many smaller JSON documents in either ndjson or JSON lines format. If your JSON documents all contain arrays or objects, we even support direct file concatenation without whitespace. However, if there is content between your JSON documents, it should be exclusively ASCII white-space characters.
@@ -1291,7 +1317,7 @@ Newline-Delimited JSON (ndjson) and JSON linesunprocessed bytes at the end: 293If your documents are large (e.g., larger than a megabyte), then the
iterate_manyfunction is maybe ill-suited. It is really meant to support reading efficiently streams of relatively small documents (e.g., a few kilobytes each). If you have larger documents, you should use other functions likeiterate.We also provide some support for comma-separated documents and other advanced features. See iterate_many.md for detailed information and design.
-+
Parsing Numbers Inside Strings
Though the JSON specification allows for numbers and string values, many engineers choose to integrate the numbers inside strings, e.g., they prefer
{"a":"1.9"}to{"a":1.9}. The simdjson library supports parsing valid numbers inside strings which makes it more convenient for people working with those types of documents. This feature is supported through three methods:get_double_in_string,get_int64_in_stringandget_uint64_in_string. However, it is important to note that these methods are not substitute to the regularget_double,get_int64andget_uint64. The usage of theget_*_in_stringmethods is solely to parse valid JSON numbers inside strings, and so we expect users to call these methods appropriately. In particular, a valid JSON number has no leading and no trailing whitespaces, and the strings"nan","1e"and"infinity"will not be accepted as valid numbers. As an example, suppose we have the following JSON text:{c++}@@ -1369,7 +1395,7 @@ Parsing Numbers Inside Strings}It is also important to note that when dealing an invalid number inside a string, simdjson will report a
NUMBER_ERRORerror if the string begins with a number whereas simdjson will report aINCORRECT_TYPEerror otherwise.The
-*_in_stringmethods can also be called on a single document instance: e.g., when your document consist solely of a quoted number.+
Dynamic Number Types
The JSON standard does not offer strongly typed numbers. It suggests that using the binary64 type (
doublein C++) is a safe choice, but little else. Given the JSON array[1.0,1], it is not specified whether it is an array of two floating-point numbers, two integers, or one floating-point number followed by an integer.Given an
@@ -1416,7 +1442,7 @@ Dynamic Number Typesondemand::valueinstance, you may ask whether it is a negative value with theis_negative()method. The function is inexpensive.3.1415 negative: 0 is_integer: 0 float: 3.1415 float: 3.1415-13231232 negative: 1 is_integer: 1 integer: -13231232 integer: -132312329999999999999999999 negative: 0 is_integer: 1 large 64-bit integer: 9999999999999999999 large 64-bit integer: 9999999999999999999-+
Raw Strings
It is sometimes useful to have access to a raw (unescaped) string: we make available a minimalist
raw_json_stringdata type which contains a pointer inside the string in the original document, right after the quote. It is accessible viaget_raw_json_string()on a string instance and returned by thekey()method on an object's field instance. It is always optional: replacingget_raw_json_string()withget_string()andkey()byunescaped_key()returns anstring_viewinstance of the unescaped string.You can quickly compare a
@@ -1436,7 +1462,7 @@ Raw Stringsraw_json_stringinstance with a target string. You may also unescape theraw_json_stringon your own string buffer:parser.unescape(mystr, ptr)advances the provided pointerptrand returns a string_view instance on the newly serialized string upon success, otherwise it returns an error. When unescaping to your own string buffer, you should ensure that you have sufficient memory space: the total size of the strings plussimdjson::SIMDJSON_PADDINGbytes. The following example illustrates how we can unescape JSON string to a user-provided buffer:// writes 'Jack The Ripper 3', escaping the \u0033mystrings.push_back(valuesv);}-+
General Direct Access to the Raw JSON String
If your value is a string, the
raw_json_stringyou withget_raw_json_string()gives you direct access to the unprocessed string. But the simdjson library allows you to have access to the raw underlying JSON more generally, not just for strings.The simdjson library makes explicit assumptions about types. For examples, numbers must be integers (up to 64-bit integers) or binary64 floating-point numbers. Some users have different needs. For example, some users might want to support big integers. The library makes this possible by providing a
@@ -1497,7 +1523,7 @@ General Direct Access to the Raw JSON Stringraw_json_tokenmethod which returns astd::string_viewinstance containing the value as a string which you may then parse as you see fit.std::string_view raw = key_value.value().raw_json();// will capture "1", "2", "\"fds\"", "{\"a\":1}", "[1,344]"}-+
Storing Directly into an Existing String Instance
The simdjson library favours the use of
std::string_viewinstances because it tends to lead to better performance due to causing fewer memory allocations. However, they are cases where you need to store a string result in anstd::stringinstance. You can do so with a templated version of theto_string()method which takes as a parameter a reference to anstd::string`.{C++}@@ -1524,14 +1550,14 @@ Storing Directly into an Existing String Instanceif (doc["foo1"].get_string(value)) { /* error */ }// value was populated with "3.1416"You should be mindful of the trade-off: allocating multiple
-std::stringinstances can become expensive.+
Thread Safety
We built simdjson with thread safety in mind.
The simdjson library is single-threaded except for `iterate_many` and `parse_many` which may use secondary threads under their control when the library is compiled with thread support.
We recommend using one
parserobject per thread. When using the On Demand front-end (our default), you should access thedocumentinstances in a single-threaded manner since it acts as an iterator (and is therefore not thread safe).The CPU detection, which runs the first time parsing is attempted and switches to the fastest parser for your CPU, is transparent and thread-safe.
In a threaded environment, stack space is often limited. Running code like simdjson in debug mode may require hundreds of kilobytes of stack memory. Thus stack overflows are a possibility. We recommend you turn on optimization when working in an environment where stack space is limited. If you must run your code in debug mode, we recommend you configure your system to have more stack space. We discourage you from running production code based on a debug build.
-+
Standard Compliance
The simdjson library is fully compliant with the RFC 8259 JSON specification.
-
@@ -1549,10 +1575,10 @@ Standard Compliance
+
Backwards Compatibility
The only header file supported by simdjson is
-simdjson.h. Older versions of simdjson published a number of other include files such asdocument.horParsedJson.halongsidesimdjson.h; these headers may be moved or removed in future versions.+
Examples
Some users like to have example. The following code samples illustrate how to process specific JSON inputs. For simplicity, we do not include full error support: this code would throw exceptions on error.
- To better understand the operation of your On Demand parser, and whether it is performing as well as you think it should be, there is a logger feature built in to simdjson! To use it, define the pre-processor directive
-SIMDJSON_VERBOSE_LOGGINGprior to including thesimdjson.hheader, which enables logging in simdjson. Run your code. It may generate a lot of logging output; adding printouts from your application that show each section may be helpful. The log's output will show step-by-step information on state, buffer pointer position, depth, and key retrieval status. Importantly, unlessSIMDJSON_VERBOSE_LOGGINGis defined, logging is entirely disabled and thus carries no overhead.+
Further reading
- John Keiser, Daniel Lemire, On-Demand JSON: A Better Way to Parse Documents?, Software: Practice and Experience (to appear) diff --git a/md_doc_dom.html b/md_doc_dom.html index 0386aac19..4e47e6d98 100644 --- a/md_doc_dom.html +++ b/md_doc_dom.html @@ -110,10 +110,10 @@ $(document).ready(function(){initNavTree('md_doc_dom.html',''); initResizable();
- Padding and Temporary Copies
- Performance Tips
+
DOM vs On Demand
The simdjson library offers two distinct approaches on how to access a JSON document. We support a conventional Document-Object-Model (DOM) front-end. In such a scenario, the JSON document is entirely parsed, validated and materialized in memory as the first step. The programmer may then access the parsed data using this in-memory model.
-+
The Basics: Loading and Parsing JSON Documents using the DOM front-end
The simdjson library offers a simple DOM tree API, which you can access by creating a
dom::parserand calling theload()method:{c++}@@ -136,7 +136,7 @@ The Basics: Loading and Parsing JSON Documents using the DOM front-endDuring the
loadorparsecalls, neither the input file nor the input string are ever modified. After callingloadorparse, the source (either a file or a string) can be safely discarded. All of the JSON data is stored in theparserinstance. The parsed document is also immutable in simdjson: you do not modify it by accessing it.For best performance, a
parserinstance should be reused over several files: otherwise you will needlessly reallocate memory, an expensive process. It is also possible to avoid entirely memory allocations during parsing when using simdjson. See our performance notes for details.If you need a lower-level interface, you may call the function
-parser.parse(const char * p, size_t l)on a pointerpwhile specifying the length of your inputlin bytes. To see how to get the very best performance from a low-level approach, you way want to read our performance notes on this topic (see the Padding and Temporary Copies section).+
Using the Parsed JSON
Once you have an element, you can navigate it with idiomatic C++ iterators, operators and casts.
-
@@ -160,7 +160,7 @@ Using the Parsed JSON
- Checking an Element Type: You can check an element's type with
element.type(). It returns anelement_typewith values such assimdjson::dom::element_type::ARRAY,simdjson::dom::element_type::OBJECT,simdjson::dom::element_type::INT64,simdjson::dom::element_type::UINT64,simdjson::dom::element_type::DOUBLE,simdjson::dom::element_type::STRING,simdjson::dom::element_type::BOOLor,simdjson::dom::element_type::NULL_VALUE. - Output to streams and strings: Given a document or an element (or node) out of a JSON document, you can output a minified string version using the C++ stream idiom (
out << element). You can also request the construction of a minified string version (simdjson::minify(element)) or a prettified string version (simdjson::prettify(element)). Numbers are serialized as 64-bit floating-point numbers (double).
+
Examples
The following code illustrates all of the above:
{c++}@@ -217,7 +217,7 @@ Examplesdom::parser parser;double v = parser.parse(abstract_json)["str"]["123"]["abc"];cout << "number: " << v << endl;-+
C++17 Support
While the simdjson library can be used in any project using C++ 11 and above, field iteration has special support C++ 17's destructuring syntax. For example:
{c++}@@ -240,7 +240,7 @@ C++17 Supportfor (dom::key_value_pair field : object) {cout << field.key << " = " << field.value << endl;}-+
JSON Pointer
The simdjson library also supports JSON pointer through the
at_pointer()method, letting you reach further down into the document in a single call:{c++}@@ -271,7 +271,7 @@ JSON Pointerdouble x = car.at_pointer("/tire_pressure/1");cout << x << endl; // Prints 39.9, 31 and 30}-+
Error Handling
All simdjson APIs that can fail return
simdjson_result<T>, which is a <value, error_code> pair. You can retrieve the value with .get(), like so:{c++}@@ -334,7 +334,7 @@ Error Handlingreturn EXIT_SUCCESS;}The
-at()method has linear-time complexity: it should not be used to iterate over the content of an array.+
Error Handling Example
This is how the example in "Using the Parsed JSON" could be written using only error code checking:
{c++}@@ -443,7 +443,7 @@ Error Handling Example}To ensure you don't write any code that uses exceptions, compile with
SIMDJSON_EXCEPTIONS=OFF. For example, if including the project via cmake:target_compile_definitions(simdjson PUBLIC SIMDJSON_EXCEPTIONS=OFF)-+
Exceptions
Users more comfortable with an exception flow may choose to directly cast the
simdjson_result<T>to the desired type:{c++}@@ -460,7 +460,7 @@ Exceptionsstd::cout << "ID: " << tweets["statuses"].at(0)["id"] << std::endl;return EXIT_SUCCESS;}-+
Tree Walking and JSON Element Types
Sometimes you don't necessarily have a document with a known type, and are trying to generically inspect or walk over JSON elements. To do that, you can use iterators and the type() method. For example, here's a quick and dirty recursive function that verbosely prints the JSON document as JSON (* ignoring nuances like trailing commas and escaping strings, for brevity's sake):
{c++}@@ -507,7 +507,7 @@ Tree Walking and JSON Element Typesdom::parser parser;print_json(parser.load("twitter.json"));}-+
Reusing the parser for maximum efficiency
If you're using simdjson to parse multiple documents, or in a loop, you should make a parser once and reuse it. The simdjson library will allocate and retain internal buffers between parses, keeping buffers hot in cache and keeping memory allocation and initialization to a minimum. In this manner, you can parse terabytes of JSON data without doing any new allocation.
{c++}@@ -531,7 +531,7 @@ Reusing the parser for maximum efficiencyYou are only borrowing the document from the simdjson parser. Don't keep it long term!
This is key: don't keep the
-document&,dom::element,dom::array,dom::objectorstring_viewobjects you get back from the API. Convert them to C++ native values, structs and arrays that you own.+
Server Loops: Long-Running Processes and Memory Capacity
The simdjson library automatically expands its memory capacity when larger documents are parsed, so that you don't unexpectedly fail. In a short process that reads a bunch of files and then exits, this works pretty flawlessly.
Server loops, though, are long-running processes that will keep the parser around forever. This means that if you encounter a really, really large document, simdjson will not resize back down. The simdjson library lets you adjust your allocation strategy to prevent your server from growing without bound:
@@ -563,16 +563,16 @@ Server Loops: Long-Running Processes and Memory Capacityif (error == CAPACITY) { request.respond(413); continue; }// ...}-+
Best Use of the DOM API
The simdjson API provides access to the JSON DOM (document-object-model) content as a tree of
-dom::elementinstances, each representing an object, an array or an atomic type (null, true, false, number). Thesedom::elementinstances are lightweight objects (e.g., spanning 16 bytes) and it might be advantageous to pass them by value, as opposed to passing them by reference or by pointer.+
Padding and Temporary Copies
The simdjson function
parser.parsereads data from a padded buffer, containing SIMDJSON_PADDING extra bytes added at the end. If you are passing apadded_stringtoparser.parseor loading the JSON directly from disk (parser.load), padding is automatically handled. When callingparser.parseon a pointer (e.g.,parser.parse(my_char_pointer, my_length_in_bytes)) a temporary copy is made by default with adequate padding and you, again, do not need to be concerned with padding.Some users may not be able use our
padded_stringclass or to load the data directly from disk (parser.load). They may need to pass data pointers to the library. If these users wish to avoid temporary copies and corresponding temporary memory allocations, they may want to callparser.parsewith therealloc_if_neededparameter set to false (e.g.,parser.parse(my_char_pointer, my_length_in_bytes, false)). In such cases, they need to ensure that there are at least SIMDJSON_PADDING extra bytes at the end that can be safely accessed and read. They do not need to initialize the padded bytes to any value in particular. The following example is safe:```C++ const char *json = R"({"key":"value"})"; const size_t json_len = std::strlen(json); std::unique_ptr<char[]> padded_json_copy{new char[json_len + SIMDJSON_PADDING]}; memcpy(padded_json_copy.get(), json, json_len); memset(padded_json_copy.get() + json_len, 0, SIMDJSON_PADDING); simdjson::dom::parser parser; simdjson::dom::element element = parser.parse(padded_json_copy.get(), json_len, false); ````
Setting the
-realloc_if_neededparameterfalsein this manner may lead to better performance since copies are avoided, but it requires that the user takes more responsibilities: the simdjson library cannot verify that the input buffer was padded with SIMDJSON_PADDING extra bytes.+
Performance Tips
- For release builds, we recommend setting
NDEBUGpre-processor directive when compiling thesimdjsonlibrary. Importantly, using the optimization flags-O2or-O3under GCC and LLVM clang does not set theNDEBUGdirectrive, you must set it manually (e.g.,-DNDEBUG).
diff --git a/md_doc_implementation_selection.html b/md_doc_implementation_selection.html
index 07fe83465..e89c6b6f0 100644
--- a/md_doc_implementation_selection.html
+++ b/md_doc_implementation_selection.html
@@ -99,7 +99,7 @@ $(document).ready(function(){initNavTree('md_doc_implementation_selection.html',
- Manually Selecting the Implementation
- Checking that an Implementation can Run on your System
+
Overview
The simdjson library takes advantage of SIMD instruction sets such as NEON, SSE and AVX to achieve much of its speed. Because these instruction sets work differently, simdjson has to compile a different version of the JSON parser for different CPU architectures, often with different algorithms to take better advantage of a given CPU!
The current implementations are:
-
@@ -113,10 +113,10 @@ Overview
- Motivations @@ -112,19 +112,19 @@ Contents
- Tracking your position
- Incomplete streams
In many cases, you don't know where your compiled binary is going to run, so simdjson automatically compiles all the implementations into the executable. On Intel, it will include 4 implementations (icelake, haswell, westmere and fallback), on 64-bit ARM it will include just one since running dispatching is unnecessary, and on PPC it will include 2 (ppc64 and fallback).
If you know more about where you're going to run and want to save the space, you can disable any of these implementations at compile time with
-DSIMDJSON_IMPLEMENTATION_X=0(where X is ICELAKE, HASWELL, WESTMERE, ARM64, PPC64 and FALLBACK).The simdjson library automatically sets header flags for each implementation as it compiles; there is no need to set architecture-specific flags yourself (e.g.,
--mavx2,/AVX2or-march=haswell), and it may even break runtime dispatch and your binaries will fail to run on older processors. Note: for POWER9 processors make sure you compile it with-mcpu=power9and-mtune=power9to get maximum performance.+
Runtime CPU Detection
When you first use simdjson, it will detect the CPU you're running on, and swap over to the fastest implementation for it. This is a small, one-time cost and for many people will be paid the first time they call
-parse()orload().+
Inspecting the Detected Implementation
You can check what implementation is running with
active_implementation:{c++}@@ -124,7 +124,7 @@ Inspecting the Detected Implementationcout << "Detected the best implementation for your machine: " << simdjson::get_active_implementation()->name();cout << "(" << simdjson::get_active_implementation()->description() << ")" << endl;Implementation detection will happen in this case when you first call
-name().+
Querying Available Implementations
You can list all available implementations, regardless of which one was selected:
{c++}@@ -136,7 +136,7 @@ Querying Available Implementationscout << simdjson::get_available_implementations()["fallback"]->description() << endl;When an implementation is not available, the bracket call
simdjson::get_available_implementations()[name]will return the null pointer.The available implementations have been compiled but may not necessarily be run safely on your system see Checking that an Implementation can Run on your System.
-+
Manually Selecting the Implementation
If you're trying to do performance tests or see how different implementations of simdjson run, you can select the CPU architecture yourself:
{c++}@@ -148,7 +148,7 @@ Manually Selecting the Implementationif (! my_implementation) { exit(1); }if (! my_implementation->supported_by_runtime_system()) { exit(1); }simdjson::get_active_implementation() = my_implementation;-+
Checking that an Implementation can Run on your System
You should call
supported_by_runtime_system()to compare the processor's features with the need of the implementation.{c++}diff --git a/md_doc_iterate_many.html b/md_doc_iterate_many.html index ceeb72758..5d6c2e123 100644 --- a/md_doc_iterate_many.html +++ b/md_doc_iterate_many.html @@ -96,7 +96,7 @@ $(document).ready(function(){initNavTree('md_doc_iterate_many.html',''); initRes{"text":"c"}...... you want to read the entries (individual JSON documents) as quickly and as conveniently as possible. Importantly, the input might span several gigabytes, but you want to use a small (fixed) amount of memory. Ideally, you'd also like the parallelize the processing (using more than one core) to speed up the process.
-+
Contents
+
Motivation
The main motivation for this piece of software is to achieve maximum speed and offer a better quality of life in parsing files containing multiple small JSON documents.
The JavaScript Object Notation (JSON) RFC7159 is a handy serialization format. However, when serializing a large sequence of values as an array, or a possibly indeterminate-length or never- ending sequence of values, JSON may be inconvenient.
Consider a sequence of one million values, each possibly one kilobyte when encoded – roughly one gigabyte. It is often desirable to process such a dataset incrementally without having to first read all of it before beginning to produce results.
-+
How it works
-+
Context
Before parsing anything, simdjson first preprocesses the JSON text by identifying all structural indexes (i.e. the starting position of any JSON value, as well as any important operators like
,,:,]or}) and validating UTF8. This stage is referred to stage 1. However, during this process, simdjson has no knowledge of whether parsed a valid document, multiple documents, or even if the document is complete. Then, to iterate through the JSON text during parsing, we use what we call a JSON iterator that will navigate through the text using these structural indexes. This JSON iterator is not visible though, but it is the key component to make parsing work.Prior to iterate_many, most people who had to parse a multiline JSON file would proceed by reading the file line by line, using a utility function like
std::getlineor equivalent, and would then use theparseon each of those lines. From a performance point of view, this process is highly inefficient, in that it requires a lot of unnecessary memory allocation and makes use of thegetlinefunction, which is fundamentally slow, slower than the act of parsing with simdjson (more on this here).Unlike the popular parser RapidJson, our DOM does not require the buffer once the parsing job is completed, the DOM and the buffer are completely independent. The drawback of this architecture is that we need to allocate some additional memory to store our ParsedJson data, for every document inside a given file. Memory allocation can be slow and become a bottleneck, therefore, we want to minimize it as much as possible.
-+
Design
To achieve a minimum amount of allocations, we opted for a design where we create only one parser object and therefore allocate its memory once, and then recycle it for every document in a given file. But, knowing that they often have largely varying size, we need to make sure that we allocate enough memory so that all the documents can fit. This value is what we call the batch size. As of right now, we need to manually specify a value for this batch size, it has to be at least as big as the biggest document in your file, but not too big so that it submerges the cached memory. The bigger the batch size, the fewer we need to make allocations. We found that 1MB is somewhat a sweet spot.
-
@@ -134,12 +134,12 @@ Design
- Each time the user calls
++to read the next document, the JSON iterator moves to the start the next document. - When we reach the end of the batch, we call stage 1 on the next batch, starting from the end of the last document, and go to step 3.
+
Threads
But how can we make use of threads if they are available? We found a pretty cool algorithm that allows us to quickly identify the position of the last JSON document in a given batch. Knowing exactly where the end of the last document in the batch is, we can safely parse through the last document without any worries that it might be incomplete. Therefore, we can run stage 1 on the next batch concurrently while parsing the documents in the current batch. Running stage 1 in a different thread can, in best cases, remove almost entirely its cost and replaces it by the overhead of a thread, which is orders of magnitude cheaper. Ain't that awesome!
Thread support is only active if thread supported is detected in which case the macro SIMDJSON_THREADS_ENABLED is set. Otherwise the library runs in single-thread mode.
A
-document_streaminstance uses at most two threads: there is a main thread and a worker thread.+
Support
Since we want to offer flexibility and not restrict ourselves to a specific file format, we support any file that contains any amount of valid JSON document, separated by one or more character that is considered whitespace by the JSON spec. Anything that is not whitespace will be parsed as a JSON document and could lead to failure.
Whitespace Characters:
-
@@ -155,7 +155,7 @@ Support
- Record separator-delimited JSON (RFC 7464) <- Not supported by JsonStream!
- More on Wikipedia...
+
API
Example:
{c++}@@ -167,7 +167,7 @@ API}// Prints 1 2 3See basics.md for an overview of the API.
-+
Use cases
From jsonlines.org:
-
@@ -177,7 +177,7 @@ Use cases
- Easy Nested Data ```json {"name": "Gilbert", "wins": [["straight", "7♣"], ["one pair", "10♥"]]} {"name": "Alexa", "wins": [["two pair", "4â™ "], ["two pair", "9â™ "]]} {"name": "May", "wins": []} {"name": "Deloise", "wins": [["three of a kind", "5♣"]]} ``‘ JSON Lines’ biggest strength is in handling lots of similar nested data structures. One .jsonl file is easier to work with than a directory full of XML files.
+
Tracking your position
Some users would like to know where the document they parsed is in the input array of bytes. It is possible to do so by accessing directly the iterator and calling its
current_index()method which reports the location (in bytes) of the current document in the input stream. You may also call thesource()method to get astd::string_viewinstance on the document anderror()to check if there were any error.Let us illustrate the idea with code:
@@ -206,7 +206,7 @@ Tracking your position{"1":1,"2":3,"4":4}got full document at 29[1,2,3]-+
Incomplete streams
Some users may need to work with truncated streams. The simdjson may truncate documents at the very end of the stream that cannot possibly be valid JSON (e.g., they contain unclosed strings, unmatched brackets, unmatched braces). After iterating through the stream, you may query the
truncated_bytes()method which tells you how many bytes were truncated. If the stream is made of full (whole) documents, then you should expecttruncated_bytes()to return zero.Consider the following example where a truncated document (
@@ -224,7 +224,7 @@ Incomplete streams{"key":"intentionally unclosed string) containing 39 bytes has been left within the stream. In such cases, the first two whole documents are parsed and returned, and thetruncated_bytes()method returns 39.{"1":1,"2":3,"4":4}39 bytesImportantly, you should only call
-truncated_bytes()after iterating through all of the documents since the stream cannot tell whether there are truncated documents at the very end when it may not have accessed that part of the data yet.+
Comma-separated documents
We also support comma-separated documents, but with some performance limitations. The
iterate_manyfunction takes in an option to allow parsing of comma separated documents (which defaults on false). In this mode, the entire buffer is processed in one batch. Therefore, the total size of the document should not exceed the maximal capacity of the parser (4 GB). This mode also effectively disallow multithreading. It is therefore mostly suitable for not "very large" inputs. In this mode, the batch_size parameter is effectively ignored, as it is set to at least the document size.Example:
diff --git a/md_doc_ondemand_design.html b/md_doc_ondemand_design.html index 19d5d85b8..9276aaf7a 100644 --- a/md_doc_ondemand_design.html +++ b/md_doc_ondemand_design.html @@ -151,7 +151,7 @@ $(document).ready(function(){initNavTree('md_doc_ondemand_design.html',''); init- Validate What You Use: On Demand deliberately validates the values you use and the structure leading to it, but nothing else. The goal is a guarantee that the value you asked for is the correct one and is not malformed: there must be no confusion over whether you got the right value.
To understand why On Demand is different, it is helpful to review the major approaches to parsing and parser APIs in use today.
-+
DOM Parsers
Many of the most usable, popular JSON APIs (including simdjson) deserialize into a DOM: an intermediate tree of objects, arrays and values. In this model, we convert the input data all at once into a tree-like structure (the DOM). The DOM is then accessed by the programmer like any other in-memory data structure. The resulting API let you refer to each array or object separately, using familiar techniques like iteration (
for (auto value : array)) or indexing (object["key"]). In some cases, the values are even deserialized directly into familiar C++ constructs like vectors and maps.The DOM approach is conceptually simple and "programmer friendly". Using the DOM tree is often easy enough that many users use the DOM as-is instead of creating their own custom data structures.
@@ -176,7 +176,7 @@ DOM Parsers- Performance drain from type blindness.
What the simdjson library demonstrates is that a DOM API may be quite fast indeed: we can parse files at speeds of several gigabytes per second. However, in some instances, it may be possible to achieve even higher speeds.
-+
Event-Based Parsers (SAX, SAJ, etc.)
The event-based model (originally from the "Streaming API for XML") uses streaming to eliminate the cost of parsing and storing the entire JSON. In the event-based model, a core JSON engine parses the JSON document piece by piece, but instead of stuffing values in a DOM tree, it passes each value to a callback function, letting the user decide for themselves how to handle it. In such a model, the programmer may need to provide functions for all possible events (a number, a string, a new object, a new array, the array ends, the object ends, and so on). This allows programmers to work with much larger files without running out of memory.
The drawback is complexity: event-based APIs generally have you define a single callback for each type (e.g.
@@ -226,7 +226,7 @@ Event-Based Parsers (SAX, SAJ, etc.)string_field(std::string_view key, std::string_view value)). Because of this, the programmer suffers from context blindness: when they find a string they have to check where it is before they know what to do with it. Is this string the text of the tweet, the screen name, or something else? Are we even in a tweet right now, or is this from some other place in the document entirely? Though an event-based approach may allow superior performance, it is demanding of the programmer who must efficiently keep track of its current state within the JSON input.- Lacks the safety of DOM: malformed documents could be ingested.
Though an event-based approach might have its niche uses, we believe that it is rarely ideally suited. We suspect that it is mostly used when performance and memory is a concern, and no other option (except DOM) is readily available.
-+
Schema-Based Parser Generators
In a schema-based model, the programmer provides a description of a data structure, and the parser constructs the data structure in question during parsing. These parsers take a schema–a description of your JSON, with field names, types, everything–and generate classes/structs in your language of choice, as well as a parser to deserialize the JSON into those structs. Some such parsers let you define your own data structures (
struct) and they let a preprocessor inspects it and generates a custom JSON parser for it. Though not all of these schema-based parser generators generate a parser or even optimize for streaming, but they are able to in principle. Unlike the DOM and the event-based models, a schema-based approach assumes that the structure of the document is known at compile-time.Pros of the schema-based approach:
-
@@ -240,14 +240,14 @@ Schema-Based Parser Generators
- It is less flexible than the DOM or event-based approaches, sometimes limited to a deserialization-to-objects scenario.
- The structure of the data must be fully known at compile-time.
+
Type Blindness and Branch Misprediction
The DOM and event-based parsing model suffer from type blindness: even when the programmer knows exactly what fields and what types are in the JSON document, the parser does not. This means it has to look at each value blind with a big "switch" statement, asking "is this a number? A string? A boolean? An array? An object?"
In modern processors, this kind of switch statement can make your program run slower than it needs to because of the high cost of branch misprediction. Indeed, modern processor cores rely on speculative execution for speed. They "read ahead" in your program, predicting which instructions to run as soon as the data is available. A single-threaded program can execute 2, 3 or even more instructions per cycle–largely because of speculative execution.
Unfortunately, when the processor mispredicts the instructions, typically due to a mispredicted branch, all of the work done from the misprediction has be discarded and started anew. The processor may have been executing 3 or 4 instructions per cycle, and consuming the corresponding power, but all of the work may have been wasteful.
Type blindness means that the processor has to guess, for every JSON value, whether it will be an array, an object, number, string or boolean since these correspond to distinct code paths. Though some JSON files have predictable content, we find in practice that many JSON files stress the branch prediction. Though branch predictors improve with each new generation of processors, the cost of branch mispredictions also tends to increase as pipelines expand, and the processors become able to schedule longer streams of instructions.
On Demand parsing is tailor-made to solve this problem at the source, parsing values only after the user declares their type by asking for a
-double, anint, astring, etc. It attempts to do so while preserving most of the flexibility of DOM parsing.+
Algorithm
To help visualize the algorithm, we'll walk through the example C++ given at the top, for this JSON:
{@@ -257,7 +257,7 @@ Algorithm],"search_metadata": { "count": 2 }}-+
Starting the iteration
First, we declare a parser object that keeps internal buffers necessary for parsing. This can be reused to parse multiple JSON files, so you do not pay the high cost of allocating memory every time (and so it can stay in cache!).
@@ -465,9 +465,9 @@ Starting the iteration
This means you can very efficiently do things like read a single value from a JSON file, or take the top N, for example. It also means the things you don't use won't be fully validated. This is a general principle of On Demand: don't validate what you don't use. We still fully validate values you do use, however, as well as the objects and arrays that lead to them, so that you can be sure you get the information you need.
-+
Design Features
-+
String Parsing
When the user requests strings, we unescape them to a single string buffer much like the DOM parser so that users enjoy the same string performance as the core simdjson. We do not write the length to the string buffer, however; that is stored in the
string_viewinstance we return to the user.{C++}@@ -489,7 +489,7 @@ String Parsingfor(auto field : doc.get_object()) {std::string_view keyv = field.unescaped_key();}-+
Iteration Safety
The On Demand API is powerful. To compensate, we add some safeguards to ensure that it can be used without fear in production systems:
-
@@ -532,7 +532,7 @@ Iteration Safety
- Straightforward, programmer-friendly interface (arrays and objects).
- Highly expressive, beyond deserialization and pointer queries: many tasks can be accomplished with little code.
- The simdjson library offers runtime dispatching which allows you to compile one binary and have it run at full speed on different processors, taking advantage of the specific features of the processor. The On Demand API has limited runtime dispatch support. Under x64 systems, to fully benefit from the On Demand API, we recommend that you compile your code for a specific processor. E.g., if your processor supports AVX2 instructions, you should compile your binary executable with AVX2 instruction support (by using your compiler's commands). If you are sufficiently technically proficient, you can implement runtime dispatching within your application, by compiling your On Demand code for different processors.
- There is an initial phase which scans the entire document quickly, irrespective of the size of the document. We plan to break this phase into distinct steps for large files in a future release as we have done with other components of our API (e.g.,
parse_many). - Both the generation and the consumption of JSON data is within your system. Your team controls both the software that produces the JSON and the software the parses it, your team knows and control the hardware. Thus you can fully test your system.
- You are working with stable JSON APIs which have a consistent layout and JSON dialect.
// the following is safe:if (std::string_view(c2["name"]) != "Daniel") { return false; }}-+
Benefits of the On Demand Approach
We expect that the On Demand approach has many of the performance benefits of the schema-based approach, while providing a flexibility that is similar to that of the DOM-based approach.
-
@@ -540,7 +540,7 @@ Benefits of the On Demand Approach
+
Limitations of the On Demand Approach
The On Demand approach has some limitations:
-
@@ -552,7 +552,7 @@ Limitations of the On Demand Approach
+
Applicability of the On Demand Approach
At this time we recommend the On Demand API in the following cases:
-
@@ -567,7 +567,7 @@ Applicability of the On Demand Approach
+
Checking Your CPU Selection (x64 systems)
The On Demand API uses advanced architecture-specific code for many common processors to make JSON preprocessing and string parsing faster. By default, however, most c++ compilers will compile to the least common denominator (since the program could theoretically be run anywhere). Since On Demand is inlined into your own code, it cannot always use these advanced versions unless the compiler is told to target them.
On relevant systems, the On Demand API provides some support for runtime dispatching: that is, it will attempt to detect, at runtime, the instructions that your processor supports and optimize the code accordingly. However, it cannot always make full use of the features of your processor.
diff --git a/md_doc_parse_many.html b/md_doc_parse_many.html index 63d4ac130..32032de8f 100644 --- a/md_doc_parse_many.html +++ b/md_doc_parse_many.html @@ -96,7 +96,7 @@ $(document).ready(function(){initNavTree('md_doc_parse_many.html',''); initResiz{"text":"c"}...... you want to read the entries (individual JSON documents) as quickly and as conveniently as possible. Importantly, the input might span several gigabytes, but you want to use a small (fixed) amount of memory. Ideally, you'd also like the parallelize the processing (using more than one core) to speed up the process.
-+
Contents
- Motivations @@ -108,22 +108,22 @@ Contents
- Tracking your position
- Incomplete streams
-+
Motivation
The main motivation for this piece of software is to achieve maximum speed and offer a better quality of life in parsing files containing multiple small JSON documents.
The JavaScript Object Notation (JSON) RFC7159 is a handy serialization format. However, when serializing a large sequence of values as an array, or a possibly indeterminate-length or never- ending sequence of values, JSON may be inconvenient.
Consider a sequence of one million values, each possibly one kilobyte when encoded – roughly one gigabyte. It is often desirable to process such a dataset incrementally without having to first read all of it before beginning to produce results.
-+
Performance
The following is a chart comparing the speed of the different alternatives to parse a multiline JSON. The simdjson library provides a threaded and non-threaded
-parse_many()implementation. As the figure below shows, if you can, use threads, but if you cannot, the unthreaded mode is still fast!
+
How it works
-+
Context
The parsing in simdjson is divided into 2 stages. First, in stage 1, we parse the document and find all the structural indexes (
{,},],[,,,", ...) and validate UTF8. Then, in stage 2, we go through the document again and build the tape using structural indexes found during stage 1. Although stage 1 finds the structural indexes, it has no knowledge of the structure of the document nor does it know whether it parsed a valid document, multiple documents, or even if the document is complete.Prior to parse_many, most people who had to parse a multiline JSON file would proceed by reading the file line by line, using a utility function like
std::getlineor equivalent, and would then use theparseon each of those lines. From a performance point of view, this process is highly inefficient, in that it requires a lot of unnecessary memory allocation and makes use of thegetlinefunction, which is fundamentally slow, slower than the act of parsing with simdjson (more on this here).Unlike the popular parser RapidJson, our DOM does not require the buffer once the parsing job is completed, the DOM and the buffer are completely independent. The drawback of this architecture is that we need to allocate some additional memory to store our ParsedJson data, for every document inside a given file. Memory allocation can be slow and become a bottleneck, therefore, we want to minimize it as much as possible.
-+
Design
To achieve a minimum amount of allocations, we opted for a design where we create only one parser object and therefore allocate its memory once, and then recycle it for every document in a given file. But, knowing that they often have largely varying size, we need to make sure that we allocate enough memory so that all the documents can fit. This value is what we call the batch size. As of right now, we need to manually specify a value for this batch size, it has to be at least as big as the biggest document in your file, but not too big so that it submerges the cached memory. The bigger the batch size, the fewer we need to make allocations. We found that 1MB is somewhat a sweet spot.
-
@@ -133,12 +133,12 @@ Design
- Each time the user calls
++to read the next document, we call stage 2 to parse the next document where we left off. - When we reach the end of the batch, we call stage 1 on the next batch, starting from the end of the last document, and go to step 3.
+
Threads
But how can we make use of threads if they are available? We found a pretty cool algorithm that allows us to quickly identify the position of the last JSON document in a given batch. Knowing exactly where the end of the batch is, we no longer need for stage 2 to finish in order to load a new batch. We already know where to start the next batch. Therefore, we can run stage 1 on the next batch concurrently while the main thread is going through stage 2. Running stage 1 in a different thread can, in best cases, remove almost entirely its cost and replaces it by the overhead of a thread, which is orders of magnitude cheaper. Ain't that awesome!
Thread support is only active if thread supported is detected in which case the macro SIMDJSON_THREADS_ENABLED is set. Otherwise the library runs in single-thread mode.
A
-document_streaminstance uses at most two threads: there is a main thread and a worker thread. You should expect the main thread to be fully occupied while the worker thread is partially busy (e.g., 80% of the time).+
Support
Since we want to offer flexibility and not restrict ourselves to a specific file format, we support any file that contains any amount of valid JSON document, separated by one or more character that is considered whitespace by the JSON spec. Anything that is not whitespace will be parsed as a JSON document and could lead to failure.
Whitespace Characters:
-
@@ -154,10 +154,10 @@ Support
- Record separator-delimited JSON (RFC 7464) <- Not supported by JsonStream!
- More on Wikipedia...
+
API
See basics.md for an overview of the API.
-+
Use cases
From jsonlines.org:
-
@@ -167,7 +167,7 @@ Use cases
- Easy Nested Data ```json {"name": "Gilbert", "wins": [["straight", "7♣"], ["one pair", "10♥"]]} {"name": "Alexa", "wins": [["two pair", "4â™ "], ["two pair", "9â™ "]]} {"name": "May", "wins": []} {"name": "Deloise", "wins": [["three of a kind", "5♣"]]} ``‘ JSON Lines’ biggest strength is in handling lots of similar nested data structures. One .jsonl file is easier to work with than a directory full of XML files.
+
Tracking your position
Some users would like to know where the document they parsed is in the input array of bytes. It is possible to do so by accessing directly the iterator and calling its
current_index()method which reports the location (in bytes) of the current document in the input stream. You may also call thesource()method to get astd::string_viewinstance on the document.Let us illustrate the idea with code:
@@ -196,7 +196,7 @@ Tracking your position{"1":1,"2":3,"4":4}got full document at 29[1,2,3]-+
Incomplete streams
Some users may need to work with truncated streams. The simdjson may truncate documents at the very end of the stream that cannot possibly be valid JSON (e.g., they contain unclosed strings, unmatched brackets, unmatched braces). After iterating through the stream, you may query the
truncated_bytes()method which tells you how many bytes were truncated. If the stream is made of full (whole) documents, then you should expecttruncated_bytes()to return zero.Consider the following example where a truncated document (
diff --git a/md_doc_performance.html b/md_doc_performance.html index 61a13132e..48f0281e3 100644 --- a/md_doc_performance.html +++ b/md_doc_performance.html @@ -101,11 +101,11 @@ $(document).ready(function(){initNavTree('md_doc_performance.html',''); initResi{"key":"intentionally unclosed string) containing 39 bytes has been left within the stream. In such cases, the first two whole documents are parsed and returned, and thetruncated_bytes()method returns 39.- Visual Studio
- Power Usage and Downclocking
-+
NDEBUG directive
In C/C++, the
NDEBUGpre-processor directive is not set by default. When it is not set, the simdjson library does many additional checks that may impact negatively the performance. We recommend that, once your code is well tested, you defineNDEBUGdirective in your Release builds. TheNDEBUGdirective should be defined prior to including thesimdjson.hheader.The
-NDEBUGdirective is generally independent from optimization flags. For example, setting-O3under GCC does not set theNDEBUGdirective.+
Reusing the parser for maximum efficiency
If you're using simdjson to parse multiple documents, or in a loop, you should make a parser once and reuse it. The simdjson library will allocate and retain internal buffers between parses, keeping buffers hot in cache and keeping memory allocation and initialization to a minimum. In this manner, you can parse terabytes of JSON data without doing any new allocation.
{c++}@@ -124,7 +124,7 @@ Reusing the parser for maximum efficiencyfor(int64_t i : doc.get_array()) {cout << i << endl;}-+
Reusing string buffers
We recommend against creating many
std::stringorsimdjson::padded_stringinstances to store the JSON content in your application. Creating many non-trivial objects is convenient but often surprisingly slow. Instead, as much as possible, you should allocate (once or a few times) reusable memory buffers where you write your JSON content. If you have a bufferjson_str(of typechar*) allocated forcapacitybytes and you store a JSON document spanninglengthbytes, you can pass it to simdjson as follows:{c++}@@ -132,7 +132,7 @@ Reusing string buffersor simply
{c++}auto doc = parser.iterate(json_str, length, capacity);-+
Server Loops: Long-Running Processes and Memory Capacity
The On Demand approach also automatically expands its memory capacity when larger documents are parsed. However, for longer processes where very large files are processed (such as server loops), this capacity is not resized down. On Demand also lets you adjust the maximal capacity that the parser can process:
-
@@ -165,7 +165,7 @@ Server Loops: Long-Running Processes and Memory Capacity
}You can also manually set the maximal capacity using the methodset_max_capacity().+
Large files and huge page support
There is a memory allocation performance cost the first time you process a large file (e.g. 100MB). Between the cost of allocation, the fact that the memory is not in cache, and the initial zeroing of memory, on some systems, allocation runs far slower than parsing (e.g., 1.4GB/s). Reusing the parser mitigates this by paying the cost once, but does not eliminate it.
In large file use cases, enabling transparent huge page allocation on the OS can help a lot. We haven't found the right way to do this on Windows or OS/X, but on Linux, you can enable transparent huge page allocation with a command like:
@@ -173,7 +173,7 @@ Large files and huge page supportIn general, when running benchmarks over large files, we recommend that you report performance numbers with and without huge pages if possible. Furthermore, you should amortize the parsing (e.g., by parsing several large files) to distinguish the time spent parsing from the time spent allocating memory. If you are using the
parsebenchmarking tool provided with the simdjson library, you can use the-Hflag to omit the memory allocation cost from the benchmark results../parse largefile # includes memory allocation cost./parse -H largefile # without memory allocation-+
Number parsing
Some JSON files contain many floating-point values. It is the case with many GeoJSON files. Accurately parsing decimal strings into binary floating-point values with proper rounding is challenging. To our knowledge, it is not possible, in general, to parse streams of numbers at gigabytes per second using a single core. While using the simdjson library, it is possible that you might be limited to a few hundred megabytes per second if your JSON documents are densely packed with floating-point values.
-
@@ -181,13 +181,13 @@ Number parsing
- When serializing numbers, you should not use more digits than necessary: 17 digits is all that is needed to exactly represent double-precision floating-point numbers. Using many more digits than necessary will make your files larger and slower to parse.
- When benchmarking parsing speeds, always report whether your JSON documents are made mostly of floating-point numbers when it is the case, since number parsing can then dominate the parsing time.
+
Visual Studio
On Intel and AMD Windows platforms, Microsoft Visual Studio enables programmers to build either 32-bit (x86) or 64-bit (x64 or ARM64) binaries. We urge you to always use 64-bit mode. Visual Studio 2019 should default on 64-bit builds when you have a 64-bit version of Windows, which we recommend.
When compiling with Visual Studio, we recommend the flags
/Ob2 /O2or better. We do not recommend that you compile simdjson with architecture-specific flags such asarch:AVX2. The simdjson library automatically selects the best execution kernel at runtime.Recent versions of Microsoft Visual Studio on Windows provides support for the LLVM Clang compiler. You only need to install the "Clang compiler" optional component (ClangCL). You may also get a copy of the 64-bit LLVM CLang compiler for Windows directly from LLVM. The simdjson library fully supports the LLVM Clang compiler under Windows. In fact, you may get better performance out of simdjson with the LLVM Clang compiler than with the regular Visual Studio compiler. Meanwhile the LLVM CLang compiler is binary compatible with Visual Studio which means that you can combine their binaries (executables and libraries).
Under Windows, we also support the GNU GCC compiler via MSYS2. The performance of 64-bit MSYS2 under Windows excellent (on par with Linux).
-+
Power Usage and Downclocking
The simdjson library relies on SIMD instructions. SIMD instructions are the public transportation of computing. Instead of using 4 distinct instructions to add numbers, you can replace them with a single instruction that does the same work. Though the one instruction is slightly more expensive, the energy used per unit of work is much less with SIMD. If you can increase your speed using SIMD instructions (NEON, SSE, AVX), you should expect to reduce your power usage.
The SIMD instructions that simdjson relies upon (SSE and AVX under x64, NEON under ARM, ALTIVEC under PPC) are routinely part of runtime libraries (e.g., Go, Glibc, LLVM, Rust, Java, PHP). What distinguishes the simdjson library is that it is built from the ground up to benefit from these instructions.
diff --git a/md_doc_tape.html b/md_doc_tape.html index a5ae64750..e05155da0 100644 --- a/md_doc_tape.html +++ b/md_doc_tape.html @@ -93,7 +93,7 @@ $(document).ready(function(){initNavTree('md_doc_tape.html',''); initResizable()diff --git a/namespacesimdjson.js b/namespacesimdjson.js index 2d4679104..bda1c4e22 100644 --- a/namespacesimdjson.js +++ b/namespacesimdjson.js @@ -5,8 +5,14 @@ var namespacesimdjson = [ "fallback", "namespacesimdjson_1_1fallback.html", null ], [ "haswell", "namespacesimdjson_1_1haswell.html", null ], [ "icelake", "namespacesimdjson_1_1icelake.html", null ], + [ "ondemand", null, [ + [ "json_path_to_pointer_conversion", "json__path__to__pointer__conversion-inl_8h.html#a39425f9221b5a826d35c92337472b23f", null ] + ] ], [ "ppc64", "namespacesimdjson_1_1ppc64.html", null ], [ "SIMDJSON_IMPLEMENTATION", null, [ + [ "internal", null, [ + [ "json_path_to_pointer_conversion", "json__path__to__pointer__conversion_8h.html#a61b6ae0646529c9ad9888658eb7e3f86", null ] + ] ], [ "numberparsing", null, [ [ "parse_number", "numberparsing_8h.html#abfab4a11a66cf3429d4b584165a0d47e", null ], [ "write_float", "numberparsing_8h.html#a4c645a86ea19178e55e6ceaa96ad29ae", null ] diff --git a/namespacesimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand.html b/namespacesimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand.html index 63b2d5a0c..11ae573dc 100644 --- a/namespacesimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand.html +++ b/namespacesimdjson_1_1_s_i_m_d_j_s_o_n___i_m_p_l_e_m_e_n_t_a_t_i_o_n_1_1ondemand.html @@ -164,6 +164,9 @@ EnumerationsWe parse a JSON document to a tape. A tape is an array of 64-bit values. Each node encountered in the JSON document is written to the tape using one or more 64-bit tape elements; the layout of the tape is in "document order": elements are stored as they are encountered in the JSON document.
Throughout, little endian encoding is assumed. The tape is indexed starting at 0 (the first element is at index 0).
-+
Example
It is sometimes useful to start with an example. Consider the following JSON document:
{@@ -111,7 +111,7 @@ Example}}The following is a dump of the content of the tape, with the first number of each line representing the index of a tape element.
-+
The Tape
-@@ -179,11 +179,11 @@ The Tape 38 r // pointing to 0 (start root) +
General formal of the tape elements
Most tape elements are written as ‘('c’ << 56) + x
where'c'‘ is some ASCII character determining the type of the element (out of 't’, 'f', 'n', 'l', 'u', 'd', '"', '{', '}', '[', ']' ,'r') and wherexis a 56-bit value called the payload. The payload is normally interpreted as an unsigned 56-bit integer. Note that 56-bit integers can be quite large.Performance consideration: We believe that accessing the tape in regular units of 64 bits is more important for performance than saving memory.
-+
Simple JSON values
Simple JSON nodes are represented with one tape element:
-
@@ -191,7 +191,7 @@ Simple JSON values
true is represented as the 64-bit value('t' << 56).false is represented as the 64-bit value('f' << 56)`.
+
Integer and Double values
Integer values are represented as two 64-bit tape elements:
- The 64-bit value ‘('l’ << 56)
followed by the 64-bit integer value literally. Integer values are assumed to be signed 64-bit values, using two's complement notation.
@@ -201,7 +201,7 @@ Integer and Double values
- The 64-bit value ‘('d’ << 56)` followed by the 64-bit double value literally in standard IEEE 754 notation.
Performance consideration: We store numbers of the main tape because we believe that locality of reference is helpful for performance.
-+
Root node
Each JSON document will have two special 64-bit tape elements representing a root node, one at the beginning and one at the end.
-
@@ -210,11 +210,11 @@ Root node
All of the parsed document is located between these two 64-bit tape elements.
Hint: We can read the first tape element to determine the length of the tape.
-+
Strings
We prefix the string data itself by a 32-bit header to be interpreted as a 32-bit integer. It indicates the length of the string. The actual string data starts at an offset of 4 bytes.
We store string values using UTF-8 encoding with null termination on a separate tape. A string value is represented on the main tape as the 64-bit tape element ‘(’"' << 56) + x
-where the payloadx` is the location on the string tape of the null-terminated string.+
Arrays
JSON arrays are represented using two 64-bit tape elements.
-
@@ -223,7 +223,7 @@ Arrays
All the content of the array is located between these two tape elements, including arrays and objects.
Performance consideration: We can skip the content of an array entirely by accessing the first 64-bit tape element, reading the payload and moving to the corresponding index on the tape.
-+
Objects
JSON objects are represented using two 64-bit tape elements.
-
diff --git a/namespaces.html b/namespaces.html
index 53f00e440..8250f184f 100644
--- a/namespaces.html
+++ b/namespaces.html
@@ -109,52 +109,54 @@ $(document).ready(function(){initNavTree('namespaces.html',''); initResizable();
Nfallback Fallback implementation (runs on any machine) Nhaswell Implementation for Haswell (Intel AVX2) Nicelake Implementation for Icelake (Intel AVX512) Nppc64 Implementation for ALTIVEC (PPC64) ▼NSIMDJSON_IMPLEMENTATION Nnumberparsing ▼Nondemand A fast, simple, DOM-like interface that parses JSON as you use it Nlogger Carray A forward-only JSON array Carray_iterator A forward-only JSON array Cdocument A JSON document Cdocument_reference A document_reference is a thin wrapper around a document reference instance ▼Cdocument_stream A forward-only stream of documents Citerator Cfield A JSON field (key/value pair) in an object Cnumber A type representing a JSON number Cobject A forward-only JSON object field iterator Cobject_iterator Cparser A JSON fragment iterator Craw_json_string A string escaped per JSON rules, terminated with quote (") Cvalue An ephemeral JSON value returned during iteration Copen_container Cdom_parser_implementation Cimplementation_simdjson_result_base The result of a simdjson operation that could fail Nwestmere Implementation for Westmere (Intel SSE4.2) Csimdjson_result< dom::array > The result of a JSON conversion that may fail Csimdjson_result< dom::document_stream > Csimdjson_result< dom::element > The result of a JSON navigation that may fail Csimdjson_result< dom::object > The result of a JSON conversion that may fail Csimdjson_error Exception thrown when an exception-supporting simdjson method is called Csimdjson_result The result of a simdjson operation that could fail Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::array > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::array_iterator > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::document > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::document_reference > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::document_stream > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::field > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::json_iterator > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::json_type > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::object > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::object_iterator > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::parser > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::raw_json_string > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::token_iterator > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::value > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::value_iterator > Cimplementation An implementation of simdjson for a particular CPU architecture Cpadded_string String with extra allocation for ease of use with parser::parse() Cpadded_string_view User-provided string that promises it has extra padded bytes at the end for use with parser::parse() Nondemand Nppc64 Implementation for ALTIVEC (PPC64) ▼NSIMDJSON_IMPLEMENTATION Ninternal Nnumberparsing ▼Nondemand A fast, simple, DOM-like interface that parses JSON as you use it Nlogger Carray A forward-only JSON array Carray_iterator A forward-only JSON array Cdocument A JSON document Cdocument_reference A document_reference is a thin wrapper around a document reference instance ▼Cdocument_stream A forward-only stream of documents Citerator Cfield A JSON field (key/value pair) in an object Cnumber A type representing a JSON number Cobject A forward-only JSON object field iterator Cobject_iterator Cparser A JSON fragment iterator Craw_json_string A string escaped per JSON rules, terminated with quote (") Cvalue An ephemeral JSON value returned during iteration Copen_container Cdom_parser_implementation Cimplementation_simdjson_result_base The result of a simdjson operation that could fail Nwestmere Implementation for Westmere (Intel SSE4.2) Csimdjson_result< dom::array > The result of a JSON conversion that may fail Csimdjson_result< dom::document_stream > Csimdjson_result< dom::element > The result of a JSON navigation that may fail Csimdjson_result< dom::object > The result of a JSON conversion that may fail Csimdjson_error Exception thrown when an exception-supporting simdjson method is called Csimdjson_result The result of a simdjson operation that could fail Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::array > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::array_iterator > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::document > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::document_reference > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::document_stream > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::field > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::json_iterator > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::json_type > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::object > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::object_iterator > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::parser > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::raw_json_string > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::token_iterator > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::value > Csimdjson_result< SIMDJSON_IMPLEMENTATION::ondemand::value_iterator > Cimplementation An implementation of simdjson for a particular CPU architecture Cpadded_string String with extra allocation for ease of use with parser::parse() Cpadded_string_view User-provided string that promises it has extra padded bytes at the end for use with parser::parse() Nstd
Public Member Functions inherited from