mirror of
https://github.com/nlohmann/json.git
synced 2026-07-09 03:55:09 +00:00
59 lines
927 B
Markdown
59 lines
927 B
Markdown
# nlohmann::json_pointer::pop_front
|
|
|
|
```
|
|
void pop_front();
|
|
```
|
|
|
|
Remove the first reference token.
|
|
|
|
## Exceptions
|
|
|
|
Throws [out_of_range.405](https://json.nlohmann.me/home/exceptions/#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`.
|
|
|
|
```
|
|
#include <iostream>
|
|
#include <nlohmann/json.hpp>
|
|
|
|
using json = nlohmann::json;
|
|
|
|
int main()
|
|
{
|
|
// create empty JSON Pointer
|
|
json::json_pointer ptr("/foo/bar/baz");
|
|
std::cout << "\"" << ptr << "\"\n";
|
|
|
|
// call pop_front()
|
|
ptr.pop_front();
|
|
std::cout << "\"" << ptr << "\"\n";
|
|
|
|
ptr.pop_front();
|
|
std::cout << "\"" << ptr << "\"\n";
|
|
|
|
ptr.pop_front();
|
|
std::cout << "\"" << ptr << "\"\n";
|
|
}
|
|
```
|
|
|
|
Output:
|
|
|
|
```
|
|
"/foo/bar/baz"
|
|
"/bar/baz"
|
|
"/baz"
|
|
""
|
|
```
|
|
|
|
## Version history
|
|
|
|
- Added in version 3.12.x.
|