JSON Pointer. More...
#include "json.h"
Public Member Functions | |
json_pointer (const std::string &s="") | |
create JSON pointer More... | |
json_pointer (const std::string &s="") | |
create JSON pointer More... | |
const std::string & | back () const |
return last reference token More... | |
const std::string & | back () const |
return last reference token More... | |
bool | empty () const noexcept |
return whether pointer points to the root document More... | |
bool | empty () const noexcept |
return whether pointer points to the root document More... | |
operator std::string () const | |
return a string representation of the JSON pointer More... | |
operator std::string () const | |
return a string representation of the JSON pointer More... | |
json_pointer & | operator/= (const json_pointer &ptr) |
append another JSON pointer at the end of this JSON pointer More... | |
json_pointer & | operator/= (const json_pointer &ptr) |
append another JSON pointer at the end of this JSON pointer More... | |
json_pointer & | operator/= (std::size_t array_idx) |
append an array index at the end of this JSON pointer More... | |
json_pointer & | operator/= (std::size_t array_idx) |
append an array index at the end of this JSON pointer More... | |
json_pointer & | operator/= (std::string token) |
append an unescaped reference token at the end of this JSON pointer More... | |
json_pointer & | operator/= (std::string token) |
append an unescaped reference token at the end of this JSON pointer More... | |
json_pointer | parent_pointer () const |
returns the parent of this JSON pointer More... | |
json_pointer | parent_pointer () const |
returns the parent of this JSON pointer More... | |
void | pop_back () |
remove last reference token More... | |
void | pop_back () |
remove last reference token More... | |
void | push_back (const std::string &token) |
append an unescaped token at the end of the reference pointer More... | |
void | push_back (const std::string &token) |
append an unescaped token at the end of the reference pointer More... | |
void | push_back (std::string &&token) |
append an unescaped token at the end of the reference pointer More... | |
void | push_back (std::string &&token) |
append an unescaped token at the end of the reference pointer More... | |
std::string | to_string () const |
return a string representation of the JSON pointer More... | |
std::string | to_string () const |
return a string representation of the JSON pointer More... | |
Private Member Functions | |
bool | contains (const BasicJsonType *ptr) const |
bool | contains (const BasicJsonType *ptr) const |
BasicJsonType & | get_and_create (BasicJsonType &j) const |
create and return a reference to the pointed to value More... | |
BasicJsonType & | get_and_create (BasicJsonType &j) const |
create and return a reference to the pointed to value More... | |
BasicJsonType & | get_checked (BasicJsonType *ptr) const |
BasicJsonType & | get_checked (BasicJsonType *ptr) const |
const BasicJsonType & | get_checked (const BasicJsonType *ptr) const |
const BasicJsonType & | get_checked (const BasicJsonType *ptr) const |
BasicJsonType & | get_unchecked (BasicJsonType *ptr) const |
return a reference to the pointed to value More... | |
BasicJsonType & | get_unchecked (BasicJsonType *ptr) const |
return a reference to the pointed to value More... | |
const BasicJsonType & | get_unchecked (const BasicJsonType *ptr) const |
return a const reference to the pointed to value More... | |
const BasicJsonType & | get_unchecked (const BasicJsonType *ptr) const |
return a const reference to the pointed to value More... | |
JSON_PRIVATE_UNLESS_TESTED | replace_substring (s, "/", "~1") |
JSON_PRIVATE_UNLESS_TESTED | replace_substring (s, "/", "~1") |
Static Private Member Functions | |
static BasicJsonType::size_type | array_index (const std::string &s) |
static BasicJsonType::size_type | array_index (const std::string &s) |
static void | flatten (const std::string &reference_string, const BasicJsonType &value, BasicJsonType &result) |
static void | flatten (const std::string &reference_string, const BasicJsonType &value, BasicJsonType &result) |
static void | replace_substring (std::string &s, const std::string &f, const std::string &t) |
replace all occurrences of a substring by another string More... | |
static void | replace_substring (std::string &s, const std::string &f, const std::string &t) |
replace all occurrences of a substring by another string More... | |
static std::vector< std::string > | split (const std::string &reference_string) |
split the string input to reference tokens More... | |
static std::vector< std::string > | split (const std::string &reference_string) |
split the string input to reference tokens More... | |
static void | unescape (std::string &s) |
unescape "~1" to tilde and "~0" to slash (order is important!) More... | |
static void | unescape (std::string &s) |
unescape "~1" to tilde and "~0" to slash (order is important!) More... | |
static BasicJsonType | unflatten (const BasicJsonType &value) |
static BasicJsonType | unflatten (const BasicJsonType &value) |
Private Attributes | |
JSON_PRIVATE_UNLESS_TESTED | __pad0__: json_pointer top() const { if (JSON_HEDLEY_UNLIKELY(empty())) { JSON_THROW(detail::out_of_range::create(405 |
JSON_PRIVATE_UNLESS_TESTED | __pad1__: static std::string escape(std::string s) { replace_substring(s |
JSON_PRIVATE_UNLESS_TESTED JSON pointer has no | parent |
result | reference_tokens = {reference_tokens[0]} |
the reference tokens More... | |
std::vector< std::string > | reference_tokens |
the reference tokens More... | |
json_pointer | result = *this |
return | result |
return | s |
Friends | |
class | basic_json |
bool | operator!= (json_pointer const &lhs, json_pointer const &rhs) noexcept |
compares two JSON pointers for inequality More... | |
bool | operator!= (json_pointer const &lhs, json_pointer const &rhs) noexcept |
compares two JSON pointers for inequality More... | |
json_pointer | operator/ (const json_pointer &lhs, const json_pointer &rhs) |
create a new JSON pointer by appending the right JSON pointer at the end of the left JSON pointer More... | |
json_pointer | operator/ (const json_pointer &lhs, const json_pointer &rhs) |
create a new JSON pointer by appending the right JSON pointer at the end of the left JSON pointer More... | |
json_pointer | operator/ (const json_pointer &ptr, std::size_t array_idx) |
create a new JSON pointer by appending the array-index-token at the end of the JSON pointer More... | |
json_pointer | operator/ (const json_pointer &ptr, std::size_t array_idx) |
create a new JSON pointer by appending the array-index-token at the end of the JSON pointer More... | |
json_pointer | operator/ (const json_pointer &ptr, std::string token) |
create a new JSON pointer by appending the unescaped token at the end of the JSON pointer More... | |
json_pointer | operator/ (const json_pointer &ptr, std::string token) |
create a new JSON pointer by appending the unescaped token at the end of the JSON pointer More... | |
bool | operator== (json_pointer const &lhs, json_pointer const &rhs) noexcept |
compares two JSON pointers for equality More... | |
bool | operator== (json_pointer const &lhs, json_pointer const &rhs) noexcept |
compares two JSON pointers for equality More... | |
JSON Pointer.
A JSON pointer defines a string syntax for identifying a specific value within a JSON document. It can be used with functions at
and operator[]
. Furthermore, JSON pointers are the base for JSON patches.
|
inlineexplicit |
create JSON pointer
Create a JSON pointer according to the syntax described in Section 3 of RFC6901.
[in] | s | string representing the JSON pointer; if omitted, the empty string is assumed which references the whole JSON value |
parse_error.107 | if the given JSON pointer s is nonempty and does not begin with a slash (/ ); see example below |
parse_error.108 | if a tilde (~ ) in the given JSON pointer s is not followed by 0 (representing ~ ) or 1 (representing / ); see example below |
@liveexample{The example shows the construction several valid JSON pointers as well as the exceptional behavior.,json_pointer}
Definition at line 11652 of file json.h.
Referenced by nlohmann::json_pointer< BasicJsonType >::unflatten().
|
inlineexplicit |
create JSON pointer
Create a JSON pointer according to the syntax described in Section 3 of RFC6901.
[in] | s | string representing the JSON pointer; if omitted, the empty string is assumed which references the whole JSON value |
parse_error.107 | if the given JSON pointer s is nonempty and does not begin with a slash (/ ); see example below |
parse_error.108 | if a tilde (~ ) in the given JSON pointer s is not followed by 0 (representing ~ ) or 1 (representing / ); see example below |
@liveexample{The example shows the construction several valid JSON pointers as well as the exceptional behavior.,json_pointer}
|
inlinestaticprivate |
[in] | s | reference token to be converted into an array index |
parse_error.106 | if an array index begins with '0' |
parse_error.109 | if an array index begins not with a digit |
out_of_range.404 | if string s could not be converted to an integer |
out_of_range.410 | if an array index exceeds size_type |
Definition at line 11939 of file json.h.
References nlohmann::detail::parse_error::create(), nlohmann::detail::out_of_range::create(), JSON_CATCH, JSON_HEDLEY_UNLIKELY, JSON_THROW, JSON_TRY, max, two-ray-to-three-gpp-ch-calibration::res, and nlohmann::json_pointer< BasicJsonType >::s.
Referenced by nlohmann::json_pointer< BasicJsonType >::contains(), nlohmann::json_pointer< BasicJsonType >::get_and_create(), nlohmann::json_pointer< BasicJsonType >::get_checked(), and nlohmann::json_pointer< BasicJsonType >::get_unchecked().
|
inlinestaticprivate |
[in] | s | reference token to be converted into an array index |
parse_error.106 | if an array index begins with '0' |
parse_error.109 | if an array index begins not with a digit |
out_of_range.404 | if string s could not be converted to an integer |
out_of_range.410 | if an array index exceeds size_type |
Definition at line 11939 of file json.h.
References nlohmann::detail::parse_error::create(), nlohmann::detail::out_of_range::create(), JSON_CATCH, JSON_HEDLEY_UNLIKELY, JSON_THROW, JSON_TRY, max, two-ray-to-three-gpp-ch-calibration::res, and nlohmann::json_pointer< BasicJsonType >::s.
|
inline |
return last reference token
empty()
@liveexample{The example shows the usage of back
.,json_pointer__back}
@complexity Constant.
out_of_range.405 | if JSON pointer has no parent |
Definition at line 11876 of file json.h.
References nlohmann::detail::out_of_range::create(), nlohmann::json_pointer< BasicJsonType >::empty(), JSON_HEDLEY_UNLIKELY, JSON_THROW, and nlohmann::json_pointer< BasicJsonType >::reference_tokens.
|
inline |
return last reference token
empty()
@liveexample{The example shows the usage of back
.,json_pointer__back}
@complexity Constant.
out_of_range.405 | if JSON pointer has no parent |
Definition at line 11876 of file json.h.
References nlohmann::detail::out_of_range::create(), nlohmann::json_pointer< BasicJsonType >::empty(), JSON_HEDLEY_UNLIKELY, JSON_THROW, and nlohmann::json_pointer< BasicJsonType >::reference_tokens.
|
inlineprivate |
parse_error.106 | if an array index begins with '0' |
parse_error.109 | if an array index was not a number |
Definition at line 12268 of file json.h.
References nlohmann::detail::array, nlohmann::json_pointer< BasicJsonType >::array_index(), JSON_HEDLEY_UNLIKELY, nlohmann::detail::object, and nlohmann::json_pointer< BasicJsonType >::reference_tokens.
|
inlineprivate |
parse_error.106 | if an array index begins with '0' |
parse_error.109 | if an array index was not a number |
Definition at line 12268 of file json.h.
References nlohmann::detail::array, nlohmann::json_pointer< BasicJsonType >::array_index(), JSON_HEDLEY_UNLIKELY, nlohmann::detail::object, and nlohmann::json_pointer< BasicJsonType >::reference_tokens.
|
inlinenoexcept |
return whether pointer points to the root document
@complexity Constant.
@exceptionsafety No-throw guarantee: this function never throws exceptions.
@liveexample{The example shows the result of empty
for different JSON Pointers.,json_pointer__empty}
Definition at line 11923 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::reference_tokens.
Referenced by nlohmann::json_pointer< BasicJsonType >::back(), nlohmann::json_pointer< BasicJsonType >::parent_pointer(), and nlohmann::json_pointer< BasicJsonType >::pop_back().
|
inlinenoexcept |
return whether pointer points to the root document
@complexity Constant.
@exceptionsafety No-throw guarantee: this function never throws exceptions.
@liveexample{The example shows the result of empty
for different JSON Pointers.,json_pointer__empty}
Definition at line 11923 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::reference_tokens.
|
inlinestaticprivate |
[in] | reference_string | the reference string to the current value |
[in] | value | the value to consider |
[in,out] | result | the result object to insert values to |
null
. Definition at line 12458 of file json.h.
References nlohmann::detail::array, nlohmann::detail::object, nlohmann::json_pointer< BasicJsonType >::result, nlohmann::to_string(), and second::value.
Referenced by nlohmann::basic_json< ObjectType, ArrayType, StringType, BooleanType, NumberIntegerType, NumberUnsignedType, NumberFloatType, AllocatorType, JSONSerializer, BinaryType >::flatten(), and nlohmann::json_pointer< BasicJsonType >::flatten().
|
inlinestaticprivate |
[in] | reference_string | the reference string to the current value |
[in] | value | the value to consider |
[in,out] | result | the result object to insert values to |
null
. Definition at line 12458 of file json.h.
References nlohmann::detail::array, nlohmann::json_pointer< BasicJsonType >::flatten(), nlohmann::detail::object, nlohmann::json_pointer< BasicJsonType >::result, nlohmann::to_string(), and second::value.
|
inlineprivate |
create and return a reference to the pointed to value
@complexity Linear in the number of reference tokens.
parse_error.109 | if array index is not a number |
type_error.313 | if value cannot be unflattened |
Definition at line 12006 of file json.h.
References nlohmann::detail::array, nlohmann::json_pointer< BasicJsonType >::array_index(), nlohmann::detail::type_error::create(), JSON_THROW, nlohmann::detail::null, nlohmann::detail::object, nlohmann::json_pointer< BasicJsonType >::reference_tokens, and nlohmann::json_pointer< BasicJsonType >::result.
|
inlineprivate |
create and return a reference to the pointed to value
@complexity Linear in the number of reference tokens.
parse_error.109 | if array index is not a number |
type_error.313 | if value cannot be unflattened |
Definition at line 12006 of file json.h.
References nlohmann::detail::array, nlohmann::json_pointer< BasicJsonType >::array_index(), nlohmann::detail::type_error::create(), JSON_THROW, nlohmann::detail::null, nlohmann::detail::object, nlohmann::json_pointer< BasicJsonType >::reference_tokens, and nlohmann::json_pointer< BasicJsonType >::result.
|
inlineprivate |
parse_error.106 | if an array index begins with '0' |
parse_error.109 | if an array index was not a number |
out_of_range.402 | if the array index '-' is used |
out_of_range.404 | if the JSON pointer can not be resolved |
Definition at line 12137 of file json.h.
References nlohmann::detail::array, nlohmann::json_pointer< BasicJsonType >::array_index(), nlohmann::detail::out_of_range::create(), JSON_HEDLEY_UNLIKELY, JSON_THROW, nlohmann::detail::object, nlohmann::json_pointer< BasicJsonType >::reference_tokens, and nlohmann::to_string().
Referenced by nlohmann::basic_json< ObjectType, ArrayType, StringType, BooleanType, NumberIntegerType, NumberUnsignedType, NumberFloatType, AllocatorType, JSONSerializer, BinaryType >::at(), and nlohmann::basic_json< ObjectType, ArrayType, StringType, BooleanType, NumberIntegerType, NumberUnsignedType, NumberFloatType, AllocatorType, JSONSerializer, BinaryType >::value().
|
inlineprivate |
parse_error.106 | if an array index begins with '0' |
parse_error.109 | if an array index was not a number |
out_of_range.402 | if the array index '-' is used |
out_of_range.404 | if the JSON pointer can not be resolved |
Definition at line 12137 of file json.h.
References nlohmann::detail::array, nlohmann::json_pointer< BasicJsonType >::array_index(), nlohmann::detail::out_of_range::create(), JSON_HEDLEY_UNLIKELY, JSON_THROW, nlohmann::detail::object, nlohmann::json_pointer< BasicJsonType >::reference_tokens, and nlohmann::to_string().
|
inlineprivate |
parse_error.106 | if an array index begins with '0' |
parse_error.109 | if an array index was not a number |
out_of_range.402 | if the array index '-' is used |
out_of_range.404 | if the JSON pointer can not be resolved |
Definition at line 12228 of file json.h.
References nlohmann::detail::array, nlohmann::json_pointer< BasicJsonType >::array_index(), nlohmann::detail::out_of_range::create(), JSON_HEDLEY_UNLIKELY, JSON_THROW, nlohmann::detail::object, nlohmann::json_pointer< BasicJsonType >::reference_tokens, and nlohmann::to_string().
|
inlineprivate |
parse_error.106 | if an array index begins with '0' |
parse_error.109 | if an array index was not a number |
out_of_range.402 | if the array index '-' is used |
out_of_range.404 | if the JSON pointer can not be resolved |
Definition at line 12228 of file json.h.
References nlohmann::detail::array, nlohmann::json_pointer< BasicJsonType >::array_index(), nlohmann::detail::out_of_range::create(), JSON_HEDLEY_UNLIKELY, JSON_THROW, nlohmann::detail::object, nlohmann::json_pointer< BasicJsonType >::reference_tokens, and nlohmann::to_string().
|
inlineprivate |
return a reference to the pointed to value
"/this/that"
on a null value is equivalent to calling operator[]("this").operator[]("that")
on that value, effectively changing the null value to an object.[in] | ptr | a JSON value |
@complexity Linear in the length of the JSON pointer.
parse_error.106 | if an array index begins with '0' |
parse_error.109 | if an array index was not a number |
out_of_range.404 | if the JSON pointer can not be resolved |
Definition at line 12078 of file json.h.
References nlohmann::detail::array, nlohmann::json_pointer< BasicJsonType >::array_index(), nlohmann::detail::out_of_range::create(), JSON_THROW, nlohmann::detail::object, nlohmann::json_pointer< BasicJsonType >::reference_tokens, and two-ray-to-three-gpp-ch-calibration::x.
|
inlineprivate |
return a reference to the pointed to value
"/this/that"
on a null value is equivalent to calling operator[]("this").operator[]("that")
on that value, effectively changing the null value to an object.[in] | ptr | a JSON value |
@complexity Linear in the length of the JSON pointer.
parse_error.106 | if an array index begins with '0' |
parse_error.109 | if an array index was not a number |
out_of_range.404 | if the JSON pointer can not be resolved |
Definition at line 12078 of file json.h.
References nlohmann::detail::array, nlohmann::json_pointer< BasicJsonType >::array_index(), nlohmann::detail::out_of_range::create(), JSON_THROW, nlohmann::detail::object, nlohmann::json_pointer< BasicJsonType >::reference_tokens, and two-ray-to-three-gpp-ch-calibration::x.
|
inlineprivate |
return a const reference to the pointed to value
[in] | ptr | a JSON value |
parse_error.106 | if an array index begins with '0' |
parse_error.109 | if an array index was not a number |
out_of_range.402 | if the array index '-' is used |
out_of_range.404 | if the JSON pointer can not be resolved |
Definition at line 12186 of file json.h.
References nlohmann::detail::array, nlohmann::json_pointer< BasicJsonType >::array_index(), nlohmann::detail::out_of_range::create(), JSON_HEDLEY_UNLIKELY, JSON_THROW, nlohmann::detail::object, nlohmann::json_pointer< BasicJsonType >::reference_tokens, and nlohmann::to_string().
|
inlineprivate |
return a const reference to the pointed to value
[in] | ptr | a JSON value |
parse_error.106 | if an array index begins with '0' |
parse_error.109 | if an array index was not a number |
out_of_range.402 | if the array index '-' is used |
out_of_range.404 | if the JSON pointer can not be resolved |
Definition at line 12186 of file json.h.
References nlohmann::detail::array, nlohmann::json_pointer< BasicJsonType >::array_index(), nlohmann::detail::out_of_range::create(), JSON_HEDLEY_UNLIKELY, JSON_THROW, nlohmann::detail::object, nlohmann::json_pointer< BasicJsonType >::reference_tokens, and nlohmann::to_string().
|
inline |
return a string representation of the JSON pointer
ptr
, it holds: @liveexample{The example shows the result of to_string
.,json_pointer__to_string}
Definition at line 11681 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::to_string().
|
inline |
return a string representation of the JSON pointer
ptr
, it holds: @liveexample{The example shows the result of to_string
.,json_pointer__to_string}
Definition at line 11681 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::to_string().
|
inline |
append another JSON pointer at the end of this JSON pointer
[in] | ptr | JSON pointer to append |
@liveexample{The example shows the usage of operator/=
.,json_pointer__operator_add}
@complexity Linear in the length of ptr.
Definition at line 11702 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::reference_tokens.
|
inline |
append another JSON pointer at the end of this JSON pointer
[in] | ptr | JSON pointer to append |
@liveexample{The example shows the usage of operator/=
.,json_pointer__operator_add}
@complexity Linear in the length of ptr.
Definition at line 11702 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::reference_tokens.
|
inline |
append an array index at the end of this JSON pointer
[in] | array_idx | array index to append |
@liveexample{The example shows the usage of operator/=
.,json_pointer__operator_add}
@complexity Amortized constant.
Definition at line 11748 of file json.h.
References nlohmann::to_string().
|
inline |
append an array index at the end of this JSON pointer
[in] | array_idx | array index to append |
@liveexample{The example shows the usage of operator/=
.,json_pointer__operator_add}
@complexity Amortized constant.
Definition at line 11748 of file json.h.
References nlohmann::to_string().
|
inline |
append an unescaped reference token at the end of this JSON pointer
[in] | token | reference token to append |
@liveexample{The example shows the usage of operator/=
.,json_pointer__operator_add}
@complexity Amortized constant.
Definition at line 11726 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::push_back().
|
inline |
append an unescaped reference token at the end of this JSON pointer
[in] | token | reference token to append |
@liveexample{The example shows the usage of operator/=
.,json_pointer__operator_add}
@complexity Amortized constant.
Definition at line 11726 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::push_back().
|
inline |
returns the parent of this JSON pointer
@complexity Linear in the length of the JSON pointer.
@liveexample{The example shows the result of parent_pointer
for different JSON Pointers.,json_pointer__parent_pointer}
Definition at line 11827 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::empty(), and two-ray-to-three-gpp-ch-calibration::res.
|
inline |
returns the parent of this JSON pointer
@complexity Linear in the length of the JSON pointer.
@liveexample{The example shows the result of parent_pointer
for different JSON Pointers.,json_pointer__parent_pointer}
Definition at line 11827 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::empty(), and two-ray-to-three-gpp-ch-calibration::res.
|
inline |
remove last reference token
empty()
@liveexample{The example shows the usage of pop_back
.,json_pointer__pop_back}
@complexity Constant.
out_of_range.405 | if JSON pointer has no parent |
Definition at line 11852 of file json.h.
References nlohmann::detail::out_of_range::create(), nlohmann::json_pointer< BasicJsonType >::empty(), JSON_HEDLEY_UNLIKELY, JSON_THROW, and nlohmann::json_pointer< BasicJsonType >::reference_tokens.
|
inline |
remove last reference token
empty()
@liveexample{The example shows the usage of pop_back
.,json_pointer__pop_back}
@complexity Constant.
out_of_range.405 | if JSON pointer has no parent |
Definition at line 11852 of file json.h.
References nlohmann::detail::out_of_range::create(), nlohmann::json_pointer< BasicJsonType >::empty(), JSON_HEDLEY_UNLIKELY, JSON_THROW, and nlohmann::json_pointer< BasicJsonType >::reference_tokens.
|
inline |
append an unescaped token at the end of the reference pointer
[in] | token | token to add |
@complexity Amortized constant.
@liveexample{The example shows the result of push_back
for different JSON Pointers.,json_pointer__push_back}
Definition at line 11898 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::reference_tokens.
Referenced by nlohmann::json_pointer< BasicJsonType >::operator/=(), and nlohmann::json_pointer< BasicJsonType >::split().
|
inline |
append an unescaped token at the end of the reference pointer
[in] | token | token to add |
@complexity Amortized constant.
@liveexample{The example shows the result of push_back
for different JSON Pointers.,json_pointer__push_back}
Definition at line 11898 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::reference_tokens.
|
inline |
append an unescaped token at the end of the reference pointer
[in] | token | token to add |
@complexity Amortized constant.
@liveexample{The example shows the result of push_back
for different JSON Pointers.,json_pointer__push_back}
Definition at line 11904 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::reference_tokens.
|
inline |
append an unescaped token at the end of the reference pointer
[in] | token | token to add |
@complexity Amortized constant.
@liveexample{The example shows the result of push_back
for different JSON Pointers.,json_pointer__push_back}
Definition at line 11904 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::reference_tokens.
|
private |
|
private |
|
inlinestaticprivate |
replace all occurrences of a substring by another string
[in,out] | s | the string to manipulate; changed so that all occurrences of f are replaced with t |
[in] | f | the substring to replace with t |
[in] | t | the string to replace f |
Definition at line 12423 of file json.h.
References f(), JSON_ASSERT, and nlohmann::json_pointer< BasicJsonType >::s.
Referenced by nlohmann::json_pointer< BasicJsonType >::unescape().
|
inlinestaticprivate |
replace all occurrences of a substring by another string
[in,out] | s | the string to manipulate; changed so that all occurrences of f are replaced with t |
[in] | f | the substring to replace with t |
[in] | t | the string to replace f |
Definition at line 12423 of file json.h.
References f(), JSON_ASSERT, and nlohmann::json_pointer< BasicJsonType >::s.
|
inlinestaticprivate |
split the string input to reference tokens
parse_error.107 | if the pointer is not empty or begins with '/' |
parse_error.108 | if character '~' is not followed by '0' or '1' |
Definition at line 12348 of file json.h.
References nlohmann::detail::parse_error::create(), JSON_ASSERT, JSON_HEDLEY_UNLIKELY, JSON_THROW, nlohmann::json_pointer< BasicJsonType >::push_back(), nlohmann::json_pointer< BasicJsonType >::result, two-ray-to-three-gpp-ch-calibration::start, and nlohmann::json_pointer< BasicJsonType >::unescape().
|
inlinestaticprivate |
split the string input to reference tokens
parse_error.107 | if the pointer is not empty or begins with '/' |
parse_error.108 | if character '~' is not followed by '0' or '1' |
Definition at line 12348 of file json.h.
References nlohmann::detail::parse_error::create(), JSON_ASSERT, JSON_HEDLEY_UNLIKELY, JSON_THROW, nlohmann::json_pointer< BasicJsonType >::push_back(), nlohmann::json_pointer< BasicJsonType >::result, two-ray-to-three-gpp-ch-calibration::start, and nlohmann::json_pointer< BasicJsonType >::unescape().
|
inline |
return a string representation of the JSON pointer
ptr
, it holds: @liveexample{The example shows the result of to_string
.,json_pointer__to_string}
Definition at line 11670 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::reference_tokens.
Referenced by nlohmann::json_pointer< BasicJsonType >::operator std::string().
|
inline |
return a string representation of the JSON pointer
ptr
, it holds: @liveexample{The example shows the result of to_string
.,json_pointer__to_string}
Definition at line 11670 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::reference_tokens.
|
inlinestaticprivate |
unescape "~1" to tilde and "~0" to slash (order is important!)
Definition at line 12444 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::replace_substring(), and nlohmann::json_pointer< BasicJsonType >::s.
Referenced by nlohmann::json_pointer< BasicJsonType >::split().
|
inlinestaticprivate |
unescape "~1" to tilde and "~0" to slash (order is important!)
Definition at line 12444 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::replace_substring(), and nlohmann::json_pointer< BasicJsonType >::s.
|
inlinestaticprivate |
[in] | value | flattened JSON |
parse_error.109 | if array index is not a number |
type_error.314 | if value is not an object |
type_error.315 | if object values are not primitive |
type_error.313 | if value cannot be unflattened |
Definition at line 12521 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::json_pointer(), nlohmann::detail::type_error::create(), JSON_HEDLEY_UNLIKELY, JSON_THROW, nlohmann::json_pointer< BasicJsonType >::result, and second::value.
|
inlinestaticprivate |
[in] | value | flattened JSON |
parse_error.109 | if array index is not a number |
type_error.314 | if value is not an object |
type_error.315 | if object values are not primitive |
type_error.313 | if value cannot be unflattened |
Definition at line 12521 of file json.h.
References nlohmann::json_pointer< BasicJsonType >::json_pointer(), nlohmann::detail::type_error::create(), JSON_HEDLEY_UNLIKELY, JSON_THROW, nlohmann::json_pointer< BasicJsonType >::result, and second::value.
|
friend |
|
friend |
compares two JSON pointers for inequality
[in] | lhs | JSON pointer to compare |
[in] | rhs | JSON pointer to compare |
@complexity Linear in the length of the JSON pointer
@exceptionsafety No-throw guarantee: this function never throws exceptions.
|
friend |
compares two JSON pointers for inequality
[in] | lhs | JSON pointer to compare |
[in] | rhs | JSON pointer to compare |
@complexity Linear in the length of the JSON pointer
@exceptionsafety No-throw guarantee: this function never throws exceptions.
|
friend |
create a new JSON pointer by appending the right JSON pointer at the end of the left JSON pointer
[in] | lhs | JSON pointer |
[in] | rhs | JSON pointer |
@liveexample{The example shows the usage of operator/
.,json_pointer__operator_add_binary}
@complexity Linear in the length of lhs and rhs.
|
friend |
create a new JSON pointer by appending the right JSON pointer at the end of the left JSON pointer
[in] | lhs | JSON pointer |
[in] | rhs | JSON pointer |
@liveexample{The example shows the usage of operator/
.,json_pointer__operator_add_binary}
@complexity Linear in the length of lhs and rhs.
|
friend |
create a new JSON pointer by appending the array-index-token at the end of the JSON pointer
[in] | ptr | JSON pointer |
[in] | array_idx | array index |
@liveexample{The example shows the usage of operator/
.,json_pointer__operator_add_binary}
@complexity Linear in the length of ptr.
|
friend |
create a new JSON pointer by appending the array-index-token at the end of the JSON pointer
[in] | ptr | JSON pointer |
[in] | array_idx | array index |
@liveexample{The example shows the usage of operator/
.,json_pointer__operator_add_binary}
@complexity Linear in the length of ptr.
|
friend |
create a new JSON pointer by appending the unescaped token at the end of the JSON pointer
[in] | ptr | JSON pointer |
[in] | token | reference token |
@liveexample{The example shows the usage of operator/
.,json_pointer__operator_add_binary}
@complexity Linear in the length of ptr.
|
friend |
create a new JSON pointer by appending the unescaped token at the end of the JSON pointer
[in] | ptr | JSON pointer |
[in] | token | reference token |
@liveexample{The example shows the usage of operator/
.,json_pointer__operator_add_binary}
@complexity Linear in the length of ptr.
|
friend |
compares two JSON pointers for equality
[in] | lhs | JSON pointer to compare |
[in] | rhs | JSON pointer to compare |
@complexity Linear in the length of the JSON pointer
@exceptionsafety No-throw guarantee: this function never throws exceptions.
|
friend |
compares two JSON pointers for equality
[in] | lhs | JSON pointer to compare |
[in] | rhs | JSON pointer to compare |
@complexity Linear in the length of the JSON pointer
@exceptionsafety No-throw guarantee: this function never throws exceptions.
|
private |
|
private |
|
private |
|
private |
the reference tokens
Definition at line 11993 of file json.h.
Referenced by nlohmann::json_pointer< BasicJsonType >::back(), nlohmann::json_pointer< BasicJsonType >::contains(), nlohmann::json_pointer< BasicJsonType >::empty(), nlohmann::json_pointer< BasicJsonType >::get_and_create(), nlohmann::json_pointer< BasicJsonType >::get_checked(), nlohmann::json_pointer< BasicJsonType >::get_unchecked(), nlohmann::json_pointer< BasicJsonType >::operator/=(), nlohmann::json_pointer< BasicJsonType >::pop_back(), nlohmann::json_pointer< BasicJsonType >::push_back(), and nlohmann::json_pointer< BasicJsonType >::to_string().
|
private |
|
private |
Definition at line 11992 of file json.h.
Referenced by nlohmann::json_pointer< BasicJsonType >::flatten(), nlohmann::json_pointer< BasicJsonType >::get_and_create(), nlohmann::json_pointer< BasicJsonType >::split(), and nlohmann::json_pointer< BasicJsonType >::unflatten().
|
private |
|
private |
Definition at line 12440 of file json.h.
Referenced by nlohmann::json_pointer< BasicJsonType >::array_index(), nlohmann::json_pointer< BasicJsonType >::replace_substring(), and nlohmann::json_pointer< BasicJsonType >::unescape().