class invalid_iterator : public exception;
This exception is thrown if iterators passed to a library function do not match the expected semantics.
Exceptions have ids 2xx (see list of iterator 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_invalid_iterator fill:#CCCCFF
??? example
The following code shows how a `invalid_iterator` exception can be caught.
```cpp
#include <iostream>
#include <nlohmann/json.hpp>
using json = nlohmann::json;
int main()
{
try
{
// calling iterator::key() on non-object iterator
json j = "string";
json::iterator it = j.begin();
auto k = it.key();
}
catch (const json::invalid_iterator& e)
{
// output exception information
std::cout << "message: " << e.what() << '\n'
<< "exception id: " << e.id << std::endl;
}
}
```
Output:
```json
message: [json.exception.invalid_iterator.207] cannot use key() for non-object iterators
exception id: 207
```
exception for the base class of all exceptions thrown by the libraryparse_error for exceptions indicating a parse errortype_error for exceptions indicating executing a member function with a wrong typeout_of_range for exceptions indicating access out of the defined rangeother_error for exceptions indicating other library errors