mirror of
https://github.com/nlohmann/json.git
synced 2026-10-02 05:53:51 +07:00
trdesilva
a0a4e7cc0b
* Added front, pop_front, and push_front methods to json_pointers in order to facilitate root-to-leaf traversals of JSON object trees. (#4889) Signed-off-by: trdesilva <5818730+trdesilva@users.noreply.github.com> * undid VS autoformatting in irrelevant code Signed-off-by: trdesilva <5818730+trdesilva@users.noreply.github.com> * Ran make amalgamate, added navigation to json_pointer's new front methods in mkdocs, and fixed errors in documented complexity for those methods. Signed-off-by: trdesilva <5818730+trdesilva@users.noreply.github.com> * Fixed GCC 4.8 compile error caused by const iterators Signed-off-by: trdesilva <5818730+trdesilva@users.noreply.github.com> * Fixed another gcc-4.8 compile error Signed-off-by: trdesilva <5818730+trdesilva@users.noreply.github.com> * amalgamated Signed-off-by: trdesilva <5818730+trdesilva@users.noreply.github.com> --------- Signed-off-by: trdesilva <5818730+trdesilva@users.noreply.github.com>
56 lines
2.3 KiB
Markdown
56 lines
2.3 KiB
Markdown
# <small>nlohmann::</small>json_pointer
|
|
|
|
```cpp
|
|
template<typename RefStringType>
|
|
class 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`](../basic_json/at.md) and [`operator[]`](../basic_json/operator%5B%5D.md). Furthermore, JSON pointers
|
|
are the base for JSON patches.
|
|
|
|
## Template parameters
|
|
|
|
`RefStringType`
|
|
: the string type used for the reference tokens making up the JSON pointer
|
|
|
|
!!! warning "Deprecation"
|
|
|
|
For backwards compatibility `RefStringType` may also be a specialization of [`basic_json`](../basic_json/index.md)
|
|
in which case `string_t` will be deduced as [`basic_json::string_t`](../basic_json/string_t.md). This feature is
|
|
deprecated and may be removed in a future major version.
|
|
|
|
## Member types
|
|
|
|
- [**string_t**](string_t.md) - the string type used for the reference tokens
|
|
|
|
## Member functions
|
|
|
|
- [(constructor)](json_pointer.md)
|
|
- [**to_string**](to_string.md) - return a string representation of the JSON pointer
|
|
- [**operator string_t**](operator_string_t.md) - return a string representation of the JSON pointer
|
|
- [**operator==**](operator_eq.md) - compare: equal
|
|
- [**operator!=**](operator_ne.md) - compare: not equal
|
|
- [**operator/=**](operator_slasheq.md) - append to the end of the JSON pointer
|
|
- [**operator/**](operator_slash.md) - create JSON Pointer by appending
|
|
- [**parent_pointer**](parent_pointer.md) - returns the parent of this JSON pointer
|
|
- [**pop_back**](pop_back.md) - remove the last reference token
|
|
- [**back**](back.md) - return last reference token
|
|
- [**push_back**](push_back.md) - append an unescaped token at the end of the pointer
|
|
- [**pop_front**](pop_front.md) - remove the first reference token
|
|
- [**front**](front.md) - return first reference token
|
|
- [**push_front**](push_front.md) - append an unescaped token at the start of the pointer
|
|
- [**empty**](empty.md) - return whether the pointer points to the root document
|
|
|
|
## Literals
|
|
|
|
- [**operator""_json_pointer**](../operator_literal_json_pointer.md) - user-defined string literal for JSON pointers
|
|
## See also
|
|
|
|
- [RFC 6901](https://datatracker.ietf.org/doc/html/rfc6901)
|
|
|
|
## Version history
|
|
|
|
- Added in version 2.0.0.
|
|
- Changed template parameter from `basic_json` to string type in version 3.11.0.
|