mirror of
https://github.com/nlohmann/json.git
synced 2026-10-03 22:06:59 +01:00
45 lines
872 B
Markdown
45 lines
872 B
Markdown
# <small>nlohmann::json_pointer::</small>pop_front
|
|
|
|
```cpp
|
|
void pop_front();
|
|
```
|
|
|
|
Remove the first reference token.
|
|
|
|
## Exception safety
|
|
|
|
Strong exception safety: if an exception occurs, the original value stays intact.
|
|
|
|
## Exceptions
|
|
|
|
Throws [out_of_range.405](../../home/exceptions.md#jsonexceptionout_of_range405) if the JSON pointer has no parent.
|
|
|
|
## Complexity
|
|
|
|
Linear in the number of reference tokens in the `json_pointer`.
|
|
|
|
## Examples
|
|
|
|
??? example
|
|
|
|
The example shows the usage of `pop_front`.
|
|
|
|
```cpp
|
|
--8<-- "examples/json_pointer__pop_front.cpp"
|
|
```
|
|
|
|
Output:
|
|
|
|
```json
|
|
--8<-- "examples/json_pointer__pop_front.output"
|
|
```
|
|
|
|
## See also
|
|
|
|
- [front](front.md) return first reference token
|
|
- [push_front](push_front.md) append an unescaped token at the start of the pointer
|
|
|
|
## Version history
|
|
|
|
- Added in version 3.13.0.
|