The code contains numerous debug assertions to ensure class invariants are valid or to detect undefined behavior. Whereas the former class invariants are nothing to be concerned of, the latter checks for undefined behavior are to detect bugs in client code.
Runtime assertions can be switched off by defining the preprocessor macro NDEBUG
(see the documentation of assert) which is the default for release builds.
The behavior of runtime assertions can be changes by defining macro JSON_ASSERT(x)
before including the json.hpp
header.
Function operator[]
implements unchecked access for objects. Whereas a missing key is added in case of non-const objects, accessing a const object with a missing key is undefined behavior (think of a dereferenced null pointer) and yields a runtime assertion.
If you are not sure whether an element in an object exists, use checked access with the at
function or call the contains
function before.
See also the documentation on element access.
??? example “Example 1: Missing object key”
The following code will trigger an assertion at runtime: ```cpp #include <nlohmann/json.hpp> using json = nlohmann::json; int main() { const json j = {{"key", "value"}}; auto v = j["missing"]; } ``` Output: ``` Assertion failed: (m_value.object->find(key) != m_value.object->end()), function operator[], file json.hpp, line 2144. ```
Constructing a JSON value from an iterator range (see constructor) with an uninitialized iterator is undefined behavior and yields a runtime assertion.
??? example “Example 2: Uninitialized iterator range”
The following code will trigger an assertion at runtime: ```cpp #include <nlohmann/json.hpp> using json = nlohmann::json; int main() { json::iterator it1, it2; json j(it1, it2); } ``` Output: ``` Assertion failed: (m_object != nullptr), function operator++, file iter_impl.hpp, line 368. ```
Any operation on uninitialized iterators (i.e., iterators that are not associated with any JSON value) is undefined behavior and yields a runtime assertion.
??? example “Example 3: Uninitialized iterator”
The following code will trigger an assertion at runtime: ```cpp #include <nlohmann/json.hpp> using json = nlohmann::json; int main() { json::iterator it; ++it; } ``` Output: ``` Assertion failed: (m_object != nullptr), function operator++, file iter_impl.hpp, line 368. ```
FILE
pointerReading from a null #!cpp FILE
pointer is undefined behavior and yields a runtime assertion. This can happen when calling #!cpp std::fopen
on a nonexistent file.
??? example “Example 4: Uninitialized iterator”
The following code will trigger an assertion at runtime: ```cpp #include <nlohmann/json.hpp> using json = nlohmann::json; int main() { std::FILE* f = std::fopen("nonexistent_file.json", "r"); json j = json::parse(f); } ``` Output: ``` Assertion failed: (m_file != nullptr), function file_input_adapter, file input_adapters.hpp, line 55. ```