Niels Lohmann d11e89471b Assert on missing array indices in const operator[] and document the JSON pointer case (#5606) ...

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-10-04 11:46:18 +02:00

..

~basic_json.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

accept.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

array_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

array.md

📝 add more docs (#5231)

2026-07-04 11:13:25 +02:00

at.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

back.md

📝 update documentation (#4723)

2025-04-05 18:54:35 +02:00

basic_json.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

begin.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

binary_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

binary.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

boolean_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

cbegin.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

cbor_tag_handler_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

cend.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

clear.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

contains.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

count.md

Reject integral keys for contains(), find(), and count() at compile time (#5705)

2026-09-30 20:07:45 +02:00

crbegin.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

crend.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

default_object_comparator_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

diff.md

📝 fix docs (#5217)

2026-06-29 22:15:18 +02:00

dump.md

Enhance documentation on serializing untrusted input in dump() (#5304)

2026-07-26 08:29:31 +00:00

emplace_back.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

emplace.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

empty.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

end_pos.md

Clean up and document project files (#4560)

2025-01-17 06:53:35 +01:00

end.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

erase.md

📝 add more docs (#5231)

2026-07-04 11:13:25 +02:00

error_handler_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

exception.md

Overwork documentation (#4516)

2024-12-09 23:02:30 +01:00

find.md

Reject integral keys for contains(), find(), and count() at compile time (#5705)

2026-09-30 20:07:45 +02:00

flatten.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

format_as.md

Documentation review (#5257)

2026-07-09 17:24:19 +02:00

from_bjdata.md

Add BON8 support (#2998)

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

from_bon8.md

Add BON8 support (#2998)

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

from_bson.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

from_cbor.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

from_msgpack.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

from_ubjson.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

front.md

📝 update documentation (#4723)

2025-04-05 18:54:35 +02:00

get_allocator.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

get_binary.md

📝 fix docs (#5217)

2026-06-29 22:15:18 +02:00

get_ptr.md

Overwork documentation (#4516)

2024-12-09 23:02:30 +01:00

get_ref.md

Fix return value of get_ptr for unsigned integers (#4525)

2024-12-06 18:38:25 +01:00

get_to.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

get.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

index.md

Add BON8 support (#2998)

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

input_format_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

insert.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

invalid_iterator.md

📝 fix docs (#5217)

2026-06-29 22:15:18 +02:00

is_array.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

is_binary.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

is_boolean.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

is_discarded.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

is_null.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

is_number_float.md

📝 update documentation (#4723)

2025-04-05 18:54:35 +02:00

is_number_integer.md

📝 update documentation (#4723)

2025-04-05 18:54:35 +02:00

is_number_unsigned.md

📝 update documentation (#4723)

2025-04-05 18:54:35 +02:00

is_number.md

📝 fix docs (#5217)

2026-06-29 22:15:18 +02:00

is_object.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

is_primitive.md

📝 update documentation (#4723)

2025-04-05 18:54:35 +02:00

is_string.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

is_structured.md

📝 update documentation (#4723)

2025-04-05 18:54:35 +02:00

items.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

json_base_class_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

json_serializer.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

max_size.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

merge_patch.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

meta.md

📝 fix docs (#5217)

2026-06-29 22:15:18 +02:00

number_float_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

number_integer_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

number_unsigned_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

object_comparator_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

object_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

object.md

📝 add more docs (#5231)

2026-07-04 11:13:25 +02:00

operator_eq.md

Make comparisons with scalars noexcept only when the conversion is (#5751)

2026-10-02 17:25:17 +02:00

operator_ge.md

Make comparisons with scalars noexcept only when the conversion is (#5751)

2026-10-02 17:25:17 +02:00

operator_gt.md

Make comparisons with scalars noexcept only when the conversion is (#5751)

2026-10-02 17:25:17 +02:00

operator_le.md

Make comparisons with scalars noexcept only when the conversion is (#5751)

2026-10-02 17:25:17 +02:00

operator_lt.md

Make comparisons with scalars noexcept only when the conversion is (#5751)

2026-10-02 17:25:17 +02:00

operator_ne.md

Make comparisons with scalars noexcept only when the conversion is (#5751)

2026-10-02 17:25:17 +02:00

operator_spaceship.md

Make comparisons with scalars noexcept only when the conversion is (#5751)

2026-10-02 17:25:17 +02:00

operator_value_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

operator_ValueType.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

operator[].md

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

2026-10-04 11:46:18 +02:00

operator+=.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

operator=.md

📝 fix docs (#5217)

2026-06-29 22:15:18 +02:00

other_error.md

📝 fix docs (#5217)

2026-06-29 22:15:18 +02:00

out_of_range.md

📝 fix docs (#5217)

2026-06-29 22:15:18 +02:00

parse_error.md

Fix raw-TeX formulas and other documentation infrastructure debt (#5736)

2026-09-30 22:15:20 +02:00

parse_event_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

parse.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

parser_callback_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

patch_inplace.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

patch.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

push_back.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

rbegin.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

rend.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

sax_parse.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

size.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

start_pos.md

Clean up and document project files (#4560)

2025-01-17 06:53:35 +01:00

std_formatter.md

Documentation review (#5257)

2026-07-09 17:24:19 +02:00

std_hash.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

std_swap.md

📝 fix docs (#5217)

2026-06-29 22:15:18 +02:00

string_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

swap.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

to_bjdata.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

to_bon8.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

to_bson.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

to_cbor.md

Add BON8 support (#2998)

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

to_msgpack.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

to_string.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

to_ubjson.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

type_error.md

📝 fix docs (#5217)

2026-06-29 22:15:18 +02:00

type_name.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

type.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

unflatten.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

update.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

value_t.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00

value.md

Review and extend the documentation, and check it in CI (#5638)

2026-10-02 11:32:15 +02:00