Files
json/docs/mkdocs/docs/api/json_pointer/parent_pointer.md
T
Niels Lohmann c20b6eddf4 docs: correct JSON Pointer documentation and add tests (#5937)
Fix inaccurate or missing statements about unflatten (third round-trip
failure, empty token, typo), value (type_error.306 before pointer lookup),
contains (pointer overload), parent_pointer and operator<< (bad_alloc),
out_of_range.410 example, template parameter requirements (resize(n)), and
document the URI fragment form and non-unique member names of RFC 6901.
Add tests for the unflatten and value() cases.

Signed-off-by: Niels Lohmann <mail@nlohmann.me>
2026-10-26 17:11:46 +01:00

1.0 KiB

nlohmann::json_pointer::parent_pointer

json_pointer parent_pointer() const;

Returns the parent of this JSON pointer.

Return value

Parent of this JSON pointer; in case this JSON pointer is the root, the root itself is returned.

Exception safety

Strong exception safety: if an exception occurs, the original value stays intact. The function is not #!cpp noexcept and allocates a new JSON pointer, so it can throw #!cpp std::bad_alloc; it throws no library exceptions.

Complexity

Linear in the length of the JSON pointer.

Examples

??? example

The example shows the result of `parent_pointer` for different JSON Pointers.
 
```cpp
--8<-- "examples/json_pointer__parent_pointer.cpp"
```

Output:

```json
--8<-- "examples/json_pointer__parent_pointer.output"
```

See also

  • pop_back remove the last reference token
  • back return the last reference token

Version history

Added in version 3.6.0.