json/docs/mkdocs at claude/const-json-pointer-assertion - json

mirror of https://github.com/nlohmann/json.git synced 2026-09-29 03:00:31 +00:00

Files

T

History

Niels Lohmann 93fe62fc0b Assert on missing array indices in const operator[] and document the JSON pointer case

The const operator[] overloads are unchecked by design, and a missing key
or index is undefined behavior. The key overload guards this with a
runtime assertion, but the index overload did not, although the element
access documentation says an assertion fires in both cases. The const
JSON pointer overload inherits both through json_pointer::get_unchecked(),
so a pointer to a missing array index read out of bounds even in debug
builds, and its documentation promised out_of_range.404 for any pointer
that cannot be resolved.

Add JSON_ASSERT(idx < size()) to const operator[](size_type), which also
covers the index leg of the const JSON pointer overload. Document the
undefined behavior for the const JSON pointer overload in operator[].md
and in the runtime assertions page. Release builds are unchanged.

Signed-off-by: Niels Lohmann <mail@nlohmann.me>

2026-09-27 23:17:42 +02:00

docs

Assert on missing array indices in const operator[] and document the JSON pointer case

2026-09-27 23:17:42 +02:00

hooks

📝 make documentation more LLM friendly (#5244 )

2026-07-08 20:18:24 +02:00

includes

Add BON8 support (#2998 )

2026-09-27 16:56:21 +02:00

scripts

Clean up and document project files (#4560 )