amorfo77/json

0 Fork 0

mirror of https://github.com/nlohmann/json.git synced 2026-10-29 00:55:44 +00:00

Files

T

Niels Lohmann cf8b7c8b8d Document the contract of object keys passed to json_sax::key and key callbacks

Describe what the name passed to json_sax::key and to a parser callback
for parse_event_t::key holds when parsing JSON text: escapes are decoded
to UTF-8, different spellings of a name yield identical strings, the name
is validated before the call (invalid escapes or UTF-8 give a parse error
and no key event), no normalization or case conversion is applied, the
event precedes the ':' check, and duplicate names are reported once per
occurrence. Also note that sax_parse passes binary-format keys unchanged.

See discussion #5955.

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

2026-10-28 20:29:43 +01:00

docset

Fix Semgrep findings in Python tooling (#5899 )

2026-10-23 07:11:17 +02:00

mkdocs

Document the contract of object keys passed to json_sax::key and key callbacks

2026-10-28 20:29:43 +01: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

Clean up non-code files (#5801 )

2026-10-11 08:21:51 +02: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.12.0):

git clone https://github.com/nlohmann/json.git
cd json
git checkout v3.12.0
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.