Niels Lohmann 2649259114 Add images of json_documents: save() and load() ...

An image is a document stored so that loading it needs no
parsing: save() writes the node index, the text and the decoded
strings; the static load() reads an image written by save().

load() takes a pointer and size, a borrowed vector, or an owned
rvalue vector; the nodes are copied so they are aligned and can
be edited, while the text and decoded strings stay in the image.

image_check controls how much load() trusts the input: full
checks structure, bounds, strings and numbers, the parser's own
guarantees; bounds checks structure and bounds only; none skips
all checks, for images from a trusted source.

Layout is little-endian only ("NJVI" header, nodes, text, decoded
strings), following the idea of zero-copy formats such as
FlatBuffers and YaFF; the check follows FlatBuffers' Verifier.

New errors: parse_error.116 for a malformed image or a failed
check, type_error.320 for a discarded document or a big-endian
target.

A dedicated fuzzer and 6,000 seeded corruptions, checked under
ASan/UBSan, found and fixed two gaps: unchecked reserved header
fields, and unbounded null/boolean offsets that could make
dump() throw std::length_error.

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

2026-10-17 08:31:47 +02:00

..

bjdata_round_trip.hpp

Split the slowest Valgrind tests out of unit-large_json and unit-bjdata (#5862)

2026-10-17 08:28:28 +02:00

custom_key_test.hpp

Restore v3.12.0 support for custom object key types (#5795)

2026-10-11 08:24:31 +02:00

custom_object_key_type.hpp

Restore v3.12.0 support for custom object key types (#5795)

2026-10-11 08:24:31 +02:00

float_hard_cases.hpp

Speed up the lexer: own float parser, string scan, and \u table (#5738)

2026-10-14 17:38:36 +02:00

fuzzer_common.hpp

Fuzz the streaming input adapters against the contiguous one (#5827)

2026-10-15 20:04:57 +02:00

fuzzer-driver_afl.cpp

📄 adjust year (#5044)

2026-01-01 20:00:39 +01:00

fuzzer-json_view_image.cpp

Add images of json_documents: save() and load()

2026-10-17 08:31:47 +02:00

fuzzer-parse_bjdata.cpp

Fuzz the streaming input adapters against the contiguous one (#5827)

2026-10-15 20:04:57 +02:00

fuzzer-parse_bon8.cpp

Fuzz the streaming input adapters against the contiguous one (#5827)

2026-10-15 20:04:57 +02:00

fuzzer-parse_bson.cpp

Fuzz the streaming input adapters against the contiguous one (#5827)

2026-10-15 20:04:57 +02:00

fuzzer-parse_cbor.cpp

Fuzz the streaming input adapters against the contiguous one (#5827)

2026-10-15 20:04:57 +02:00

fuzzer-parse_json_view.cpp

Fuzz json_document with exact-size buffers and parse options

2026-10-17 08:30:36 +02:00

fuzzer-parse_json.cpp

Fuzz the streaming input adapters against the contiguous one (#5827)

2026-10-15 20:04:57 +02:00

fuzzer-parse_msgpack.cpp

Fuzz the streaming input adapters against the contiguous one (#5827)

2026-10-15 20:04:57 +02:00

fuzzer-parse_ubjson.cpp

Fuzz the streaming input adapters against the contiguous one (#5827)

2026-10-15 20:04:57 +02:00

json_view_test_helpers.hpp

Split the dump and comparison tests off unit-json_view.cpp

2026-10-17 08:31:09 +02:00

make_test_data_available.hpp

📄 adjust year (#5044)

2026-01-01 20:00:39 +01:00

round_trip_corpus.hpp

Remove test debt: dead guards, discarded results, and unreferenced files (#5732)

2026-10-01 07:33:07 +02:00

sax_countdown.hpp

Remove test debt: dead guards, discarded results, and unreferenced files (#5732)

2026-10-01 07:33:07 +02:00

sax_event_loggers.hpp

Use and extend the detail helpers to remove duplicated code (#5783)

2026-10-11 08:21:13 +02:00

skip_library_version_check.cpp

Test suite: cover untested macro configs, std::formatter branches, patch_inplace, and fix a duplicate TEST_CASE name (#5492)

2026-09-16 20:15:46 +02:00

test_utils.hpp

Reduce test suite runtime and run the Unicode tests everywhere (#5605)

2026-10-06 22:53:03 +02:00

unit-32bit.cpp

Remove test debt: dead guards, discarded results, and unreferenced files (#5732)

2026-10-01 07:33:07 +02:00

unit-algorithms.cpp

Speed up JSON pointer parsing, formatting, comparison and lookup (#5836)

2026-10-15 20:01:20 +02:00

unit-allocator.cpp

Use the with_*_t aliases in tests, examples, and docs (#5787)

2026-10-08 16:11:16 +02:00

unit-alt-string.cpp

Add with_*_t alias templates to create basic_json types with changed template parameters (#5758)

2026-10-06 22:33:29 +02:00

unit-assert_macro.cpp

Fix lint debt: enum-macro NOLINTs, doctest as SYSTEM, no-op analyzer (#5737)

2026-10-01 07:37:47 +02:00

unit-binary_formats.cpp

Write doubles with the shortest digits (Żmij), digits in registers (#5634)

2026-10-14 17:38:37 +02:00

unit-binary_utf8_error_handler.cpp

Keep converted object keys alive while writing UBJSON and BJData (#5791)

2026-10-09 17:05:36 +02:00

unit-binary_utf8_strict.cpp

Fix CI on develop after merging the ready-to-merge PRs (#5754)

2026-10-04 17:18:19 +02:00

unit-binary_writer_sinks.cpp

Fix lint debt: enum-macro NOLINTs, doctest as SYSTEM, no-op analyzer (#5737)

2026-10-01 07:37:47 +02:00

unit-bjdata_round_trip_draft2.cpp

Split the slowest Valgrind tests out of unit-large_json and unit-bjdata (#5862)

2026-10-17 08:28:28 +02:00

unit-bjdata_round_trip_draft3.cpp

Split the slowest Valgrind tests out of unit-large_json and unit-bjdata (#5862)

2026-10-17 08:28:28 +02:00

unit-bjdata.cpp

Split the slowest Valgrind tests out of unit-large_json and unit-bjdata (#5862)

2026-10-17 08:28:28 +02:00

unit-bon8.cpp

Throw type_error.321 for discarded values in to_bon8 (#5802)

2026-10-11 08:22:00 +02:00

unit-brace-init-copy-semantics.cpp

Copy a pair-shaped array value under JSON_BRACE_INIT_COPY_SEMANTICS (#5701)

2026-10-07 07:39:05 +02:00

unit-bson.cpp

Use the with_*_t aliases in the remaining tests and docs (#5790)

2026-10-09 16:56:14 +02:00

unit-byte_container_with_subtype.cpp

Test suite: cover untested macro configs, std::formatter branches, patch_inplace, and fix a duplicate TEST_CASE name (#5492)

2026-09-16 20:15:46 +02:00

unit-capacity.cpp

Fix lint debt: enum-macro NOLINTs, doctest as SYSTEM, no-op analyzer (#5737)

2026-10-01 07:37:47 +02:00

unit-cbor.cpp

Move custom object key tests out of unit-cbor.cpp and unit-msgpack.cpp (#5798)

2026-10-10 00:05:02 +02:00

unit-class_const_iterator.cpp

Add tests for uncovered code paths (#5581)

2026-09-27 14:19:22 +02:00

unit-class_iterator.cpp

📄 adjust year (#5044)

2026-01-01 20:00:39 +01:00

unit-class_lexer.cpp

Speed up the lexer: own float parser, string scan, and \u table (#5738)

2026-10-14 17:38:36 +02:00

unit-class_parser.cpp

Use and extend the detail helpers to remove duplicated code (#5783)

2026-10-11 08:21:13 +02:00

unit-comparison.cpp

Make the value lifecycle inline-friendly (#5840)

2026-10-15 20:01:21 +02:00

unit-concepts.cpp

📄 adjust year (#5044)

2026-01-01 20:00:39 +01:00

unit-constructor1.cpp

Check the iterator range for binary values in basic_json(first, last) (#5719)

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

unit-constructor2.cpp

Fix CI failures on develop from the API performance stack (#5860)

2026-10-16 19:16:21 +02:00

unit-convenience.cpp

Stop dump() from heap-allocating its output adapter per call (#5449)

2026-09-11 08:22:50 +02:00

unit-conversions1.cpp

Fix CI on develop after merging the ready-to-merge PRs (#5754)

2026-10-04 17:18:19 +02:00

unit-conversions2.cpp

Fix CI on develop after #5600, #5607, and #5755 (#5764)

2026-10-06 07:22:55 +02:00

unit-custom-array-type.cpp

Use the with_*_t aliases in tests, examples, and docs (#5787)

2026-10-08 16:11:16 +02:00

unit-custom-base-class.cpp

Use the with_*_t aliases in the remaining tests and docs (#5790)

2026-10-09 16:56:14 +02:00

unit-custom-binary-type.cpp

Derive the lexer position lazily for seekable input (#5809)

2026-10-13 17:16:52 +02:00

unit-custom-key-type-c-str.cpp

Restore v3.12.0 support for custom object key types (#5795)

2026-10-11 08:24:31 +02:00

unit-custom-key-type-explicit.cpp

Restore v3.12.0 support for custom object key types (#5795)

2026-10-11 08:24:31 +02:00

unit-custom-key-type-full.cpp

Restore v3.12.0 support for custom object key types (#5795)

2026-10-11 08:24:31 +02:00

unit-custom-key-type-no-eq.cpp

Restore v3.12.0 support for custom object key types (#5795)

2026-10-11 08:24:31 +02:00

unit-custom-key-type-to-json.cpp

Restore v3.12.0 support for custom object key types (#5795)

2026-10-11 08:24:31 +02:00

unit-custom-object-key-type.cpp

Move custom object key tests out of unit-cbor.cpp and unit-msgpack.cpp (#5798)

2026-10-10 00:05:02 +02:00

unit-custom-object-type.cpp

Use the with_*_t aliases in tests, examples, and docs (#5787)

2026-10-08 16:11:16 +02:00

unit-delete_deprecated_functions.cpp

Fix CI on develop after #5600, #5607, and #5755 (#5764)

2026-10-06 07:22:55 +02:00

unit-deserialization.cpp

Skip the indentation after a newline 8 bytes at a time (#5810)

2026-10-13 17:16:52 +02:00

unit-diagnostic-positions.cpp

Fix stack overflow converting deep values between specializations (#5723)

2026-09-30 21:36:04 +02:00

unit-diagnostics-optimized.cpp

Fix CI on develop after #5585 (#5779)

2026-10-07 16:37:19 +02:00

unit-diagnostics.cpp

Fix CI failures on develop from the API performance stack (#5860)

2026-10-16 19:16:21 +02:00

unit-disable-tuple-reference-conversion.cpp

Add JSON_DISABLE_TUPLE_REFERENCE_CONVERSION to fix std::tuple conversions (#5598)

2026-09-30 20:53:56 +02:00

unit-disabled_exceptions.cpp

Fix CI on develop after merging the ready-to-merge PRs (#5754)

2026-10-04 17:18:19 +02:00

unit-element_access1.cpp

Throw std::length_error for operator[](SIZE_MAX) instead of corrupting the array (#5687)

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

unit-element_access2.cpp

Report one-character non-numeric array indices like longer ones (#5800)

2026-10-11 08:21:41 +02:00

unit-enum_keyed_maps_default.cpp

Store maps with enum keys as objects (opt-in) (#5600)

2026-10-04 17:54:05 +02:00

unit-enum_keyed_maps.cpp

Store maps with enum keys as objects (opt-in) (#5600)

2026-10-04 17:54:05 +02:00

unit-explicit_instantiation.cpp

Add BON8 support (#2998)

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

unit-format-as.cpp

Add std::format and fmt support (#5224)

2026-07-02 15:59:36 +02:00

unit-hash.cpp

Use the with_*_t aliases in tests, examples, and docs (#5787)

2026-10-08 16:11:16 +02:00

unit-inspection.cpp

📄 adjust year (#5044)

2026-01-01 20:00:39 +01:00

unit-items-cpp17.cpp

Reduce test-suite compile time: extract tiny per-standard test content; drop redundant legacy-comparison CI job (#5481)

2026-09-09 09:52:58 +02:00

unit-items.cpp

Add JSON_DELETE_DEPRECATED_FUNCTIONS to delete the deprecated functions (#5755)

2026-10-04 22:11:34 +02:00

unit-iterators1.cpp

Fix CI failures on develop from the API performance stack (#5860)

2026-10-16 19:16:21 +02:00

unit-iterators2.cpp

Remove test debt: dead guards, discarded results, and unreferenced files (#5732)

2026-10-01 07:33:07 +02:00

unit-iterators3.cpp

📄 adjust year (#5044)

2026-01-01 20:00:39 +01:00

unit-json_patch.cpp

Speed up container destruction, iterator access and diff() (#5835)

2026-10-15 20:01:22 +02:00

unit-json_pointer.cpp

Fix CI failures on develop from the API performance stack (#5860)

2026-10-16 19:16:21 +02:00

unit-json_view_builder.cpp

Follow the renames from the review of the view builder

2026-10-17 08:31:44 +02:00

unit-json_view_dump.cpp

Move the dump, comparison, and large-object tests to unit-json_view_dump.cpp

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

unit-json_view_edit.cpp

Keep a raw string with a backslash out of a CHECK (MSVC C2017)

2026-10-17 08:31:41 +02:00

unit-json_view_image.cpp

Add images of json_documents: save() and load()

2026-10-17 08:31:47 +02:00

unit-json_view_macros.cpp

Add json_document and json_view: node index, parser, and document

2026-10-17 08:30:27 +02:00

unit-json_view.cpp

Move the dump, comparison, and large-object tests to unit-json_view_dump.cpp

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

unit-large_json_binary_writers.cpp

Split the slowest Valgrind tests out of unit-large_json and unit-bjdata (#5862)

2026-10-17 08:28:28 +02:00

unit-large_json_conversions.cpp

Split the slowest Valgrind tests out of unit-large_json and unit-bjdata (#5862)

2026-10-17 08:28:28 +02:00

unit-large_json.cpp

Split the slowest Valgrind tests out of unit-large_json and unit-bjdata (#5862)

2026-10-17 08:28:28 +02:00

unit-locale-cpp.cpp

Speed up the lexer: own float parser, string scan, and \u table (#5738)

2026-10-14 17:38:36 +02:00

unit-merge_diff.cpp

support JSON Merge Patch (RFC 7396) diff creation (#4965)

2026-10-12 09:33:43 +02:00

unit-merge_patch.cpp

Fix lint debt: enum-macro NOLINTs, doctest as SYSTEM, no-op analyzer (#5737)

2026-10-01 07:37:47 +02:00

unit-meta.cpp

📄 adjust year (#5044)

2026-01-01 20:00:39 +01:00

unit-modifiers.cpp

Fix CI on develop after merging the ready-to-merge PRs (#5754)

2026-10-04 17:18:19 +02:00

unit-msgpack-cpp17.cpp

Reduce test suite runtime and run the Unicode tests everywhere (#5605)

2026-10-06 22:53:03 +02:00

unit-msgpack.cpp

Move custom object key tests out of unit-cbor.cpp and unit-msgpack.cpp (#5798)

2026-10-10 00:05:02 +02:00

unit-no_automatic_udls.cpp

Move the user-defined string literals to <nlohmann/json_literals.hpp> and add JSON_NO_AUTOMATIC_UDLS (#5610)

2026-09-30 20:08:17 +02:00

unit-no_io_and_user_exceptions.cpp

Test suite: cover untested macro configs, std::formatter branches, patch_inplace, and fix a duplicate TEST_CASE name (#5492)

2026-09-16 20:15:46 +02:00

unit-no-macro-leak.cpp

Undefine the four JSON_HEDLEY_* macros that leak after including json.hpp (#5475)

2026-09-09 09:48:17 +02:00

unit-no-mem-leak-on-adl-serialize.cpp

Test suite: cover untested macro configs, std::formatter branches, patch_inplace, and fix a duplicate TEST_CASE name (#5492)

2026-09-16 20:15:46 +02:00

unit-noexcept.cpp

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

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

unit-ordered_json2.cpp

Use the with_*_t aliases in the remaining tests and docs (#5790)

2026-10-09 16:56:14 +02:00

unit-ordered_json.cpp

Accept lvalues in ordered_map::emplace's value parameter (#5685)

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

unit-ordered_map.cpp

Fix CI on develop after merging the ready-to-merge PRs (#5754)

2026-10-04 17:18:19 +02:00

unit-pointer_access.cpp

Fix CI on develop (#5750)

2026-10-02 11:23:55 +02:00

unit-precise-stream-position.cpp

Fix lint debt: enum-macro NOLINTs, doctest as SYSTEM, no-op analyzer (#5737)

2026-10-01 07:37:47 +02:00

unit-readme.cpp

Remove test debt: dead guards, discarded results, and unreferenced files (#5732)

2026-10-01 07:33:07 +02:00

unit-reference_access.cpp

📄 adjust year (#5044)

2026-01-01 20:00:39 +01:00

unit-regression1.cpp

Use the with_*_t aliases in tests, examples, and docs (#5787)

2026-10-08 16:11:16 +02:00

unit-regression2.cpp

Use the with_*_t aliases in tests, examples, and docs (#5787)

2026-10-08 16:11:16 +02:00

unit-regression3.cpp

Derive the lexer position lazily for seekable input (#5809)

2026-10-13 17:16:52 +02:00

unit-same-number-types.cpp

Allow the same type for number_integer_t and number_unsigned_t (#5815)

2026-10-15 20:04:42 +02:00

unit-serialization.cpp

Fix CI failures on develop from the API performance stack (#5860)

2026-10-16 19:16:21 +02:00

unit-std-format.cpp

Add tests for uncovered code paths (#5581)

2026-09-27 14:19:22 +02:00

unit-testsuites.cpp

Fix CI failures on develop from the API performance stack (#5860)

2026-10-16 19:16:21 +02:00

unit-throw_messages.cpp

Fix CI failures on develop from the API performance stack (#5860)

2026-10-16 19:16:21 +02:00

unit-to_chars.cpp

Fix AppVeyor failures from the Zmij double writer (#5843)

2026-10-15 20:08:12 +02:00

unit-to_json-rvalue.cpp

Fix compiler warnings on develop from the API performance stack (#5858)

2026-10-15 22:42:46 +02:00

unit-type_traits.cpp

Remove dead metaprogramming and duplicated code in traits and pointers (#5728)

2026-10-04 11:50:42 +02:00

unit-ubjson.cpp

Stricter fuzzer checks and boundary-value tests for buffers (#5774)

2026-10-07 08:50:12 +02:00

unit-udl.cpp

📄 adjust year (#5044)

2026-01-01 20:00:39 +01:00

unit-udt_macro.cpp

Support zero-member types in NLOHMANN_DEFINE_TYPE_* macros (#4041) (#5272)

2026-09-25 20:44:30 +02:00

unit-udt.cpp

Add with_*_t alias templates to create basic_json types with changed template parameters (#5758)

2026-10-06 22:33:29 +02:00

unit-unicode.cpp

Add tests for error_handler_t::keep in dump() (#4555)

2026-10-07 19:17:57 +02:00

unit-user_defined_input.cpp

Fix lint debt: enum-macro NOLINTs, doctest as SYSTEM, no-op analyzer (#5737)

2026-10-01 07:37:47 +02:00

unit-windows_h.cpp

📄 adjust year (#5044)

2026-01-01 20:00:39 +01:00

unit-wstring.cpp

Fix CI on develop after merging the ready-to-merge PRs (#5754)

2026-10-04 17:18:19 +02:00

unit.cpp

Fix CI jobs that check less than they claim; move arm64 to GitHub (#5733)

2026-09-30 22:49:24 +02:00

value_in_range_of_test.hpp

Fix lint debt: enum-macro NOLINTs, doctest as SYSTEM, no-op analyzer (#5737)

2026-10-01 07:37:47 +02:00