amorfo77/json

0 Fork 0

mirror of https://github.com/nlohmann/json.git synced 2026-10-10 16:37:14 +00:00

Files

T

Niels Lohmann 7cbfd60e2d Point users to update(…, true), JSON Pointer defaults, and built-in std::optional

A code search of client code found many hand-written versions of
functionality the library already has: recursive object merges
(update(j, true) since 3.10.5), dotted-path getters (value() and
contains() with a JSON Pointer), get_or helpers (value() throws for a
member that is present but null), and adl_serializer specializations
for std::optional (supported since 3.12.0).

- modifying_values.md: describe both modes of update(), add a
  defaults + user settings recipe, and stop recommending Merge Patch
  for recursive merges.
- merge_patch.md: note that null deletes keys, so a merge patch is not
  a general deep merge; link update().
- default_value.md: add "Nested values" (value/contains with a JSON
  Pointer, building a pointer from a dotted path with operator/=) and
  a warning that null and mistyped members are not missing.
- value.md: note that a null member is converted, not replaced by the
  default.
- json_pointer.md: link value/contains/at with JSON Pointers.
- arbitrary_types.md: note that std::optional needs no serializer.

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

2026-10-10 16:55:34 +02:00

docset

Check the URL scheme before downloading in generate_docset.py (#5803 )

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

mkdocs

Point users to update(…, true), JSON Pointer defaults, and built-in std::optional

2026-10-10 16:55:34 +02:00

avatars.png

🔖 set version to 3.12.0 (#4727 )

2025-04-11 10:41:14 +02:00

json.gif

🔖 set version to 3.12.0 (#4727 )

2025-04-11 10:41:14 +02:00

Makefile

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

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

README.md

docs: improve clarity and formatting in documentation generation section (#5021 )

2025-12-03 00:15:27 +01:00

README.md

Documentation

Generate documentation

Note on documentation: The source files contain links to the online documentation at https://json.nlohmann.me.
This URL provides the most recent documentation and also applies to previous versions. Documentation for deprecated functions is not removed; instead, it is marked as deprecated.

If you want to view the documentation for a specific tag or commit hash, you can generate it locally as follows (example using tag v3.10.2):

git clone https://github.com/nlohmann/json.git
cd json
git checkout v3.10.2
make install_venv serve -C docs/mkdocs

Open http://127.0.0.1:8000/ in your browser. Replace any URL in the source code that points to https://json.nlohmann.me with http://127.0.0.1:8000 to view the documentation for the selected tag or commit hash.