Niels LohmannandGitHub fe0299545a 📝 Document cross-basic_json conversion limitation (#3425) (#5249) ...

When converting objects or strings between different basic_json specializations,
the target's object_t::key_type or string_t must be directly constructible from
the source's corresponding type. If this requirement is not met, the conversion
silently falls back to the array-conversion path, producing incorrect results.

This documents the limitation and provides references to issue #3425, which tracks
this behavior. The comment in unit-alt-string.cpp is clarified to reference the
known limitation with a link to the issue, and suggests the parse() workaround.

Fixes #3425 (documentation; full fix deferred pending type-trait redesign)

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

2026-07-09 06:44:51 +02:00

..

fuzzer-driver_afl.cpp

📄 adjust year (#5044)

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

fuzzer-parse_bjdata.cpp

📄 adjust year (#5044)

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

fuzzer-parse_bson.cpp

📄 adjust year (#5044)

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

fuzzer-parse_cbor.cpp

📄 adjust year (#5044)

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

fuzzer-parse_json.cpp

📄 adjust year (#5044)

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

fuzzer-parse_msgpack.cpp

📄 adjust year (#5044)

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

fuzzer-parse_ubjson.cpp

📄 adjust year (#5044)

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

make_test_data_available.hpp

📄 adjust year (#5044)

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

test_utils.hpp

📄 adjust year (#5044)

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

unit-32bit.cpp

📄 adjust year (#5044)

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

unit-algorithms.cpp

🔒 fix security findings (#5245)

2026-07-08 16:40:58 +02:00

unit-allocator.cpp

📄 adjust year (#5044)

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

unit-alt-string.cpp

📝 Document cross-basic_json conversion limitation (#3425) (#5249)

2026-07-09 06:44:51 +02:00

unit-assert_macro.cpp

📄 adjust year (#5044)

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

unit-binary_formats.cpp

📄 adjust year (#5044)

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

unit-bjdata.cpp

📄 adjust year (#5044)

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

unit-bson.cpp

📄 adjust year (#5044)

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

unit-byte_container_with_subtype.cpp

📄 adjust year (#5044)

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

unit-capacity.cpp

📄 adjust year (#5044)

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

unit-cbor.cpp

Read binary strings/blobs in bulk chunks with a memcpy fast path (#5233)

2026-07-05 19:26:02 +02:00

unit-class_const_iterator.cpp

📄 adjust year (#5044)

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

unit-class_iterator.cpp

📄 adjust year (#5044)

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

unit-class_lexer.cpp

📄 adjust year (#5044)

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

unit-class_parser_diagnostic_positions.cpp

📄 adjust year (#5044)

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

unit-class_parser.cpp

Reconstruct lexer diagnostics lazily for seekable input (#120) (#5234)

2026-07-05 10:42:48 +02:00

unit-comparison.cpp

📄 adjust year (#5044)

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

unit-concepts.cpp

📄 adjust year (#5044)

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

unit-constructor1.cpp

Reference tuple from json (#5016)

2026-01-23 08:14:55 +01:00

unit-constructor2.cpp

📄 adjust year (#5044)

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

unit-convenience.cpp

Replace snprintf with a branch-free writer for \uXXXX escapes (#5235)

2026-07-08 20:25:13 +02:00

unit-conversions.cpp

optional: use #if instead of #ifndef in test, fixes #3859 (#5183)

2026-05-18 22:34:13 +02:00

unit-custom-base-class.cpp

📄 adjust year (#5044)

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

unit-deserialization.cpp

📄 adjust year (#5044)

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

unit-diagnostic-positions-only.cpp

📄 adjust year (#5044)

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

unit-diagnostic-positions.cpp

🐛 avoid assertion in patch (#5222)

2026-07-01 06:47:24 +02:00

unit-diagnostics.cpp

Fix: update() parent pointers not updated after recursive merge with JSON_DIAGNOSTICS (#5187)

2026-05-22 14:14:11 +02:00

unit-disabled_exceptions.cpp

📄 adjust year (#5044)

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

unit-element_access1.cpp

📄 adjust year (#5044)

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

unit-element_access2.cpp

Extend value to arrays when using JSON pointers (#5223)

2026-07-02 06:35:35 +02:00

unit-format-as.cpp

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

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

unit-hash.cpp

📄 adjust year (#5044)

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

unit-inspection.cpp

📄 adjust year (#5044)

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

unit-items.cpp

📄 adjust year (#5044)

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

unit-iterators1.cpp

📄 adjust year (#5044)

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

unit-iterators2.cpp

📄 adjust year (#5044)

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

unit-iterators3.cpp

📄 adjust year (#5044)

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

unit-json_patch.cpp

🐛 avoid assertion in patch (#5222)

2026-07-01 06:47:24 +02:00

unit-json_pointer.cpp

Add front methods to json_pointers (implements #4889) (#5152)

2026-05-13 07:59:16 +02:00

unit-large_json.cpp

📄 adjust year (#5044)

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

unit-locale-cpp.cpp

📄 adjust year (#5044)

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

unit-merge_patch.cpp

📄 adjust year (#5044)

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

unit-meta.cpp

📄 adjust year (#5044)

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

unit-modifiers.cpp

📄 adjust year (#5044)

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

unit-msgpack.cpp

📄 adjust year (#5044)

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

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

📄 adjust year (#5044)

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

unit-noexcept.cpp

📄 adjust year (#5044)

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

unit-ordered_json.cpp

🚨 fix warning (#5169)

2026-05-14 15:39:18 +02:00

unit-ordered_map.cpp

Add missing overload to ordered_map::find (#5171)

2026-05-18 20:33:47 +02:00

unit-pointer_access.cpp

📄 adjust year (#5044)

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

unit-readme.cpp

📄 adjust year (#5044)

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

unit-reference_access.cpp

📄 adjust year (#5044)

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

unit-regression1.cpp

📄 adjust year (#5044)

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

unit-regression2.cpp

Fix ADL leak of nlohmann::detail through basic_json's default base class (#5238)

2026-07-06 12:47:24 +02:00

unit-serialization.cpp

Document number conversion (#5208)

2026-06-16 22:05:44 +02:00

unit-std-format.cpp

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

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

unit-testsuites.cpp

📄 adjust year (#5044)

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

unit-to_chars.cpp

📄 adjust year (#5044)

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

unit-type_traits.cpp

📄 adjust year (#5044)

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

unit-ubjson.cpp

📄 adjust year (#5044)

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

unit-udl.cpp

📄 adjust year (#5044)

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

unit-udt_macro.cpp

New macros for the named JSON convertor generation (#4563)

2026-05-16 10:04:22 +02:00

unit-udt.cpp

📄 adjust year (#5044)

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

unit-unicode1.cpp

📄 adjust year (#5044)

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

unit-unicode2.cpp

📄 adjust year (#5044)

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

unit-unicode3.cpp

📄 adjust year (#5044)

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

unit-unicode4.cpp

📄 adjust year (#5044)

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

unit-unicode5.cpp

📄 adjust year (#5044)

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

unit-user_defined_input.cpp

📄 adjust year (#5044)

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

unit-windows_h.cpp

📄 adjust year (#5044)

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

unit-wstring.cpp

📄 adjust year (#5044)

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

unit.cpp

📄 adjust year (#5044)

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