mirror of https://github.com/nlohmann/json.git synced 2026-09-29 22:10:47 +01:00

Files

T

Niels Lohmann 9adb510a0d Recover from parse errors when parse_error() returns true (#3989 )

The return value of json_sax::parse_error() was documented both as "must
return false" and as "whether the parsing should continue", and the code
just passed it on. For JSON text, parsing stopped anyway, but sax_parse()
could report success for invalid input. The binary readers read on after
the error, looping forever on a CBOR indefinite-length array without its
end.

Now false stops parsing, and true recovers from the error:

- JSON text is repaired with the smallest local edit (insert a missing
  ',' or ':', remove a stray token, keep the readable part of a broken
  string or number, null for a value that cannot be read, close the
  innermost container at a wrong closing bracket and all of them at the
  end of the input), and parsing continues. The SAX events stay balanced,
  every key is followed by exactly one value, and each token is reported
  at most once.
- The binary formats cannot resynchronize, so they stop, but complete
  the value read so far.

sax_parse() returns false after any error. parse(), accept(), and the
from_*() functions never recover and compile to the same code as before.

Supersedes #4522.

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

2026-09-27 20:16:42 +02:00

docset

Add BON8 support (#2998 )

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

mkdocs

Recover from parse errors when parse_error() returns true (#3989 )

2026-09-27 20:16:42 +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

Clean up and document project files (#4560 )

2025-01-17 06:53:35 +01: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.