json/api/json_pointer/front.md

nlohmann::json_pointer::front

const string_t& front() const;

Return the first reference token.

Return value

First reference token.

Exception safety

Strong exception safety: if an exception occurs, the original value stays intact.

Exceptions

Throws out_of_range.405 if the JSON pointer has no parent.

Complexity

Constant.

Examples

??? example

The example shows the usage of `front`.
 
```cpp
--8<-- "examples/json_pointer__front.cpp"
```

Output:

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

See also

• back return last reference token
• pop_front remove the first reference token
• push_front append an unescaped token at the start of the pointer

Version history

• Added in version 3.13.0.