Niels Lohmann
444dba381f
- Figures with numbered captions: SAX stepper, json_view layout and edit stepper, exception map, JSON pointer and patch walkers, QA pipeline, scaling and binary size charts, roadmap lanes, release timeline, integration decision tree and namespace builder - Table captions (nj-table-caption) on 9 pages - Compile times: modules and PCH charts, filesystem section, re-measured Figure 1, links between features/modules.md and compile_times.md - Interactive macro chooser for features/arbitrary_types.md - Link check: exclude URLs that answer the plugin with 400/401/419 or are dead (customers.md) Signed-off-by: Niels Lohmann <mail@nlohmann.me>
2.3 KiB
2.3 KiB
nlohmann::basic_json::out_of_range
class out_of_range : public exception;
This exception is thrown in case a library function is called on an input parameter that exceeds the expected range, for instance, in the case of array indices or nonexisting object keys.
Exceptions have ids 4xx (see list of out-of-range errors).
classDiagram
direction LR
class std_exception ["std::exception"] {
<<interface>>
}
class json_exception ["basic_json::exception"] {
+const int id
+const char* what() const
}
class json_parse_error ["basic_json::parse_error"] {
+const std::size_t byte
}
class json_invalid_iterator ["basic_json::invalid_iterator"]
class json_type_error ["basic_json::type_error"]
class json_out_of_range ["basic_json::out_of_range"]
class json_other_error ["basic_json::other_error"]
std_exception <|-- json_exception
json_exception <|-- json_parse_error
json_exception <|-- json_invalid_iterator
json_exception <|-- json_type_error
json_exception <|-- json_out_of_range
json_exception <|-- json_other_error
style json_out_of_range fill:#CCCCFF
Class hierarchy of the library's exceptions; arrows point from a derived class to its base class, and the highlighted box is `basic_json::out_of_range`.
Member functions
- what - returns explanatory string
Member variables
- id - the id of the exception
Examples
??? example
The following code shows how a `out_of_range` exception can be caught.
```cpp
--8<-- "examples/out_of_range.cpp"
```
Output:
```json
--8<-- "examples/out_of_range.output"
```
See also
exceptionfor the base class of all exceptions thrown by the library- List of out-of-range errors
parse_errorfor exceptions indicating a parse errorinvalid_iteratorfor exceptions indicating errors with iteratorstype_errorfor exceptions indicating executing a member function with a wrong typeother_errorfor exceptions indicating other library errors
Version history
- Added in version 3.0.0.