From 1a90c9463aa5691b4a1fd5b746fedfbecebe57ff Mon Sep 17 00:00:00 2001
From: Florian Albrechtskirchinger <falbrechtskirchinger@gmail.com>
Date: Fri, 22 Apr 2022 14:21:16 +0200
Subject: [PATCH 01/30] Disable regression test for #3070 on GCC <8.4 (#3451)

---
 test/src/unit-regression2.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/test/src/unit-regression2.cpp b/test/src/unit-regression2.cpp
index 3ab9a2a2c..e034593ed 100644
--- a/test/src/unit-regression2.cpp
+++ b/test/src/unit-regression2.cpp
@@ -48,6 +48,7 @@ using ordered_json = nlohmann::ordered_json;
 #endif
 
 #if JSON_HAS_EXPERIMENTAL_FILESYSTEM
+// JSON_HAS_CPP_17 (magic keyword; do not remove)
 #include <experimental/filesystem>
 namespace nlohmann::detail
 {
@@ -61,7 +62,6 @@ namespace std_fs = std::filesystem;
 } // namespace nlohmann::detail
 #endif
 
-
 #ifdef JSON_HAS_CPP_20
     #include <span>
 #endif
@@ -793,8 +793,8 @@ TEST_CASE("regression tests 2")
         const auto j_path = j.get<nlohmann::detail::std_fs::path>();
         CHECK(j_path == text_path);
 
-#ifndef _MSC_VER
-        // works everywhere but on MSVC
+#if !defined(_MSC_VER) && !(defined(__GNUC__) && __GNUC__ == 8 && __GNUC_MINOR__ < 4)
+        // works everywhere but on MSVC and GCC <8.4
         CHECK_THROWS_WITH_AS(nlohmann::detail::std_fs::path(json(1)), "[json.exception.type_error.302] type must be string, but is number", json::type_error);
 #endif
     }

From fcc36f99ba1afc7baebe24e0c7429d2039d32d99 Mon Sep 17 00:00:00 2001
From: Niels Lohmann <mail@nlohmann.me>
Date: Sun, 24 Apr 2022 17:22:04 +0200
Subject: [PATCH 02/30] :arrow_up: cpplint 1.6.0 (#3454)

---
 third_party/cpplint/README.rst |  5 +----
 third_party/cpplint/cpplint.py | 20 ++++++++++++++------
 2 files changed, 15 insertions(+), 10 deletions(-)

diff --git a/third_party/cpplint/README.rst b/third_party/cpplint/README.rst
index 18af13c00..9ff67c0eb 100644
--- a/third_party/cpplint/README.rst
+++ b/third_party/cpplint/README.rst
@@ -1,9 +1,6 @@
 cpplint - static code checker for C++
 =====================================
 
-.. image:: https://travis-ci.org/cpplint/cpplint.svg?branch=master
-    :target: https://travis-ci.org/cpplint/cpplint
-
 .. image:: https://img.shields.io/pypi/v/cpplint.svg
     :target: https://pypi.python.org/pypi/cpplint
 
@@ -62,7 +59,7 @@ The modifications in this fork are minor fixes and cosmetic changes, such as:
 * python 3 compatibility
 * more default file extensions
 * customizable file extensions with the --extensions argument
-* continuous integration on travis
+* continuous integration on github
 * support for recursive file discovery via the --recursive argument
 * support for excluding files via --exclude
 * JUnit XML output format
diff --git a/third_party/cpplint/cpplint.py b/third_party/cpplint/cpplint.py
index 3bf3441a3..6b78b308c 100755
--- a/third_party/cpplint/cpplint.py
+++ b/third_party/cpplint/cpplint.py
@@ -41,6 +41,11 @@ We do a small hack, which is to ignore //'s with "'s after them on the
 same line, but it is far from perfect (in either direction).
 """
 
+# cpplint predates fstrings
+# pylint: disable=consider-using-f-string
+
+# pylint: disable=invalid-name
+
 import codecs
 import copy
 import getopt
@@ -59,7 +64,7 @@ import xml.etree.ElementTree
 # if empty, use defaults
 _valid_extensions = set([])
 
-__VERSION__ = '1.5.5'
+__VERSION__ = '1.6.0'
 
 try:
   xrange          # Python 2
@@ -1915,6 +1920,7 @@ class CleansedLines(object):
     self.raw_lines = lines
     self.num_lines = len(lines)
     self.lines_without_raw_strings = CleanseRawStrings(lines)
+    # # pylint: disable=consider-using-enumerate
     for linenum in range(len(self.lines_without_raw_strings)):
       self.lines.append(CleanseComments(
           self.lines_without_raw_strings[linenum]))
@@ -5068,10 +5074,12 @@ def CheckIncludeLine(filename, clean_lines, linenum, include_state, error):
   #
   # We also make an exception for Lua headers, which follow google
   # naming convention but not the include convention.
-  match = Match(r'#include\s*"([^/]+\.h)"', line)
-  if match and not _THIRD_PARTY_HEADERS_PATTERN.match(match.group(1)):
-    error(filename, linenum, 'build/include_subdir', 4,
-          'Include the directory when naming .h files')
+  match = Match(r'#include\s*"([^/]+\.(.*))"', line)
+  if match:
+    if (IsHeaderExtension(match.group(2)) and
+        not _THIRD_PARTY_HEADERS_PATTERN.match(match.group(1))):
+      error(filename, linenum, 'build/include_subdir', 4,
+            'Include the directory when naming header files')
 
   # we shouldn't include a file more than once. actually, there are a
   # handful of instances where doing so is okay, but in general it's
@@ -6523,7 +6531,7 @@ def ProcessConfigOverrides(filename):
       continue
 
     try:
-      with open(cfg_file) as file_handle:
+      with open(cfg_file, encoding='utf-8') as file_handle:
         for line in file_handle:
           line, _, _ = line.partition('#')  # Remove comments.
           if not line.strip():

From a6ee8bf9d94ef783f21f955d4125d5f3924d2c8e Mon Sep 17 00:00:00 2001
From: Niels Lohmann <mail@nlohmann.me>
Date: Mon, 25 Apr 2022 22:40:45 +0200
Subject: [PATCH 03/30] Overwork documentation (#3444)

* :memo: overwork macro documentation

* :memo: address review comments

* :wrench: add style check to Makefile

* :see_no_evil: overwork .gitignore

* :pushpin: Pygments 2.12.0 is broken

* :pencil2: fix links

* :children_crossing: adjust output to cppcheck

* :memo: add titles to more admonitions

* :pencil2: fix typos

* :memo: document future behavior change
---
 .gitignore                                    |  25 +-
 README.md                                     |  16 +-
 ...lohmann_define_type_intrusive_explicit.cpp |  59 +++++
 ...mann_define_type_intrusive_explicit.output |   2 +
 .../nlohmann_define_type_intrusive_macro.cpp  |  47 ++++
 ...lohmann_define_type_intrusive_macro.output |   2 +
 ...e_type_intrusive_with_default_explicit.cpp |  54 +++++
 ...ype_intrusive_with_default_explicit.output |   2 +
 ...fine_type_intrusive_with_default_macro.cpp |  41 ++++
 ...e_type_intrusive_with_default_macro.output |   2 +
 ...ann_define_type_non_intrusive_explicit.cpp |  52 +++++
 ..._define_type_non_intrusive_explicit.output |   2 +
 ...ohmann_define_type_non_intrusive_macro.cpp |  40 ++++
 ...ann_define_type_non_intrusive_macro.output |   2 +
 ...pe_non_intrusive_with_default_explicit.cpp |  52 +++++
 ...non_intrusive_with_default_explicit.output |   2 +
 ..._type_non_intrusive_with_default_macro.cpp |  39 ++++
 ...pe_non_intrusive_with_default_macro.output |   2 +
 doc/examples/nlohmann_json_serialize_enum.cpp |  59 +++++
 .../nlohmann_json_serialize_enum.output       |   3 +
 .../nlohmann_json_serialize_enum_2.cpp        |  33 +++
 .../nlohmann_json_serialize_enum_2.output     |   3 +
 doc/mkdocs/Makefile                           |  19 +-
 doc/mkdocs/docs/api/basic_json/back.md        |   4 +-
 doc/mkdocs/docs/api/basic_json/basic_json.md  |  10 +-
 doc/mkdocs/docs/api/basic_json/front.md       |   4 +-
 doc/mkdocs/docs/api/basic_json/get.md         |   2 +-
 doc/mkdocs/docs/api/basic_json/get_ptr.md     |   2 +-
 doc/mkdocs/docs/api/basic_json/get_ref.md     |   4 +-
 doc/mkdocs/docs/api/basic_json/index.md       |   2 +-
 .../docs/api/basic_json/is_discarded.md       |   4 +-
 doc/mkdocs/docs/api/basic_json/items.md       |   2 +-
 doc/mkdocs/docs/api/basic_json/meta.md        |   4 +
 .../api/basic_json/object_comparator_t.md     |   2 +-
 doc/mkdocs/docs/api/basic_json/operator[].md  |   5 +-
 .../docs/api/basic_json/operator_ValueType.md |  47 ++--
 doc/mkdocs/docs/api/basic_json/value.md       |   2 +-
 doc/mkdocs/docs/api/json_pointer/index.md     |  12 +-
 doc/mkdocs/docs/api/macros/index.md           |  49 ++--
 doc/mkdocs/docs/api/macros/json_assert.md     |  81 ++++++-
 .../docs/api/macros/json_diagnostics.md       |  67 ++++++
 doc/mkdocs/docs/api/macros/json_has_cpp_11.md |  28 +++
 .../docs/api/macros/json_has_filesystem.md    |  30 +++
 doc/mkdocs/docs/api/macros/json_no_io.md      |  21 ++
 .../docs/api/macros/json_noexception.md       |  32 +++
 .../macros/json_skip_library_version_check.md |  37 +++
 .../json_skip_unsupported_compiler_check.md   |  20 ++
 doc/mkdocs/docs/api/macros/json_throw_user.md |  75 ++++++
 .../macros/json_use_implicit_conversions.md   |  56 +++++
 .../macros/nlohmann_define_type_intrusive.md  | 124 ++++++++++
 .../nlohmann_define_type_non_intrusive.md     | 124 ++++++++++
 .../macros/nlohmann_json_serialize_enum.md    |  84 +++++++
 .../api/macros/nlohmann_json_version_major.md |  23 ++
 doc/mkdocs/docs/features/arbitrary_types.md   |  17 +-
 doc/mkdocs/docs/features/assertions.md        | 104 +++++++++
 .../element_access/unchecked_access.md        |  12 +-
 doc/mkdocs/docs/features/enum_conversion.md   |  11 +-
 doc/mkdocs/docs/features/macros.md            | 220 +++---------------
 .../docs/features/types/number_handling.md    |   2 +-
 doc/mkdocs/docs/home/exceptions.md            |   7 +-
 doc/mkdocs/mkdocs.yml                         |  27 ++-
 doc/mkdocs/requirements.txt                   |  77 +++---
 doc/mkdocs/scripts/check_structure.py         |  63 +++--
 63 files changed, 1689 insertions(+), 366 deletions(-)
 create mode 100644 doc/examples/nlohmann_define_type_intrusive_explicit.cpp
 create mode 100644 doc/examples/nlohmann_define_type_intrusive_explicit.output
 create mode 100644 doc/examples/nlohmann_define_type_intrusive_macro.cpp
 create mode 100644 doc/examples/nlohmann_define_type_intrusive_macro.output
 create mode 100644 doc/examples/nlohmann_define_type_intrusive_with_default_explicit.cpp
 create mode 100644 doc/examples/nlohmann_define_type_intrusive_with_default_explicit.output
 create mode 100644 doc/examples/nlohmann_define_type_intrusive_with_default_macro.cpp
 create mode 100644 doc/examples/nlohmann_define_type_intrusive_with_default_macro.output
 create mode 100644 doc/examples/nlohmann_define_type_non_intrusive_explicit.cpp
 create mode 100644 doc/examples/nlohmann_define_type_non_intrusive_explicit.output
 create mode 100644 doc/examples/nlohmann_define_type_non_intrusive_macro.cpp
 create mode 100644 doc/examples/nlohmann_define_type_non_intrusive_macro.output
 create mode 100644 doc/examples/nlohmann_define_type_non_intrusive_with_default_explicit.cpp
 create mode 100644 doc/examples/nlohmann_define_type_non_intrusive_with_default_explicit.output
 create mode 100644 doc/examples/nlohmann_define_type_non_intrusive_with_default_macro.cpp
 create mode 100644 doc/examples/nlohmann_define_type_non_intrusive_with_default_macro.output
 create mode 100644 doc/examples/nlohmann_json_serialize_enum.cpp
 create mode 100644 doc/examples/nlohmann_json_serialize_enum.output
 create mode 100644 doc/examples/nlohmann_json_serialize_enum_2.cpp
 create mode 100644 doc/examples/nlohmann_json_serialize_enum_2.output
 create mode 100644 doc/mkdocs/docs/api/macros/json_diagnostics.md
 create mode 100644 doc/mkdocs/docs/api/macros/json_has_cpp_11.md
 create mode 100644 doc/mkdocs/docs/api/macros/json_has_filesystem.md
 create mode 100644 doc/mkdocs/docs/api/macros/json_no_io.md
 create mode 100644 doc/mkdocs/docs/api/macros/json_noexception.md
 create mode 100644 doc/mkdocs/docs/api/macros/json_skip_library_version_check.md
 create mode 100644 doc/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md
 create mode 100644 doc/mkdocs/docs/api/macros/json_throw_user.md
 create mode 100644 doc/mkdocs/docs/api/macros/json_use_implicit_conversions.md
 create mode 100644 doc/mkdocs/docs/api/macros/nlohmann_define_type_intrusive.md
 create mode 100644 doc/mkdocs/docs/api/macros/nlohmann_define_type_non_intrusive.md
 create mode 100644 doc/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md
 create mode 100644 doc/mkdocs/docs/api/macros/nlohmann_json_version_major.md
 create mode 100644 doc/mkdocs/docs/features/assertions.md
 mode change 100644 => 100755 doc/mkdocs/scripts/check_structure.py

diff --git a/.gitignore b/.gitignore
index a13ad89a5..e4f92117b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,32 +1,21 @@
-json_unit
-json_benchmarks
-json_benchmarks_simple
-fuzz-testing
-
 *.dSYM
 *.o
 *.gcno
 *.gcda
-
-build
-build_coverage
-clang_analyze_build
-
-benchmarks/files/numbers/*.json
+.DS_Store
 
 .wsjcpp-logs/*
 .wsjcpp/*
 
-.idea
+/.idea
 /cmake-build-*
 
-test/test-*
 /.vs
 
-doc/html
-doc/mkdocs/venv/
-doc/mkdocs/docs/examples
-doc/mkdocs/site
-doc/mkdocs/docs/__pycache__/
+/doc/mkdocs/docs/examples/
+/doc/mkdocs/docs/__pycache__/
+/doc/mkdocs/site/
+/doc/mkdocs/venv/
 /doc/docset/JSON_for_Modern_C++.docset/
 /doc/docset/JSON_for_Modern_C++.tgz
+/doc/mkdocs/docs/images/json.gif
diff --git a/README.md b/README.md
index 9d9bd2c91..20e7c48ea 100644
--- a/README.md
+++ b/README.md
@@ -93,7 +93,7 @@ There is also a [**docset**](https://github.com/Kapeli/Dash-User-Contributions/t
 
 ## Examples
 
-Beside the examples below, you may want to check the [documentation](https://nlohmann.github.io/json/) where each function contains a separate code example (e.g., check out [`emplace()`](https://nlohmann.github.io/json/api/basic_json/emplace/)). All [example files](https://github.com/nlohmann/json/tree/develop/doc/examples) can be compiled and executed on their own (e.g., file [emplace.cpp](https://github.com/nlohmann/json/blob/develop/doc/examples/emplace.cpp)).
+Beside the examples below, you may want to check the [documentation](https://json.nlohmann.me/) where each function contains a separate code example (e.g., check out [`emplace()`](https://json.nlohmann.me/api/basic_json/emplace/)). All [example files](https://github.com/nlohmann/json/tree/develop/doc/examples) can be compiled and executed on their own (e.g., file [emplace.cpp](https://github.com/nlohmann/json/blob/develop/doc/examples/emplace.cpp)).
 
 ### JSON as first-class data type
 
@@ -162,7 +162,7 @@ json j2 = {
 };
 ```
 
-Note that in all these cases, you never need to "tell" the compiler which JSON value type you want to use. If you want to be explicit or express some edge cases, the functions [`json::array()`](https://nlohmann.github.io/json/api/basic_json/array/) and [`json::object()`](https://nlohmann.github.io/json/api/basic_json/object/) will help:
+Note that in all these cases, you never need to "tell" the compiler which JSON value type you want to use. If you want to be explicit or express some edge cases, the functions [`json::array()`](https://json.nlohmann.me/api/basic_json/array/) and [`json::object()`](https://json.nlohmann.me/api/basic_json/object/) will help:
 
 ```cpp
 // a way to express the empty array []
@@ -197,7 +197,7 @@ auto j2 = R"(
 
 Note that without appending the `_json` suffix, the passed string literal is not parsed, but just used as JSON string value. That is, `json j = "{ \"happy\": true, \"pi\": 3.141 }"` would just store the string `"{ "happy": true, "pi": 3.141 }"` rather than parsing the actual object.
 
-The above example can also be expressed explicitly using [`json::parse()`](https://nlohmann.github.io/json/api/basic_json/parse/):
+The above example can also be expressed explicitly using [`json::parse()`](https://json.nlohmann.me/api/basic_json/parse/):
 
 ```cpp
 // parse explicitly
@@ -240,9 +240,9 @@ std::cout << cpp_string << " == " << cpp_string2 << " == " << j_string.get<std::
 std::cout << j_string << " == " << serialized_string << std::endl;
 ```
 
-[`.dump()`](https://nlohmann.github.io/json/api/basic_json/dump/) returns the originally stored string value.
+[`.dump()`](https://json.nlohmann.me/api/basic_json/dump/) returns the originally stored string value.
 
-Note the library only supports UTF-8. When you store strings with different encodings in the library, calling [`dump()`](https://nlohmann.github.io/json/api/basic_json/dump/) may throw an exception unless `json::error_handler_t::replace` or `json::error_handler_t::ignore` are used as error handlers.
+Note the library only supports UTF-8. When you store strings with different encodings in the library, calling [`dump()`](https://json.nlohmann.me/api/basic_json/dump/) may throw an exception unless `json::error_handler_t::replace` or `json::error_handler_t::ignore` are used as error handlers.
 
 #### To/from streams (e.g. files, string streams)
 
@@ -730,7 +730,7 @@ Some important things:
 * Those methods **MUST** be in your type's namespace (which can be the global namespace), or the library will not be able to locate them (in this example, they are in namespace `ns`, where `person` is defined).
 * Those methods **MUST** be available (e.g., proper headers must be included) everywhere you use these conversions. Look at [issue 1108](https://github.com/nlohmann/json/issues/1108) for errors that may occur otherwise.
 * When using `get<your_type>()`, `your_type` **MUST** be [DefaultConstructible](https://en.cppreference.com/w/cpp/named_req/DefaultConstructible). (There is a way to bypass this requirement described later.)
-* In function `from_json`, use function [`at()`](https://nlohmann.github.io/json/api/basic_json/at/) to access the object values rather than `operator[]`. In case a key does not exist, `at` throws an exception that you can handle, whereas `operator[]` exhibits undefined behavior.
+* In function `from_json`, use function [`at()`](https://json.nlohmann.me/api/basic_json/at/) to access the object values rather than `operator[]`. In case a key does not exist, `at` throws an exception that you can handle, whereas `operator[]` exhibits undefined behavior.
 * You do not need to add serializers or deserializers for STL types like `std::vector`: the library already implements these.
 
 #### Simplify your life with macros
@@ -1647,7 +1647,7 @@ The library supports **Unicode input** as follows:
 - [Unicode noncharacters](https://www.unicode.org/faq/private_use.html#nonchar1) will not be replaced by the library.
 - Invalid surrogates (e.g., incomplete pairs such as `\uDEAD`) will yield parse errors.
 - The strings stored in the library are UTF-8 encoded. When using the default string type (`std::string`), note that its length/size functions return the number of stored bytes rather than the number of characters or glyphs.
-- When you store strings with different encodings in the library, calling [`dump()`](https://nlohmann.github.io/json/api/basic_json/dump/) may throw an exception unless `json::error_handler_t::replace` or `json::error_handler_t::ignore` are used as error handlers.
+- When you store strings with different encodings in the library, calling [`dump()`](https://json.nlohmann.me/api/basic_json/dump/) may throw an exception unless `json::error_handler_t::replace` or `json::error_handler_t::ignore` are used as error handlers.
 - To store wide strings (e.g., `std::wstring`), you need to convert them to a UTF-8 encoded `std::string` before, see [an example](https://json.nlohmann.me/home/faq/#wide-string-handling).
 
 ### Comments in JSON
@@ -1682,7 +1682,7 @@ Here is a related issue [#1924](https://github.com/nlohmann/json/issues/1924).
 
 ### Further notes
 
-- The code contains numerous debug **assertions** which can be switched off by defining the preprocessor macro `NDEBUG`, see the [documentation of `assert`](https://en.cppreference.com/w/cpp/error/assert). In particular, note [`operator[]`](https://nlohmann.github.io/json/api/basic_json/operator%5B%5D/) implements **unchecked access** for const objects: If the given key is not present, the behavior is undefined (think of a dereferenced null pointer) and yields an [assertion failure](https://github.com/nlohmann/json/issues/289) if assertions are switched on. If you are not sure whether an element in an object exists, use checked access with the [`at()` function](https://nlohmann.github.io/json/api/basic_json/at/). Furthermore, you can define `JSON_ASSERT(x)` to replace calls to `assert(x)`.
+- The code contains numerous debug **assertions** which can be switched off by defining the preprocessor macro `NDEBUG`, see the [documentation of `assert`](https://en.cppreference.com/w/cpp/error/assert). In particular, note [`operator[]`](https://json.nlohmann.me/api/basic_json/operator%5B%5D/) implements **unchecked access** for const objects: If the given key is not present, the behavior is undefined (think of a dereferenced null pointer) and yields an [assertion failure](https://github.com/nlohmann/json/issues/289) if assertions are switched on. If you are not sure whether an element in an object exists, use checked access with the [`at()` function](https://json.nlohmann.me/api/basic_json/at/). Furthermore, you can define `JSON_ASSERT(x)` to replace calls to `assert(x)`.
 - As the exact number type is not defined in the [JSON specification](https://tools.ietf.org/html/rfc8259.html), this library tries to choose the best fitting C++ number type automatically. As a result, the type `double` may be used to store numbers which may yield [**floating-point exceptions**](https://github.com/nlohmann/json/issues/181) in certain rare situations if floating-point exceptions have been unmasked in the calling code. These exceptions are not caused by the library and need to be fixed in the calling code, such as by re-masking the exceptions prior to calling library functions.
 - The code can be compiled without C++ **runtime type identification** features; that is, you can use the `-fno-rtti` compiler flag.
 - **Exceptions** are used widely within the library. They can, however, be switched off with either using the compiler flag `-fno-exceptions` or by defining the symbol `JSON_NOEXCEPTION`. In this case, exceptions are replaced by `abort()` calls. You can further control this behavior by defining `JSON_THROW_USER` (overriding `throw`), `JSON_TRY_USER` (overriding `try`), and `JSON_CATCH_USER` (overriding `catch`). Note that `JSON_THROW_USER` should leave the current scope (e.g., by throwing or aborting), as continuing after it may yield undefined behavior. Note the explanatory [`what()`](https://en.cppreference.com/w/cpp/error/exception/what) string of exceptions is not available for MSVC if exceptions are disabled, see [#2824](https://github.com/nlohmann/json/discussions/2824).
diff --git a/doc/examples/nlohmann_define_type_intrusive_explicit.cpp b/doc/examples/nlohmann_define_type_intrusive_explicit.cpp
new file mode 100644
index 000000000..fb7701dec
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_intrusive_explicit.cpp
@@ -0,0 +1,59 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+namespace ns
+{
+class person
+{
+  private:
+    std::string name = "John Doe";
+    std::string address = "123 Fake St";
+    int age = -1;
+
+  public:
+    person() = default;
+    person(std::string name_, std::string address_, int age_)
+        : name(std::move(name_)), address(std::move(address_)), age(age_)
+    {}
+
+    friend void to_json(nlohmann::json& nlohmann_json_j, const person& nlohmann_json_t)
+    {
+        nlohmann_json_j["name"] = nlohmann_json_t.name;
+        nlohmann_json_j["address"] = nlohmann_json_t.address;
+        nlohmann_json_j["age"] = nlohmann_json_t.age;
+    }
+
+    friend void from_json(const nlohmann::json& nlohmann_json_j, person& nlohmann_json_t)
+    {
+        nlohmann_json_t.name = nlohmann_json_j.at("name");
+        nlohmann_json_t.address = nlohmann_json_j.at("address");
+        nlohmann_json_t.age = nlohmann_json_j.at("age");
+    }
+};
+} // namespace ns
+
+int main()
+{
+    ns::person p = {"Ned Flanders", "744 Evergreen Terrace", 60};
+
+    // serialization: person -> json
+    json j = p;
+    std::cout << "serialization: " << j << std::endl;
+
+    // deserialization: json -> person
+    json j2 = R"({"address": "742 Evergreen Terrace", "age": 40, "name": "Homer Simpson"})"_json;
+    auto p2 = j2.get<ns::person>();
+
+    // incomplete deserialization:
+    json j3 = R"({"address": "742 Evergreen Terrace", "name": "Maggie Simpson"})"_json;
+    try
+    {
+        auto p3 = j3.get<ns::person>();
+    }
+    catch (json::exception& e)
+    {
+        std::cout << "deserialization failed: " << e.what() << std::endl;
+    }
+}
diff --git a/doc/examples/nlohmann_define_type_intrusive_explicit.output b/doc/examples/nlohmann_define_type_intrusive_explicit.output
new file mode 100644
index 000000000..37f4eb414
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_intrusive_explicit.output
@@ -0,0 +1,2 @@
+serialization: {"address":"744 Evergreen Terrace","age":60,"name":"Ned Flanders"}
+deserialization failed: [json.exception.out_of_range.403] key 'age' not found
diff --git a/doc/examples/nlohmann_define_type_intrusive_macro.cpp b/doc/examples/nlohmann_define_type_intrusive_macro.cpp
new file mode 100644
index 000000000..ce292659a
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_intrusive_macro.cpp
@@ -0,0 +1,47 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+namespace ns
+{
+class person
+{
+  private:
+    std::string name = "John Doe";
+    std::string address = "123 Fake St";
+    int age = -1;
+
+  public:
+    person() = default;
+    person(std::string name_, std::string address_, int age_)
+        : name(std::move(name_)), address(std::move(address_)), age(age_)
+    {}
+
+    NLOHMANN_DEFINE_TYPE_INTRUSIVE(person, name, address, age)
+};
+} // namespace ns
+
+int main()
+{
+    ns::person p = {"Ned Flanders", "744 Evergreen Terrace", 60};
+
+    // serialization: person -> json
+    json j = p;
+    std::cout << "serialization: " << j << std::endl;
+
+    // deserialization: json -> person
+    json j2 = R"({"address": "742 Evergreen Terrace", "age": 40, "name": "Homer Simpson"})"_json;
+    auto p2 = j2.get<ns::person>();
+
+    // incomplete deserialization:
+    json j3 = R"({"address": "742 Evergreen Terrace", "name": "Maggie Simpson"})"_json;
+    try
+    {
+        auto p3 = j3.get<ns::person>();
+    }
+    catch (json::exception& e)
+    {
+        std::cout << "deserialization failed: " << e.what() << std::endl;
+    }
+}
diff --git a/doc/examples/nlohmann_define_type_intrusive_macro.output b/doc/examples/nlohmann_define_type_intrusive_macro.output
new file mode 100644
index 000000000..37f4eb414
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_intrusive_macro.output
@@ -0,0 +1,2 @@
+serialization: {"address":"744 Evergreen Terrace","age":60,"name":"Ned Flanders"}
+deserialization failed: [json.exception.out_of_range.403] key 'age' not found
diff --git a/doc/examples/nlohmann_define_type_intrusive_with_default_explicit.cpp b/doc/examples/nlohmann_define_type_intrusive_with_default_explicit.cpp
new file mode 100644
index 000000000..621ed1452
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_intrusive_with_default_explicit.cpp
@@ -0,0 +1,54 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+namespace ns
+{
+class person
+{
+  private:
+    std::string name = "John Doe";
+    std::string address = "123 Fake St";
+    int age = -1;
+
+  public:
+    person() = default;
+    person(std::string name_, std::string address_, int age_)
+        : name(std::move(name_)), address(std::move(address_)), age(age_)
+    {}
+
+    friend void to_json(nlohmann::json& nlohmann_json_j, const person& nlohmann_json_t)
+    {
+        nlohmann_json_j["name"] = nlohmann_json_t.name;
+        nlohmann_json_j["address"] = nlohmann_json_t.address;
+        nlohmann_json_j["age"] = nlohmann_json_t.age;
+    }
+
+    friend void from_json(const nlohmann::json& nlohmann_json_j, person& nlohmann_json_t)
+    {
+        person nlohmann_json_default_obj;
+        nlohmann_json_t.name = nlohmann_json_j.value("name", nlohmann_json_default_obj.name);
+        nlohmann_json_t.address = nlohmann_json_j.value("address", nlohmann_json_default_obj.address);
+        nlohmann_json_t.age = nlohmann_json_j.value("age", nlohmann_json_default_obj.age);
+    }
+};
+} // namespace ns
+
+int main()
+{
+    ns::person p = {"Ned Flanders", "744 Evergreen Terrace", 60};
+
+    // serialization: person -> json
+    json j = p;
+    std::cout << "serialization: " << j << std::endl;
+
+    // deserialization: json -> person
+    json j2 = R"({"address": "742 Evergreen Terrace", "age": 40, "name": "Homer Simpson"})"_json;
+    auto p2 = j2.get<ns::person>();
+
+    // incomplete deserialization:
+    json j3 = R"({"address": "742 Evergreen Terrace", "name": "Maggie Simpson"})"_json;
+    auto p3 = j3.get<ns::person>();
+    std::cout << "roundtrip: " << json(p3) << std::endl;
+}
diff --git a/doc/examples/nlohmann_define_type_intrusive_with_default_explicit.output b/doc/examples/nlohmann_define_type_intrusive_with_default_explicit.output
new file mode 100644
index 000000000..1a255f65c
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_intrusive_with_default_explicit.output
@@ -0,0 +1,2 @@
+serialization: {"address":"744 Evergreen Terrace","age":60,"name":"Ned Flanders"}
+roundtrip: {"address":"742 Evergreen Terrace","age":-1,"name":"Maggie Simpson"}
diff --git a/doc/examples/nlohmann_define_type_intrusive_with_default_macro.cpp b/doc/examples/nlohmann_define_type_intrusive_with_default_macro.cpp
new file mode 100644
index 000000000..7851f526e
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_intrusive_with_default_macro.cpp
@@ -0,0 +1,41 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+namespace ns
+{
+class person
+{
+  private:
+    std::string name = "John Doe";
+    std::string address = "123 Fake St";
+    int age = -1;
+
+  public:
+    person() = default;
+    person(std::string name_, std::string address_, int age_)
+        : name(std::move(name_)), address(std::move(address_)), age(age_)
+    {}
+
+    NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT(person, name, address, age)
+};
+} // namespace ns
+
+int main()
+{
+    ns::person p = {"Ned Flanders", "744 Evergreen Terrace", 60};
+
+    // serialization: person -> json
+    json j = p;
+    std::cout << "serialization: " << j << std::endl;
+
+    // deserialization: json -> person
+    json j2 = R"({"address": "742 Evergreen Terrace", "age": 40, "name": "Homer Simpson"})"_json;
+    auto p2 = j2.get<ns::person>();
+
+    // incomplete deserialization:
+    json j3 = R"({"address": "742 Evergreen Terrace", "name": "Maggie Simpson"})"_json;
+    auto p3 = j3.get<ns::person>();
+    std::cout << "roundtrip: " << json(p3) << std::endl;
+}
diff --git a/doc/examples/nlohmann_define_type_intrusive_with_default_macro.output b/doc/examples/nlohmann_define_type_intrusive_with_default_macro.output
new file mode 100644
index 000000000..1a255f65c
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_intrusive_with_default_macro.output
@@ -0,0 +1,2 @@
+serialization: {"address":"744 Evergreen Terrace","age":60,"name":"Ned Flanders"}
+roundtrip: {"address":"742 Evergreen Terrace","age":-1,"name":"Maggie Simpson"}
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_explicit.cpp b/doc/examples/nlohmann_define_type_non_intrusive_explicit.cpp
new file mode 100644
index 000000000..b9d30dd8f
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_non_intrusive_explicit.cpp
@@ -0,0 +1,52 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+namespace ns
+{
+struct person
+{
+    std::string name;
+    std::string address;
+    int age;
+};
+
+void to_json(nlohmann::json& nlohmann_json_j, const person& nlohmann_json_t)
+{
+    nlohmann_json_j["name"] = nlohmann_json_t.name;
+    nlohmann_json_j["address"] = nlohmann_json_t.address;
+    nlohmann_json_j["age"] = nlohmann_json_t.age;
+}
+
+void from_json(const nlohmann::json& nlohmann_json_j, person& nlohmann_json_t)
+{
+    nlohmann_json_t.name = nlohmann_json_j.at("name");
+    nlohmann_json_t.address = nlohmann_json_j.at("address");
+    nlohmann_json_t.age = nlohmann_json_j.at("age");
+}
+} // namespace ns
+
+int main()
+{
+    ns::person p = {"Ned Flanders", "744 Evergreen Terrace", 60};
+
+    // serialization: person -> json
+    json j = p;
+    std::cout << "serialization: " << j << std::endl;
+
+    // deserialization: json -> person
+    json j2 = R"({"address": "742 Evergreen Terrace", "age": 40, "name": "Homer Simpson"})"_json;
+    auto p2 = j2.get<ns::person>();
+
+    // incomplete deserialization:
+    json j3 = R"({"address": "742 Evergreen Terrace", "name": "Maggie Simpson"})"_json;
+    try
+    {
+        auto p3 = j3.get<ns::person>();
+    }
+    catch (json::exception& e)
+    {
+        std::cout << "deserialization failed: " << e.what() << std::endl;
+    }
+}
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_explicit.output b/doc/examples/nlohmann_define_type_non_intrusive_explicit.output
new file mode 100644
index 000000000..37f4eb414
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_non_intrusive_explicit.output
@@ -0,0 +1,2 @@
+serialization: {"address":"744 Evergreen Terrace","age":60,"name":"Ned Flanders"}
+deserialization failed: [json.exception.out_of_range.403] key 'age' not found
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_macro.cpp b/doc/examples/nlohmann_define_type_non_intrusive_macro.cpp
new file mode 100644
index 000000000..b073ef615
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_non_intrusive_macro.cpp
@@ -0,0 +1,40 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+namespace ns
+{
+struct person
+{
+    std::string name;
+    std::string address;
+    int age;
+};
+
+NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(person, name, address, age)
+} // namespace ns
+
+int main()
+{
+    ns::person p = {"Ned Flanders", "744 Evergreen Terrace", 60};
+
+    // serialization: person -> json
+    json j = p;
+    std::cout << "serialization: " << j << std::endl;
+
+    // deserialization: json -> person
+    json j2 = R"({"address": "742 Evergreen Terrace", "age": 40, "name": "Homer Simpson"})"_json;
+    auto p2 = j2.get<ns::person>();
+
+    // incomplete deserialization:
+    json j3 = R"({"address": "742 Evergreen Terrace", "name": "Maggie Simpson"})"_json;
+    try
+    {
+        auto p3 = j3.get<ns::person>();
+    }
+    catch (json::exception& e)
+    {
+        std::cout << "deserialization failed: " << e.what() << std::endl;
+    }
+}
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_macro.output b/doc/examples/nlohmann_define_type_non_intrusive_macro.output
new file mode 100644
index 000000000..37f4eb414
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_non_intrusive_macro.output
@@ -0,0 +1,2 @@
+serialization: {"address":"744 Evergreen Terrace","age":60,"name":"Ned Flanders"}
+deserialization failed: [json.exception.out_of_range.403] key 'age' not found
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_with_default_explicit.cpp b/doc/examples/nlohmann_define_type_non_intrusive_with_default_explicit.cpp
new file mode 100644
index 000000000..21967b638
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_non_intrusive_with_default_explicit.cpp
@@ -0,0 +1,52 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+namespace ns
+{
+struct person
+{
+    std::string name = "John Doe";
+    std::string address = "123 Fake St";
+    int age = -1;
+
+    person() = default;
+    person(std::string name_, std::string address_, int age_)
+        : name(std::move(name_)), address(std::move(address_)), age(age_)
+    {}
+};
+
+void to_json(nlohmann::json& nlohmann_json_j, const person& nlohmann_json_t)
+{
+    nlohmann_json_j["name"] = nlohmann_json_t.name;
+    nlohmann_json_j["address"] = nlohmann_json_t.address;
+    nlohmann_json_j["age"] = nlohmann_json_t.age;
+}
+
+void from_json(const nlohmann::json& nlohmann_json_j, person& nlohmann_json_t)
+{
+    person nlohmann_json_default_obj;
+    nlohmann_json_t.name = nlohmann_json_j.value("name", nlohmann_json_default_obj.name);
+    nlohmann_json_t.address = nlohmann_json_j.value("address", nlohmann_json_default_obj.address);
+    nlohmann_json_t.age = nlohmann_json_j.value("age", nlohmann_json_default_obj.age);
+}
+} // namespace ns
+
+int main()
+{
+    ns::person p = {"Ned Flanders", "744 Evergreen Terrace", 60};
+
+    // serialization: person -> json
+    json j = p;
+    std::cout << "serialization: " << j << std::endl;
+
+    // deserialization: json -> person
+    json j2 = R"({"address": "742 Evergreen Terrace", "age": 40, "name": "Homer Simpson"})"_json;
+    auto p2 = j2.get<ns::person>();
+
+    // incomplete deserialization:
+    json j3 = R"({"address": "742 Evergreen Terrace", "name": "Maggie Simpson"})"_json;
+    auto p3 = j3.get<ns::person>();
+    std::cout << "roundtrip: " << json(p3) << std::endl;
+}
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_with_default_explicit.output b/doc/examples/nlohmann_define_type_non_intrusive_with_default_explicit.output
new file mode 100644
index 000000000..1a255f65c
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_non_intrusive_with_default_explicit.output
@@ -0,0 +1,2 @@
+serialization: {"address":"744 Evergreen Terrace","age":60,"name":"Ned Flanders"}
+roundtrip: {"address":"742 Evergreen Terrace","age":-1,"name":"Maggie Simpson"}
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_with_default_macro.cpp b/doc/examples/nlohmann_define_type_non_intrusive_with_default_macro.cpp
new file mode 100644
index 000000000..470fed69c
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_non_intrusive_with_default_macro.cpp
@@ -0,0 +1,39 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+namespace ns
+{
+struct person
+{
+    std::string name = "John Doe";
+    std::string address = "123 Fake St";
+    int age = -1;
+
+    person() = default;
+    person(std::string name_, std::string address_, int age_)
+        : name(std::move(name_)), address(std::move(address_)), age(age_)
+    {}
+};
+
+NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT(person, name, address, age)
+} // namespace ns
+
+int main()
+{
+    ns::person p = {"Ned Flanders", "744 Evergreen Terrace", 60};
+
+    // serialization: person -> json
+    json j = p;
+    std::cout << "serialization: " << j << std::endl;
+
+    // deserialization: json -> person
+    json j2 = R"({"address": "742 Evergreen Terrace", "age": 40, "name": "Homer Simpson"})"_json;
+    auto p2 = j2.get<ns::person>();
+
+    // incomplete deserialization:
+    json j3 = R"({"address": "742 Evergreen Terrace", "name": "Maggie Simpson"})"_json;
+    auto p3 = j3.get<ns::person>();
+    std::cout << "roundtrip: " << json(p3) << std::endl;
+}
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_with_default_macro.output b/doc/examples/nlohmann_define_type_non_intrusive_with_default_macro.output
new file mode 100644
index 000000000..1a255f65c
--- /dev/null
+++ b/doc/examples/nlohmann_define_type_non_intrusive_with_default_macro.output
@@ -0,0 +1,2 @@
+serialization: {"address":"744 Evergreen Terrace","age":60,"name":"Ned Flanders"}
+roundtrip: {"address":"742 Evergreen Terrace","age":-1,"name":"Maggie Simpson"}
diff --git a/doc/examples/nlohmann_json_serialize_enum.cpp b/doc/examples/nlohmann_json_serialize_enum.cpp
new file mode 100644
index 000000000..f9e472c64
--- /dev/null
+++ b/doc/examples/nlohmann_json_serialize_enum.cpp
@@ -0,0 +1,59 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+namespace ns
+{
+enum TaskState
+{
+    TS_STOPPED,
+    TS_RUNNING,
+    TS_COMPLETED,
+    TS_INVALID = -1
+};
+
+NLOHMANN_JSON_SERIALIZE_ENUM(TaskState,
+{
+    { TS_INVALID, nullptr },
+    { TS_STOPPED, "stopped" },
+    { TS_RUNNING, "running" },
+    { TS_COMPLETED, "completed" }
+})
+
+enum class Color
+{
+    red, green, blue, unknown
+};
+
+NLOHMANN_JSON_SERIALIZE_ENUM(Color,
+{
+    { Color::unknown, "unknown" }, { Color::red, "red" },
+    { Color::green, "green" }, { Color::blue, "blue" }
+})
+} // namespace ns
+
+int main()
+{
+    // serialization
+    json j_stopped = ns::TS_STOPPED;
+    json j_red = ns::Color::red;
+    std::cout << "ns::TS_STOPPED -> " << j_stopped
+              << ", ns::Color::red -> " << j_red << std::endl;
+
+    // deserialization
+    json j_running = "running";
+    json j_blue = "blue";
+    auto running = j_running.get<ns::TaskState>();
+    auto blue = j_blue.get<ns::Color>();
+    std::cout << j_running << " -> " << running
+              << ", " << j_blue << " -> " << static_cast<int>(blue) << std::endl;
+
+    // deserializing undefined JSON value to enum
+    // (where the first map entry above is the default)
+    json j_pi = 3.14;
+    auto invalid = j_pi.get<ns::TaskState>();
+    auto unknown = j_pi.get<ns::Color>();
+    std::cout << j_pi << " -> " << invalid << ", "
+              << j_pi << " -> " << static_cast<int>(unknown) << std::endl;
+}
diff --git a/doc/examples/nlohmann_json_serialize_enum.output b/doc/examples/nlohmann_json_serialize_enum.output
new file mode 100644
index 000000000..f512563dd
--- /dev/null
+++ b/doc/examples/nlohmann_json_serialize_enum.output
@@ -0,0 +1,3 @@
+ns::TS_STOPPED -> "stopped", ns::Color::red -> "red"
+"running" -> 1, "blue" -> 2
+3.14 -> -1, 3.14 -> 3
diff --git a/doc/examples/nlohmann_json_serialize_enum_2.cpp b/doc/examples/nlohmann_json_serialize_enum_2.cpp
new file mode 100644
index 000000000..fd27226ca
--- /dev/null
+++ b/doc/examples/nlohmann_json_serialize_enum_2.cpp
@@ -0,0 +1,33 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+namespace ns
+{
+enum class Color
+{
+    red, green, blue, unknown
+};
+
+NLOHMANN_JSON_SERIALIZE_ENUM(Color,
+{
+    { Color::unknown, "unknown" }, { Color::red, "red" },
+    { Color::green, "green" }, { Color::blue, "blue" },
+    { Color::red, "rot" } // a second conversion for Color::red
+})
+}
+
+int main()
+{
+    // serialization
+    json j_red = ns::Color::red;
+    std::cout << static_cast<int>(ns::Color::red) << " -> " << j_red << std::endl;
+
+    // deserialization
+    json j_rot = "rot";
+    auto rot = j_rot.get<ns::Color>();
+    auto red = j_red.get<ns::Color>();
+    std::cout << j_rot << " -> " << static_cast<int>(rot) << std::endl;
+    std::cout << j_red << " -> " << static_cast<int>(red) << std::endl;
+}
diff --git a/doc/examples/nlohmann_json_serialize_enum_2.output b/doc/examples/nlohmann_json_serialize_enum_2.output
new file mode 100644
index 000000000..5dec31b4a
--- /dev/null
+++ b/doc/examples/nlohmann_json_serialize_enum_2.output
@@ -0,0 +1,3 @@
+0 -> "red"
+"rot" -> 0
+"red" -> 0
diff --git a/doc/mkdocs/Makefile b/doc/mkdocs/Makefile
index 3d3d5e7c6..3f894d098 100644
--- a/doc/mkdocs/Makefile
+++ b/doc/mkdocs/Makefile
@@ -1,18 +1,21 @@
 # serve the site locally
-serve: prepare_files
+serve: prepare_files style_check
 	venv/bin/mkdocs serve
 
-build: prepare_files
+serve_dirty: prepare_files style_check
+	venv/bin/mkdocs serve --dirtyreload
+
+build: prepare_files style_check
 	venv/bin/mkdocs build
 
-# create files that are not versioned inside the mkdocs folder
+# create files that are not versioned inside the mkdocs folder (images, examples)
 prepare_files: clean
-	# create subfolders
 	mkdir docs/examples
-	# copy images
-	cp -vr ../json.gif docs/images
-	# copy examples
-	cp -vr ../examples/*.cpp ../examples/*.output docs/examples
+	cp -r ../json.gif docs/images
+	cp -r ../examples/*.cpp ../examples/*.output docs/examples
+
+style_check:
+	@cd docs ; python3 ../scripts/check_structure.py
 
 # clean subfolders
 clean:
diff --git a/doc/mkdocs/docs/api/basic_json/back.md b/doc/mkdocs/docs/api/basic_json/back.md
index 96e1dec75..1a715284d 100644
--- a/doc/mkdocs/docs/api/basic_json/back.md
+++ b/doc/mkdocs/docs/api/basic_json/back.md
@@ -35,9 +35,9 @@ Constant.
 
 ## Notes
 
-!!! danger
+!!! info "Precondition"
 
-    Calling `back` on an empty array or object is undefined behavior and is **guarded by an assertion**!
+    The array or object must not be empty. Calling `back` on an empty array or object yields undefined behavior.
 
 ## Examples
 
diff --git a/doc/mkdocs/docs/api/basic_json/basic_json.md b/doc/mkdocs/docs/api/basic_json/basic_json.md
index ab3fea470..afa3901d1 100644
--- a/doc/mkdocs/docs/api/basic_json/basic_json.md
+++ b/doc/mkdocs/docs/api/basic_json/basic_json.md
@@ -250,17 +250,15 @@ basic_json(basic_json&& other) noexcept;
 
     !!! info "Preconditions"
 
-        - Iterators `first` and `last` must be initialized. **This precondition is enforced with an assertion (see
-          warning).** If assertions are switched off, a violation of this precondition yields undefined behavior.
+        - Iterators `first` and `last` must be initialized. **This precondition is enforced with a
+          [runtime assertion](../../features/assertions.md).
         - Range `[first, last)` is valid. Usually, this precondition cannot be checked efficiently. Only certain edge
           cases are detected; see the description of the exceptions above. A violation of this precondition yields
           undefined behavior.
     
-    !!! warning
+    !!! danger "Runtime assertion"
 
-        A precondition is enforced with a runtime assertion that will result in calling `std::abort` if this
-        precondition is not met. Assertions can be disabled by defining `NDEBUG` at compile time. See
-        <https://en.cppreference.com/w/cpp/error/assert> for more information.
+        A precondition is enforced with a [runtime assertion](../../features/assertions.md).
     
 - Overload 8:
 
diff --git a/doc/mkdocs/docs/api/basic_json/front.md b/doc/mkdocs/docs/api/basic_json/front.md
index 909f0b59b..e258c36a0 100644
--- a/doc/mkdocs/docs/api/basic_json/front.md
+++ b/doc/mkdocs/docs/api/basic_json/front.md
@@ -28,9 +28,9 @@ Constant.
 
 ## Notes
 
-!!! danger
+!!! info "Precondition"
 
-    Calling `front` on an empty array or object is undefined behavior and is **guarded by an assertion**!
+    The array or object must not be empty. Calling `front` on an empty array or object yields undefined behavior.
 
 ## Examples
 
diff --git a/doc/mkdocs/docs/api/basic_json/get.md b/doc/mkdocs/docs/api/basic_json/get.md
index 0a0bc3bab..96fc221da 100644
--- a/doc/mkdocs/docs/api/basic_json/get.md
+++ b/doc/mkdocs/docs/api/basic_json/get.md
@@ -90,7 +90,7 @@ Depends on what `json_serializer<ValueType>` `from_json()` method throws
 
 ## Notes
 
-!!! warning
+!!! danger "Undefined behavior"
 
     Writing data to the pointee (overload 3) of the result yields an undefined state.
 
diff --git a/doc/mkdocs/docs/api/basic_json/get_ptr.md b/doc/mkdocs/docs/api/basic_json/get_ptr.md
index 72517cd7e..2441e1156 100644
--- a/doc/mkdocs/docs/api/basic_json/get_ptr.md
+++ b/doc/mkdocs/docs/api/basic_json/get_ptr.md
@@ -33,7 +33,7 @@ Constant.
 
 ## Notes
 
-!!! warning
+!!! danger "Undefined behavior"
 
     Writing data to the pointee of the result yields an undefined state.
 
diff --git a/doc/mkdocs/docs/api/basic_json/get_ref.md b/doc/mkdocs/docs/api/basic_json/get_ref.md
index 1140836e4..b1219742c 100644
--- a/doc/mkdocs/docs/api/basic_json/get_ref.md
+++ b/doc/mkdocs/docs/api/basic_json/get_ref.md
@@ -16,7 +16,7 @@ Implicit reference access to the internally stored JSON value. No copies are mad
 :   reference type; must be a reference to [`array_t`](array_t.md), [`object_t`](object_t.md),
     [`string_t`](string_t.md), [`boolean_t`](boolean_t.md), [`number_integer_t`](number_integer_t.md), or
     [`number_unsigned_t`](number_unsigned_t.md), [`number_float_t`](number_float_t.md), or [`binary_t`](binary_t.md).
-    Enforced by static assertion.
+    Enforced by a static assertion.
 
 ## Return value
 
@@ -38,7 +38,7 @@ Constant.
 
 ## Notes
 
-!!! warning
+!!! danger "Undefined behavior"
 
     Writing data to the referee of the result yields an undefined state.
 
diff --git a/doc/mkdocs/docs/api/basic_json/index.md b/doc/mkdocs/docs/api/basic_json/index.md
index f8828dbd8..286fea2b4 100644
--- a/doc/mkdocs/docs/api/basic_json/index.md
+++ b/doc/mkdocs/docs/api/basic_json/index.md
@@ -292,7 +292,7 @@ Access to the JSON value
 - [**std::hash&lt;basic_json&gt;**](std_hash.md) - return a hash value for a JSON object
 - [**std::swap&lt;basic_json&gt;**](std_swap.md) - exchanges the values of two JSON objects
 
-## Example
+## Examples
 
 ??? example
 
diff --git a/doc/mkdocs/docs/api/basic_json/is_discarded.md b/doc/mkdocs/docs/api/basic_json/is_discarded.md
index 6de31c937..663cbf889 100644
--- a/doc/mkdocs/docs/api/basic_json/is_discarded.md
+++ b/doc/mkdocs/docs/api/basic_json/is_discarded.md
@@ -24,7 +24,7 @@ Constant.
 
 ## Notes
 
-!!! note
+!!! note "Comparisons"
 
     Discarded values are never compared equal with [`operator==`](operator_eq.md). That is, checking whether a JSON
     value `j` is discarded will only work via:
@@ -41,7 +41,7 @@ Constant.
     
     will always be `#!cpp false`.
 
-!!! note
+!!! note "Removal during parsing with callback functions"
 
     When a value is discarded by a callback function (see [`parser_callback_t`](parser_callback_t.md)) during parsing,
     then it is removed when it is part of a structured value. For instance, if the second value of an array is discarded,
diff --git a/doc/mkdocs/docs/api/basic_json/items.md b/doc/mkdocs/docs/api/basic_json/items.md
index b388824f9..0b34ddcba 100644
--- a/doc/mkdocs/docs/api/basic_json/items.md
+++ b/doc/mkdocs/docs/api/basic_json/items.md
@@ -63,7 +63,7 @@ Constant.
 When iterating over an array, `key()` will return the index of the element as string (see example). For primitive types
 (e.g., numbers), `key()` returns an empty string.
 
-!!! warning
+!!! danger "Lifetime issues"
 
     Using `items()` on temporary objects is dangerous. Make sure the object's lifetime exceeds the iteration. See
     <https://github.com/nlohmann/json/issues/2040> for more information.
diff --git a/doc/mkdocs/docs/api/basic_json/meta.md b/doc/mkdocs/docs/api/basic_json/meta.md
index e2b312e0c..87767e4d5 100644
--- a/doc/mkdocs/docs/api/basic_json/meta.md
+++ b/doc/mkdocs/docs/api/basic_json/meta.md
@@ -45,6 +45,10 @@ Constant.
     --8<-- "examples/meta.output"
     ```
 
+## See also
+
+- [**NLOHMANN_JSON_VERSION_MAJOR**/**NLOHMANN_JSON_VERSION_MINOR**/**NLOHMANN_JSON_VERSION_PATCH**](../macros/nlohmann_json_version_major.md) - library version information
+
 ## Version history
 
 - Added in version 2.1.0.
diff --git a/doc/mkdocs/docs/api/basic_json/object_comparator_t.md b/doc/mkdocs/docs/api/basic_json/object_comparator_t.md
index 44509a94b..e2bc79d05 100644
--- a/doc/mkdocs/docs/api/basic_json/object_comparator_t.md
+++ b/doc/mkdocs/docs/api/basic_json/object_comparator_t.md
@@ -8,7 +8,7 @@ using object_comparator_t = std::less<>;            // since C++14
 
 The comparator used in [`object_t`](object_t.md).
 
-When C++14 is detected, a transparent com parator is used which, when combined with perfect forwarding on find() and
+When C++14 is detected, a transparent comparator is used which, when combined with perfect forwarding on find() and
 count() calls, prevents unnecessary string construction.
 
 ## Version history
diff --git a/doc/mkdocs/docs/api/basic_json/operator[].md b/doc/mkdocs/docs/api/basic_json/operator[].md
index 5b6512a21..cc9eae7f3 100644
--- a/doc/mkdocs/docs/api/basic_json/operator[].md
+++ b/doc/mkdocs/docs/api/basic_json/operator[].md
@@ -74,10 +74,11 @@ Strong exception safety: if an exception occurs, the original value stays intact
 
 ## Notes
 
-!!! danger
+!!! danger "Undefined behavior and runtime assertions"
 
     1. If the element with key `idx` does not exist, the behavior is undefined.
-    2. If the element with key `key` does not exist, the behavior is undefined and is **guarded by an assertion**!
+    2. If the element with key `key` does not exist, the behavior is undefined and is **guarded by a
+       [runtime assertion](../../features/assertions.md)**!
 
 1. The non-const version may add values: If `idx` is beyond the range of the array (i.e., `idx >= size()`), then the
    array is silently filled up with `#!json null` values to make `idx` a valid reference to the last stored element. In
diff --git a/doc/mkdocs/docs/api/basic_json/operator_ValueType.md b/doc/mkdocs/docs/api/basic_json/operator_ValueType.md
index 1eec13553..787588781 100644
--- a/doc/mkdocs/docs/api/basic_json/operator_ValueType.md
+++ b/doc/mkdocs/docs/api/basic_json/operator_ValueType.md
@@ -27,33 +27,44 @@ Linear in the size of the JSON value.
 
 ## Notes
 
-By default `JSON_EXPLICIT` defined to the empty string, so the signature is:
+!!! note "Definition of `JSON_EXPLICIT`"
 
-```cpp
-template<typename ValueType>
-operator ValueType() const;
-```
+    By default `JSON_EXPLICIT` is defined to the empty string, so the signature is:
+    
+    ```cpp
+    template<typename ValueType>
+    operator ValueType() const;
+    ```
+    
+    If [`JSON_USE_IMPLICIT_CONVERSIONS`](../macros/json_use_implicit_conversions.md) is set to `0`,
+    `JSON_EXPLICIT` is defined to `#!cpp explicit`:
 
-If [`JSON_USE_IMPLICIT_CONVERSIONS`](../../features/macros.md#json_use_implicit_conversions) is set to `0`,
-`JSON_EXPLICIT` is defined to `#!cpp explicit`:
+    ```cpp
+    template<typename ValueType>
+    explicit operator ValueType() const;
+    ```
+    
+    That is, implicit conversions can be switched off by defining
+    [`JSON_USE_IMPLICIT_CONVERSIONS`](../macros/json_use_implicit_conversions.md) to `0`.
 
-```cpp
-template<typename ValueType>
-explicit operator ValueType() const;
-```
+!!! info "Future behavior change"
+
+    Implicit conversions will be switched off by default in the next major release of the library. That is,
+    `JSON_EXPLICIT` will be set to `#!cpp explicit` by default.
+
+    You can prepare existing code by already defining
+    [`JSON_USE_IMPLICIT_CONVERSIONS`](../macros/json_use_implicit_conversions.md) to `0` and replace any implicit
+    conversions with calls to [`get`](../basic_json/get.md).
 
-That is, implicit conversions can be switched off by defining
-[`JSON_USE_IMPLICIT_CONVERSIONS`](../../features/macros.md#json_use_implicit_conversions) to `0`.
 
 ## Examples
 
 ??? example
 
-    The example below shows several conversions from JSON values
-    to other types. There a few things to note: (1) Floating-point numbers can
-    be converted to integers, (2) A JSON array can be converted to a standard
-    `std::vector<short>`, (3) A JSON object can be converted to C++
-    associative containers such as `std::unordered_map<std::string, json>`.
+    The example below shows several conversions from JSON values to other types. There are a few things to note: (1)
+    Floating-point numbers can be converted to integers, (2) A JSON array can be converted to a standard
+    `std::vector<short>`, (3) A JSON object can be converted to C++ associative containers such as
+    `std::unordered_map<std::string, json>`.
         
     ```cpp
     --8<-- "examples/operator__ValueType.cpp"
diff --git a/doc/mkdocs/docs/api/basic_json/value.md b/doc/mkdocs/docs/api/basic_json/value.md
index 0b4f1cc19..1844c41fb 100644
--- a/doc/mkdocs/docs/api/basic_json/value.md
+++ b/doc/mkdocs/docs/api/basic_json/value.md
@@ -36,7 +36,7 @@ ValueType value(const json_pointer& ptr,
     }
     ```
 
-!!! note
+!!! note "Differences to `at` and `operator[]`"
 
     - Unlike [`at`](at.md), this function does not throw if the given `key`/`ptr` was not found.
     - Unlike [`operator[]`](operator[].md), this function does not implicitly add an element to the position defined by
diff --git a/doc/mkdocs/docs/api/json_pointer/index.md b/doc/mkdocs/docs/api/json_pointer/index.md
index 3504c9ff7..dca9c382c 100644
--- a/doc/mkdocs/docs/api/json_pointer/index.md
+++ b/doc/mkdocs/docs/api/json_pointer/index.md
@@ -16,7 +16,13 @@ are the base for JSON patches.
 
 ## Notes
 
-For backwards compatibility `RefStringType` may also be a specialization of [`basic_json`](../basic_json/index.md) in which case `string_t` will be deduced as [`basic_json::string_t`](../basic_json/string_t.md). This feature is deprecated and may be removed in a future major version.
+For backwards compatibility `RefStringType` may also be a specialization of [`basic_json`](../basic_json/index.md) in
+which case `string_t` will be deduced as [`basic_json::string_t`](../basic_json/string_t.md). This feature is deprecated
+and may be removed in a future major version.
+
+## Member types
+
+- [**string_t**](string_t.md) - the string type used for the reference tokens
 
 ## Member functions
 
@@ -31,10 +37,6 @@ For backwards compatibility `RefStringType` may also be a specialization of [`ba
 - [**push_back**](push_back.md) - append an unescaped token at the end of the pointer
 - [**empty**](empty.md) - return whether pointer points to the root document
 
-## Member types
-
-- [**string_t**](string_t.md) - the string type used for the reference tokens
-
 ## See also
 
 - [operator""_json_pointer](../basic_json/operator_literal_json_pointer.md) - user-defined string literal for JSON pointers
diff --git a/doc/mkdocs/docs/api/macros/index.md b/doc/mkdocs/docs/api/macros/index.md
index 4c723c6a6..56924da44 100644
--- a/doc/mkdocs/docs/api/macros/index.md
+++ b/doc/mkdocs/docs/api/macros/index.md
@@ -1,22 +1,37 @@
 # Macros
 
-!!! note
+Some aspects of the library can be configured by defining preprocessor macros **before** including the `json.hpp`
+header. See also the [macro overview page](../../features/macros.md).
 
-    This page is under construction. See the [macro overview page](../../features/macros.md) until then.
+## Runtime assertions
 
-Some aspects of the library can be configured by defining preprocessor macros before including the `json.hpp` header.
+- [**JSON_ASSERT(x)**](json_assert.md) - control behavior of runtime assertions
 
-- [`JSON_ASSERT(x)`](json_assert.md)
-- `JSON_CATCH_USER(exception)`
-- `JSON_DIAGNOSTICS`
-- `JSON_HAS_CPP_11`, `JSON_HAS_CPP_14`, `JSON_HAS_CPP_17`, `JSON_HAS_CPP_20`
-- `JSON_NOEXCEPTION`
-- `JSON_NO_IO`
-- `JSON_SKIP_UNSUPPORTED_COMPILER_CHECK`
-- `JSON_THROW_USER(exception)`
-- `JSON_TRY_USER`
-- `JSON_USE_IMPLICIT_CONVERSIONS`
-- `NLOHMANN_DEFINE_TYPE_INTRUSIVE(type, member...)`
-- `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(type, member...)`
-- `NLOHMANN_JSON_SERIALIZE_ENUM(type, ...)`
-- `NLOHMANN_JSON_VERSION_MAJOR`, `NLOHMANN_JSON_VERSION_MINOR`, `NLOHMANN_JSON_VERSION_PATCH`
+## Exceptions
+
+- [**JSON_CATCH_USER(exception)**<br>**JSON_THROW_USER(exception)**<br>**JSON_TRY_USER**](json_throw_user.md) - control exceptions
+- [**JSON_DIAGNOSTICS**](json_diagnostics.md) - control extended diagnostics
+- [**JSON_NOEXCEPTION**](json_noexception.md) - switch off exceptions
+
+## Language support
+
+- [**JSON_HAS_CPP_11**<br>**JSON_HAS_CPP_14**<br>**JSON_HAS_CPP_17**<br>**JSON_HAS_CPP_20**](json_has_cpp_11.md) - set supported C++ standard
+- [**JSON_HAS_FILESYSTEM**<br>**JSON_HAS_EXPERIMENTAL_FILESYSTEM**](json_has_filesystem.md) - control `std::filesystem` support
+- [**JSON_NO_IO**](json_no_io.md) - switch off functions relying on certain C++ I/O headers
+- [**JSON_SKIP_UNSUPPORTED_COMPILER_CHECK**](json_skip_unsupported_compiler_check.md) - do not warn about unsupported compilers
+
+## Library version
+
+- [**JSON_SKIP_LIBRARY_VERSION_CHECK**](json_skip_library_version_check.md) - skip library version check
+- [**NLOHMANN_JSON_VERSION_MAJOR**<br>**NLOHMANN_JSON_VERSION_MINOR**<br>**NLOHMANN_JSON_VERSION_PATCH**](nlohmann_json_version_major.md) - library version information
+
+## Type conversions
+
+- [**JSON_USE_IMPLICIT_CONVERSIONS**](json_use_implicit_conversions.md) - control implicit conversions
+
+## Serialization/deserialization macros
+
+- [**NLOHMANN_DEFINE_TYPE_INTRUSIVE(type, member...)**<br>**NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT(type, member...)**](nlohmann_define_type_intrusive.md) - serialization/deserialization of types _with_ access to private variables
+- [**NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(type, member...)**<br>**NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT(type, member...)**](nlohmann_define_type_non_intrusive.md) - serialization/deserialization of types _without_ access to private variables
+- [**NLOHMANN_JSON_SERIALIZE_ENUM(type, ...)**](nlohmann_json_serialize_enum.md) - serialization/deserialization of enum
+  types
diff --git a/doc/mkdocs/docs/api/macros/json_assert.md b/doc/mkdocs/docs/api/macros/json_assert.md
index 63d4ae076..a093341a1 100644
--- a/doc/mkdocs/docs/api/macros/json_assert.md
+++ b/doc/mkdocs/docs/api/macros/json_assert.md
@@ -1,11 +1,84 @@
-# JSON_ASSERT(x)
+# JSON_ASSERT
 
 ```cpp
-JSON_ASSERT(x)
+#define JSON_ASSERT(x) /* value */
 ```
 
-## Default implementation
+This macro controls which code is executed for [runtime assertions](../../features/assertions.md) of the library.
+
+## Parameters
+
+`x` (in)
+:   expression of scalar type
+
+## Default definition
+
+The default value is [`#!cpp assert(x)`](https://en.cppreference.com/w/cpp/error/assert).
 
 ```cpp
-assert(x);
+#define JSON_ASSERT(x) assert(x)
 ```
+
+Therefore, assertions can be switched off by defining `NDEBUG`.
+
+## Notes
+
+- The library uses numerous assertions to guarantee invariants and to abort in case of otherwise undefined behavior
+  (e.g., when calling [operator[]](../basic_json/operator%5B%5D.md) with a missing object key on a `const` object). See
+  page [runtime assertions](../../features/assertions.md) for more information.
+- Defining the macro to code that does not call `std::abort` may leave the library in an undefined state.
+- The macro is undefined outside the library.
+
+## Examples
+
+??? example "Example 1: default behavior"
+
+    The following code will trigger an assertion at runtime:
+
+    ```cpp
+    #include <nlohmann/json.hpp>
+    
+    using json = nlohmann::json;
+    
+    int main()
+    {
+        const json j = {{"key", "value"}};
+        auto v = j["missing"];
+    }
+    ```
+
+    Output:
+
+    ```
+    Assertion failed: (m_value.object->find(key) != m_value.object->end()), function operator[], file json.hpp, line 2144.
+    ```
+
+??? example "Example 2: user-defined behavior"
+
+    The assertion reporting can be changed by defining `JSON_ASSERT(x)` differently.
+
+    ```cpp
+    #include <cstdio>
+    #include <cstdlib>
+    #define JSON_ASSERT(x) if(!(x)){fprintf(stderr, "assertion error in %s\n", __FUNCTION__); std::abort();}
+    
+    #include <nlohmann/json.hpp>
+    
+    using json = nlohmann::json;
+    
+    int main()
+    {
+        const json j = {{"key", "value"}};
+        auto v = j["missing"];
+    }
+    ```
+
+    Output:
+
+    ```
+    assertion error in operator[]
+    ```
+
+## Version history
+
+- Added in version 3.9.0.
diff --git a/doc/mkdocs/docs/api/macros/json_diagnostics.md b/doc/mkdocs/docs/api/macros/json_diagnostics.md
new file mode 100644
index 000000000..d42025092
--- /dev/null
+++ b/doc/mkdocs/docs/api/macros/json_diagnostics.md
@@ -0,0 +1,67 @@
+# JSON_DIAGNOSTICS
+
+```cpp
+#define JSON_DIAGNOSTICS /* value */
+```
+
+This macro enables [extended diagnostics for exception messages](../../home/exceptions.md#extended-diagnostic-messages).
+Possible values are `1` to enable or `0` to disable (default).
+
+When enabled, exception messages contain a [JSON Pointer](../json_pointer/json_pointer.md) to the JSON value that
+triggered the exception. Note that enabling this macro increases the size of every JSON value by one pointer and adds
+some  runtime overhead.
+
+The diagnostics messages can also be controlled with the CMake option `JSON_Diagnostics` (`OFF` by default) which sets
+`JSON_DIAGNOSTICS` accordingly.
+
+## Default definition
+
+The default value is `0` (extended diagnostics are switched off).
+
+```cpp
+#define JSON_DIAGNOSTICS 0
+```
+
+When the macro is not defined, the library will define it to its default value.
+
+## Notes
+
+!!! danger "ABI incompatibility"
+
+    As this macro changes the definition of the `basic_json` object, it MUST be defined in the same way globally, even
+    across different compilation units: `basic_json` objects with differently defined `JSON_DIAGNOSTICS` macros are
+    not compatible!
+
+## Examples
+
+??? example "Example 1: default behavior"
+
+    ```cpp
+    --8<-- "examples/diagnostics_standard.cpp"
+    ```
+    
+    Output:
+
+    ```
+    --8<-- "examples/diagnostics_standard.output"
+    ```
+
+    This exception can be hard to debug if storing the value `#!c "12"` and accessing it is further apart.
+
+??? example "Example 2: extended diagnostic messages"
+
+    ```cpp
+    --8<-- "examples/diagnostics_extended.cpp"
+    ```
+    
+    Output:
+
+    ```
+    --8<-- "examples/diagnostics_extended.output"
+    ```
+
+    Now the exception message contains a JSON Pointer `/address/housenumber` that indicates which value has the wrong type.
+
+## Version history
+
+- Added in version 3.10.0.
diff --git a/doc/mkdocs/docs/api/macros/json_has_cpp_11.md b/doc/mkdocs/docs/api/macros/json_has_cpp_11.md
new file mode 100644
index 000000000..3bee84324
--- /dev/null
+++ b/doc/mkdocs/docs/api/macros/json_has_cpp_11.md
@@ -0,0 +1,28 @@
+# JSON_HAS_CPP_11, JSON_HAS_CPP_14, JSON_HAS_CPP_17, JSON_HAS_CPP_20
+
+```cpp
+#define JSON_HAS_CPP_11
+#define JSON_HAS_CPP_14
+#define JSON_HAS_CPP_17
+#define JSON_HAS_CPP_20
+```
+
+The library targets C++11, but also supports some features introduced in later C++ versions (e.g., `std::string_view`
+support for C++17). For these new features, the library implements some preprocessor checks to determine the C++
+standard. By defining any of these symbols, the internal check is overridden and the provided C++ version is
+unconditionally assumed. This can be helpful for compilers that only implement parts of the standard and would be
+detected incorrectly.
+
+## Default definition
+
+The default value is detected based on preprocessor macros such as `#!cpp __cplusplus`, `#!cpp _HAS_CXX17`, or
+`#!cpp _MSVC_LANG`.
+
+## Notes
+
+- `#!cpp JSON_HAS_CPP_11` is always defined.
+- All macros are undefined outside the library.
+
+## Version history
+
+- Added in version 3.10.5.
diff --git a/doc/mkdocs/docs/api/macros/json_has_filesystem.md b/doc/mkdocs/docs/api/macros/json_has_filesystem.md
new file mode 100644
index 000000000..160ad8c24
--- /dev/null
+++ b/doc/mkdocs/docs/api/macros/json_has_filesystem.md
@@ -0,0 +1,30 @@
+# JSON_HAS_FILESYSTEM / JSON_HAS_EXPERIMENTAL_FILESYSTEM
+
+```cpp
+#define JSON_HAS_FILESYSTEM /* value */
+#define JSON_HAS_EXPERIMENTAL_FILESYSTEM /* value */
+```
+
+When compiling with C++17, the library provides conversions from and to
+[`std::filesystem::path`](https://en.cppreference.com/w/cpp/filesystem/path). As compiler support for filesystem is
+limited, the library tries to detect whether
+[`<filesystem>`/`std::filesystem`](https://en.cppreference.com/w/cpp/header/filesystem) (`JSON_HAS_FILESYSTEM`) or
+[`<experimental/filesystem>`/`std::experimental::filesystem`](https://en.cppreference.com/w/cpp/header/experimental/filesystem)
+(`JSON_HAS_EXPERIMENTAL_FILESYSTEM`) should be used. To override the built-in check, define `JSON_HAS_FILESYSTEM` or
+`JSON_HAS_EXPERIMENTAL_FILESYSTEM` to `1`.
+
+## Default definition
+
+The default value is detected based on the preprocessor macros `#!cpp __cpp_lib_filesystem`,
+`#!cpp __cpp_lib_experimental_filesystem`, `#!cpp __has_include(<filesystem>)`, or
+`#!cpp __has_include(<experimental/filesystem>)`.
+
+## Notes
+
+- Note that older compilers or older versions of libstd++ also require the library `stdc++fs` to be linked to for
+  filesystem support.
+- Both macros are undefined outside the library.
+
+## Version history
+
+- Added in version 3.10.5.
diff --git a/doc/mkdocs/docs/api/macros/json_no_io.md b/doc/mkdocs/docs/api/macros/json_no_io.md
new file mode 100644
index 000000000..10ae24c8a
--- /dev/null
+++ b/doc/mkdocs/docs/api/macros/json_no_io.md
@@ -0,0 +1,21 @@
+# JSON_NO_IO
+
+```cpp
+#define JSON_NO_IO
+```
+
+When defined, headers `<cstdio>`, `<ios>`, `<iosfwd>`, `<istream>`, and `<ostream>` are not included and parse functions
+relying on these headers are excluded. This is relevant for environments where these I/O functions are disallowed for
+security reasons (e.g., Intel Software Guard Extensions (SGX)).
+
+## Default definition
+
+By default, `#!cpp JSON_NO_IO` is not defined.
+
+```cpp
+#undef JSON_NO_IO
+```
+
+## Version history
+
+- Added in version 3.10.0.
diff --git a/doc/mkdocs/docs/api/macros/json_noexception.md b/doc/mkdocs/docs/api/macros/json_noexception.md
new file mode 100644
index 000000000..0f32b63e9
--- /dev/null
+++ b/doc/mkdocs/docs/api/macros/json_noexception.md
@@ -0,0 +1,32 @@
+# JSON_NOEXCEPTION
+
+```cpp
+#define JSON_NOEXCEPTION
+```
+
+Exceptions can be switched off by defining the symbol `JSON_NOEXCEPTION`. When defining `JSON_NOEXCEPTION`, `#!cpp try`
+is replaced by `#!cpp if (true)`, `#!cpp catch` is replaced by `#!cpp if (false)`, and `#!cpp throw` is replaced by
+`#!cpp std::abort()`.
+
+The same effect is achieved by setting the compiler flag `-fno-exceptions`.
+
+## Default definition
+
+By default, the macro is not defined.
+
+```cpp
+#undef JSON_NOEXCEPTION
+```
+
+## Notes
+
+The explanatory [`what()`](https://en.cppreference.com/w/cpp/error/exception/what) string of exceptions is not
+available for MSVC if exceptions are disabled, see [#2824](https://github.com/nlohmann/json/discussions/2824).
+
+## See also
+
+- [Switch off exceptions](../../home/exceptions.md#switch-off-exceptions) for more information how to switch off exceptions
+
+## Version history
+
+Added in version 2.1.0.
diff --git a/doc/mkdocs/docs/api/macros/json_skip_library_version_check.md b/doc/mkdocs/docs/api/macros/json_skip_library_version_check.md
new file mode 100644
index 000000000..c9a743c18
--- /dev/null
+++ b/doc/mkdocs/docs/api/macros/json_skip_library_version_check.md
@@ -0,0 +1,37 @@
+# JSON_SKIP_LIBRARY_VERSION_CHECK
+
+```cpp
+#define JSON_SKIP_LIBRARY_VERSION_CHECK
+```
+
+When defined, the library will not create a compiler warning when a different version of the library was already
+included.
+
+## Default definition
+
+By default, the macro is not defined.
+
+```cpp
+#undef JSON_SKIP_LIBRARY_VERSION_CHECK
+```
+
+## Notes
+
+!!! danger "ABI compatibility"
+
+    Mixing different library versions in the same code can be a problem as the different versions may not be ABI
+    compatible.
+
+## Examples
+
+!!! example
+
+    The following warning will be shown in case a different version of the library was already included:
+
+    ```
+    Already included a different version of the library!
+    ```
+
+## Version history
+
+Added in version 3.11.0.
diff --git a/doc/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md b/doc/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md
new file mode 100644
index 000000000..c58d0ea85
--- /dev/null
+++ b/doc/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md
@@ -0,0 +1,20 @@
+# JSON_SKIP_UNSUPPORTED_COMPILER_CHECK
+
+```cpp
+#define JSON_SKIP_UNSUPPORTED_COMPILER_CHECK
+```
+
+When defined, the library will not create a compile error when a known unsupported compiler is detected. This allows to
+use the library with compilers that do not fully support C++11 and may only work if unsupported features are not used.
+
+## Default definition
+
+By default, the macro is not defined.
+
+```cpp
+#undef JSON_SKIP_UNSUPPORTED_COMPILER_CHECK
+```
+
+## Version history
+
+Added in version 3.2.0.
diff --git a/doc/mkdocs/docs/api/macros/json_throw_user.md b/doc/mkdocs/docs/api/macros/json_throw_user.md
new file mode 100644
index 000000000..e10db90e4
--- /dev/null
+++ b/doc/mkdocs/docs/api/macros/json_throw_user.md
@@ -0,0 +1,75 @@
+# JSON_CATCH_USER, JSON_THROW_USER, JSON_TRY_USER
+
+```cpp
+// (1)
+#define JSON_CATCH_USER(exception) /* value */
+// (2)
+#define JSON_THROW_USER(exception) /* value */
+// (3)
+#define JSON_TRY_USER /* value */
+```
+
+Controls how exceptions are handled by the library.
+
+1. This macro overrides [`#!cpp catch`](https://en.cppreference.com/w/cpp/language/try_catch) calls inside the library.
+   The argument is the type of the exception to catch. As of version 3.8.0, the library only catches `std::out_of_range`
+   exceptions internally to rethrow them as [`json::out_of_range`](../../home/exceptions.md#out-of-range) exceptions.
+   The macro is always followed by a scope.
+2. This macro overrides `#!cpp throw` calls inside the library. The argument is the exception to be thrown. Note that
+   `JSON_THROW_USER` should leave the current scope (e.g., by throwing or aborting), as continuing after it may yield
+   undefined behavior.
+3. This macro overrides `#!cpp try` calls inside the library. It has no arguments and is always followed by a scope.
+
+## Parameters
+
+`exception` (in)
+:   an exception type
+
+## Default definition
+
+By default, the macros map to their respective C++ keywords:
+
+```cpp
+#define JSON_CATCH_USER(exception) catch(exception)
+#define JSON_THROW_USER(exception) throw exception
+#define JSON_TRY_USER              try
+```
+
+When exceptions are switched off, the `#!cpp try` block is executed unconditionally, and throwing exceptions is
+replaced by calling [`std::abort`](https://en.cppreference.com/w/cpp/utility/program/abort) to make reaching the
+`#!cpp throw` branch abort the process.
+
+```cpp
+#define JSON_THROW_USER(exception) std::abort()
+#define JSON_TRY_USER              if (true)
+#define JSON_CATCH_USER(exception) if (false)
+```
+
+## Examples
+
+??? example
+
+    The code below switches off exceptions and creates a log entry with a detailed error message in case of errors.
+
+    ```cpp
+    #include <iostream>
+    
+    #define JSON_TRY_USER if(true)
+    #define JSON_CATCH_USER(exception) if(false)
+    #define JSON_THROW_USER(exception)                           \
+        {std::clog << "Error in " << __FILE__ << ":" << __LINE__ \
+                   << " (function " << __FUNCTION__ << ") - "    \
+                   << (exception).what() << std::endl;           \
+         std::abort();}
+    
+    #include <nlohmann/json.hpp>
+    ```
+
+## See also
+
+- [Switch off exceptions](../../home/exceptions.md#switch-off-exceptions) for more information how to switch off exceptions
+- [JSON_NOEXCEPTION](JSON_NOEXCEPTION) - switch off exceptions
+
+## Version history
+
+- Added in version 3.1.0.
diff --git a/doc/mkdocs/docs/api/macros/json_use_implicit_conversions.md b/doc/mkdocs/docs/api/macros/json_use_implicit_conversions.md
new file mode 100644
index 000000000..3ee81b061
--- /dev/null
+++ b/doc/mkdocs/docs/api/macros/json_use_implicit_conversions.md
@@ -0,0 +1,56 @@
+# JSON_USE_IMPLICIT_CONVERSIONS
+
+```cpp
+#define JSON_USE_IMPLICIT_CONVERSIONS /* value */
+```
+
+When defined to `0`, implicit conversions are switched off. By default, implicit conversions are switched on. The
+value directly affects [`operator ValueType`](../basic_json/operator_ValueType.md).
+
+Implicit conversions can also be controlled with the CMake option `JSON_ImplicitConversions` (`ON` by default) which
+sets `JSON_USE_IMPLICIT_CONVERSIONS` accordingly.
+
+## Default definition
+
+By default, implicit conversions are enabled.
+
+```cpp
+#define JSON_USE_IMPLICIT_CONVERSIONS 1
+```
+
+## Notes
+
+!!! info "Future behavior change"
+
+    Implicit conversions will be switched off by default in the next major release of the library.
+
+    You can prepare existing code by already defining `JSON_USE_IMPLICIT_CONVERSIONS` to `0` and replace any implicit
+    conversions with calls to [`get`](../basic_json/get.md).
+
+## Examples
+
+??? example
+
+    This is an example for an implicit conversion:
+
+    ```cpp
+    json j = "Hello, world!";
+    std::string s = j;
+    ```
+
+    When `JSON_USE_IMPLICIT_CONVERSIONS` is defined to `0`, the code above does no longer compile. Instead, it must be
+    written like this:
+
+    ```cpp
+    json j = "Hello, world!";
+    auto s = j.get<std::string>();
+    ```
+
+## See also
+
+- [**operator ValueType**](../basic_json/operator_ValueType.md) - get a value (implicit)
+- [**get**](../basic_json/get.md) - get a value (explicit)
+
+## Version history
+
+- Added in version 3.9.0.
diff --git a/doc/mkdocs/docs/api/macros/nlohmann_define_type_intrusive.md b/doc/mkdocs/docs/api/macros/nlohmann_define_type_intrusive.md
new file mode 100644
index 000000000..7269ef081
--- /dev/null
+++ b/doc/mkdocs/docs/api/macros/nlohmann_define_type_intrusive.md
@@ -0,0 +1,124 @@
+# NLOHMANN_DEFINE_TYPE_INTRUSIVE, NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT
+
+```cpp
+#define NLOHMANN_DEFINE_TYPE_INTRUSIVE(type, member...)              // (1)
+#define NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT(type, member...) // (2)
+```
+
+These macros can be used to simplify the serialization/deserialization of types if you want to use a JSON object as
+serialization and want to use the member variable names as object keys in that object. The macro is to be defined
+**inside** the class/struct to create code for.
+Unlike [`NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE`](nlohmann_define_type_non_intrusive.md), it can access private members.
+The first parameter is the name of the class/struct, and all remaining parameters name the members.
+
+1. Will use [`at`](../basic_json/at.md) during deserialization and will throw
+  [`out_of_range.403`](../../home/exceptions.md#jsonexceptionout_of_range403) if a key is missing in the JSON object.
+2. Will use [`value`](../basic_json/value.md) during deserialization and fall back to the default value for the
+   respective type of the member variable if a key in the JSON object is missing. The generated `from_json()` function
+   default constructs an object and uses its values as the defaults when calling the `value` function.
+
+## Parameters
+
+`type` (in)
+:   name of the type (class, struct) to serialize/deserialize
+
+`member` (in)
+:   name of the member variable to serialize/deserialize; up to 64 members can be given as comma-separated list
+
+## Default definition
+
+The macros add two friend functions to the class which take care of the serialization and deserialization:
+
+```cpp
+friend void to_json(nlohmann::json&, const type&);
+friend void from_json(const nlohmann::json&, type&);
+```
+
+See examples below for the concrete generated code.
+
+## Notes
+
+!!! info "Prerequisites"
+
+    1. The type `type` must be default constructible. See [How can I use `get()` for non-default constructible/non-copyable types?](../../features/arbitrary_types.md#how-can-i-use-get-for-non-default-constructiblenon-copyable-types)
+       for how to overcome this limitation.
+    2. The macro must be used inside the type (class/struct).
+
+!!! warning "Implementation limits"
+
+    - The current implementation is limited to at most 64 member variables. If you want to serialize/deserialize types
+      with more than 64 member variables, you need to define the `to_json`/`from_json` functions manually.
+    - The macros only work for the [`nlohmann::json`](../json.md) type; other specializations such as
+      [`nlohmann::ordered_json`](../ordered_json.md) are currently unsupported.
+
+## Examples
+
+??? example "Example (1): NLOHMANN_DEFINE_TYPE_INTRUSIVE"
+
+    Consider the following complete example:
+
+    ```cpp hl_lines="21"
+    --8<-- "examples/nlohmann_define_type_intrusive_macro.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/nlohmann_define_type_intrusive_macro.output"
+    ```
+
+    Notes:
+
+    - `ns::person` is default-constructible. This is a requirement for using the macro.
+    - `ns::person` has private member variables. This makes `NLOHMANN_DEFINE_TYPE_INTRUSIVE` applicable, but not
+      `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE`.
+    - The macro `NLOHMANN_DEFINE_TYPE_INTRUSIVE` is used _inside_ the class.
+    - A missing key "age" in the deserialization yields an exception. To fall back to the default value,
+      `NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT` can be used.
+
+    The macro is equivalent to:
+
+    ```cpp hl_lines="21 22 23 24 25 26 27 28 29 30 31 32 33"
+    --8<-- "examples/nlohmann_define_type_intrusive_explicit.cpp"
+    ```
+
+??? example "Example (2): NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT"
+
+    Consider the following complete example:
+
+    ```cpp hl_lines="21"
+    --8<-- "examples/nlohmann_define_type_intrusive_with_default_macro.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/nlohmann_define_type_intrusive_with_default_macro.output"
+    ```
+
+    Notes:
+
+    - `ns::person` is default-constructible. This is a requirement for using the macro.
+    - `ns::person` has private member variables. This makes `NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT` applicable,
+       but not `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT`.
+    - The macro `NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT` is used _inside_ the class.
+    - A missing key "age" in the deserialization does not yield an exception. Instead, the default value `-1` is used.
+
+    The macro is equivalent to:
+
+    ```cpp hl_lines="21 22 23 24 25 26 27 28 29 30 31 32 33 34"
+    --8<-- "examples/nlohmann_define_type_intrusive_with_default_explicit.cpp"
+    ```
+
+    Note how a default-initialized `person` object is used in the `from_json` to fill missing values.
+
+## See also
+
+- [NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE / NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT](nlohmann_define_type_non_intrusive.md)
+  for a similar macro that can be defined _outside_ the type.
+- [Arbitrary Types Conversions](../../features/arbitrary_types.md) for an overview.
+
+## Version history
+
+1. Added in version 3.9.0.
+2. Added in version 3.11.0.
diff --git a/doc/mkdocs/docs/api/macros/nlohmann_define_type_non_intrusive.md b/doc/mkdocs/docs/api/macros/nlohmann_define_type_non_intrusive.md
new file mode 100644
index 000000000..7ed5a6b43
--- /dev/null
+++ b/doc/mkdocs/docs/api/macros/nlohmann_define_type_non_intrusive.md
@@ -0,0 +1,124 @@
+# NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE, NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT
+
+```cpp
+#define NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(type, member...)              // (1)
+#define NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT(type, member...) // (2)
+```
+
+These macros can be used to simplify the serialization/deserialization of types if you want to use a JSON object as
+serialization and want to use the member variable names as object keys in that object. The macro is to be defined
+**outside** the class/struct to create code for, but **inside** its namespace.
+Unlike [`NLOHMANN_DEFINE_TYPE_INTRUSIVE`](nlohmann_define_type_intrusive.md), it **cannot** access private members.
+The first parameter is the name of the class/struct, and all remaining parameters name the members.
+
+1. Will use [`at`](../basic_json/at.md) during deserialization and will throw
+   [`out_of_range.403`](../../home/exceptions.md#jsonexceptionout_of_range403) if a key is missing in the JSON object.
+2. Will use [`value`](../basic_json/value.md) during deserialization and fall back to the default value for the
+   respective type of the member variable if a key in the JSON object is missing. The generated `from_json()` function
+   default constructs an object and uses its values as the defaults when calling the `value` function.
+
+## Parameters
+
+`type` (in)
+:   name of the type (class, struct) to serialize/deserialize
+
+`member` (in)
+:   name of the (public) member variable to serialize/deserialize; up to 64 members can be given as comma-separated list
+
+## Default definition
+
+The macros add two functions to the namespace which take care of the serialization and deserialization:
+
+```cpp
+void to_json(nlohmann::json&, const type&);
+void from_json(const nlohmann::json&, type&);
+```
+
+See examples below for the concrete generated code.
+
+## Notes
+
+!!! info "Prerequisites"
+
+    1. The type `type` must be default constructible. See [How can I use `get()` for non-default constructible/non-copyable types?](../../features/arbitrary_types.md#how-can-i-use-get-for-non-default-constructiblenon-copyable-types)
+       for how to overcome this limitation.
+    2. The macro must be used outside the type (class/struct).
+    3. The passed members must be public.
+
+!!! warning "Implementation limits"
+
+    - The current implementation is limited to at most 64 member variables. If you want to serialize/deserialize types
+      with more than 64 member variables, you need to define the `to_json`/`from_json` functions manually.
+    - The macros only work for the [`nlohmann::json`](../json.md) type; other specializations such as
+      [`nlohmann::ordered_json`](../ordered_json.md) are currently unsupported.
+
+## Examples
+
+??? example "Example (1): NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE"
+
+    Consider the following complete example:
+
+    ```cpp hl_lines="15"
+    --8<-- "examples/nlohmann_define_type_non_intrusive_macro.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/nlohmann_define_type_non_intrusive_macro.output"
+    ```
+
+    Notes:
+
+    - `ns::person` is default-constructible. This is a requirement for using the macro.
+    - `ns::person` has only public member variables. This makes `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE` applicable.
+    - The macro `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE` is used _outside_ the class, but _inside_ its namespace `ns`.
+    - A missing key "age" in the deserialization yields an exception. To fall back to the default value,
+      `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT` can be used.
+
+    The macro is equivalent to:
+
+    ```cpp hl_lines="15 16 17 18 19 20 21 22 23 24 25 26 27"
+    --8<-- "examples/nlohmann_define_type_non_intrusive_explicit.cpp"
+    ```
+
+??? example "Example (2): NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT"
+
+    Consider the following complete example:
+
+    ```cpp hl_lines="20"
+    --8<-- "examples/nlohmann_define_type_non_intrusive_with_default_macro.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/nlohmann_define_type_non_intrusive_with_default_macro.output"
+    ```
+
+    Notes:
+
+    - `ns::person` is default-constructible. This is a requirement for using the macro.
+    - `ns::person` has only public member variables. This makes `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT`
+      applicable.
+    - The macro `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT` is used _outside_ the class, but _inside_ its namespace `ns`.
+    - A missing key "age" in the deserialization does not yield an exception. Instead, the default value `-1` is used.
+
+    The macro is equivalent to:
+
+    ```cpp hl_lines="20 21 22 23 24 25 26 27 28 29 30 31 32 33"
+    --8<-- "examples/nlohmann_define_type_non_intrusive_with_default_explicit.cpp"
+    ```
+
+    Note how a default-initialized `person` object is used in the `from_json` to fill missing values.
+
+## See also
+
+- [NLOHMANN_DEFINE_TYPE_INTRUSIVE / NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT](nlohmann_define_type_intrusive.md)
+  for a similar macro that can be defined _inside_ the type.
+- [Arbitrary Types Conversions](../../features/arbitrary_types.md) for an overview.
+
+## Version history
+
+1. Added in version 3.9.0.
+2. Added in version 3.11.0.
diff --git a/doc/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md b/doc/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md
new file mode 100644
index 000000000..7b0f89802
--- /dev/null
+++ b/doc/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md
@@ -0,0 +1,84 @@
+# NLOHMANN_JSON_SERIALIZE_ENUM
+
+```cpp
+#define NLOHMANN_JSON_SERIALIZE_ENUM(type, conversion...)
+```
+
+By default, enum values are serialized to JSON as integers. In some cases this could result in undesired behavior. If an
+enum is modified or re-ordered after data has been serialized to JSON, the later de-serialized JSON data may be
+undefined or a different enum value than was originally intended.
+
+The `NLOHMANN_JSON_SERIALIZE_ENUM` allows to define a user-defined serialization for every enumerator.
+
+## Parameters
+
+`type` (in)
+:   name of the enum to serialize/deserialize
+
+`conversion` (in)
+:   a pair of an enumerator and a JSON serialization; arbitrary pairs can can be given as comma-separated list
+
+## Default definition
+
+The macros add two friend functions to the class which take care of the serialization and deserialization:
+
+```cpp
+template<typename BasicJsonType>
+inline void to_json(BasicJsonType& j, const type& e);
+template<typename BasicJsonType>
+inline void from_json(const BasicJsonType& j, type& e);
+```
+
+## Notes
+
+!!! info "Prerequisites"
+
+    The macro must be used inside the namespace of the enum.
+
+!!! important "Important notes"
+
+    - When using [`get<ENUM_TYPE>()`](../basic_json/get.md), undefined JSON values will default to the first specified
+      conversion. Select this default pair carefully. See example 1 below.
+    - If an enum or JSON value is specified in multiple conversions, the first matching conversion from the top of the
+      list will be returned when converting to or from JSON. See example 2 below.
+
+## Examples
+
+??? example "Example 1: Basic usage"
+
+    The example shows how `NLOHMANN_JSON_SERIALIZE_ENUM` can be used to serialize/deserialize both classical enums and
+    C++11 enum classes:
+
+    ```cpp hl_lines="16 17 18 19 20 21 22 29 30 31 32 33"
+    --8<-- "examples/nlohmann_json_serialize_enum.cpp"
+    ```
+
+    Output:
+    
+    ```json
+    --8<-- "examples/nlohmann_json_serialize_enum.output"
+    ```
+
+??? example "Example 2: Multiple conversions for one enumerator"
+
+    The example shows how to use multiple conversions for a single enumerator. In the example, `Color::red` will always
+    be *serialized* to `"red"`, because the first occurring conversion. The second conversion, however, offers an
+    alternative *deserialization* from `"rot"` to `Color::red`.
+
+    ```cpp hl_lines="17"
+    --8<-- "examples/nlohmann_json_serialize_enum_2.cpp"
+    ```
+
+    Output:
+    
+    ```json
+    --8<-- "examples/nlohmann_json_serialize_enum_2.output"
+    ```
+
+## See also
+
+- [Specializing enum conversion](../../features/enum_conversion.md)
+
+## Version history
+
+Added in version 3.4.0.
diff --git a/doc/mkdocs/docs/api/macros/nlohmann_json_version_major.md b/doc/mkdocs/docs/api/macros/nlohmann_json_version_major.md
new file mode 100644
index 000000000..826785292
--- /dev/null
+++ b/doc/mkdocs/docs/api/macros/nlohmann_json_version_major.md
@@ -0,0 +1,23 @@
+# NLOHMANN_JSON_VERSION_MAJOR, NLOHMANN_JSON_VERSION_MINOR, NLOHMANN_JSON_VERSION_PATCH
+
+```cpp
+#define NLOHMANN_JSON_VERSION_MAJOR /* value */
+#define NLOHMANN_JSON_VERSION_MINOR /* value */
+#define NLOHMANN_JSON_VERSION_PATCH /* value */
+```
+
+These macros are defined by the library and contain the version numbers according to
+[Semantic Versioning 2.0.0](https://semver.org/spec/v2.0.0.html).
+
+## Default definition
+
+The macros are defined according to the current library version.
+
+## See also
+
+- [meta](../basic_json/meta.md) - returns version information on the library
+- [JSON_SKIP_LIBRARY_VERSION_CHECK](json_skip_library_version_check.md) - skip library version check
+
+## Version history
+
+- Added in version 3.1.0.
diff --git a/doc/mkdocs/docs/features/arbitrary_types.md b/doc/mkdocs/docs/features/arbitrary_types.md
index 67e8a4554..49a541ef5 100644
--- a/doc/mkdocs/docs/features/arbitrary_types.md
+++ b/doc/mkdocs/docs/features/arbitrary_types.md
@@ -77,7 +77,7 @@ Some important things:
 * Those methods **MUST** be in your type's namespace (which can be the global namespace), or the library will not be able to locate them (in this example, they are in namespace `ns`, where `person` is defined).
 * Those methods **MUST** be available (e.g., proper headers must be included) everywhere you use these conversions. Look at [issue 1108](https://github.com/nlohmann/json/issues/1108) for errors that may occur otherwise.
 * When using `get<your_type>()`, `your_type` **MUST** be [DefaultConstructible](https://en.cppreference.com/w/cpp/named_req/DefaultConstructible). (There is a way to bypass this requirement described later.)
-* In function `from_json`, use function [`at()`](https://nlohmann.github.io/json/classnlohmann_1_1basic__json_a93403e803947b86f4da2d1fb3345cf2c.html#a93403e803947b86f4da2d1fb3345cf2c) to access the object values rather than `operator[]`. In case a key does not exist, `at` throws an exception that you can handle, whereas `operator[]` exhibits undefined behavior.
+* In function `from_json`, use function [`at()`](../api/basic_json/at.md) to access the object values rather than `operator[]`. In case a key does not exist, `at` throws an exception that you can handle, whereas `operator[]` exhibits undefined behavior.
 * You do not need to add serializers or deserializers for STL types like `std::vector`: the library already implements these.
 
 
@@ -87,16 +87,19 @@ If you just want to serialize/deserialize some structs, the `to_json`/`from_json
 
 There are four macros to make your life easier as long as you (1) want to use a JSON object as serialization and (2) want to use the member variable names as object keys in that object:
 
-- `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(name, member1, member2, ...)` is to be defined inside the namespace of the class/struct to create code for. It will throw an exception in `from_json()` due to a missing value in the JSON object.
-- `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT(name, member1, member2, ...)` is to be defined inside the namespace of the class/struct to create code for. It will not throw an exception in `from_json()` due to a missing value in the JSON object, but fills in values from object which is default-constructed by the type.
-- `NLOHMANN_DEFINE_TYPE_INTRUSIVE(name, member1, member2, ...)` is to be defined inside the class/struct to create code for. This macro can also access private members. It will throw an exception in `from_json()` due to a missing value in the JSON object.
-- `NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT(name, member1, member2, ...)` is to be defined inside the class/struct to create code for. This macro can also access private members. It will not throw an exception in `from_json()` due to a missing value in the JSON object, but fills in values from object which is default-constructed by the type.
+- [`NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(name, member1, member2, ...)`](../api/macros/nlohmann_define_type_non_intrusive.md) is to be defined inside the namespace of the class/struct to create code for. It will throw an exception in `from_json()` due to a missing value in the JSON object.
+- [`NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT(name, member1, member2, ...)`](../api/macros/nlohmann_define_type_non_intrusive.md) is to be defined inside the namespace of the class/struct to create code for. It will not throw an exception in `from_json()` due to a missing value in the JSON object, but fills in values from object which is default-constructed by the type.
+- [`NLOHMANN_DEFINE_TYPE_INTRUSIVE(name, member1, member2, ...)`](../api/macros/nlohmann_define_type_intrusive.md) is to be defined inside the class/struct to create code for. This macro can also access private members. It will throw an exception in `from_json()` due to a missing value in the JSON object.
+- [`NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT(name, member1, member2, ...)`](../api/macros/nlohmann_define_type_intrusive.md) is to be defined inside the class/struct to create code for. This macro can also access private members. It will not throw an exception in `from_json()` due to a missing value in the JSON object, but fills in values from object which is default-constructed by the type.
 
 In all macros, the first parameter is the name of the class/struct, and all remaining parameters name the members. You can read more docs about them starting from [here](macros.md#nlohmann_define_type_intrusivetype-member).
 
-!!! note
+!!! info "Implementation limits"
 
-    At most 64 member variables can be passed to these macros.
+    - The current macro implementations are limited to at most 64 member variables. If you want to serialize/deserialize
+      types with more than 64 member variables, you need to define the `to_json`/`from_json` functions manually.
+    - The macros only work for the [`nlohmann::json`](../api/json.md) type; other specializations such as
+      [`nlohmann::ordered_json`](../api/ordered_json.md) are currently unsupported.
 
 ??? example
 
diff --git a/doc/mkdocs/docs/features/assertions.md b/doc/mkdocs/docs/features/assertions.md
new file mode 100644
index 000000000..a0b118722
--- /dev/null
+++ b/doc/mkdocs/docs/features/assertions.md
@@ -0,0 +1,104 @@
+# Runtime Assertions
+
+The code contains numerous debug assertions to ensure class invariants are valid or to detect undefined behavior.
+Whereas the former class invariants are nothing to be concerned of, the latter checks for undefined behavior are to
+detect bugs in client code.
+
+## Switch off runtime assertions
+
+Runtime assertions can be switched off by defining the preprocessor macro `NDEBUG` (see the
+[documentation of assert](https://en.cppreference.com/w/cpp/error/assert)) which is the default for release builds.
+
+## Change assertion behavior
+
+The behavior of runtime assertions can be changes by defining macro [`JSON_ASSERT(x)`](../api/macros/json_assert.md)
+before including the `json.hpp` header.
+
+## Function with runtime assertions
+
+### Unchecked object access to a const value
+
+Function [`operator[]`](../api/basic_json/operator%5B%5D.md) implements unchecked access for objects. Whereas a missing
+key is added in case of non-const objects, accessing a const object with a missing key is undefined behavior (think of a
+dereferenced null pointer) and yields a runtime assertion.
+
+If you are not sure whether an element in an object exists, use checked access with the
+[`at` function](../api/basic_json/at.md) or call the [`contains` function](../api/basic_json/contains.md) before.
+
+See also the documentation on [element access](element_access/index.md).
+
+??? example "Example 1: Missing object key"
+
+    The following code will trigger an assertion at runtime:
+
+    ```cpp
+    #include <nlohmann/json.hpp>
+    
+    using json = nlohmann::json;
+    
+    int main()
+    {
+        const json j = {{"key", "value"}};
+        auto v = j["missing"];
+    }
+    ```
+
+    Output:
+
+    ```
+    Assertion failed: (m_value.object->find(key) != m_value.object->end()), function operator[], file json.hpp, line 2144.
+    ```
+
+### Constructing from an uninitialized iterator range
+
+Constructing a JSON value from an iterator range (see [constructor](../api/basic_json/basic_json.md)) with an
+uninitialized iterator is undefined behavior and yields a runtime assertion.
+
+??? example "Example 2: Uninitialized iterator range"
+
+    The following code will trigger an assertion at runtime:
+
+    ```cpp
+    #include <nlohmann/json.hpp>
+    
+    using json = nlohmann::json;
+    
+    int main()
+    {
+        json::iterator it1, it2;
+        json j(it1, it2);
+    }
+    ```
+
+    Output:
+
+    ```
+    Assertion failed: (m_object != nullptr), function operator++, file iter_impl.hpp, line 368.
+    ```
+
+### Operations on uninitialized iterators
+
+Any operation on uninitialized iterators (i.e., iterators that are not associated with any JSON value) is undefined
+behavior and yields a runtime assertion.
+
+??? example "Example 3: Uninitialized iterator"
+
+    The following code will trigger an assertion at runtime:
+
+    ```cpp
+    #include <nlohmann/json.hpp>
+    
+    using json = nlohmann::json;
+    
+    int main()
+    {
+      json::iterator it;
+      ++it;
+    }
+    ```
+
+    Output:
+
+    ```
+    Assertion failed: (m_object != nullptr), function operator++, file iter_impl.hpp, line 368.
+    ```
diff --git a/doc/mkdocs/docs/features/element_access/unchecked_access.md b/doc/mkdocs/docs/features/element_access/unchecked_access.md
index bb7228777..4fdef35c7 100644
--- a/doc/mkdocs/docs/features/element_access/unchecked_access.md
+++ b/doc/mkdocs/docs/features/element_access/unchecked_access.md
@@ -94,9 +94,9 @@ When accessing an invalid index (i.e., an index greater than or equal to the arr
 
 ## Summary
 
-| scenario                          | non-const value                                                                                                                                      | const value                                     |
-|-----------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------|
-| access to existing object key     | reference to existing value is returned                                                                                                              | const reference to existing value is returned   |
-| access to valid array index       | reference to existing value is returned                                                                                                              | const reference to existing value is returned   |
-| access to non-existing object key | reference to newly inserted `#!json null` value is returned                                                                                          | **undefined behavior**; assertion in debug mode |
-| access to invalid array index     | reference to newly inserted `#!json null` value is returned; any index between previous maximal index and passed index are filled with `#!json null` | **undefined behavior**; assertion in debug mode |
+| scenario                          | non-const value                                                                                                                                      | const value                                                                 |
+|-----------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------|
+| access to existing object key     | reference to existing value is returned                                                                                                              | const reference to existing value is returned                               |
+| access to valid array index       | reference to existing value is returned                                                                                                              | const reference to existing value is returned                               |
+| access to non-existing object key | reference to newly inserted `#!json null` value is returned                                                                                          | **undefined behavior**; [runtime assertion](../assertions.md) in debug mode |
+| access to invalid array index     | reference to newly inserted `#!json null` value is returned; any index between previous maximal index and passed index are filled with `#!json null` | **undefined behavior**; [runtime assertion](../assertions.md) in debug mode |
diff --git a/doc/mkdocs/docs/features/enum_conversion.md b/doc/mkdocs/docs/features/enum_conversion.md
index 8f474a702..7e61f67bb 100644
--- a/doc/mkdocs/docs/features/enum_conversion.md
+++ b/doc/mkdocs/docs/features/enum_conversion.md
@@ -24,8 +24,8 @@ NLOHMANN_JSON_SERIALIZE_ENUM( TaskState, {
 })
 ```
 
-The `NLOHMANN_JSON_SERIALIZE_ENUM()` macro declares a set of `to_json()` / `from_json()` functions for type `TaskState`
-while avoiding repetition and boilerplate serialization code.
+The [`NLOHMANN_JSON_SERIALIZE_ENUM()` macro](../api/macros/nlohmann_json_serialize_enum.md) declares a set of
+`to_json()` / `from_json()` functions for type `TaskState` while avoiding repetition and boilerplate serialization code.
 
 ## Usage
 
@@ -45,10 +45,11 @@ assert(jPi.get<TaskState>() == TS_INVALID );
 
 ## Notes
 
-Just as in [Arbitrary Type Conversions](#arbitrary-types-conversions) above,
+Just as in [Arbitrary Type Conversions](arbitrary_types.md) above,
 
-- `NLOHMANN_JSON_SERIALIZE_ENUM()` MUST be declared in your enum type's namespace (which can be the global namespace),
-  or the library will not be able to locate it, and it will default to integer serialization.
+- [`NLOHMANN_JSON_SERIALIZE_ENUM()`](../api/macros/nlohmann_json_serialize_enum.md) MUST be declared in your enum type's
+  namespace (which can be the global namespace), or the library will not be able to locate it, and it will default to
+  integer serialization.
 - It MUST be available (e.g., proper headers must be included) everywhere you use the conversions.
 
 Other Important points:
diff --git a/doc/mkdocs/docs/features/macros.md b/doc/mkdocs/docs/features/macros.md
index 576ec935d..e04a426a5 100644
--- a/doc/mkdocs/docs/features/macros.md
+++ b/doc/mkdocs/docs/features/macros.md
@@ -1,47 +1,19 @@
 # Supported Macros
 
 Some aspects of the library can be configured by defining preprocessor macros before including the `json.hpp` header.
+See also the [API documentation for macros](../api/macros/index.md) for examples and more information.
 
 ## `JSON_ASSERT(x)`
 
-This macro controls which code is executed for runtime assertions of the libraries.
+This macro controls which code is executed for [runtime assertions](assertions.md) of the library.
 
-!!! info "Default behavior"
-
-    The default value is [`#!cpp assert(x)`](https://en.cppreference.com/w/cpp/error/assert).
-
-    ```cpp
-    #define JSON_ASSERT(x) assert(x)
-    ```
-
-The macro was introduced in version 3.9.0.
+See [full documentation of `JSON_ASSERT(x)`](../api/macros/json_assert.md).
 
 ## `JSON_CATCH_USER(exception)`
 
 This macro overrides [`#!cpp catch`](https://en.cppreference.com/w/cpp/language/try_catch) calls inside the library.
-The argument is the type of the exception to catch. As of version 3.8.0, the library only catches `std::out_of_range`
-exceptions internally to rethrow them as [`json::out_of_range`](../home/exceptions.md#out-of-range) exceptions. The
-macro is always followed by a scope.
 
-See [Switch off exceptions](../home/exceptions.md#switch-off-exceptions) for an example.
-
-!!! info "Default behavior"
-
-    When exceptions are enabled, the default value is
-    [`#!cpp catch(exception)`](https://en.cppreference.com/w/cpp/language/try_catch).
-
-    ```cpp
-    #define JSON_CATCH_USER(exception) catch(exception)
-    ```
-
-    When exceptions are switched off by the compiler, the default value is `#!cpp if (false)` to make the catch block
-    unreachable.
-
-    ```cpp
-    #define JSON_CATCH_USER(exception) if (false)
-    ```
-
-The macro was introduced in version 3.1.0.
+See [full documentation of `JSON_CATCH_USER(exception)`](../api/macros/json_throw_user.md).
 
 ## `JSON_DIAGNOSTICS`
 
@@ -55,19 +27,7 @@ that enabling this macro increases the size of every JSON value by one pointer a
 The diagnostics messages can also be controlled with the CMake option `JSON_Diagnostics` (`OFF` by default) which sets
 `JSON_DIAGNOSTICS` accordingly.
 
-!!! warning
-
-    As this macro changes the definition of the `basic_json` object, it MUST be defined in the same way globally, even
-    across different compilation units; DO NOT link together code compiled with different definitions of
-    `JSON_DIAGNOSTICS` as this is a violation of the One Definition Rule and will cause undefined behaviour.
-
-!!! info "Default behavior"
-
-    ```cpp
-    #define JSON_DIAGNOSTICS 0
-    ```
-
-The macro was introduced in version 3.10.0.
+See [full documentation of `JSON_DIAGNOSTICS`](../api/macros/json_diagnostics.md).
 
 ## `JSON_HAS_CPP_11`, `JSON_HAS_CPP_14`, `JSON_HAS_CPP_17`, `JSON_HAS_CPP_20`
 
@@ -77,12 +37,7 @@ standard. By defining any of these symbols, the internal check is overridden and
 unconditionally assumed. This can be helpful for compilers that only implement parts of the standard and would be
 detected incorrectly.
 
-!!! info "Default behavior"
-
-    The default value is detected based on the preprocessor macros `#!cpp __cplusplus`, `#!cpp _HAS_CXX17`, or
-    `#!cpp _MSVC_LANG`.
-
-The macros were introduced in version 3.10.5.
+See [full documentation of `JSON_HAS_CPP_11`, `JSON_HAS_CPP_14`, `JSON_HAS_CPP_17`, and `JSON_HAS_CPP_20`](../api/macros/json_has_cpp_11.md).
 
 ## `JSON_HAS_FILESYSTEM`, `JSON_HAS_EXPERIMENTAL_FILESYSTEM`
 
@@ -91,37 +46,13 @@ for filesystem is limited, the library tries to detect whether `<filesystem>`/`s
 or `<experimental/filesystem>`/`std::experimental::filesystem` (`JSON_HAS_EXPERIMENTAL_FILESYSTEM`) should be used.
 To override the built-in check, define `JSON_HAS_FILESYSTEM` or `JSON_HAS_EXPERIMENTAL_FILESYSTEM` to `1`.
 
-!!! info "Default behavior"
-
-    The default value is detected based on the preprocessor macros `#!cpp __cpp_lib_filesystem`,
-    `#!cpp __cpp_lib_experimental_filesystem`, `#!cpp __has_include(<filesystem>)`, or
-    `#!cpp __has_include(<experimental/filesystem>)`.
-
-Note that older compilers or older versions of libstd++ also require the library `stdc++fs` to be linked to for
-filesystem support.
-
-The macros were introduced in version 3.10.5.
+See [full documentation of `JSON_HAS_FILESYSTEM` and `JSON_HAS_EXPERIMENTAL_FILESYSTEM`](../api/macros/json_has_filesystem.md).
 
 ## `JSON_NOEXCEPTION`
 
-Exceptions can be switched off by defining the symbol `JSON_NOEXCEPTION`. When defining `JSON_NOEXCEPTION`, `#!cpp try`
-is replaced by `#!cpp if (true)`, `#!cpp catch` is replaced by `#!cpp if (false)`, and `#!cpp throw` is replaced by
-`#!cpp std::abort()`.
+Exceptions can be switched off by defining the symbol `JSON_NOEXCEPTION`.
 
-!!! info "Default behavior"
-
-    By default, the macro is not defined.
-
-    ```cpp
-    #undef JSON_NOEXCEPTION
-    ```
-
-The same effect is achieved by setting the compiler flag `-fno-exceptions`.
-
-Note the explanatory [`what()`](https://en.cppreference.com/w/cpp/error/exception/what) string of exceptions is not
-available for MSVC if exceptions are disabled, see [#2824](https://github.com/nlohmann/json/discussions/2824).
-
-The macro was introduced in version 2.1.0.
+See [full documentation of `JSON_NOEXCEPTION`](../api/macros/json_noexception.md).
 
 ## `JSON_NO_IO`
 
@@ -129,128 +60,39 @@ When defined, headers `<cstdio>`, `<ios>`, `<iosfwd>`, `<istream>`, and `<ostrea
 relying on these headers are excluded. This is relevant for environment where these I/O functions are disallowed for
 security reasons (e.g., Intel Software Guard Extensions (SGX)).
 
-!!! info "Default behavior"
-
-    By default, the macro is not defined.
-
-    ```cpp
-    #undef JSON_NO_IO
-    ```
-
-The macro was introduced in version 3.10.0.
+See [full documentation of `JSON_NO_IO`](../api/macros/json_no_io.md).
 
 ## `JSON_SKIP_LIBRARY_VERSION_CHECK`
 
 When defined, the library will not create a compiler warning when a different version of the library was already
 included.
 
-!!! info "Default behavior"
-
-    By default, the macro is not defined.
-
-    ```cpp
-    #undef JSON_SKIP_LIBRARY_VERSION_CHECK
-    ```
-
-The macro was introduced in version 3.11.0.
+See [full documentation of `JSON_SKIP_LIBRARY_VERSION_CHECK`](../api/macros/json_skip_library_version_check.md).
 
 ## `JSON_SKIP_UNSUPPORTED_COMPILER_CHECK`
 
 When defined, the library will not create a compile error when a known unsupported compiler is detected. This allows to
 use the library with compilers that do not fully support C++11 and may only work if unsupported features are not used.
 
-!!! info "Default behavior"
-
-    By default, the macro is not defined.
-
-    ```cpp
-    #undef JSON_SKIP_UNSUPPORTED_COMPILER_CHECK
-    ```
-
-The macro was introduced in version 3.2.0.
+See [full documentation of `JSON_SKIP_UNSUPPORTED_COMPILER_CHECK`](../api/macros/json_skip_unsupported_compiler_check.md).
 
 ## `JSON_THROW_USER(exception)`
 
-This macro overrides `#!cpp throw` calls inside the library. The argument is the exception to be thrown. Note that
-`JSON_THROW_USER` should leave the current scope (e.g., by throwing or aborting), as continuing after it may yield
-undefined behavior.
+This macro overrides `#!cpp throw` calls inside the library. The argument is the exception to be thrown.
 
-!!! info "Default behavior"
-
-    When exceptions are enabled, the default value is
-    [`#!cpp throw exception`](https://en.cppreference.com/w/cpp/language/throw).
-
-    ```cpp
-    #define JSON_THROW_USER(exception) throw exception
-    ```
-
-    When exceptions are switched off by the compiler, the default value is
-    [`#!cpp std::abort()`](https://en.cppreference.com/w/cpp/utility/program/abort) to make reaching the throw branch
-    abort the process.
-
-    ```cpp
-    #define JSON_THROW_USER(exception) std::abort()
-    ```
-
-See [Switch off exceptions](../home/exceptions.md#switch-off-exceptions) for an example.
-
-The macro was introduced in version 3.1.0.
+See [full documentation of `JSON_THROW_USER(exception)`](../api/macros/json_throw_user.md).
 
 ## `JSON_TRY_USER`
 
-This macro overrides `#!cpp try` calls inside the library. It has no arguments and is always followed by a scope.
+This macro overrides `#!cpp try` calls inside the library.
 
-!!! info "Default behavior"
-
-    When exceptions are enabled, the default value is
-    [`#!cpp try`](https://en.cppreference.com/w/cpp/language/try_catch).
-
-    ```cpp
-    #define JSON_TRY_USER try
-    ```
-
-    When exceptions are switched off by the compiler, the default value is `#!cpp if (true)` to unconditionally execute
-    the following code block.
-
-    ```cpp
-    #define JSON_TRY_USER if (true)
-    ```
-
-See [Switch off exceptions](../home/exceptions.md#switch-off-exceptions) for an example.
-
-The macro was introduced in version 3.1.0.
+See [full documentation of `JSON_TRY_USER`](../api/macros/json_throw_user.md).
 
 ## `JSON_USE_IMPLICIT_CONVERSIONS`
 
 When defined to `0`, implicit conversions are switched off. By default, implicit conversions are switched on.
 
-??? example
-
-    This is an example for an implicit conversion:
-
-    ```cpp
-    json j = "Hello, world!";
-    std::string s = j;
-    ```
-
-    When `JSON_USE_IMPLICIT_CONVERSIONS` is defined to `0`, the code above does no longer compile. Instead, it must be
-    written like this:
-
-    ```cpp
-    json j = "Hello, world!";
-    auto s = j.get<std::string>();
-    ```
-
-Implicit conversions can also be controlled with the CMake option `JSON_ImplicitConversions` (`ON` by default) which
-sets `JSON_USE_IMPLICIT_CONVERSIONS` accordingly.
-
-!!! info "Default behavior"
-
-    ```cpp
-    #define JSON_USE_IMPLICIT_CONVERSIONS 1
-    ```
-
-The macro was introduced in version 3.9.0.
+See [full documentation of `JSON_USE_IMPLICIT_CONVERSIONS`](../api/macros/json_use_implicit_conversions.md).
 
 ## `NLOHMANN_DEFINE_TYPE_INTRUSIVE(type, member...)`
 
@@ -261,18 +103,15 @@ The macro is to be defined inside the class/struct to create code for. Unlike
 [`NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE`](#nlohmann_define_type_non_intrusivetype-member), it can access private members.
 The first parameter is the name of the class/struct, and all remaining parameters name the members.
 
-See [Simplify your life with macros](arbitrary_types.md#simplify-your-life-with-macros) for an example.
-
-The macro was introduced in version 3.9.0.
+See [full documentation of `NLOHMANN_DEFINE_TYPE_INTRUSIVE`](../api/macros/nlohmann_define_type_intrusive.md).
 
 ## `NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT(type, member...)`
 
 This macro is similar to `NLOHMANN_DEFINE_TYPE_INTRUSIVE`. It will not throw an exception in `from_json()` due to a
-missing value in the JSON object, but can throw due to a mismatched type. In order to support that it requires that the
-type be default constructible. The `from_json()` function default constructs an object and uses its values as the
-defaults when calling the `value()` function.
+missing value in the JSON object, but can throw due to a mismatched type. The `from_json()` function default constructs
+an object and uses its values as the defaults when calling the [`value`](../api/basic_json/value.md) function.
 
-The macro was introduced in version 3.11.0.
+See [full documentation of `NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT`](../api/macros/nlohmann_define_type_intrusive.md).
 
 ## `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(type, member...)`
 
@@ -283,29 +122,26 @@ The macro is to be defined inside the namespace of the class/struct to create co
 accessed. Use [`NLOHMANN_DEFINE_TYPE_INTRUSIVE`](#nlohmann_define_type_intrusivetype-member) in these scenarios. The
 first parameter is the name of the class/struct, and all remaining parameters name the members.
 
-See [Simplify your life with macros](arbitrary_types.md#simplify-your-life-with-macros) for an example.
-
-The macro was introduced in version 3.9.0.
+See [full documentation of `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE`](../api/macros/nlohmann_define_type_non_intrusive.md).
 
 ## `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT(type, member...)`
 
 This macro is similar to `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE`. It will not throw an exception in `from_json()` due to a
-missing value in the JSON object, but can throw due to a mismatched type. In order to support that it requires that the
-type be default constructible. The `from_json()` function default constructs an object and uses its values as the
-defaults when calling the `value()` function.
+missing value in the JSON object, but can throw due to a mismatched type. The `from_json()` function default constructs
+an object and uses its values as the defaults when calling the [`value`](../api/basic_json/value.md) function.
 
-The macro was introduced in version 3.11.0.
+See [full documentation of `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT`](../api/macros/nlohmann_define_type_non_intrusive.md).
 
 ## `NLOHMANN_JSON_SERIALIZE_ENUM(type, ...)`
 
 This macro simplifies the serialization/deserialization of enum types. See
 [Specializing enum conversion](enum_conversion.md) for more information.
 
-The macro was introduced in version 3.4.0.
+See [full documentation of `NLOHMANN_JSON_SERIALIZE_ENUM`](../api/macros/nlohmann_json_serialize_enum.md).
 
 ## `NLOHMANN_JSON_VERSION_MAJOR`, `NLOHMANN_JSON_VERSION_MINOR`, `NLOHMANN_JSON_VERSION_PATCH`
 
 These macros are defined by the library and contain the version numbers according to
-[Semantic Versioning 2.0.0](https://semver.org).
+[Semantic Versioning 2.0.0](https://semver.org/spec/v2.0.0.html).
 
-The macros were introduced in version 3.1.0.
+See [full documentation of `NLOHMANN_JSON_VERSION_MAJOR`, `NLOHMANN_JSON_VERSION_MINOR`, and `NLOHMANN_JSON_VERSION_PATCH`](../api/macros/nlohmann_json_version_major.md).
diff --git a/doc/mkdocs/docs/features/types/number_handling.md b/doc/mkdocs/docs/features/types/number_handling.md
index dd6507353..03d8c9c69 100644
--- a/doc/mkdocs/docs/features/types/number_handling.md
+++ b/doc/mkdocs/docs/features/types/number_handling.md
@@ -275,7 +275,7 @@ The rationale is twofold:
 
 ### Determine number types
 
-As the example in [Number conversion](#number_conversion) shows, there are different functions to determine the type of
+As the example in [Number conversion](#number-conversion) shows, there are different functions to determine the type of
 the stored number:
 
 - [`is_number()`](../../api/basic_json/is_number.md) returns `#!c true` for any number type
diff --git a/doc/mkdocs/docs/home/exceptions.md b/doc/mkdocs/docs/home/exceptions.md
index 1241926cf..666d225bd 100644
--- a/doc/mkdocs/docs/home/exceptions.md
+++ b/doc/mkdocs/docs/home/exceptions.md
@@ -28,9 +28,9 @@ class json::parse_error {
 
 ### Switch off exceptions
 
-Exceptions are used widely within the library. They can, however, be switched off with either using the compiler flag `-fno-exceptions` or by defining the symbol `JSON_NOEXCEPTION`. In this case, exceptions are replaced by `abort()` calls. You can further control this behavior by defining `JSON_THROW_USER` (overriding `#!cpp throw`), `JSON_TRY_USER` (overriding `#!cpp try`), and `JSON_CATCH_USER` (overriding `#!cpp catch`).
+Exceptions are used widely within the library. They can, however, be switched off with either using the compiler flag `-fno-exceptions` or by defining the symbol [`JSON_NOEXCEPTION`](../api/macros/json_noexception.md). In this case, exceptions are replaced by `abort()` calls. You can further control this behavior by defining `JSON_THROW_USER` (overriding `#!cpp throw`), `JSON_TRY_USER` (overriding `#!cpp try`), and `JSON_CATCH_USER` (overriding `#!cpp catch`).
 
-Note that `JSON_THROW_USER` should leave the current scope (e.g., by throwing or aborting), as continuing after it may yield undefined behavior.
+Note that [`JSON_THROW_USER`](../api/macros/json_throw_user.md) should leave the current scope (e.g., by throwing or aborting), as continuing after it may yield undefined behavior.
 
 ??? example
 
@@ -52,6 +52,8 @@ Note that `JSON_THROW_USER` should leave the current scope (e.g., by throwing or
 
 Note the explanatory [`what()`](https://en.cppreference.com/w/cpp/error/exception/what) string of exceptions is not available for MSVC if exceptions are disabled, see [#2824](https://github.com/nlohmann/json/discussions/2824).
 
+See [documentation of `JSON_TRY_USER`, `JSON_CATCH_USER` and `JSON_THROW_USER`](../api/macros/json_throw_user.md) for more information.
+
 ### Extended diagnostic messages
 
 Exceptions in the library are thrown in the local context of the JSON value they are detected. This makes detailed diagnostics messages, and hence debugging, difficult.
@@ -88,6 +90,7 @@ As this global context comes at the price of storing one additional pointer per
 
     Now the exception message contains a JSON Pointer `/address/housenumber` that indicates which value has the wrong type.
 
+See [documentation of `JSON_DIAGNOSTICS`](../api/macros/json_diagnostics.md) for more information.
 
 ## Parse errors
 
diff --git a/doc/mkdocs/mkdocs.yml b/doc/mkdocs/mkdocs.yml
index ddd55e5c9..59f0ae700 100644
--- a/doc/mkdocs/mkdocs.yml
+++ b/doc/mkdocs/mkdocs.yml
@@ -64,6 +64,7 @@ nav:
         - features/parsing/parse_exceptions.md
         - features/parsing/parser_callbacks.md
         - features/parsing/sax_interface.md
+    - features/assertions.md
     - features/enum_conversion.md
     - features/macros.md
     - Types:
@@ -232,7 +233,30 @@ nav:
       - 'ordered_map': api/ordered_map.md
       - macros:
         - 'Overview': api/macros/index.md
-        - 'JSON_ASSERT(x)': api/macros/json_assert.md
+        - 'JSON_ASSERT': api/macros/json_assert.md
+        - 'JSON_CATCH_USER': api/macros/json_throw_user.md
+        - 'JSON_DIAGNOSTICS': api/macros/json_diagnostics.md
+        - 'JSON_HAS_CPP_11': api/macros/json_has_cpp_11.md
+        - 'JSON_HAS_CPP_14': api/macros/json_has_cpp_11.md
+        - 'JSON_HAS_CPP_17': api/macros/json_has_cpp_11.md
+        - 'JSON_HAS_CPP_20': api/macros/json_has_cpp_11.md
+        - 'JSON_HAS_EXPERIMENTAL_FILESYSTEM': api/macros/json_has_filesystem.md
+        - 'JSON_HAS_FILESYSTEM': api/macros/json_has_filesystem.md
+        - 'JSON_NOEXCEPTION': api/macros/json_noexception.md
+        - 'JSON_NO_IO': api/macros/json_no_io.md
+        - 'JSON_SKIP_LIBRARY_VERSION_CHECK': api/macros/json_skip_library_version_check.md
+        - 'JSON_SKIP_UNSUPPORTED_COMPILER_CHECK': api/macros/json_skip_unsupported_compiler_check.md
+        - 'JSON_THROW_USER': api/macros/json_throw_user.md
+        - 'JSON_TRY_USER': api/macros/json_throw_user.md
+        - 'JSON_USE_IMPLICIT_CONVERSIONS': api/macros/json_use_implicit_conversions.md
+        - 'NLOHMANN_DEFINE_TYPE_INTRUSIVE': api/macros/nlohmann_define_type_intrusive.md
+        - 'NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT': api/macros/nlohmann_define_type_intrusive.md
+        - 'NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE': api/macros/nlohmann_define_type_non_intrusive.md
+        - 'NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT': api/macros/nlohmann_define_type_non_intrusive.md
+        - 'NLOHMANN_JSON_SERIALIZE_ENUM': api/macros/nlohmann_json_serialize_enum.md
+        - 'NLOHMANN_JSON_VERSION_MAJOR': api/macros/nlohmann_json_version_major.md
+        - 'NLOHMANN_JSON_VERSION_MINOR': api/macros/nlohmann_json_version_major.md
+        - 'NLOHMANN_JSON_VERSION_PATCH': api/macros/nlohmann_json_version_major.md
 
 # Extras
 extra:
@@ -289,6 +313,7 @@ plugins:
         lang: en
     - minify:
         minify_html: true
+    - git-revision-date-localized
 
 extra_javascript:
   - https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-MML-AM_CHTML
diff --git a/doc/mkdocs/requirements.txt b/doc/mkdocs/requirements.txt
index b64e9b873..aa9fcaf0e 100644
--- a/doc/mkdocs/requirements.txt
+++ b/doc/mkdocs/requirements.txt
@@ -1,29 +1,48 @@
-click>=7.1.2
-future>=0.18.2
-htmlmin>=0.1.12
-httplib2>=0.18.1
-importlib-metadata>=1.6.0
-Jinja2>=2.11.2
-joblib>=0.15.1
-jsmin>=2.2.2
-livereload>=2.6.1
-lunr>=0.5.8
-Markdown>=3.2.2
-markdown-include>=0.5.1
-MarkupSafe>=1.1.1
-mkdocs>=1.1.2
-mkdocs-material>=5.2.1
-mkdocs-material-extensions>=1.0
-mkdocs-minify-plugin>=0.3.0
-mkdocs-simple-hooks>=0.1.1
-nltk>=3.5
-plantuml>=0.3.0
-plantuml-markdown>=3.2.2
-Pygments>=2.6.1
-pymdown-extensions>=7.1
-PyYAML>=5.3.1
-regex>=2020.5.14
-six>=1.15.0
-tornado>=6.0.4
-tqdm>=4.46.0
-zipp>=3.1.0
+Babel==2.10.1
+certifi==2021.10.8
+charset-normalizer==2.0.12
+click==8.1.2
+csscompressor==0.9.5
+future==0.18.2
+ghp-import==2.0.2
+gitdb==4.0.9
+GitPython==3.1.27
+htmlmin==0.1.12
+httplib2==0.20.4
+idna==3.3
+importlib-metadata==4.11.3
+Jinja2==3.1.1
+joblib==1.1.0
+jsmin==3.0.1
+livereload==2.6.3
+lunr==0.6.2
+Markdown==3.3.6
+markdown-include==0.6.0
+MarkupSafe==2.1.1
+mergedeep==1.3.4
+mkdocs==1.3.0
+mkdocs-git-revision-date-localized-plugin==1.0.1
+mkdocs-material==8.2.10
+mkdocs-material-extensions==1.0.3
+mkdocs-minify-plugin==0.5.0
+mkdocs-simple-hooks==0.1.5
+nltk==3.7
+packaging==21.3
+plantuml==0.3.0
+plantuml-markdown==3.5.2
+Pygments==2.11.0
+pymdown-extensions==9.3
+pyparsing==3.0.8
+python-dateutil==2.8.2
+pytz==2022.1
+PyYAML==6.0
+pyyaml_env_tag==0.1
+regex==2022.4.24
+requests==2.27.1
+six==1.16.0
+smmap==5.0.0
+tornado==6.1
+tqdm==4.64.0
+urllib3==1.26.9
+watchdog==2.1.7
+zipp==3.8.0
diff --git a/doc/mkdocs/scripts/check_structure.py b/doc/mkdocs/scripts/check_structure.py
old mode 100644
new mode 100755
index cacc51cb4..92f6ff182
--- a/doc/mkdocs/scripts/check_structure.py
+++ b/doc/mkdocs/scripts/check_structure.py
@@ -2,10 +2,19 @@
 
 import glob
 import os.path
+import re
+
+warnings = 0
+
+
+def report(rule, location, description):
+    global warnings
+    warnings += 1
+    print(f'{warnings:3}. {location}:  {description} [{rule}]')
 
 
 def check_structure():
-    expected_headers = [
+    expected_sections = [
         'Template parameters',
         'Specializations',
         'Iterator invalidation',
@@ -23,13 +32,14 @@ def check_structure():
         'Exceptions',
         'Complexity',
         'Possible implementation',
+        'Default definition',
         'Notes',
         'Examples',
         'See also',
         'Version history'
     ]
 
-    required_headers = [
+    required_sections = [
         'Examples',
         'Version history'
     ]
@@ -37,8 +47,8 @@ def check_structure():
     files = sorted(glob.glob('api/**/*.md', recursive=True))
     for file in files:
         with open(file) as file_content:
-            header_idx = -1
-            existing_headers = []
+            section_idx = -1
+            existing_sections = []
             in_initial_code_example = False
             previous_line = None
             h1sections = 0
@@ -51,50 +61,55 @@ def check_structure():
 
                 # there should only be one top-level title
                 if h1sections > 1:
-                    print(f'{file}:{lineno+1}: Error: unexpected top-level title "{line}"!')
+                    report('structure/unexpected_section', f'{file}:{lineno+1}', f'unexpected top-level title "{line}"')
                     h1sections = 1
 
                 # Overview pages should have a better title
                 if line == '# Overview':
-                    print(f'{file}:{lineno+1}: Error: overview pages should have a better title!')
+                    report('style/title', f'{file}:{lineno+1}', 'overview pages should have a better title than "Overview"')
 
                 # lines longer than 160 characters are bad (unless they are tables)
                 if len(line) > 160 and '|' not in line:
-                    print(f'{file}:{lineno+1}: Error: line is too long ({len(line)} vs. 160 chars)!')
+                    report('whitespace/line_length', f'{file}:{lineno+1}', f'line is too long ({len(line)} vs. 160 chars)')
 
-                # check if headers are correct
+                # check if sections are correct
                 if line.startswith('## '):
-                    header = line.strip('## ')
-                    existing_headers.append(header)
+                    current_section = line.strip('## ')
+                    existing_sections.append(current_section)
 
-                    if header in expected_headers:
-                        idx = expected_headers.index(header)
-                        if idx <= header_idx:
-                            print(f'{file}:{lineno+1}: Error: header "{header}" is in an unexpected order (should be before "{expected_headers[header_idx]}")!')
-                        header_idx = idx
+                    if current_section in expected_sections:
+                        idx = expected_sections.index(current_section)
+                        if idx <= section_idx:
+                            report('structure/section_order', f'{file}:{lineno+1}', f'section "{current_section}" is in an unexpected order (should be before "{expected_sections[section_idx]}")')
+                        section_idx = idx
                     else:
-                        print(f'{file}:{lineno+1}: Error: header "{header}" is not part of the expected headers!')
+                        report('structure/unknown_section', f'{file}:{lineno+1}', f'section "{current_section}" is not part of the expected sections')
 
                 # code example
-                if line == '```cpp' and header_idx == -1:
+                if line == '```cpp' and section_idx == -1:
                     in_initial_code_example = True
 
                 if in_initial_code_example and line.startswith('//'):
                     if any(map(str.isdigit, line)) and '(' not in line:
-                        print(f'{file}:{lineno+1}: Number should be in parentheses: {line}')
+                        report('style/numbering', f'{file}:{lineno+1}', 'number should be in parentheses: {line}')
 
                 if line == '```' and in_initial_code_example:
                     in_initial_code_example = False
 
                 # consecutive blank lines are bad
                 if line == '' and previous_line == '':
-                    print(f'{file}:{lineno}-{lineno+1}: Error: Consecutive blank lines!')
+                    report('whitespace/blank_lines', f'{file}:{lineno}-{lineno+1}', 'consecutive blank lines')
+
+                # check that non-example admonitions have titles
+                untitled_admonition = re.match(r'^(\?\?\?|!!!) ([^ ]+)$', line)
+                if untitled_admonition and untitled_admonition.group(2) != 'example':
+                    report('style/admonition_title', f'{file}:{lineno}', f'"{untitled_admonition.group(2)}" admonitions should have a title')
 
                 previous_line = line
 
-            for required_header in required_headers:
-                if required_header not in existing_headers:
-                    print(f'{file}:{lineno+1}: Error: required header "{required_header}" was not found!')
+            for required_section in required_sections:
+                if required_section not in existing_sections:
+                    report('structure/missing_section', f'{file}:{lineno+1}', f'required section "{required_section}" was not found')
 
 
 def check_examples():
@@ -113,9 +128,11 @@ def check_examples():
                 break
 
         if not found:
-            print(f'{example_file}: Error: example file is not used in any documentation file!')
+            report('examples/missing', f'{example_file}', 'example file is not used in any documentation file')
 
 
 if __name__ == '__main__':
+    print(120 * '-')
     check_structure()
     check_examples()
+    print(120 * '-')

From ee516614813c4ef5762d436f26f2138f09c96410 Mon Sep 17 00:00:00 2001
From: Qianqian Fang <fangqq@gmail.com>
Date: Fri, 29 Apr 2022 15:17:30 -0400
Subject: [PATCH 04/30] Support UBJSON-derived Binary JData (BJData) format
 (#3336)

* support UBJSON-derived Binary JData (BJData) format

* fix Codacy warning

* partially fix VS compilation errors

* fix additional VS errors

* fix more VS compilation errors

* fix additional warnings and errors for clang and msvc

* add more tests to cover the new bjdata types

* add tests for optimized ndarray, improve coverage, fix clang/gcc warnings

* gcc warn useless conversion but msvc gives an error

* fix ci_test errors

* complete test coverage, fix ci_test errors

* add half precision error test

* fix No newline at end of file error by clang

* simplify endian condition, format unit-bjdata

* remove broken test due to alloc limit

* full coverage, I hope

* move bjdata new markers from default to the same level as ubjson markers

* fix ci errors, add tests for new bjdata switch structure

* make is_bjdata const after using initializer list

* remove the unwanted assert

* move is_bjdata to an optional param to write_ubjson

* pass use_bjdata via output adapter

* revert order to avoid msvc 2015 unreferenced formal param error

* update BJData Spect V1 Draft-2 URL after spec release

* amalgamate code

* code polishing following @gregmarr's feedback

* make use_bjdata a non-default parameter

* fix ci error, remove unwanted param comment

* encode and decode bjdata ndarray in jdata annotations, enable roundtrip tests

* partially fix ci errors, add tests to improve coverage

* polish patch to remove ci errors

* fix a ndarray dim vector condition

* fix clang tidy error

* add sax test cases for ndarray

* add additional sax event tests

* adjust sax event numbering

* fix sax tests

* ndarray can only be used with array containers, discard if used in object

* complete test coverage

* disable [{SHTFNZ in optimized type due to security risks in #2793 and hampered readability

* fix ci error

* move OutputIsLittleEndian from tparam to param to replace use_bjdata

* fix ci clang gcc error

* fix ci static analysis error

* update json_test_data to 3.1.0, enable file-based bjdata unit tests

* fix stack overflow error on msvc 2019 and 2022

* use https link, update sax_parse_error after rebase

* make input_format const and use initializer

* return bool for write_bjdata_ndarray

* test write_bjdata_ndarray return value as boolean

* fix ci error
---
 README.md                                     |    6 +-
 cmake/ci.cmake                                |    2 +-
 cmake/download_test_data.cmake                |    2 +-
 .../nlohmann/detail/input/binary_reader.hpp   |  420 ++-
 .../nlohmann/detail/input/input_adapters.hpp  |    2 +-
 .../nlohmann/detail/output/binary_writer.hpp  |  291 +-
 include/nlohmann/json.hpp                     |  111 +-
 single_include/nlohmann/json.hpp              |  824 +++-
 test/CMakeLists.txt                           |    2 +-
 test/Makefile                                 |    5 +-
 test/src/fuzzer-parse_bjdata.cpp              |   84 +
 test/src/unit-bjdata.cpp                      | 3355 +++++++++++++++++
 12 files changed, 4877 insertions(+), 227 deletions(-)
 create mode 100644 test/src/fuzzer-parse_bjdata.cpp
 create mode 100644 test/src/unit-bjdata.cpp

diff --git a/README.md b/README.md
index 20e7c48ea..c3990a69b 100644
--- a/README.md
+++ b/README.md
@@ -32,7 +32,7 @@
   - [Implicit conversions](#implicit-conversions)
   - [Conversions to/from arbitrary types](#arbitrary-types-conversions)
   - [Specializing enum conversion](#specializing-enum-conversion)
-  - [Binary formats (BSON, CBOR, MessagePack, and UBJSON)](#binary-formats-bson-cbor-messagepack-and-ubjson)
+  - [Binary formats (BSON, CBOR, MessagePack, UBJSON, and BJData)](#binary-formats-bson-cbor-messagepack-ubjson-and-bjdata)
 - [Supported compilers](#supported-compilers)
 - [Integration](#integration)
   - [CMake](#cmake)
@@ -961,9 +961,9 @@ Other Important points:
 - When using `get<ENUM_TYPE>()`, undefined JSON values will default to the first pair specified in your map. Select this default pair carefully.
 - If an enum or JSON value is specified more than once in your map, the first matching occurrence from the top of the map will be returned when converting to or from JSON.
 
-### Binary formats (BSON, CBOR, MessagePack, and UBJSON)
+### Binary formats (BSON, CBOR, MessagePack, UBJSON, and BJData)
 
-Though JSON is a ubiquitous data format, it is not a very compact format suitable for data exchange, for instance over a network. Hence, the library supports [BSON](https://bsonspec.org) (Binary JSON), [CBOR](https://cbor.io) (Concise Binary Object Representation), [MessagePack](https://msgpack.org), and [UBJSON](https://ubjson.org) (Universal Binary JSON Specification) to efficiently encode JSON values to byte vectors and to decode such vectors.
+Though JSON is a ubiquitous data format, it is not a very compact format suitable for data exchange, for instance over a network. Hence, the library supports [BSON](https://bsonspec.org) (Binary JSON), [CBOR](https://cbor.io) (Concise Binary Object Representation), [MessagePack](https://msgpack.org), [UBJSON](https://ubjson.org) (Universal Binary JSON Specification) and [BJData](https://neurojson.org/bjdata) (Binary JData) to efficiently encode JSON values to byte vectors and to decode such vectors.
 
 ```cpp
 // create a JSON value
diff --git a/cmake/ci.cmake b/cmake/ci.cmake
index be564fa99..5ae05a9d9 100644
--- a/cmake/ci.cmake
+++ b/cmake/ci.cmake
@@ -683,7 +683,7 @@ add_custom_target(ci_infer
 
 add_custom_target(ci_offline_testdata
     COMMAND mkdir -p ${PROJECT_BINARY_DIR}/build_offline_testdata/test_data
-    COMMAND cd ${PROJECT_BINARY_DIR}/build_offline_testdata/test_data && ${GIT_TOOL} clone -c advice.detachedHead=false --branch v3.0.0 https://github.com/nlohmann/json_test_data.git --quiet --depth 1
+    COMMAND cd ${PROJECT_BINARY_DIR}/build_offline_testdata/test_data && ${GIT_TOOL} clone -c advice.detachedHead=false --branch v3.1.0 https://github.com/nlohmann/json_test_data.git --quiet --depth 1
     COMMAND ${CMAKE_COMMAND}
         -DCMAKE_BUILD_TYPE=Debug -GNinja
         -DJSON_BuildTests=ON -DJSON_FastTests=ON -DJSON_TestDataDirectory=${PROJECT_BINARY_DIR}/build_offline_testdata/test_data/json_test_data
diff --git a/cmake/download_test_data.cmake b/cmake/download_test_data.cmake
index f516a7c3b..1bb998dae 100644
--- a/cmake/download_test_data.cmake
+++ b/cmake/download_test_data.cmake
@@ -1,5 +1,5 @@
 set(JSON_TEST_DATA_URL     https://github.com/nlohmann/json_test_data)
-set(JSON_TEST_DATA_VERSION 3.0.0)
+set(JSON_TEST_DATA_VERSION 3.1.0)
 
 # if variable is set, use test data from given directory rather than downloading them
 if(JSON_TestDataDirectory)
diff --git a/include/nlohmann/detail/input/binary_reader.hpp b/include/nlohmann/detail/input/binary_reader.hpp
index 4041cedba..6474b8b05 100644
--- a/include/nlohmann/detail/input/binary_reader.hpp
+++ b/include/nlohmann/detail/input/binary_reader.hpp
@@ -12,6 +12,7 @@
 #include <string> // char_traits, string
 #include <utility> // make_pair, move
 #include <vector> // vector
+#include <map> // map
 
 #include <nlohmann/detail/exceptions.hpp>
 #include <nlohmann/detail/input/input_adapters.hpp>
@@ -74,7 +75,7 @@ class binary_reader
 
     @param[in] adapter  input adapter to read from
     */
-    explicit binary_reader(InputAdapterType&& adapter) noexcept : ia(std::move(adapter))
+    explicit binary_reader(InputAdapterType&& adapter, const input_format_t format = input_format_t::json) noexcept : ia(std::move(adapter)), input_format(format)
     {
         (void)detail::is_sax_static_asserts<SAX, BasicJsonType> {};
     }
@@ -118,6 +119,7 @@ class binary_reader
                 break;
 
             case input_format_t::ubjson:
+            case input_format_t::bjdata:
                 result = parse_ubjson_internal();
                 break;
 
@@ -129,7 +131,7 @@ class binary_reader
         // strict mode: next byte must be EOF
         if (result && strict)
         {
-            if (format == input_format_t::ubjson)
+            if (input_format == input_format_t::ubjson || input_format == input_format_t::bjdata)
             {
                 get_ignore_noop();
             }
@@ -141,7 +143,7 @@ class binary_reader
             if (JSON_HEDLEY_UNLIKELY(current != std::char_traits<char_type>::eof()))
             {
                 return sax->parse_error(chars_read, get_token_string(), parse_error::create(110, chars_read,
-                                        exception_message(format, concat("expected end of input; last byte: 0x", get_token_string()), "value"), nullptr));
+                                        exception_message(input_format, concat("expected end of input; last byte: 0x", get_token_string()), "value"), nullptr));
             }
         }
 
@@ -1844,7 +1846,7 @@ class binary_reader
             get();  // TODO(niels): may we ignore N here?
         }
 
-        if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "value")))
+        if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "value")))
         {
             return false;
         }
@@ -1854,52 +1856,154 @@ class binary_reader
             case 'U':
             {
                 std::uint8_t len{};
-                return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, len, result);
+                return get_number(input_format, len) && get_string(input_format, len, result);
             }
 
             case 'i':
             {
                 std::int8_t len{};
-                return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, len, result);
+                return get_number(input_format, len) && get_string(input_format, len, result);
             }
 
             case 'I':
             {
                 std::int16_t len{};
-                return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, len, result);
+                return get_number(input_format, len) && get_string(input_format, len, result);
             }
 
             case 'l':
             {
                 std::int32_t len{};
-                return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, len, result);
+                return get_number(input_format, len) && get_string(input_format, len, result);
             }
 
             case 'L':
             {
                 std::int64_t len{};
-                return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, len, result);
+                return get_number(input_format, len) && get_string(input_format, len, result);
+            }
+
+            case 'u':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint16_t len{};
+                return get_number(input_format, len) && get_string(input_format, len, result);
+            }
+
+            case 'm':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint32_t len{};
+                return get_number(input_format, len) && get_string(input_format, len, result);
+            }
+
+            case 'M':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint64_t len{};
+                return get_number(input_format, len) && get_string(input_format, len, result);
             }
 
             default:
-                auto last_token = get_token_string();
-                return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read,
-                                        exception_message(input_format_t::ubjson, concat("expected length type specification (U, i, I, l, L); last byte: 0x", last_token), "string"), nullptr));
+                break;
         }
+        auto last_token = get_token_string();
+        std::string message;
+
+        if (input_format != input_format_t::bjdata)
+        {
+            message = "expected length type specification (U, i, I, l, L); last byte: 0x" + last_token;
+        }
+        else
+        {
+            message = "expected length type specification (U, i, u, I, m, l, M, L); last byte: 0x" + last_token;
+        }
+        return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read, exception_message(input_format, message, "string"), nullptr));
+    }
+
+    /*!
+    @param[out] dim  an integer vector storing the ND array dimensions
+    @return whether reading ND array size vector is successful
+    */
+    bool get_ubjson_ndarray_size(std::vector<size_t>& dim)
+    {
+        std::pair<std::size_t, char_int_type> size_and_type;
+        size_t dimlen = 0;
+
+        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type)))
+        {
+            return false;
+        }
+
+        if (size_and_type.first != string_t::npos)
+        {
+            if (size_and_type.second != 0)
+            {
+                if (size_and_type.second != 'N')
+                {
+                    for (std::size_t i = 0; i < size_and_type.first; ++i)
+                    {
+                        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, size_and_type.second)))
+                        {
+                            return false;
+                        }
+                        dim.push_back(dimlen);
+                    }
+                }
+            }
+            else
+            {
+                for (std::size_t i = 0; i < size_and_type.first; ++i)
+                {
+                    if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen)))
+                    {
+                        return false;
+                    }
+                    dim.push_back(dimlen);
+                }
+            }
+        }
+        else
+        {
+            while (current != ']')
+            {
+                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, current)))
+                {
+                    return false;
+                }
+                dim.push_back(dimlen);
+                get_ignore_noop();
+            }
+        }
+        return true;
     }
 
     /*!
     @param[out] result  determined size
     @return whether size determination completed
     */
-    bool get_ubjson_size_value(std::size_t& result)
+    bool get_ubjson_size_value(std::size_t& result, char_int_type prefix = 0)
     {
-        switch (get_ignore_noop())
+        if (prefix == 0)
+        {
+            prefix = get_ignore_noop();
+        }
+
+        switch (prefix)
         {
             case 'U':
             {
                 std::uint8_t number{};
-                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
                 {
                     return false;
                 }
@@ -1910,7 +2014,7 @@ class binary_reader
             case 'i':
             {
                 std::int8_t number{};
-                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
                 {
                     return false;
                 }
@@ -1921,7 +2025,7 @@ class binary_reader
             case 'I':
             {
                 std::int16_t number{};
-                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
                 {
                     return false;
                 }
@@ -1932,7 +2036,7 @@ class binary_reader
             case 'l':
             {
                 std::int32_t number{};
-                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
                 {
                     return false;
                 }
@@ -1943,7 +2047,7 @@ class binary_reader
             case 'L':
             {
                 std::int64_t number{};
-                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
                 {
                     return false;
                 }
@@ -1951,13 +2055,105 @@ class binary_reader
                 return true;
             }
 
-            default:
+            case 'u':
             {
-                auto last_token = get_token_string();
-                return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read,
-                                        exception_message(input_format_t::ubjson, concat("expected length type specification (U, i, I, l, L) after '#'; last byte: 0x", last_token), "size"), nullptr));
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint16_t number{};
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
+                {
+                    return false;
+                }
+                result = static_cast<std::size_t>(number);
+                return true;
             }
+
+            case 'm':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint32_t number{};
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
+                {
+                    return false;
+                }
+                result = static_cast<std::size_t>(number);
+                return true;
+            }
+
+            case 'M':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint64_t number{};
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
+                {
+                    return false;
+                }
+                result = detail::conditional_static_cast<std::size_t>(number);
+                return true;
+            }
+
+            case '[':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::vector<size_t> dim;
+                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_ndarray_size(dim)))
+                {
+                    return false;
+                }
+                if (dim.size() == 1 || (dim.size() == 2 && dim.at(0) == 1)) // return normal array size if 1D row vector
+                {
+                    result = dim.at(dim.size() - 1);
+                    return true;
+                }
+                if (!dim.empty())  // if ndarray, convert to an object in JData annotated array format
+                {
+                    string_t key = "_ArraySize_";
+                    if (JSON_HEDLEY_UNLIKELY(!sax->start_object(3) || !sax->key(key) || !sax->start_array(dim.size())))
+                    {
+                        return false;
+                    }
+                    result = 1;
+                    for (auto i : dim)
+                    {
+                        result *= i;
+                        if (JSON_HEDLEY_UNLIKELY(!sax->number_integer(static_cast<number_integer_t>(i))))
+                        {
+                            return false;
+                        }
+                    }
+                    result |= (1ull << (sizeof(result) * 8 - 1)); // low 63 bit of result stores the total element count, sign-bit indicates ndarray
+                    return sax->end_array();
+                }
+                result = 0;
+                return true;
+            }
+
+            default:
+                break;
         }
+        auto last_token = get_token_string();
+        std::string message;
+
+        if (input_format != input_format_t::bjdata)
+        {
+            message = "expected length type specification (U, i, I, l, L) after '#'; last byte: 0x" + last_token;
+        }
+        else
+        {
+            message = "expected length type specification (U, i, u, I, m, l, M, L) after '#'; last byte: 0x" + last_token;
+        }
+        return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read, exception_message(input_format, message, "size"), nullptr));
     }
 
     /*!
@@ -1979,8 +2175,10 @@ class binary_reader
 
         if (current == '$')
         {
+            std::vector<char_int_type> bjdx = {'[', '{', 'S', 'H', 'T', 'F', 'N', 'Z'}; // excluded markers in bjdata optimized type
+
             result.second = get();  // must not ignore 'N', because 'N' maybe the type
-            if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "type")))
+            if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "type") || (input_format == input_format_t::bjdata && std::find(bjdx.begin(), bjdx.end(), result.second) != bjdx.end() )))
             {
                 return false;
             }
@@ -1988,13 +2186,13 @@ class binary_reader
             get_ignore_noop();
             if (JSON_HEDLEY_UNLIKELY(current != '#'))
             {
-                if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "value")))
+                if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "value")))
                 {
                     return false;
                 }
                 auto last_token = get_token_string();
                 return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
-                                        exception_message(input_format_t::ubjson, concat("expected '#' after type information; last byte: 0x", last_token), "size"), nullptr));
+                                        exception_message(input_format, concat("expected '#' after type information; last byte: 0x", last_token), "size"), nullptr));
             }
 
             return get_ubjson_size_value(result.first);
@@ -2017,7 +2215,7 @@ class binary_reader
         switch (prefix)
         {
             case std::char_traits<char_type>::eof():  // EOF
-                return unexpect_eof(input_format_t::ubjson, "value");
+                return unexpect_eof(input_format, "value");
 
             case 'T':  // true
                 return sax->boolean(true);
@@ -2030,43 +2228,125 @@ class binary_reader
             case 'U':
             {
                 std::uint8_t number{};
-                return get_number(input_format_t::ubjson, number) && sax->number_unsigned(number);
+                return get_number(input_format, number) && sax->number_unsigned(number);
             }
 
             case 'i':
             {
                 std::int8_t number{};
-                return get_number(input_format_t::ubjson, number) && sax->number_integer(number);
+                return get_number(input_format, number) && sax->number_integer(number);
             }
 
             case 'I':
             {
                 std::int16_t number{};
-                return get_number(input_format_t::ubjson, number) && sax->number_integer(number);
+                return get_number(input_format, number) && sax->number_integer(number);
             }
 
             case 'l':
             {
                 std::int32_t number{};
-                return get_number(input_format_t::ubjson, number) && sax->number_integer(number);
+                return get_number(input_format, number) && sax->number_integer(number);
             }
 
             case 'L':
             {
                 std::int64_t number{};
-                return get_number(input_format_t::ubjson, number) && sax->number_integer(number);
+                return get_number(input_format, number) && sax->number_integer(number);
+            }
+
+            case 'u':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint16_t number{};
+                return get_number(input_format, number) && sax->number_unsigned(number);
+            }
+
+            case 'm':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint32_t number{};
+                return get_number(input_format, number) && sax->number_unsigned(number);
+            }
+
+            case 'M':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint64_t number{};
+                return get_number(input_format, number) && sax->number_unsigned(number);
+            }
+
+            case 'h':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                const auto byte1_raw = get();
+                if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "number")))
+                {
+                    return false;
+                }
+                const auto byte2_raw = get();
+                if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "number")))
+                {
+                    return false;
+                }
+
+                const auto byte1 = static_cast<unsigned char>(byte1_raw);
+                const auto byte2 = static_cast<unsigned char>(byte2_raw);
+
+                // code from RFC 7049, Appendix D, Figure 3:
+                // As half-precision floating-point numbers were only added
+                // to IEEE 754 in 2008, today's programming platforms often
+                // still only have limited support for them. It is very
+                // easy to include at least decoding support for them even
+                // without such support. An example of a small decoder for
+                // half-precision floating-point numbers in the C language
+                // is shown in Fig. 3.
+                const auto half = static_cast<unsigned int>((byte2 << 8u) + byte1);
+                const double val = [&half]
+                {
+                    const int exp = (half >> 10u) & 0x1Fu;
+                    const unsigned int mant = half & 0x3FFu;
+                    JSON_ASSERT(0 <= exp&& exp <= 32);
+                    JSON_ASSERT(mant <= 1024);
+                    switch (exp)
+                    {
+                        case 0:
+                            return std::ldexp(mant, -24);
+                        case 31:
+                            return (mant == 0)
+                            ? std::numeric_limits<double>::infinity()
+                            : std::numeric_limits<double>::quiet_NaN();
+                        default:
+                            return std::ldexp(mant + 1024, exp - 25);
+                    }
+                }();
+                return sax->number_float((half & 0x8000u) != 0
+                                         ? static_cast<number_float_t>(-val)
+                                         : static_cast<number_float_t>(val), "");
             }
 
             case 'd':
             {
                 float number{};
-                return get_number(input_format_t::ubjson, number) && sax->number_float(static_cast<number_float_t>(number), "");
+                return get_number(input_format, number) && sax->number_float(static_cast<number_float_t>(number), "");
             }
 
             case 'D':
             {
                 double number{};
-                return get_number(input_format_t::ubjson, number) && sax->number_float(static_cast<number_float_t>(number), "");
+                return get_number(input_format, number) && sax->number_float(static_cast<number_float_t>(number), "");
             }
 
             case 'H':
@@ -2077,7 +2357,7 @@ class binary_reader
             case 'C':  // char
             {
                 get();
-                if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "char")))
+                if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "char")))
                 {
                     return false;
                 }
@@ -2085,7 +2365,7 @@ class binary_reader
                 {
                     auto last_token = get_token_string();
                     return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read,
-                                            exception_message(input_format_t::ubjson, concat("byte after 'C' must be in range 0x00..0x7F; last byte: 0x", last_token), "char"), nullptr));
+                                            exception_message(input_format, concat("byte after 'C' must be in range 0x00..0x7F; last byte: 0x", last_token), "char"), nullptr));
                 }
                 string_t s(1, static_cast<typename string_t::value_type>(current));
                 return sax->string(s);
@@ -2104,12 +2384,10 @@ class binary_reader
                 return get_ubjson_object();
 
             default: // anything else
-            {
-                auto last_token = get_token_string();
-                return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
-                                        exception_message(input_format_t::ubjson, concat("invalid byte: 0x", last_token), "value"), nullptr));
-            }
+                break;
         }
+        auto last_token = get_token_string();
+        return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read, exception_message(input_format, "invalid byte: 0x" + last_token, "value"), nullptr));
     }
 
     /*!
@@ -2123,6 +2401,44 @@ class binary_reader
             return false;
         }
 
+        // detect and encode bjdata ndarray as an object in JData annotated array format (https://github.com/NeuroJSON/jdata):
+        // {"_ArrayType_" : "typeid", "_ArraySize_" : [n1, n2, ...], "_ArrayData_" : [v1, v2, ...]}
+
+        if (input_format == input_format_t::bjdata && size_and_type.first != string_t::npos && size_and_type.first >= (1ull << (sizeof(std::size_t) * 8 - 1)))
+        {
+            std::map<char_int_type, string_t> bjdtype = {{'U', "uint8"},  {'i', "int8"},  {'u', "uint16"}, {'I', "int16"},
+                {'m', "uint32"}, {'l', "int32"}, {'M', "uint64"}, {'L', "int64"}, {'d', "single"}, {'D', "double"}, {'C', "char"}
+            };
+
+            string_t key = "_ArrayType_";
+            if (JSON_HEDLEY_UNLIKELY(bjdtype.count(size_and_type.second) == 0 || !sax->key(key) || !sax->string(bjdtype[size_and_type.second]) ))
+            {
+                return false;
+            }
+
+            if (size_and_type.second == 'C')
+            {
+                size_and_type.second = 'U';
+            }
+
+            size_and_type.first &= ~(1ull << (sizeof(std::size_t) * 8 - 1));
+            key = "_ArrayData_";
+            if (JSON_HEDLEY_UNLIKELY(!sax->key(key) || !sax->start_array(size_and_type.first) ))
+            {
+                return false;
+            }
+
+            for (std::size_t i = 0; i < size_and_type.first; ++i)
+            {
+                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_value(size_and_type.second)))
+                {
+                    return false;
+                }
+            }
+
+            return (sax->end_array() && sax->end_object());
+        }
+
         if (size_and_type.first != string_t::npos)
         {
             if (JSON_HEDLEY_UNLIKELY(!sax->start_array(size_and_type.first)))
@@ -2185,6 +2501,11 @@ class binary_reader
             return false;
         }
 
+        if (input_format == input_format_t::bjdata && size_and_type.first != string_t::npos && size_and_type.first >= (1ull << (sizeof(std::size_t) * 8 - 1)))
+        {
+            return false;
+        }
+
         string_t key;
         if (size_and_type.first != string_t::npos)
         {
@@ -2267,7 +2588,7 @@ class binary_reader
         for (std::size_t i = 0; i < size; ++i)
         {
             get();
-            if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "number")))
+            if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "number")))
             {
                 return false;
             }
@@ -2286,7 +2607,7 @@ class binary_reader
         if (JSON_HEDLEY_UNLIKELY(result_remainder != token_type::end_of_input))
         {
             return sax->parse_error(chars_read, number_string, parse_error::create(115, chars_read,
-                                    exception_message(input_format_t::ubjson, concat("invalid number text: ", number_lexer.get_token_string()), "high-precision number"), nullptr));
+                                    exception_message(input_format, concat("invalid number text: ", number_lexer.get_token_string()), "high-precision number"), nullptr));
         }
 
         switch (result_number)
@@ -2313,7 +2634,7 @@ class binary_reader
             case token_type::literal_or_value:
             default:
                 return sax->parse_error(chars_read, number_string, parse_error::create(115, chars_read,
-                                        exception_message(input_format_t::ubjson, concat("invalid number text: ", number_lexer.get_token_string()), "high-precision number"), nullptr));
+                                        exception_message(input_format, concat("invalid number text: ", number_lexer.get_token_string()), "high-precision number"), nullptr));
         }
     }
 
@@ -2362,6 +2683,8 @@ class binary_reader
     @note This function needs to respect the system's endianness, because
           bytes in CBOR, MessagePack, and UBJSON are stored in network order
           (big endian) and therefore need reordering on little endian systems.
+          On the other hand, BSON and BJData use little endian and should reorder
+          on big endian systems.
     */
     template<typename NumberType, bool InputIsLittleEndian = false>
     bool get_number(const input_format_t format, NumberType& result)
@@ -2377,7 +2700,7 @@ class binary_reader
             }
 
             // reverse byte order prior to conversion if necessary
-            if (is_little_endian != InputIsLittleEndian)
+            if (is_little_endian != (InputIsLittleEndian || format == input_format_t::bjdata))
             {
                 vec[sizeof(NumberType) - i - 1] = static_cast<std::uint8_t>(current);
             }
@@ -2514,6 +2837,10 @@ class binary_reader
                 error_msg += "BSON";
                 break;
 
+            case input_format_t::bjdata:
+                error_msg += "BJData";
+                break;
+
             case input_format_t::json: // LCOV_EXCL_LINE
             default:            // LCOV_EXCL_LINE
                 JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert) LCOV_EXCL_LINE
@@ -2535,6 +2862,9 @@ class binary_reader
     /// whether we can assume little endianness
     const bool is_little_endian = little_endianness();
 
+    /// input format
+    const input_format_t input_format = input_format_t::json;
+
     /// the SAX parser
     json_sax_t* sax = nullptr;
 };
diff --git a/include/nlohmann/detail/input/input_adapters.hpp b/include/nlohmann/detail/input/input_adapters.hpp
index d196aec54..4c1ad3cef 100644
--- a/include/nlohmann/detail/input/input_adapters.hpp
+++ b/include/nlohmann/detail/input/input_adapters.hpp
@@ -23,7 +23,7 @@ namespace nlohmann
 namespace detail
 {
 /// the supported input formats
-enum class input_format_t { json, cbor, msgpack, ubjson, bson };
+enum class input_format_t { json, cbor, msgpack, ubjson, bson, bjdata };
 
 ////////////////////
 // input adapters //
diff --git a/include/nlohmann/detail/output/binary_writer.hpp b/include/nlohmann/detail/output/binary_writer.hpp
index c018b8ccd..bb44a1811 100644
--- a/include/nlohmann/detail/output/binary_writer.hpp
+++ b/include/nlohmann/detail/output/binary_writer.hpp
@@ -2,12 +2,14 @@
 
 #include <algorithm> // reverse
 #include <array> // array
+#include <map> // map
 #include <cmath> // isnan, isinf
 #include <cstdint> // uint8_t, uint16_t, uint32_t, uint64_t
 #include <cstring> // memcpy
 #include <limits> // numeric_limits
 #include <string> // string
 #include <utility> // move
+#include <vector> // vector
 
 #include <nlohmann/detail/input/binary_reader.hpp>
 #include <nlohmann/detail/macro_scope.hpp>
@@ -724,9 +726,11 @@ class binary_writer
     @param[in] use_count   whether to use '#' prefixes (optimized format)
     @param[in] use_type    whether to use '$' prefixes (optimized format)
     @param[in] add_prefix  whether prefixes need to be used for this value
+    @param[in] use_bjdata  whether write in BJData format, default is false
     */
     void write_ubjson(const BasicJsonType& j, const bool use_count,
-                      const bool use_type, const bool add_prefix = true)
+                      const bool use_type, const bool add_prefix = true,
+                      const bool use_bjdata = false)
     {
         switch (j.type())
         {
@@ -752,19 +756,19 @@ class binary_writer
 
             case value_t::number_integer:
             {
-                write_number_with_ubjson_prefix(j.m_value.number_integer, add_prefix);
+                write_number_with_ubjson_prefix(j.m_value.number_integer, add_prefix, use_bjdata);
                 break;
             }
 
             case value_t::number_unsigned:
             {
-                write_number_with_ubjson_prefix(j.m_value.number_unsigned, add_prefix);
+                write_number_with_ubjson_prefix(j.m_value.number_unsigned, add_prefix, use_bjdata);
                 break;
             }
 
             case value_t::number_float:
             {
-                write_number_with_ubjson_prefix(j.m_value.number_float, add_prefix);
+                write_number_with_ubjson_prefix(j.m_value.number_float, add_prefix, use_bjdata);
                 break;
             }
 
@@ -774,7 +778,7 @@ class binary_writer
                 {
                     oa->write_character(to_char_type('S'));
                 }
-                write_number_with_ubjson_prefix(j.m_value.string->size(), true);
+                write_number_with_ubjson_prefix(j.m_value.string->size(), true, use_bjdata);
                 oa->write_characters(
                     reinterpret_cast<const CharType*>(j.m_value.string->c_str()),
                     j.m_value.string->size());
@@ -792,14 +796,16 @@ class binary_writer
                 if (use_type && !j.m_value.array->empty())
                 {
                     JSON_ASSERT(use_count);
-                    const CharType first_prefix = ubjson_prefix(j.front());
+                    const CharType first_prefix = ubjson_prefix(j.front(), use_bjdata);
                     const bool same_prefix = std::all_of(j.begin() + 1, j.end(),
-                                                         [this, first_prefix](const BasicJsonType & v)
+                                                         [this, first_prefix, use_bjdata](const BasicJsonType & v)
                     {
-                        return ubjson_prefix(v) == first_prefix;
+                        return ubjson_prefix(v, use_bjdata) == first_prefix;
                     });
 
-                    if (same_prefix)
+                    std::vector<CharType> bjdx = {'[', '{', 'S', 'H', 'T', 'F', 'N', 'Z'}; // excluded markers in bjdata optimized type
+
+                    if (same_prefix && !(use_bjdata && std::find(bjdx.begin(), bjdx.end(), first_prefix) != bjdx.end()))
                     {
                         prefix_required = false;
                         oa->write_character(to_char_type('$'));
@@ -810,12 +816,12 @@ class binary_writer
                 if (use_count)
                 {
                     oa->write_character(to_char_type('#'));
-                    write_number_with_ubjson_prefix(j.m_value.array->size(), true);
+                    write_number_with_ubjson_prefix(j.m_value.array->size(), true, use_bjdata);
                 }
 
                 for (const auto& el : *j.m_value.array)
                 {
-                    write_ubjson(el, use_count, use_type, prefix_required);
+                    write_ubjson(el, use_count, use_type, prefix_required, use_bjdata);
                 }
 
                 if (!use_count)
@@ -843,7 +849,7 @@ class binary_writer
                 if (use_count)
                 {
                     oa->write_character(to_char_type('#'));
-                    write_number_with_ubjson_prefix(j.m_value.binary->size(), true);
+                    write_number_with_ubjson_prefix(j.m_value.binary->size(), true, use_bjdata);
                 }
 
                 if (use_type)
@@ -871,6 +877,14 @@ class binary_writer
 
             case value_t::object:
             {
+                if (use_bjdata && j.m_value.object->size() == 3 && j.m_value.object->find("_ArrayType_") != j.m_value.object->end() && j.m_value.object->find("_ArraySize_") != j.m_value.object->end() && j.m_value.object->find("_ArrayData_") != j.m_value.object->end())
+                {
+                    if (!write_bjdata_ndarray(*j.m_value.object, use_count, use_type))  // decode bjdata ndarray in the JData format (https://github.com/NeuroJSON/jdata)
+                    {
+                        break;
+                    }
+                }
+
                 if (add_prefix)
                 {
                     oa->write_character(to_char_type('{'));
@@ -880,14 +894,16 @@ class binary_writer
                 if (use_type && !j.m_value.object->empty())
                 {
                     JSON_ASSERT(use_count);
-                    const CharType first_prefix = ubjson_prefix(j.front());
+                    const CharType first_prefix = ubjson_prefix(j.front(), use_bjdata);
                     const bool same_prefix = std::all_of(j.begin(), j.end(),
-                                                         [this, first_prefix](const BasicJsonType & v)
+                                                         [this, first_prefix, use_bjdata](const BasicJsonType & v)
                     {
-                        return ubjson_prefix(v) == first_prefix;
+                        return ubjson_prefix(v, use_bjdata) == first_prefix;
                     });
 
-                    if (same_prefix)
+                    std::vector<CharType> bjdx = {'[', '{', 'S', 'H', 'T', 'F', 'N', 'Z'}; // excluded markers in bjdata optimized type
+
+                    if (same_prefix && !(use_bjdata && std::find(bjdx.begin(), bjdx.end(), first_prefix) != bjdx.end()))
                     {
                         prefix_required = false;
                         oa->write_character(to_char_type('$'));
@@ -898,16 +914,16 @@ class binary_writer
                 if (use_count)
                 {
                     oa->write_character(to_char_type('#'));
-                    write_number_with_ubjson_prefix(j.m_value.object->size(), true);
+                    write_number_with_ubjson_prefix(j.m_value.object->size(), true, use_bjdata);
                 }
 
                 for (const auto& el : *j.m_value.object)
                 {
-                    write_number_with_ubjson_prefix(el.first.size(), true);
+                    write_number_with_ubjson_prefix(el.first.size(), true, use_bjdata);
                     oa->write_characters(
                         reinterpret_cast<const CharType*>(el.first.c_str()),
                         el.first.size());
-                    write_ubjson(el.second, use_count, use_type, prefix_required);
+                    write_ubjson(el.second, use_count, use_type, prefix_required, use_bjdata);
                 }
 
                 if (!use_count)
@@ -974,7 +990,7 @@ class binary_writer
                            const double value)
     {
         write_bson_entry_header(name, 0x01);
-        write_number<double, true>(value);
+        write_number<double>(value, true);
     }
 
     /*!
@@ -993,7 +1009,7 @@ class binary_writer
     {
         write_bson_entry_header(name, 0x02);
 
-        write_number<std::int32_t, true>(static_cast<std::int32_t>(value.size() + 1ul));
+        write_number<std::int32_t>(static_cast<std::int32_t>(value.size() + 1ul), true);
         oa->write_characters(
             reinterpret_cast<const CharType*>(value.c_str()),
             value.size() + 1);
@@ -1026,12 +1042,12 @@ class binary_writer
         if ((std::numeric_limits<std::int32_t>::min)() <= value && value <= (std::numeric_limits<std::int32_t>::max)())
         {
             write_bson_entry_header(name, 0x10); // int32
-            write_number<std::int32_t, true>(static_cast<std::int32_t>(value));
+            write_number<std::int32_t>(static_cast<std::int32_t>(value), true);
         }
         else
         {
             write_bson_entry_header(name, 0x12); // int64
-            write_number<std::int64_t, true>(static_cast<std::int64_t>(value));
+            write_number<std::int64_t>(static_cast<std::int64_t>(value), true);
         }
     }
 
@@ -1054,12 +1070,12 @@ class binary_writer
         if (j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::int32_t>::max)()))
         {
             write_bson_entry_header(name, 0x10 /* int32 */);
-            write_number<std::int32_t, true>(static_cast<std::int32_t>(j.m_value.number_unsigned));
+            write_number<std::int32_t>(static_cast<std::int32_t>(j.m_value.number_unsigned), true);
         }
         else if (j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::int64_t>::max)()))
         {
             write_bson_entry_header(name, 0x12 /* int64 */);
-            write_number<std::int64_t, true>(static_cast<std::int64_t>(j.m_value.number_unsigned));
+            write_number<std::int64_t>(static_cast<std::int64_t>(j.m_value.number_unsigned), true);
         }
         else
         {
@@ -1107,7 +1123,7 @@ class binary_writer
                           const typename BasicJsonType::array_t& value)
     {
         write_bson_entry_header(name, 0x04); // array
-        write_number<std::int32_t, true>(static_cast<std::int32_t>(calc_bson_array_size(value)));
+        write_number<std::int32_t>(static_cast<std::int32_t>(calc_bson_array_size(value)), true);
 
         std::size_t array_index = 0ul;
 
@@ -1127,7 +1143,7 @@ class binary_writer
     {
         write_bson_entry_header(name, 0x05);
 
-        write_number<std::int32_t, true>(static_cast<std::int32_t>(value.size()));
+        write_number<std::int32_t>(static_cast<std::int32_t>(value.size()), true);
         write_number(value.has_subtype() ? static_cast<std::uint8_t>(value.subtype()) : static_cast<std::uint8_t>(0x00));
 
         oa->write_characters(reinterpret_cast<const CharType*>(value.data()), value.size());
@@ -1249,7 +1265,7 @@ class binary_writer
     */
     void write_bson_object(const typename BasicJsonType::object_t& value)
     {
-        write_number<std::int32_t, true>(static_cast<std::int32_t>(calc_bson_object_size(value)));
+        write_number<std::int32_t>(static_cast<std::int32_t>(calc_bson_object_size(value)), true);
 
         for (const auto& el : value)
         {
@@ -1295,20 +1311,22 @@ class binary_writer
     template<typename NumberType, typename std::enable_if<
                  std::is_floating_point<NumberType>::value, int>::type = 0>
     void write_number_with_ubjson_prefix(const NumberType n,
-                                         const bool add_prefix)
+                                         const bool add_prefix,
+                                         const bool use_bjdata)
     {
         if (add_prefix)
         {
             oa->write_character(get_ubjson_float_prefix(n));
         }
-        write_number(n);
+        write_number(n, use_bjdata);
     }
 
     // UBJSON: write number (unsigned integer)
     template<typename NumberType, typename std::enable_if<
                  std::is_unsigned<NumberType>::value, int>::type = 0>
     void write_number_with_ubjson_prefix(const NumberType n,
-                                         const bool add_prefix)
+                                         const bool add_prefix,
+                                         const bool use_bjdata)
     {
         if (n <= static_cast<std::uint64_t>((std::numeric_limits<std::int8_t>::max)()))
         {
@@ -1316,7 +1334,7 @@ class binary_writer
             {
                 oa->write_character(to_char_type('i'));  // int8
             }
-            write_number(static_cast<std::uint8_t>(n));
+            write_number(static_cast<std::uint8_t>(n), use_bjdata);
         }
         else if (n <= (std::numeric_limits<std::uint8_t>::max)())
         {
@@ -1324,7 +1342,7 @@ class binary_writer
             {
                 oa->write_character(to_char_type('U'));  // uint8
             }
-            write_number(static_cast<std::uint8_t>(n));
+            write_number(static_cast<std::uint8_t>(n), use_bjdata);
         }
         else if (n <= static_cast<std::uint64_t>((std::numeric_limits<std::int16_t>::max)()))
         {
@@ -1332,7 +1350,15 @@ class binary_writer
             {
                 oa->write_character(to_char_type('I'));  // int16
             }
-            write_number(static_cast<std::int16_t>(n));
+            write_number(static_cast<std::int16_t>(n), use_bjdata);
+        }
+        else if (use_bjdata && n <= static_cast<uint64_t>((std::numeric_limits<uint16_t>::max)()))
+        {
+            if (add_prefix)
+            {
+                oa->write_character(to_char_type('u'));  // uint16 - bjdata only
+            }
+            write_number(static_cast<std::uint16_t>(n), use_bjdata);
         }
         else if (n <= static_cast<std::uint64_t>((std::numeric_limits<std::int32_t>::max)()))
         {
@@ -1340,7 +1366,15 @@ class binary_writer
             {
                 oa->write_character(to_char_type('l'));  // int32
             }
-            write_number(static_cast<std::int32_t>(n));
+            write_number(static_cast<std::int32_t>(n), use_bjdata);
+        }
+        else if (use_bjdata && n <= static_cast<uint64_t>((std::numeric_limits<uint32_t>::max)()))
+        {
+            if (add_prefix)
+            {
+                oa->write_character(to_char_type('m'));  // uint32 - bjdata only
+            }
+            write_number(static_cast<std::uint32_t>(n), use_bjdata);
         }
         else if (n <= static_cast<std::uint64_t>((std::numeric_limits<std::int64_t>::max)()))
         {
@@ -1348,7 +1382,15 @@ class binary_writer
             {
                 oa->write_character(to_char_type('L'));  // int64
             }
-            write_number(static_cast<std::int64_t>(n));
+            write_number(static_cast<std::int64_t>(n), use_bjdata);
+        }
+        else if (use_bjdata && n <= (std::numeric_limits<uint64_t>::max)())
+        {
+            if (add_prefix)
+            {
+                oa->write_character(to_char_type('M'));  // uint64 - bjdata only
+            }
+            write_number(static_cast<std::uint64_t>(n), use_bjdata);
         }
         else
         {
@@ -1358,7 +1400,7 @@ class binary_writer
             }
 
             const auto number = BasicJsonType(n).dump();
-            write_number_with_ubjson_prefix(number.size(), true);
+            write_number_with_ubjson_prefix(number.size(), true, use_bjdata);
             for (std::size_t i = 0; i < number.size(); ++i)
             {
                 oa->write_character(to_char_type(static_cast<std::uint8_t>(number[i])));
@@ -1371,7 +1413,8 @@ class binary_writer
                    std::is_signed<NumberType>::value&&
                    !std::is_floating_point<NumberType>::value, int >::type = 0 >
     void write_number_with_ubjson_prefix(const NumberType n,
-                                         const bool add_prefix)
+                                         const bool add_prefix,
+                                         const bool use_bjdata)
     {
         if ((std::numeric_limits<std::int8_t>::min)() <= n && n <= (std::numeric_limits<std::int8_t>::max)())
         {
@@ -1379,7 +1422,7 @@ class binary_writer
             {
                 oa->write_character(to_char_type('i'));  // int8
             }
-            write_number(static_cast<std::int8_t>(n));
+            write_number(static_cast<std::int8_t>(n), use_bjdata);
         }
         else if (static_cast<std::int64_t>((std::numeric_limits<std::uint8_t>::min)()) <= n && n <= static_cast<std::int64_t>((std::numeric_limits<std::uint8_t>::max)()))
         {
@@ -1387,7 +1430,7 @@ class binary_writer
             {
                 oa->write_character(to_char_type('U'));  // uint8
             }
-            write_number(static_cast<std::uint8_t>(n));
+            write_number(static_cast<std::uint8_t>(n), use_bjdata);
         }
         else if ((std::numeric_limits<std::int16_t>::min)() <= n && n <= (std::numeric_limits<std::int16_t>::max)())
         {
@@ -1395,7 +1438,15 @@ class binary_writer
             {
                 oa->write_character(to_char_type('I'));  // int16
             }
-            write_number(static_cast<std::int16_t>(n));
+            write_number(static_cast<std::int16_t>(n), use_bjdata);
+        }
+        else if (use_bjdata && (static_cast<std::int64_t>((std::numeric_limits<std::uint16_t>::min)()) <= n && n <= static_cast<std::int64_t>((std::numeric_limits<std::uint16_t>::max)())))
+        {
+            if (add_prefix)
+            {
+                oa->write_character(to_char_type('u'));  // uint16 - bjdata only
+            }
+            write_number(static_cast<uint16_t>(n), use_bjdata);
         }
         else if ((std::numeric_limits<std::int32_t>::min)() <= n && n <= (std::numeric_limits<std::int32_t>::max)())
         {
@@ -1403,7 +1454,15 @@ class binary_writer
             {
                 oa->write_character(to_char_type('l'));  // int32
             }
-            write_number(static_cast<std::int32_t>(n));
+            write_number(static_cast<std::int32_t>(n), use_bjdata);
+        }
+        else if (use_bjdata && (static_cast<std::int64_t>((std::numeric_limits<std::uint32_t>::min)()) <= n && n <= static_cast<std::int64_t>((std::numeric_limits<std::uint32_t>::max)())))
+        {
+            if (add_prefix)
+            {
+                oa->write_character(to_char_type('m'));  // uint32 - bjdata only
+            }
+            write_number(static_cast<uint32_t>(n), use_bjdata);
         }
         else if ((std::numeric_limits<std::int64_t>::min)() <= n && n <= (std::numeric_limits<std::int64_t>::max)())
         {
@@ -1411,7 +1470,7 @@ class binary_writer
             {
                 oa->write_character(to_char_type('L'));  // int64
             }
-            write_number(static_cast<std::int64_t>(n));
+            write_number(static_cast<std::int64_t>(n), use_bjdata);
         }
         // LCOV_EXCL_START
         else
@@ -1422,7 +1481,7 @@ class binary_writer
             }
 
             const auto number = BasicJsonType(n).dump();
-            write_number_with_ubjson_prefix(number.size(), true);
+            write_number_with_ubjson_prefix(number.size(), true, use_bjdata);
             for (std::size_t i = 0; i < number.size(); ++i)
             {
                 oa->write_character(to_char_type(static_cast<std::uint8_t>(number[i])));
@@ -1434,7 +1493,7 @@ class binary_writer
     /*!
     @brief determine the type prefix of container values
     */
-    CharType ubjson_prefix(const BasicJsonType& j) const noexcept
+    CharType ubjson_prefix(const BasicJsonType& j, const bool use_bjdata) const noexcept
     {
         switch (j.type())
         {
@@ -1458,10 +1517,18 @@ class binary_writer
                 {
                     return 'I';
                 }
+                if (use_bjdata && ((std::numeric_limits<std::uint16_t>::min)() <= j.m_value.number_integer && j.m_value.number_integer <= (std::numeric_limits<std::uint16_t>::max)()))
+                {
+                    return 'u';
+                }
                 if ((std::numeric_limits<std::int32_t>::min)() <= j.m_value.number_integer && j.m_value.number_integer <= (std::numeric_limits<std::int32_t>::max)())
                 {
                     return 'l';
                 }
+                if (use_bjdata && ((std::numeric_limits<std::uint32_t>::min)() <= j.m_value.number_integer && j.m_value.number_integer <= (std::numeric_limits<std::uint32_t>::max)()))
+                {
+                    return 'm';
+                }
                 if ((std::numeric_limits<std::int64_t>::min)() <= j.m_value.number_integer && j.m_value.number_integer <= (std::numeric_limits<std::int64_t>::max)())
                 {
                     return 'L';
@@ -1484,14 +1551,26 @@ class binary_writer
                 {
                     return 'I';
                 }
+                if (use_bjdata && j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::uint16_t>::max)()))
+                {
+                    return 'u';
+                }
                 if (j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::int32_t>::max)()))
                 {
                     return 'l';
                 }
+                if (use_bjdata && j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::uint32_t>::max)()))
+                {
+                    return 'm';
+                }
                 if (j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::int64_t>::max)()))
                 {
                     return 'L';
                 }
+                if (use_bjdata && j.m_value.number_unsigned <= (std::numeric_limits<std::uint64_t>::max)())
+                {
+                    return 'M';
+                }
                 // anything else is treated as high-precision number
                 return 'H'; // LCOV_EXCL_LINE
             }
@@ -1525,6 +1604,118 @@ class binary_writer
         return 'D';  // float 64
     }
 
+    /*!
+    @return false if the object is successfully converted to a bjdata ndarray, true if the type or size is invalid
+    */
+    bool write_bjdata_ndarray(const typename BasicJsonType::object_t& value, const bool use_count, const bool use_type)
+    {
+        std::map<string_t, CharType> bjdtype = {{"uint8", 'U'},  {"int8", 'i'},  {"uint16", 'u'}, {"int16", 'I'},
+            {"uint32", 'm'}, {"int32", 'l'}, {"uint64", 'M'}, {"int64", 'L'}, {"single", 'd'}, {"double", 'D'}, {"char", 'C'}
+        };
+
+        string_t key = "_ArrayType_";
+        auto it = bjdtype.find(static_cast<string_t>(value.at(key)));
+        if (it == bjdtype.end())
+        {
+            return true;
+        }
+        CharType dtype = it->second;
+
+        key = "_ArraySize_";
+        std::size_t len = (value.at(key).empty() ? 0 : 1);
+        for (const auto& el : value.at(key))
+        {
+            len *= static_cast<std::size_t>(el.m_value.number_unsigned);
+        }
+
+        key = "_ArrayData_";
+        if (value.at(key).size() != len)
+        {
+            return true;
+        }
+
+        oa->write_character('[');
+        oa->write_character('$');
+        oa->write_character(dtype);
+        oa->write_character('#');
+
+        key = "_ArraySize_";
+        write_ubjson(value.at(key), use_count, use_type, true,  true);
+
+        key = "_ArrayData_";
+        if (dtype == 'U' || dtype == 'C')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::uint8_t>(el.m_value.number_unsigned), true);
+            }
+        }
+        else if (dtype == 'i')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::int8_t>(el.m_value.number_integer), true);
+            }
+        }
+        else if (dtype == 'u')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::uint16_t>(el.m_value.number_unsigned), true);
+            }
+        }
+        else if (dtype == 'I')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::int16_t>(el.m_value.number_integer), true);
+            }
+        }
+        else if (dtype == 'm')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::uint32_t>(el.m_value.number_unsigned), true);
+            }
+        }
+        else if (dtype == 'l')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::int32_t>(el.m_value.number_integer), true);
+            }
+        }
+        else if (dtype == 'M')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::uint64_t>(el.m_value.number_unsigned), true);
+            }
+        }
+        else if (dtype == 'L')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::int64_t>(el.m_value.number_integer), true);
+            }
+        }
+        else if (dtype == 'd')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<float>(el.m_value.number_float), true);
+            }
+        }
+        else if (dtype == 'D')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<double>(el.m_value.number_float), true);
+            }
+        }
+        return false;
+    }
+
     ///////////////////////
     // Utility functions //
     ///////////////////////
@@ -1532,16 +1723,18 @@ class binary_writer
     /*
     @brief write a number to output input
     @param[in] n number of type @a NumberType
-    @tparam NumberType the type of the number
-    @tparam OutputIsLittleEndian Set to true if output data is
+    @param[in] OutputIsLittleEndian Set to true if output data is
                                  required to be little endian
+    @tparam NumberType the type of the number
 
     @note This function needs to respect the system's endianness, because bytes
           in CBOR, MessagePack, and UBJSON are stored in network order (big
           endian) and therefore need reordering on little endian systems.
+          On the other hand, BSON and BJData use little endian and should reorder
+          on big endian systems.
     */
-    template<typename NumberType, bool OutputIsLittleEndian = false>
-    void write_number(const NumberType n)
+    template<typename NumberType>
+    void write_number(const NumberType n, const bool OutputIsLittleEndian = false)
     {
         // step 1: write number to array of length NumberType
         std::array<CharType, sizeof(NumberType)> vec{};
diff --git a/include/nlohmann/json.hpp b/include/nlohmann/json.hpp
index 1a2da8d45..0a18f1634 100644
--- a/include/nlohmann/json.hpp
+++ b/include/nlohmann/json.hpp
@@ -3773,7 +3773,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         auto ia = detail::input_adapter(std::forward<InputType>(i));
         return format == input_format_t::json
                ? parser(std::move(ia), nullptr, true, ignore_comments).sax_parse(sax, strict)
-               : detail::binary_reader<basic_json, decltype(ia), SAX>(std::move(ia)).sax_parse(format, sax, strict);
+               : detail::binary_reader<basic_json, decltype(ia), SAX>(std::move(ia), format).sax_parse(format, sax, strict);
     }
 
     /// @brief generate SAX events
@@ -3788,7 +3788,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         auto ia = detail::input_adapter(std::move(first), std::move(last));
         return format == input_format_t::json
                ? parser(std::move(ia), nullptr, true, ignore_comments).sax_parse(sax, strict)
-               : detail::binary_reader<basic_json, decltype(ia), SAX>(std::move(ia)).sax_parse(format, sax, strict);
+               : detail::binary_reader<basic_json, decltype(ia), SAX>(std::move(ia), format).sax_parse(format, sax, strict);
     }
 
     /// @brief generate SAX events
@@ -3809,7 +3809,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
                // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
                ? parser(std::move(ia), nullptr, true, ignore_comments).sax_parse(sax, strict)
                // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
-               : detail::binary_reader<basic_json, decltype(ia), SAX>(std::move(ia)).sax_parse(format, sax, strict);
+               : detail::binary_reader<basic_json, decltype(ia), SAX>(std::move(ia), format).sax_parse(format, sax, strict);
     }
 #ifndef JSON_NO_IO
     /// @brief deserialize from stream
@@ -3965,6 +3965,33 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         binary_writer<char>(o).write_ubjson(j, use_size, use_type);
     }
 
+    /// @brief create a BJData serialization of a given JSON value
+    /// @sa https://json.nlohmann.me/api/basic_json/to_bjdata/
+    static std::vector<std::uint8_t> to_bjdata(const basic_json& j,
+            const bool use_size = false,
+            const bool use_type = false)
+    {
+        std::vector<std::uint8_t> result;
+        to_bjdata(j, result, use_size, use_type);
+        return result;
+    }
+
+    /// @brief create a BJData serialization of a given JSON value
+    /// @sa https://json.nlohmann.me/api/basic_json/to_bjdata/
+    static void to_bjdata(const basic_json& j, detail::output_adapter<std::uint8_t> o,
+                          const bool use_size = false, const bool use_type = false)
+    {
+        binary_writer<std::uint8_t>(o).write_ubjson(j, use_size, use_type, true, true);
+    }
+
+    /// @brief create a BJData serialization of a given JSON value
+    /// @sa https://json.nlohmann.me/api/basic_json/to_bjdata/
+    static void to_bjdata(const basic_json& j, detail::output_adapter<char> o,
+                          const bool use_size = false, const bool use_type = false)
+    {
+        binary_writer<char>(o).write_ubjson(j, use_size, use_type, true, true);
+    }
+
     /// @brief create a BSON serialization of a given JSON value
     /// @sa https://json.nlohmann.me/api/basic_json/to_bson/
     static std::vector<std::uint8_t> to_bson(const basic_json& j)
@@ -4000,7 +4027,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::forward<InputType>(i));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::cbor, &sdp, strict, tag_handler);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::cbor).sax_parse(input_format_t::cbor, &sdp, strict, tag_handler);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -4016,7 +4043,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::move(first), std::move(last));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::cbor, &sdp, strict, tag_handler);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::cbor).sax_parse(input_format_t::cbor, &sdp, strict, tag_handler);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -4043,7 +4070,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = i.get();
         // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::cbor, &sdp, strict, tag_handler);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::cbor).sax_parse(input_format_t::cbor, &sdp, strict, tag_handler);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -4058,7 +4085,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::forward<InputType>(i));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::msgpack, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::msgpack).sax_parse(input_format_t::msgpack, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -4073,7 +4100,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::move(first), std::move(last));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::msgpack, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::msgpack).sax_parse(input_format_t::msgpack, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -4097,7 +4124,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = i.get();
         // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::msgpack, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::msgpack).sax_parse(input_format_t::msgpack, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -4112,7 +4139,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::forward<InputType>(i));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::ubjson, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::ubjson).sax_parse(input_format_t::ubjson, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -4127,7 +4154,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::move(first), std::move(last));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::ubjson, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::ubjson).sax_parse(input_format_t::ubjson, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -4151,10 +4178,64 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = i.get();
         // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::ubjson, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::ubjson).sax_parse(input_format_t::ubjson, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
+
+    /// @brief create a JSON value from an input in BJData format
+    /// @sa https://json.nlohmann.me/api/basic_json/from_bjdata/
+    template<typename InputType>
+    JSON_HEDLEY_WARN_UNUSED_RESULT
+    static basic_json from_bjdata(InputType&& i,
+                                  const bool strict = true,
+                                  const bool allow_exceptions = true)
+    {
+        basic_json result;
+        detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
+        auto ia = detail::input_adapter(std::forward<InputType>(i));
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::bjdata).sax_parse(input_format_t::bjdata, &sdp, strict);
+        return res ? result : basic_json(value_t::discarded);
+    }
+
+    /// @brief create a JSON value from an input in BJData format
+    /// @sa https://json.nlohmann.me/api/basic_json/from_bjdata/
+    template<typename IteratorType>
+    JSON_HEDLEY_WARN_UNUSED_RESULT
+    static basic_json from_bjdata(IteratorType first, IteratorType last,
+                                  const bool strict = true,
+                                  const bool allow_exceptions = true)
+    {
+        basic_json result;
+        detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
+        auto ia = detail::input_adapter(std::move(first), std::move(last));
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::bjdata).sax_parse(input_format_t::bjdata, &sdp, strict);
+        return res ? result : basic_json(value_t::discarded);
+    }
+
+    template<typename T>
+    JSON_HEDLEY_WARN_UNUSED_RESULT
+    static basic_json from_bjdata(const T* ptr, std::size_t len,
+                                  const bool strict = true,
+                                  const bool allow_exceptions = true)
+    {
+        return from_bjdata(ptr, ptr + len, strict, allow_exceptions);
+    }
+
+    JSON_HEDLEY_WARN_UNUSED_RESULT
+    static basic_json from_bjdata(detail::span_input_adapter&& i,
+                                  const bool strict = true,
+                                  const bool allow_exceptions = true)
+    {
+        basic_json result;
+        detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
+        auto ia = i.get();
+        // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::bjdata).sax_parse(input_format_t::bjdata, &sdp, strict);
+        return res ? result : basic_json(value_t::discarded);
+    }
+
+
     /// @brief create a JSON value from an input in BSON format
     /// @sa https://json.nlohmann.me/api/basic_json/from_bson/
     template<typename InputType>
@@ -4166,7 +4247,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::forward<InputType>(i));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::bson, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::bson).sax_parse(input_format_t::bson, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -4181,7 +4262,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::move(first), std::move(last));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::bson, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::bson).sax_parse(input_format_t::bson, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -4205,7 +4286,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = i.get();
         // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::bson, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::bson).sax_parse(input_format_t::bson, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
     /// @}
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index a29c52997..d596180c6 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -5402,6 +5402,7 @@ std::size_t hash(const BasicJsonType& j)
 #include <string> // char_traits, string
 #include <utility> // make_pair, move
 #include <vector> // vector
+#include <map> // map
 
 // #include <nlohmann/detail/exceptions.hpp>
 
@@ -5433,7 +5434,7 @@ namespace nlohmann
 namespace detail
 {
 /// the supported input formats
-enum class input_format_t { json, cbor, msgpack, ubjson, bson };
+enum class input_format_t { json, cbor, msgpack, ubjson, bson, bjdata };
 
 ////////////////////
 // input adapters //
@@ -8450,7 +8451,7 @@ class binary_reader
 
     @param[in] adapter  input adapter to read from
     */
-    explicit binary_reader(InputAdapterType&& adapter) noexcept : ia(std::move(adapter))
+    explicit binary_reader(InputAdapterType&& adapter, const input_format_t format = input_format_t::json) noexcept : ia(std::move(adapter)), input_format(format)
     {
         (void)detail::is_sax_static_asserts<SAX, BasicJsonType> {};
     }
@@ -8494,6 +8495,7 @@ class binary_reader
                 break;
 
             case input_format_t::ubjson:
+            case input_format_t::bjdata:
                 result = parse_ubjson_internal();
                 break;
 
@@ -8505,7 +8507,7 @@ class binary_reader
         // strict mode: next byte must be EOF
         if (result && strict)
         {
-            if (format == input_format_t::ubjson)
+            if (input_format == input_format_t::ubjson || input_format == input_format_t::bjdata)
             {
                 get_ignore_noop();
             }
@@ -8517,7 +8519,7 @@ class binary_reader
             if (JSON_HEDLEY_UNLIKELY(current != std::char_traits<char_type>::eof()))
             {
                 return sax->parse_error(chars_read, get_token_string(), parse_error::create(110, chars_read,
-                                        exception_message(format, concat("expected end of input; last byte: 0x", get_token_string()), "value"), nullptr));
+                                        exception_message(input_format, concat("expected end of input; last byte: 0x", get_token_string()), "value"), nullptr));
             }
         }
 
@@ -10220,7 +10222,7 @@ class binary_reader
             get();  // TODO(niels): may we ignore N here?
         }
 
-        if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "value")))
+        if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "value")))
         {
             return false;
         }
@@ -10230,52 +10232,154 @@ class binary_reader
             case 'U':
             {
                 std::uint8_t len{};
-                return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, len, result);
+                return get_number(input_format, len) && get_string(input_format, len, result);
             }
 
             case 'i':
             {
                 std::int8_t len{};
-                return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, len, result);
+                return get_number(input_format, len) && get_string(input_format, len, result);
             }
 
             case 'I':
             {
                 std::int16_t len{};
-                return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, len, result);
+                return get_number(input_format, len) && get_string(input_format, len, result);
             }
 
             case 'l':
             {
                 std::int32_t len{};
-                return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, len, result);
+                return get_number(input_format, len) && get_string(input_format, len, result);
             }
 
             case 'L':
             {
                 std::int64_t len{};
-                return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, len, result);
+                return get_number(input_format, len) && get_string(input_format, len, result);
+            }
+
+            case 'u':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint16_t len{};
+                return get_number(input_format, len) && get_string(input_format, len, result);
+            }
+
+            case 'm':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint32_t len{};
+                return get_number(input_format, len) && get_string(input_format, len, result);
+            }
+
+            case 'M':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint64_t len{};
+                return get_number(input_format, len) && get_string(input_format, len, result);
             }
 
             default:
-                auto last_token = get_token_string();
-                return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read,
-                                        exception_message(input_format_t::ubjson, concat("expected length type specification (U, i, I, l, L); last byte: 0x", last_token), "string"), nullptr));
+                break;
         }
+        auto last_token = get_token_string();
+        std::string message;
+
+        if (input_format != input_format_t::bjdata)
+        {
+            message = "expected length type specification (U, i, I, l, L); last byte: 0x" + last_token;
+        }
+        else
+        {
+            message = "expected length type specification (U, i, u, I, m, l, M, L); last byte: 0x" + last_token;
+        }
+        return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read, exception_message(input_format, message, "string"), nullptr));
+    }
+
+    /*!
+    @param[out] dim  an integer vector storing the ND array dimensions
+    @return whether reading ND array size vector is successful
+    */
+    bool get_ubjson_ndarray_size(std::vector<size_t>& dim)
+    {
+        std::pair<std::size_t, char_int_type> size_and_type;
+        size_t dimlen = 0;
+
+        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type)))
+        {
+            return false;
+        }
+
+        if (size_and_type.first != string_t::npos)
+        {
+            if (size_and_type.second != 0)
+            {
+                if (size_and_type.second != 'N')
+                {
+                    for (std::size_t i = 0; i < size_and_type.first; ++i)
+                    {
+                        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, size_and_type.second)))
+                        {
+                            return false;
+                        }
+                        dim.push_back(dimlen);
+                    }
+                }
+            }
+            else
+            {
+                for (std::size_t i = 0; i < size_and_type.first; ++i)
+                {
+                    if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen)))
+                    {
+                        return false;
+                    }
+                    dim.push_back(dimlen);
+                }
+            }
+        }
+        else
+        {
+            while (current != ']')
+            {
+                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, current)))
+                {
+                    return false;
+                }
+                dim.push_back(dimlen);
+                get_ignore_noop();
+            }
+        }
+        return true;
     }
 
     /*!
     @param[out] result  determined size
     @return whether size determination completed
     */
-    bool get_ubjson_size_value(std::size_t& result)
+    bool get_ubjson_size_value(std::size_t& result, char_int_type prefix = 0)
     {
-        switch (get_ignore_noop())
+        if (prefix == 0)
+        {
+            prefix = get_ignore_noop();
+        }
+
+        switch (prefix)
         {
             case 'U':
             {
                 std::uint8_t number{};
-                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
                 {
                     return false;
                 }
@@ -10286,7 +10390,7 @@ class binary_reader
             case 'i':
             {
                 std::int8_t number{};
-                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
                 {
                     return false;
                 }
@@ -10297,7 +10401,7 @@ class binary_reader
             case 'I':
             {
                 std::int16_t number{};
-                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
                 {
                     return false;
                 }
@@ -10308,7 +10412,7 @@ class binary_reader
             case 'l':
             {
                 std::int32_t number{};
-                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
                 {
                     return false;
                 }
@@ -10319,7 +10423,7 @@ class binary_reader
             case 'L':
             {
                 std::int64_t number{};
-                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
                 {
                     return false;
                 }
@@ -10327,13 +10431,105 @@ class binary_reader
                 return true;
             }
 
-            default:
+            case 'u':
             {
-                auto last_token = get_token_string();
-                return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read,
-                                        exception_message(input_format_t::ubjson, concat("expected length type specification (U, i, I, l, L) after '#'; last byte: 0x", last_token), "size"), nullptr));
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint16_t number{};
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
+                {
+                    return false;
+                }
+                result = static_cast<std::size_t>(number);
+                return true;
             }
+
+            case 'm':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint32_t number{};
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
+                {
+                    return false;
+                }
+                result = static_cast<std::size_t>(number);
+                return true;
+            }
+
+            case 'M':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint64_t number{};
+                if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
+                {
+                    return false;
+                }
+                result = detail::conditional_static_cast<std::size_t>(number);
+                return true;
+            }
+
+            case '[':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::vector<size_t> dim;
+                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_ndarray_size(dim)))
+                {
+                    return false;
+                }
+                if (dim.size() == 1 || (dim.size() == 2 && dim.at(0) == 1)) // return normal array size if 1D row vector
+                {
+                    result = dim.at(dim.size() - 1);
+                    return true;
+                }
+                if (!dim.empty())  // if ndarray, convert to an object in JData annotated array format
+                {
+                    string_t key = "_ArraySize_";
+                    if (JSON_HEDLEY_UNLIKELY(!sax->start_object(3) || !sax->key(key) || !sax->start_array(dim.size())))
+                    {
+                        return false;
+                    }
+                    result = 1;
+                    for (auto i : dim)
+                    {
+                        result *= i;
+                        if (JSON_HEDLEY_UNLIKELY(!sax->number_integer(static_cast<number_integer_t>(i))))
+                        {
+                            return false;
+                        }
+                    }
+                    result |= (1ull << (sizeof(result) * 8 - 1)); // low 63 bit of result stores the total element count, sign-bit indicates ndarray
+                    return sax->end_array();
+                }
+                result = 0;
+                return true;
+            }
+
+            default:
+                break;
         }
+        auto last_token = get_token_string();
+        std::string message;
+
+        if (input_format != input_format_t::bjdata)
+        {
+            message = "expected length type specification (U, i, I, l, L) after '#'; last byte: 0x" + last_token;
+        }
+        else
+        {
+            message = "expected length type specification (U, i, u, I, m, l, M, L) after '#'; last byte: 0x" + last_token;
+        }
+        return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read, exception_message(input_format, message, "size"), nullptr));
     }
 
     /*!
@@ -10355,8 +10551,10 @@ class binary_reader
 
         if (current == '$')
         {
+            std::vector<char_int_type> bjdx = {'[', '{', 'S', 'H', 'T', 'F', 'N', 'Z'}; // excluded markers in bjdata optimized type
+
             result.second = get();  // must not ignore 'N', because 'N' maybe the type
-            if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "type")))
+            if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "type") || (input_format == input_format_t::bjdata && std::find(bjdx.begin(), bjdx.end(), result.second) != bjdx.end() )))
             {
                 return false;
             }
@@ -10364,13 +10562,13 @@ class binary_reader
             get_ignore_noop();
             if (JSON_HEDLEY_UNLIKELY(current != '#'))
             {
-                if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "value")))
+                if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "value")))
                 {
                     return false;
                 }
                 auto last_token = get_token_string();
                 return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
-                                        exception_message(input_format_t::ubjson, concat("expected '#' after type information; last byte: 0x", last_token), "size"), nullptr));
+                                        exception_message(input_format, concat("expected '#' after type information; last byte: 0x", last_token), "size"), nullptr));
             }
 
             return get_ubjson_size_value(result.first);
@@ -10393,7 +10591,7 @@ class binary_reader
         switch (prefix)
         {
             case std::char_traits<char_type>::eof():  // EOF
-                return unexpect_eof(input_format_t::ubjson, "value");
+                return unexpect_eof(input_format, "value");
 
             case 'T':  // true
                 return sax->boolean(true);
@@ -10406,43 +10604,125 @@ class binary_reader
             case 'U':
             {
                 std::uint8_t number{};
-                return get_number(input_format_t::ubjson, number) && sax->number_unsigned(number);
+                return get_number(input_format, number) && sax->number_unsigned(number);
             }
 
             case 'i':
             {
                 std::int8_t number{};
-                return get_number(input_format_t::ubjson, number) && sax->number_integer(number);
+                return get_number(input_format, number) && sax->number_integer(number);
             }
 
             case 'I':
             {
                 std::int16_t number{};
-                return get_number(input_format_t::ubjson, number) && sax->number_integer(number);
+                return get_number(input_format, number) && sax->number_integer(number);
             }
 
             case 'l':
             {
                 std::int32_t number{};
-                return get_number(input_format_t::ubjson, number) && sax->number_integer(number);
+                return get_number(input_format, number) && sax->number_integer(number);
             }
 
             case 'L':
             {
                 std::int64_t number{};
-                return get_number(input_format_t::ubjson, number) && sax->number_integer(number);
+                return get_number(input_format, number) && sax->number_integer(number);
+            }
+
+            case 'u':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint16_t number{};
+                return get_number(input_format, number) && sax->number_unsigned(number);
+            }
+
+            case 'm':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint32_t number{};
+                return get_number(input_format, number) && sax->number_unsigned(number);
+            }
+
+            case 'M':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                std::uint64_t number{};
+                return get_number(input_format, number) && sax->number_unsigned(number);
+            }
+
+            case 'h':
+            {
+                if (input_format != input_format_t::bjdata)
+                {
+                    break;
+                }
+                const auto byte1_raw = get();
+                if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "number")))
+                {
+                    return false;
+                }
+                const auto byte2_raw = get();
+                if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "number")))
+                {
+                    return false;
+                }
+
+                const auto byte1 = static_cast<unsigned char>(byte1_raw);
+                const auto byte2 = static_cast<unsigned char>(byte2_raw);
+
+                // code from RFC 7049, Appendix D, Figure 3:
+                // As half-precision floating-point numbers were only added
+                // to IEEE 754 in 2008, today's programming platforms often
+                // still only have limited support for them. It is very
+                // easy to include at least decoding support for them even
+                // without such support. An example of a small decoder for
+                // half-precision floating-point numbers in the C language
+                // is shown in Fig. 3.
+                const auto half = static_cast<unsigned int>((byte2 << 8u) + byte1);
+                const double val = [&half]
+                {
+                    const int exp = (half >> 10u) & 0x1Fu;
+                    const unsigned int mant = half & 0x3FFu;
+                    JSON_ASSERT(0 <= exp&& exp <= 32);
+                    JSON_ASSERT(mant <= 1024);
+                    switch (exp)
+                    {
+                        case 0:
+                            return std::ldexp(mant, -24);
+                        case 31:
+                            return (mant == 0)
+                            ? std::numeric_limits<double>::infinity()
+                            : std::numeric_limits<double>::quiet_NaN();
+                        default:
+                            return std::ldexp(mant + 1024, exp - 25);
+                    }
+                }();
+                return sax->number_float((half & 0x8000u) != 0
+                                         ? static_cast<number_float_t>(-val)
+                                         : static_cast<number_float_t>(val), "");
             }
 
             case 'd':
             {
                 float number{};
-                return get_number(input_format_t::ubjson, number) && sax->number_float(static_cast<number_float_t>(number), "");
+                return get_number(input_format, number) && sax->number_float(static_cast<number_float_t>(number), "");
             }
 
             case 'D':
             {
                 double number{};
-                return get_number(input_format_t::ubjson, number) && sax->number_float(static_cast<number_float_t>(number), "");
+                return get_number(input_format, number) && sax->number_float(static_cast<number_float_t>(number), "");
             }
 
             case 'H':
@@ -10453,7 +10733,7 @@ class binary_reader
             case 'C':  // char
             {
                 get();
-                if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "char")))
+                if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "char")))
                 {
                     return false;
                 }
@@ -10461,7 +10741,7 @@ class binary_reader
                 {
                     auto last_token = get_token_string();
                     return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read,
-                                            exception_message(input_format_t::ubjson, concat("byte after 'C' must be in range 0x00..0x7F; last byte: 0x", last_token), "char"), nullptr));
+                                            exception_message(input_format, concat("byte after 'C' must be in range 0x00..0x7F; last byte: 0x", last_token), "char"), nullptr));
                 }
                 string_t s(1, static_cast<typename string_t::value_type>(current));
                 return sax->string(s);
@@ -10480,12 +10760,10 @@ class binary_reader
                 return get_ubjson_object();
 
             default: // anything else
-            {
-                auto last_token = get_token_string();
-                return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
-                                        exception_message(input_format_t::ubjson, concat("invalid byte: 0x", last_token), "value"), nullptr));
-            }
+                break;
         }
+        auto last_token = get_token_string();
+        return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read, exception_message(input_format, "invalid byte: 0x" + last_token, "value"), nullptr));
     }
 
     /*!
@@ -10499,6 +10777,44 @@ class binary_reader
             return false;
         }
 
+        // detect and encode bjdata ndarray as an object in JData annotated array format (https://github.com/NeuroJSON/jdata):
+        // {"_ArrayType_" : "typeid", "_ArraySize_" : [n1, n2, ...], "_ArrayData_" : [v1, v2, ...]}
+
+        if (input_format == input_format_t::bjdata && size_and_type.first != string_t::npos && size_and_type.first >= (1ull << (sizeof(std::size_t) * 8 - 1)))
+        {
+            std::map<char_int_type, string_t> bjdtype = {{'U', "uint8"},  {'i', "int8"},  {'u', "uint16"}, {'I', "int16"},
+                {'m', "uint32"}, {'l', "int32"}, {'M', "uint64"}, {'L', "int64"}, {'d', "single"}, {'D', "double"}, {'C', "char"}
+            };
+
+            string_t key = "_ArrayType_";
+            if (JSON_HEDLEY_UNLIKELY(bjdtype.count(size_and_type.second) == 0 || !sax->key(key) || !sax->string(bjdtype[size_and_type.second]) ))
+            {
+                return false;
+            }
+
+            if (size_and_type.second == 'C')
+            {
+                size_and_type.second = 'U';
+            }
+
+            size_and_type.first &= ~(1ull << (sizeof(std::size_t) * 8 - 1));
+            key = "_ArrayData_";
+            if (JSON_HEDLEY_UNLIKELY(!sax->key(key) || !sax->start_array(size_and_type.first) ))
+            {
+                return false;
+            }
+
+            for (std::size_t i = 0; i < size_and_type.first; ++i)
+            {
+                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_value(size_and_type.second)))
+                {
+                    return false;
+                }
+            }
+
+            return (sax->end_array() && sax->end_object());
+        }
+
         if (size_and_type.first != string_t::npos)
         {
             if (JSON_HEDLEY_UNLIKELY(!sax->start_array(size_and_type.first)))
@@ -10561,6 +10877,11 @@ class binary_reader
             return false;
         }
 
+        if (input_format == input_format_t::bjdata && size_and_type.first != string_t::npos && size_and_type.first >= (1ull << (sizeof(std::size_t) * 8 - 1)))
+        {
+            return false;
+        }
+
         string_t key;
         if (size_and_type.first != string_t::npos)
         {
@@ -10643,7 +10964,7 @@ class binary_reader
         for (std::size_t i = 0; i < size; ++i)
         {
             get();
-            if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "number")))
+            if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "number")))
             {
                 return false;
             }
@@ -10662,7 +10983,7 @@ class binary_reader
         if (JSON_HEDLEY_UNLIKELY(result_remainder != token_type::end_of_input))
         {
             return sax->parse_error(chars_read, number_string, parse_error::create(115, chars_read,
-                                    exception_message(input_format_t::ubjson, concat("invalid number text: ", number_lexer.get_token_string()), "high-precision number"), nullptr));
+                                    exception_message(input_format, concat("invalid number text: ", number_lexer.get_token_string()), "high-precision number"), nullptr));
         }
 
         switch (result_number)
@@ -10689,7 +11010,7 @@ class binary_reader
             case token_type::literal_or_value:
             default:
                 return sax->parse_error(chars_read, number_string, parse_error::create(115, chars_read,
-                                        exception_message(input_format_t::ubjson, concat("invalid number text: ", number_lexer.get_token_string()), "high-precision number"), nullptr));
+                                        exception_message(input_format, concat("invalid number text: ", number_lexer.get_token_string()), "high-precision number"), nullptr));
         }
     }
 
@@ -10738,6 +11059,8 @@ class binary_reader
     @note This function needs to respect the system's endianness, because
           bytes in CBOR, MessagePack, and UBJSON are stored in network order
           (big endian) and therefore need reordering on little endian systems.
+          On the other hand, BSON and BJData use little endian and should reorder
+          on big endian systems.
     */
     template<typename NumberType, bool InputIsLittleEndian = false>
     bool get_number(const input_format_t format, NumberType& result)
@@ -10753,7 +11076,7 @@ class binary_reader
             }
 
             // reverse byte order prior to conversion if necessary
-            if (is_little_endian != InputIsLittleEndian)
+            if (is_little_endian != (InputIsLittleEndian || format == input_format_t::bjdata))
             {
                 vec[sizeof(NumberType) - i - 1] = static_cast<std::uint8_t>(current);
             }
@@ -10890,6 +11213,10 @@ class binary_reader
                 error_msg += "BSON";
                 break;
 
+            case input_format_t::bjdata:
+                error_msg += "BJData";
+                break;
+
             case input_format_t::json: // LCOV_EXCL_LINE
             default:            // LCOV_EXCL_LINE
                 JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert) LCOV_EXCL_LINE
@@ -10911,6 +11238,9 @@ class binary_reader
     /// whether we can assume little endianness
     const bool is_little_endian = little_endianness();
 
+    /// input format
+    const input_format_t input_format = input_format_t::json;
+
     /// the SAX parser
     json_sax_t* sax = nullptr;
 };
@@ -13427,12 +13757,14 @@ class json_ref
 
 #include <algorithm> // reverse
 #include <array> // array
+#include <map> // map
 #include <cmath> // isnan, isinf
 #include <cstdint> // uint8_t, uint16_t, uint32_t, uint64_t
 #include <cstring> // memcpy
 #include <limits> // numeric_limits
 #include <string> // string
 #include <utility> // move
+#include <vector> // vector
 
 // #include <nlohmann/detail/input/binary_reader.hpp>
 
@@ -14292,9 +14624,11 @@ class binary_writer
     @param[in] use_count   whether to use '#' prefixes (optimized format)
     @param[in] use_type    whether to use '$' prefixes (optimized format)
     @param[in] add_prefix  whether prefixes need to be used for this value
+    @param[in] use_bjdata  whether write in BJData format, default is false
     */
     void write_ubjson(const BasicJsonType& j, const bool use_count,
-                      const bool use_type, const bool add_prefix = true)
+                      const bool use_type, const bool add_prefix = true,
+                      const bool use_bjdata = false)
     {
         switch (j.type())
         {
@@ -14320,19 +14654,19 @@ class binary_writer
 
             case value_t::number_integer:
             {
-                write_number_with_ubjson_prefix(j.m_value.number_integer, add_prefix);
+                write_number_with_ubjson_prefix(j.m_value.number_integer, add_prefix, use_bjdata);
                 break;
             }
 
             case value_t::number_unsigned:
             {
-                write_number_with_ubjson_prefix(j.m_value.number_unsigned, add_prefix);
+                write_number_with_ubjson_prefix(j.m_value.number_unsigned, add_prefix, use_bjdata);
                 break;
             }
 
             case value_t::number_float:
             {
-                write_number_with_ubjson_prefix(j.m_value.number_float, add_prefix);
+                write_number_with_ubjson_prefix(j.m_value.number_float, add_prefix, use_bjdata);
                 break;
             }
 
@@ -14342,7 +14676,7 @@ class binary_writer
                 {
                     oa->write_character(to_char_type('S'));
                 }
-                write_number_with_ubjson_prefix(j.m_value.string->size(), true);
+                write_number_with_ubjson_prefix(j.m_value.string->size(), true, use_bjdata);
                 oa->write_characters(
                     reinterpret_cast<const CharType*>(j.m_value.string->c_str()),
                     j.m_value.string->size());
@@ -14360,14 +14694,16 @@ class binary_writer
                 if (use_type && !j.m_value.array->empty())
                 {
                     JSON_ASSERT(use_count);
-                    const CharType first_prefix = ubjson_prefix(j.front());
+                    const CharType first_prefix = ubjson_prefix(j.front(), use_bjdata);
                     const bool same_prefix = std::all_of(j.begin() + 1, j.end(),
-                                                         [this, first_prefix](const BasicJsonType & v)
+                                                         [this, first_prefix, use_bjdata](const BasicJsonType & v)
                     {
-                        return ubjson_prefix(v) == first_prefix;
+                        return ubjson_prefix(v, use_bjdata) == first_prefix;
                     });
 
-                    if (same_prefix)
+                    std::vector<CharType> bjdx = {'[', '{', 'S', 'H', 'T', 'F', 'N', 'Z'}; // excluded markers in bjdata optimized type
+
+                    if (same_prefix && !(use_bjdata && std::find(bjdx.begin(), bjdx.end(), first_prefix) != bjdx.end()))
                     {
                         prefix_required = false;
                         oa->write_character(to_char_type('$'));
@@ -14378,12 +14714,12 @@ class binary_writer
                 if (use_count)
                 {
                     oa->write_character(to_char_type('#'));
-                    write_number_with_ubjson_prefix(j.m_value.array->size(), true);
+                    write_number_with_ubjson_prefix(j.m_value.array->size(), true, use_bjdata);
                 }
 
                 for (const auto& el : *j.m_value.array)
                 {
-                    write_ubjson(el, use_count, use_type, prefix_required);
+                    write_ubjson(el, use_count, use_type, prefix_required, use_bjdata);
                 }
 
                 if (!use_count)
@@ -14411,7 +14747,7 @@ class binary_writer
                 if (use_count)
                 {
                     oa->write_character(to_char_type('#'));
-                    write_number_with_ubjson_prefix(j.m_value.binary->size(), true);
+                    write_number_with_ubjson_prefix(j.m_value.binary->size(), true, use_bjdata);
                 }
 
                 if (use_type)
@@ -14439,6 +14775,14 @@ class binary_writer
 
             case value_t::object:
             {
+                if (use_bjdata && j.m_value.object->size() == 3 && j.m_value.object->find("_ArrayType_") != j.m_value.object->end() && j.m_value.object->find("_ArraySize_") != j.m_value.object->end() && j.m_value.object->find("_ArrayData_") != j.m_value.object->end())
+                {
+                    if (!write_bjdata_ndarray(*j.m_value.object, use_count, use_type))  // decode bjdata ndarray in the JData format (https://github.com/NeuroJSON/jdata)
+                    {
+                        break;
+                    }
+                }
+
                 if (add_prefix)
                 {
                     oa->write_character(to_char_type('{'));
@@ -14448,14 +14792,16 @@ class binary_writer
                 if (use_type && !j.m_value.object->empty())
                 {
                     JSON_ASSERT(use_count);
-                    const CharType first_prefix = ubjson_prefix(j.front());
+                    const CharType first_prefix = ubjson_prefix(j.front(), use_bjdata);
                     const bool same_prefix = std::all_of(j.begin(), j.end(),
-                                                         [this, first_prefix](const BasicJsonType & v)
+                                                         [this, first_prefix, use_bjdata](const BasicJsonType & v)
                     {
-                        return ubjson_prefix(v) == first_prefix;
+                        return ubjson_prefix(v, use_bjdata) == first_prefix;
                     });
 
-                    if (same_prefix)
+                    std::vector<CharType> bjdx = {'[', '{', 'S', 'H', 'T', 'F', 'N', 'Z'}; // excluded markers in bjdata optimized type
+
+                    if (same_prefix && !(use_bjdata && std::find(bjdx.begin(), bjdx.end(), first_prefix) != bjdx.end()))
                     {
                         prefix_required = false;
                         oa->write_character(to_char_type('$'));
@@ -14466,16 +14812,16 @@ class binary_writer
                 if (use_count)
                 {
                     oa->write_character(to_char_type('#'));
-                    write_number_with_ubjson_prefix(j.m_value.object->size(), true);
+                    write_number_with_ubjson_prefix(j.m_value.object->size(), true, use_bjdata);
                 }
 
                 for (const auto& el : *j.m_value.object)
                 {
-                    write_number_with_ubjson_prefix(el.first.size(), true);
+                    write_number_with_ubjson_prefix(el.first.size(), true, use_bjdata);
                     oa->write_characters(
                         reinterpret_cast<const CharType*>(el.first.c_str()),
                         el.first.size());
-                    write_ubjson(el.second, use_count, use_type, prefix_required);
+                    write_ubjson(el.second, use_count, use_type, prefix_required, use_bjdata);
                 }
 
                 if (!use_count)
@@ -14542,7 +14888,7 @@ class binary_writer
                            const double value)
     {
         write_bson_entry_header(name, 0x01);
-        write_number<double, true>(value);
+        write_number<double>(value, true);
     }
 
     /*!
@@ -14561,7 +14907,7 @@ class binary_writer
     {
         write_bson_entry_header(name, 0x02);
 
-        write_number<std::int32_t, true>(static_cast<std::int32_t>(value.size() + 1ul));
+        write_number<std::int32_t>(static_cast<std::int32_t>(value.size() + 1ul), true);
         oa->write_characters(
             reinterpret_cast<const CharType*>(value.c_str()),
             value.size() + 1);
@@ -14594,12 +14940,12 @@ class binary_writer
         if ((std::numeric_limits<std::int32_t>::min)() <= value && value <= (std::numeric_limits<std::int32_t>::max)())
         {
             write_bson_entry_header(name, 0x10); // int32
-            write_number<std::int32_t, true>(static_cast<std::int32_t>(value));
+            write_number<std::int32_t>(static_cast<std::int32_t>(value), true);
         }
         else
         {
             write_bson_entry_header(name, 0x12); // int64
-            write_number<std::int64_t, true>(static_cast<std::int64_t>(value));
+            write_number<std::int64_t>(static_cast<std::int64_t>(value), true);
         }
     }
 
@@ -14622,12 +14968,12 @@ class binary_writer
         if (j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::int32_t>::max)()))
         {
             write_bson_entry_header(name, 0x10 /* int32 */);
-            write_number<std::int32_t, true>(static_cast<std::int32_t>(j.m_value.number_unsigned));
+            write_number<std::int32_t>(static_cast<std::int32_t>(j.m_value.number_unsigned), true);
         }
         else if (j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::int64_t>::max)()))
         {
             write_bson_entry_header(name, 0x12 /* int64 */);
-            write_number<std::int64_t, true>(static_cast<std::int64_t>(j.m_value.number_unsigned));
+            write_number<std::int64_t>(static_cast<std::int64_t>(j.m_value.number_unsigned), true);
         }
         else
         {
@@ -14675,7 +15021,7 @@ class binary_writer
                           const typename BasicJsonType::array_t& value)
     {
         write_bson_entry_header(name, 0x04); // array
-        write_number<std::int32_t, true>(static_cast<std::int32_t>(calc_bson_array_size(value)));
+        write_number<std::int32_t>(static_cast<std::int32_t>(calc_bson_array_size(value)), true);
 
         std::size_t array_index = 0ul;
 
@@ -14695,7 +15041,7 @@ class binary_writer
     {
         write_bson_entry_header(name, 0x05);
 
-        write_number<std::int32_t, true>(static_cast<std::int32_t>(value.size()));
+        write_number<std::int32_t>(static_cast<std::int32_t>(value.size()), true);
         write_number(value.has_subtype() ? static_cast<std::uint8_t>(value.subtype()) : static_cast<std::uint8_t>(0x00));
 
         oa->write_characters(reinterpret_cast<const CharType*>(value.data()), value.size());
@@ -14817,7 +15163,7 @@ class binary_writer
     */
     void write_bson_object(const typename BasicJsonType::object_t& value)
     {
-        write_number<std::int32_t, true>(static_cast<std::int32_t>(calc_bson_object_size(value)));
+        write_number<std::int32_t>(static_cast<std::int32_t>(calc_bson_object_size(value)), true);
 
         for (const auto& el : value)
         {
@@ -14863,20 +15209,22 @@ class binary_writer
     template<typename NumberType, typename std::enable_if<
                  std::is_floating_point<NumberType>::value, int>::type = 0>
     void write_number_with_ubjson_prefix(const NumberType n,
-                                         const bool add_prefix)
+                                         const bool add_prefix,
+                                         const bool use_bjdata)
     {
         if (add_prefix)
         {
             oa->write_character(get_ubjson_float_prefix(n));
         }
-        write_number(n);
+        write_number(n, use_bjdata);
     }
 
     // UBJSON: write number (unsigned integer)
     template<typename NumberType, typename std::enable_if<
                  std::is_unsigned<NumberType>::value, int>::type = 0>
     void write_number_with_ubjson_prefix(const NumberType n,
-                                         const bool add_prefix)
+                                         const bool add_prefix,
+                                         const bool use_bjdata)
     {
         if (n <= static_cast<std::uint64_t>((std::numeric_limits<std::int8_t>::max)()))
         {
@@ -14884,7 +15232,7 @@ class binary_writer
             {
                 oa->write_character(to_char_type('i'));  // int8
             }
-            write_number(static_cast<std::uint8_t>(n));
+            write_number(static_cast<std::uint8_t>(n), use_bjdata);
         }
         else if (n <= (std::numeric_limits<std::uint8_t>::max)())
         {
@@ -14892,7 +15240,7 @@ class binary_writer
             {
                 oa->write_character(to_char_type('U'));  // uint8
             }
-            write_number(static_cast<std::uint8_t>(n));
+            write_number(static_cast<std::uint8_t>(n), use_bjdata);
         }
         else if (n <= static_cast<std::uint64_t>((std::numeric_limits<std::int16_t>::max)()))
         {
@@ -14900,7 +15248,15 @@ class binary_writer
             {
                 oa->write_character(to_char_type('I'));  // int16
             }
-            write_number(static_cast<std::int16_t>(n));
+            write_number(static_cast<std::int16_t>(n), use_bjdata);
+        }
+        else if (use_bjdata && n <= static_cast<uint64_t>((std::numeric_limits<uint16_t>::max)()))
+        {
+            if (add_prefix)
+            {
+                oa->write_character(to_char_type('u'));  // uint16 - bjdata only
+            }
+            write_number(static_cast<std::uint16_t>(n), use_bjdata);
         }
         else if (n <= static_cast<std::uint64_t>((std::numeric_limits<std::int32_t>::max)()))
         {
@@ -14908,7 +15264,15 @@ class binary_writer
             {
                 oa->write_character(to_char_type('l'));  // int32
             }
-            write_number(static_cast<std::int32_t>(n));
+            write_number(static_cast<std::int32_t>(n), use_bjdata);
+        }
+        else if (use_bjdata && n <= static_cast<uint64_t>((std::numeric_limits<uint32_t>::max)()))
+        {
+            if (add_prefix)
+            {
+                oa->write_character(to_char_type('m'));  // uint32 - bjdata only
+            }
+            write_number(static_cast<std::uint32_t>(n), use_bjdata);
         }
         else if (n <= static_cast<std::uint64_t>((std::numeric_limits<std::int64_t>::max)()))
         {
@@ -14916,7 +15280,15 @@ class binary_writer
             {
                 oa->write_character(to_char_type('L'));  // int64
             }
-            write_number(static_cast<std::int64_t>(n));
+            write_number(static_cast<std::int64_t>(n), use_bjdata);
+        }
+        else if (use_bjdata && n <= (std::numeric_limits<uint64_t>::max)())
+        {
+            if (add_prefix)
+            {
+                oa->write_character(to_char_type('M'));  // uint64 - bjdata only
+            }
+            write_number(static_cast<std::uint64_t>(n), use_bjdata);
         }
         else
         {
@@ -14926,7 +15298,7 @@ class binary_writer
             }
 
             const auto number = BasicJsonType(n).dump();
-            write_number_with_ubjson_prefix(number.size(), true);
+            write_number_with_ubjson_prefix(number.size(), true, use_bjdata);
             for (std::size_t i = 0; i < number.size(); ++i)
             {
                 oa->write_character(to_char_type(static_cast<std::uint8_t>(number[i])));
@@ -14939,7 +15311,8 @@ class binary_writer
                    std::is_signed<NumberType>::value&&
                    !std::is_floating_point<NumberType>::value, int >::type = 0 >
     void write_number_with_ubjson_prefix(const NumberType n,
-                                         const bool add_prefix)
+                                         const bool add_prefix,
+                                         const bool use_bjdata)
     {
         if ((std::numeric_limits<std::int8_t>::min)() <= n && n <= (std::numeric_limits<std::int8_t>::max)())
         {
@@ -14947,7 +15320,7 @@ class binary_writer
             {
                 oa->write_character(to_char_type('i'));  // int8
             }
-            write_number(static_cast<std::int8_t>(n));
+            write_number(static_cast<std::int8_t>(n), use_bjdata);
         }
         else if (static_cast<std::int64_t>((std::numeric_limits<std::uint8_t>::min)()) <= n && n <= static_cast<std::int64_t>((std::numeric_limits<std::uint8_t>::max)()))
         {
@@ -14955,7 +15328,7 @@ class binary_writer
             {
                 oa->write_character(to_char_type('U'));  // uint8
             }
-            write_number(static_cast<std::uint8_t>(n));
+            write_number(static_cast<std::uint8_t>(n), use_bjdata);
         }
         else if ((std::numeric_limits<std::int16_t>::min)() <= n && n <= (std::numeric_limits<std::int16_t>::max)())
         {
@@ -14963,7 +15336,15 @@ class binary_writer
             {
                 oa->write_character(to_char_type('I'));  // int16
             }
-            write_number(static_cast<std::int16_t>(n));
+            write_number(static_cast<std::int16_t>(n), use_bjdata);
+        }
+        else if (use_bjdata && (static_cast<std::int64_t>((std::numeric_limits<std::uint16_t>::min)()) <= n && n <= static_cast<std::int64_t>((std::numeric_limits<std::uint16_t>::max)())))
+        {
+            if (add_prefix)
+            {
+                oa->write_character(to_char_type('u'));  // uint16 - bjdata only
+            }
+            write_number(static_cast<uint16_t>(n), use_bjdata);
         }
         else if ((std::numeric_limits<std::int32_t>::min)() <= n && n <= (std::numeric_limits<std::int32_t>::max)())
         {
@@ -14971,7 +15352,15 @@ class binary_writer
             {
                 oa->write_character(to_char_type('l'));  // int32
             }
-            write_number(static_cast<std::int32_t>(n));
+            write_number(static_cast<std::int32_t>(n), use_bjdata);
+        }
+        else if (use_bjdata && (static_cast<std::int64_t>((std::numeric_limits<std::uint32_t>::min)()) <= n && n <= static_cast<std::int64_t>((std::numeric_limits<std::uint32_t>::max)())))
+        {
+            if (add_prefix)
+            {
+                oa->write_character(to_char_type('m'));  // uint32 - bjdata only
+            }
+            write_number(static_cast<uint32_t>(n), use_bjdata);
         }
         else if ((std::numeric_limits<std::int64_t>::min)() <= n && n <= (std::numeric_limits<std::int64_t>::max)())
         {
@@ -14979,7 +15368,7 @@ class binary_writer
             {
                 oa->write_character(to_char_type('L'));  // int64
             }
-            write_number(static_cast<std::int64_t>(n));
+            write_number(static_cast<std::int64_t>(n), use_bjdata);
         }
         // LCOV_EXCL_START
         else
@@ -14990,7 +15379,7 @@ class binary_writer
             }
 
             const auto number = BasicJsonType(n).dump();
-            write_number_with_ubjson_prefix(number.size(), true);
+            write_number_with_ubjson_prefix(number.size(), true, use_bjdata);
             for (std::size_t i = 0; i < number.size(); ++i)
             {
                 oa->write_character(to_char_type(static_cast<std::uint8_t>(number[i])));
@@ -15002,7 +15391,7 @@ class binary_writer
     /*!
     @brief determine the type prefix of container values
     */
-    CharType ubjson_prefix(const BasicJsonType& j) const noexcept
+    CharType ubjson_prefix(const BasicJsonType& j, const bool use_bjdata) const noexcept
     {
         switch (j.type())
         {
@@ -15026,10 +15415,18 @@ class binary_writer
                 {
                     return 'I';
                 }
+                if (use_bjdata && ((std::numeric_limits<std::uint16_t>::min)() <= j.m_value.number_integer && j.m_value.number_integer <= (std::numeric_limits<std::uint16_t>::max)()))
+                {
+                    return 'u';
+                }
                 if ((std::numeric_limits<std::int32_t>::min)() <= j.m_value.number_integer && j.m_value.number_integer <= (std::numeric_limits<std::int32_t>::max)())
                 {
                     return 'l';
                 }
+                if (use_bjdata && ((std::numeric_limits<std::uint32_t>::min)() <= j.m_value.number_integer && j.m_value.number_integer <= (std::numeric_limits<std::uint32_t>::max)()))
+                {
+                    return 'm';
+                }
                 if ((std::numeric_limits<std::int64_t>::min)() <= j.m_value.number_integer && j.m_value.number_integer <= (std::numeric_limits<std::int64_t>::max)())
                 {
                     return 'L';
@@ -15052,14 +15449,26 @@ class binary_writer
                 {
                     return 'I';
                 }
+                if (use_bjdata && j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::uint16_t>::max)()))
+                {
+                    return 'u';
+                }
                 if (j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::int32_t>::max)()))
                 {
                     return 'l';
                 }
+                if (use_bjdata && j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::uint32_t>::max)()))
+                {
+                    return 'm';
+                }
                 if (j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::int64_t>::max)()))
                 {
                     return 'L';
                 }
+                if (use_bjdata && j.m_value.number_unsigned <= (std::numeric_limits<std::uint64_t>::max)())
+                {
+                    return 'M';
+                }
                 // anything else is treated as high-precision number
                 return 'H'; // LCOV_EXCL_LINE
             }
@@ -15093,6 +15502,118 @@ class binary_writer
         return 'D';  // float 64
     }
 
+    /*!
+    @return false if the object is successfully converted to a bjdata ndarray, true if the type or size is invalid
+    */
+    bool write_bjdata_ndarray(const typename BasicJsonType::object_t& value, const bool use_count, const bool use_type)
+    {
+        std::map<string_t, CharType> bjdtype = {{"uint8", 'U'},  {"int8", 'i'},  {"uint16", 'u'}, {"int16", 'I'},
+            {"uint32", 'm'}, {"int32", 'l'}, {"uint64", 'M'}, {"int64", 'L'}, {"single", 'd'}, {"double", 'D'}, {"char", 'C'}
+        };
+
+        string_t key = "_ArrayType_";
+        auto it = bjdtype.find(static_cast<string_t>(value.at(key)));
+        if (it == bjdtype.end())
+        {
+            return true;
+        }
+        CharType dtype = it->second;
+
+        key = "_ArraySize_";
+        std::size_t len = (value.at(key).empty() ? 0 : 1);
+        for (const auto& el : value.at(key))
+        {
+            len *= static_cast<std::size_t>(el.m_value.number_unsigned);
+        }
+
+        key = "_ArrayData_";
+        if (value.at(key).size() != len)
+        {
+            return true;
+        }
+
+        oa->write_character('[');
+        oa->write_character('$');
+        oa->write_character(dtype);
+        oa->write_character('#');
+
+        key = "_ArraySize_";
+        write_ubjson(value.at(key), use_count, use_type, true,  true);
+
+        key = "_ArrayData_";
+        if (dtype == 'U' || dtype == 'C')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::uint8_t>(el.m_value.number_unsigned), true);
+            }
+        }
+        else if (dtype == 'i')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::int8_t>(el.m_value.number_integer), true);
+            }
+        }
+        else if (dtype == 'u')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::uint16_t>(el.m_value.number_unsigned), true);
+            }
+        }
+        else if (dtype == 'I')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::int16_t>(el.m_value.number_integer), true);
+            }
+        }
+        else if (dtype == 'm')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::uint32_t>(el.m_value.number_unsigned), true);
+            }
+        }
+        else if (dtype == 'l')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::int32_t>(el.m_value.number_integer), true);
+            }
+        }
+        else if (dtype == 'M')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::uint64_t>(el.m_value.number_unsigned), true);
+            }
+        }
+        else if (dtype == 'L')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<std::int64_t>(el.m_value.number_integer), true);
+            }
+        }
+        else if (dtype == 'd')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<float>(el.m_value.number_float), true);
+            }
+        }
+        else if (dtype == 'D')
+        {
+            for (const auto& el : value.at(key))
+            {
+                write_number(static_cast<double>(el.m_value.number_float), true);
+            }
+        }
+        return false;
+    }
+
     ///////////////////////
     // Utility functions //
     ///////////////////////
@@ -15100,16 +15621,18 @@ class binary_writer
     /*
     @brief write a number to output input
     @param[in] n number of type @a NumberType
-    @tparam NumberType the type of the number
-    @tparam OutputIsLittleEndian Set to true if output data is
+    @param[in] OutputIsLittleEndian Set to true if output data is
                                  required to be little endian
+    @tparam NumberType the type of the number
 
     @note This function needs to respect the system's endianness, because bytes
           in CBOR, MessagePack, and UBJSON are stored in network order (big
           endian) and therefore need reordering on little endian systems.
+          On the other hand, BSON and BJData use little endian and should reorder
+          on big endian systems.
     */
-    template<typename NumberType, bool OutputIsLittleEndian = false>
-    void write_number(const NumberType n)
+    template<typename NumberType>
+    void write_number(const NumberType n, const bool OutputIsLittleEndian = false)
     {
         // step 1: write number to array of length NumberType
         std::array<CharType, sizeof(NumberType)> vec{};
@@ -21221,7 +21744,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         auto ia = detail::input_adapter(std::forward<InputType>(i));
         return format == input_format_t::json
                ? parser(std::move(ia), nullptr, true, ignore_comments).sax_parse(sax, strict)
-               : detail::binary_reader<basic_json, decltype(ia), SAX>(std::move(ia)).sax_parse(format, sax, strict);
+               : detail::binary_reader<basic_json, decltype(ia), SAX>(std::move(ia), format).sax_parse(format, sax, strict);
     }
 
     /// @brief generate SAX events
@@ -21236,7 +21759,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         auto ia = detail::input_adapter(std::move(first), std::move(last));
         return format == input_format_t::json
                ? parser(std::move(ia), nullptr, true, ignore_comments).sax_parse(sax, strict)
-               : detail::binary_reader<basic_json, decltype(ia), SAX>(std::move(ia)).sax_parse(format, sax, strict);
+               : detail::binary_reader<basic_json, decltype(ia), SAX>(std::move(ia), format).sax_parse(format, sax, strict);
     }
 
     /// @brief generate SAX events
@@ -21257,7 +21780,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
                // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
                ? parser(std::move(ia), nullptr, true, ignore_comments).sax_parse(sax, strict)
                // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
-               : detail::binary_reader<basic_json, decltype(ia), SAX>(std::move(ia)).sax_parse(format, sax, strict);
+               : detail::binary_reader<basic_json, decltype(ia), SAX>(std::move(ia), format).sax_parse(format, sax, strict);
     }
 #ifndef JSON_NO_IO
     /// @brief deserialize from stream
@@ -21413,6 +21936,33 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         binary_writer<char>(o).write_ubjson(j, use_size, use_type);
     }
 
+    /// @brief create a BJData serialization of a given JSON value
+    /// @sa https://json.nlohmann.me/api/basic_json/to_bjdata/
+    static std::vector<std::uint8_t> to_bjdata(const basic_json& j,
+            const bool use_size = false,
+            const bool use_type = false)
+    {
+        std::vector<std::uint8_t> result;
+        to_bjdata(j, result, use_size, use_type);
+        return result;
+    }
+
+    /// @brief create a BJData serialization of a given JSON value
+    /// @sa https://json.nlohmann.me/api/basic_json/to_bjdata/
+    static void to_bjdata(const basic_json& j, detail::output_adapter<std::uint8_t> o,
+                          const bool use_size = false, const bool use_type = false)
+    {
+        binary_writer<std::uint8_t>(o).write_ubjson(j, use_size, use_type, true, true);
+    }
+
+    /// @brief create a BJData serialization of a given JSON value
+    /// @sa https://json.nlohmann.me/api/basic_json/to_bjdata/
+    static void to_bjdata(const basic_json& j, detail::output_adapter<char> o,
+                          const bool use_size = false, const bool use_type = false)
+    {
+        binary_writer<char>(o).write_ubjson(j, use_size, use_type, true, true);
+    }
+
     /// @brief create a BSON serialization of a given JSON value
     /// @sa https://json.nlohmann.me/api/basic_json/to_bson/
     static std::vector<std::uint8_t> to_bson(const basic_json& j)
@@ -21448,7 +21998,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::forward<InputType>(i));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::cbor, &sdp, strict, tag_handler);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::cbor).sax_parse(input_format_t::cbor, &sdp, strict, tag_handler);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -21464,7 +22014,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::move(first), std::move(last));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::cbor, &sdp, strict, tag_handler);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::cbor).sax_parse(input_format_t::cbor, &sdp, strict, tag_handler);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -21491,7 +22041,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = i.get();
         // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::cbor, &sdp, strict, tag_handler);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::cbor).sax_parse(input_format_t::cbor, &sdp, strict, tag_handler);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -21506,7 +22056,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::forward<InputType>(i));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::msgpack, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::msgpack).sax_parse(input_format_t::msgpack, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -21521,7 +22071,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::move(first), std::move(last));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::msgpack, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::msgpack).sax_parse(input_format_t::msgpack, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -21545,7 +22095,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = i.get();
         // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::msgpack, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::msgpack).sax_parse(input_format_t::msgpack, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -21560,7 +22110,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::forward<InputType>(i));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::ubjson, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::ubjson).sax_parse(input_format_t::ubjson, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -21575,7 +22125,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::move(first), std::move(last));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::ubjson, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::ubjson).sax_parse(input_format_t::ubjson, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -21599,10 +22149,64 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = i.get();
         // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::ubjson, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::ubjson).sax_parse(input_format_t::ubjson, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
+
+    /// @brief create a JSON value from an input in BJData format
+    /// @sa https://json.nlohmann.me/api/basic_json/from_bjdata/
+    template<typename InputType>
+    JSON_HEDLEY_WARN_UNUSED_RESULT
+    static basic_json from_bjdata(InputType&& i,
+                                  const bool strict = true,
+                                  const bool allow_exceptions = true)
+    {
+        basic_json result;
+        detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
+        auto ia = detail::input_adapter(std::forward<InputType>(i));
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::bjdata).sax_parse(input_format_t::bjdata, &sdp, strict);
+        return res ? result : basic_json(value_t::discarded);
+    }
+
+    /// @brief create a JSON value from an input in BJData format
+    /// @sa https://json.nlohmann.me/api/basic_json/from_bjdata/
+    template<typename IteratorType>
+    JSON_HEDLEY_WARN_UNUSED_RESULT
+    static basic_json from_bjdata(IteratorType first, IteratorType last,
+                                  const bool strict = true,
+                                  const bool allow_exceptions = true)
+    {
+        basic_json result;
+        detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
+        auto ia = detail::input_adapter(std::move(first), std::move(last));
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::bjdata).sax_parse(input_format_t::bjdata, &sdp, strict);
+        return res ? result : basic_json(value_t::discarded);
+    }
+
+    template<typename T>
+    JSON_HEDLEY_WARN_UNUSED_RESULT
+    static basic_json from_bjdata(const T* ptr, std::size_t len,
+                                  const bool strict = true,
+                                  const bool allow_exceptions = true)
+    {
+        return from_bjdata(ptr, ptr + len, strict, allow_exceptions);
+    }
+
+    JSON_HEDLEY_WARN_UNUSED_RESULT
+    static basic_json from_bjdata(detail::span_input_adapter&& i,
+                                  const bool strict = true,
+                                  const bool allow_exceptions = true)
+    {
+        basic_json result;
+        detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
+        auto ia = i.get();
+        // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::bjdata).sax_parse(input_format_t::bjdata, &sdp, strict);
+        return res ? result : basic_json(value_t::discarded);
+    }
+
+
     /// @brief create a JSON value from an input in BSON format
     /// @sa https://json.nlohmann.me/api/basic_json/from_bson/
     template<typename InputType>
@@ -21614,7 +22218,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::forward<InputType>(i));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::bson, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::bson).sax_parse(input_format_t::bson, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -21629,7 +22233,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         basic_json result;
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = detail::input_adapter(std::move(first), std::move(last));
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::bson, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::bson).sax_parse(input_format_t::bson, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
 
@@ -21653,7 +22257,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
         auto ia = i.get();
         // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
-        const bool res = binary_reader<decltype(ia)>(std::move(ia)).sax_parse(input_format_t::bson, &sdp, strict);
+        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::bson).sax_parse(input_format_t::bson, &sdp, strict);
         return res ? result : basic_json(value_t::discarded);
     }
     /// @}
diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt
index 2f06def50..1d5c78697 100644
--- a/test/CMakeLists.txt
+++ b/test/CMakeLists.txt
@@ -72,7 +72,7 @@ endif()
 
 if (CMAKE_CXX_COMPILER_ID STREQUAL "MSVC")
     # avoid stack overflow, see https://github.com/nlohmann/json/issues/2955
-    json_test_set_test_options("test-cbor;test-msgpack;test-ubjson" LINK_OPTIONS /STACK:4000000)
+    json_test_set_test_options("test-cbor;test-msgpack;test-ubjson;test-bjdata" LINK_OPTIONS /STACK:4000000)
 endif()
 
 # disable exceptions for test-disabled_exceptions
diff --git a/test/Makefile b/test/Makefile
index 2d08a8f7b..3a11ce7dd 100644
--- a/test/Makefile
+++ b/test/Makefile
@@ -10,7 +10,7 @@ CXXFLAGS += -std=c++11
 CPPFLAGS += -I ../single_include
 
 FUZZER_ENGINE = src/fuzzer-driver_afl.cpp
-FUZZERS = parse_afl_fuzzer parse_bson_fuzzer parse_cbor_fuzzer parse_msgpack_fuzzer parse_ubjson_fuzzer
+FUZZERS = parse_afl_fuzzer parse_bson_fuzzer parse_cbor_fuzzer parse_msgpack_fuzzer parse_ubjson_fuzzer parse_bjdata_fuzzer
 fuzzers: $(FUZZERS)
 
 parse_afl_fuzzer:
@@ -27,3 +27,6 @@ parse_msgpack_fuzzer:
 
 parse_ubjson_fuzzer:
 	$(CXX) $(CXXFLAGS) $(CPPFLAGS) $(FUZZER_ENGINE) src/fuzzer-parse_ubjson.cpp -o $@
+
+parse_bjdata_fuzzer:
+	$(CXX) $(CXXFLAGS) $(CPPFLAGS) $(FUZZER_ENGINE) src/fuzzer-parse_bjdata.cpp -o $@
diff --git a/test/src/fuzzer-parse_bjdata.cpp b/test/src/fuzzer-parse_bjdata.cpp
new file mode 100644
index 000000000..99e799bd3
--- /dev/null
+++ b/test/src/fuzzer-parse_bjdata.cpp
@@ -0,0 +1,84 @@
+/*
+    __ _____ _____ _____
+ __|  |   __|     |   | |  JSON for Modern C++ (fuzz test support)
+|  |  |__   |  |  | | | |  version 3.10.5
+|_____|_____|_____|_|___|  https://github.com/nlohmann/json
+
+This file implements a parser test suitable for fuzz testing. Given a byte
+array data, it performs the following steps:
+
+- j1 = from_bjdata(data)
+- vec = to_bjdata(j1)
+- j2 = from_bjdata(vec)
+- assert(j1 == j2)
+- vec2 = to_bjdata(j1, use_size = true, use_type = false)
+- j3 = from_bjdata(vec2)
+- assert(j1 == j3)
+- vec3 = to_bjdata(j1, use_size = true, use_type = true)
+- j4 = from_bjdata(vec3)
+- assert(j1 == j4)
+
+The provided function `LLVMFuzzerTestOneInput` can be used in different fuzzer
+drivers.
+
+Licensed under the MIT License <http://opensource.org/licenses/MIT>.
+*/
+
+#include <iostream>
+#include <sstream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+// see http://llvm.org/docs/LibFuzzer.html
+extern "C" int LLVMFuzzerTestOneInput(const uint8_t* data, size_t size)
+{
+    try
+    {
+        // step 1: parse input
+        std::vector<uint8_t> vec1(data, data + size);
+        json j1 = json::from_bjdata(vec1);
+
+        try
+        {
+            // step 2.1: round trip without adding size annotations to container types
+            std::vector<uint8_t> vec2 = json::to_bjdata(j1, false, false);
+
+            // step 2.2: round trip with adding size annotations but without adding type annonations to container types
+            std::vector<uint8_t> vec3 = json::to_bjdata(j1, true, false);
+
+            // step 2.3: round trip with adding size as well as type annotations to container types
+            std::vector<uint8_t> vec4 = json::to_bjdata(j1, true, true);
+
+            // parse serialization
+            json j2 = json::from_bjdata(vec2);
+            json j3 = json::from_bjdata(vec3);
+            json j4 = json::from_bjdata(vec4);
+
+            // serializations must match
+            assert(json::to_bjdata(j2, false, false) == vec2);
+            assert(json::to_bjdata(j3, true, false) == vec3);
+            assert(json::to_bjdata(j4, true, true) == vec4);
+        }
+        catch (const json::parse_error&)
+        {
+            // parsing a BJData serialization must not fail
+            assert(false);
+        }
+    }
+    catch (const json::parse_error&)
+    {
+        // parse errors are ok, because input may be random bytes
+    }
+    catch (const json::type_error&)
+    {
+        // type errors can occur during parsing, too
+    }
+    catch (const json::out_of_range&)
+    {
+        // out of range errors may happen if provided sizes are excessive
+    }
+
+    // return 0 - non-zero return values are reserved for future use
+    return 0;
+}
diff --git a/test/src/unit-bjdata.cpp b/test/src/unit-bjdata.cpp
new file mode 100644
index 000000000..bc6c52833
--- /dev/null
+++ b/test/src/unit-bjdata.cpp
@@ -0,0 +1,3355 @@
+/*
+    __ _____ _____ _____
+ __|  |   __|     |   | |  JSON for Modern C++ (test suite)
+|  |  |__   |  |  | | | |  version 3.10.5
+|_____|_____|_____|_|___|  https://github.com/nlohmann/json
+
+Licensed under the MIT License <http://opensource.org/licenses/MIT>.
+SPDX-License-Identifier: MIT
+Copyright (c) 2013-2022 Niels Lohmann <http://nlohmann.me>.
+
+Permission is hereby  granted, free of charge, to any  person obtaining a copy
+of this software and associated  documentation files (the "Software"), to deal
+in the Software  without restriction, including without  limitation the rights
+to  use, copy,  modify, merge,  publish, distribute,  sublicense, and/or  sell
+copies  of  the Software,  and  to  permit persons  to  whom  the Software  is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE  IS PROVIDED "AS  IS", WITHOUT WARRANTY  OF ANY KIND,  EXPRESS OR
+IMPLIED,  INCLUDING BUT  NOT  LIMITED TO  THE  WARRANTIES OF  MERCHANTABILITY,
+FITNESS FOR  A PARTICULAR PURPOSE AND  NONINFRINGEMENT. IN NO EVENT  SHALL THE
+AUTHORS  OR COPYRIGHT  HOLDERS  BE  LIABLE FOR  ANY  CLAIM,  DAMAGES OR  OTHER
+LIABILITY, WHETHER IN AN ACTION OF  CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE  OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+*/
+
+#include "doctest_compatibility.h"
+
+#include <nlohmann/json.hpp>
+using nlohmann::json;
+
+#include <iostream>
+#include <fstream>
+#include <set>
+#include <test_data.hpp>
+#include "test_utils.hpp"
+
+namespace
+{
+class SaxCountdown
+{
+  public:
+    explicit SaxCountdown(const int count) : events_left(count)
+    {}
+
+    bool null()
+    {
+        return events_left-- > 0;
+    }
+
+    bool boolean(bool /*unused*/)
+    {
+        return events_left-- > 0;
+    }
+
+    bool number_integer(json::number_integer_t /*unused*/)
+    {
+        return events_left-- > 0;
+    }
+
+    bool number_unsigned(json::number_unsigned_t /*unused*/)
+    {
+        return events_left-- > 0;
+    }
+
+    bool number_float(json::number_float_t /*unused*/, const std::string& /*unused*/)
+    {
+        return events_left-- > 0;
+    }
+
+    bool string(std::string& /*unused*/)
+    {
+        return events_left-- > 0;
+    }
+
+    bool binary(std::vector<std::uint8_t>& /*unused*/)
+    {
+        return events_left-- > 0;
+    }
+
+    bool start_object(std::size_t /*unused*/)
+    {
+        return events_left-- > 0;
+    }
+
+    bool key(std::string& /*unused*/)
+    {
+        return events_left-- > 0;
+    }
+
+    bool end_object()
+    {
+        return events_left-- > 0;
+    }
+
+    bool start_array(std::size_t /*unused*/)
+    {
+        return events_left-- > 0;
+    }
+
+    bool end_array()
+    {
+        return events_left-- > 0;
+    }
+
+    bool parse_error(std::size_t /*unused*/, const std::string& /*unused*/, const json::exception& /*unused*/) // NOLINT(readability-convert-member-functions-to-static)
+    {
+        return false;
+    }
+
+  private:
+    int events_left = 0;
+};
+} // namespace
+
+TEST_CASE("BJData")
+{
+    SECTION("individual values")
+    {
+        SECTION("discarded")
+        {
+            // discarded values are not serialized
+            json j = json::value_t::discarded;
+            const auto result = json::to_bjdata(j);
+            CHECK(result.empty());
+        }
+
+        SECTION("null")
+        {
+            json j = nullptr;
+            std::vector<uint8_t> expected = {'Z'};
+            const auto result = json::to_bjdata(j);
+            CHECK(result == expected);
+
+            // roundtrip
+            CHECK(json::from_bjdata(result) == j);
+            CHECK(json::from_bjdata(result, true, false) == j);
+        }
+
+        SECTION("boolean")
+        {
+            SECTION("true")
+            {
+                json j = true;
+                std::vector<uint8_t> expected = {'T'};
+                const auto result = json::to_bjdata(j);
+                CHECK(result == expected);
+
+                // roundtrip
+                CHECK(json::from_bjdata(result) == j);
+                CHECK(json::from_bjdata(result, true, false) == j);
+            }
+
+            SECTION("false")
+            {
+                json j = false;
+                std::vector<uint8_t> expected = {'F'};
+                const auto result = json::to_bjdata(j);
+                CHECK(result == expected);
+
+                // roundtrip
+                CHECK(json::from_bjdata(result) == j);
+                CHECK(json::from_bjdata(result, true, false) == j);
+            }
+        }
+
+        SECTION("number")
+        {
+            SECTION("signed")
+            {
+                SECTION("-9223372036854775808..-2147483649 (int64)")
+                {
+                    std::vector<int64_t> numbers;
+                    numbers.push_back((std::numeric_limits<int64_t>::min)());
+                    numbers.push_back(-1000000000000000000LL);
+                    numbers.push_back(-100000000000000000LL);
+                    numbers.push_back(-10000000000000000LL);
+                    numbers.push_back(-1000000000000000LL);
+                    numbers.push_back(-100000000000000LL);
+                    numbers.push_back(-10000000000000LL);
+                    numbers.push_back(-1000000000000LL);
+                    numbers.push_back(-100000000000LL);
+                    numbers.push_back(-10000000000LL);
+                    numbers.push_back(-2147483649LL);
+                    for (auto i : numbers)
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with integer number
+                        json j = i;
+
+                        // check type
+                        CHECK(j.is_number_integer());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back(static_cast<uint8_t>('L'));
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 8) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 16) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 24) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 32) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 40) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 48) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 56) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 9);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'L');
+                        int64_t restored = (static_cast<int64_t>(result[8]) << 070) +
+                                           (static_cast<int64_t>(result[7]) << 060) +
+                                           (static_cast<int64_t>(result[6]) << 050) +
+                                           (static_cast<int64_t>(result[5]) << 040) +
+                                           (static_cast<int64_t>(result[4]) << 030) +
+                                           (static_cast<int64_t>(result[3]) << 020) +
+                                           (static_cast<int64_t>(result[2]) << 010) +
+                                           static_cast<int64_t>(result[1]);
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("-2147483648..-32769 (int32)")
+                {
+                    std::vector<int32_t> numbers;
+                    numbers.push_back(-32769);
+                    numbers.push_back(-100000);
+                    numbers.push_back(-1000000);
+                    numbers.push_back(-10000000);
+                    numbers.push_back(-100000000);
+                    numbers.push_back(-1000000000);
+                    numbers.push_back(-2147483647 - 1); // https://stackoverflow.com/a/29356002/266378
+                    for (auto i : numbers)
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with integer number
+                        json j = i;
+
+                        // check type
+                        CHECK(j.is_number_integer());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back(static_cast<uint8_t>('l'));
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 8) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 16) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 24) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 5);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'l');
+                        int32_t restored = (static_cast<int32_t>(result[4]) << 030) +
+                                           (static_cast<int32_t>(result[3]) << 020) +
+                                           (static_cast<int32_t>(result[2]) << 010) +
+                                           static_cast<int32_t>(result[1]);
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("-32768..-129 (int16)")
+                {
+                    for (int32_t i = -32768; i <= -129; ++i)
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with integer number
+                        json j = i;
+
+                        // check type
+                        CHECK(j.is_number_integer());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back(static_cast<uint8_t>('I'));
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 8) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 3);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'I');
+                        auto restored = static_cast<int16_t>(((result[2] << 8) + result[1]));
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("-9263 (int16)")
+                {
+                    json j = -9263;
+                    std::vector<uint8_t> expected = {'I', 0xd1, 0xdb};
+
+                    // compare result + size
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+                    CHECK(result.size() == 3);
+
+                    // check individual bytes
+                    CHECK(result[0] == 'I');
+                    auto restored = static_cast<int16_t>(((result[2] << 8) + result[1]));
+                    CHECK(restored == -9263);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("-128..-1 (int8)")
+                {
+                    for (auto i = -128; i <= -1; ++i)
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with integer number
+                        json j = i;
+
+                        // check type
+                        CHECK(j.is_number_integer());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back('i');
+                        expected.push_back(static_cast<uint8_t>(i));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 2);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'i');
+                        CHECK(static_cast<int8_t>(result[1]) == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("0..127 (int8)")
+                {
+                    for (size_t i = 0; i <= 127; ++i)
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with integer number
+                        json j = -1;
+                        j.get_ref<json::number_integer_t&>() = static_cast<json::number_integer_t>(i);
+
+                        // check type
+                        CHECK(j.is_number_integer());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back(static_cast<uint8_t>('i'));
+                        expected.push_back(static_cast<uint8_t>(i));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 2);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'i');
+                        CHECK(result[1] == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("128..255 (uint8)")
+                {
+                    for (size_t i = 128; i <= 255; ++i)
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with integer number
+                        json j = -1;
+                        j.get_ref<json::number_integer_t&>() = static_cast<json::number_integer_t>(i);
+
+                        // check type
+                        CHECK(j.is_number_integer());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back(static_cast<uint8_t>('U'));
+                        expected.push_back(static_cast<uint8_t>(i));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 2);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'U');
+                        CHECK(result[1] == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("256..32767 (int16)")
+                {
+                    for (size_t i = 256; i <= 32767; ++i)
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with integer number
+                        json j = -1;
+                        j.get_ref<json::number_integer_t&>() = static_cast<json::number_integer_t>(i);
+
+                        // check type
+                        CHECK(j.is_number_integer());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back(static_cast<uint8_t>('I'));
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 8) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 3);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'I');
+                        auto restored = static_cast<uint16_t>(static_cast<uint8_t>(result[2]) * 256 + static_cast<uint8_t>(result[1]));
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("32768..65535 (uint16)")
+                {
+                    for (uint32_t i :
+                            {
+                                32768u, 55555u, 65535u
+                            })
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with integer number
+                        json j = -1;
+                        j.get_ref<json::number_integer_t&>() = static_cast<json::number_integer_t>(i);
+
+                        // check type
+                        CHECK(j.is_number_integer());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back(static_cast<uint8_t>('u'));
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 8) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 3);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'u');
+                        auto restored = static_cast<uint16_t>(static_cast<uint8_t>(result[2]) * 256 + static_cast<uint8_t>(result[1]));
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("65536..2147483647 (int32)")
+                {
+                    for (uint32_t i :
+                            {
+                                65536u, 77777u, 2147483647u
+                            })
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with integer number
+                        json j = -1;
+                        j.get_ref<json::number_integer_t&>() = static_cast<json::number_integer_t>(i);
+
+                        // check type
+                        CHECK(j.is_number_integer());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back('l');
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 8) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 16) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 24) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 5);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'l');
+                        uint32_t restored = (static_cast<uint32_t>(result[4]) << 030) +
+                                            (static_cast<uint32_t>(result[3]) << 020) +
+                                            (static_cast<uint32_t>(result[2]) << 010) +
+                                            static_cast<uint32_t>(result[1]);
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("2147483648..4294967295 (uint32)")
+                {
+                    for (uint32_t i :
+                            {
+                                2147483648u, 3333333333u, 4294967295u
+                            })
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with integer number
+                        json j = -1;
+                        j.get_ref<json::number_integer_t&>() = static_cast<json::number_integer_t>(i);
+
+                        // check type
+                        CHECK(j.is_number_integer());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back('m');
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 8) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 16) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 24) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 5);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'm');
+                        uint32_t restored = (static_cast<uint32_t>(result[4]) << 030) +
+                                            (static_cast<uint32_t>(result[3]) << 020) +
+                                            (static_cast<uint32_t>(result[2]) << 010) +
+                                            static_cast<uint32_t>(result[1]);
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("4294967296..9223372036854775807 (int64)")
+                {
+                    std::vector<uint64_t> v = {4294967296LU, 9223372036854775807LU};
+                    for (uint64_t i : v)
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with integer number
+                        json j = -1;
+                        j.get_ref<json::number_integer_t&>() = static_cast<json::number_integer_t>(i);
+
+                        // check type
+                        CHECK(j.is_number_integer());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back('L');
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 010) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 020) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 030) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 040) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 050) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 060) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 070) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 9);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'L');
+                        uint64_t restored = (static_cast<uint64_t>(result[8]) << 070) +
+                                            (static_cast<uint64_t>(result[7]) << 060) +
+                                            (static_cast<uint64_t>(result[6]) << 050) +
+                                            (static_cast<uint64_t>(result[5]) << 040) +
+                                            (static_cast<uint64_t>(result[4]) << 030) +
+                                            (static_cast<uint64_t>(result[3]) << 020) +
+                                            (static_cast<uint64_t>(result[2]) << 010) +
+                                            static_cast<uint64_t>(result[1]);
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("9223372036854775808..18446744073709551615 (uint64)")
+                {
+                    std::vector<uint64_t> v = {9223372036854775808ull, 18446744073709551615ull};
+                    for (uint64_t i : v)
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with integer number
+                        json j = i;
+
+                        // check type
+                        CHECK(j.is_number_unsigned());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back('M');
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 010) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 020) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 030) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 040) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 050) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 060) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 070) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 9);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'M');
+                        uint64_t restored = (static_cast<uint64_t>(result[8]) << 070) +
+                                            (static_cast<uint64_t>(result[7]) << 060) +
+                                            (static_cast<uint64_t>(result[6]) << 050) +
+                                            (static_cast<uint64_t>(result[5]) << 040) +
+                                            (static_cast<uint64_t>(result[4]) << 030) +
+                                            (static_cast<uint64_t>(result[3]) << 020) +
+                                            (static_cast<uint64_t>(result[2]) << 010) +
+                                            static_cast<uint64_t>(result[1]);
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+            }
+
+            SECTION("unsigned")
+            {
+                SECTION("0..127 (int8)")
+                {
+                    for (size_t i = 0; i <= 127; ++i)
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with unsigned integer number
+                        json j = i;
+
+                        // check type
+                        CHECK(j.is_number_unsigned());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back('i');
+                        expected.push_back(static_cast<uint8_t>(i));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 2);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'i');
+                        auto restored = static_cast<uint8_t>(result[1]);
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("128..255 (uint8)")
+                {
+                    for (size_t i = 128; i <= 255; ++i)
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with unsigned integer number
+                        json j = i;
+
+                        // check type
+                        CHECK(j.is_number_unsigned());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back('U');
+                        expected.push_back(static_cast<uint8_t>(i));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 2);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'U');
+                        auto restored = static_cast<uint8_t>(result[1]);
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("256..32767 (int16)")
+                {
+                    for (size_t i = 256; i <= 32767; ++i)
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with unsigned integer number
+                        json j = i;
+
+                        // check type
+                        CHECK(j.is_number_unsigned());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back('I');
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 8) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 3);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'I');
+                        auto restored = static_cast<uint16_t>(static_cast<uint8_t>(result[2]) * 256 + static_cast<uint8_t>(result[1]));
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("32768..65535 (uint16)")
+                {
+                    for (uint32_t i :
+                            {
+                                32768u, 55555u, 65535u
+                            })
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with unsigned integer number
+                        json j = i;
+
+                        // check type
+                        CHECK(j.is_number_unsigned());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back('u');
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 8) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 3);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'u');
+                        auto restored = static_cast<uint16_t>(static_cast<uint8_t>(result[2]) * 256 + static_cast<uint8_t>(result[1]));
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+                SECTION("65536..2147483647 (int32)")
+                {
+                    for (uint32_t i :
+                            {
+                                65536u, 77777u, 2147483647u
+                            })
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with unsigned integer number
+                        json j = i;
+
+                        // check type
+                        CHECK(j.is_number_unsigned());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back('l');
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 8) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 16) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 24) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 5);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'l');
+                        uint32_t restored = (static_cast<uint32_t>(result[4]) << 030) +
+                                            (static_cast<uint32_t>(result[3]) << 020) +
+                                            (static_cast<uint32_t>(result[2]) << 010) +
+                                            static_cast<uint32_t>(result[1]);
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("2147483648..4294967295 (uint32)")
+                {
+                    for (uint32_t i :
+                            {
+                                2147483648u, 3333333333u, 4294967295u
+                            })
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with unsigned integer number
+                        json j = i;
+
+                        // check type
+                        CHECK(j.is_number_unsigned());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back('m');
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 8) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 16) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 24) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 5);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'm');
+                        uint32_t restored = (static_cast<uint32_t>(result[4]) << 030) +
+                                            (static_cast<uint32_t>(result[3]) << 020) +
+                                            (static_cast<uint32_t>(result[2]) << 010) +
+                                            static_cast<uint32_t>(result[1]);
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("4294967296..9223372036854775807 (int64)")
+                {
+                    std::vector<uint64_t> v = {4294967296ul, 9223372036854775807ul};
+                    for (uint64_t i : v)
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with integer number
+                        json j = i;
+
+                        // check type
+                        CHECK(j.is_number_unsigned());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back('L');
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 010) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 020) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 030) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 040) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 050) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 060) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 070) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 9);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'L');
+                        uint64_t restored = (static_cast<uint64_t>(result[8]) << 070) +
+                                            (static_cast<uint64_t>(result[7]) << 060) +
+                                            (static_cast<uint64_t>(result[6]) << 050) +
+                                            (static_cast<uint64_t>(result[5]) << 040) +
+                                            (static_cast<uint64_t>(result[4]) << 030) +
+                                            (static_cast<uint64_t>(result[3]) << 020) +
+                                            (static_cast<uint64_t>(result[2]) << 010) +
+                                            static_cast<uint64_t>(result[1]);
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+
+                SECTION("9223372036854775808..18446744073709551615 (uint64)")
+                {
+                    std::vector<uint64_t> v = {9223372036854775808ull, 18446744073709551615ull};
+                    for (uint64_t i : v)
+                    {
+                        CAPTURE(i)
+
+                        // create JSON value with integer number
+                        json j = i;
+
+                        // check type
+                        CHECK(j.is_number_unsigned());
+
+                        // create expected byte vector
+                        std::vector<uint8_t> expected;
+                        expected.push_back('M');
+                        expected.push_back(static_cast<uint8_t>(i & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 010) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 020) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 030) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 040) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 050) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 060) & 0xff));
+                        expected.push_back(static_cast<uint8_t>((i >> 070) & 0xff));
+
+                        // compare result + size
+                        const auto result = json::to_bjdata(j);
+                        CHECK(result == expected);
+                        CHECK(result.size() == 9);
+
+                        // check individual bytes
+                        CHECK(result[0] == 'M');
+                        uint64_t restored = (static_cast<uint64_t>(result[8]) << 070) +
+                                            (static_cast<uint64_t>(result[7]) << 060) +
+                                            (static_cast<uint64_t>(result[6]) << 050) +
+                                            (static_cast<uint64_t>(result[5]) << 040) +
+                                            (static_cast<uint64_t>(result[4]) << 030) +
+                                            (static_cast<uint64_t>(result[3]) << 020) +
+                                            (static_cast<uint64_t>(result[2]) << 010) +
+                                            static_cast<uint64_t>(result[1]);
+                        CHECK(restored == i);
+
+                        // roundtrip
+                        CHECK(json::from_bjdata(result) == j);
+                        CHECK(json::from_bjdata(result, true, false) == j);
+                    }
+                }
+            }
+            SECTION("float64")
+            {
+                SECTION("3.1415925")
+                {
+                    double v = 3.1415925;
+                    json j = v;
+                    std::vector<uint8_t> expected =
+                    {
+                        'D', 0xfc, 0xde, 0xa6, 0x3f, 0xfb, 0x21, 0x09, 0x40
+                    };
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result) == v);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+
+            SECTION("half-precision float")
+            {
+                SECTION("simple half floats")
+                {
+                    CHECK(json::parse("0.0") == json::from_bjdata(std::vector<uint8_t>({'h', 0x00, 0x00})));
+                    CHECK(json::parse("-0.0") == json::from_bjdata(std::vector<uint8_t>({'h', 0x00, 0x80})));
+                    CHECK(json::parse("1.0") == json::from_bjdata(std::vector<uint8_t>({'h', 0x00, 0x3c})));
+                    CHECK(json::parse("1.5") == json::from_bjdata(std::vector<uint8_t>({'h', 0x00, 0x3e})));
+                    CHECK(json::parse("65504.0") == json::from_bjdata(std::vector<uint8_t>({'h', 0xff, 0x7b})));
+                }
+
+                SECTION("errors")
+                {
+                    SECTION("no byte follows")
+                    {
+                        json _;
+                        std::vector<uint8_t> vec0 = {'h'};
+                        CHECK_THROWS_AS(_ = json::from_bjdata(vec0), json::parse_error&);
+                        CHECK_THROWS_WITH(_ = json::from_bjdata(vec0), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData number: unexpected end of input");
+                        CHECK(json::from_bjdata(vec0, true, false).is_discarded());
+                    }
+
+                    SECTION("only one byte follows")
+                    {
+                        json _;
+                        std::vector<uint8_t> vec1 = {'h', 0x00};
+                        CHECK_THROWS_AS(_ = json::from_bjdata(vec1), json::parse_error&);
+                        CHECK_THROWS_WITH(_ = json::from_bjdata(vec1), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing BJData number: unexpected end of input");
+                        CHECK(json::from_bjdata(vec1, true, false).is_discarded());
+                    }
+                }
+            }
+
+            SECTION("half-precision float (edge cases)")
+            {
+                SECTION("exp = 0b00000")
+                {
+                    SECTION("0 (0 00000 0000000000)")
+                    {
+                        json j = json::from_bjdata(std::vector<uint8_t>({'h', 0x00, 0x00}));
+                        json::number_float_t d{j};
+                        CHECK(d == 0.0);
+                    }
+
+                    SECTION("-0 (1 00000 0000000000)")
+                    {
+                        json j = json::from_bjdata(std::vector<uint8_t>({'h', 0x00, 0x80}));
+                        json::number_float_t d{j};
+                        CHECK(d == -0.0);
+                    }
+
+                    SECTION("2**-24 (0 00000 0000000001)")
+                    {
+                        json j = json::from_bjdata(std::vector<uint8_t>({'h', 0x01, 0x00}));
+                        json::number_float_t d{j};
+                        CHECK(d == std::pow(2.0, -24.0));
+                    }
+                }
+
+                SECTION("exp = 0b11111")
+                {
+                    SECTION("infinity (0 11111 0000000000)")
+                    {
+                        json j = json::from_bjdata(std::vector<uint8_t>({'h', 0x00, 0x7c}));
+                        json::number_float_t d{j};
+                        CHECK(d == std::numeric_limits<json::number_float_t>::infinity());
+                        CHECK(j.dump() == "null");
+                    }
+
+                    SECTION("-infinity (1 11111 0000000000)")
+                    {
+                        json j = json::from_bjdata(std::vector<uint8_t>({'h', 0x00, 0xfc}));
+                        json::number_float_t d{j};
+                        CHECK(d == -std::numeric_limits<json::number_float_t>::infinity());
+                        CHECK(j.dump() == "null");
+                    }
+                }
+
+                SECTION("other values from https://en.wikipedia.org/wiki/Half-precision_floating-point_format")
+                {
+                    SECTION("1 (0 01111 0000000000)")
+                    {
+                        json j = json::from_bjdata(std::vector<uint8_t>({'h', 0x00, 0x3c}));
+                        json::number_float_t d{j};
+                        CHECK(d == 1);
+                    }
+
+                    SECTION("-2 (1 10000 0000000000)")
+                    {
+                        json j = json::from_bjdata(std::vector<uint8_t>({'h', 0x00, 0xc0}));
+                        json::number_float_t d{j};
+                        CHECK(d == -2);
+                    }
+
+                    SECTION("65504 (0 11110 1111111111)")
+                    {
+                        json j = json::from_bjdata(std::vector<uint8_t>({'h', 0xff, 0x7b}));
+                        json::number_float_t d{j};
+                        CHECK(d == 65504);
+                    }
+                }
+
+                SECTION("infinity")
+                {
+                    json j = json::from_bjdata(std::vector<uint8_t>({'h', 0x00, 0x7c}));
+                    json::number_float_t d{j};
+                    CHECK(!std::isfinite(d));
+                    CHECK(j.dump() == "null");
+                }
+
+                SECTION("NaN")
+                {
+                    json j = json::from_bjdata(std::vector<uint8_t>({'h', 0x00, 0x7e }));
+                    json::number_float_t d{j};
+                    CHECK(std::isnan(d));
+                    CHECK(j.dump() == "null");
+                }
+            }
+
+            SECTION("high-precision number")
+            {
+                SECTION("unsigned integer number")
+                {
+                    std::vector<uint8_t> vec = {'H', 'i', 0x14, '1', '2', '3', '4', '5', '6', '7', '8', '9', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '0'};
+                    const auto j = json::from_bjdata(vec);
+                    CHECK(j.is_number_unsigned());
+                    CHECK(j.dump() == "12345678901234567890");
+                }
+
+                SECTION("signed integer number")
+                {
+                    std::vector<uint8_t> vec = {'H', 'i', 0x13, '-', '1', '2', '3', '4', '5', '6', '7', '8', '9', '0', '1', '2', '3', '4', '5', '6', '7', '8'};
+                    const auto j = json::from_bjdata(vec);
+                    CHECK(j.is_number_integer());
+                    CHECK(j.dump() == "-123456789012345678");
+                }
+
+                SECTION("floating-point number")
+                {
+                    std::vector<uint8_t> vec = {'H', 'i', 0x16, '3', '.', '1', '4', '1', '5', '9',  '2', '6', '5', '3', '5', '8', '9',  '7', '9', '3', '2', '3', '8', '4',  '6'};
+                    const auto j = json::from_bjdata(vec);
+                    CHECK(j.is_number_float());
+                    CHECK(j.dump() == "3.141592653589793");
+                }
+
+                SECTION("errors")
+                {
+                    // error while parsing length
+                    std::vector<uint8_t> vec0 = {'H', 'i'};
+                    CHECK(json::from_bjdata(vec0, true, false).is_discarded());
+                    // error while parsing string
+                    std::vector<uint8_t> vec1 = {'H', 'i', '1'};
+                    CHECK(json::from_bjdata(vec1, true, false).is_discarded());
+
+                    json _;
+                    std::vector<uint8_t> vec2 = {'H', 'i', 2, '1', 'A', '3'};
+                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vec2), "[json.exception.parse_error.115] parse error at byte 5: syntax error while parsing BJData high-precision number: invalid number text: 1A", json::parse_error);
+                    std::vector<uint8_t> vec3 = {'H', 'i', 2, '1', '.'};
+                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vec3), "[json.exception.parse_error.115] parse error at byte 5: syntax error while parsing BJData high-precision number: invalid number text: 1.", json::parse_error);
+                    std::vector<uint8_t> vec4 = {'H', 2, '1', '0'};
+                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vec4), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing BJData size: expected length type specification (U, i, u, I, m, l, M, L) after '#'; last byte: 0x02", json::parse_error);
+                }
+            }
+        }
+
+        SECTION("string")
+        {
+            SECTION("N = 0..127")
+            {
+                for (size_t N = 0; N <= 127; ++N)
+                {
+                    CAPTURE(N)
+
+                    // create JSON value with string containing of N * 'x'
+                    const auto s = std::string(N, 'x');
+                    json j = s;
+
+                    // create expected byte vector
+                    std::vector<uint8_t> expected;
+                    expected.push_back('S');
+                    expected.push_back('i');
+                    expected.push_back(static_cast<uint8_t>(N));
+                    for (size_t i = 0; i < N; ++i)
+                    {
+                        expected.push_back('x');
+                    }
+
+                    // compare result + size
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+                    CHECK(result.size() == N + 3);
+                    // check that no null byte is appended
+                    if (N > 0)
+                    {
+                        CHECK(result.back() != '\x00');
+                    }
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+
+            SECTION("N = 128..255")
+            {
+                for (size_t N = 128; N <= 255; ++N)
+                {
+                    CAPTURE(N)
+
+                    // create JSON value with string containing of N * 'x'
+                    const auto s = std::string(N, 'x');
+                    json j = s;
+
+                    // create expected byte vector
+                    std::vector<uint8_t> expected;
+                    expected.push_back('S');
+                    expected.push_back('U');
+                    expected.push_back(static_cast<uint8_t>(N));
+                    for (size_t i = 0; i < N; ++i)
+                    {
+                        expected.push_back('x');
+                    }
+
+                    // compare result + size
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+                    CHECK(result.size() == N + 3);
+                    // check that no null byte is appended
+                    CHECK(result.back() != '\x00');
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+
+            SECTION("N = 256..32767")
+            {
+                for (size_t N :
+                        {
+                            256u, 999u, 1025u, 3333u, 2048u, 32767u
+                        })
+                {
+                    CAPTURE(N)
+
+                    // create JSON value with string containing of N * 'x'
+                    const auto s = std::string(N, 'x');
+                    json j = s;
+
+                    // create expected byte vector (hack: create string first)
+                    std::vector<uint8_t> expected(N, 'x');
+                    // reverse order of commands, because we insert at begin()
+                    expected.insert(expected.begin(), static_cast<uint8_t>((N >> 8) & 0xff));
+                    expected.insert(expected.begin(), static_cast<uint8_t>(N & 0xff));
+                    expected.insert(expected.begin(), 'I');
+                    expected.insert(expected.begin(), 'S');
+
+                    // compare result + size
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+                    CHECK(result.size() == N + 4);
+                    // check that no null byte is appended
+                    CHECK(result.back() != '\x00');
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+
+            SECTION("N = 32768..65535")
+            {
+                for (size_t N :
+                        {
+                            32768u, 55555u, 65535u
+                        })
+                {
+                    CAPTURE(N)
+
+                    // create JSON value with string containing of N * 'x'
+                    const auto s = std::string(N, 'x');
+                    json j = s;
+
+                    // create expected byte vector (hack: create string first)
+                    std::vector<uint8_t> expected(N, 'x');
+                    // reverse order of commands, because we insert at begin()
+                    expected.insert(expected.begin(), static_cast<uint8_t>((N >> 8) & 0xff));
+                    expected.insert(expected.begin(), static_cast<uint8_t>(N & 0xff));
+                    expected.insert(expected.begin(), 'u');
+                    expected.insert(expected.begin(), 'S');
+
+                    // compare result + size
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+                    CHECK(result.size() == N + 4);
+                    // check that no null byte is appended
+                    CHECK(result.back() != '\x00');
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+
+            SECTION("N = 65536..2147483647")
+            {
+                for (size_t N :
+                        {
+                            65536u, 77777u, 1048576u
+                        })
+                {
+                    CAPTURE(N)
+
+                    // create JSON value with string containing of N * 'x'
+                    const auto s = std::string(N, 'x');
+                    json j = s;
+
+                    // create expected byte vector (hack: create string first)
+                    std::vector<uint8_t> expected(N, 'x');
+                    // reverse order of commands, because we insert at begin()
+                    expected.insert(expected.begin(), static_cast<uint8_t>((N >> 24) & 0xff));
+                    expected.insert(expected.begin(), static_cast<uint8_t>((N >> 16) & 0xff));
+                    expected.insert(expected.begin(), static_cast<uint8_t>((N >> 8) & 0xff));
+                    expected.insert(expected.begin(), static_cast<uint8_t>(N & 0xff));
+                    expected.insert(expected.begin(), 'l');
+                    expected.insert(expected.begin(), 'S');
+
+                    // compare result + size
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+                    CHECK(result.size() == N + 6);
+                    // check that no null byte is appended
+                    CHECK(result.back() != '\x00');
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+        }
+
+
+        SECTION("binary")
+        {
+            SECTION("N = 0..127")
+            {
+                for (std::size_t N = 0; N <= 127; ++N)
+                {
+                    CAPTURE(N)
+
+                    // create JSON value with byte array containing of N * 'x'
+                    const auto s = std::vector<std::uint8_t>(N, 'x');
+                    json j = json::binary(s);
+
+                    // create expected byte vector
+                    std::vector<std::uint8_t> expected;
+                    expected.push_back(static_cast<std::uint8_t>('['));
+                    if (N != 0)
+                    {
+                        expected.push_back(static_cast<std::uint8_t>('$'));
+                        expected.push_back(static_cast<std::uint8_t>('U'));
+                    }
+                    expected.push_back(static_cast<std::uint8_t>('#'));
+                    expected.push_back(static_cast<std::uint8_t>('i'));
+                    expected.push_back(static_cast<std::uint8_t>(N));
+                    for (size_t i = 0; i < N; ++i)
+                    {
+                        expected.push_back(0x78);
+                    }
+
+                    // compare result + size
+                    const auto result = json::to_bjdata(j, true, true);
+                    CHECK(result == expected);
+                    if (N == 0)
+                    {
+                        CHECK(result.size() == N + 4);
+                    }
+                    else
+                    {
+                        CHECK(result.size() == N + 6);
+                    }
+
+                    // check that no null byte is appended
+                    if (N > 0)
+                    {
+                        CHECK(result.back() != '\x00');
+                    }
+
+                    // roundtrip only works to an array of numbers
+                    json j_out = s;
+                    CHECK(json::from_bjdata(result) == j_out);
+                    CHECK(json::from_bjdata(result, true, false) == j_out);
+                }
+            }
+
+            SECTION("N = 128..255")
+            {
+                for (std::size_t N = 128; N <= 255; ++N)
+                {
+                    CAPTURE(N)
+
+                    // create JSON value with byte array containing of N * 'x'
+                    const auto s = std::vector<std::uint8_t>(N, 'x');
+                    json j = json::binary(s);
+
+                    // create expected byte vector
+                    std::vector<uint8_t> expected;
+                    expected.push_back(static_cast<std::uint8_t>('['));
+                    expected.push_back(static_cast<std::uint8_t>('$'));
+                    expected.push_back(static_cast<std::uint8_t>('U'));
+                    expected.push_back(static_cast<std::uint8_t>('#'));
+                    expected.push_back(static_cast<std::uint8_t>('U'));
+                    expected.push_back(static_cast<std::uint8_t>(N));
+                    for (size_t i = 0; i < N; ++i)
+                    {
+                        expected.push_back(0x78);
+                    }
+
+                    // compare result + size
+                    const auto result = json::to_bjdata(j, true, true);
+                    CHECK(result == expected);
+                    CHECK(result.size() == N + 6);
+                    // check that no null byte is appended
+                    CHECK(result.back() != '\x00');
+
+                    // roundtrip only works to an array of numbers
+                    json j_out = s;
+                    CHECK(json::from_bjdata(result) == j_out);
+                    CHECK(json::from_bjdata(result, true, false) == j_out);
+                }
+            }
+
+            SECTION("N = 256..32767")
+            {
+                for (std::size_t N :
+                        {
+                            256u, 999u, 1025u, 3333u, 2048u, 32767u
+                        })
+                {
+                    CAPTURE(N)
+
+                    // create JSON value with byte array containing of N * 'x'
+                    const auto s = std::vector<std::uint8_t>(N, 'x');
+                    json j = json::binary(s);
+
+                    // create expected byte vector
+                    std::vector<std::uint8_t> expected(N + 7, 'x');
+                    expected[0] = '[';
+                    expected[1] = '$';
+                    expected[2] = 'U';
+                    expected[3] = '#';
+                    expected[4] = 'I';
+                    expected[5] = static_cast<std::uint8_t>(N & 0xFF);
+                    expected[6] = static_cast<std::uint8_t>((N >> 8) & 0xFF);
+
+                    // compare result + size
+                    const auto result = json::to_bjdata(j, true, true);
+                    CHECK(result == expected);
+                    CHECK(result.size() == N + 7);
+                    // check that no null byte is appended
+                    CHECK(result.back() != '\x00');
+
+                    // roundtrip only works to an array of numbers
+                    json j_out = s;
+                    CHECK(json::from_bjdata(result) == j_out);
+                    CHECK(json::from_bjdata(result, true, false) == j_out);
+                }
+            }
+
+            SECTION("N = 32768..65535")
+            {
+                for (std::size_t N :
+                        {
+                            32768u, 55555u, 65535u
+                        })
+                {
+                    CAPTURE(N)
+
+                    // create JSON value with byte array containing of N * 'x'
+                    const auto s = std::vector<std::uint8_t>(N, 'x');
+                    json j = json::binary(s);
+
+                    // create expected byte vector
+                    std::vector<std::uint8_t> expected(N + 7, 'x');
+                    expected[0] = '[';
+                    expected[1] = '$';
+                    expected[2] = 'U';
+                    expected[3] = '#';
+                    expected[4] = 'u';
+                    expected[5] = static_cast<std::uint8_t>(N & 0xFF);
+                    expected[6] = static_cast<std::uint8_t>((N >> 8) & 0xFF);
+
+                    // compare result + size
+                    const auto result = json::to_bjdata(j, true, true);
+                    CHECK(result == expected);
+                    CHECK(result.size() == N + 7);
+                    // check that no null byte is appended
+                    CHECK(result.back() != '\x00');
+
+                    // roundtrip only works to an array of numbers
+                    json j_out = s;
+                    CHECK(json::from_bjdata(result) == j_out);
+                    CHECK(json::from_bjdata(result, true, false) == j_out);
+                }
+            }
+
+            SECTION("N = 65536..2147483647")
+            {
+                for (std::size_t N :
+                        {
+                            65536u, 77777u, 1048576u
+                        })
+                {
+                    CAPTURE(N)
+
+                    // create JSON value with byte array containing of N * 'x'
+                    const auto s = std::vector<std::uint8_t>(N, 'x');
+                    json j = json::binary(s);
+
+                    // create expected byte vector
+                    std::vector<std::uint8_t> expected(N + 9, 'x');
+                    expected[0] = '[';
+                    expected[1] = '$';
+                    expected[2] = 'U';
+                    expected[3] = '#';
+                    expected[4] = 'l';
+                    expected[5] = static_cast<std::uint8_t>(N & 0xFF);
+                    expected[6] = static_cast<std::uint8_t>((N >> 8) & 0xFF);
+                    expected[7] = static_cast<std::uint8_t>((N >> 16) & 0xFF);
+                    expected[8] = static_cast<std::uint8_t>((N >> 24) & 0xFF);
+
+                    // compare result + size
+                    const auto result = json::to_bjdata(j, true, true);
+                    CHECK(result == expected);
+                    CHECK(result.size() == N + 9);
+                    // check that no null byte is appended
+                    CHECK(result.back() != '\x00');
+
+                    // roundtrip only works to an array of numbers
+                    json j_out = s;
+                    CHECK(json::from_bjdata(result) == j_out);
+                    CHECK(json::from_bjdata(result, true, false) == j_out);
+                }
+            }
+
+            SECTION("Other Serializations")
+            {
+                const std::size_t N = 10;
+                const auto s = std::vector<std::uint8_t>(N, 'x');
+                json j = json::binary(s);
+
+                SECTION("No Count No Type")
+                {
+                    std::vector<uint8_t> expected;
+                    expected.push_back(static_cast<std::uint8_t>('['));
+                    for (std::size_t i = 0; i < N; ++i)
+                    {
+                        expected.push_back(static_cast<std::uint8_t>('U'));
+                        expected.push_back(static_cast<std::uint8_t>(0x78));
+                    }
+                    expected.push_back(static_cast<std::uint8_t>(']'));
+
+                    // compare result + size
+                    const auto result = json::to_bjdata(j, false, false);
+                    CHECK(result == expected);
+                    CHECK(result.size() == N + 12);
+                    // check that no null byte is appended
+                    CHECK(result.back() != '\x00');
+
+                    // roundtrip only works to an array of numbers
+                    json j_out = s;
+                    CHECK(json::from_bjdata(result) == j_out);
+                    CHECK(json::from_bjdata(result, true, false) == j_out);
+                }
+
+                SECTION("Yes Count No Type")
+                {
+                    std::vector<std::uint8_t> expected;
+                    expected.push_back(static_cast<std::uint8_t>('['));
+                    expected.push_back(static_cast<std::uint8_t>('#'));
+                    expected.push_back(static_cast<std::uint8_t>('i'));
+                    expected.push_back(static_cast<std::uint8_t>(N));
+
+                    for (size_t i = 0; i < N; ++i)
+                    {
+                        expected.push_back(static_cast<std::uint8_t>('U'));
+                        expected.push_back(static_cast<std::uint8_t>(0x78));
+                    }
+
+                    // compare result + size
+                    const auto result = json::to_bjdata(j, true, false);
+                    CHECK(result == expected);
+                    CHECK(result.size() == N + 14);
+                    // check that no null byte is appended
+                    CHECK(result.back() != '\x00');
+
+                    // roundtrip only works to an array of numbers
+                    json j_out = s;
+                    CHECK(json::from_bjdata(result) == j_out);
+                    CHECK(json::from_bjdata(result, true, false) == j_out);
+                }
+            }
+        }
+        SECTION("array")
+        {
+            SECTION("empty")
+            {
+                SECTION("size=false type=false")
+                {
+                    json j = json::array();
+                    std::vector<uint8_t> expected = {'[', ']'};
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=false")
+                {
+                    json j = json::array();
+                    std::vector<uint8_t> expected = {'[', '#', 'i', 0};
+                    const auto result = json::to_bjdata(j, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=true")
+                {
+                    json j = json::array();
+                    std::vector<uint8_t> expected = {'[', '#', 'i', 0};
+                    const auto result = json::to_bjdata(j, true, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+
+            SECTION("[null]")
+            {
+                SECTION("size=false type=false")
+                {
+                    json j = {nullptr};
+                    std::vector<uint8_t> expected = {'[', 'Z', ']'};
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=false")
+                {
+                    json j = {nullptr};
+                    std::vector<uint8_t> expected = {'[', '#', 'i', 1, 'Z'};
+                    const auto result = json::to_bjdata(j, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=true")
+                {
+                    json j = {nullptr};
+                    std::vector<uint8_t> expected = {'[', '#', 'i', 1, 'Z'};
+                    const auto result = json::to_bjdata(j, true, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+
+            SECTION("[1,2,3,4,5]")
+            {
+                SECTION("size=false type=false")
+                {
+                    json j = json::parse("[1,2,3,4,5]");
+                    std::vector<uint8_t> expected = {'[', 'i', 1, 'i', 2, 'i', 3, 'i', 4, 'i', 5, ']'};
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=false")
+                {
+                    json j = json::parse("[1,2,3,4,5]");
+                    std::vector<uint8_t> expected = {'[', '#', 'i', 5, 'i', 1, 'i', 2, 'i', 3, 'i', 4, 'i', 5};
+                    const auto result = json::to_bjdata(j, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=true")
+                {
+                    json j = json::parse("[1,2,3,4,5]");
+                    std::vector<uint8_t> expected = {'[', '$', 'i', '#', 'i', 5, 1, 2, 3, 4, 5};
+                    const auto result = json::to_bjdata(j, true, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+
+            SECTION("[[[[]]]]")
+            {
+                SECTION("size=false type=false")
+                {
+                    json j = json::parse("[[[[]]]]");
+                    std::vector<uint8_t> expected = {'[', '[', '[', '[', ']', ']', ']', ']'};
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=false")
+                {
+                    json j = json::parse("[[[[]]]]");
+                    std::vector<uint8_t> expected = {'[', '#', 'i', 1, '[', '#', 'i', 1, '[', '#', 'i', 1, '[', '#', 'i', 0};
+                    const auto result = json::to_bjdata(j, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=true")
+                {
+                    json j = json::parse("[[[[]]]]");
+                    std::vector<uint8_t> expected = {'[', '#', 'i', 1, '[', '#', 'i', 1, '[', '#', 'i', 1, '[', '#', 'i', 0};
+                    const auto result = json::to_bjdata(j, true, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+
+            SECTION("array with int16_t elements")
+            {
+                SECTION("size=false type=false")
+                {
+                    json j(257, nullptr);
+                    std::vector<uint8_t> expected(j.size() + 2, 'Z'); // all null
+                    expected[0] = '['; // opening array
+                    expected[258] = ']'; // closing array
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=false")
+                {
+                    json j(257, nullptr);
+                    std::vector<uint8_t> expected(j.size() + 5, 'Z'); // all null
+                    expected[0] = '['; // opening array
+                    expected[1] = '#'; // array size
+                    expected[2] = 'I'; // int16
+                    expected[3] = 0x01; // 0x0101, first byte
+                    expected[4] = 0x01; // 0x0101, second byte
+                    const auto result = json::to_bjdata(j, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+
+            SECTION("array with uint16_t elements")
+            {
+                SECTION("size=false type=false")
+                {
+                    json j(32768, nullptr);
+                    std::vector<uint8_t> expected(j.size() + 2, 'Z'); // all null
+                    expected[0] = '['; // opening array
+                    expected[32769] = ']'; // closing array
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=false")
+                {
+                    json j(32768, nullptr);
+                    std::vector<uint8_t> expected(j.size() + 5, 'Z'); // all null
+                    expected[0] = '['; // opening array
+                    expected[1] = '#'; // array size
+                    expected[2] = 'u'; // int16
+                    expected[3] = 0x00; // 0x0101, first byte
+                    expected[4] = 0x80; // 0x0101, second byte
+                    const auto result = json::to_bjdata(j, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+
+            SECTION("array with int32_t elements")
+            {
+                SECTION("size=false type=false")
+                {
+                    json j(65793, nullptr);
+                    std::vector<uint8_t> expected(j.size() + 2, 'Z'); // all null
+                    expected[0] = '['; // opening array
+                    expected[65794] = ']'; // closing array
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=false")
+                {
+                    json j(65793, nullptr);
+                    std::vector<uint8_t> expected(j.size() + 7, 'Z'); // all null
+                    expected[0] = '['; // opening array
+                    expected[1] = '#'; // array size
+                    expected[2] = 'l'; // int32
+                    expected[3] = 0x01; // 0x00010101, fourth byte
+                    expected[4] = 0x01; // 0x00010101, third byte
+                    expected[5] = 0x01; // 0x00010101, second byte
+                    expected[6] = 0x00; // 0x00010101, first byte
+                    const auto result = json::to_bjdata(j, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+        }
+
+        SECTION("object")
+        {
+            SECTION("empty")
+            {
+                SECTION("size=false type=false")
+                {
+                    json j = json::object();
+                    std::vector<uint8_t> expected = {'{', '}'};
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=false")
+                {
+                    json j = json::object();
+                    std::vector<uint8_t> expected = {'{', '#', 'i', 0};
+                    const auto result = json::to_bjdata(j, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=true")
+                {
+                    json j = json::object();
+                    std::vector<uint8_t> expected = {'{', '#', 'i', 0};
+                    const auto result = json::to_bjdata(j, true, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+
+            SECTION("{\"\":null}")
+            {
+                SECTION("size=false type=false")
+                {
+                    json j = {{"", nullptr}};
+                    std::vector<uint8_t> expected = {'{', 'i', 0, 'Z', '}'};
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=false")
+                {
+                    json j = {{"", nullptr}};
+                    std::vector<uint8_t> expected = {'{', '#', 'i', 1, 'i', 0, 'Z'};
+                    const auto result = json::to_bjdata(j, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+
+            SECTION("{\"a\": {\"b\": {\"c\": {}}}}")
+            {
+                SECTION("size=false type=false")
+                {
+                    json j = json::parse(R"({"a": {"b": {"c": {}}}})");
+                    std::vector<uint8_t> expected =
+                    {
+                        '{', 'i', 1, 'a', '{', 'i', 1, 'b', '{', 'i', 1, 'c', '{', '}', '}', '}', '}'
+                    };
+                    const auto result = json::to_bjdata(j);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=false")
+                {
+                    json j = json::parse(R"({"a": {"b": {"c": {}}}})");
+                    std::vector<uint8_t> expected =
+                    {
+                        '{', '#', 'i', 1, 'i', 1, 'a', '{', '#', 'i', 1, 'i', 1, 'b', '{', '#', 'i', 1, 'i', 1, 'c', '{', '#', 'i', 0
+                    };
+                    const auto result = json::to_bjdata(j, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+
+                SECTION("size=true type=true ignore object type marker")
+                {
+                    json j = json::parse(R"({"a": {"b": {"c": {}}}})");
+                    std::vector<uint8_t> expected =
+                    {
+                        '{', '#', 'i', 1, 'i', 1, 'a', '{', '#', 'i', 1, 'i', 1, 'b', '{', '#', 'i', 1, 'i', 1, 'c', '{', '#', 'i', 0
+                    };
+                    const auto result = json::to_bjdata(j, true, true);
+                    CHECK(result == expected);
+
+                    // roundtrip
+                    CHECK(json::from_bjdata(result) == j);
+                    CHECK(json::from_bjdata(result, true, false) == j);
+                }
+            }
+        }
+    }
+
+    SECTION("errors")
+    {
+        SECTION("strict mode")
+        {
+            std::vector<uint8_t> vec = {'Z', 'Z'};
+            SECTION("non-strict mode")
+            {
+                const auto result = json::from_bjdata(vec, false);
+                CHECK(result == json());
+            }
+
+            SECTION("strict mode")
+            {
+                json _;
+                CHECK_THROWS_AS(_ = json::from_bjdata(vec), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(vec),
+                                  "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData value: expected end of input; last byte: 0x5A");
+            }
+        }
+    }
+
+    SECTION("SAX aborts")
+    {
+        SECTION("start_array()")
+        {
+            std::vector<uint8_t> v = {'[', 'T', 'F', ']'};
+            SaxCountdown scp(0);
+            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+        }
+
+        SECTION("start_object()")
+        {
+            std::vector<uint8_t> v = {'{', 'i', 3, 'f', 'o', 'o', 'F', '}'};
+            SaxCountdown scp(0);
+            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+        }
+
+        SECTION("key() in object")
+        {
+            std::vector<uint8_t> v = {'{', 'i', 3, 'f', 'o', 'o', 'F', '}'};
+            SaxCountdown scp(1);
+            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+        }
+
+        SECTION("start_array(len)")
+        {
+            std::vector<uint8_t> v = {'[', '#', 'i', '2', 'T', 'F'};
+            SaxCountdown scp(0);
+            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+        }
+
+        SECTION("start_object(len)")
+        {
+            std::vector<uint8_t> v = {'{', '#', 'i', '1', 3, 'f', 'o', 'o', 'F'};
+            SaxCountdown scp(0);
+            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+        }
+
+        SECTION("key() in object with length")
+        {
+            std::vector<uint8_t> v = {'{', 'i', 3, 'f', 'o', 'o', 'F', '}'};
+            SaxCountdown scp(1);
+            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+        }
+
+        SECTION("start_array() in ndarray _ArraySize_")
+        {
+            std::vector<uint8_t> v = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'i', 2, 2, 1, 1, 2};
+            SaxCountdown scp(2);
+            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+        }
+
+        SECTION("number_integer() in ndarray _ArraySize_")
+        {
+            std::vector<uint8_t> v = {'[', '$', 'U', '#', '[', '$', 'i', '#', 'i', 2, 2, 1, 1, 2};
+            SaxCountdown scp(3);
+            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+        }
+
+        SECTION("key() in ndarray _ArrayType_")
+        {
+            std::vector<uint8_t> v = {'[', '$', 'U', '#', '[', '$', 'U', '#', 'i', 2, 2, 2, 1, 2, 3, 4};
+            SaxCountdown scp(8);
+            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+        }
+
+        SECTION("string() in ndarray _ArrayType_")
+        {
+            std::vector<uint8_t> v = {'[', '$', 'U', '#', '[', '$', 'i', '#', 'i', 2, 3, 2, 6, 5, 4, 3, 2, 1};
+            SaxCountdown scp(11);
+            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+        }
+
+        SECTION("start_array() in ndarray _ArrayData_")
+        {
+            std::vector<uint8_t> v = {'[', '$', 'U', '#', '[', 'i', 2, 'i', 3, ']', 6, 5, 4, 3, 2, 1};
+            SaxCountdown scp(13);
+            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+        }
+    }
+
+    SECTION("parsing values")
+    {
+        SECTION("strings")
+        {
+            // create a single-character string for all number types
+            std::vector<uint8_t> s_i = {'S', 'i', 1, 'a'};
+            std::vector<uint8_t> s_U = {'S', 'U', 1, 'a'};
+            std::vector<uint8_t> s_I = {'S', 'I', 1, 0, 'a'};
+            std::vector<uint8_t> s_u = {'S', 'u', 1, 0, 'a'};
+            std::vector<uint8_t> s_l = {'S', 'l', 1, 0, 0, 0, 'a'};
+            std::vector<uint8_t> s_m = {'S', 'm', 1, 0, 0, 0, 'a'};
+            std::vector<uint8_t> s_L = {'S', 'L', 1, 0, 0, 0, 0, 0, 0, 0, 'a'};
+            std::vector<uint8_t> s_M = {'S', 'M', 1, 0, 0, 0, 0, 0, 0, 0, 'a'};
+
+            // check if string is parsed correctly to "a"
+            CHECK(json::from_bjdata(s_i) == "a");
+            CHECK(json::from_bjdata(s_U) == "a");
+            CHECK(json::from_bjdata(s_I) == "a");
+            CHECK(json::from_bjdata(s_u) == "a");
+            CHECK(json::from_bjdata(s_l) == "a");
+            CHECK(json::from_bjdata(s_m) == "a");
+            CHECK(json::from_bjdata(s_L) == "a");
+            CHECK(json::from_bjdata(s_M) == "a");
+
+            // roundtrip: output should be optimized
+            CHECK(json::to_bjdata(json::from_bjdata(s_i)) == s_i);
+            CHECK(json::to_bjdata(json::from_bjdata(s_U)) == s_i);
+            CHECK(json::to_bjdata(json::from_bjdata(s_I)) == s_i);
+            CHECK(json::to_bjdata(json::from_bjdata(s_u)) == s_i);
+            CHECK(json::to_bjdata(json::from_bjdata(s_l)) == s_i);
+            CHECK(json::to_bjdata(json::from_bjdata(s_m)) == s_i);
+            CHECK(json::to_bjdata(json::from_bjdata(s_L)) == s_i);
+            CHECK(json::to_bjdata(json::from_bjdata(s_M)) == s_i);
+        }
+
+        SECTION("number")
+        {
+            SECTION("float")
+            {
+                // float32
+                std::vector<uint8_t> v_d = {'d', 0xd0, 0x0f, 0x49, 0x40};
+                CHECK(json::from_bjdata(v_d) == 3.14159f);
+
+                // float64
+                std::vector<uint8_t> v_D = {'D', 0x6e, 0x86, 0x1b, 0xf0, 0xf9, 0x21, 0x09, 0x40};
+                CHECK(json::from_bjdata(v_D) == 3.14159);
+
+                // float32 is serialized as float64 as the library does not support float32
+                CHECK(json::to_bjdata(json::from_bjdata(v_d)) == json::to_bjdata(3.14159f));
+            }
+        }
+
+        SECTION("array")
+        {
+            SECTION("optimized version (length only)")
+            {
+                // create vector with two elements of the same type
+                std::vector<uint8_t> v_TU = {'[', '#', 'U', 2, 'T', 'T'};
+                std::vector<uint8_t> v_T = {'[', '#', 'i', 2, 'T', 'T'};
+                std::vector<uint8_t> v_F = {'[', '#', 'i', 2, 'F', 'F'};
+                std::vector<uint8_t> v_Z = {'[', '#', 'i', 2, 'Z', 'Z'};
+                std::vector<uint8_t> v_i = {'[', '#', 'i', 2, 'i', 0x7F, 'i', 0x7F};
+                std::vector<uint8_t> v_U = {'[', '#', 'i', 2, 'U', 0xFF, 'U', 0xFF};
+                std::vector<uint8_t> v_I = {'[', '#', 'i', 2, 'I', 0xFF, 0x7F, 'I', 0xFF, 0x7F};
+                std::vector<uint8_t> v_u = {'[', '#', 'i', 2, 'u', 0x0F, 0xA7, 'u', 0x0F, 0xA7};
+                std::vector<uint8_t> v_l = {'[', '#', 'i', 2, 'l', 0xFF, 0xFF, 0xFF, 0x7F, 'l', 0xFF, 0xFF, 0xFF, 0x7F};
+                std::vector<uint8_t> v_m = {'[', '#', 'i', 2, 'm', 0xFF, 0xC9, 0x9A, 0xBB, 'm', 0xFF, 0xC9, 0x9A, 0xBB};
+                std::vector<uint8_t> v_L = {'[', '#', 'i', 2, 'L', 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x7F, 'L', 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x7F};
+                std::vector<uint8_t> v_M = {'[', '#', 'i', 2, 'M', 0xFF, 0xFF, 0x63, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D, 'M', 0xFF, 0xFF, 0x63, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D};
+                std::vector<uint8_t> v_D = {'[', '#', 'i', 2, 'D', 0x4a, 0xd8, 0x12, 0x4d, 0xfb, 0x21, 0x09, 0x40, 'D', 0x4a, 0xd8, 0x12, 0x4d, 0xfb, 0x21, 0x09, 0x40};
+                std::vector<uint8_t> v_S = {'[', '#', 'i', 2, 'S', 'i', 1, 'a', 'S', 'i', 1, 'a'};
+                std::vector<uint8_t> v_C = {'[', '#', 'i', 2, 'C', 'a', 'C', 'a'};
+
+                // check if vector is parsed correctly
+                CHECK(json::from_bjdata(v_TU) == json({true, true}));
+                CHECK(json::from_bjdata(v_T) == json({true, true}));
+                CHECK(json::from_bjdata(v_F) == json({false, false}));
+                CHECK(json::from_bjdata(v_Z) == json({nullptr, nullptr}));
+                CHECK(json::from_bjdata(v_i) == json({127, 127}));
+                CHECK(json::from_bjdata(v_U) == json({255, 255}));
+                CHECK(json::from_bjdata(v_I) == json({32767, 32767}));
+                CHECK(json::from_bjdata(v_u) == json({42767, 42767}));
+                CHECK(json::from_bjdata(v_l) == json({2147483647, 2147483647}));
+                CHECK(json::from_bjdata(v_m) == json({3147483647, 3147483647}));
+                CHECK(json::from_bjdata(v_L) == json({9223372036854775807, 9223372036854775807}));
+                CHECK(json::from_bjdata(v_M) == json({10223372036854775807ull, 10223372036854775807ull}));
+                CHECK(json::from_bjdata(v_D) == json({3.1415926, 3.1415926}));
+                CHECK(json::from_bjdata(v_S) == json({"a", "a"}));
+                CHECK(json::from_bjdata(v_C) == json({"a", "a"}));
+
+                // roundtrip: output should be optimized
+                CHECK(json::to_bjdata(json::from_bjdata(v_T), true) == v_T);
+                CHECK(json::to_bjdata(json::from_bjdata(v_F), true) == v_F);
+                CHECK(json::to_bjdata(json::from_bjdata(v_Z), true) == v_Z);
+                CHECK(json::to_bjdata(json::from_bjdata(v_i), true) == v_i);
+                CHECK(json::to_bjdata(json::from_bjdata(v_U), true) == v_U);
+                CHECK(json::to_bjdata(json::from_bjdata(v_I), true) == v_I);
+                CHECK(json::to_bjdata(json::from_bjdata(v_u), true) == v_u);
+                CHECK(json::to_bjdata(json::from_bjdata(v_l), true) == v_l);
+                CHECK(json::to_bjdata(json::from_bjdata(v_m), true) == v_m);
+                CHECK(json::to_bjdata(json::from_bjdata(v_L), true) == v_L);
+                CHECK(json::to_bjdata(json::from_bjdata(v_M), true) == v_M);
+                CHECK(json::to_bjdata(json::from_bjdata(v_D), true) == v_D);
+                CHECK(json::to_bjdata(json::from_bjdata(v_S), true) == v_S);
+                CHECK(json::to_bjdata(json::from_bjdata(v_C), true) == v_S); // char is serialized to string
+            }
+
+            SECTION("optimized version (type and length)")
+            {
+                // create vector with two elements of the same type
+                std::vector<uint8_t> v_i = {'[', '$', 'i', '#', 'i', 2, 0x7F, 0x7F};
+                std::vector<uint8_t> v_U = {'[', '$', 'U', '#', 'i', 2, 0xFF, 0xFF};
+                std::vector<uint8_t> v_I = {'[', '$', 'I', '#', 'i', 2, 0xFF, 0x7F, 0xFF, 0x7F};
+                std::vector<uint8_t> v_u = {'[', '$', 'u', '#', 'i', 2, 0x0F, 0xA7, 0x0F, 0xA7};
+                std::vector<uint8_t> v_l = {'[', '$', 'l', '#', 'i', 2, 0xFF, 0xFF, 0xFF, 0x7F, 0xFF, 0xFF, 0xFF, 0x7F};
+                std::vector<uint8_t> v_m = {'[', '$', 'm', '#', 'i', 2, 0xFF, 0xC9, 0x9A, 0xBB, 0xFF, 0xC9, 0x9A, 0xBB};
+                std::vector<uint8_t> v_L = {'[', '$', 'L', '#', 'i', 2, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x7F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x7F};
+                std::vector<uint8_t> v_M = {'[', '$', 'M', '#', 'i', 2, 0xFF, 0xFF, 0x63, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D, 0xFF, 0xFF, 0x63, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D};
+                std::vector<uint8_t> v_D = {'[', '$', 'D', '#', 'i', 2, 0x4a, 0xd8, 0x12, 0x4d, 0xfb, 0x21, 0x09, 0x40, 0x4a, 0xd8, 0x12, 0x4d, 0xfb, 0x21, 0x09, 0x40};
+                std::vector<uint8_t> v_S = {'[', '#', 'i', 2, 'S', 'i', 1, 'a', 'S', 'i', 1, 'a'};
+                std::vector<uint8_t> v_C = {'[', '$', 'C', '#', 'i', 2, 'a', 'a'};
+
+                // check if vector is parsed correctly
+                CHECK(json::from_bjdata(v_i) == json({127, 127}));
+                CHECK(json::from_bjdata(v_U) == json({255, 255}));
+                CHECK(json::from_bjdata(v_I) == json({32767, 32767}));
+                CHECK(json::from_bjdata(v_u) == json({42767, 42767}));
+                CHECK(json::from_bjdata(v_l) == json({2147483647, 2147483647}));
+                CHECK(json::from_bjdata(v_m) == json({3147483647, 3147483647}));
+                CHECK(json::from_bjdata(v_L) == json({9223372036854775807, 9223372036854775807}));
+                CHECK(json::from_bjdata(v_M) == json({10223372036854775807ull, 10223372036854775807ull}));
+                CHECK(json::from_bjdata(v_D) == json({3.1415926, 3.1415926}));
+                CHECK(json::from_bjdata(v_S) == json({"a", "a"}));
+                CHECK(json::from_bjdata(v_C) == json({"a", "a"}));
+
+                // roundtrip: output should be optimized
+                std::vector<uint8_t> v_empty = {'[', '#', 'i', 0};
+                CHECK(json::to_bjdata(json::from_bjdata(v_i), true, true) == v_i);
+                CHECK(json::to_bjdata(json::from_bjdata(v_U), true, true) == v_U);
+                CHECK(json::to_bjdata(json::from_bjdata(v_I), true, true) == v_I);
+                CHECK(json::to_bjdata(json::from_bjdata(v_u), true, true) == v_u);
+                CHECK(json::to_bjdata(json::from_bjdata(v_l), true, true) == v_l);
+                CHECK(json::to_bjdata(json::from_bjdata(v_m), true, true) == v_m);
+                CHECK(json::to_bjdata(json::from_bjdata(v_L), true, true) == v_L);
+                CHECK(json::to_bjdata(json::from_bjdata(v_M), true, true) == v_M);
+                CHECK(json::to_bjdata(json::from_bjdata(v_D), true, true) == v_D);
+                CHECK(json::to_bjdata(json::from_bjdata(v_S), true, true) == v_S);
+                CHECK(json::to_bjdata(json::from_bjdata(v_C), true, true) == v_S); // char is serialized to string
+            }
+
+            SECTION("optimized ndarray (type and vector-size as optimized 1D array)")
+            {
+                // create vector with two elements of the same type
+                std::vector<uint8_t> v_0 = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'i', 1, 0};
+                std::vector<uint8_t> v_1 = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'i', 1, 2, 0x7F, 0x7F};
+                std::vector<uint8_t> v_i = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'i', 2, 1, 2, 0x7F, 0x7F};
+                std::vector<uint8_t> v_U = {'[', '$', 'U', '#', '[', '$', 'i', '#', 'i', 2, 1, 2, 0xFF, 0xFF};
+                std::vector<uint8_t> v_I = {'[', '$', 'I', '#', '[', '$', 'i', '#', 'i', 2, 1, 2, 0xFF, 0x7F, 0xFF, 0x7F};
+                std::vector<uint8_t> v_u = {'[', '$', 'u', '#', '[', '$', 'i', '#', 'i', 2, 1, 2, 0x0F, 0xA7, 0x0F, 0xA7};
+                std::vector<uint8_t> v_l = {'[', '$', 'l', '#', '[', '$', 'i', '#', 'i', 2, 1, 2, 0xFF, 0xFF, 0xFF, 0x7F, 0xFF, 0xFF, 0xFF, 0x7F};
+                std::vector<uint8_t> v_m = {'[', '$', 'm', '#', '[', '$', 'i', '#', 'i', 2, 1, 2, 0xFF, 0xC9, 0x9A, 0xBB, 0xFF, 0xC9, 0x9A, 0xBB};
+                std::vector<uint8_t> v_L = {'[', '$', 'L', '#', '[', '$', 'i', '#', 'i', 2, 1, 2, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x7F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x7F};
+                std::vector<uint8_t> v_M = {'[', '$', 'M', '#', '[', '$', 'i', '#', 'i', 2, 1, 2, 0xFF, 0xFF, 0x63, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D, 0xFF, 0xFF, 0x63, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D};
+                std::vector<uint8_t> v_D = {'[', '$', 'D', '#', '[', '$', 'i', '#', 'i', 2, 1, 2, 0x4a, 0xd8, 0x12, 0x4d, 0xfb, 0x21, 0x09, 0x40, 0x4a, 0xd8, 0x12, 0x4d, 0xfb, 0x21, 0x09, 0x40};
+                std::vector<uint8_t> v_S = {'[', '#', '[', '$', 'i', '#', 'i', 2, 1, 2, 'S', 'i', 1, 'a', 'S', 'i', 1, 'a'};
+                std::vector<uint8_t> v_C = {'[', '$', 'C', '#', '[', '$', 'i', '#', 'i', 2, 1, 2, 'a', 'a'};
+
+                // check if vector is parsed correctly
+                CHECK(json::from_bjdata(v_0) == json::array());
+                CHECK(json::from_bjdata(v_1) == json({127, 127}));
+                CHECK(json::from_bjdata(v_i) == json({127, 127}));
+                CHECK(json::from_bjdata(v_U) == json({255, 255}));
+                CHECK(json::from_bjdata(v_I) == json({32767, 32767}));
+                CHECK(json::from_bjdata(v_u) == json({42767, 42767}));
+                CHECK(json::from_bjdata(v_l) == json({2147483647, 2147483647}));
+                CHECK(json::from_bjdata(v_m) == json({3147483647, 3147483647}));
+                CHECK(json::from_bjdata(v_L) == json({9223372036854775807, 9223372036854775807}));
+                CHECK(json::from_bjdata(v_M) == json({10223372036854775807ull, 10223372036854775807ull}));
+                CHECK(json::from_bjdata(v_D) == json({3.1415926, 3.1415926}));
+                CHECK(json::from_bjdata(v_S) == json({"a", "a"}));
+                CHECK(json::from_bjdata(v_C) == json({"a", "a"}));
+            }
+
+            SECTION("optimized ndarray (type and vector-size ndarray with JData annotations)")
+            {
+                // create vector with 0, 1, 2 elements of the same type
+                std::vector<uint8_t> v_e = {'[', '$', 'U', '#', '[', '$', 'i', '#', 'i', 2, 2, 1, 0xFE, 0xFF};
+                std::vector<uint8_t> v_U = {'[', '$', 'U', '#', '[', '$', 'i', '#', 'i', 2, 2, 3, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06};
+                std::vector<uint8_t> v_i = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'i', 2, 2, 3, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06};
+                std::vector<uint8_t> v_u = {'[', '$', 'u', '#', '[', '$', 'i', '#', 'i', 2, 2, 3, 0x01, 0x00, 0x02, 0x00, 0x03, 0x00, 0x04, 0x00, 0x05, 0x00, 0x06, 0x00};
+                std::vector<uint8_t> v_I = {'[', '$', 'I', '#', '[', '$', 'i', '#', 'i', 2, 2, 3, 0x01, 0x00, 0x02, 0x00, 0x03, 0x00, 0x04, 0x00, 0x05, 0x00, 0x06, 0x00};
+                std::vector<uint8_t> v_m = {'[', '$', 'm', '#', '[', '$', 'i', '#', 'i', 2, 2, 3, 0x01, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x03, 0x00, 0x00, 0x00, 0x04, 0x00, 0x00, 0x00, 0x05, 0x00, 0x00, 0x00, 0x06, 0x00, 0x00, 0x00};
+                std::vector<uint8_t> v_l = {'[', '$', 'l', '#', '[', '$', 'i', '#', 'i', 2, 2, 3, 0x01, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x03, 0x00, 0x00, 0x00, 0x04, 0x00, 0x00, 0x00, 0x05, 0x00, 0x00, 0x00, 0x06, 0x00, 0x00, 0x00};
+                std::vector<uint8_t> v_M = {'[', '$', 'M', '#', '[', '$', 'i', '#', 'i', 2, 2, 3, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x04, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x05, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x06, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
+                std::vector<uint8_t> v_L = {'[', '$', 'L', '#', '[', '$', 'i', '#', 'i', 2, 2, 3, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x04, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x05, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x06, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
+                std::vector<uint8_t> v_d = {'[', '$', 'd', '#', '[', '$', 'i', '#', 'i', 2, 2, 3, 0x00, 0x00, 0x80, 0x3F, 0x00, 0x00, 0x00, 0x40, 0x00, 0x00, 0x40, 0x40, 0x00, 0x00, 0x80, 0x40, 0x00, 0x00, 0xA0, 0x40, 0x00, 0x00, 0xC0, 0x40};
+                std::vector<uint8_t> v_D = {'[', '$', 'D', '#', '[', '$', 'i', '#', 'i', 2, 2, 3, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xF0, 0x3F, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x40, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x08, 0x40, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, 0x40, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x14, 0x40, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x40};
+                std::vector<uint8_t> v_C = {'[', '$', 'C', '#', '[', '$', 'i', '#', 'i', 2, 2, 3, 'a', 'b', 'c', 'd', 'e', 'f'};
+
+                // check if vector is parsed correctly
+                CHECK(json::from_bjdata(v_e) == json({{"_ArrayData_", {254, 255}}, {"_ArraySize_", {2, 1}}, {"_ArrayType_", "uint8"}}));
+                CHECK(json::from_bjdata(v_U) == json({{"_ArrayData_", {1, 2, 3, 4, 5, 6}}, {"_ArraySize_", {2, 3}}, {"_ArrayType_", "uint8"}}));
+                CHECK(json::from_bjdata(v_i) == json({{"_ArrayData_", {1, 2, 3, 4, 5, 6}}, {"_ArraySize_", {2, 3}}, {"_ArrayType_", "int8"}}));
+                CHECK(json::from_bjdata(v_i) == json({{"_ArrayData_", {1, 2, 3, 4, 5, 6}}, {"_ArraySize_", {2, 3}}, {"_ArrayType_", "int8"}}));
+                CHECK(json::from_bjdata(v_u) == json({{"_ArrayData_", {1, 2, 3, 4, 5, 6}}, {"_ArraySize_", {2, 3}}, {"_ArrayType_", "uint16"}}));
+                CHECK(json::from_bjdata(v_I) == json({{"_ArrayData_", {1, 2, 3, 4, 5, 6}}, {"_ArraySize_", {2, 3}}, {"_ArrayType_", "int16"}}));
+                CHECK(json::from_bjdata(v_m) == json({{"_ArrayData_", {1, 2, 3, 4, 5, 6}}, {"_ArraySize_", {2, 3}}, {"_ArrayType_", "uint32"}}));
+                CHECK(json::from_bjdata(v_l) == json({{"_ArrayData_", {1, 2, 3, 4, 5, 6}}, {"_ArraySize_", {2, 3}}, {"_ArrayType_", "int32"}}));
+                CHECK(json::from_bjdata(v_M) == json({{"_ArrayData_", {1, 2, 3, 4, 5, 6}}, {"_ArraySize_", {2, 3}}, {"_ArrayType_", "uint64"}}));
+                CHECK(json::from_bjdata(v_L) == json({{"_ArrayData_", {1, 2, 3, 4, 5, 6}}, {"_ArraySize_", {2, 3}}, {"_ArrayType_", "int64"}}));
+                CHECK(json::from_bjdata(v_d) == json({{"_ArrayData_", {1.f, 2.f, 3.f, 4.f, 5.f, 6.f}}, {"_ArraySize_", {2, 3}}, {"_ArrayType_", "single"}}));
+                CHECK(json::from_bjdata(v_D) == json({{"_ArrayData_", {1., 2., 3., 4., 5., 6.}}, {"_ArraySize_", {2, 3}}, {"_ArrayType_", "double"}}));
+                CHECK(json::from_bjdata(v_C) == json({{"_ArrayData_", {'a', 'b', 'c', 'd', 'e', 'f'}}, {"_ArraySize_", {2, 3}}, {"_ArrayType_", "char"}}));
+
+                // roundtrip: output should be optimized
+                CHECK(json::to_bjdata(json::from_bjdata(v_e), true, true) == v_e);
+                CHECK(json::to_bjdata(json::from_bjdata(v_U), true, true) == v_U);
+                CHECK(json::to_bjdata(json::from_bjdata(v_i), true, true) == v_i);
+                CHECK(json::to_bjdata(json::from_bjdata(v_u), true, true) == v_u);
+                CHECK(json::to_bjdata(json::from_bjdata(v_I), true, true) == v_I);
+                CHECK(json::to_bjdata(json::from_bjdata(v_m), true, true) == v_m);
+                CHECK(json::to_bjdata(json::from_bjdata(v_l), true, true) == v_l);
+                CHECK(json::to_bjdata(json::from_bjdata(v_M), true, true) == v_M);
+                CHECK(json::to_bjdata(json::from_bjdata(v_L), true, true) == v_L);
+                CHECK(json::to_bjdata(json::from_bjdata(v_d), true, true) == v_d);
+                CHECK(json::to_bjdata(json::from_bjdata(v_D), true, true) == v_D);
+                CHECK(json::to_bjdata(json::from_bjdata(v_C), true, true) == v_C);
+            }
+
+            SECTION("optimized ndarray (type and vector-size as 1D array)")
+            {
+                // create vector with two elements of the same type
+                std::vector<uint8_t> v_0 = {'[', '$', 'i', '#', '[', ']'};
+                std::vector<uint8_t> v_i = {'[', '$', 'i', '#', '[', 'i', 1, 'i', 2, ']', 0x7F, 0x7F};
+                std::vector<uint8_t> v_U = {'[', '$', 'U', '#', '[', 'i', 1, 'i', 2, ']', 0xFF, 0xFF};
+                std::vector<uint8_t> v_I = {'[', '$', 'I', '#', '[', 'i', 1, 'i', 2, ']', 0xFF, 0x7F, 0xFF, 0x7F};
+                std::vector<uint8_t> v_u = {'[', '$', 'u', '#', '[', 'i', 1, 'i', 2, ']', 0x0F, 0xA7, 0x0F, 0xA7};
+                std::vector<uint8_t> v_l = {'[', '$', 'l', '#', '[', 'i', 1, 'i', 2, ']', 0xFF, 0xFF, 0xFF, 0x7F, 0xFF, 0xFF, 0xFF, 0x7F};
+                std::vector<uint8_t> v_m = {'[', '$', 'm', '#', '[', 'i', 1, 'i', 2, ']', 0xFF, 0xC9, 0x9A, 0xBB, 0xFF, 0xC9, 0x9A, 0xBB};
+                std::vector<uint8_t> v_L = {'[', '$', 'L', '#', '[', 'i', 1, 'i', 2, ']', 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x7F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x7F};
+                std::vector<uint8_t> v_M = {'[', '$', 'M', '#', '[', 'i', 1, 'i', 2, ']', 0xFF, 0xFF, 0x63, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D, 0xFF, 0xFF, 0x63, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D};
+                std::vector<uint8_t> v_D = {'[', '$', 'D', '#', '[', 'i', 1, 'i', 2, ']', 0x4a, 0xd8, 0x12, 0x4d, 0xfb, 0x21, 0x09, 0x40, 0x4a, 0xd8, 0x12, 0x4d, 0xfb, 0x21, 0x09, 0x40};
+                std::vector<uint8_t> v_S = {'[', '#', '[', 'i', 1, 'i', 2, ']', 'S', 'i', 1, 'a', 'S', 'i', 1, 'a'};
+                std::vector<uint8_t> v_C = {'[', '$', 'C', '#', '[', 'i', 1, 'i', 2, ']', 'a', 'a'};
+
+                // check if vector is parsed correctly
+                CHECK(json::from_bjdata(v_0) == json::array());
+                CHECK(json::from_bjdata(v_i) == json({127, 127}));
+                CHECK(json::from_bjdata(v_U) == json({255, 255}));
+                CHECK(json::from_bjdata(v_I) == json({32767, 32767}));
+                CHECK(json::from_bjdata(v_u) == json({42767, 42767}));
+                CHECK(json::from_bjdata(v_l) == json({2147483647, 2147483647}));
+                CHECK(json::from_bjdata(v_m) == json({3147483647, 3147483647}));
+                CHECK(json::from_bjdata(v_L) == json({9223372036854775807, 9223372036854775807}));
+                CHECK(json::from_bjdata(v_M) == json({10223372036854775807ull, 10223372036854775807ull}));
+                CHECK(json::from_bjdata(v_D) == json({3.1415926, 3.1415926}));
+                CHECK(json::from_bjdata(v_S) == json({"a", "a"}));
+                CHECK(json::from_bjdata(v_C) == json({"a", "a"}));
+            }
+
+            SECTION("optimized ndarray (type and vector-size as size-optimized array)")
+            {
+                // create vector with two elements of the same type
+                std::vector<uint8_t> v_i = {'[', '$', 'i', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2, 0x7F, 0x7F};
+                std::vector<uint8_t> v_U = {'[', '$', 'U', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2, 0xFF, 0xFF};
+                std::vector<uint8_t> v_I = {'[', '$', 'I', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2, 0xFF, 0x7F, 0xFF, 0x7F};
+                std::vector<uint8_t> v_u = {'[', '$', 'u', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2, 0x0F, 0xA7, 0x0F, 0xA7};
+                std::vector<uint8_t> v_l = {'[', '$', 'l', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2, 0xFF, 0xFF, 0xFF, 0x7F, 0xFF, 0xFF, 0xFF, 0x7F};
+                std::vector<uint8_t> v_m = {'[', '$', 'm', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2, 0xFF, 0xC9, 0x9A, 0xBB, 0xFF, 0xC9, 0x9A, 0xBB};
+                std::vector<uint8_t> v_L = {'[', '$', 'L', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x7F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x7F};
+                std::vector<uint8_t> v_M = {'[', '$', 'M', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2, 0xFF, 0xFF, 0x63, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D, 0xFF, 0xFF, 0x63, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D};
+                std::vector<uint8_t> v_D = {'[', '$', 'D', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2, 0x4a, 0xd8, 0x12, 0x4d, 0xfb, 0x21, 0x09, 0x40, 0x4a, 0xd8, 0x12, 0x4d, 0xfb, 0x21, 0x09, 0x40};
+                std::vector<uint8_t> v_S = {'[', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2, 'S', 'i', 1, 'a', 'S', 'i', 1, 'a'};
+                std::vector<uint8_t> v_C = {'[', '$', 'C', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2, 'a', 'a'};
+
+                // check if vector is parsed correctly
+                CHECK(json::from_bjdata(v_i) == json({127, 127}));
+                CHECK(json::from_bjdata(v_U) == json({255, 255}));
+                CHECK(json::from_bjdata(v_I) == json({32767, 32767}));
+                CHECK(json::from_bjdata(v_u) == json({42767, 42767}));
+                CHECK(json::from_bjdata(v_l) == json({2147483647, 2147483647}));
+                CHECK(json::from_bjdata(v_m) == json({3147483647, 3147483647}));
+                CHECK(json::from_bjdata(v_L) == json({9223372036854775807, 9223372036854775807}));
+                CHECK(json::from_bjdata(v_M) == json({10223372036854775807ull, 10223372036854775807ull}));
+                CHECK(json::from_bjdata(v_D) == json({3.1415926, 3.1415926}));
+                CHECK(json::from_bjdata(v_S) == json({"a", "a"}));
+                CHECK(json::from_bjdata(v_C) == json({"a", "a"}));
+            }
+
+            SECTION("invalid ndarray annotations remains as object")
+            {
+                // check if invalid ND array annotations stay as object
+                json j_type = json({{"_ArrayData_", {1, 2, 3, 4, 5, 6}}, {"_ArraySize_", {2, 3}}, {"_ArrayType_", "invalidtype"}});
+                json j_size = json({{"_ArrayData_", {1, 2, 3, 4, 5}}, {"_ArraySize_", {2, 3}}, {"_ArrayType_", "uint8"}});
+
+                // roundtrip: output should stay as object
+                CHECK(json::from_bjdata(json::to_bjdata(j_type), true, true) == j_type);
+                CHECK(json::from_bjdata(json::to_bjdata(j_size), true, true) == j_size);
+            }
+
+            SECTION("do not accept NTFZ markers in ndarray optimized type")
+            {
+                json _;
+                std::vector<uint8_t> v_N = {'[', '$', 'N', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
+                std::vector<uint8_t> v_T = {'[', '$', 'T', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
+                std::vector<uint8_t> v_F = {'[', '$', 'F', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
+                std::vector<uint8_t> v_Z = {'[', '$', 'Z', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
+
+                CHECK(json::from_bjdata(v_N, true, true).is_discarded());
+                CHECK(json::from_bjdata(v_T, true, true).is_discarded());
+                CHECK(json::from_bjdata(v_F, true, true).is_discarded());
+                CHECK(json::from_bjdata(v_Z, true, true).is_discarded());
+            }
+
+            SECTION("do not accept NTFZ markers in ndarray optimized type")
+            {
+                json _;
+                std::vector<uint8_t> v_N = {'[', '$', 'N', '#', '[', 'i', 1, 'i', 2, ']'};
+                std::vector<uint8_t> v_T = {'[', '$', 'T', '#', '[', 'i', 1, 'i', 2, ']'};
+                std::vector<uint8_t> v_F = {'[', '$', 'F', '#', '[', 'i', 1, 'i', 2, ']'};
+                std::vector<uint8_t> v_Z = {'[', '$', 'Z', '#', '[', 'i', 1, 'i', 2, ']'};
+
+                CHECK(json::from_bjdata(v_N, true, true).is_discarded());
+                CHECK(json::from_bjdata(v_T, true, true).is_discarded());
+                CHECK(json::from_bjdata(v_F, true, true).is_discarded());
+                CHECK(json::from_bjdata(v_Z, true, true).is_discarded());
+            }
+        }
+    }
+
+    SECTION("parse errors")
+    {
+        SECTION("empty byte vector")
+        {
+            json _;
+            CHECK_THROWS_AS(_ = json::from_bjdata(std::vector<uint8_t>()), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(std::vector<uint8_t>()),
+                              "[json.exception.parse_error.110] parse error at byte 1: syntax error while parsing BJData value: unexpected end of input");
+        }
+
+        SECTION("char")
+        {
+            SECTION("eof after C byte")
+            {
+                std::vector<uint8_t> v = {'C'};
+                json _;
+                CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData char: unexpected end of input");
+            }
+
+            SECTION("byte out of range")
+            {
+                std::vector<uint8_t> v = {'C', 130};
+                json _;
+                CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing BJData char: byte after 'C' must be in range 0x00..0x7F; last byte: 0x82");
+            }
+        }
+
+        SECTION("strings")
+        {
+            SECTION("eof after S byte")
+            {
+                std::vector<uint8_t> v = {'S'};
+                json _;
+                CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData value: unexpected end of input");
+            }
+
+            SECTION("invalid byte")
+            {
+                std::vector<uint8_t> v = {'S', '1', 'a'};
+                json _;
+                CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing BJData string: expected length type specification (U, i, u, I, m, l, M, L); last byte: 0x31");
+            }
+
+            SECTION("parse bjdata markers in ubjson")
+            {
+                // create a single-character string for all number types
+                std::vector<uint8_t> s_u = {'S', 'u', 1, 0, 'a'};
+                std::vector<uint8_t> s_m = {'S', 'm', 1, 0, 0, 0, 'a'};
+                std::vector<uint8_t> s_M = {'S', 'M', 1, 0, 0, 0, 0, 0, 0, 0, 'a'};
+
+                json _;
+                // check if string is parsed correctly to "a"
+                CHECK_THROWS_AS(_ = json::from_ubjson(s_u), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_ubjson(s_u), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing UBJSON string: expected length type specification (U, i, I, l, L); last byte: 0x75");
+
+                CHECK_THROWS_AS(_ = json::from_ubjson(s_m), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_ubjson(s_m), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing UBJSON string: expected length type specification (U, i, I, l, L); last byte: 0x6D");
+
+                CHECK_THROWS_AS(_ = json::from_ubjson(s_M), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_ubjson(s_M), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing UBJSON string: expected length type specification (U, i, I, l, L); last byte: 0x4D");
+            }
+        }
+
+        SECTION("array")
+        {
+            SECTION("optimized array: no size following type")
+            {
+                std::vector<uint8_t> v = {'[', '$', 'i', 2};
+                json _;
+                CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.112] parse error at byte 4: syntax error while parsing BJData size: expected '#' after type information; last byte: 0x02");
+            }
+        }
+
+        SECTION("strings")
+        {
+            std::vector<uint8_t> vS = {'S'};
+            json _;
+            CHECK_THROWS_AS(_ = json::from_bjdata(vS), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vS), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData value: unexpected end of input");
+            CHECK(json::from_bjdata(vS, true, false).is_discarded());
+
+            std::vector<uint8_t> v = {'S', 'i', '2', 'a'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing BJData string: unexpected end of input");
+            CHECK(json::from_bjdata(v, true, false).is_discarded());
+
+            std::vector<uint8_t> vC = {'C'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vC), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vC), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData char: unexpected end of input");
+            CHECK(json::from_bjdata(vC, true, false).is_discarded());
+        }
+
+        SECTION("sizes")
+        {
+            std::vector<uint8_t> vU = {'[', '#', 'U'};
+            json _;
+            CHECK_THROWS_AS(_ = json::from_bjdata(vU), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vU), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vU, true, false).is_discarded());
+
+            std::vector<uint8_t> vi = {'[', '#', 'i'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vi), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vi), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vi, true, false).is_discarded());
+
+            std::vector<uint8_t> vI = {'[', '#', 'I'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vI), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vI), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vI, true, false).is_discarded());
+
+            std::vector<uint8_t> vu = {'[', '#', 'u'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vu), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vu), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vu, true, false).is_discarded());
+
+            std::vector<uint8_t> vl = {'[', '#', 'l'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vl), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vl), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vl, true, false).is_discarded());
+
+            std::vector<uint8_t> vm = {'[', '#', 'm'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vm), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vm), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vm, true, false).is_discarded());
+
+            std::vector<uint8_t> vL = {'[', '#', 'L'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vL), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vL), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vL, true, false).is_discarded());
+
+            std::vector<uint8_t> vM = {'[', '#', 'M'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vM), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vM), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vM, true, false).is_discarded());
+
+            std::vector<uint8_t> v0 = {'[', '#', 'T', ']'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(v0), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(v0), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing BJData size: expected length type specification (U, i, u, I, m, l, M, L) after '#'; last byte: 0x54");
+            CHECK(json::from_bjdata(v0, true, false).is_discarded());
+        }
+
+        SECTION("parse bjdata markers as array size in ubjson")
+        {
+            json _;
+            std::vector<uint8_t> vu = {'[', '#', 'u'};
+            CHECK_THROWS_AS(_ = json::from_ubjson(vu), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_ubjson(vu), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing UBJSON size: expected length type specification (U, i, I, l, L) after '#'; last byte: 0x75");
+            CHECK(json::from_ubjson(vu, true, false).is_discarded());
+
+            std::vector<uint8_t> vm = {'[', '#', 'm'};
+            CHECK_THROWS_AS(_ = json::from_ubjson(vm), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_ubjson(vm), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing UBJSON size: expected length type specification (U, i, I, l, L) after '#'; last byte: 0x6D");
+            CHECK(json::from_ubjson(vm, true, false).is_discarded());
+
+            std::vector<uint8_t> vM = {'[', '#', 'M'};
+            CHECK_THROWS_AS(_ = json::from_ubjson(vM), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_ubjson(vM), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing UBJSON size: expected length type specification (U, i, I, l, L) after '#'; last byte: 0x4D");
+            CHECK(json::from_ubjson(vM, true, false).is_discarded());
+
+            std::vector<uint8_t> v0 = {'[', '#', '['};
+            CHECK_THROWS_AS(_ = json::from_ubjson(v0), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_ubjson(v0), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing UBJSON size: expected length type specification (U, i, I, l, L) after '#'; last byte: 0x5B");
+            CHECK(json::from_ubjson(v0, true, false).is_discarded());
+        }
+
+        SECTION("types")
+        {
+            std::vector<uint8_t> v0 = {'[', '$'};
+            json _;
+            CHECK_THROWS_AS(_ = json::from_bjdata(v0), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(v0), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing BJData type: unexpected end of input");
+            CHECK(json::from_bjdata(v0, true, false).is_discarded());
+
+            std::vector<uint8_t> vi = {'[', '$', '#'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vi), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vi), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData value: unexpected end of input");
+            CHECK(json::from_bjdata(vi, true, false).is_discarded());
+
+            std::vector<uint8_t> vU = {'[', '$', 'U'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vU), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vU), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData value: unexpected end of input");
+            CHECK(json::from_bjdata(vU, true, false).is_discarded());
+        }
+
+        SECTION("arrays")
+        {
+            std::vector<uint8_t> vST = {'[', '$', 'i', '#', 'i', 2, 1};
+            json _;
+            CHECK_THROWS_AS(_ = json::from_bjdata(vST), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vST), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vST, true, false).is_discarded());
+
+            std::vector<uint8_t> vS = {'[', '#', 'i', 2, 'i', 1};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vS), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vS), "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing BJData value: unexpected end of input");
+            CHECK(json::from_bjdata(vS, true, false).is_discarded());
+
+            std::vector<uint8_t> v = {'[', 'i', 2, 'i', 1};
+            CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 6: syntax error while parsing BJData value: unexpected end of input");
+            CHECK(json::from_bjdata(v, true, false).is_discarded());
+        }
+
+        SECTION("ndarrays")
+        {
+            std::vector<uint8_t> vST = {'[', '$', 'i', '#', '[', '$', 'i', '#'};
+            json _;
+            CHECK_THROWS_AS(_ = json::from_bjdata(vST), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vST), "[json.exception.parse_error.113] parse error at byte 9: syntax error while parsing BJData size: expected length type specification (U, i, u, I, m, l, M, L) after '#'; last byte: 0xFF");
+            CHECK(json::from_bjdata(vST, true, false).is_discarded());
+
+            std::vector<uint8_t> v = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'i', 2, 1, 2};
+            CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 13: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(v, true, false).is_discarded());
+
+            std::vector<uint8_t> vS0 = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'i', 2, 1};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vS0), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vS0), "[json.exception.parse_error.110] parse error at byte 12: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vS0, true, false).is_discarded());
+
+            std::vector<uint8_t> vS = {'[', '$', 'i', '#', '[', '#', 'i', 2, 1, 2, 1};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vS), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vS), "[json.exception.parse_error.113] parse error at byte 9: syntax error while parsing BJData size: expected length type specification (U, i, u, I, m, l, M, L) after '#'; last byte: 0x01");
+            CHECK(json::from_bjdata(vS, true, false).is_discarded());
+
+            std::vector<uint8_t> vT = {'[', '$', 'i', '#', '[', 'i', 2, 'i'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vT), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vT), "[json.exception.parse_error.110] parse error at byte 9: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vT, true, false).is_discarded());
+
+            std::vector<uint8_t> vT0 = {'[', '$', 'i', '#', '[', 'i'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vT0), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vT0), "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vT0, true, false).is_discarded());
+
+            std::vector<uint8_t> vu = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'u', 1, 0};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vu), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vu), "[json.exception.parse_error.110] parse error at byte 12: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vu, true, false).is_discarded());
+
+            std::vector<uint8_t> vm = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'm', 1, 0, 0, 0};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vm), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vm), "[json.exception.parse_error.110] parse error at byte 14: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vm, true, false).is_discarded());
+
+            std::vector<uint8_t> vM = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'M', 1, 0, 0, 0, 0, 0, 0, 0};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vM), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vM), "[json.exception.parse_error.110] parse error at byte 18: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vM, true, false).is_discarded());
+
+            std::vector<uint8_t> vU = {'[', '$', 'U', '#', '[', '$', 'i', '#', 'i', 2, 2, 3, 1, 2, 3, 4, 5};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vU), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vU), "[json.exception.parse_error.110] parse error at byte 18: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vU, true, false).is_discarded());
+
+            std::vector<uint8_t> vT1 = {'[', '$', 'T', '#', '[', '$', 'i', '#', 'i', 2, 2, 3};
+            CHECK(json::from_bjdata(vT1, true, false).is_discarded());
+
+            std::vector<uint8_t> vh = {'[', '$', 'h', '#', '[', '$', 'i', '#', 'i', 2, 2, 3};
+            CHECK(json::from_bjdata(vh, true, false).is_discarded());
+        }
+
+        SECTION("objects")
+        {
+            std::vector<uint8_t> vST = {'{', '$', 'i', '#', 'i', 2, 'i', 1, 'a', 1};
+            json _;
+            CHECK_THROWS_AS(_ = json::from_bjdata(vST), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vST), "[json.exception.parse_error.110] parse error at byte 11: syntax error while parsing BJData value: unexpected end of input");
+            CHECK(json::from_bjdata(vST, true, false).is_discarded());
+
+            std::vector<uint8_t> vT = {'{', '$', 'i', 'i', 1, 'a', 1};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vT), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vT), "[json.exception.parse_error.112] parse error at byte 4: syntax error while parsing BJData size: expected '#' after type information; last byte: 0x69");
+            CHECK(json::from_bjdata(vT, true, false).is_discarded());
+
+            std::vector<uint8_t> vS = {'{', '#', 'i', 2, 'i', 1, 'a', 'i', 1};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vS), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vS), "[json.exception.parse_error.110] parse error at byte 10: syntax error while parsing BJData value: unexpected end of input");
+            CHECK(json::from_bjdata(vS, true, false).is_discarded());
+
+            std::vector<uint8_t> v = {'{', 'i', 1, 'a', 'i', 1};
+            CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing BJData value: unexpected end of input");
+            CHECK(json::from_bjdata(v, true, false).is_discarded());
+
+            std::vector<uint8_t> v2 = {'{', 'i', 1, 'a', 'i', 1, 'i'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(v2), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(v2), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(v2, true, false).is_discarded());
+
+            std::vector<uint8_t> v3 = {'{', 'i', 1, 'a'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(v3), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(v3), "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing BJData value: unexpected end of input");
+            CHECK(json::from_bjdata(v3, true, false).is_discarded());
+
+            std::vector<uint8_t> vST1 = {'{', '$', 'd', '#', 'i', 2, 'i', 1, 'a'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vST1), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vST1), "[json.exception.parse_error.110] parse error at byte 10: syntax error while parsing BJData number: unexpected end of input");
+            CHECK(json::from_bjdata(vST1, true, false).is_discarded());
+
+            std::vector<uint8_t> vST2 = {'{', '#', 'i', 2, 'i', 1, 'a'};
+            CHECK_THROWS_AS(_ = json::from_bjdata(vST2), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(vST2), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing BJData value: unexpected end of input");
+            CHECK(json::from_bjdata(vST2, true, false).is_discarded());
+
+            std::vector<uint8_t> vO = {'{', '#', '[', 'i', 2, 'i', 1, ']', 'i', 1, 'a', 'i', 1, 'i', 1, 'b', 'i', 2};
+            CHECK(json::from_bjdata(vO, true, false).is_discarded());
+        }
+    }
+
+    SECTION("writing optimized values")
+    {
+        SECTION("integer")
+        {
+            SECTION("array of i")
+            {
+                json j = {1, -1};
+                std::vector<uint8_t> expected = {'[', '$', 'i', '#', 'i', 2, 1, 0xff};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+            }
+
+            SECTION("array of U")
+            {
+                json j = {200, 201};
+                std::vector<uint8_t> expected = {'[', '$', 'U', '#', 'i', 2, 0xC8, 0xC9};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+            }
+
+            SECTION("array of I")
+            {
+                json j = {30000, -30000};
+                std::vector<uint8_t> expected = {'[', '$', 'I', '#', 'i', 2, 0x30, 0x75, 0xd0, 0x8a};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+            }
+
+            SECTION("array of u")
+            {
+                json j = {50000, 50001};
+                std::vector<uint8_t> expected = {'[', '$', 'u', '#', 'i', 2, 0x50, 0xC3, 0x51, 0xC3};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+            }
+
+            SECTION("array of l")
+            {
+                json j = {70000, -70000};
+                std::vector<uint8_t> expected = {'[', '$', 'l', '#', 'i', 2, 0x70, 0x11, 0x01, 0x00, 0x90, 0xEE, 0xFE, 0xFF};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+            }
+
+            SECTION("array of m")
+            {
+                json j = {3147483647, 3147483648};
+                std::vector<uint8_t> expected = {'[', '$', 'm', '#', 'i', 2, 0xFF, 0xC9, 0x9A, 0xBB, 0x00, 0xCA, 0x9A, 0xBB};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+            }
+
+            SECTION("array of L")
+            {
+                json j = {5000000000, -5000000000};
+                std::vector<uint8_t> expected = {'[', '$', 'L', '#', 'i', 2, 0x00, 0xF2, 0x05, 0x2A, 0x01, 0x00, 0x00, 0x00, 0x00, 0x0E, 0xFA, 0xD5, 0xFE, 0xFF, 0xFF, 0xFF};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+            }
+        }
+
+        SECTION("unsigned integer")
+        {
+            SECTION("array of i")
+            {
+                json j = {1u, 2u};
+                std::vector<uint8_t> expected = {'[', '$', 'i', '#', 'i', 2, 1, 2};
+                std::vector<uint8_t> expected_size = {'[', '#', 'i', 2, 'i', 1, 'i', 2};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+                CHECK(json::to_bjdata(j, true) == expected_size);
+            }
+
+            SECTION("array of U")
+            {
+                json j = {200u, 201u};
+                std::vector<uint8_t> expected = {'[', '$', 'U', '#', 'i', 2, 0xC8, 0xC9};
+                std::vector<uint8_t> expected_size = {'[', '#', 'i', 2, 'U', 0xC8, 'U', 0xC9};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+                CHECK(json::to_bjdata(j, true) == expected_size);
+            }
+
+            SECTION("array of I")
+            {
+                json j = {30000u, 30001u};
+                std::vector<uint8_t> expected = {'[', '$', 'I', '#', 'i', 2, 0x30, 0x75, 0x31, 0x75};
+                std::vector<uint8_t> expected_size = {'[', '#', 'i', 2, 'I', 0x30, 0x75, 'I', 0x31, 0x75};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+                CHECK(json::to_bjdata(j, true) == expected_size);
+            }
+
+            SECTION("array of u")
+            {
+                json j = {50000u, 50001u};
+                std::vector<uint8_t> expected = {'[', '$', 'u', '#', 'i', 2, 0x50, 0xC3, 0x51, 0xC3};
+                std::vector<uint8_t> expected_size = {'[', '#', 'i', 2, 'u', 0x50, 0xC3, 'u', 0x51, 0xC3};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+                CHECK(json::to_bjdata(j, true) == expected_size);
+            }
+
+            SECTION("array of l")
+            {
+                json j = {70000u, 70001u};
+                std::vector<uint8_t> expected = {'[', '$', 'l', '#', 'i', 2, 0x70, 0x11, 0x01, 0x00, 0x71, 0x11, 0x01, 0x00};
+                std::vector<uint8_t> expected_size = {'[', '#', 'i', 2, 'l', 0x70, 0x11, 0x01, 0x00, 'l', 0x71, 0x11, 0x01, 0x00};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+                CHECK(json::to_bjdata(j, true) == expected_size);
+            }
+
+            SECTION("array of m")
+            {
+                json j = {3147483647u, 3147483648u};
+                std::vector<uint8_t> expected = {'[', '$', 'm', '#', 'i', 2, 0xFF, 0xC9, 0x9A, 0xBB, 0x00, 0xCA, 0x9A, 0xBB};
+                std::vector<uint8_t> expected_size = {'[', '#', 'i', 2, 'm', 0xFF, 0xC9, 0x9A, 0xBB, 'm', 0x00, 0xCA, 0x9A, 0xBB};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+                CHECK(json::to_bjdata(j, true) == expected_size);
+            }
+
+            SECTION("array of L")
+            {
+                json j = {5000000000u, 5000000001u};
+                std::vector<uint8_t> expected = {'[', '$', 'L', '#', 'i', 2, 0x00, 0xF2, 0x05, 0x2A, 0x01, 0x00, 0x00, 0x00, 0x01, 0xF2, 0x05, 0x2A, 0x01, 0x00, 0x00, 0x00};
+                std::vector<uint8_t> expected_size = {'[', '#', 'i', 2, 'L', 0x00, 0xF2, 0x05, 0x2A, 0x01, 0x00, 0x00, 0x00, 'L', 0x01, 0xF2, 0x05, 0x2A, 0x01, 0x00, 0x00, 0x00};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+                CHECK(json::to_bjdata(j, true) == expected_size);
+            }
+
+            SECTION("array of M")
+            {
+                json j = {10223372036854775807ull, 10223372036854775808ull};
+                std::vector<uint8_t> expected = {'[', '$', 'M', '#', 'i', 2, 0xFF, 0xFF, 0x63, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D, 0x00, 0x00, 0x64, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D};
+                std::vector<uint8_t> expected_size = {'[', '#', 'i', 2, 'M', 0xFF, 0xFF, 0x63, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D, 'M', 0x00, 0x00, 0x64, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D};
+                CHECK(json::to_bjdata(j, true, true) == expected);
+                CHECK(json::to_bjdata(j, true) == expected_size);
+            }
+        }
+    }
+}
+
+TEST_CASE("Universal Binary JSON Specification Examples 1")
+{
+    SECTION("Null Value")
+    {
+        json j = {{"passcode", nullptr}};
+        std::vector<uint8_t> v = {'{', 'i', 8, 'p', 'a', 's', 's', 'c', 'o', 'd', 'e', 'Z', '}'};
+        CHECK(json::to_bjdata(j) == v);
+        CHECK(json::from_bjdata(v) == j);
+    }
+
+    SECTION("No-Op Value")
+    {
+        json j = {"foo", "bar", "baz"};
+        std::vector<uint8_t> v = {'[', 'S', 'i', 3, 'f', 'o', 'o',
+                                  'S', 'i', 3, 'b', 'a', 'r',
+                                  'S', 'i', 3, 'b', 'a', 'z', ']'
+                                 };
+        std::vector<uint8_t> v2 = {'[', 'S', 'i', 3, 'f', 'o', 'o', 'N',
+                                   'S', 'i', 3, 'b', 'a', 'r', 'N', 'N', 'N',
+                                   'S', 'i', 3, 'b', 'a', 'z', 'N', 'N', ']'
+                                  };
+        CHECK(json::to_bjdata(j) == v);
+        CHECK(json::from_bjdata(v) == j);
+        CHECK(json::from_bjdata(v2) == j);
+    }
+
+    SECTION("Boolean Types")
+    {
+        json j = {{"authorized", true}, {"verified", false}};
+        std::vector<uint8_t> v = {'{', 'i', 10, 'a', 'u', 't', 'h', 'o', 'r', 'i', 'z', 'e', 'd', 'T',
+                                  'i', 8, 'v', 'e', 'r', 'i', 'f', 'i', 'e', 'd', 'F', '}'
+                                 };
+        CHECK(json::to_bjdata(j) == v);
+        CHECK(json::from_bjdata(v) == j);
+    }
+
+    SECTION("Numeric Types")
+    {
+        json j =
+        {
+            {"int8", 16},
+            {"uint8", 255},
+            {"int16", 32767},
+            {"uint16", 42767},
+            {"int32", 2147483647},
+            {"uint32", 3147483647},
+            {"int64", 9223372036854775807},
+            {"uint64", 10223372036854775807ull},
+            {"float64", 113243.7863123}
+        };
+        std::vector<uint8_t> v = {'{',
+                                  'i', 7, 'f', 'l', 'o', 'a', 't', '6', '4', 'D', 0xcf, 0x34, 0xbc, 0x94, 0xbc, 0xa5, 0xfb, 0x40,
+                                  'i', 5, 'i', 'n', 't', '1', '6', 'I', 0xff, 0x7f,
+                                  'i', 5, 'i', 'n', 't', '3', '2', 'l', 0xff, 0xff, 0xff, 0x7f,
+                                  'i', 5, 'i', 'n', 't', '6', '4', 'L', 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0x7f,
+                                  'i', 4, 'i', 'n', 't', '8', 'i', 16,
+                                  'i', 6, 'u', 'i', 'n', 't', '1', '6', 'u', 0x0F, 0xA7,
+                                  'i', 6, 'u', 'i', 'n', 't', '3', '2', 'm', 0xFF, 0xC9, 0x9A, 0xBB,
+                                  'i', 6, 'u', 'i', 'n', 't', '6', '4', 'M', 0xFF, 0xFF, 0x63, 0xA7, 0xB3, 0xB6, 0xE0, 0x8D,
+                                  'i', 5, 'u', 'i', 'n', 't', '8', 'U', 0xff,
+                                  '}'
+                                 };
+        CHECK(json::to_bjdata(j) == v);
+        CHECK(json::from_bjdata(v) == j);
+    }
+
+    SECTION("Char Type")
+    {
+        json j = {{"rolecode", "a"}, {"delim", ";"}};
+        std::vector<uint8_t> v = {'{', 'i', 5, 'd', 'e', 'l', 'i', 'm', 'C', ';', 'i', 8, 'r', 'o', 'l', 'e', 'c', 'o', 'd', 'e', 'C', 'a', '}'};
+        //CHECK(json::to_bjdata(j) == v);
+        CHECK(json::from_bjdata(v) == j);
+    }
+
+    SECTION("String Type")
+    {
+        SECTION("English")
+        {
+            json j = "hello";
+            std::vector<uint8_t> v = {'S', 'i', 5, 'h', 'e', 'l', 'l', 'o'};
+            CHECK(json::to_bjdata(j) == v);
+            CHECK(json::from_bjdata(v) == j);
+        }
+
+        SECTION("Russian")
+        {
+            json j = "привет";
+            std::vector<uint8_t> v = {'S', 'i', 12, 0xD0, 0xBF, 0xD1, 0x80, 0xD0, 0xB8, 0xD0, 0xB2, 0xD0, 0xB5, 0xD1, 0x82};
+            CHECK(json::to_bjdata(j) == v);
+            CHECK(json::from_bjdata(v) == j);
+        }
+
+        SECTION("Russian")
+        {
+            json j = "مرحبا";
+            std::vector<uint8_t> v = {'S', 'i', 10, 0xD9, 0x85, 0xD8, 0xB1, 0xD8, 0xAD, 0xD8, 0xA8, 0xD8, 0xA7};
+            CHECK(json::to_bjdata(j) == v);
+            CHECK(json::from_bjdata(v) == j);
+        }
+    }
+
+    SECTION("Array Type")
+    {
+        SECTION("size=false type=false")
+        {
+            // note the float has been replaced by a double
+            json j = {nullptr, true, false, 4782345193, 153.132, "ham"};
+            std::vector<uint8_t> v = {'[', 'Z', 'T', 'F', 'L', 0xE9, 0xCB, 0x0C, 0x1D, 0x01, 0x00, 0x00, 0x00, 'D', 0x4e, 0x62, 0x10, 0x58, 0x39, 0x24, 0x63, 0x40, 'S', 'i', 3, 'h', 'a', 'm', ']'};
+            CHECK(json::to_bjdata(j) == v);
+            CHECK(json::from_bjdata(v) == j);
+        }
+
+        SECTION("size=true type=false")
+        {
+            // note the float has been replaced by a double
+            json j = {nullptr, true, false, 4782345193, 153.132, "ham"};
+            std::vector<uint8_t> v = {'[', '#', 'i', 6, 'Z', 'T', 'F', 'L', 0xE9, 0xCB, 0x0C, 0x1D, 0x01, 0x00, 0x00, 0x00, 'D', 0x4e, 0x62, 0x10, 0x58, 0x39, 0x24, 0x63, 0x40, 'S', 'i', 3, 'h', 'a', 'm'};
+            CHECK(json::to_bjdata(j, true) == v);
+            CHECK(json::from_bjdata(v) == j);
+        }
+
+        SECTION("size=true type=true")
+        {
+            // note the float has been replaced by a double
+            json j = {nullptr, true, false, 4782345193, 153.132, "ham"};
+            std::vector<uint8_t> v = {'[', '#', 'i', 6, 'Z', 'T', 'F', 'L', 0xE9, 0xCB, 0x0C, 0x1D, 0x01, 0x00, 0x00, 0x00, 'D', 0x4e, 0x62, 0x10, 0x58, 0x39, 0x24, 0x63, 0x40, 'S', 'i', 3, 'h', 'a', 'm'};
+            CHECK(json::to_bjdata(j, true, true) == v);
+            CHECK(json::from_bjdata(v) == j);
+        }
+    }
+
+    SECTION("Object Type")
+    {
+        SECTION("size=false type=false")
+        {
+            json j =
+            {
+                {
+                    "post", {
+                        {"id", 1137},
+                        {"author", "rkalla"},
+                        {"timestamp", 1364482090592},
+                        {"body", "I totally agree!"}
+                    }
+                }
+            };
+            std::vector<uint8_t> v = {'{', 'i', 4, 'p', 'o', 's', 't', '{',
+                                      'i', 6, 'a', 'u', 't', 'h', 'o', 'r', 'S', 'i', 6, 'r', 'k', 'a', 'l', 'l', 'a',
+                                      'i', 4, 'b', 'o', 'd', 'y', 'S', 'i', 16, 'I', ' ', 't', 'o', 't', 'a', 'l', 'l', 'y', ' ', 'a', 'g', 'r', 'e', 'e', '!',
+                                      'i', 2, 'i', 'd', 'I', 0x71, 0x04,
+                                      'i', 9, 't', 'i', 'm', 'e', 's', 't', 'a', 'm', 'p', 'L', 0x60, 0x66, 0x78, 0xB1, 0x3D, 0x01, 0x00, 0x00,
+                                      '}', '}'
+                                     };
+            CHECK(json::to_bjdata(j) == v);
+            CHECK(json::from_bjdata(v) == j);
+        }
+
+        SECTION("size=true type=false")
+        {
+            json j =
+            {
+                {
+                    "post", {
+                        {"id", 1137},
+                        {"author", "rkalla"},
+                        {"timestamp", 1364482090592},
+                        {"body", "I totally agree!"}
+                    }
+                }
+            };
+            std::vector<uint8_t> v = {'{', '#', 'i', 1, 'i', 4, 'p', 'o', 's', 't', '{', '#', 'i', 4,
+                                      'i', 6, 'a', 'u', 't', 'h', 'o', 'r', 'S', 'i', 6, 'r', 'k', 'a', 'l', 'l', 'a',
+                                      'i', 4, 'b', 'o', 'd', 'y', 'S', 'i', 16, 'I', ' ', 't', 'o', 't', 'a', 'l', 'l', 'y', ' ', 'a', 'g', 'r', 'e', 'e', '!',
+                                      'i', 2, 'i', 'd', 'I', 0x71, 0x04,
+                                      'i', 9, 't', 'i', 'm', 'e', 's', 't', 'a', 'm', 'p', 'L', 0x60, 0x66, 0x78, 0xB1, 0x3D, 0x01, 0x00, 0x00,
+                                     };
+            CHECK(json::to_bjdata(j, true) == v);
+            CHECK(json::from_bjdata(v) == j);
+        }
+
+        SECTION("size=true type=true")
+        {
+            json j =
+            {
+                {
+                    "post", {
+                        {"id", 1137},
+                        {"author", "rkalla"},
+                        {"timestamp", 1364482090592},
+                        {"body", "I totally agree!"}
+                    }
+                }
+            };
+            std::vector<uint8_t> v = {'{', '#', 'i', 1, 'i', 4, 'p', 'o', 's', 't', '{', '#', 'i', 4,
+                                      'i', 6, 'a', 'u', 't', 'h', 'o', 'r', 'S', 'i', 6, 'r', 'k', 'a', 'l', 'l', 'a',
+                                      'i', 4, 'b', 'o', 'd', 'y', 'S', 'i', 16, 'I', ' ', 't', 'o', 't', 'a', 'l', 'l', 'y', ' ', 'a', 'g', 'r', 'e', 'e', '!',
+                                      'i', 2, 'i', 'd', 'I', 0x71, 0x04,
+                                      'i', 9, 't', 'i', 'm', 'e', 's', 't', 'a', 'm', 'p', 'L', 0x60, 0x66, 0x78, 0xB1, 0x3D, 0x01, 0x00, 0x00,
+                                     };
+            CHECK(json::to_bjdata(j, true, true) == v);
+            CHECK(json::from_bjdata(v) == j);
+        }
+    }
+
+    SECTION("Optimized Format")
+    {
+        SECTION("Array Example")
+        {
+            SECTION("No Optimization")
+            {
+                // note the floats have been replaced by doubles
+                json j = {29.97, 31.13, 67.0, 2.113, 23.888};
+                std::vector<uint8_t> v = {'[',
+                                          'D', 0xb8, 0x1e, 0x85, 0xeb, 0x51, 0xf8, 0x3d, 0x40,
+                                          'D', 0xe1, 0x7a, 0x14, 0xae, 0x47, 0x21, 0x3f, 0x40,
+                                          'D', 0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0x50, 0x40,
+                                          'D', 0x81, 0x95, 0x43, 0x8b, 0x6c, 0xe7, 0x00, 0x40,
+                                          'D', 0x17, 0xd9, 0xce, 0xf7, 0x53, 0xe3, 0x37, 0x40,
+                                          ']'
+                                         };
+                CHECK(json::to_bjdata(j) == v);
+                CHECK(json::from_bjdata(v) == j);
+            }
+
+            SECTION("Optimized with count")
+            {
+                // note the floats have been replaced by doubles
+                json j = {29.97, 31.13, 67.0, 2.113, 23.888};
+                std::vector<uint8_t> v = {'[', '#', 'i', 5,
+                                          'D', 0xb8, 0x1e, 0x85, 0xeb, 0x51, 0xf8, 0x3d, 0x40,
+                                          'D', 0xe1, 0x7a, 0x14, 0xae, 0x47, 0x21, 0x3f, 0x40,
+                                          'D', 0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0x50, 0x40,
+                                          'D', 0x81, 0x95, 0x43, 0x8b, 0x6c, 0xe7, 0x00, 0x40,
+                                          'D', 0x17, 0xd9, 0xce, 0xf7, 0x53, 0xe3, 0x37, 0x40,
+                                         };
+                CHECK(json::to_bjdata(j, true) == v);
+                CHECK(json::from_bjdata(v) == j);
+            }
+
+            SECTION("Optimized with type & count")
+            {
+                // note the floats have been replaced by doubles
+                json j = {29.97, 31.13, 67.0, 2.113, 23.888};
+                std::vector<uint8_t> v = {'[', '$', 'D', '#', 'i', 5,
+                                          0xb8, 0x1e, 0x85, 0xeb, 0x51, 0xf8, 0x3d, 0x40,
+                                          0xe1, 0x7a, 0x14, 0xae, 0x47, 0x21, 0x3f, 0x40,
+                                          0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0x50, 0x40,
+                                          0x81, 0x95, 0x43, 0x8b, 0x6c, 0xe7, 0x00, 0x40,
+                                          0x17, 0xd9, 0xce, 0xf7, 0x53, 0xe3, 0x37, 0x40,
+                                         };
+                CHECK(json::to_bjdata(j, true, true) == v);
+                CHECK(json::from_bjdata(v) == j);
+            }
+        }
+
+        SECTION("Object Example")
+        {
+            SECTION("No Optimization")
+            {
+                // note the floats have been replaced by doubles
+                json j = { {"lat", 29.976}, {"long", 31.131}, {"alt", 67.0} };
+                std::vector<uint8_t> v = {'{',
+                                          'i', 3, 'a', 'l', 't', 'D',      0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0x50, 0x40,
+                                          'i', 3, 'l', 'a', 't', 'D',      0x60, 0xe5, 0xd0, 0x22, 0xdb, 0xf9, 0x3d, 0x40,
+                                          'i', 4, 'l', 'o', 'n', 'g', 'D', 0xa8, 0xc6, 0x4b, 0x37, 0x89, 0x21, 0x3f, 0x40,
+                                          '}'
+                                         };
+                CHECK(json::to_bjdata(j) == v);
+                CHECK(json::from_bjdata(v) == j);
+            }
+
+            SECTION("Optimized with count")
+            {
+                // note the floats have been replaced by doubles
+                json j = { {"lat", 29.976}, {"long", 31.131}, {"alt", 67.0} };
+                std::vector<uint8_t> v = {'{', '#', 'i', 3,
+                                          'i', 3, 'a', 'l', 't', 'D',      0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0x50, 0x40,
+                                          'i', 3, 'l', 'a', 't', 'D',      0x60, 0xe5, 0xd0, 0x22, 0xdb, 0xf9, 0x3d, 0x40,
+                                          'i', 4, 'l', 'o', 'n', 'g', 'D', 0xa8, 0xc6, 0x4b, 0x37, 0x89, 0x21, 0x3f, 0x40,
+                                         };
+                CHECK(json::to_bjdata(j, true) == v);
+                CHECK(json::from_bjdata(v) == j);
+            }
+
+            SECTION("Optimized with type & count")
+            {
+                // note the floats have been replaced by doubles
+                json j = { {"lat", 29.976}, {"long", 31.131}, {"alt", 67.0} };
+                std::vector<uint8_t> v = {'{', '$', 'D', '#', 'i', 3,
+                                          'i', 3, 'a', 'l', 't',      0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0x50, 0x40,
+                                          'i', 3, 'l', 'a', 't',      0x60, 0xe5, 0xd0, 0x22, 0xdb, 0xf9, 0x3d, 0x40,
+                                          'i', 4, 'l', 'o', 'n', 'g', 0xa8, 0xc6, 0x4b, 0x37, 0x89, 0x21, 0x3f, 0x40,
+                                         };
+                CHECK(json::to_bjdata(j, true, true) == v);
+                CHECK(json::from_bjdata(v) == j);
+            }
+        }
+
+        SECTION("Special Cases (Null, No-Op and Boolean)")
+        {
+            SECTION("Array")
+            {
+                std::vector<uint8_t> v = {'[', '$', 'N', '#', 'I', 0x00, 0x02};
+                CHECK(json::from_bjdata(v, true, true).is_discarded());
+            }
+
+            SECTION("Object")
+            {
+                std::vector<uint8_t> v = {'{', '$', 'Z', '#', 'i', 3, 'i', 4, 'n', 'a', 'm', 'e', 'i', 8, 'p', 'a', 's', 's', 'w', 'o', 'r', 'd', 'i', 5, 'e', 'm', 'a', 'i', 'l'};
+                CHECK(json::from_bjdata(v, true, true).is_discarded());
+            }
+        }
+    }
+}
+
+#if !defined(JSON_NOEXCEPTION)
+TEST_CASE("all BJData first bytes")
+{
+    // these bytes will fail immediately with exception parse_error.112
+    std::set<uint8_t> supported =
+    {
+        'T', 'F', 'Z', 'U', 'i', 'I', 'l', 'L', 'd', 'D', 'C', 'S', '[', '{', 'N', 'H', 'u', 'm', 'M', 'h'
+    };
+
+    for (auto i = 0; i < 256; ++i)
+    {
+        const auto byte = static_cast<uint8_t>(i);
+        CAPTURE(byte)
+
+        try
+        {
+            auto res = json::from_bjdata(std::vector<uint8_t>(1, byte));
+        }
+        catch (const json::parse_error& e)
+        {
+            // check that parse_error.112 is only thrown if the
+            // first byte is not in the supported set
+            INFO_WITH_TEMP(e.what());
+            if (supported.find(byte) == supported.end())
+            {
+                CHECK(e.id == 112);
+            }
+            else
+            {
+                CHECK(e.id != 112);
+            }
+        }
+    }
+}
+#endif
+
+TEST_CASE("BJData roundtrips" * doctest::skip())
+{
+    SECTION("input from self-generated BJData files")
+    {
+        for (std::string filename :
+                {
+                    TEST_DATA_DIRECTORY "/json_nlohmann_tests/all_unicode.json",
+                    TEST_DATA_DIRECTORY "/json.org/1.json",
+                    TEST_DATA_DIRECTORY "/json.org/2.json",
+                    TEST_DATA_DIRECTORY "/json.org/3.json",
+                    TEST_DATA_DIRECTORY "/json.org/4.json",
+                    TEST_DATA_DIRECTORY "/json.org/5.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip01.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip02.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip03.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip04.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip05.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip06.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip07.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip08.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip09.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip10.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip11.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip12.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip13.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip14.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip15.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip16.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip17.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip18.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip19.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip20.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip21.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip22.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip23.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip24.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip25.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip26.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip27.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip28.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip29.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip30.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip31.json",
+                    TEST_DATA_DIRECTORY "/json_roundtrip/roundtrip32.json",
+                    TEST_DATA_DIRECTORY "/json_testsuite/sample.json",
+                    TEST_DATA_DIRECTORY "/json_tests/pass1.json",
+                    TEST_DATA_DIRECTORY "/json_tests/pass2.json",
+                    TEST_DATA_DIRECTORY "/json_tests/pass3.json"
+                })
+        {
+            CAPTURE(filename)
+
+            {
+                INFO_WITH_TEMP(filename + ": std::vector<uint8_t>");
+                // parse JSON file
+                std::ifstream f_json(filename);
+                json j1 = json::parse(f_json);
+
+                // parse BJData file
+                auto packed = utils::read_binary_file(filename + ".bjdata");
+                json j2;
+                CHECK_NOTHROW(j2 = json::from_bjdata(packed));
+
+                // compare parsed JSON values
+                CHECK(j1 == j2);
+            }
+
+            {
+                INFO_WITH_TEMP(filename + ": std::ifstream");
+                // parse JSON file
+                std::ifstream f_json(filename);
+                json j1 = json::parse(f_json);
+
+                // parse BJData file
+                std::ifstream f_bjdata(filename + ".bjdata", std::ios::binary);
+                json j2;
+                CHECK_NOTHROW(j2 = json::from_bjdata(f_bjdata));
+
+                // compare parsed JSON values
+                CHECK(j1 == j2);
+            }
+
+            {
+                INFO_WITH_TEMP(filename + ": uint8_t* and size");
+                // parse JSON file
+                std::ifstream f_json(filename);
+                json j1 = json::parse(f_json);
+
+                // parse BJData file
+                auto packed = utils::read_binary_file(filename + ".bjdata");
+                json j2;
+                CHECK_NOTHROW(j2 = json::from_bjdata({packed.data(), packed.size()}));
+
+                // compare parsed JSON values
+                CHECK(j1 == j2);
+            }
+
+            {
+                INFO_WITH_TEMP(filename + ": output to output adapters");
+                // parse JSON file
+                std::ifstream f_json(filename);
+                json j1 = json::parse(f_json);
+
+                // parse BJData file
+                auto packed = utils::read_binary_file(filename + ".bjdata");
+
+                {
+                    INFO_WITH_TEMP(filename + ": output adapters: std::vector<uint8_t>");
+                    std::vector<uint8_t> vec;
+                    json::to_bjdata(j1, vec);
+                    CHECK(vec == packed);
+                }
+            }
+        }
+    }
+}

From 5352856f04730204123285ed928fc720ee8348b3 Mon Sep 17 00:00:00 2001
From: Florian Albrechtskirchinger <falbrechtskirchinger@gmail.com>
Date: Fri, 29 Apr 2022 21:40:02 +0200
Subject: [PATCH 05/30] Implement support for string_view (attempt no. 3)
 (#3423)

* Add key_compare member to ordered_map

* Replace == with key_compare in ordered_map

* Expose the actual comparison function used by object_t

nlohmann::ordered_map uses a different comparison function than the one
provided via template parameter.
* Introduce a type trait to detect if object_t has a key_compare member.
* Rename object_comparator_t to default_object_comparator_t.
* Add object_comparator_t to be conditionally defined as
  object_t::key_compare, if available, or default_object_comparator_t
  otherwise.
* Update the documentation accordingly.

Co-authored-by: Niels Lohmann <niels.lohmann@gmail.com>

* Add type traits to check if a type is usable as object key

Add type trait to check:
* if a type is a specialization of a template.
* if a type is a json_pointer.
* if a type is a basic_json::{const_,}iterator.
* if two types are comparable using a given comparison functor.
* if a type is comparable to basic_json::object_t::key_type.
* if a type has a member type is_transparent.
* if a type is usable as object key.
* if a type has an erase() function accepting a given KeyType.

Co-authored-by: Niels Lohmann <niels.lohmann@gmail.com>

* Rework basic_json element access to accept more key types

Rework basic_json element access member functions and operators to
accept any type that meets the requirements defined by type trait
detail::is_usable_as_key_type.

Member functions and operators:
* at()
* operator[]
* value()
* erase()
* find()
* count()
* contains()

Update documentation to reflect these changes.

Add unit tests to excercise the new functions using std::string_view.

Co-authored-by: Niels Lohmann <niels.lohmann@gmail.com>

Co-authored-by: Niels Lohmann <niels.lohmann@gmail.com>
---
 doc/mkdocs/docs/api/basic_json/at.md          |  41 +-
 doc/mkdocs/docs/api/basic_json/basic_json.md  |  10 +-
 doc/mkdocs/docs/api/basic_json/contains.md    |  32 +-
 doc/mkdocs/docs/api/basic_json/count.md       |  23 +-
 .../basic_json/default_object_comparator_t.md |  19 +
 doc/mkdocs/docs/api/basic_json/erase.md       |  39 +-
 doc/mkdocs/docs/api/basic_json/find.md        |  31 +-
 doc/mkdocs/docs/api/basic_json/index.md       |   1 +
 doc/mkdocs/docs/api/basic_json/insert.md      |   2 +-
 .../api/basic_json/object_comparator_t.md     |  16 +-
 doc/mkdocs/docs/api/basic_json/object_t.md    |   4 +-
 doc/mkdocs/docs/api/basic_json/operator[].md  |  52 +-
 doc/mkdocs/docs/api/basic_json/to_bson.md     |   2 +-
 doc/mkdocs/docs/api/basic_json/to_cbor.md     |   2 +-
 doc/mkdocs/docs/api/basic_json/to_msgpack.md  |   2 +-
 doc/mkdocs/docs/api/basic_json/to_ubjson.md   |   2 +-
 doc/mkdocs/docs/api/basic_json/value.md       |  32 +-
 doc/mkdocs/docs/api/ordered_map.md            |   7 +
 doc/mkdocs/mkdocs.yml                         |   1 +
 include/nlohmann/detail/macro_scope.hpp       |   6 +
 include/nlohmann/detail/macro_unscope.hpp     |   1 +
 include/nlohmann/detail/meta/type_traits.hpp  |  95 +++-
 include/nlohmann/json.hpp                     | 370 +++++++++----
 include/nlohmann/ordered_map.hpp              |  26 +-
 single_include/nlohmann/json.hpp              | 498 +++++++++++++----
 test/src/unit-element_access2.cpp             | 508 ++++++++++++++++++
 26 files changed, 1517 insertions(+), 305 deletions(-)
 create mode 100644 doc/mkdocs/docs/api/basic_json/default_object_comparator_t.md

diff --git a/doc/mkdocs/docs/api/basic_json/at.md b/doc/mkdocs/docs/api/basic_json/at.md
index fc518f46e..dbd4cb6c9 100644
--- a/doc/mkdocs/docs/api/basic_json/at.md
+++ b/doc/mkdocs/docs/api/basic_json/at.md
@@ -10,13 +10,28 @@ reference at(const typename object_t::key_type& key);
 const_reference at(const typename object_t::key_type& key) const;
 
 // (3)
+template<typename KeyType>
+reference at(KeyType&& key);
+template<typename KeyType>
+const_reference at(KeyType&& key) const;
+
+// (4)
 reference at(const json_pointer& ptr);
 const_reference at(const json_pointer& ptr) const;
 ```
 
 1. Returns a reference to the array element at specified location `idx`, with bounds checking.
-2. Returns a reference to the object element at with specified key `key`, with bounds checking.
-3. Returns a reference to the element at with specified JSON pointer `ptr`, with bounds checking.
+2. Returns a reference to the object element with specified key `key`, with bounds checking.
+3. See 2. This overload is only available if `KeyType` is comparable with `#!cpp typename object_t::key_type` and
+   `#!cpp typename object_comparator_t::is_transparent` denotes a type.
+4. Returns a reference to the element at specified JSON pointer `ptr`, with bounds checking.
+
+## Template parameters
+
+`KeyType`
+:   A type for an object key other than [`json_pointer`](../json_pointer/index.md) that is comparable with
+    [`string_t`](string_t.md) using  [`object_comparator_t`](object_comparator_t.md).
+    This can also be a string view (C++17).
 
 ## Parameters
 
@@ -25,15 +40,16 @@ const_reference at(const json_pointer& ptr) const;
 
 `key` (in)
 :   object key of the elements to access
-    
+
 `ptr` (in)
 :   JSON pointer to the desired element
-    
+
 ## Return value
 
 1. reference to the element at index `idx`
 2. reference to the element at key `key`
-3. reference to the element pointed to by `ptr`
+3. reference to the element at key `key`
+4. reference to the element pointed to by `ptr`
 
 ## Exception safety
 
@@ -51,7 +67,8 @@ Strong exception safety: if an exception occurs, the original value stays intact
       in this case, calling `at` with a key makes no sense. See example below.
     - Throws [`out_of_range.403`](../../home/exceptions.md#jsonexceptionout_of_range403) if the key `key` is not
       stored in the object; that is, `find(key) == end()`. See example below.
-3. The function can throw the following exceptions:
+3. See 2.
+4. The function can throw the following exceptions:
     - Throws [`parse_error.106`](../../home/exceptions.md#jsonexceptionparse_error106) if an array index in the passed
       JSON pointer `ptr` begins with '0'. See example below.
     - Throws [`parse_error.109`](../../home/exceptions.md#jsonexceptionparse_error109) if an array index in the passed
@@ -68,9 +85,10 @@ Strong exception safety: if an exception occurs, the original value stays intact
 
 ## Complexity
 
-1. Constant
+1. Constant.
 2. Logarithmic in the size of the container.
-3. Constant
+3. Logarithmic in the size of the container.
+4. Logarithmic in the size of the container.
 
 ## Examples
 
@@ -134,7 +152,7 @@ Strong exception safety: if an exception occurs, the original value stays intact
     --8<-- "examples/at__object_t_key_type_const.output"
     ```
 
-??? example "Example (3) access specified element via JSON Pointer"
+??? example "Example (4) access specified element via JSON Pointer"
 
     The example below shows how object elements can be read and written using `at()`. It also demonstrates the different
     exceptions that can be thrown.
@@ -149,7 +167,7 @@ Strong exception safety: if an exception occurs, the original value stays intact
     --8<-- "examples/at_json_pointer.output"
     ```
 
-??? example "Example (3) access specified element via JSON Pointer"
+??? example "Example (4) access specified element via JSON Pointer"
 
     The example below shows how object elements can be read using `at()`. It also demonstrates the different exceptions
     that can be thrown.
@@ -173,4 +191,5 @@ Strong exception safety: if an exception occurs, the original value stays intact
 
 1. Added in version 1.0.0.
 2. Added in version 1.0.0.
-3. Added in version 2.0.0.
+3. Added in version 3.11.0.
+4. Added in version 2.0.0.
diff --git a/doc/mkdocs/docs/api/basic_json/basic_json.md b/doc/mkdocs/docs/api/basic_json/basic_json.md
index afa3901d1..9a289d6e9 100644
--- a/doc/mkdocs/docs/api/basic_json/basic_json.md
+++ b/doc/mkdocs/docs/api/basic_json/basic_json.md
@@ -201,16 +201,16 @@ basic_json(basic_json&& other) noexcept;
 
 ## Exceptions
 
-1. /
+1. (none)
 2. The function does not throw exceptions.
-3. /
-4. /
+3. (none)
+4. (none)
 5. The function can throw the following exceptions:
     - Throws [`type_error.301`](../../home/exceptions.md#jsonexceptiontype_error301) if `type_deduction` is
       `#!cpp false`, `manual_type` is `value_t::object`, but `init` contains an element which is not a pair whose first
       element is a string. In this case, the constructor could not create an object. If `type_deduction` would have been
       `#!cpp true`, an array would have been created. See `object(initializer_list_t)` for an example.
-6. /
+6. (none)
 7. The function can throw the following exceptions:
     - Throws [`invalid_iterator.201`](../../home/exceptions.md#jsonexceptioninvalid_iterator201) if iterators `first`
       and `last` are not compatible (i.e., do not belong to the same JSON value). In this case, the range
@@ -220,7 +220,7 @@ basic_json(basic_json&& other) noexcept;
       element anymore. In this case, the range `[first, last)` is undefined. See example code below.
     - Throws [`invalid_iterator.206`](../../home/exceptions.md#jsonexceptioninvalid_iterator206) if iterators `first`
       and `last` belong to a `#!json null` value. In this case, the range `[first, last)` is undefined.
-8. /
+8. (none)
 9. The function does not throw exceptions.
 
 ## Complexity
diff --git a/doc/mkdocs/docs/api/basic_json/contains.md b/doc/mkdocs/docs/api/basic_json/contains.md
index 8463f4ea9..67a5ffcc0 100644
--- a/doc/mkdocs/docs/api/basic_json/contains.md
+++ b/doc/mkdocs/docs/api/basic_json/contains.md
@@ -2,21 +2,28 @@
 
 ```cpp
 // (1)
-template<typename KeyT>
-bool contains(KeyT && key) const;
+bool contains(const typename object_t::key_type& key) const;
 
 // (2)
+template<typename KeyType>
+bool contains(KeyType&& key) const;
+
+// (3)
 bool contains(const json_pointer& ptr) const;
 ```
 
-1. Check whether an element exists in a JSON object with key equivalent to `key`. If the element is not found or the 
+1. Check whether an element exists in a JSON object with a key equivalent to `key`. If the element is not found or the 
    JSON value is not an object, `#!cpp false` is returned.
-2. Check whether the given JSON pointer `ptr` can be resolved in the current JSON value.
+2. See 1. This overload is only available if `KeyType` is comparable with `#!cpp typename object_t::key_type` and
+   `#!cpp typename object_comparator_t::is_transparent` denotes a type.
+3. Check whether the given JSON pointer `ptr` can be resolved in the current JSON value.
 
 ## Template parameters
 
-`KeyT`
-:   A type for an object key other than `basic_json::json_pointer`.
+`KeyType`
+:   A type for an object key other than [`json_pointer`](../json_pointer/index.md) that is comparable with
+    [`string_t`](string_t.md) using  [`object_comparator_t`](object_comparator_t.md).
+    This can also be a string view (C++17).
 
 ## Parameters
 
@@ -30,7 +37,8 @@ bool contains(const json_pointer& ptr) const;
 
 1. `#!cpp true` if an element with specified `key` exists. If no such element with such key is found or the JSON value
    is not an object, `#!cpp false` is returned.
-2. `#!cpp true` if the JSON pointer can be resolved to a stored value, `#!cpp false` otherwise.
+2. See 1.
+3. `#!cpp true` if the JSON pointer can be resolved to a stored value, `#!cpp false` otherwise.
 
 ## Exception safety
 
@@ -39,7 +47,8 @@ Strong exception safety: if an exception occurs, the original value stays intact
 ## Exceptions
 
 1. The function does not throw exceptions.
-2. The function can throw the following exceptions:
+2. The function does not throw exceptions.
+3. The function can throw the following exceptions:
     - Throws [`parse_error.106`](../../home/exceptions.md#jsonexceptionparse_error106) if an array index begins with
       `0`.
     - Throws [`parse_error.109`](../../home/exceptions.md#jsonexceptionparse_error109) if an array index was not a
@@ -74,7 +83,7 @@ Logarithmic in the size of the JSON object.
     --8<-- "examples/contains.output"
     ```
 
-??? example "Example (1) check with JSON pointer"
+??? example "Example (3) check with JSON pointer"
 
     The example shows how `contains()` is used.
     
@@ -90,5 +99,6 @@ Logarithmic in the size of the JSON object.
 
 ## Version history
 
-1. Added in version 3.6.0.
-2. Added in version 3.7.0.
+1. Added in version 3.11.0.
+2. Added in version 3.6.0. Extended template `KeyType` to support comparable types in version 3.11.0.
+3. Added in version 3.7.0.
diff --git a/doc/mkdocs/docs/api/basic_json/count.md b/doc/mkdocs/docs/api/basic_json/count.md
index fcfef8673..de135be21 100644
--- a/doc/mkdocs/docs/api/basic_json/count.md
+++ b/doc/mkdocs/docs/api/basic_json/count.md
@@ -1,17 +1,25 @@
 # <small>nlohmann::basic_json::</small>count
 
 ```cpp
-template<typename KeyT>
-size_type count(KeyT&& key) const;
+// (1)
+size_type count(const typename object_t::key_type& key) const;
+
+// (2)
+template<typename KeyType>
+size_type count(KeyType&& key) const;
 ```
 
-Returns the number of elements with key `key`. If `ObjectType` is the default `std::map` type, the return value will
-always be `0` (`key` was not found) or `1` (`key` was found).
+1. Returns the number of elements with key `key`. If `ObjectType` is the default `std::map` type, the return value will
+   always be `0` (`key` was not found) or `1` (`key` was found).
+2. See 1. This overload is only available if `KeyType` is comparable with `#!cpp typename object_t::key_type` and
+   `#!cpp typename object_comparator_t::is_transparent` denotes a type.
 
 ## Template parameters
 
-`KeyT`
-:   A type for an object key.
+`KeyType`
+:   A type for an object key other than [`json_pointer`](../json_pointer/index.md) that is comparable with
+    [`string_t`](string_t.md) using  [`object_comparator_t`](object_comparator_t.md).
+    This can also be a string view (C++17).
 
 ## Parameters
 
@@ -52,4 +60,5 @@ This method always returns `0` when executed on a JSON type that is not an objec
 
 ## Version history
 
-- Added in version 1.0.0.
+1. Added in version 3.11.0.
+2. Added in version 1.0.0. Changed parameter `key` type to `KeyType&&` in version 3.11.0.
diff --git a/doc/mkdocs/docs/api/basic_json/default_object_comparator_t.md b/doc/mkdocs/docs/api/basic_json/default_object_comparator_t.md
new file mode 100644
index 000000000..9e5f6c5bd
--- /dev/null
+++ b/doc/mkdocs/docs/api/basic_json/default_object_comparator_t.md
@@ -0,0 +1,19 @@
+# <small>nlohmann::basic_json::</small>default_object_comparator_t
+
+```cpp
+using default_object_comparator_t = std::less<StringType>;  // until C++14
+
+using default_object_comparator_t = std::less<>;            // since C++14
+```
+
+The default comparator used by [`object_t`](object_t.md).
+
+Since C++14 a transparent comparator is used which prevents unnecessary string construction
+when looking up a key in an object.
+
+The actual comparator used depends on [`object_t`](object_t.md) and can be obtained via
+[`object_comparator_t`](object_comparator_t.md).
+
+## Version history
+
+- Added in version 3.11.0.
diff --git a/doc/mkdocs/docs/api/basic_json/erase.md b/doc/mkdocs/docs/api/basic_json/erase.md
index d94c25b7f..6cb749b8c 100644
--- a/doc/mkdocs/docs/api/basic_json/erase.md
+++ b/doc/mkdocs/docs/api/basic_json/erase.md
@@ -13,6 +13,10 @@ const_iterator erase(const_iterator first, const_iterator last);
 size_type erase(const typename object_t::key_type& key);
 
 // (4)
+template<typename KeyType>
+size_type erase(KeyType&& key);
+
+// (5)
 void erase(const size_type idx);
 ```
 
@@ -29,7 +33,17 @@ void erase(const size_type idx);
 
 3. Removes an element from a JSON object by key.
 
-4. Removes an element from a JSON array by index.
+4. See 3. This overload is only available if `KeyType` is comparable with `#!cpp typename object_t::key_type` and
+   `#!cpp typename object_comparator_t::is_transparent` denotes a type.
+
+5. Removes an element from a JSON array by index.
+
+## Template parameters
+
+`KeyType`
+:   A type for an object key other than [`json_pointer`](../json_pointer/index.md) that is comparable with
+    [`string_t`](string_t.md) using  [`object_comparator_t`](object_comparator_t.md).
+    This can also be a string view (C++17).
 
 ## Parameters
 
@@ -56,7 +70,8 @@ void erase(const size_type idx);
    is returned.
 3. Number of elements removed. If `ObjectType` is the default `std::map` type, the return value will always be `0`
    (`key` was not found) or `1` (`key` was found).
-4. /
+4. See 3.
+5. (none)
 
 ## Exception safety
 
@@ -83,7 +98,8 @@ Strong exception safety: if an exception occurs, the original value stays intact
 3. The function can throw the following exceptions:
     - Throws [`type_error.307`](../../home/exceptions.md#jsonexceptiontype_error307) when called on a type other than
       JSON object; example: `"cannot use erase() with null"`
-4. The function can throw the following exceptions:
+4. See 3.
+5. The function can throw the following exceptions:
     - Throws [`type_error.307`](../../home/exceptions.md#jsonexceptiontype_error307) when called on a type other than
       JSON object; example: `"cannot use erase() with null"`
     - Throws [`out_of_range.401`](../../home/exceptions.md#jsonexceptionout_of_range401) when `idx >= size()`; example:
@@ -103,14 +119,16 @@ Strong exception safety: if an exception occurs, the original value stays intact
        - strings and binary: linear in the length of the member
        - other types: constant
 3. `log(size()) + count(key)`
-4. Linear in distance between `idx` and the end of the container.
+4. `log(size()) + count(key)`
+5. Linear in distance between `idx` and the end of the container.
 
 ## Notes
 
 1. Invalidates iterators and references at or after the point of the `erase`, including the `end()` iterator.
-2. /
+2. (none)
 3. References and iterators to the erased elements are invalidated. Other references and iterators are not affected.
-4. /
+4. See 3.
+5. (none)
 
 ## Examples
 
@@ -156,7 +174,7 @@ Strong exception safety: if an exception occurs, the original value stays intact
     --8<-- "examples/erase__key_type.output"
     ```
 
-??? example "Example: (4) remove element from a JSON array given an index"
+??? example "Example: (5) remove element from a JSON array given an index"
 
     The example shows the effect of `erase()` using an array index.
     
@@ -172,5 +190,8 @@ Strong exception safety: if an exception occurs, the original value stays intact
 
 ## Version history
 
-- Added in version 1.0.0.
-- Added support for binary types in version 3.8.0.
+1. Added in version 1.0.0. Added support for binary types in version 3.8.0.
+2. Added in version 1.0.0. Added support for binary types in version 3.8.0.
+3. Added in version 1.0.0.
+4. Added in version 3.11.0.
+5. Added in version 1.0.0.
diff --git a/doc/mkdocs/docs/api/basic_json/find.md b/doc/mkdocs/docs/api/basic_json/find.md
index af4cb2972..d4fddc579 100644
--- a/doc/mkdocs/docs/api/basic_json/find.md
+++ b/doc/mkdocs/docs/api/basic_json/find.md
@@ -1,20 +1,28 @@
 # <small>nlohmann::basic_json::</small>find
 
 ```cpp
-template<typename KeyT>
-iterator find(KeyT&& key);
+// (1)
+iterator find(const typename object_t::key_type& key);
+const_iterator find(const typename object_t::key_type& key) const;
 
-template<typename KeyT>
-const_iterator find(KeyT&& key) const;
+// (2)
+template<typename KeyType>
+iterator find(KeyType&& key);
+template<typename KeyType>
+const_iterator find(KeyType&& key) const;
 ```
 
-Finds an element in a JSON object with key equivalent to `key`. If the element is not found or the JSON value is not an
-object, `end()` is returned.
+1. Finds an element in a JSON object with a key equivalent to `key`. If the element is not found or the
+   JSON value is not an object, `end()` is returned.
+2. See 1. This overload is only available if `KeyType` is comparable with `#!cpp typename object_t::key_type` and
+   `#!cpp typename object_comparator_t::is_transparent` denotes a type.
 
 ## Template parameters
 
-`KeyT`
-:   A type for an object key.
+`KeyType`
+:   A type for an object key other than [`json_pointer`](../json_pointer/index.md) that is comparable with
+    [`string_t`](string_t.md) using  [`object_comparator_t`](object_comparator_t.md).
+    This can also be a string view (C++17).
 
 ## Parameters
 
@@ -23,8 +31,8 @@ object, `end()` is returned.
     
 ## Return value
 
-Iterator to an element with key equivalent to `key`. If no such element is found or the JSON value is not an object,
-past-the-end (see `end()`) iterator is returned.
+Iterator to an element with a key equivalent to `key`. If no such element is found or the JSON value is not an object,
+a past-the-end iterator (see `end()`) is returned.
 
 ## Exception safety
 
@@ -60,4 +68,5 @@ This method always returns `end()` when executed on a JSON type that is not an o
 
 ## Version history
 
-- Added in version 1.0.0.
+1. Added in version 3.11.0.
+2. Added in version 1.0.0. Changed to support comparable types in version 3.11.0.
diff --git a/doc/mkdocs/docs/api/basic_json/index.md b/doc/mkdocs/docs/api/basic_json/index.md
index 286fea2b4..68ac063ff 100644
--- a/doc/mkdocs/docs/api/basic_json/index.md
+++ b/doc/mkdocs/docs/api/basic_json/index.md
@@ -128,6 +128,7 @@ The class satisfies the following concept requirements:
 - [**array_t**](array_t.md) - type for arrays
 - [**binary_t**](binary_t.md) - type for binary arrays
 - [**boolean_t**](boolean_t.md) - type for booleans
+- [**default_object_comparator_t**](default_object_comparator_t.md) - default comparator for objects
 - [**number_float_t**](number_float_t.md) - type for numbers (floating-point)
 - [**number_integer_t**](number_integer_t.md) - type for numbers (integer)
 - [**number_unsigned_t**](number_unsigned_t.md) - type for numbers (unsigned)
diff --git a/doc/mkdocs/docs/api/basic_json/insert.md b/doc/mkdocs/docs/api/basic_json/insert.md
index fdd8fe6b5..2e6b29301 100644
--- a/doc/mkdocs/docs/api/basic_json/insert.md
+++ b/doc/mkdocs/docs/api/basic_json/insert.md
@@ -50,7 +50,7 @@ void insert(const_iterator first, const_iterator last);
 2. iterator pointing to the first element inserted, or `pos` if `#!cpp cnt==0`
 3. iterator pointing to the first element inserted, or `pos` if `#!cpp first==last`
 4. iterator pointing to the first element inserted, or `pos` if `ilist` is empty
-5. /
+5. (none)
 
 ## Exception safety
 
diff --git a/doc/mkdocs/docs/api/basic_json/object_comparator_t.md b/doc/mkdocs/docs/api/basic_json/object_comparator_t.md
index e2bc79d05..6c64b6453 100644
--- a/doc/mkdocs/docs/api/basic_json/object_comparator_t.md
+++ b/doc/mkdocs/docs/api/basic_json/object_comparator_t.md
@@ -1,16 +1,16 @@
 # <small>nlohmann::basic_json::</small>object_comparator_t
 
-```cpp
-using object_comparator_t = std::less<StringType>;  // until C++14
 
-using object_comparator_t = std::less<>;            // since C++14
+```cpp
+using object_comparator_t = typename object_t::key_compare;
+// or
+using object_comparator_t = default_object_comparator_t;
 ```
 
-The comparator used in [`object_t`](object_t.md).
-
-When C++14 is detected, a transparent comparator is used which, when combined with perfect forwarding on find() and
-count() calls, prevents unnecessary string construction.
+The comparator used by [`object_t`](object_t.md). Defined as `#!cpp typename object_t::key_compare` if available,
+and [`default_object_comparator_t`](default_object_comparator_t.md) otherwise.
 
 ## Version history
 
-- Unknown.
+- Added in version 3.0.0.
+- Changed to be conditionally defined as `#!cpp typename object_t::key_compare` or `default_object_comparator_t` in version 3.11.0.
diff --git a/doc/mkdocs/docs/api/basic_json/object_t.md b/doc/mkdocs/docs/api/basic_json/object_t.md
index d4bea15aa..67b3bb78c 100644
--- a/doc/mkdocs/docs/api/basic_json/object_t.md
+++ b/doc/mkdocs/docs/api/basic_json/object_t.md
@@ -3,7 +3,7 @@
 ```cpp
 using object_t = ObjectType<StringType,
                             basic_json,
-                            object_comparator_t,
+                            default_object_comparator_t,
                             AllocatorType<std::pair<const StringType, basic_json>>>;
 ```
 
@@ -52,7 +52,7 @@ std::map<
 >
 ```
 
-See [`object_comparator_t`](object_comparator_t.md) for more information.
+See [`default_object_comparator_t`](default_object_comparator_t.md) for more information.
 
 #### Behavior
 
diff --git a/doc/mkdocs/docs/api/basic_json/operator[].md b/doc/mkdocs/docs/api/basic_json/operator[].md
index cc9eae7f3..cd5638b97 100644
--- a/doc/mkdocs/docs/api/basic_json/operator[].md
+++ b/doc/mkdocs/docs/api/basic_json/operator[].md
@@ -6,26 +6,32 @@ reference operator[](size_type idx);
 const_reference operator[](size_type idx) const;
 
 // (2)
-reference operator[](const typename object_t::key_type& key);
+reference operator[](typename object_t::key_type key);
 const_reference operator[](const typename object_t::key_type& key) const;
-template<typename T>
-reference operator[](T* key);
-template<typename T>
-const_reference operator[](T* key) const;
 
 // (3)
+template<typename KeyType>
+reference operator[](KeyType&& key);
+template<typename KeyType>
+const_reference operator[](KeyType&& key) const;
+
+// (4)
 reference operator[](const json_pointer& ptr);
 const_reference operator[](const json_pointer& ptr) const;
 ```
 
 1. Returns a reference to the array element at specified location `idx`.
-2. Returns a reference to the object element at with specified key `key`.
-3. Returns a reference to the element at with specified JSON pointer `ptr`.
+2. Returns a reference to the object element with specified key `key`. The non-const qualified overload takes the key by value.
+3. See 2. This overload is only available if `KeyType` is comparable with `#!cpp typename object_t::key_type` and
+   `#!cpp typename object_comparator_t::is_transparent` denotes a type.
+4. Returns a reference to the element with specified JSON pointer `ptr`.
 
 ## Template parameters
 
-`T`
-:   string literal convertible to `object_t::key_type`
+`KeyType`
+:   A type for an object key other than [`json_pointer`](../json_pointer/index.md) that is comparable with
+    [`string_t`](string_t.md) using  [`object_comparator_t`](object_comparator_t.md).
+    This can also be a string view (C++17).
 
 ## Parameters
 
@@ -40,9 +46,10 @@ const_reference operator[](const json_pointer& ptr) const;
     
 ## Return value
 
-1. reference to the element at index `idx`
-2. reference to the element at key `key`
-3. reference to the element pointed to by `ptr`
+1. (const) reference to the element at index `idx`
+2. (const) reference to the element at key `key`
+3. (const) reference to the element at key `key`
+4. (const) reference to the element pointed to by `ptr`
 
 ## Exception safety
 
@@ -56,7 +63,8 @@ Strong exception safety: if an exception occurs, the original value stays intact
 2. The function can throw the following exceptions:
     - Throws [`type_error.305`](../../home/exceptions.md#jsonexceptiontype_error305) if the JSON value is not an object
       or null; in that case, using the `[]` operator with a key makes no sense.
-3. The function can throw the following exceptions:
+3. See 2.
+4. The function can throw the following exceptions:
     - Throws [`parse_error.106`](../../home/exceptions.md#jsonexceptionparse_error106) if an array index in the passed
       JSON pointer `ptr` begins with '0'.
     - Throws [`parse_error.109`](../../home/exceptions.md#jsonexceptionparse_error109) if an array index in the passed
@@ -70,7 +78,8 @@ Strong exception safety: if an exception occurs, the original value stays intact
 
 1. Constant if `idx` is in the range of the array. Otherwise, linear in `idx - size()`.
 2. Logarithmic in the size of the container.
-3. Constant
+3. Logarithmic in the size of the container.
+4. Logarithmic in the size of the container.
 
 ## Notes
 
@@ -87,7 +96,9 @@ Strong exception safety: if an exception occurs, the original value stays intact
 2. If `key` is not found in the object, then it is silently added to the object and filled with a `#!json null` value to
    make `key` a valid reference. In case the value was `#!json null` before, it is converted to an object.
 
-3. `null` values are created in arrays and objects if necessary.
+3. See 2.
+
+4. `null` values are created in arrays and objects if necessary.
    
     In particular:
 
@@ -143,7 +154,7 @@ Strong exception safety: if an exception occurs, the original value stays intact
     --8<-- "examples/operatorarray__key_type.output"
     ```
 
-??? example "Example (2): access specified object element"
+??? example "Example (2): access specified object element (const)"
 
     The example below shows how object elements can be read using the `[]` operator.
     
@@ -157,7 +168,7 @@ Strong exception safety: if an exception occurs, the original value stays intact
     --8<-- "examples/operatorarray__key_type_const.output"
     ```
 
-??? example "Example (3): access specified element via JSON Pointer"
+??? example "Example (4): access specified element via JSON Pointer"
 
     The example below shows how values can be read and written using JSON Pointers.
     
@@ -171,7 +182,7 @@ Strong exception safety: if an exception occurs, the original value stays intact
     --8<-- "examples/operatorjson_pointer.output"
     ```
 
-??? example "Example (3): access specified element via JSON Pointer"
+??? example "Example (4): access specified element via JSON Pointer (const)"
 
     The example below shows how values can be read using JSON Pointers.
     
@@ -193,5 +204,6 @@ Strong exception safety: if an exception occurs, the original value stays intact
 ## Version history
 
 1. Added in version 1.0.0.
-2. Added in version 1.0.0. Overloads for `T* key` added in version 1.1.0.
-3. Added in version 2.0.0.
+2. Added in version 1.0.0. Added overloads for `T* key` in version 1.1.0. Removed overloads for `T* key` (replaced by 3) in version 3.11.0.
+3. Added in version 3.11.0.
+4. Added in version 2.0.0.
diff --git a/doc/mkdocs/docs/api/basic_json/to_bson.md b/doc/mkdocs/docs/api/basic_json/to_bson.md
index 664dd0e20..5c4324a3f 100644
--- a/doc/mkdocs/docs/api/basic_json/to_bson.md
+++ b/doc/mkdocs/docs/api/basic_json/to_bson.md
@@ -28,7 +28,7 @@ The exact mapping and its limitations is described on a [dedicated page](../../f
 ## Return value
 
 1. BSON serialization as byte vector
-2. /
+2. (none)
 
 ## Exception safety
 
diff --git a/doc/mkdocs/docs/api/basic_json/to_cbor.md b/doc/mkdocs/docs/api/basic_json/to_cbor.md
index 05d85ed85..0f944c481 100644
--- a/doc/mkdocs/docs/api/basic_json/to_cbor.md
+++ b/doc/mkdocs/docs/api/basic_json/to_cbor.md
@@ -29,7 +29,7 @@ The exact mapping and its limitations is described on a [dedicated page](../../f
 ## Return value
 
 1. CBOR serialization as byte vector
-2. /
+2. (none)
 
 ## Exception safety
 
diff --git a/doc/mkdocs/docs/api/basic_json/to_msgpack.md b/doc/mkdocs/docs/api/basic_json/to_msgpack.md
index fb4b40bd0..7d40981d5 100644
--- a/doc/mkdocs/docs/api/basic_json/to_msgpack.md
+++ b/doc/mkdocs/docs/api/basic_json/to_msgpack.md
@@ -28,7 +28,7 @@ The exact mapping and its limitations is described on a [dedicated page](../../f
 ## Return value
 
 1. MessagePack serialization as byte vector
-2. /
+2. (none)
 
 ## Exception safety
 
diff --git a/doc/mkdocs/docs/api/basic_json/to_ubjson.md b/doc/mkdocs/docs/api/basic_json/to_ubjson.md
index 0a3d87e54..e3cd5d62b 100644
--- a/doc/mkdocs/docs/api/basic_json/to_ubjson.md
+++ b/doc/mkdocs/docs/api/basic_json/to_ubjson.md
@@ -39,7 +39,7 @@ The exact mapping and its limitations is described on a [dedicated page](../../f
 ## Return value
 
 1. UBJSON serialization as byte vector
-2. /
+2. (none)
 
 ## Exception safety
 
diff --git a/doc/mkdocs/docs/api/basic_json/value.md b/doc/mkdocs/docs/api/basic_json/value.md
index 1844c41fb..6a1f3481d 100644
--- a/doc/mkdocs/docs/api/basic_json/value.md
+++ b/doc/mkdocs/docs/api/basic_json/value.md
@@ -4,9 +4,14 @@
 // (1)
 template<class ValueType>
 ValueType value(const typename object_t::key_type& key,
-                const ValueType& default_value) const;
+                ValueType&& default_value) const;
 
 // (2)
+template<class KeyType, class ValueType>
+ValueType value(KeyType&& key,
+                ValueType&& default_value) const;
+
+// (3)
 template<class ValueType>
 ValueType value(const json_pointer& ptr,
                 const ValueType& default_value) const;
@@ -24,7 +29,10 @@ ValueType value(const json_pointer& ptr,
     }
     ```
 
-2. Returns either a copy of an object's element at the specified JSON pointer `ptr` or a given default value if no value
+2. See 1. This overload is only available if `KeyType` is comparable with `#!cpp typename object_t::key_type` and
+   `#!cpp typename object_comparator_t::is_transparent` denotes a type.
+
+3. Returns either a copy of an object's element at the specified JSON pointer `ptr` or a given default value if no value
    at `ptr` exists.
    
     The function is basically equivalent to executing
@@ -44,6 +52,10 @@ ValueType value(const json_pointer& ptr,
 
 ## Template parameters
 
+`KeyType`
+:   A type for an object key other than [`json_pointer`](../json_pointer/index.md) that is comparable with
+    [`string_t`](string_t.md) using  [`object_comparator_t`](object_comparator_t.md).
+    This can also be a string view (C++17).
 `ValueType` 
 :   type compatible to JSON values, for instance `#!cpp int` for JSON integer numbers, `#!cpp bool` for JSON booleans,
     or `#!cpp std::vector` types for JSON arrays. Note the type of the expected value at `key`/`ptr` and the default
@@ -55,7 +67,7 @@ ValueType value(const json_pointer& ptr,
 :   key of the element to access
 
 `default_value` (in)
-:   the value to return if key/ptr found no value
+:   the value to return if `key`/`ptr` found no value
 
 `ptr` (in)
 :   a JSON pointer to the element to access
@@ -63,7 +75,8 @@ ValueType value(const json_pointer& ptr,
 ## Return value
 
 1. copy of the element at key `key` or `default_value` if `key` is not found
-1. copy of the element at JSON Pointer `ptr` or `default_value` if no value for `ptr` is found
+2. copy of the element at key `key` or `default_value` if `key` is not found
+3. copy of the element at JSON Pointer `ptr` or `default_value` if no value for `ptr` is found
 
 ## Exception safety
 
@@ -77,7 +90,8 @@ changes to any JSON value.
       the type of the value at `key`
     - Throws [`type_error.306`](../../home/exceptions.md#jsonexceptiontype_error306) if the JSON value is not an object;
       in that case, using `value()` with a key makes no sense.
-2. The function can throw the following exceptions:
+2. See 1.
+3. The function can throw the following exceptions:
     - Throws [`type_error.302`](../../home/exceptions.md#jsonexceptiontype_error302) if `default_value` does not match
       the type of the value at `ptr`
     - Throws [`type_error.306`](../../home/exceptions.md#jsonexceptiontype_error306) if the JSON value is not an object;
@@ -87,6 +101,7 @@ changes to any JSON value.
 
 1. Logarithmic in the size of the container.
 2. Logarithmic in the size of the container.
+3. Logarithmic in the size of the container.
 
 ## Examples
 
@@ -104,7 +119,7 @@ changes to any JSON value.
     --8<-- "examples/basic_json__value.output"
     ```
 
-??? example "Example (2): access specified object element via JSON Pointer with default value"
+??? example "Example (3): access specified object element via JSON Pointer with default value"
 
     The example below shows how object elements can be queried with a default value.
     
@@ -125,5 +140,6 @@ changes to any JSON value.
 
 ## Version history
 
-1. Added in version 1.0.0.
-2. Added in version 2.0.2.
+1. Added in version 1.0.0. Changed parameter `default_value` type from `const ValueType&` to `ValueType&&` in version 3.11.0.
+2. Added in version 3.11.0.
+3. Added in version 2.0.2.
diff --git a/doc/mkdocs/docs/api/ordered_map.md b/doc/mkdocs/docs/api/ordered_map.md
index 74b248ff2..160b85c28 100644
--- a/doc/mkdocs/docs/api/ordered_map.md
+++ b/doc/mkdocs/docs/api/ordered_map.md
@@ -32,6 +32,12 @@ A minimal map-like container that preserves insertion order for use within [`nlo
 - **const_iterator**
 - **size_type**
 - **value_type**
+- **key_compare** - key comparison function
+```cpp
+std::equal_to<Key>  // until C++14
+
+std::equal_to<>     // since C++14
+```
 
 ## Member functions
 
@@ -68,3 +74,4 @@ A minimal map-like container that preserves insertion order for use within [`nlo
 ## Version history
 
 - Added in version 3.9.0 to implement [`nlohmann::ordered_json`](ordered_json.md).
+- Added **key_compare** member in version 3.11.0.
diff --git a/doc/mkdocs/mkdocs.yml b/doc/mkdocs/mkdocs.yml
index 59f0ae700..302e827cf 100644
--- a/doc/mkdocs/mkdocs.yml
+++ b/doc/mkdocs/mkdocs.yml
@@ -97,6 +97,7 @@ nav:
         - 'count': api/basic_json/count.md
         - 'crbegin': api/basic_json/crbegin.md
         - 'crend': api/basic_json/crend.md
+        - 'default_object_comparator_t': api/basic_json/default_object_comparator_t.md
         - 'diff': api/basic_json/diff.md
         - 'dump': api/basic_json/dump.md
         - 'emplace': api/basic_json/emplace.md
diff --git a/include/nlohmann/detail/macro_scope.hpp b/include/nlohmann/detail/macro_scope.hpp
index f636b908a..cc9ac5fc7 100644
--- a/include/nlohmann/detail/macro_scope.hpp
+++ b/include/nlohmann/detail/macro_scope.hpp
@@ -106,6 +106,12 @@
     #endif
 #endif
 
+#if JSON_HEDLEY_HAS_ATTRIBUTE(no_unique_address)
+    #define JSON_NO_UNIQUE_ADDRESS [[no_unique_address]]
+#else
+    #define JSON_NO_UNIQUE_ADDRESS
+#endif
+
 // disable documentation warnings on clang
 #if defined(__clang__)
     #pragma clang diagnostic push
diff --git a/include/nlohmann/detail/macro_unscope.hpp b/include/nlohmann/detail/macro_unscope.hpp
index 377d3f11d..ec57b02cc 100644
--- a/include/nlohmann/detail/macro_unscope.hpp
+++ b/include/nlohmann/detail/macro_unscope.hpp
@@ -14,6 +14,7 @@
 #undef NLOHMANN_BASIC_JSON_TPL
 #undef JSON_EXPLICIT
 #undef NLOHMANN_CAN_CALL_STD_FUNC_IMPL
+#undef JSON_NO_UNIQUE_ADDRESS
 
 #ifndef JSON_TEST_KEEP_MACROS
     #undef JSON_CATCH
diff --git a/include/nlohmann/detail/meta/type_traits.hpp b/include/nlohmann/detail/meta/type_traits.hpp
index 376c00a09..2cc13f3ac 100644
--- a/include/nlohmann/detail/meta/type_traits.hpp
+++ b/include/nlohmann/detail/meta/type_traits.hpp
@@ -54,11 +54,6 @@ struct is_basic_json_context :
     || std::is_same<BasicJsonContext, std::nullptr_t>::value >
 {};
 
-template<typename> struct is_json_pointer : std::false_type {};
-
-template<typename RefStringType>
-struct is_json_pointer<json_pointer<RefStringType>> : std::true_type {};
-
 //////////////////////
 // json_ref helpers //
 //////////////////////
@@ -160,6 +155,24 @@ struct has_to_json < BasicJsonType, T, enable_if_t < !is_basic_json<T>::value >>
         T>::value;
 };
 
+template<typename T>
+using detect_key_compare = typename T::key_compare;
+
+template<typename T>
+struct has_key_compare : std::integral_constant<bool, is_detected<detect_key_compare, T>::value> {};
+
+// obtains the actual object key comparator
+template<typename BasicJsonType>
+struct actual_object_comparator
+{
+    using object_t = typename BasicJsonType::object_t;
+    using object_comparator_t = typename BasicJsonType::default_object_comparator_t;
+    using type = typename std::conditional < has_key_compare<object_t>::value,
+          typename object_t::key_compare, object_comparator_t>::type;
+};
+
+template<typename BasicJsonType>
+using actual_object_comparator_t = typename actual_object_comparator<BasicJsonType>::type;
 
 ///////////////////
 // is_ functions //
@@ -454,6 +467,78 @@ struct is_constructible_tuple : std::false_type {};
 template<typename T1, typename... Args>
 struct is_constructible_tuple<T1, std::tuple<Args...>> : conjunction<is_constructible<T1, Args>...> {};
 
+template<typename BasicJsonType, typename T>
+struct is_json_iterator_of : std::false_type {};
+
+template<typename BasicJsonType>
+struct is_json_iterator_of<BasicJsonType, typename BasicJsonType::iterator> : std::true_type {};
+
+template<typename BasicJsonType>
+struct is_json_iterator_of<BasicJsonType, typename BasicJsonType::const_iterator> : std::true_type
+{};
+
+// checks if a given type T is a template specialization of Primary
+template<template <typename...> class Primary, typename T>
+struct is_specialization_of : std::false_type {};
+
+template<template <typename...> class Primary, typename... Args>
+struct is_specialization_of<Primary, Primary<Args...>> : std::true_type {};
+
+template<typename T>
+using is_json_pointer = is_specialization_of<::nlohmann::json_pointer, uncvref_t<T>>;
+
+// checks if A and B are comparable using Compare functor
+template<typename Compare, typename A, typename B, typename = void>
+struct is_comparable : std::false_type {};
+
+template<typename Compare, typename A, typename B>
+struct is_comparable<Compare, A, B, void_t<
+decltype(std::declval<Compare>()(std::declval<A>(), std::declval<B>())),
+decltype(std::declval<Compare>()(std::declval<B>(), std::declval<A>()))
+>> : std::true_type {};
+
+// checks if BasicJsonType::object_t::key_type and KeyType are comparable using Compare functor
+template<typename BasicJsonType, typename KeyType>
+using is_key_type_comparable = typename is_comparable <
+                               typename BasicJsonType::object_comparator_t,
+                               const key_type_t<typename BasicJsonType::object_t>&,
+                               KeyType >::type;
+
+template<typename T>
+using detect_is_transparent = typename T::is_transparent;
+
+// type trait to check if KeyType can be used as object key
+// true if:
+//   - KeyType is comparable with BasicJsonType::object_t::key_type
+//   - if ExcludeObjectKeyType is true, KeyType is not BasicJsonType::object_t::key_type
+//   - the comparator is transparent or RequireTransparentComparator is false
+//   - KeyType is not a JSON iterator or json_pointer
+template<typename BasicJsonType, typename KeyTypeCVRef, bool RequireTransparentComparator = true,
+         bool ExcludeObjectKeyType = RequireTransparentComparator, typename KeyType = uncvref_t<KeyTypeCVRef>>
+using is_usable_as_key_type = typename std::conditional <
+                              is_key_type_comparable<BasicJsonType, KeyTypeCVRef>::value
+                              && !(ExcludeObjectKeyType && std::is_same<KeyType,
+                                   typename BasicJsonType::object_t::key_type>::value)
+                              && (!RequireTransparentComparator || is_detected <
+                                  detect_is_transparent,
+                                  typename BasicJsonType::object_comparator_t >::value)
+                              && !is_json_iterator_of<BasicJsonType, KeyType>::value
+                              && !is_json_pointer<KeyType>::value,
+                              std::true_type,
+                              std::false_type >::type;
+
+template<typename ObjectType, typename KeyType>
+using detect_erase_with_key_type = decltype(std::declval<ObjectType&>().erase(std::declval<KeyType>()));
+
+// type trait to check if object_t has an erase() member functions accepting KeyType
+template<typename BasicJsonType, typename KeyType>
+using has_erase_with_key_type = typename std::conditional <
+                                is_detected <
+                                detect_erase_with_key_type,
+                                typename BasicJsonType::object_t, KeyType >::value,
+                                std::true_type,
+                                std::false_type >::type;
+
 // a naive helper to check if a type is an ordered_map (exploits the fact that
 // ordered_map inherits capacity() from std::vector)
 template <typename T>
diff --git a/include/nlohmann/json.hpp b/include/nlohmann/json.hpp
index 0a18f1634..da9b3de6c 100644
--- a/include/nlohmann/json.hpp
+++ b/include/nlohmann/json.hpp
@@ -350,21 +350,23 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// the template arguments passed to class @ref basic_json.
     /// @{
 
-    /// @brief object key comparator type
-    /// @sa https://json.nlohmann.me/api/basic_json/object_comparator_t/
+    /// @brief default object key comparator type
+    /// The actual object key comparator type (@ref object_comparator_t) may be
+    /// different.
+    /// @sa https://json.nlohmann.me/api/basic_json/default_object_comparator_t/
 #if defined(JSON_HAS_CPP_14)
-    // Use transparent comparator if possible, combined with perfect forwarding
-    // on find() and count() calls prevents unnecessary string construction.
-    using object_comparator_t = std::less<>;
+    // use of transparent comparator avoids unnecessary repeated construction of temporaries
+    // in functions involving lookup by key with types other than object_t::key_type (aka. StringType)
+    using default_object_comparator_t = std::less<>;
 #else
-    using object_comparator_t = std::less<StringType>;
+    using default_object_comparator_t = std::less<StringType>;
 #endif
 
     /// @brief a type for an object
     /// @sa https://json.nlohmann.me/api/basic_json/object_t/
     using object_t = ObjectType<StringType,
           basic_json,
-          object_comparator_t,
+          default_object_comparator_t,
           AllocatorType<std::pair<const StringType,
           basic_json>>>;
 
@@ -396,6 +398,10 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// @sa https://json.nlohmann.me/api/basic_json/binary_t/
     using binary_t = nlohmann::byte_container_with_subtype<BinaryType>;
 
+    /// @brief object key comparator type
+    /// @sa https://json.nlohmann.me/api/basic_json/object_comparator_t/
+    using object_comparator_t = detail::actual_object_comparator_t<basic_json>;
+
     /// @}
 
   private:
@@ -2000,22 +2006,37 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     reference at(const typename object_t::key_type& key)
     {
         // at only works for objects
-        if (JSON_HEDLEY_LIKELY(is_object()))
-        {
-            JSON_TRY
-            {
-                return set_parent(m_value.object->at(key));
-            }
-            JSON_CATCH (std::out_of_range&)
-            {
-                // create better exception explanation
-                JSON_THROW(out_of_range::create(403, detail::concat("key '", key, "' not found"), this));
-            }
-        }
-        else
+        if (JSON_HEDLEY_UNLIKELY(!is_object()))
         {
             JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
         }
+
+        auto it = m_value.object->find(key);
+        if (it == m_value.object->end())
+        {
+            JSON_THROW(out_of_range::create(403, detail::concat("key '", key, "' not found"), this));
+        }
+        return set_parent(it->second);
+    }
+
+    /// @brief access specified object element with bounds checking
+    /// @sa https://json.nlohmann.me/api/basic_json/at/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int> = 0>
+    reference at(KeyType && key)
+    {
+        // at only works for objects
+        if (JSON_HEDLEY_UNLIKELY(!is_object()))
+        {
+            JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
+        }
+
+        auto it = m_value.object->find(std::forward<KeyType>(key));
+        if (it == m_value.object->end())
+        {
+            JSON_THROW(out_of_range::create(403, detail::concat("key '", string_t(std::forward<KeyType>(key)), "' not found"), this));
+        }
+        return set_parent(it->second);
     }
 
     /// @brief access specified object element with bounds checking
@@ -2023,22 +2044,37 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     const_reference at(const typename object_t::key_type& key) const
     {
         // at only works for objects
-        if (JSON_HEDLEY_LIKELY(is_object()))
-        {
-            JSON_TRY
-            {
-                return m_value.object->at(key);
-            }
-            JSON_CATCH (std::out_of_range&)
-            {
-                // create better exception explanation
-                JSON_THROW(out_of_range::create(403, detail::concat("key '", key, "' not found"), this));
-            }
-        }
-        else
+        if (JSON_HEDLEY_UNLIKELY(!is_object()))
         {
             JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
         }
+
+        auto it = m_value.object->find(key);
+        if (it == m_value.object->end())
+        {
+            JSON_THROW(out_of_range::create(403, detail::concat("key '", key, "' not found"), this));
+        }
+        return it->second;
+    }
+
+    /// @brief access specified object element with bounds checking
+    /// @sa https://json.nlohmann.me/api/basic_json/at/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int> = 0>
+    const_reference at(KeyType && key) const
+    {
+        // at only works for objects
+        if (JSON_HEDLEY_UNLIKELY(!is_object()))
+        {
+            JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
+        }
+
+        auto it = m_value.object->find(std::forward<KeyType>(key));
+        if (it == m_value.object->end())
+        {
+            JSON_THROW(out_of_range::create(403, detail::concat("key '", string_t(std::forward<KeyType>(key)), "' not found"), this));
+        }
+        return it->second;
     }
 
     /// @brief access specified array element
@@ -2102,7 +2138,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief access specified object element
     /// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
-    reference operator[](const typename object_t::key_type& key)
+    reference operator[](typename object_t::key_type key)
     {
         // implicitly convert null value to an empty object
         if (is_null())
@@ -2115,7 +2151,8 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         // operator[] only works for objects
         if (JSON_HEDLEY_LIKELY(is_object()))
         {
-            return set_parent(m_value.object->operator[](key));
+            auto result = m_value.object->emplace(std::move(key), nullptr);
+            return set_parent(result.first->second);
         }
 
         JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a string argument with ", type_name()), this));
@@ -2128,31 +2165,47 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         // const operator[] only works for objects
         if (JSON_HEDLEY_LIKELY(is_object()))
         {
-            JSON_ASSERT(m_value.object->find(key) != m_value.object->end());
-            return m_value.object->find(key)->second;
+            auto it = m_value.object->find(key);
+            JSON_ASSERT(it != m_value.object->end());
+            return it->second;
         }
 
         JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a string argument with ", type_name()), this));
     }
 
-    /// @brief access specified object element
-    /// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
+    // these two functions resolve a (const) char * ambiguity affecting Clang and MSVC
+    // (they seemingly cannot be constrained to resolve the ambiguity)
     template<typename T>
-    JSON_HEDLEY_NON_NULL(2)
     reference operator[](T* key)
     {
-        // implicitly convert null to object
+        return operator[](typename object_t::key_type(key));
+    }
+
+    template<typename T>
+    const_reference operator[](T* key) const
+    {
+        return operator[](typename object_t::key_type(key));
+    }
+
+    /// @brief access specified object element
+    /// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int > = 0 >
+    reference operator[](KeyType && key)
+    {
+        // implicitly convert null value to an empty object
         if (is_null())
         {
             m_type = value_t::object;
-            m_value = value_t::object;
+            m_value.object = create<object_t>();
             assert_invariant();
         }
 
-        // at only works for objects
+        // operator[] only works for objects
         if (JSON_HEDLEY_LIKELY(is_object()))
         {
-            return set_parent(m_value.object->operator[](key));
+            auto result = m_value.object->emplace(std::forward<KeyType>(key), nullptr);
+            return set_parent(result.first->second);
         }
 
         JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a string argument with ", type_name()), this));
@@ -2160,15 +2213,16 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief access specified object element
     /// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
-    template<typename T>
-    JSON_HEDLEY_NON_NULL(2)
-    const_reference operator[](T* key) const
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int > = 0 >
+    const_reference operator[](KeyType && key) const
     {
-        // at only works for objects
+        // const operator[] only works for objects
         if (JSON_HEDLEY_LIKELY(is_object()))
         {
-            JSON_ASSERT(m_value.object->find(key) != m_value.object->end());
-            return m_value.object->find(key)->second;
+            auto it = m_value.object->find(std::forward<KeyType>(key));
+            JSON_ASSERT(it != m_value.object->end());
+            return it->second;
         }
 
         JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a string argument with ", type_name()), this));
@@ -2176,23 +2230,24 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief access specified object element with default value
     /// @sa https://json.nlohmann.me/api/basic_json/value/
-    /// using std::is_convertible in a std::enable_if will fail when using explicit conversions
-    template < class ValueType, typename std::enable_if <
-                   detail::is_getable<basic_json_t, ValueType>::value
-                   && !std::is_same<value_t, ValueType>::value, int >::type = 0 >
-    ValueType value(const typename object_t::key_type& key, const ValueType& default_value) const
+    // this is the value(const typename object_t::key_type&) overload
+    template < class KeyType, class ValueType, detail::enable_if_t <
+                   std::is_same<KeyType, typename object_t::key_type>::value
+                   && detail::is_getable<basic_json_t, ValueType>::value
+                   && !std::is_same<value_t, ValueType>::value, int > = 0 >
+    typename std::decay<ValueType>::type value(const KeyType& key, ValueType && default_value) const
     {
-        // at only works for objects
+        // value only works for objects
         if (JSON_HEDLEY_LIKELY(is_object()))
         {
             // if key is found, return value and given default value otherwise
             const auto it = find(key);
             if (it != end())
             {
-                return it->template get<ValueType>();
+                return it->template get<typename std::decay<ValueType>::type>();
             }
 
-            return default_value;
+            return std::forward<ValueType>(default_value);
         }
 
         JSON_THROW(type_error::create(306, detail::concat("cannot use value() with ", type_name()), this));
@@ -2206,13 +2261,64 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         return value(key, string_t(default_value));
     }
 
+    // these two functions, in conjunction with value(const KeyType &, ValueType &&),
+    // resolve an ambiguity that would otherwise occur between the json_pointer and
+    // typename object_t::key_type & overloads
+    template < class ValueType, detail::enable_if_t <
+                   detail::is_getable<basic_json_t, ValueType>::value
+                   && !std::is_same<value_t, ValueType>::value, int > = 0 >
+    typename std::decay<ValueType>::type value(const char* key, ValueType && default_value) const
+    {
+        return value(typename object_t::key_type(key), std::forward<ValueType>(default_value));
+    }
+
+    string_t value(const char* key, const char* default_value) const
+    {
+        return value(typename object_t::key_type(key), string_t(default_value));
+    }
+
+    /// @brief access specified object element with default value
+    /// @sa https://json.nlohmann.me/api/basic_json/value/
+    /// using std::is_convertible in a std::enable_if will fail when using explicit conversions
+    template < class KeyType, class ValueType, detail::enable_if_t <
+                   detail::is_getable<basic_json_t, ValueType>::value
+                   && !std::is_same<value_t, ValueType>::value
+                   && detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int > = 0 >
+    typename std::decay<ValueType>::type value(KeyType && key, ValueType && default_value) const
+    {
+        // value only works for objects
+        if (JSON_HEDLEY_LIKELY(is_object()))
+        {
+            // if key is found, return value and given default value otherwise
+            const auto it = find(std::forward<KeyType>(key));
+            if (it != end())
+            {
+                return it->template get<typename std::decay<ValueType>::type>();
+            }
+
+            return std::forward<ValueType>(default_value);
+        }
+
+        JSON_THROW(type_error::create(306, detail::concat("cannot use value() with ", type_name()), this));
+    }
+
+    /// @brief access specified object element with default value
+    /// @sa https://json.nlohmann.me/api/basic_json/value/
+    /// overload for a default value of type const char*
+    template < class KeyType, detail::enable_if_t <
+                   !detail::is_json_pointer<KeyType>::value, int > = 0 >
+    string_t value(KeyType && key, const char* default_value) const
+    {
+        return value(std::forward<KeyType>(key), string_t(default_value));
+    }
+
     /// @brief access specified object element via JSON Pointer with default value
     /// @sa https://json.nlohmann.me/api/basic_json/value/
-    template<class ValueType, typename std::enable_if<
-                 detail::is_getable<basic_json_t, ValueType>::value, int>::type = 0>
+    template < class ValueType, detail::enable_if_t <
+                   detail::is_getable<basic_json_t, ValueType>::value, int> = 0 >
     ValueType value(const json_pointer& ptr, const ValueType& default_value) const
     {
-        // at only works for objects
+        // value only works for objects
         if (JSON_HEDLEY_LIKELY(is_object()))
         {
             // if pointer resolves a value, return it or use default value
@@ -2229,8 +2335,8 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         JSON_THROW(type_error::create(306, detail::concat("cannot use value() with ", type_name()), this));
     }
 
-    template<class ValueType, class BasicJsonType, typename std::enable_if<
-                 detail::is_getable<basic_json_t, ValueType>::value, int>::type = 0>
+    template < class ValueType, class BasicJsonType, detail::enable_if_t <
+                   detail::is_getable<basic_json_t, ValueType>::value, int> = 0 >
     JSON_HEDLEY_DEPRECATED_FOR(3.11.0, basic_json::json_pointer or nlohmann::json_pointer<basic_json::string_t>) // NOLINT(readability/alt_tokens)
     ValueType value(const ::nlohmann::json_pointer<BasicJsonType>& ptr, const ValueType& default_value) const
     {
@@ -2288,10 +2394,9 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief remove element given an iterator
     /// @sa https://json.nlohmann.me/api/basic_json/erase/
-    template < class IteratorType, typename std::enable_if <
+    template < class IteratorType, detail::enable_if_t <
                    std::is_same<IteratorType, typename basic_json_t::iterator>::value ||
-                   std::is_same<IteratorType, typename basic_json_t::const_iterator>::value, int >::type
-               = 0 >
+                   std::is_same<IteratorType, typename basic_json_t::const_iterator>::value, int > = 0 >
     IteratorType erase(IteratorType pos)
     {
         // make sure iterator fits the current value
@@ -2359,10 +2464,9 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief remove elements given an iterator range
     /// @sa https://json.nlohmann.me/api/basic_json/erase/
-    template < class IteratorType, typename std::enable_if <
+    template < class IteratorType, detail::enable_if_t <
                    std::is_same<IteratorType, typename basic_json_t::iterator>::value ||
-                   std::is_same<IteratorType, typename basic_json_t::const_iterator>::value, int >::type
-               = 0 >
+                   std::is_same<IteratorType, typename basic_json_t::const_iterator>::value, int > = 0 >
     IteratorType erase(IteratorType first, IteratorType last)
     {
         // make sure iterator fits the current value
@@ -2431,17 +2535,57 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         return result;
     }
 
+  private:
+    template < typename KeyType, detail::enable_if_t <
+                   detail::has_erase_with_key_type<basic_json_t, KeyType>::value, int > = 0 >
+    size_type erase_internal(KeyType && key)
+    {
+        // this erase only works for objects
+        if (JSON_HEDLEY_UNLIKELY(!is_object()))
+        {
+            JSON_THROW(type_error::create(307, detail::concat("cannot use erase() with ", type_name()), this));
+        }
+
+        return m_value.object->erase(std::forward<KeyType>(key));
+    }
+
+    template < typename KeyType, detail::enable_if_t <
+                   !detail::has_erase_with_key_type<basic_json_t, KeyType>::value, int > = 0 >
+    size_type erase_internal(KeyType && key)
+    {
+        // this erase only works for objects
+        if (JSON_HEDLEY_UNLIKELY(!is_object()))
+        {
+            JSON_THROW(type_error::create(307, detail::concat("cannot use erase() with ", type_name()), this));
+        }
+
+        const auto it = m_value.object->find(std::forward<KeyType>(key));
+        if (it != m_value.object->end())
+        {
+            m_value.object->erase(it);
+            return 1;
+        }
+        return 0;
+    }
+
+  public:
+
     /// @brief remove element from a JSON object given a key
     /// @sa https://json.nlohmann.me/api/basic_json/erase/
     size_type erase(const typename object_t::key_type& key)
     {
-        // this erase only works for objects
-        if (JSON_HEDLEY_LIKELY(is_object()))
-        {
-            return m_value.object->erase(key);
-        }
+        // the indirection via erase_internal() is added to avoid making this
+        // function a template and thus de-rank it during overload resolution
+        return erase_internal(key);
+    }
 
-        JSON_THROW(type_error::create(307, detail::concat("cannot use erase() with ", type_name()), this));
+    /// @brief remove element from a JSON object given a key
+    /// @sa https://json.nlohmann.me/api/basic_json/erase/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int> = 0>
+    size_type erase(KeyType && key)
+    {
+        return erase_internal(std::forward<KeyType>(key));
     }
 
     /// @brief remove element from a JSON array given an index
@@ -2476,14 +2620,13 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief find an element in a JSON object
     /// @sa https://json.nlohmann.me/api/basic_json/find/
-    template<typename KeyT>
-    iterator find(KeyT&& key)
+    iterator find(const typename object_t::key_type& key)
     {
         auto result = end();
 
         if (is_object())
         {
-            result.m_it.object_iterator = m_value.object->find(std::forward<KeyT>(key));
+            result.m_it.object_iterator = m_value.object->find(key);
         }
 
         return result;
@@ -2491,14 +2634,45 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief find an element in a JSON object
     /// @sa https://json.nlohmann.me/api/basic_json/find/
-    template<typename KeyT>
-    const_iterator find(KeyT&& key) const
+    const_iterator find(const typename object_t::key_type& key) const
     {
         auto result = cend();
 
         if (is_object())
         {
-            result.m_it.object_iterator = m_value.object->find(std::forward<KeyT>(key));
+            result.m_it.object_iterator = m_value.object->find(key);
+        }
+
+        return result;
+    }
+
+    /// @brief find an element in a JSON object
+    /// @sa https://json.nlohmann.me/api/basic_json/find/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int> = 0>
+    iterator find(KeyType && key)
+    {
+        auto result = end();
+
+        if (is_object())
+        {
+            result.m_it.object_iterator = m_value.object->find(std::forward<KeyType>(key));
+        }
+
+        return result;
+    }
+
+    /// @brief find an element in a JSON object
+    /// @sa https://json.nlohmann.me/api/basic_json/find/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int> = 0>
+    const_iterator find(KeyType && key) const
+    {
+        auto result = cend();
+
+        if (is_object())
+        {
+            result.m_it.object_iterator = m_value.object->find(std::forward<KeyType>(key));
         }
 
         return result;
@@ -2506,20 +2680,36 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief returns the number of occurrences of a key in a JSON object
     /// @sa https://json.nlohmann.me/api/basic_json/count/
-    template<typename KeyT>
-    size_type count(KeyT&& key) const
+    size_type count(const typename object_t::key_type& key) const
     {
         // return 0 for all nonobject types
-        return is_object() ? m_value.object->count(std::forward<KeyT>(key)) : 0;
+        return is_object() ? m_value.object->count(key) : 0;
+    }
+
+    /// @brief returns the number of occurrences of a key in a JSON object
+    /// @sa https://json.nlohmann.me/api/basic_json/count/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int> = 0>
+    size_type count(KeyType && key) const
+    {
+        // return 0 for all nonobject types
+        return is_object() ? m_value.object->count(std::forward<KeyType>(key)) : 0;
     }
 
     /// @brief check the existence of an element in a JSON object
     /// @sa https://json.nlohmann.me/api/basic_json/contains/
-    template < typename KeyT, typename std::enable_if <
-                   !detail::is_json_pointer<typename std::decay<KeyT>::type>::value, int >::type = 0 >
-    bool contains(KeyT && key) const
+    bool contains(const typename object_t::key_type& key) const
     {
-        return is_object() && m_value.object->find(std::forward<KeyT>(key)) != m_value.object->end();
+        return is_object() && m_value.object->find(key) != m_value.object->end();
+    }
+
+    /// @brief check the existence of an element in a JSON object
+    /// @sa https://json.nlohmann.me/api/basic_json/contains/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int> = 0>
+    bool contains(KeyType && key) const
+    {
+        return is_object() && m_value.object->find(std::forward<KeyType>(key)) != m_value.object->end();
     }
 
     /// @brief check the existence of an element in a JSON object given a JSON pointer
@@ -4305,7 +4495,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         return ptr.get_unchecked(this);
     }
 
-    template<typename BasicJsonType>
+    template<typename BasicJsonType, detail::enable_if_t<detail::is_basic_json<BasicJsonType>::value, int> = 0>
     JSON_HEDLEY_DEPRECATED_FOR(3.11.0, basic_json::json_pointer or nlohmann::json_pointer<basic_json::string_t>) // NOLINT(readability/alt_tokens)
     reference operator[](const ::nlohmann::json_pointer<BasicJsonType>& ptr)
     {
@@ -4319,7 +4509,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         return ptr.get_unchecked(this);
     }
 
-    template<typename BasicJsonType>
+    template<typename BasicJsonType, detail::enable_if_t<detail::is_basic_json<BasicJsonType>::value, int> = 0>
     JSON_HEDLEY_DEPRECATED_FOR(3.11.0, basic_json::json_pointer or nlohmann::json_pointer<basic_json::string_t>) // NOLINT(readability/alt_tokens)
     const_reference operator[](const ::nlohmann::json_pointer<BasicJsonType>& ptr) const
     {
diff --git a/include/nlohmann/ordered_map.hpp b/include/nlohmann/ordered_map.hpp
index 5a7da074b..6779fdf9a 100644
--- a/include/nlohmann/ordered_map.hpp
+++ b/include/nlohmann/ordered_map.hpp
@@ -1,6 +1,6 @@
 #pragma once
 
-#include <functional> // less
+#include <functional> // equal_to, less
 #include <initializer_list> // initializer_list
 #include <iterator> // input_iterator_tag, iterator_traits
 #include <memory> // allocator
@@ -27,6 +27,11 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     using const_iterator = typename Container::const_iterator;
     using size_type = typename Container::size_type;
     using value_type = typename Container::value_type;
+#ifdef JSON_HAS_CPP_14
+    using key_compare = std::equal_to<>;
+#else
+    using key_compare = std::equal_to<Key>;
+#endif
 
     // Explicit constructors instead of `using Container::Container`
     // otherwise older compilers choke on it (GCC <= 5.5, xcode <= 9.4)
@@ -42,7 +47,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == key)
+            if (m_compare(it->first, key))
             {
                 return {it, false};
             }
@@ -65,7 +70,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == key)
+            if (m_compare(it->first, key))
             {
                 return it->second;
             }
@@ -78,7 +83,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == key)
+            if (m_compare(it->first, key))
             {
                 return it->second;
             }
@@ -91,7 +96,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == key)
+            if (m_compare(it->first, key))
             {
                 // Since we cannot move const Keys, re-construct them in place
                 for (auto next = it; ++next != this->end(); ++it)
@@ -163,7 +168,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == key)
+            if (m_compare(it->first, key))
             {
                 return 1;
             }
@@ -175,7 +180,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == key)
+            if (m_compare(it->first, key))
             {
                 return it;
             }
@@ -187,7 +192,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == key)
+            if (m_compare(it->first, key))
             {
                 return it;
             }
@@ -204,7 +209,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == value.first)
+            if (m_compare(it->first, value.first))
             {
                 return {it, false};
             }
@@ -225,6 +230,9 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
             insert(*it);
         }
     }
+
+private:
+    JSON_NO_UNIQUE_ADDRESS key_compare m_compare = key_compare();
 };
 
 }  // namespace nlohmann
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index d596180c6..d5fe92c58 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -2411,6 +2411,12 @@ using is_detected_convertible =
     #endif
 #endif
 
+#if JSON_HEDLEY_HAS_ATTRIBUTE(no_unique_address)
+    #define JSON_NO_UNIQUE_ADDRESS [[no_unique_address]]
+#else
+    #define JSON_NO_UNIQUE_ADDRESS
+#endif
+
 // disable documentation warnings on clang
 #if defined(__clang__)
     #pragma clang diagnostic push
@@ -3183,11 +3189,6 @@ struct is_basic_json_context :
     || std::is_same<BasicJsonContext, std::nullptr_t>::value >
 {};
 
-template<typename> struct is_json_pointer : std::false_type {};
-
-template<typename RefStringType>
-struct is_json_pointer<json_pointer<RefStringType>> : std::true_type {};
-
 //////////////////////
 // json_ref helpers //
 //////////////////////
@@ -3289,6 +3290,24 @@ struct has_to_json < BasicJsonType, T, enable_if_t < !is_basic_json<T>::value >>
         T>::value;
 };
 
+template<typename T>
+using detect_key_compare = typename T::key_compare;
+
+template<typename T>
+struct has_key_compare : std::integral_constant<bool, is_detected<detect_key_compare, T>::value> {};
+
+// obtains the actual object key comparator
+template<typename BasicJsonType>
+struct actual_object_comparator
+{
+    using object_t = typename BasicJsonType::object_t;
+    using object_comparator_t = typename BasicJsonType::default_object_comparator_t;
+    using type = typename std::conditional < has_key_compare<object_t>::value,
+          typename object_t::key_compare, object_comparator_t>::type;
+};
+
+template<typename BasicJsonType>
+using actual_object_comparator_t = typename actual_object_comparator<BasicJsonType>::type;
 
 ///////////////////
 // is_ functions //
@@ -3583,6 +3602,78 @@ struct is_constructible_tuple : std::false_type {};
 template<typename T1, typename... Args>
 struct is_constructible_tuple<T1, std::tuple<Args...>> : conjunction<is_constructible<T1, Args>...> {};
 
+template<typename BasicJsonType, typename T>
+struct is_json_iterator_of : std::false_type {};
+
+template<typename BasicJsonType>
+struct is_json_iterator_of<BasicJsonType, typename BasicJsonType::iterator> : std::true_type {};
+
+template<typename BasicJsonType>
+struct is_json_iterator_of<BasicJsonType, typename BasicJsonType::const_iterator> : std::true_type
+{};
+
+// checks if a given type T is a template specialization of Primary
+template<template <typename...> class Primary, typename T>
+struct is_specialization_of : std::false_type {};
+
+template<template <typename...> class Primary, typename... Args>
+struct is_specialization_of<Primary, Primary<Args...>> : std::true_type {};
+
+template<typename T>
+using is_json_pointer = is_specialization_of<::nlohmann::json_pointer, uncvref_t<T>>;
+
+// checks if A and B are comparable using Compare functor
+template<typename Compare, typename A, typename B, typename = void>
+struct is_comparable : std::false_type {};
+
+template<typename Compare, typename A, typename B>
+struct is_comparable<Compare, A, B, void_t<
+decltype(std::declval<Compare>()(std::declval<A>(), std::declval<B>())),
+decltype(std::declval<Compare>()(std::declval<B>(), std::declval<A>()))
+>> : std::true_type {};
+
+// checks if BasicJsonType::object_t::key_type and KeyType are comparable using Compare functor
+template<typename BasicJsonType, typename KeyType>
+using is_key_type_comparable = typename is_comparable <
+                               typename BasicJsonType::object_comparator_t,
+                               const key_type_t<typename BasicJsonType::object_t>&,
+                               KeyType >::type;
+
+template<typename T>
+using detect_is_transparent = typename T::is_transparent;
+
+// type trait to check if KeyType can be used as object key
+// true if:
+//   - KeyType is comparable with BasicJsonType::object_t::key_type
+//   - if ExcludeObjectKeyType is true, KeyType is not BasicJsonType::object_t::key_type
+//   - the comparator is transparent or RequireTransparentComparator is false
+//   - KeyType is not a JSON iterator or json_pointer
+template<typename BasicJsonType, typename KeyTypeCVRef, bool RequireTransparentComparator = true,
+         bool ExcludeObjectKeyType = RequireTransparentComparator, typename KeyType = uncvref_t<KeyTypeCVRef>>
+using is_usable_as_key_type = typename std::conditional <
+                              is_key_type_comparable<BasicJsonType, KeyTypeCVRef>::value
+                              && !(ExcludeObjectKeyType && std::is_same<KeyType,
+                                   typename BasicJsonType::object_t::key_type>::value)
+                              && (!RequireTransparentComparator || is_detected <
+                                  detect_is_transparent,
+                                  typename BasicJsonType::object_comparator_t >::value)
+                              && !is_json_iterator_of<BasicJsonType, KeyType>::value
+                              && !is_json_pointer<KeyType>::value,
+                              std::true_type,
+                              std::false_type >::type;
+
+template<typename ObjectType, typename KeyType>
+using detect_erase_with_key_type = decltype(std::declval<ObjectType&>().erase(std::declval<KeyType>()));
+
+// type trait to check if object_t has an erase() member functions accepting KeyType
+template<typename BasicJsonType, typename KeyType>
+using has_erase_with_key_type = typename std::conditional <
+                                is_detected <
+                                detect_erase_with_key_type,
+                                typename BasicJsonType::object_t, KeyType >::value,
+                                std::true_type,
+                                std::false_type >::type;
+
 // a naive helper to check if a type is an ordered_map (exploits the fact that
 // ordered_map inherits capacity() from std::vector)
 template <typename T>
@@ -17834,7 +17925,7 @@ class serializer
 // #include <nlohmann/ordered_map.hpp>
 
 
-#include <functional> // less
+#include <functional> // equal_to, less
 #include <initializer_list> // initializer_list
 #include <iterator> // input_iterator_tag, iterator_traits
 #include <memory> // allocator
@@ -17862,6 +17953,11 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     using const_iterator = typename Container::const_iterator;
     using size_type = typename Container::size_type;
     using value_type = typename Container::value_type;
+#ifdef JSON_HAS_CPP_14
+    using key_compare = std::equal_to<>;
+#else
+    using key_compare = std::equal_to<Key>;
+#endif
 
     // Explicit constructors instead of `using Container::Container`
     // otherwise older compilers choke on it (GCC <= 5.5, xcode <= 9.4)
@@ -17877,7 +17973,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == key)
+            if (m_compare(it->first, key))
             {
                 return {it, false};
             }
@@ -17900,7 +17996,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == key)
+            if (m_compare(it->first, key))
             {
                 return it->second;
             }
@@ -17913,7 +18009,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == key)
+            if (m_compare(it->first, key))
             {
                 return it->second;
             }
@@ -17926,7 +18022,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == key)
+            if (m_compare(it->first, key))
             {
                 // Since we cannot move const Keys, re-construct them in place
                 for (auto next = it; ++next != this->end(); ++it)
@@ -17998,7 +18094,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == key)
+            if (m_compare(it->first, key))
             {
                 return 1;
             }
@@ -18010,7 +18106,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == key)
+            if (m_compare(it->first, key))
             {
                 return it;
             }
@@ -18022,7 +18118,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == key)
+            if (m_compare(it->first, key))
             {
                 return it;
             }
@@ -18039,7 +18135,7 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
     {
         for (auto it = this->begin(); it != this->end(); ++it)
         {
-            if (it->first == value.first)
+            if (m_compare(it->first, value.first))
             {
                 return {it, false};
             }
@@ -18060,6 +18156,9 @@ template <class Key, class T, class IgnoredLess = std::less<Key>,
             insert(*it);
         }
     }
+
+private:
+    JSON_NO_UNIQUE_ADDRESS key_compare m_compare = key_compare();
 };
 
 }  // namespace nlohmann
@@ -18321,21 +18420,23 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// the template arguments passed to class @ref basic_json.
     /// @{
 
-    /// @brief object key comparator type
-    /// @sa https://json.nlohmann.me/api/basic_json/object_comparator_t/
+    /// @brief default object key comparator type
+    /// The actual object key comparator type (@ref object_comparator_t) may be
+    /// different.
+    /// @sa https://json.nlohmann.me/api/basic_json/default_object_comparator_t/
 #if defined(JSON_HAS_CPP_14)
-    // Use transparent comparator if possible, combined with perfect forwarding
-    // on find() and count() calls prevents unnecessary string construction.
-    using object_comparator_t = std::less<>;
+    // use of transparent comparator avoids unnecessary repeated construction of temporaries
+    // in functions involving lookup by key with types other than object_t::key_type (aka. StringType)
+    using default_object_comparator_t = std::less<>;
 #else
-    using object_comparator_t = std::less<StringType>;
+    using default_object_comparator_t = std::less<StringType>;
 #endif
 
     /// @brief a type for an object
     /// @sa https://json.nlohmann.me/api/basic_json/object_t/
     using object_t = ObjectType<StringType,
           basic_json,
-          object_comparator_t,
+          default_object_comparator_t,
           AllocatorType<std::pair<const StringType,
           basic_json>>>;
 
@@ -18367,6 +18468,10 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// @sa https://json.nlohmann.me/api/basic_json/binary_t/
     using binary_t = nlohmann::byte_container_with_subtype<BinaryType>;
 
+    /// @brief object key comparator type
+    /// @sa https://json.nlohmann.me/api/basic_json/object_comparator_t/
+    using object_comparator_t = detail::actual_object_comparator_t<basic_json>;
+
     /// @}
 
   private:
@@ -19971,22 +20076,37 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     reference at(const typename object_t::key_type& key)
     {
         // at only works for objects
-        if (JSON_HEDLEY_LIKELY(is_object()))
-        {
-            JSON_TRY
-            {
-                return set_parent(m_value.object->at(key));
-            }
-            JSON_CATCH (std::out_of_range&)
-            {
-                // create better exception explanation
-                JSON_THROW(out_of_range::create(403, detail::concat("key '", key, "' not found"), this));
-            }
-        }
-        else
+        if (JSON_HEDLEY_UNLIKELY(!is_object()))
         {
             JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
         }
+
+        auto it = m_value.object->find(key);
+        if (it == m_value.object->end())
+        {
+            JSON_THROW(out_of_range::create(403, detail::concat("key '", key, "' not found"), this));
+        }
+        return set_parent(it->second);
+    }
+
+    /// @brief access specified object element with bounds checking
+    /// @sa https://json.nlohmann.me/api/basic_json/at/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int> = 0>
+    reference at(KeyType && key)
+    {
+        // at only works for objects
+        if (JSON_HEDLEY_UNLIKELY(!is_object()))
+        {
+            JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
+        }
+
+        auto it = m_value.object->find(std::forward<KeyType>(key));
+        if (it == m_value.object->end())
+        {
+            JSON_THROW(out_of_range::create(403, detail::concat("key '", string_t(std::forward<KeyType>(key)), "' not found"), this));
+        }
+        return set_parent(it->second);
     }
 
     /// @brief access specified object element with bounds checking
@@ -19994,22 +20114,37 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     const_reference at(const typename object_t::key_type& key) const
     {
         // at only works for objects
-        if (JSON_HEDLEY_LIKELY(is_object()))
-        {
-            JSON_TRY
-            {
-                return m_value.object->at(key);
-            }
-            JSON_CATCH (std::out_of_range&)
-            {
-                // create better exception explanation
-                JSON_THROW(out_of_range::create(403, detail::concat("key '", key, "' not found"), this));
-            }
-        }
-        else
+        if (JSON_HEDLEY_UNLIKELY(!is_object()))
         {
             JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
         }
+
+        auto it = m_value.object->find(key);
+        if (it == m_value.object->end())
+        {
+            JSON_THROW(out_of_range::create(403, detail::concat("key '", key, "' not found"), this));
+        }
+        return it->second;
+    }
+
+    /// @brief access specified object element with bounds checking
+    /// @sa https://json.nlohmann.me/api/basic_json/at/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int> = 0>
+    const_reference at(KeyType && key) const
+    {
+        // at only works for objects
+        if (JSON_HEDLEY_UNLIKELY(!is_object()))
+        {
+            JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
+        }
+
+        auto it = m_value.object->find(std::forward<KeyType>(key));
+        if (it == m_value.object->end())
+        {
+            JSON_THROW(out_of_range::create(403, detail::concat("key '", string_t(std::forward<KeyType>(key)), "' not found"), this));
+        }
+        return it->second;
     }
 
     /// @brief access specified array element
@@ -20073,7 +20208,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief access specified object element
     /// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
-    reference operator[](const typename object_t::key_type& key)
+    reference operator[](typename object_t::key_type key)
     {
         // implicitly convert null value to an empty object
         if (is_null())
@@ -20086,7 +20221,8 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         // operator[] only works for objects
         if (JSON_HEDLEY_LIKELY(is_object()))
         {
-            return set_parent(m_value.object->operator[](key));
+            auto result = m_value.object->emplace(std::move(key), nullptr);
+            return set_parent(result.first->second);
         }
 
         JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a string argument with ", type_name()), this));
@@ -20099,31 +20235,47 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         // const operator[] only works for objects
         if (JSON_HEDLEY_LIKELY(is_object()))
         {
-            JSON_ASSERT(m_value.object->find(key) != m_value.object->end());
-            return m_value.object->find(key)->second;
+            auto it = m_value.object->find(key);
+            JSON_ASSERT(it != m_value.object->end());
+            return it->second;
         }
 
         JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a string argument with ", type_name()), this));
     }
 
-    /// @brief access specified object element
-    /// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
+    // these two functions resolve a (const) char * ambiguity affecting Clang and MSVC
+    // (they seemingly cannot be constrained to resolve the ambiguity)
     template<typename T>
-    JSON_HEDLEY_NON_NULL(2)
     reference operator[](T* key)
     {
-        // implicitly convert null to object
+        return operator[](typename object_t::key_type(key));
+    }
+
+    template<typename T>
+    const_reference operator[](T* key) const
+    {
+        return operator[](typename object_t::key_type(key));
+    }
+
+    /// @brief access specified object element
+    /// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int > = 0 >
+    reference operator[](KeyType && key)
+    {
+        // implicitly convert null value to an empty object
         if (is_null())
         {
             m_type = value_t::object;
-            m_value = value_t::object;
+            m_value.object = create<object_t>();
             assert_invariant();
         }
 
-        // at only works for objects
+        // operator[] only works for objects
         if (JSON_HEDLEY_LIKELY(is_object()))
         {
-            return set_parent(m_value.object->operator[](key));
+            auto result = m_value.object->emplace(std::forward<KeyType>(key), nullptr);
+            return set_parent(result.first->second);
         }
 
         JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a string argument with ", type_name()), this));
@@ -20131,15 +20283,16 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief access specified object element
     /// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
-    template<typename T>
-    JSON_HEDLEY_NON_NULL(2)
-    const_reference operator[](T* key) const
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int > = 0 >
+    const_reference operator[](KeyType && key) const
     {
-        // at only works for objects
+        // const operator[] only works for objects
         if (JSON_HEDLEY_LIKELY(is_object()))
         {
-            JSON_ASSERT(m_value.object->find(key) != m_value.object->end());
-            return m_value.object->find(key)->second;
+            auto it = m_value.object->find(std::forward<KeyType>(key));
+            JSON_ASSERT(it != m_value.object->end());
+            return it->second;
         }
 
         JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a string argument with ", type_name()), this));
@@ -20147,23 +20300,24 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief access specified object element with default value
     /// @sa https://json.nlohmann.me/api/basic_json/value/
-    /// using std::is_convertible in a std::enable_if will fail when using explicit conversions
-    template < class ValueType, typename std::enable_if <
-                   detail::is_getable<basic_json_t, ValueType>::value
-                   && !std::is_same<value_t, ValueType>::value, int >::type = 0 >
-    ValueType value(const typename object_t::key_type& key, const ValueType& default_value) const
+    // this is the value(const typename object_t::key_type&) overload
+    template < class KeyType, class ValueType, detail::enable_if_t <
+                   std::is_same<KeyType, typename object_t::key_type>::value
+                   && detail::is_getable<basic_json_t, ValueType>::value
+                   && !std::is_same<value_t, ValueType>::value, int > = 0 >
+    typename std::decay<ValueType>::type value(const KeyType& key, ValueType && default_value) const
     {
-        // at only works for objects
+        // value only works for objects
         if (JSON_HEDLEY_LIKELY(is_object()))
         {
             // if key is found, return value and given default value otherwise
             const auto it = find(key);
             if (it != end())
             {
-                return it->template get<ValueType>();
+                return it->template get<typename std::decay<ValueType>::type>();
             }
 
-            return default_value;
+            return std::forward<ValueType>(default_value);
         }
 
         JSON_THROW(type_error::create(306, detail::concat("cannot use value() with ", type_name()), this));
@@ -20177,13 +20331,64 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         return value(key, string_t(default_value));
     }
 
+    // these two functions, in conjunction with value(const KeyType &, ValueType &&),
+    // resolve an ambiguity that would otherwise occur between the json_pointer and
+    // typename object_t::key_type & overloads
+    template < class ValueType, detail::enable_if_t <
+                   detail::is_getable<basic_json_t, ValueType>::value
+                   && !std::is_same<value_t, ValueType>::value, int > = 0 >
+    typename std::decay<ValueType>::type value(const char* key, ValueType && default_value) const
+    {
+        return value(typename object_t::key_type(key), std::forward<ValueType>(default_value));
+    }
+
+    string_t value(const char* key, const char* default_value) const
+    {
+        return value(typename object_t::key_type(key), string_t(default_value));
+    }
+
+    /// @brief access specified object element with default value
+    /// @sa https://json.nlohmann.me/api/basic_json/value/
+    /// using std::is_convertible in a std::enable_if will fail when using explicit conversions
+    template < class KeyType, class ValueType, detail::enable_if_t <
+                   detail::is_getable<basic_json_t, ValueType>::value
+                   && !std::is_same<value_t, ValueType>::value
+                   && detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int > = 0 >
+    typename std::decay<ValueType>::type value(KeyType && key, ValueType && default_value) const
+    {
+        // value only works for objects
+        if (JSON_HEDLEY_LIKELY(is_object()))
+        {
+            // if key is found, return value and given default value otherwise
+            const auto it = find(std::forward<KeyType>(key));
+            if (it != end())
+            {
+                return it->template get<typename std::decay<ValueType>::type>();
+            }
+
+            return std::forward<ValueType>(default_value);
+        }
+
+        JSON_THROW(type_error::create(306, detail::concat("cannot use value() with ", type_name()), this));
+    }
+
+    /// @brief access specified object element with default value
+    /// @sa https://json.nlohmann.me/api/basic_json/value/
+    /// overload for a default value of type const char*
+    template < class KeyType, detail::enable_if_t <
+                   !detail::is_json_pointer<KeyType>::value, int > = 0 >
+    string_t value(KeyType && key, const char* default_value) const
+    {
+        return value(std::forward<KeyType>(key), string_t(default_value));
+    }
+
     /// @brief access specified object element via JSON Pointer with default value
     /// @sa https://json.nlohmann.me/api/basic_json/value/
-    template<class ValueType, typename std::enable_if<
-                 detail::is_getable<basic_json_t, ValueType>::value, int>::type = 0>
+    template < class ValueType, detail::enable_if_t <
+                   detail::is_getable<basic_json_t, ValueType>::value, int> = 0 >
     ValueType value(const json_pointer& ptr, const ValueType& default_value) const
     {
-        // at only works for objects
+        // value only works for objects
         if (JSON_HEDLEY_LIKELY(is_object()))
         {
             // if pointer resolves a value, return it or use default value
@@ -20200,8 +20405,8 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         JSON_THROW(type_error::create(306, detail::concat("cannot use value() with ", type_name()), this));
     }
 
-    template<class ValueType, class BasicJsonType, typename std::enable_if<
-                 detail::is_getable<basic_json_t, ValueType>::value, int>::type = 0>
+    template < class ValueType, class BasicJsonType, detail::enable_if_t <
+                   detail::is_getable<basic_json_t, ValueType>::value, int> = 0 >
     JSON_HEDLEY_DEPRECATED_FOR(3.11.0, basic_json::json_pointer or nlohmann::json_pointer<basic_json::string_t>) // NOLINT(readability/alt_tokens)
     ValueType value(const ::nlohmann::json_pointer<BasicJsonType>& ptr, const ValueType& default_value) const
     {
@@ -20259,10 +20464,9 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief remove element given an iterator
     /// @sa https://json.nlohmann.me/api/basic_json/erase/
-    template < class IteratorType, typename std::enable_if <
+    template < class IteratorType, detail::enable_if_t <
                    std::is_same<IteratorType, typename basic_json_t::iterator>::value ||
-                   std::is_same<IteratorType, typename basic_json_t::const_iterator>::value, int >::type
-               = 0 >
+                   std::is_same<IteratorType, typename basic_json_t::const_iterator>::value, int > = 0 >
     IteratorType erase(IteratorType pos)
     {
         // make sure iterator fits the current value
@@ -20330,10 +20534,9 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief remove elements given an iterator range
     /// @sa https://json.nlohmann.me/api/basic_json/erase/
-    template < class IteratorType, typename std::enable_if <
+    template < class IteratorType, detail::enable_if_t <
                    std::is_same<IteratorType, typename basic_json_t::iterator>::value ||
-                   std::is_same<IteratorType, typename basic_json_t::const_iterator>::value, int >::type
-               = 0 >
+                   std::is_same<IteratorType, typename basic_json_t::const_iterator>::value, int > = 0 >
     IteratorType erase(IteratorType first, IteratorType last)
     {
         // make sure iterator fits the current value
@@ -20402,17 +20605,57 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         return result;
     }
 
+  private:
+    template < typename KeyType, detail::enable_if_t <
+                   detail::has_erase_with_key_type<basic_json_t, KeyType>::value, int > = 0 >
+    size_type erase_internal(KeyType && key)
+    {
+        // this erase only works for objects
+        if (JSON_HEDLEY_UNLIKELY(!is_object()))
+        {
+            JSON_THROW(type_error::create(307, detail::concat("cannot use erase() with ", type_name()), this));
+        }
+
+        return m_value.object->erase(std::forward<KeyType>(key));
+    }
+
+    template < typename KeyType, detail::enable_if_t <
+                   !detail::has_erase_with_key_type<basic_json_t, KeyType>::value, int > = 0 >
+    size_type erase_internal(KeyType && key)
+    {
+        // this erase only works for objects
+        if (JSON_HEDLEY_UNLIKELY(!is_object()))
+        {
+            JSON_THROW(type_error::create(307, detail::concat("cannot use erase() with ", type_name()), this));
+        }
+
+        const auto it = m_value.object->find(std::forward<KeyType>(key));
+        if (it != m_value.object->end())
+        {
+            m_value.object->erase(it);
+            return 1;
+        }
+        return 0;
+    }
+
+  public:
+
     /// @brief remove element from a JSON object given a key
     /// @sa https://json.nlohmann.me/api/basic_json/erase/
     size_type erase(const typename object_t::key_type& key)
     {
-        // this erase only works for objects
-        if (JSON_HEDLEY_LIKELY(is_object()))
-        {
-            return m_value.object->erase(key);
-        }
+        // the indirection via erase_internal() is added to avoid making this
+        // function a template and thus de-rank it during overload resolution
+        return erase_internal(key);
+    }
 
-        JSON_THROW(type_error::create(307, detail::concat("cannot use erase() with ", type_name()), this));
+    /// @brief remove element from a JSON object given a key
+    /// @sa https://json.nlohmann.me/api/basic_json/erase/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int> = 0>
+    size_type erase(KeyType && key)
+    {
+        return erase_internal(std::forward<KeyType>(key));
     }
 
     /// @brief remove element from a JSON array given an index
@@ -20447,14 +20690,13 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief find an element in a JSON object
     /// @sa https://json.nlohmann.me/api/basic_json/find/
-    template<typename KeyT>
-    iterator find(KeyT&& key)
+    iterator find(const typename object_t::key_type& key)
     {
         auto result = end();
 
         if (is_object())
         {
-            result.m_it.object_iterator = m_value.object->find(std::forward<KeyT>(key));
+            result.m_it.object_iterator = m_value.object->find(key);
         }
 
         return result;
@@ -20462,14 +20704,45 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief find an element in a JSON object
     /// @sa https://json.nlohmann.me/api/basic_json/find/
-    template<typename KeyT>
-    const_iterator find(KeyT&& key) const
+    const_iterator find(const typename object_t::key_type& key) const
     {
         auto result = cend();
 
         if (is_object())
         {
-            result.m_it.object_iterator = m_value.object->find(std::forward<KeyT>(key));
+            result.m_it.object_iterator = m_value.object->find(key);
+        }
+
+        return result;
+    }
+
+    /// @brief find an element in a JSON object
+    /// @sa https://json.nlohmann.me/api/basic_json/find/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int> = 0>
+    iterator find(KeyType && key)
+    {
+        auto result = end();
+
+        if (is_object())
+        {
+            result.m_it.object_iterator = m_value.object->find(std::forward<KeyType>(key));
+        }
+
+        return result;
+    }
+
+    /// @brief find an element in a JSON object
+    /// @sa https://json.nlohmann.me/api/basic_json/find/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int> = 0>
+    const_iterator find(KeyType && key) const
+    {
+        auto result = cend();
+
+        if (is_object())
+        {
+            result.m_it.object_iterator = m_value.object->find(std::forward<KeyType>(key));
         }
 
         return result;
@@ -20477,20 +20750,36 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @brief returns the number of occurrences of a key in a JSON object
     /// @sa https://json.nlohmann.me/api/basic_json/count/
-    template<typename KeyT>
-    size_type count(KeyT&& key) const
+    size_type count(const typename object_t::key_type& key) const
     {
         // return 0 for all nonobject types
-        return is_object() ? m_value.object->count(std::forward<KeyT>(key)) : 0;
+        return is_object() ? m_value.object->count(key) : 0;
+    }
+
+    /// @brief returns the number of occurrences of a key in a JSON object
+    /// @sa https://json.nlohmann.me/api/basic_json/count/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int> = 0>
+    size_type count(KeyType && key) const
+    {
+        // return 0 for all nonobject types
+        return is_object() ? m_value.object->count(std::forward<KeyType>(key)) : 0;
     }
 
     /// @brief check the existence of an element in a JSON object
     /// @sa https://json.nlohmann.me/api/basic_json/contains/
-    template < typename KeyT, typename std::enable_if <
-                   !detail::is_json_pointer<typename std::decay<KeyT>::type>::value, int >::type = 0 >
-    bool contains(KeyT && key) const
+    bool contains(const typename object_t::key_type& key) const
     {
-        return is_object() && m_value.object->find(std::forward<KeyT>(key)) != m_value.object->end();
+        return is_object() && m_value.object->find(key) != m_value.object->end();
+    }
+
+    /// @brief check the existence of an element in a JSON object
+    /// @sa https://json.nlohmann.me/api/basic_json/contains/
+    template<class KeyType, detail::enable_if_t<
+                 detail::is_usable_as_key_type<basic_json_t, KeyType>::value, int> = 0>
+    bool contains(KeyType && key) const
+    {
+        return is_object() && m_value.object->find(std::forward<KeyType>(key)) != m_value.object->end();
     }
 
     /// @brief check the existence of an element in a JSON object given a JSON pointer
@@ -22276,7 +22565,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         return ptr.get_unchecked(this);
     }
 
-    template<typename BasicJsonType>
+    template<typename BasicJsonType, detail::enable_if_t<detail::is_basic_json<BasicJsonType>::value, int> = 0>
     JSON_HEDLEY_DEPRECATED_FOR(3.11.0, basic_json::json_pointer or nlohmann::json_pointer<basic_json::string_t>) // NOLINT(readability/alt_tokens)
     reference operator[](const ::nlohmann::json_pointer<BasicJsonType>& ptr)
     {
@@ -22290,7 +22579,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         return ptr.get_unchecked(this);
     }
 
-    template<typename BasicJsonType>
+    template<typename BasicJsonType, detail::enable_if_t<detail::is_basic_json<BasicJsonType>::value, int> = 0>
     JSON_HEDLEY_DEPRECATED_FOR(3.11.0, basic_json::json_pointer or nlohmann::json_pointer<basic_json::string_t>) // NOLINT(readability/alt_tokens)
     const_reference operator[](const ::nlohmann::json_pointer<BasicJsonType>& ptr) const
     {
@@ -22892,6 +23181,7 @@ inline nlohmann::json::json_pointer operator "" _json_pointer(const char* s, std
 #undef NLOHMANN_BASIC_JSON_TPL
 #undef JSON_EXPLICIT
 #undef NLOHMANN_CAN_CALL_STD_FUNC_IMPL
+#undef JSON_NO_UNIQUE_ADDRESS
 
 #ifndef JSON_TEST_KEEP_MACROS
     #undef JSON_CATCH
diff --git a/test/src/unit-element_access2.cpp b/test/src/unit-element_access2.cpp
index 94e0df42d..11daba145 100644
--- a/test/src/unit-element_access2.cpp
+++ b/test/src/unit-element_access2.cpp
@@ -60,12 +60,38 @@ TEST_CASE("element access 2")
                 CHECK(j_const.at("floating") == json(42.23));
                 CHECK(j_const.at("object") == json::object());
                 CHECK(j_const.at("array") == json({1, 2, 3}));
+
+#ifdef JSON_HAS_CPP_17
+                CHECK(j.at(std::string_view("integer")) == json(1));
+                CHECK(j.at(std::string_view("unsigned")) == json(1u));
+                CHECK(j.at(std::string_view("boolean")) == json(true));
+                CHECK(j.at(std::string_view("null")) == json(nullptr));
+                CHECK(j.at(std::string_view("string")) == json("hello world"));
+                CHECK(j.at(std::string_view("floating")) == json(42.23));
+                CHECK(j.at(std::string_view("object")) == json::object());
+                CHECK(j.at(std::string_view("array")) == json({1, 2, 3}));
+
+                CHECK(j_const.at(std::string_view("integer")) == json(1));
+                CHECK(j_const.at(std::string_view("unsigned")) == json(1u));
+                CHECK(j_const.at(std::string_view("boolean")) == json(true));
+                CHECK(j_const.at(std::string_view("null")) == json(nullptr));
+                CHECK(j_const.at(std::string_view("string")) == json("hello world"));
+                CHECK(j_const.at(std::string_view("floating")) == json(42.23));
+                CHECK(j_const.at(std::string_view("object")) == json::object());
+                CHECK(j_const.at(std::string_view("array")) == json({1, 2, 3}));
+#endif
             }
 
             SECTION("access outside bounds")
             {
                 CHECK_THROWS_WITH_AS(j.at("foo"), "[json.exception.out_of_range.403] key 'foo' not found", json::out_of_range&);
                 CHECK_THROWS_WITH_AS(j_const.at("foo"), "[json.exception.out_of_range.403] key 'foo' not found", json::out_of_range&);
+
+
+#ifdef JSON_HAS_CPP_17
+                CHECK_THROWS_WITH_AS(j.at(std::string_view("foo")), "[json.exception.out_of_range.403] key 'foo' not found", json::out_of_range&);
+                CHECK_THROWS_WITH_AS(j_const.at(std::string_view("foo")), "[json.exception.out_of_range.403] key 'foo' not found", json::out_of_range&);
+#endif
             }
 
             SECTION("access on non-object type")
@@ -76,6 +102,11 @@ TEST_CASE("element access 2")
                     const json j_nonobject_const(j_nonobject);
                     CHECK_THROWS_WITH_AS(j_nonobject.at("foo"), "[json.exception.type_error.304] cannot use at() with null", json::type_error&);
                     CHECK_THROWS_WITH_AS(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with null", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject.at(std::string_view(std::string_view("foo"))), "[json.exception.type_error.304] cannot use at() with null", json::type_error&);
+                    CHECK_THROWS_WITH_AS(j_nonobject_const.at(std::string_view(std::string_view("foo"))), "[json.exception.type_error.304] cannot use at() with null", json::type_error&);
+#endif
                 }
 
                 SECTION("boolean")
@@ -84,6 +115,11 @@ TEST_CASE("element access 2")
                     const json j_nonobject_const(j_nonobject);
                     CHECK_THROWS_WITH_AS(j_nonobject.at("foo"), "[json.exception.type_error.304] cannot use at() with boolean", json::type_error&);
                     CHECK_THROWS_WITH_AS(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with boolean", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject.at(std::string_view("foo")), "[json.exception.type_error.304] cannot use at() with boolean", json::type_error&);
+                    CHECK_THROWS_WITH_AS(j_nonobject_const.at(std::string_view("foo")), "[json.exception.type_error.304] cannot use at() with boolean", json::type_error&);
+#endif
                 }
 
                 SECTION("string")
@@ -92,6 +128,11 @@ TEST_CASE("element access 2")
                     const json j_nonobject_const(j_nonobject);
                     CHECK_THROWS_WITH_AS(j_nonobject.at("foo"), "[json.exception.type_error.304] cannot use at() with string", json::type_error&);
                     CHECK_THROWS_WITH_AS(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with string", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject.at(std::string_view("foo")), "[json.exception.type_error.304] cannot use at() with string", json::type_error&);
+                    CHECK_THROWS_WITH_AS(j_nonobject_const.at(std::string_view("foo")), "[json.exception.type_error.304] cannot use at() with string", json::type_error&);
+#endif
                 }
 
                 SECTION("array")
@@ -100,6 +141,11 @@ TEST_CASE("element access 2")
                     const json j_nonobject_const(j_nonobject);
                     CHECK_THROWS_WITH_AS(j_nonobject.at("foo"), "[json.exception.type_error.304] cannot use at() with array", json::type_error&);
                     CHECK_THROWS_WITH_AS(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with array", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject.at(std::string_view("foo")), "[json.exception.type_error.304] cannot use at() with array", json::type_error&);
+                    CHECK_THROWS_WITH_AS(j_nonobject_const.at(std::string_view("foo")), "[json.exception.type_error.304] cannot use at() with array", json::type_error&);
+#endif
                 }
 
                 SECTION("number (integer)")
@@ -108,6 +154,11 @@ TEST_CASE("element access 2")
                     const json j_nonobject_const(j_nonobject);
                     CHECK_THROWS_WITH_AS(j_nonobject.at("foo"), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
                     CHECK_THROWS_WITH_AS(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject.at(std::string_view("foo")), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+                    CHECK_THROWS_WITH_AS(j_nonobject_const.at(std::string_view("foo")), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+#endif
                 }
 
                 SECTION("number (unsigned)")
@@ -116,6 +167,11 @@ TEST_CASE("element access 2")
                     const json j_nonobject_const(j_nonobject);
                     CHECK_THROWS_WITH_AS(j_nonobject.at("foo"), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
                     CHECK_THROWS_WITH_AS(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject.at(std::string_view("foo")), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+                    CHECK_THROWS_WITH_AS(j_nonobject_const.at(std::string_view("foo")), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+#endif
                 }
 
                 SECTION("number (floating-point)")
@@ -124,6 +180,11 @@ TEST_CASE("element access 2")
                     const json j_nonobject_const(j_nonobject);
                     CHECK_THROWS_WITH_AS(j_nonobject.at("foo"), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
                     CHECK_THROWS_WITH_AS(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject.at(std::string_view("foo")), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+                    CHECK_THROWS_WITH_AS(j_nonobject_const.at(std::string_view("foo")), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+#endif
                 }
             }
         }
@@ -158,6 +219,33 @@ TEST_CASE("element access 2")
                     CHECK(j_const.value("floating", 12) == 42);
                     CHECK(j_const.value("object", json({{"foo", "bar"}})) == json::object());
                     CHECK(j_const.value("array", json({10, 100})) == json({1, 2, 3}));
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j.value(std::string_view("integer"), 2) == 1);
+                    CHECK(j.value(std::string_view("integer"), 1.0) == Approx(1));
+                    CHECK(j.value(std::string_view("unsigned"), 2) == 1u);
+                    CHECK(j.value(std::string_view("unsigned"), 1.0) == Approx(1u));
+                    CHECK(j.value(std::string_view("null"), json(1)) == json());
+                    CHECK(j.value(std::string_view("boolean"), false) == true);
+                    CHECK(j.value(std::string_view("string"), "bar") == "hello world");
+                    CHECK(j.value(std::string_view("string"), std::string("bar")) == "hello world");
+                    CHECK(j.value(std::string_view("floating"), 12.34) == Approx(42.23));
+                    CHECK(j.value(std::string_view("floating"), 12) == 42);
+                    CHECK(j.value(std::string_view("object"), json({{"foo", "bar"}})) == json::object());
+                    CHECK(j.value(std::string_view("array"), json({10, 100})) == json({1, 2, 3}));
+
+                    CHECK(j_const.value(std::string_view("integer"), 2) == 1);
+                    CHECK(j_const.value(std::string_view("integer"), 1.0) == Approx(1));
+                    CHECK(j_const.value(std::string_view("unsigned"), 2) == 1u);
+                    CHECK(j_const.value(std::string_view("unsigned"), 1.0) == Approx(1u));
+                    CHECK(j_const.value(std::string_view("boolean"), false) == true);
+                    CHECK(j_const.value(std::string_view("string"), "bar") == "hello world");
+                    CHECK(j_const.value(std::string_view("string"), std::string("bar")) == "hello world");
+                    CHECK(j_const.value(std::string_view("floating"), 12.34) == Approx(42.23));
+                    CHECK(j_const.value(std::string_view("floating"), 12) == 42);
+                    CHECK(j_const.value(std::string_view("object"), json({{"foo", "bar"}})) == json::object());
+                    CHECK(j_const.value(std::string_view("array"), json({10, 100})) == json({1, 2, 3}));
+#endif
                 }
 
                 SECTION("access non-existing value")
@@ -177,6 +265,24 @@ TEST_CASE("element access 2")
                     CHECK(j_const.value("_", 12.34) == Approx(12.34));
                     CHECK(j_const.value("_", json({{"foo", "bar"}})) == json({{"foo", "bar"}}));
                     CHECK(j_const.value("_", json({10, 100})) == json({10, 100}));
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j.value(std::string_view("_"), 2) == 2);
+                    CHECK(j.value(std::string_view("_"), 2u) == 2u);
+                    CHECK(j.value(std::string_view("_"), false) == false);
+                    CHECK(j.value(std::string_view("_"), "bar") == "bar");
+                    CHECK(j.value(std::string_view("_"), 12.34) == Approx(12.34));
+                    CHECK(j.value(std::string_view("_"), json({{"foo", "bar"}})) == json({{"foo", "bar"}}));
+                    CHECK(j.value(std::string_view("_"), json({10, 100})) == json({10, 100}));
+
+                    CHECK(j_const.value(std::string_view("_"), 2) == 2);
+                    CHECK(j_const.value(std::string_view("_"), 2u) == 2u);
+                    CHECK(j_const.value(std::string_view("_"), false) == false);
+                    CHECK(j_const.value(std::string_view("_"), "bar") == "bar");
+                    CHECK(j_const.value(std::string_view("_"), 12.34) == Approx(12.34));
+                    CHECK(j_const.value(std::string_view("_"), json({{"foo", "bar"}})) == json({{"foo", "bar"}}));
+                    CHECK(j_const.value(std::string_view("_"), json({10, 100})) == json({10, 100}));
+#endif
                 }
 
                 SECTION("access on non-object type")
@@ -187,6 +293,11 @@ TEST_CASE("element access 2")
                         const json j_nonobject_const(json::value_t::null);
                         CHECK_THROWS_WITH_AS(j_nonobject.value("foo", 1), "[json.exception.type_error.306] cannot use value() with null", json::type_error&);
                         CHECK_THROWS_WITH_AS(j_nonobject_const.value("foo", 1), "[json.exception.type_error.306] cannot use value() with null", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                        CHECK_THROWS_WITH_AS(j_nonobject.value(std::string_view("foo"), 1), "[json.exception.type_error.306] cannot use value() with null", json::type_error&);
+                        CHECK_THROWS_WITH_AS(j_nonobject_const.value(std::string_view("foo"), 1), "[json.exception.type_error.306] cannot use value() with null", json::type_error&);
+#endif
                     }
 
                     SECTION("boolean")
@@ -195,6 +306,11 @@ TEST_CASE("element access 2")
                         const json j_nonobject_const(json::value_t::boolean);
                         CHECK_THROWS_WITH_AS(j_nonobject.value("foo", 1), "[json.exception.type_error.306] cannot use value() with boolean", json::type_error&);
                         CHECK_THROWS_WITH_AS(j_nonobject_const.value("foo", 1), "[json.exception.type_error.306] cannot use value() with boolean", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                        CHECK_THROWS_WITH_AS(j_nonobject.value(std::string_view("foo"), 1), "[json.exception.type_error.306] cannot use value() with boolean", json::type_error&);
+                        CHECK_THROWS_WITH_AS(j_nonobject_const.value(std::string_view("foo"), 1), "[json.exception.type_error.306] cannot use value() with boolean", json::type_error&);
+#endif
                     }
 
                     SECTION("string")
@@ -203,6 +319,11 @@ TEST_CASE("element access 2")
                         const json j_nonobject_const(json::value_t::string);
                         CHECK_THROWS_WITH_AS(j_nonobject.value("foo", 1), "[json.exception.type_error.306] cannot use value() with string", json::type_error&);
                         CHECK_THROWS_WITH_AS(j_nonobject_const.value("foo", 1), "[json.exception.type_error.306] cannot use value() with string", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                        CHECK_THROWS_WITH_AS(j_nonobject.value(std::string_view("foo"), 1), "[json.exception.type_error.306] cannot use value() with string", json::type_error&);
+                        CHECK_THROWS_WITH_AS(j_nonobject_const.value(std::string_view("foo"), 1), "[json.exception.type_error.306] cannot use value() with string", json::type_error&);
+#endif
                     }
 
                     SECTION("array")
@@ -211,6 +332,11 @@ TEST_CASE("element access 2")
                         const json j_nonobject_const(json::value_t::array);
                         CHECK_THROWS_WITH_AS(j_nonobject.value("foo", 1), "[json.exception.type_error.306] cannot use value() with array", json::type_error&);
                         CHECK_THROWS_WITH_AS(j_nonobject_const.value("foo", 1), "[json.exception.type_error.306] cannot use value() with array", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                        CHECK_THROWS_WITH_AS(j_nonobject.value(std::string_view("foo"), 1), "[json.exception.type_error.306] cannot use value() with array", json::type_error&);
+                        CHECK_THROWS_WITH_AS(j_nonobject_const.value(std::string_view("foo"), 1), "[json.exception.type_error.306] cannot use value() with array", json::type_error&);
+#endif
                     }
 
                     SECTION("number (integer)")
@@ -219,6 +345,11 @@ TEST_CASE("element access 2")
                         const json j_nonobject_const(json::value_t::number_integer);
                         CHECK_THROWS_WITH_AS(j_nonobject.value("foo", 1), "[json.exception.type_error.306] cannot use value() with number", json::type_error&);
                         CHECK_THROWS_WITH_AS(j_nonobject_const.value("foo", 1), "[json.exception.type_error.306] cannot use value() with number", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                        CHECK_THROWS_WITH_AS(j_nonobject.value(std::string_view("foo"), 1), "[json.exception.type_error.306] cannot use value() with number", json::type_error&);
+                        CHECK_THROWS_WITH_AS(j_nonobject_const.value(std::string_view("foo"), 1), "[json.exception.type_error.306] cannot use value() with number", json::type_error&);
+#endif
                     }
 
                     SECTION("number (unsigned)")
@@ -227,6 +358,11 @@ TEST_CASE("element access 2")
                         const json j_nonobject_const(json::value_t::number_unsigned);
                         CHECK_THROWS_WITH_AS(j_nonobject.value("foo", 1), "[json.exception.type_error.306] cannot use value() with number", json::type_error&);
                         CHECK_THROWS_WITH_AS(j_nonobject_const.value("foo", 1), "[json.exception.type_error.306] cannot use value() with number", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                        CHECK_THROWS_WITH_AS(j_nonobject.value(std::string_view("foo"), 1), "[json.exception.type_error.306] cannot use value() with number", json::type_error&);
+                        CHECK_THROWS_WITH_AS(j_nonobject_const.value(std::string_view("foo"), 1), "[json.exception.type_error.306] cannot use value() with number", json::type_error&);
+#endif
                     }
 
                     SECTION("number (floating-point)")
@@ -235,6 +371,11 @@ TEST_CASE("element access 2")
                         const json j_nonobject_const(json::value_t::number_float);
                         CHECK_THROWS_WITH_AS(j_nonobject.value("foo", 1), "[json.exception.type_error.306] cannot use value() with number", json::type_error&);
                         CHECK_THROWS_WITH_AS(j_nonobject_const.value("foo", 1), "[json.exception.type_error.306] cannot use value() with number", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                        CHECK_THROWS_WITH_AS(j_nonobject.value(std::string_view("foo"), 1), "[json.exception.type_error.306] cannot use value() with number", json::type_error&);
+                        CHECK_THROWS_WITH_AS(j_nonobject_const.value(std::string_view("foo"), 1), "[json.exception.type_error.306] cannot use value() with number", json::type_error&);
+#endif
                     }
                 }
             }
@@ -330,6 +471,31 @@ TEST_CASE("element access 2")
             }
         }
 
+        SECTION("non-const operator[]")
+        {
+            {
+                json j_null;
+                CHECK(j_null.is_null());
+                j_null["key"] = 1;
+                CHECK(j_null.is_object());
+                CHECK(j_null.size() == 1);
+                j_null["key"] = 2;
+                CHECK(j_null.size() == 1);
+            }
+#ifdef JSON_HAS_CPP_17
+            {
+                std::string_view key = "key";
+                json j_null;
+                CHECK(j_null.is_null());
+                j_null[key] = 1;
+                CHECK(j_null.is_object());
+                CHECK(j_null.size() == 1);
+                j_null[key] = 2;
+                CHECK(j_null.size() == 1);
+            }
+#endif
+        }
+
         SECTION("front and back")
         {
             // "array" is the smallest key
@@ -390,6 +556,56 @@ TEST_CASE("element access 2")
                 CHECK(j_const[json::object_t::key_type("array")] == j["array"]);
             }
 
+#ifdef JSON_HAS_CPP_17
+            SECTION("access within bounds (string_view)")
+            {
+                CHECK(j["integer"] == json(1));
+                CHECK(j[std::string_view("integer")] == j["integer"]);
+
+                CHECK(j["unsigned"] == json(1u));
+                CHECK(j[std::string_view("unsigned")] == j["unsigned"]);
+
+                CHECK(j["boolean"] == json(true));
+                CHECK(j[std::string_view("boolean")] == j["boolean"]);
+
+                CHECK(j["null"] == json(nullptr));
+                CHECK(j[std::string_view("null")] == j["null"]);
+
+                CHECK(j["string"] == json("hello world"));
+                CHECK(j[std::string_view("string")] == j["string"]);
+
+                CHECK(j["floating"] == json(42.23));
+                CHECK(j[std::string_view("floating")] == j["floating"]);
+
+                CHECK(j["object"] == json::object());
+                CHECK(j[std::string_view("object")] == j["object"]);
+
+                CHECK(j["array"] == json({1, 2, 3}));
+                CHECK(j[std::string_view("array")] == j["array"]);
+
+                CHECK(j_const["integer"] == json(1));
+                CHECK(j_const[std::string_view("integer")] == j["integer"]);
+
+                CHECK(j_const["boolean"] == json(true));
+                CHECK(j_const[std::string_view("boolean")] == j["boolean"]);
+
+                CHECK(j_const["null"] == json(nullptr));
+                CHECK(j_const[std::string_view("null")] == j["null"]);
+
+                CHECK(j_const["string"] == json("hello world"));
+                CHECK(j_const[std::string_view("string")] == j["string"]);
+
+                CHECK(j_const["floating"] == json(42.23));
+                CHECK(j_const[std::string_view("floating")] == j["floating"]);
+
+                CHECK(j_const["object"] == json::object());
+                CHECK(j_const[std::string_view("object")] == j["object"]);
+
+                CHECK(j_const["array"] == json({1, 2, 3}));
+                CHECK(j_const[std::string_view("array")] == j["array"]);
+            }
+#endif
+
             SECTION("access on non-object type")
             {
                 SECTION("null")
@@ -397,10 +613,16 @@ TEST_CASE("element access 2")
                     json j_nonobject(json::value_t::null);
                     json j_nonobject2(json::value_t::null);
                     const json j_const_nonobject(j_nonobject);
+
                     CHECK_NOTHROW(j_nonobject["foo"]);
                     CHECK_NOTHROW(j_nonobject2[json::object_t::key_type("foo")]);
                     CHECK_THROWS_WITH_AS(j_const_nonobject["foo"], "[json.exception.type_error.305] cannot use operator[] with a string argument with null", json::type_error&);
                     CHECK_THROWS_WITH_AS(j_const_nonobject[json::object_t::key_type("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with null", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_NOTHROW(j_nonobject2[std::string_view("foo")]);
+                    CHECK_THROWS_WITH_AS(j_const_nonobject[std::string_view("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with null", json::type_error&);
+#endif
                 }
 
                 SECTION("boolean")
@@ -415,6 +637,11 @@ TEST_CASE("element access 2")
                                          "[json.exception.type_error.305] cannot use operator[] with a string argument with boolean", json::type_error&);
                     CHECK_THROWS_WITH_AS(j_const_nonobject[json::object_t::key_type("foo")],
                                          "[json.exception.type_error.305] cannot use operator[] with a string argument with boolean", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject[std::string_view("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with boolean", json::type_error&);
+                    CHECK_THROWS_WITH_AS(j_const_nonobject[std::string_view("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with boolean", json::type_error&);
+#endif
                 }
 
                 SECTION("string")
@@ -429,6 +656,11 @@ TEST_CASE("element access 2")
                                          "[json.exception.type_error.305] cannot use operator[] with a string argument with string", json::type_error&);
                     CHECK_THROWS_WITH_AS(j_const_nonobject[json::object_t::key_type("foo")],
                                          "[json.exception.type_error.305] cannot use operator[] with a string argument with string", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject[std::string_view("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with string", json::type_error&);
+                    CHECK_THROWS_WITH_AS(j_const_nonobject[std::string_view("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with string", json::type_error&);
+#endif
                 }
 
                 SECTION("array")
@@ -442,6 +674,11 @@ TEST_CASE("element access 2")
                                          "[json.exception.type_error.305] cannot use operator[] with a string argument with array", json::type_error&);
                     CHECK_THROWS_WITH_AS(j_const_nonobject[json::object_t::key_type("foo")],
                                          "[json.exception.type_error.305] cannot use operator[] with a string argument with array", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject[std::string_view("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with array", json::type_error&);
+                    CHECK_THROWS_WITH_AS(j_const_nonobject[std::string_view("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with array", json::type_error&);
+#endif
                 }
 
                 SECTION("number (integer)")
@@ -456,6 +693,11 @@ TEST_CASE("element access 2")
                                          "[json.exception.type_error.305] cannot use operator[] with a string argument with number", json::type_error&);
                     CHECK_THROWS_WITH_AS(j_const_nonobject[json::object_t::key_type("foo")],
                                          "[json.exception.type_error.305] cannot use operator[] with a string argument with number", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject[std::string_view("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with number", json::type_error&);
+                    CHECK_THROWS_WITH_AS(j_const_nonobject[std::string_view("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with number", json::type_error&);
+#endif
                 }
 
                 SECTION("number (unsigned)")
@@ -470,6 +712,11 @@ TEST_CASE("element access 2")
                                          "[json.exception.type_error.305] cannot use operator[] with a string argument with number", json::type_error&);
                     CHECK_THROWS_WITH_AS(j_const_nonobject[json::object_t::key_type("foo")],
                                          "[json.exception.type_error.305] cannot use operator[] with a string argument with number", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject[std::string_view("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with number", json::type_error&);
+                    CHECK_THROWS_WITH_AS(j_const_nonobject[std::string_view("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with number", json::type_error&);
+#endif
                 }
 
                 SECTION("number (floating-point)")
@@ -484,6 +731,11 @@ TEST_CASE("element access 2")
                                          "[json.exception.type_error.305] cannot use operator[] with a string argument with number", json::type_error&);
                     CHECK_THROWS_WITH_AS(j_const_nonobject[json::object_t::key_type("foo")],
                                          "[json.exception.type_error.305] cannot use operator[] with a string argument with number", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject[std::string_view("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with number", json::type_error&);
+                    CHECK_THROWS_WITH_AS(j_const_nonobject[std::string_view("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with number", json::type_error&);
+#endif
                 }
             }
         }
@@ -533,6 +785,51 @@ TEST_CASE("element access 2")
                 CHECK(j.erase("array") == 0);
             }
 
+#ifdef JSON_HAS_CPP_17
+            SECTION("remove element by key (string_view)")
+            {
+                CHECK(j.find(std::string_view("integer")) != j.end());
+                CHECK(j.erase(std::string_view("integer")) == 1);
+                CHECK(j.find(std::string_view("integer")) == j.end());
+                CHECK(j.erase(std::string_view("integer")) == 0);
+
+                CHECK(j.find(std::string_view("unsigned")) != j.end());
+                CHECK(j.erase(std::string_view("unsigned")) == 1);
+                CHECK(j.find(std::string_view("unsigned")) == j.end());
+                CHECK(j.erase(std::string_view("unsigned")) == 0);
+
+                CHECK(j.find(std::string_view("boolean")) != j.end());
+                CHECK(j.erase(std::string_view("boolean")) == 1);
+                CHECK(j.find(std::string_view("boolean")) == j.end());
+                CHECK(j.erase(std::string_view("boolean")) == 0);
+
+                CHECK(j.find(std::string_view("null")) != j.end());
+                CHECK(j.erase(std::string_view("null")) == 1);
+                CHECK(j.find(std::string_view("null")) == j.end());
+                CHECK(j.erase(std::string_view("null")) == 0);
+
+                CHECK(j.find(std::string_view("string")) != j.end());
+                CHECK(j.erase(std::string_view("string")) == 1);
+                CHECK(j.find(std::string_view("string")) == j.end());
+                CHECK(j.erase(std::string_view("string")) == 0);
+
+                CHECK(j.find(std::string_view("floating")) != j.end());
+                CHECK(j.erase(std::string_view("floating")) == 1);
+                CHECK(j.find(std::string_view("floating")) == j.end());
+                CHECK(j.erase(std::string_view("floating")) == 0);
+
+                CHECK(j.find(std::string_view("object")) != j.end());
+                CHECK(j.erase(std::string_view("object")) == 1);
+                CHECK(j.find(std::string_view("object")) == j.end());
+                CHECK(j.erase(std::string_view("object")) == 0);
+
+                CHECK(j.find(std::string_view("array")) != j.end());
+                CHECK(j.erase(std::string_view("array")) == 1);
+                CHECK(j.find(std::string_view("array")) == j.end());
+                CHECK(j.erase(std::string_view("array")) == 0);
+            }
+#endif
+
             SECTION("remove element by iterator")
             {
                 SECTION("erase(begin())")
@@ -652,36 +949,60 @@ TEST_CASE("element access 2")
                 {
                     json j_nonobject(json::value_t::null);
                     CHECK_THROWS_WITH_AS(j_nonobject.erase("foo"), "[json.exception.type_error.307] cannot use erase() with null", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject.erase(std::string_view("foo")), "[json.exception.type_error.307] cannot use erase() with null", json::type_error&);
+#endif
                 }
 
                 SECTION("boolean")
                 {
                     json j_nonobject(json::value_t::boolean);
                     CHECK_THROWS_WITH_AS(j_nonobject.erase("foo"), "[json.exception.type_error.307] cannot use erase() with boolean", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject.erase(std::string_view("foo")), "[json.exception.type_error.307] cannot use erase() with boolean", json::type_error&);
+#endif
                 }
 
                 SECTION("string")
                 {
                     json j_nonobject(json::value_t::string);
                     CHECK_THROWS_WITH_AS(j_nonobject.erase("foo"), "[json.exception.type_error.307] cannot use erase() with string", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject.erase(std::string_view("foo")), "[json.exception.type_error.307] cannot use erase() with string", json::type_error&);
+#endif
                 }
 
                 SECTION("array")
                 {
                     json j_nonobject(json::value_t::array);
                     CHECK_THROWS_WITH_AS(j_nonobject.erase("foo"), "[json.exception.type_error.307] cannot use erase() with array", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject.erase(std::string_view("foo")), "[json.exception.type_error.307] cannot use erase() with array", json::type_error&);
+#endif
                 }
 
                 SECTION("number (integer)")
                 {
                     json j_nonobject(json::value_t::number_integer);
                     CHECK_THROWS_WITH_AS(j_nonobject.erase("foo"), "[json.exception.type_error.307] cannot use erase() with number", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject.erase(std::string_view("foo")), "[json.exception.type_error.307] cannot use erase() with number", json::type_error&);
+#endif
                 }
 
                 SECTION("number (floating-point)")
                 {
                     json j_nonobject(json::value_t::number_float);
                     CHECK_THROWS_WITH_AS(j_nonobject.erase("foo"), "[json.exception.type_error.307] cannot use erase() with number", json::type_error&);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK_THROWS_WITH_AS(j_nonobject.erase(std::string_view("foo")), "[json.exception.type_error.307] cannot use erase() with number", json::type_error&);
+#endif
                 }
             }
         }
@@ -699,12 +1020,28 @@ TEST_CASE("element access 2")
                     CHECK(j_const.find(key) != j_const.end());
                     CHECK(*j_const.find(key) == j_const.at(key));
                 }
+#ifdef JSON_HAS_CPP_17
+                for (const std::string_view key :
+                        {"integer", "unsigned", "floating", "null", "string", "boolean", "object", "array"
+                        })
+                {
+                    CHECK(j.find(key) != j.end());
+                    CHECK(*j.find(key) == j.at(key));
+                    CHECK(j_const.find(key) != j_const.end());
+                    CHECK(*j_const.find(key) == j_const.at(key));
+                }
+#endif
             }
 
             SECTION("nonexisting element")
             {
                 CHECK(j.find("foo") == j.end());
                 CHECK(j_const.find("foo") == j_const.end());
+
+#ifdef JSON_HAS_CPP_17
+                CHECK(j.find(std::string_view("foo")) == j.end());
+                CHECK(j_const.find(std::string_view("foo")) == j_const.end());
+#endif
             }
 
             SECTION("all types")
@@ -713,64 +1050,112 @@ TEST_CASE("element access 2")
                 {
                     json j_nonarray(json::value_t::null);
                     const json j_nonarray_const(j_nonarray);
+
                     CHECK(j_nonarray.find("foo") == j_nonarray.end());
                     CHECK(j_nonarray_const.find("foo") == j_nonarray_const.end());
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonarray.find(std::string_view("foo")) == j_nonarray.end());
+                    CHECK(j_nonarray_const.find(std::string_view("foo")) == j_nonarray_const.end());
+#endif
                 }
 
                 SECTION("string")
                 {
                     json j_nonarray(json::value_t::string);
                     const json j_nonarray_const(j_nonarray);
+
                     CHECK(j_nonarray.find("foo") == j_nonarray.end());
                     CHECK(j_nonarray_const.find("foo") == j_nonarray_const.end());
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonarray.find(std::string_view("foo")) == j_nonarray.end());
+                    CHECK(j_nonarray_const.find(std::string_view("foo")) == j_nonarray_const.end());
+#endif
                 }
 
                 SECTION("object")
                 {
                     json j_nonarray(json::value_t::object);
                     const json j_nonarray_const(j_nonarray);
+
                     CHECK(j_nonarray.find("foo") == j_nonarray.end());
                     CHECK(j_nonarray_const.find("foo") == j_nonarray_const.end());
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonarray.find(std::string_view("foo")) == j_nonarray.end());
+                    CHECK(j_nonarray_const.find(std::string_view("foo")) == j_nonarray_const.end());
+#endif
                 }
 
                 SECTION("array")
                 {
                     json j_nonarray(json::value_t::array);
                     const json j_nonarray_const(j_nonarray);
+
                     CHECK(j_nonarray.find("foo") == j_nonarray.end());
                     CHECK(j_nonarray_const.find("foo") == j_nonarray_const.end());
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonarray.find(std::string_view("foo")) == j_nonarray.end());
+                    CHECK(j_nonarray_const.find(std::string_view("foo")) == j_nonarray_const.end());
+#endif
                 }
 
                 SECTION("boolean")
                 {
                     json j_nonarray(json::value_t::boolean);
                     const json j_nonarray_const(j_nonarray);
+
                     CHECK(j_nonarray.find("foo") == j_nonarray.end());
                     CHECK(j_nonarray_const.find("foo") == j_nonarray_const.end());
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonarray.find(std::string_view("foo")) == j_nonarray.end());
+                    CHECK(j_nonarray_const.find(std::string_view("foo")) == j_nonarray_const.end());
+#endif
                 }
 
                 SECTION("number (integer)")
                 {
                     json j_nonarray(json::value_t::number_integer);
                     const json j_nonarray_const(j_nonarray);
+
                     CHECK(j_nonarray.find("foo") == j_nonarray.end());
                     CHECK(j_nonarray_const.find("foo") == j_nonarray_const.end());
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonarray.find(std::string_view("foo")) == j_nonarray.end());
+                    CHECK(j_nonarray_const.find(std::string_view("foo")) == j_nonarray_const.end());
+#endif
                 }
 
                 SECTION("number (unsigned)")
                 {
                     json j_nonarray(json::value_t::number_unsigned);
                     const json j_nonarray_const(j_nonarray);
+
                     CHECK(j_nonarray.find("foo") == j_nonarray.end());
                     CHECK(j_nonarray_const.find("foo") == j_nonarray_const.end());
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonarray.find(std::string_view("foo")) == j_nonarray.end());
+                    CHECK(j_nonarray_const.find(std::string_view("foo")) == j_nonarray_const.end());
+#endif
                 }
 
                 SECTION("number (floating-point)")
                 {
                     json j_nonarray(json::value_t::number_float);
                     const json j_nonarray_const(j_nonarray);
+
                     CHECK(j_nonarray.find("foo") == j_nonarray.end());
                     CHECK(j_nonarray_const.find("foo") == j_nonarray_const.end());
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonarray.find(std::string_view("foo")) == j_nonarray.end());
+                    CHECK(j_nonarray_const.find(std::string_view("foo")) == j_nonarray_const.end());
+#endif
                 }
             }
         }
@@ -786,12 +1171,26 @@ TEST_CASE("element access 2")
                     CHECK(j.count(key) == 1);
                     CHECK(j_const.count(key) == 1);
                 }
+#ifdef JSON_HAS_CPP_17
+                for (const std::string_view key :
+                        {"integer", "unsigned", "floating", "null", "string", "boolean", "object", "array"
+                        })
+                {
+                    CHECK(j.count(key) == 1);
+                    CHECK(j_const.count(key) == 1);
+                }
+#endif
             }
 
             SECTION("nonexisting element")
             {
                 CHECK(j.count("foo") == 0);
                 CHECK(j_const.count("foo") == 0);
+
+#ifdef JSON_HAS_CPP_17
+                CHECK(j.count(std::string_view("foo")) == 0);
+                CHECK(j_const.count(std::string_view("foo")) == 0);
+#endif
             }
 
             SECTION("all types")
@@ -800,64 +1199,112 @@ TEST_CASE("element access 2")
                 {
                     json j_nonobject(json::value_t::null);
                     const json j_nonobject_const(json::value_t::null);
+
                     CHECK(j_nonobject.count("foo") == 0);
                     CHECK(j_nonobject_const.count("foo") == 0);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j.count(std::string_view("foo")) == 0);
+                    CHECK(j_const.count(std::string_view("foo")) == 0);
+#endif
                 }
 
                 SECTION("string")
                 {
                     json j_nonobject(json::value_t::string);
                     const json j_nonobject_const(json::value_t::string);
+
                     CHECK(j_nonobject.count("foo") == 0);
                     CHECK(j_nonobject_const.count("foo") == 0);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j.count(std::string_view("foo")) == 0);
+                    CHECK(j_const.count(std::string_view("foo")) == 0);
+#endif
                 }
 
                 SECTION("object")
                 {
                     json j_nonobject(json::value_t::object);
                     const json j_nonobject_const(json::value_t::object);
+
                     CHECK(j_nonobject.count("foo") == 0);
                     CHECK(j_nonobject_const.count("foo") == 0);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j.count(std::string_view("foo")) == 0);
+                    CHECK(j_const.count(std::string_view("foo")) == 0);
+#endif
                 }
 
                 SECTION("array")
                 {
                     json j_nonobject(json::value_t::array);
                     const json j_nonobject_const(json::value_t::array);
+
                     CHECK(j_nonobject.count("foo") == 0);
                     CHECK(j_nonobject_const.count("foo") == 0);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j.count(std::string_view("foo")) == 0);
+                    CHECK(j_const.count(std::string_view("foo")) == 0);
+#endif
                 }
 
                 SECTION("boolean")
                 {
                     json j_nonobject(json::value_t::boolean);
                     const json j_nonobject_const(json::value_t::boolean);
+
                     CHECK(j_nonobject.count("foo") == 0);
                     CHECK(j_nonobject_const.count("foo") == 0);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j.count(std::string_view("foo")) == 0);
+                    CHECK(j_const.count(std::string_view("foo")) == 0);
+#endif
                 }
 
                 SECTION("number (integer)")
                 {
                     json j_nonobject(json::value_t::number_integer);
                     const json j_nonobject_const(json::value_t::number_integer);
+
                     CHECK(j_nonobject.count("foo") == 0);
                     CHECK(j_nonobject_const.count("foo") == 0);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j.count(std::string_view("foo")) == 0);
+                    CHECK(j_const.count(std::string_view("foo")) == 0);
+#endif
                 }
 
                 SECTION("number (unsigned)")
                 {
                     json j_nonobject(json::value_t::number_unsigned);
                     const json j_nonobject_const(json::value_t::number_unsigned);
+
                     CHECK(j_nonobject.count("foo") == 0);
                     CHECK(j_nonobject_const.count("foo") == 0);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j.count(std::string_view("foo")) == 0);
+                    CHECK(j_const.count(std::string_view("foo")) == 0);
+#endif
                 }
 
                 SECTION("number (floating-point)")
                 {
                     json j_nonobject(json::value_t::number_float);
                     const json j_nonobject_const(json::value_t::number_float);
+
                     CHECK(j_nonobject.count("foo") == 0);
                     CHECK(j_nonobject_const.count("foo") == 0);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j.count(std::string_view("foo")) == 0);
+                    CHECK(j_const.count(std::string_view("foo")) == 0);
+#endif
                 }
             }
         }
@@ -873,12 +1320,27 @@ TEST_CASE("element access 2")
                     CHECK(j.contains(key) == true);
                     CHECK(j_const.contains(key) == true);
                 }
+
+#ifdef JSON_HAS_CPP_17
+                for (const std::string_view key :
+                        {"integer", "unsigned", "floating", "null", "string", "boolean", "object", "array"
+                        })
+                {
+                    CHECK(j.contains(key) == true);
+                    CHECK(j_const.contains(key) == true);
+                }
+#endif
             }
 
             SECTION("nonexisting element")
             {
                 CHECK(j.contains("foo") == false);
                 CHECK(j_const.contains("foo") == false);
+
+#ifdef JSON_HAS_CPP_17
+                CHECK(j.contains(std::string_view("foo")) == false);
+                CHECK(j_const.contains(std::string_view("foo")) == false);
+#endif
             }
 
             SECTION("all types")
@@ -887,56 +1349,98 @@ TEST_CASE("element access 2")
                 {
                     json j_nonobject(json::value_t::null);
                     const json j_nonobject_const(json::value_t::null);
+
                     CHECK(j_nonobject.contains("foo") == false);
                     CHECK(j_nonobject_const.contains("foo") == false);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonobject.contains(std::string_view("foo")) == false);
+                    CHECK(j_nonobject_const.contains(std::string_view("foo")) == false);
+#endif
                 }
 
                 SECTION("string")
                 {
                     json j_nonobject(json::value_t::string);
                     const json j_nonobject_const(json::value_t::string);
+
                     CHECK(j_nonobject.contains("foo") == false);
                     CHECK(j_nonobject_const.contains("foo") == false);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonobject.contains(std::string_view("foo")) == false);
+                    CHECK(j_nonobject_const.contains(std::string_view("foo")) == false);
+#endif
                 }
 
                 SECTION("object")
                 {
                     json j_nonobject(json::value_t::object);
                     const json j_nonobject_const(json::value_t::object);
+
                     CHECK(j_nonobject.contains("foo") == false);
                     CHECK(j_nonobject_const.contains("foo") == false);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonobject.contains(std::string_view("foo")) == false);
+                    CHECK(j_nonobject_const.contains(std::string_view("foo")) == false);
+#endif
                 }
 
                 SECTION("array")
                 {
                     json j_nonobject(json::value_t::array);
                     const json j_nonobject_const(json::value_t::array);
+
                     CHECK(j_nonobject.contains("foo") == false);
                     CHECK(j_nonobject_const.contains("foo") == false);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonobject.contains(std::string_view("foo")) == false);
+                    CHECK(j_nonobject_const.contains(std::string_view("foo")) == false);
+#endif
                 }
 
                 SECTION("boolean")
                 {
                     json j_nonobject(json::value_t::boolean);
                     const json j_nonobject_const(json::value_t::boolean);
+
                     CHECK(j_nonobject.contains("foo") == false);
                     CHECK(j_nonobject_const.contains("foo") == false);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonobject.contains(std::string_view("foo")) == false);
+                    CHECK(j_nonobject_const.contains(std::string_view("foo")) == false);
+#endif
                 }
 
                 SECTION("number (integer)")
                 {
                     json j_nonobject(json::value_t::number_integer);
                     const json j_nonobject_const(json::value_t::number_integer);
+
                     CHECK(j_nonobject.contains("foo") == false);
                     CHECK(j_nonobject_const.contains("foo") == false);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonobject.contains(std::string_view("foo")) == false);
+                    CHECK(j_nonobject_const.contains(std::string_view("foo")) == false);
+#endif
                 }
 
                 SECTION("number (unsigned)")
                 {
                     json j_nonobject(json::value_t::number_unsigned);
                     const json j_nonobject_const(json::value_t::number_unsigned);
+
                     CHECK(j_nonobject.contains("foo") == false);
                     CHECK(j_nonobject_const.contains("foo") == false);
+
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonobject.contains(std::string_view("foo")) == false);
+                    CHECK(j_nonobject_const.contains(std::string_view("foo")) == false);
+#endif
                 }
 
                 SECTION("number (floating-point)")
@@ -945,6 +1449,10 @@ TEST_CASE("element access 2")
                     const json j_nonobject_const(json::value_t::number_float);
                     CHECK(j_nonobject.contains("foo") == false);
                     CHECK(j_nonobject_const.contains("foo") == false);
+#ifdef JSON_HAS_CPP_17
+                    CHECK(j_nonobject.contains(std::string_view("foo")) == false);
+                    CHECK(j_nonobject_const.contains(std::string_view("foo")) == false);
+#endif
                 }
             }
         }

From b21c34517900c46a943c804d9af3a20cd0c77062 Mon Sep 17 00:00:00 2001
From: Niels Lohmann <mail@nlohmann.me>
Date: Sun, 1 May 2022 09:41:50 +0200
Subject: [PATCH 06/30] Reorganize directories (#3462)

* :truck: move files
* :truck: rename doc folder to docs
* :truck: rename test folder to tests
---
 .../CODE_OF_CONDUCT.md                        |   0
 .drone.yml => .github/external_ci/.drone.yml  |   2 +-
 .../external_ci/appveyor.yml                  |   0
 .gitignore                                    |  14 +++---
 CMakeLists.txt                                |   2 +-
 Makefile                                      |  44 +++++++++---------
 README.md                                     |  12 ++---
 cmake/ci.cmake                                |  18 +++----
 {doc => docs}/Makefile                        |   0
 {doc => docs}/README.md                       |   2 +-
 {doc => docs}/avatars.png                     | Bin
 {doc => docs}/docset/Info.plist               |   0
 {doc => docs}/docset/Makefile                 |   0
 {doc => docs}/docset/README.md                |   0
 {doc => docs}/docset/docSet.sql               |   0
 {doc => docs}/docset/docset.json              |   0
 {doc => docs}/docset/icon.png                 | Bin
 {doc => docs}/docset/icon@2x.png              | Bin
 {doc => docs}/examples/README.cpp             |   0
 {doc => docs}/examples/README.output          |   0
 {doc => docs}/examples/accept__string.cpp     |   0
 {doc => docs}/examples/accept__string.output  |   0
 {doc => docs}/examples/array.cpp              |   0
 {doc => docs}/examples/array.output           |   0
 {doc => docs}/examples/array_t.cpp            |   0
 {doc => docs}/examples/array_t.output         |   0
 .../examples/at__object_t_key_type.cpp        |   0
 .../examples/at__object_t_key_type.output     |   0
 .../examples/at__object_t_key_type_const.cpp  |   0
 .../at__object_t_key_type_const.output        |   0
 {doc => docs}/examples/at__size_type.cpp      |   0
 {doc => docs}/examples/at__size_type.output   |   0
 .../examples/at__size_type_const.cpp          |   0
 .../examples/at__size_type_const.output       |   0
 {doc => docs}/examples/at_json_pointer.cpp    |   0
 {doc => docs}/examples/at_json_pointer.output |   0
 .../examples/at_json_pointer_const.cpp        |   0
 .../examples/at_json_pointer_const.output     |   0
 {doc => docs}/examples/back.cpp               |   0
 {doc => docs}/examples/back.output            |   0
 .../examples/basic_json__CompatibleType.cpp   |   0
 .../basic_json__CompatibleType.output         |   0
 .../examples/basic_json__InputIt_InputIt.cpp  |   0
 .../basic_json__InputIt_InputIt.output        |   0
 .../examples/basic_json__basic_json.cpp       |   0
 .../examples/basic_json__basic_json.output    |   0
 .../examples/basic_json__copyassignment.cpp   |   0
 .../basic_json__copyassignment.output         |   0
 .../examples/basic_json__list_init_t.cpp      |   0
 .../examples/basic_json__list_init_t.output   |   0
 .../examples/basic_json__moveconstructor.cpp  |   0
 .../basic_json__moveconstructor.output        |   0
 .../examples/basic_json__nullptr_t.cpp        |   0
 .../examples/basic_json__nullptr_t.output     |   0
 .../basic_json__size_type_basic_json.cpp      |   0
 .../basic_json__size_type_basic_json.output   |   0
 {doc => docs}/examples/basic_json__value.cpp  |   0
 .../examples/basic_json__value.output         |   0
 .../examples/basic_json__value_ptr.cpp        |   0
 .../examples/basic_json__value_ptr.output     |   0
 .../examples/basic_json__value_t.cpp          |   0
 .../examples/basic_json__value_t.output       |   0
 {doc => docs}/examples/begin.cpp              |   0
 {doc => docs}/examples/begin.output           |   0
 {doc => docs}/examples/binary.cpp             |   0
 {doc => docs}/examples/binary.output          |   0
 {doc => docs}/examples/binary_t.cpp           |   0
 {doc => docs}/examples/binary_t.output        |   0
 {doc => docs}/examples/boolean_t.cpp          |   0
 {doc => docs}/examples/boolean_t.output       |   0
 {doc => docs}/examples/cbegin.cpp             |   0
 {doc => docs}/examples/cbegin.output          |   0
 {doc => docs}/examples/cend.cpp               |   0
 {doc => docs}/examples/cend.output            |   0
 {doc => docs}/examples/clear.cpp              |   0
 {doc => docs}/examples/clear.output           |   0
 {doc => docs}/examples/contains.cpp           |   0
 {doc => docs}/examples/contains.output        |   0
 .../examples/contains_json_pointer.cpp        |   0
 .../examples/contains_json_pointer.output     |   0
 {doc => docs}/examples/count.cpp              |   0
 {doc => docs}/examples/count.output           |   0
 {doc => docs}/examples/crbegin.cpp            |   0
 {doc => docs}/examples/crbegin.output         |   0
 {doc => docs}/examples/crend.cpp              |   0
 {doc => docs}/examples/crend.output           |   0
 .../examples/diagnostics_extended.cpp         |   0
 .../examples/diagnostics_extended.output      |   0
 .../examples/diagnostics_standard.cpp         |   0
 .../examples/diagnostics_standard.output      |   0
 {doc => docs}/examples/diff.cpp               |   0
 {doc => docs}/examples/diff.output            |   0
 {doc => docs}/examples/dump.cpp               |   0
 {doc => docs}/examples/dump.output            |   0
 {doc => docs}/examples/emplace.cpp            |   0
 {doc => docs}/examples/emplace.output         |   0
 {doc => docs}/examples/emplace_back.cpp       |   0
 {doc => docs}/examples/emplace_back.output    |   0
 {doc => docs}/examples/empty.cpp              |   0
 {doc => docs}/examples/empty.output           |   0
 {doc => docs}/examples/end.cpp                |   0
 {doc => docs}/examples/end.output             |   0
 .../examples/erase__IteratorType.cpp          |   0
 .../examples/erase__IteratorType.output       |   0
 .../erase__IteratorType_IteratorType.cpp      |   0
 .../erase__IteratorType_IteratorType.output   |   0
 {doc => docs}/examples/erase__key_type.cpp    |   0
 {doc => docs}/examples/erase__key_type.output |   0
 {doc => docs}/examples/erase__size_type.cpp   |   0
 .../examples/erase__size_type.output          |   0
 {doc => docs}/examples/exception.cpp          |   0
 {doc => docs}/examples/exception.output       |   0
 {doc => docs}/examples/find__key_type.cpp     |   0
 {doc => docs}/examples/find__key_type.output  |   0
 {doc => docs}/examples/flatten.cpp            |   0
 {doc => docs}/examples/flatten.output         |   0
 {doc => docs}/examples/from_bson.cpp          |   0
 {doc => docs}/examples/from_bson.output       |   0
 {doc => docs}/examples/from_cbor.cpp          |   0
 {doc => docs}/examples/from_cbor.output       |   0
 {doc => docs}/examples/from_msgpack.cpp       |   0
 {doc => docs}/examples/from_msgpack.output    |   0
 {doc => docs}/examples/from_ubjson.cpp        |   0
 {doc => docs}/examples/from_ubjson.output     |   0
 {doc => docs}/examples/front.cpp              |   0
 {doc => docs}/examples/front.output           |   0
 {doc => docs}/examples/get__PointerType.cpp   |   0
 .../examples/get__PointerType.output          |   0
 .../examples/get__ValueType_const.cpp         |   0
 .../examples/get__ValueType_const.output      |   0
 {doc => docs}/examples/get_binary.cpp         |   0
 {doc => docs}/examples/get_binary.output      |   0
 {doc => docs}/examples/get_ptr.cpp            |   0
 {doc => docs}/examples/get_ptr.output         |   0
 {doc => docs}/examples/get_ref.cpp            |   0
 {doc => docs}/examples/get_ref.output         |   0
 {doc => docs}/examples/get_to.cpp             |   0
 {doc => docs}/examples/get_to.output          |   0
 {doc => docs}/examples/insert.cpp             |   0
 {doc => docs}/examples/insert.output          |   0
 {doc => docs}/examples/insert__count.cpp      |   0
 {doc => docs}/examples/insert__count.output   |   0
 {doc => docs}/examples/insert__ilist.cpp      |   0
 {doc => docs}/examples/insert__ilist.output   |   0
 {doc => docs}/examples/insert__range.cpp      |   0
 {doc => docs}/examples/insert__range.output   |   0
 .../examples/insert__range_object.cpp         |   0
 .../examples/insert__range_object.output      |   0
 {doc => docs}/examples/invalid_iterator.cpp   |   0
 .../examples/invalid_iterator.output          |   0
 {doc => docs}/examples/is_array.cpp           |   0
 {doc => docs}/examples/is_array.output        |   0
 {doc => docs}/examples/is_binary.cpp          |   0
 {doc => docs}/examples/is_binary.output       |   0
 {doc => docs}/examples/is_boolean.cpp         |   0
 {doc => docs}/examples/is_boolean.output      |   0
 {doc => docs}/examples/is_discarded.cpp       |   0
 {doc => docs}/examples/is_discarded.output    |   0
 {doc => docs}/examples/is_null.cpp            |   0
 {doc => docs}/examples/is_null.output         |   0
 {doc => docs}/examples/is_number.cpp          |   0
 {doc => docs}/examples/is_number.output       |   0
 {doc => docs}/examples/is_number_float.cpp    |   0
 {doc => docs}/examples/is_number_float.output |   0
 {doc => docs}/examples/is_number_integer.cpp  |   0
 .../examples/is_number_integer.output         |   0
 {doc => docs}/examples/is_number_unsigned.cpp |   0
 .../examples/is_number_unsigned.output        |   0
 {doc => docs}/examples/is_object.cpp          |   0
 {doc => docs}/examples/is_object.output       |   0
 {doc => docs}/examples/is_primitive.cpp       |   0
 {doc => docs}/examples/is_primitive.output    |   0
 {doc => docs}/examples/is_string.cpp          |   0
 {doc => docs}/examples/is_string.output       |   0
 {doc => docs}/examples/is_structured.cpp      |   0
 {doc => docs}/examples/is_structured.output   |   0
 {doc => docs}/examples/items.cpp              |   0
 {doc => docs}/examples/items.output           |   0
 {doc => docs}/examples/iterator_wrapper.cpp   |   0
 .../examples/iterator_wrapper.output          |   0
 {doc => docs}/examples/json_lines.cpp         |   0
 {doc => docs}/examples/json_lines.output      |   0
 {doc => docs}/examples/json_pointer.cpp       |   0
 {doc => docs}/examples/json_pointer.output    |   0
 {doc => docs}/examples/json_pointer__back.cpp |   0
 .../examples/json_pointer__back.output        |   0
 .../examples/json_pointer__empty.cpp          |   0
 .../examples/json_pointer__empty.output       |   0
 .../examples/json_pointer__operator_add.cpp   |   0
 .../json_pointer__operator_add.output         |   0
 .../json_pointer__operator_add_binary.cpp     |   0
 .../json_pointer__operator_add_binary.output  |   0
 .../examples/json_pointer__parent_pointer.cpp |   0
 .../json_pointer__parent_pointer.output       |   0
 .../examples/json_pointer__pop_back.cpp       |   0
 .../examples/json_pointer__pop_back.output    |   0
 .../examples/json_pointer__push_back.cpp      |   0
 .../examples/json_pointer__push_back.output   |   0
 .../examples/json_pointer__to_string.cpp      |   0
 .../examples/json_pointer__to_string.output   |   0
 {doc => docs}/examples/max_size.cpp           |   0
 {doc => docs}/examples/max_size.output        |   0
 {doc => docs}/examples/merge_patch.cpp        |   0
 {doc => docs}/examples/merge_patch.output     |   0
 {doc => docs}/examples/meta.cpp               |   0
 {doc => docs}/examples/meta.output            |   0
 ...lohmann_define_type_intrusive_explicit.cpp |   0
 ...mann_define_type_intrusive_explicit.output |   0
 .../nlohmann_define_type_intrusive_macro.cpp  |   0
 ...lohmann_define_type_intrusive_macro.output |   0
 ...e_type_intrusive_with_default_explicit.cpp |   0
 ...ype_intrusive_with_default_explicit.output |   0
 ...fine_type_intrusive_with_default_macro.cpp |   0
 ...e_type_intrusive_with_default_macro.output |   0
 ...ann_define_type_non_intrusive_explicit.cpp |   0
 ..._define_type_non_intrusive_explicit.output |   0
 ...ohmann_define_type_non_intrusive_macro.cpp |   0
 ...ann_define_type_non_intrusive_macro.output |   0
 ...pe_non_intrusive_with_default_explicit.cpp |   0
 ...non_intrusive_with_default_explicit.output |   0
 ..._type_non_intrusive_with_default_macro.cpp |   0
 ...pe_non_intrusive_with_default_macro.output |   0
 .../examples/nlohmann_json_serialize_enum.cpp |   0
 .../nlohmann_json_serialize_enum.output       |   0
 .../nlohmann_json_serialize_enum_2.cpp        |   0
 .../nlohmann_json_serialize_enum_2.output     |   0
 {doc => docs}/examples/number_float_t.cpp     |   0
 {doc => docs}/examples/number_float_t.output  |   0
 {doc => docs}/examples/number_integer_t.cpp   |   0
 .../examples/number_integer_t.output          |   0
 {doc => docs}/examples/number_unsigned_t.cpp  |   0
 .../examples/number_unsigned_t.output         |   0
 {doc => docs}/examples/object.cpp             |   0
 {doc => docs}/examples/object.output          |   0
 {doc => docs}/examples/object_t.cpp           |   0
 {doc => docs}/examples/object_t.output        |   0
 .../examples/operator__ValueType.cpp          |   0
 .../examples/operator__ValueType.output       |   0
 {doc => docs}/examples/operator__equal.cpp    |   0
 {doc => docs}/examples/operator__equal.output |   0
 .../examples/operator__equal__nullptr_t.cpp   |   0
 .../operator__equal__nullptr_t.output         |   0
 {doc => docs}/examples/operator__greater.cpp  |   0
 .../examples/operator__greater.output         |   0
 .../examples/operator__greaterequal.cpp       |   0
 .../examples/operator__greaterequal.output    |   0
 {doc => docs}/examples/operator__less.cpp     |   0
 {doc => docs}/examples/operator__less.output  |   0
 .../examples/operator__lessequal.cpp          |   0
 .../examples/operator__lessequal.output       |   0
 {doc => docs}/examples/operator__notequal.cpp |   0
 .../examples/operator__notequal.output        |   0
 .../operator__notequal__nullptr_t.cpp         |   0
 .../operator__notequal__nullptr_t.output      |   0
 {doc => docs}/examples/operator__value_t.cpp  |   0
 .../examples/operator__value_t.output         |   0
 .../examples/operator_deserialize.cpp         |   0
 .../examples/operator_deserialize.output      |   0
 .../examples/operator_literal_json.cpp        |   0
 .../examples/operator_literal_json.output     |   0
 .../operator_literal_json_pointer.cpp         |   0
 .../operator_literal_json_pointer.output      |   0
 {doc => docs}/examples/operator_serialize.cpp |   0
 .../examples/operator_serialize.output        |   0
 .../examples/operatorarray__key_type.cpp      |   0
 .../examples/operatorarray__key_type.output   |   0
 .../operatorarray__key_type_const.cpp         |   0
 .../operatorarray__key_type_const.output      |   0
 .../examples/operatorarray__size_type.cpp     |   0
 .../examples/operatorarray__size_type.output  |   0
 .../operatorarray__size_type_const.cpp        |   0
 .../operatorarray__size_type_const.output     |   0
 .../examples/operatorjson_pointer.cpp         |   0
 .../examples/operatorjson_pointer.output      |   0
 .../examples/operatorjson_pointer_const.cpp   |   0
 .../operatorjson_pointer_const.output         |   0
 {doc => docs}/examples/ordered_map.cpp        |   0
 {doc => docs}/examples/ordered_map.output     |   0
 {doc => docs}/examples/other_error.cpp        |   0
 {doc => docs}/examples/other_error.output     |   0
 {doc => docs}/examples/out_of_range.cpp       |   0
 {doc => docs}/examples/out_of_range.output    |   0
 .../examples/parse__allow_exceptions.cpp      |   0
 .../examples/parse__allow_exceptions.output   |   0
 .../parse__array__parser_callback_t.cpp       |   0
 .../parse__array__parser_callback_t.output    |   0
 ...contiguouscontainer__parser_callback_t.cpp |   0
 ...tiguouscontainer__parser_callback_t.output |   0
 .../parse__istream__parser_callback_t.cpp     |   0
 .../parse__istream__parser_callback_t.output  |   0
 .../examples/parse__iterator_pair.cpp         |   0
 .../examples/parse__iterator_pair.link        |   0
 .../examples/parse__iterator_pair.output      |   0
 {doc => docs}/examples/parse__pointers.cpp    |   0
 {doc => docs}/examples/parse__pointers.link   |   0
 {doc => docs}/examples/parse__pointers.output |   0
 .../parse__string__parser_callback_t.cpp      |   0
 .../parse__string__parser_callback_t.output   |   0
 {doc => docs}/examples/parse_error.cpp        |   0
 {doc => docs}/examples/parse_error.output     |   0
 {doc => docs}/examples/patch.cpp              |   0
 {doc => docs}/examples/patch.output           |   0
 {doc => docs}/examples/push_back.cpp          |   0
 {doc => docs}/examples/push_back.output       |   0
 .../examples/push_back__initializer_list.cpp  |   0
 .../push_back__initializer_list.output        |   0
 .../examples/push_back__object_t__value.cpp   |   0
 .../push_back__object_t__value.output         |   0
 {doc => docs}/examples/rbegin.cpp             |   0
 {doc => docs}/examples/rbegin.output          |   0
 {doc => docs}/examples/rend.cpp               |   0
 {doc => docs}/examples/rend.output            |   0
 {doc => docs}/examples/sax_parse.cpp          |   0
 {doc => docs}/examples/sax_parse.output       |   0
 {doc => docs}/examples/size.cpp               |   0
 {doc => docs}/examples/size.output            |   0
 {doc => docs}/examples/std_hash.cpp           |   0
 {doc => docs}/examples/std_hash.output        |   0
 {doc => docs}/examples/std_swap.cpp           |   0
 {doc => docs}/examples/std_swap.output        |   0
 {doc => docs}/examples/string_t.cpp           |   0
 {doc => docs}/examples/string_t.output        |   0
 {doc => docs}/examples/swap__array_t.cpp      |   0
 {doc => docs}/examples/swap__array_t.output   |   0
 {doc => docs}/examples/swap__binary_t.cpp     |   0
 {doc => docs}/examples/swap__binary_t.output  |   0
 {doc => docs}/examples/swap__object_t.cpp     |   0
 {doc => docs}/examples/swap__object_t.output  |   0
 {doc => docs}/examples/swap__reference.cpp    |   0
 {doc => docs}/examples/swap__reference.output |   0
 {doc => docs}/examples/swap__string_t.cpp     |   0
 {doc => docs}/examples/swap__string_t.output  |   0
 {doc => docs}/examples/to_bson.cpp            |   0
 {doc => docs}/examples/to_bson.output         |   0
 {doc => docs}/examples/to_cbor.cpp            |   0
 {doc => docs}/examples/to_cbor.output         |   0
 {doc => docs}/examples/to_msgpack.cpp         |   0
 {doc => docs}/examples/to_msgpack.output      |   0
 {doc => docs}/examples/to_string.cpp          |   0
 {doc => docs}/examples/to_string.output       |   0
 {doc => docs}/examples/to_ubjson.cpp          |   0
 {doc => docs}/examples/to_ubjson.output       |   0
 {doc => docs}/examples/type.cpp               |   0
 {doc => docs}/examples/type.output            |   0
 {doc => docs}/examples/type_error.cpp         |   0
 {doc => docs}/examples/type_error.output      |   0
 {doc => docs}/examples/type_name.cpp          |   0
 {doc => docs}/examples/type_name.output       |   0
 {doc => docs}/examples/unflatten.cpp          |   0
 {doc => docs}/examples/unflatten.output       |   0
 {doc => docs}/examples/update.cpp             |   0
 {doc => docs}/examples/update.output          |   0
 {doc => docs}/examples/update__range.cpp      |   0
 {doc => docs}/examples/update__range.output   |   0
 {doc => docs}/index.md                        |   0
 {doc => docs}/json.gif                        | Bin
 {doc => docs}/mkdocs/Makefile                 |   0
 .../docs/api/adl_serializer/from_json.md      |   0
 .../mkdocs/docs/api/adl_serializer/index.md   |   0
 .../mkdocs/docs/api/adl_serializer/to_json.md |   0
 .../mkdocs/docs/api/basic_json/accept.md      |   0
 .../mkdocs/docs/api/basic_json/array.md       |   0
 .../mkdocs/docs/api/basic_json/array_t.md     |   0
 .../mkdocs/docs/api/basic_json/at.md          |   0
 .../mkdocs/docs/api/basic_json/back.md        |   0
 .../mkdocs/docs/api/basic_json/basic_json.md  |   0
 .../mkdocs/docs/api/basic_json/begin.md       |   0
 .../mkdocs/docs/api/basic_json/binary.md      |   0
 .../mkdocs/docs/api/basic_json/binary_t.md    |   0
 .../mkdocs/docs/api/basic_json/boolean_t.md   |   0
 .../mkdocs/docs/api/basic_json/cbegin.md      |   0
 .../docs/api/basic_json/cbor_tag_handler_t.md |   0
 .../mkdocs/docs/api/basic_json/cend.md        |   0
 .../mkdocs/docs/api/basic_json/clear.md       |   0
 .../mkdocs/docs/api/basic_json/contains.md    |   0
 .../mkdocs/docs/api/basic_json/count.md       |   0
 .../mkdocs/docs/api/basic_json/crbegin.md     |   0
 .../mkdocs/docs/api/basic_json/crend.md       |   0
 .../basic_json/default_object_comparator_t.md |   0
 .../mkdocs/docs/api/basic_json/diff.md        |   0
 .../mkdocs/docs/api/basic_json/dump.md        |   0
 .../mkdocs/docs/api/basic_json/emplace.md     |   0
 .../docs/api/basic_json/emplace_back.md       |   0
 .../mkdocs/docs/api/basic_json/empty.md       |   0
 .../mkdocs/docs/api/basic_json/end.md         |   0
 .../mkdocs/docs/api/basic_json/erase.md       |   0
 .../docs/api/basic_json/error_handler_t.md    |   0
 .../mkdocs/docs/api/basic_json/exception.md   |   0
 .../mkdocs/docs/api/basic_json/find.md        |   0
 .../mkdocs/docs/api/basic_json/flatten.md     |   0
 .../mkdocs/docs/api/basic_json/from_bson.md   |   0
 .../mkdocs/docs/api/basic_json/from_cbor.md   |   0
 .../docs/api/basic_json/from_msgpack.md       |   0
 .../mkdocs/docs/api/basic_json/from_ubjson.md |   0
 .../mkdocs/docs/api/basic_json/front.md       |   0
 .../mkdocs/docs/api/basic_json/get.md         |   0
 .../docs/api/basic_json/get_allocator.md      |   0
 .../mkdocs/docs/api/basic_json/get_binary.md  |   0
 .../mkdocs/docs/api/basic_json/get_ptr.md     |   0
 .../mkdocs/docs/api/basic_json/get_ref.md     |   0
 .../mkdocs/docs/api/basic_json/get_to.md      |   0
 .../mkdocs/docs/api/basic_json/index.md       |   0
 .../docs/api/basic_json/input_format_t.md     |   0
 .../mkdocs/docs/api/basic_json/insert.md      |   0
 .../docs/api/basic_json/invalid_iterator.md   |   0
 .../mkdocs/docs/api/basic_json/is_array.md    |   0
 .../mkdocs/docs/api/basic_json/is_binary.md   |   0
 .../mkdocs/docs/api/basic_json/is_boolean.md  |   0
 .../docs/api/basic_json/is_discarded.md       |   0
 .../mkdocs/docs/api/basic_json/is_null.md     |   0
 .../mkdocs/docs/api/basic_json/is_number.md   |   0
 .../docs/api/basic_json/is_number_float.md    |   0
 .../docs/api/basic_json/is_number_integer.md  |   0
 .../docs/api/basic_json/is_number_unsigned.md |   0
 .../mkdocs/docs/api/basic_json/is_object.md   |   0
 .../docs/api/basic_json/is_primitive.md       |   0
 .../mkdocs/docs/api/basic_json/is_string.md   |   0
 .../docs/api/basic_json/is_structured.md      |   0
 .../mkdocs/docs/api/basic_json/items.md       |   0
 .../docs/api/basic_json/json_serializer.md    |   0
 .../mkdocs/docs/api/basic_json/max_size.md    |   0
 .../mkdocs/docs/api/basic_json/merge_patch.md |   0
 .../mkdocs/docs/api/basic_json/meta.md        |   0
 .../docs/api/basic_json/number_float_t.md     |   0
 .../docs/api/basic_json/number_integer_t.md   |   0
 .../docs/api/basic_json/number_unsigned_t.md  |   0
 .../mkdocs/docs/api/basic_json/object.md      |   0
 .../api/basic_json/object_comparator_t.md     |   0
 .../mkdocs/docs/api/basic_json/object_t.md    |   0
 .../mkdocs/docs/api/basic_json/operator+=.md  |   0
 .../mkdocs/docs/api/basic_json/operator=.md   |   0
 .../mkdocs/docs/api/basic_json/operator[].md  |   0
 .../docs/api/basic_json/operator_ValueType.md |   0
 .../mkdocs/docs/api/basic_json/operator_eq.md |   0
 .../mkdocs/docs/api/basic_json/operator_ge.md |   0
 .../mkdocs/docs/api/basic_json/operator_gt.md |   0
 .../docs/api/basic_json/operator_gtgt.md      |   0
 .../mkdocs/docs/api/basic_json/operator_le.md |   0
 .../api/basic_json/operator_literal_json.md   |   0
 .../operator_literal_json_pointer.md          |   0
 .../mkdocs/docs/api/basic_json/operator_lt.md |   0
 .../docs/api/basic_json/operator_ltlt.md      |   0
 .../mkdocs/docs/api/basic_json/operator_ne.md |   0
 .../docs/api/basic_json/operator_value_t.md   |   0
 .../mkdocs/docs/api/basic_json/other_error.md |   0
 .../docs/api/basic_json/out_of_range.md       |   0
 .../mkdocs/docs/api/basic_json/parse.md       |   0
 .../mkdocs/docs/api/basic_json/parse_error.md |   0
 .../docs/api/basic_json/parse_event_t.md      |   0
 .../docs/api/basic_json/parser_callback_t.md  |   0
 .../mkdocs/docs/api/basic_json/patch.md       |   0
 .../mkdocs/docs/api/basic_json/push_back.md   |   0
 .../mkdocs/docs/api/basic_json/rbegin.md      |   0
 .../mkdocs/docs/api/basic_json/rend.md        |   0
 .../mkdocs/docs/api/basic_json/sax_parse.md   |   0
 .../mkdocs/docs/api/basic_json/size.md        |   0
 .../mkdocs/docs/api/basic_json/std_hash.md    |   0
 .../mkdocs/docs/api/basic_json/std_swap.md    |   0
 .../mkdocs/docs/api/basic_json/string_t.md    |   0
 .../mkdocs/docs/api/basic_json/swap.md        |   0
 .../mkdocs/docs/api/basic_json/to_bson.md     |   0
 .../mkdocs/docs/api/basic_json/to_cbor.md     |   0
 .../mkdocs/docs/api/basic_json/to_msgpack.md  |   0
 .../mkdocs/docs/api/basic_json/to_string.md   |   0
 .../mkdocs/docs/api/basic_json/to_ubjson.md   |   0
 .../mkdocs/docs/api/basic_json/type.md        |   0
 .../mkdocs/docs/api/basic_json/type_error.md  |   0
 .../mkdocs/docs/api/basic_json/type_name.md   |   0
 .../mkdocs/docs/api/basic_json/unflatten.md   |   0
 .../mkdocs/docs/api/basic_json/update.md      |   0
 .../mkdocs/docs/api/basic_json/value.md       |   0
 .../mkdocs/docs/api/basic_json/value_t.md     |   0
 .../mkdocs/docs/api/basic_json/~basic_json.md |   0
 .../byte_container_with_subtype.md            |   0
 .../clear_subtype.md                          |   0
 .../has_subtype.md                            |   0
 .../api/byte_container_with_subtype/index.md  |   0
 .../set_subtype.md                            |   0
 .../byte_container_with_subtype/subtype.md    |   0
 {doc => docs}/mkdocs/docs/api/json.md         |   0
 .../mkdocs/docs/api/json_pointer/back.md      |   0
 .../mkdocs/docs/api/json_pointer/empty.md     |   0
 .../mkdocs/docs/api/json_pointer/index.md     |   0
 .../docs/api/json_pointer/json_pointer.md     |   0
 .../docs/api/json_pointer/operator_slash.md   |   0
 .../docs/api/json_pointer/operator_slasheq.md |   0
 .../docs/api/json_pointer/operator_string.md  |   0
 .../docs/api/json_pointer/parent_pointer.md   |   0
 .../mkdocs/docs/api/json_pointer/pop_back.md  |   0
 .../mkdocs/docs/api/json_pointer/push_back.md |   0
 .../mkdocs/docs/api/json_pointer/string_t.md  |   0
 .../mkdocs/docs/api/json_pointer/to_string.md |   0
 .../mkdocs/docs/api/json_sax/binary.md        |   0
 .../mkdocs/docs/api/json_sax/boolean.md       |   0
 .../mkdocs/docs/api/json_sax/end_array.md     |   0
 .../mkdocs/docs/api/json_sax/end_object.md    |   0
 .../mkdocs/docs/api/json_sax/index.md         |   0
 {doc => docs}/mkdocs/docs/api/json_sax/key.md |   0
 .../mkdocs/docs/api/json_sax/null.md          |   0
 .../mkdocs/docs/api/json_sax/number_float.md  |   0
 .../docs/api/json_sax/number_integer.md       |   0
 .../docs/api/json_sax/number_unsigned.md      |   0
 .../mkdocs/docs/api/json_sax/parse_error.md   |   0
 .../mkdocs/docs/api/json_sax/start_array.md   |   0
 .../mkdocs/docs/api/json_sax/start_object.md  |   0
 .../mkdocs/docs/api/json_sax/string.md        |   0
 {doc => docs}/mkdocs/docs/api/macros/index.md |   0
 .../mkdocs/docs/api/macros/json_assert.md     |   0
 .../docs/api/macros/json_diagnostics.md       |   0
 .../mkdocs/docs/api/macros/json_has_cpp_11.md |   0
 .../docs/api/macros/json_has_filesystem.md    |   0
 .../mkdocs/docs/api/macros/json_no_io.md      |   0
 .../docs/api/macros/json_noexception.md       |   0
 .../macros/json_skip_library_version_check.md |   0
 .../json_skip_unsupported_compiler_check.md   |   0
 .../mkdocs/docs/api/macros/json_throw_user.md |   0
 .../macros/json_use_implicit_conversions.md   |   0
 .../macros/nlohmann_define_type_intrusive.md  |   0
 .../nlohmann_define_type_non_intrusive.md     |   0
 .../macros/nlohmann_json_serialize_enum.md    |   0
 .../api/macros/nlohmann_json_version_major.md |   0
 {doc => docs}/mkdocs/docs/api/ordered_json.md |   0
 {doc => docs}/mkdocs/docs/api/ordered_map.md  |   0
 .../mkdocs/docs/features/arbitrary_types.md   |   0
 .../mkdocs/docs/features/assertions.md        |   0
 .../docs/features/binary_formats/bson.md      |   0
 .../docs/features/binary_formats/cbor.md      |   0
 .../docs/features/binary_formats/index.md     |   0
 .../features/binary_formats/messagepack.md    |   0
 .../docs/features/binary_formats/ubjson.md    |   0
 .../mkdocs/docs/features/binary_values.md     |   0
 .../mkdocs/docs/features/comments.md          |   0
 .../features/element_access/checked_access.md |   0
 .../features/element_access/default_value.md  |   0
 .../docs/features/element_access/index.md     |   0
 .../element_access/unchecked_access.md        |   0
 .../mkdocs/docs/features/enum_conversion.md   |   0
 .../mkdocs/docs/features/iterators.md         |   0
 .../mkdocs/docs/features/json_patch.md        |   0
 .../mkdocs/docs/features/json_pointer.md      |   0
 {doc => docs}/mkdocs/docs/features/macros.md  |   0
 .../mkdocs/docs/features/merge_patch.md       |   0
 .../mkdocs/docs/features/object_order.md      |   0
 .../mkdocs/docs/features/parsing/index.md     |   0
 .../docs/features/parsing/json_lines.md       |   0
 .../docs/features/parsing/parse_exceptions.md |   0
 .../docs/features/parsing/parser_callbacks.md |   0
 .../docs/features/parsing/sax_interface.md    |   0
 .../mkdocs/docs/features/types/index.md       |   0
 .../docs/features/types/number_handling.md    |   0
 .../mkdocs/docs/home/code_of_conduct.md       |   0
 .../mkdocs/docs/home/design_goals.md          |   0
 {doc => docs}/mkdocs/docs/home/exceptions.md  |   0
 {doc => docs}/mkdocs/docs/home/faq.md         |   0
 {doc => docs}/mkdocs/docs/home/license.md     |   0
 {doc => docs}/mkdocs/docs/home/releases.md    |   0
 {doc => docs}/mkdocs/docs/home/sponsors.md    |   0
 .../mkdocs/docs/images/callback_events.png    | Bin
 .../mkdocs/docs/images/json_syntax_number.png | Bin
 .../mkdocs/docs/images/range-begin-end.svg    |   0
 .../mkdocs/docs/images/range-rbegin-rend.svg  |   0
 {doc => docs}/mkdocs/docs/index.md            |   0
 .../mkdocs/docs/integration/cmake.md          |   0
 .../docs/integration/conan/CMakeLists.txt     |   0
 .../docs/integration/conan/Conanfile.txt      |   0
 .../mkdocs/docs/integration/conan/example.cpp |   0
 .../mkdocs/docs/integration/example.cpp       |   0
 .../mkdocs/docs/integration/index.md          |   0
 .../docs/integration/package_managers.md      |   0
 .../mkdocs/docs/integration/pkg-config.md     |   0
 .../docs/integration/vcpkg/CMakeLists.txt     |   0
 .../mkdocs/docs/integration/vcpkg/example.cpp |   0
 {doc => docs}/mkdocs/mkdocs.yml               |   2 +-
 {doc => docs}/mkdocs/requirements.txt         |   0
 .../mkdocs/scripts/check_structure.py         |   0
 {doc => docs}/usages/ios.png                  | Bin
 {doc => docs}/usages/macos.png                | Bin
 include/nlohmann/json.hpp                     |   2 +-
 single_include/nlohmann/json.hpp              |   2 +-
 {test => tests}/CMakeLists.txt                |   0
 {test => tests}/Makefile                      |   0
 .../benchmarks}/CMakeLists.txt                |   3 +-
 .../benchmarks}/src/benchmarks.cpp            |   0
 .../cmake_add_subdirectory/CMakeLists.txt     |   0
 .../project/CMakeLists.txt                    |   0
 .../cmake_add_subdirectory/project/main.cpp   |   0
 .../cmake_fetch_content/CMakeLists.txt        |   0
 .../project/CMakeLists.txt                    |   0
 .../cmake_fetch_content/project/main.cpp      |   0
 .../cmake_fetch_content2/CMakeLists.txt       |   0
 .../project/CMakeLists.txt                    |   0
 .../cmake_fetch_content2/project/main.cpp     |   0
 {test => tests}/cmake_import/CMakeLists.txt   |   0
 .../cmake_import/project/CMakeLists.txt       |   0
 {test => tests}/cmake_import/project/main.cpp |   0
 .../cmake_import_minver/CMakeLists.txt        |   0
 .../project/CMakeLists.txt                    |   0
 .../cmake_import_minver/project/main.cpp      |   0
 .../CMakeLists.txt                            |   0
 .../project/Bar.cpp                           |   0
 .../project/Bar.hpp                           |   0
 .../project/CMakeLists.txt                    |   0
 .../project/Foo.cpp                           |   0
 .../project/Foo.hpp                           |   0
 .../project/main.cpp                          |   0
 {test => tests}/cuda_example/CMakeLists.txt   |   0
 {test => tests}/cuda_example/json_cuda.cu     |   0
 .../reports/2016-08-29-fuzz/exec_speed.png    | Bin
 .../reports/2016-08-29-fuzz/fuzz.tiff         | Bin
 .../reports/2016-08-29-fuzz/high_freq.png     | Bin
 .../reports/2016-08-29-fuzz/index.html        |   0
 .../reports/2016-08-29-fuzz/low_freq.png      | Bin
 .../2016-09-09-nativejson_benchmark/README.md |   0
 .../conformance_Nlohmann (C++11).md           |   0
 .../conformance_overall_Result.png            | Bin
 ..._mac64_clang7.0_1._Parse_Memory_(byte).png | Bin
 ...0GHz_mac64_clang7.0_1._Parse_Time_(ms).png | Bin
 ..._mac64_clang7.0_2._Stringify_Time_(ms).png | Bin
 ...z_mac64_clang7.0_3._Prettify_Time_(ms).png | Bin
 ..._clang7.0_7._Code_size_FileSize_(byte).png | Bin
 .../reports/2016-10-02-fuzz/exec_speed.png    | Bin
 .../reports/2016-10-02-fuzz/fuzz.tiff         | Bin
 .../reports/2016-10-02-fuzz/high_freq.png     | Bin
 .../reports/2016-10-02-fuzz/index.html        |   0
 .../reports/2016-10-02-fuzz/low_freq.png      | Bin
 {test => tests}/src/fuzzer-driver_afl.cpp     |   0
 {test => tests}/src/fuzzer-parse_bjdata.cpp   |   0
 {test => tests}/src/fuzzer-parse_bson.cpp     |   0
 {test => tests}/src/fuzzer-parse_cbor.cpp     |   0
 {test => tests}/src/fuzzer-parse_json.cpp     |   0
 {test => tests}/src/fuzzer-parse_msgpack.cpp  |   0
 {test => tests}/src/fuzzer-parse_ubjson.cpp   |   0
 {test => tests}/src/test_utils.hpp            |   0
 {test => tests}/src/unit-algorithms.cpp       |   0
 {test => tests}/src/unit-allocator.cpp        |   0
 {test => tests}/src/unit-alt-string.cpp       |   0
 {test => tests}/src/unit-assert_macro.cpp     |   0
 {test => tests}/src/unit-bjdata.cpp           |   0
 {test => tests}/src/unit-bson.cpp             |   0
 .../src/unit-byte_container_with_subtype.cpp  |   0
 {test => tests}/src/unit-capacity.cpp         |   0
 {test => tests}/src/unit-cbor.cpp             |   0
 .../src/unit-class_const_iterator.cpp         |   0
 {test => tests}/src/unit-class_iterator.cpp   |   0
 {test => tests}/src/unit-class_lexer.cpp      |   0
 {test => tests}/src/unit-class_parser.cpp     |   0
 {test => tests}/src/unit-comparison.cpp       |   0
 {test => tests}/src/unit-concepts.cpp         |   0
 {test => tests}/src/unit-constructor1.cpp     |   0
 {test => tests}/src/unit-constructor2.cpp     |   0
 {test => tests}/src/unit-convenience.cpp      |   0
 {test => tests}/src/unit-conversions.cpp      |   0
 {test => tests}/src/unit-deserialization.cpp  |   0
 {test => tests}/src/unit-diagnostics.cpp      |   0
 .../src/unit-disabled_exceptions.cpp          |   0
 {test => tests}/src/unit-element_access1.cpp  |   0
 {test => tests}/src/unit-element_access2.cpp  |   0
 {test => tests}/src/unit-hash.cpp             |   0
 {test => tests}/src/unit-inspection.cpp       |   0
 {test => tests}/src/unit-items.cpp            |   0
 {test => tests}/src/unit-iterators1.cpp       |   0
 {test => tests}/src/unit-iterators2.cpp       |   0
 {test => tests}/src/unit-json_patch.cpp       |   0
 {test => tests}/src/unit-json_pointer.cpp     |   0
 {test => tests}/src/unit-large_json.cpp       |   0
 {test => tests}/src/unit-merge_patch.cpp      |   0
 {test => tests}/src/unit-meta.cpp             |   0
 {test => tests}/src/unit-modifiers.cpp        |   0
 {test => tests}/src/unit-msgpack.cpp          |   0
 {test => tests}/src/unit-noexcept.cpp         |   0
 {test => tests}/src/unit-ordered_json.cpp     |   0
 {test => tests}/src/unit-ordered_map.cpp      |   0
 {test => tests}/src/unit-pointer_access.cpp   |   0
 {test => tests}/src/unit-readme.cpp           |   0
 {test => tests}/src/unit-reference_access.cpp |   0
 {test => tests}/src/unit-regression1.cpp      |   0
 {test => tests}/src/unit-regression2.cpp      |   0
 {test => tests}/src/unit-serialization.cpp    |   0
 {test => tests}/src/unit-testsuites.cpp       |   0
 {test => tests}/src/unit-to_chars.cpp         |   0
 {test => tests}/src/unit-ubjson.cpp           |   0
 {test => tests}/src/unit-udt.cpp              |   0
 {test => tests}/src/unit-udt_macro.cpp        |   0
 {test => tests}/src/unit-unicode1.cpp         |   0
 {test => tests}/src/unit-unicode2.cpp         |   0
 {test => tests}/src/unit-unicode3.cpp         |   0
 {test => tests}/src/unit-unicode4.cpp         |   0
 {test => tests}/src/unit-unicode5.cpp         |   0
 .../src/unit-user_defined_input.cpp           |   0
 {test => tests}/src/unit-wstring.cpp          |   0
 {test => tests}/src/unit.cpp                  |   0
 .../thirdparty/Fuzzer/CMakeLists.txt          |   0
 .../thirdparty/Fuzzer/FuzzerCorpus.h          |   0
 .../thirdparty/Fuzzer/FuzzerCrossOver.cpp     |   0
 .../thirdparty/Fuzzer/FuzzerDefs.h            |   0
 .../thirdparty/Fuzzer/FuzzerDictionary.h      |   0
 .../thirdparty/Fuzzer/FuzzerDriver.cpp        |   0
 .../thirdparty/Fuzzer/FuzzerExtFunctions.def  |   0
 .../thirdparty/Fuzzer/FuzzerExtFunctions.h    |   0
 .../Fuzzer/FuzzerExtFunctionsDlsym.cpp        |   0
 .../Fuzzer/FuzzerExtFunctionsWeak.cpp         |   0
 .../Fuzzer/FuzzerExtFunctionsWeakAlias.cpp    |   0
 .../thirdparty/Fuzzer/FuzzerFlags.def         |   0
 .../thirdparty/Fuzzer/FuzzerIO.cpp            |   0
 {test => tests}/thirdparty/Fuzzer/FuzzerIO.h  |   0
 .../thirdparty/Fuzzer/FuzzerIOPosix.cpp       |   0
 .../thirdparty/Fuzzer/FuzzerIOWindows.cpp     |   0
 .../thirdparty/Fuzzer/FuzzerInterface.h       |   0
 .../thirdparty/Fuzzer/FuzzerInternal.h        |   0
 .../thirdparty/Fuzzer/FuzzerLoop.cpp          |   0
 .../thirdparty/Fuzzer/FuzzerMain.cpp          |   0
 .../thirdparty/Fuzzer/FuzzerMerge.cpp         |   0
 .../thirdparty/Fuzzer/FuzzerMerge.h           |   0
 .../thirdparty/Fuzzer/FuzzerMutate.cpp        |   0
 .../thirdparty/Fuzzer/FuzzerMutate.h          |   0
 .../thirdparty/Fuzzer/FuzzerOptions.h         |   0
 .../thirdparty/Fuzzer/FuzzerRandom.h          |   0
 .../thirdparty/Fuzzer/FuzzerSHA1.cpp          |   0
 .../thirdparty/Fuzzer/FuzzerSHA1.h            |   0
 .../thirdparty/Fuzzer/FuzzerTracePC.cpp       |   0
 .../thirdparty/Fuzzer/FuzzerTracePC.h         |   0
 .../thirdparty/Fuzzer/FuzzerTraceState.cpp    |   0
 .../thirdparty/Fuzzer/FuzzerUtil.cpp          |   0
 .../thirdparty/Fuzzer/FuzzerUtil.h            |   0
 .../thirdparty/Fuzzer/FuzzerUtilDarwin.cpp    |   0
 .../thirdparty/Fuzzer/FuzzerUtilLinux.cpp     |   0
 .../thirdparty/Fuzzer/FuzzerUtilPosix.cpp     |   0
 .../thirdparty/Fuzzer/FuzzerUtilWindows.cpp   |   0
 .../thirdparty/Fuzzer/FuzzerValueBitMap.h     |   0
 {test => tests}/thirdparty/Fuzzer/README.txt  |   0
 .../thirdparty/Fuzzer/afl/afl_driver.cpp      |   0
 {test => tests}/thirdparty/Fuzzer/build.sh    |   0
 {test => tests}/thirdparty/Fuzzer/cxx.dict    |   0
 .../standalone/StandaloneFuzzTargetMain.c     |   0
 .../thirdparty/Fuzzer/test/AFLDriverTest.cpp  |   0
 .../Fuzzer/test/AbsNegAndConstant64Test.cpp   |   0
 .../Fuzzer/test/AbsNegAndConstantTest.cpp     |   0
 .../Fuzzer/test/AccumulateAllocationsTest.cpp |   0
 .../Fuzzer/test/BufferOverflowOnInput.cpp     |   0
 .../thirdparty/Fuzzer/test/CMakeLists.txt     |   0
 .../Fuzzer/test/CallerCalleeTest.cpp          |   0
 .../thirdparty/Fuzzer/test/CounterTest.cpp    |   0
 .../Fuzzer/test/CustomCrossOverTest.cpp       |   0
 .../Fuzzer/test/CustomMutatorTest.cpp         |   0
 .../thirdparty/Fuzzer/test/DSO1.cpp           |   0
 .../thirdparty/Fuzzer/test/DSO2.cpp           |   0
 .../thirdparty/Fuzzer/test/DSOTestExtra.cpp   |   0
 .../thirdparty/Fuzzer/test/DSOTestMain.cpp    |   0
 .../thirdparty/Fuzzer/test/DivTest.cpp        |   0
 .../thirdparty/Fuzzer/test/EmptyTest.cpp      |   0
 .../test/FourIndependentBranchesTest.cpp      |   0
 .../Fuzzer/test/FullCoverageSetTest.cpp       |   0
 .../thirdparty/Fuzzer/test/FuzzerUnittest.cpp |   0
 .../thirdparty/Fuzzer/test/InitializeTest.cpp |   0
 .../thirdparty/Fuzzer/test/LeakTest.cpp       |   0
 .../Fuzzer/test/LeakTimeoutTest.cpp           |   0
 .../thirdparty/Fuzzer/test/LoadTest.cpp       |   0
 .../thirdparty/Fuzzer/test/MemcmpTest.cpp     |   0
 .../Fuzzer/test/NthRunCrashTest.cpp           |   0
 .../Fuzzer/test/NullDerefOnEmptyTest.cpp      |   0
 .../thirdparty/Fuzzer/test/NullDerefTest.cpp  |   0
 .../Fuzzer/test/OneHugeAllocTest.cpp          |   0
 .../test/OutOfMemorySingleLargeMallocTest.cpp |   0
 .../Fuzzer/test/OutOfMemoryTest.cpp           |   0
 .../Fuzzer/test/RepeatedBytesTest.cpp         |   0
 .../thirdparty/Fuzzer/test/RepeatedMemcmp.cpp |   0
 .../Fuzzer/test/ShrinkControlFlowTest.cpp     |   0
 .../Fuzzer/test/ShrinkValueProfileTest.cpp    |   0
 .../Fuzzer/test/SignedIntOverflowTest.cpp     |   0
 .../thirdparty/Fuzzer/test/SimpleCmpTest.cpp  |   0
 .../Fuzzer/test/SimpleDictionaryTest.cpp      |   0
 .../thirdparty/Fuzzer/test/SimpleHashTest.cpp |   0
 .../thirdparty/Fuzzer/test/SimpleTest.cpp     |   0
 .../Fuzzer/test/SimpleThreadedTest.cpp        |   0
 .../Fuzzer/test/SingleMemcmpTest.cpp          |   0
 .../Fuzzer/test/SingleStrcmpTest.cpp          |   0
 .../Fuzzer/test/SingleStrncmpTest.cpp         |   0
 .../thirdparty/Fuzzer/test/SpamyTest.cpp      |   0
 .../thirdparty/Fuzzer/test/StrcmpTest.cpp     |   0
 .../thirdparty/Fuzzer/test/StrncmpOOBTest.cpp |   0
 .../thirdparty/Fuzzer/test/StrncmpTest.cpp    |   0
 .../thirdparty/Fuzzer/test/StrstrTest.cpp     |   0
 .../thirdparty/Fuzzer/test/SwapCmpTest.cpp    |   0
 .../thirdparty/Fuzzer/test/Switch2Test.cpp    |   0
 .../thirdparty/Fuzzer/test/SwitchTest.cpp     |   0
 .../Fuzzer/test/ThreadedLeakTest.cpp          |   0
 .../thirdparty/Fuzzer/test/ThreadedTest.cpp   |   0
 .../Fuzzer/test/TimeoutEmptyTest.cpp          |   0
 .../thirdparty/Fuzzer/test/TimeoutTest.cpp    |   0
 .../Fuzzer/test/TraceMallocTest.cpp           |   0
 .../Fuzzer/test/UninstrumentedTest.cpp        |   0
 .../Fuzzer/test/afl-driver-extra-stats.test   |   0
 .../Fuzzer/test/afl-driver-stderr.test        |   0
 .../thirdparty/Fuzzer/test/caller-callee.test |   0
 .../thirdparty/Fuzzer/test/coverage.test      |   0
 .../thirdparty/Fuzzer/test/dict1.txt          |   0
 .../thirdparty/Fuzzer/test/dump_coverage.test |   0
 .../Fuzzer/test/fuzzer-customcrossover.test   |   0
 .../Fuzzer/test/fuzzer-custommutator.test     |   0
 .../thirdparty/Fuzzer/test/fuzzer-dict.test   |   0
 .../thirdparty/Fuzzer/test/fuzzer-dirs.test   |   0
 .../thirdparty/Fuzzer/test/fuzzer-fdmask.test |   0
 .../Fuzzer/test/fuzzer-finalstats.test        |   0
 .../thirdparty/Fuzzer/test/fuzzer-flags.test  |   0
 .../thirdparty/Fuzzer/test/fuzzer-jobs.test   |   0
 .../thirdparty/Fuzzer/test/fuzzer-leak.test   |   0
 .../Fuzzer/test/fuzzer-oom-with-profile.test  |   0
 .../thirdparty/Fuzzer/test/fuzzer-oom.test    |   0
 .../Fuzzer/test/fuzzer-printcovpcs.test       |   0
 .../thirdparty/Fuzzer/test/fuzzer-runs.test   |   0
 .../thirdparty/Fuzzer/test/fuzzer-seed.test   |   0
 .../thirdparty/Fuzzer/test/fuzzer-segv.test   |   0
 .../Fuzzer/test/fuzzer-singleinputs.test      |   0
 .../Fuzzer/test/fuzzer-threaded.test          |   0
 .../Fuzzer/test/fuzzer-timeout.test           |   0
 .../Fuzzer/test/fuzzer-traces-hooks.test      |   0
 .../thirdparty/Fuzzer/test/fuzzer-ubsan.test  |   0
 .../thirdparty/Fuzzer/test/fuzzer.test        |   0
 {test => tests}/thirdparty/Fuzzer/test/hi.txt |   0
 .../thirdparty/Fuzzer/test/lit.cfg            |   0
 .../thirdparty/Fuzzer/test/lit.site.cfg.in    |   0
 .../thirdparty/Fuzzer/test/merge.test         |   0
 .../Fuzzer/test/minimize_crash.test           |   0
 .../Fuzzer/test/no-coverage/CMakeLists.txt    |   0
 .../Fuzzer/test/repeated-bytes.test           |   0
 .../thirdparty/Fuzzer/test/shrink.test        |   0
 .../thirdparty/Fuzzer/test/simple-cmp.test    |   0
 .../thirdparty/Fuzzer/test/standalone.test    |   0
 .../thirdparty/Fuzzer/test/swap-cmp.test      |   0
 .../thirdparty/Fuzzer/test/trace-malloc.test  |   0
 .../Fuzzer/test/ubsan/CMakeLists.txt          |   0
 .../thirdparty/Fuzzer/test/ulimit.test        |   0
 .../Fuzzer/test/uninstrumented/CMakeLists.txt |   0
 .../thirdparty/Fuzzer/test/unit/lit.cfg       |   0
 .../Fuzzer/test/unit/lit.site.cfg.in          |   0
 .../Fuzzer/test/value-profile-cmp.test        |   0
 .../Fuzzer/test/value-profile-cmp2.test       |   0
 .../Fuzzer/test/value-profile-cmp3.test       |   0
 .../Fuzzer/test/value-profile-cmp4.test       |   0
 .../Fuzzer/test/value-profile-div.test        |   0
 .../Fuzzer/test/value-profile-load.test       |   0
 .../Fuzzer/test/value-profile-mem.test        |   0
 .../Fuzzer/test/value-profile-set.test        |   0
 .../Fuzzer/test/value-profile-strcmp.test     |   0
 .../Fuzzer/test/value-profile-strncmp.test    |   0
 .../Fuzzer/test/value-profile-switch.test     |   0
 .../thirdparty/doctest/LICENSE.txt            |   0
 {test => tests}/thirdparty/doctest/doctest.h  |   0
 .../doctest/doctest_compatibility.h           |   0
 .../thirdparty/fifo_map/LICENSE.MIT           |   0
 .../thirdparty/fifo_map/fifo_map.hpp          |   0
 {test => tests}/thirdparty/imapdl/filterbr.py |   0
 {test => tests}/thirdparty/imapdl/gpl-3.0.txt |   0
 {third_party => tools}/amalgamate/CHANGES.md  |   0
 {third_party => tools}/amalgamate/LICENSE.md  |   0
 {third_party => tools}/amalgamate/README.md   |   0
 .../amalgamate/amalgamate.py                  |   0
 {third_party => tools}/amalgamate/config.json |   0
 {third_party => tools}/cpplint/LICENSE        |   0
 {third_party => tools}/cpplint/README.rst     |   0
 {third_party => tools}/cpplint/cpplint.py     |   0
 {third_party => tools}/cpplint/update.sh      |   0
 .../gdb_pretty_printer/README.md              |   0
 .../gdb_pretty_printer/nlohmann-json.py       |   0
 {third_party => tools}/macro_builder/main.cpp |   0
 865 files changed, 52 insertions(+), 51 deletions(-)
 rename CODE_OF_CONDUCT.md => .github/CODE_OF_CONDUCT.md (100%)
 rename .drone.yml => .github/external_ci/.drone.yml (97%)
 rename appveyor.yml => .github/external_ci/appveyor.yml (100%)
 rename {doc => docs}/Makefile (100%)
 rename {doc => docs}/README.md (95%)
 rename {doc => docs}/avatars.png (100%)
 rename {doc => docs}/docset/Info.plist (100%)
 rename {doc => docs}/docset/Makefile (100%)
 rename {doc => docs}/docset/README.md (100%)
 rename {doc => docs}/docset/docSet.sql (100%)
 rename {doc => docs}/docset/docset.json (100%)
 rename {doc => docs}/docset/icon.png (100%)
 rename {doc => docs}/docset/icon@2x.png (100%)
 rename {doc => docs}/examples/README.cpp (100%)
 rename {doc => docs}/examples/README.output (100%)
 rename {doc => docs}/examples/accept__string.cpp (100%)
 rename {doc => docs}/examples/accept__string.output (100%)
 rename {doc => docs}/examples/array.cpp (100%)
 rename {doc => docs}/examples/array.output (100%)
 rename {doc => docs}/examples/array_t.cpp (100%)
 rename {doc => docs}/examples/array_t.output (100%)
 rename {doc => docs}/examples/at__object_t_key_type.cpp (100%)
 rename {doc => docs}/examples/at__object_t_key_type.output (100%)
 rename {doc => docs}/examples/at__object_t_key_type_const.cpp (100%)
 rename {doc => docs}/examples/at__object_t_key_type_const.output (100%)
 rename {doc => docs}/examples/at__size_type.cpp (100%)
 rename {doc => docs}/examples/at__size_type.output (100%)
 rename {doc => docs}/examples/at__size_type_const.cpp (100%)
 rename {doc => docs}/examples/at__size_type_const.output (100%)
 rename {doc => docs}/examples/at_json_pointer.cpp (100%)
 rename {doc => docs}/examples/at_json_pointer.output (100%)
 rename {doc => docs}/examples/at_json_pointer_const.cpp (100%)
 rename {doc => docs}/examples/at_json_pointer_const.output (100%)
 rename {doc => docs}/examples/back.cpp (100%)
 rename {doc => docs}/examples/back.output (100%)
 rename {doc => docs}/examples/basic_json__CompatibleType.cpp (100%)
 rename {doc => docs}/examples/basic_json__CompatibleType.output (100%)
 rename {doc => docs}/examples/basic_json__InputIt_InputIt.cpp (100%)
 rename {doc => docs}/examples/basic_json__InputIt_InputIt.output (100%)
 rename {doc => docs}/examples/basic_json__basic_json.cpp (100%)
 rename {doc => docs}/examples/basic_json__basic_json.output (100%)
 rename {doc => docs}/examples/basic_json__copyassignment.cpp (100%)
 rename {doc => docs}/examples/basic_json__copyassignment.output (100%)
 rename {doc => docs}/examples/basic_json__list_init_t.cpp (100%)
 rename {doc => docs}/examples/basic_json__list_init_t.output (100%)
 rename {doc => docs}/examples/basic_json__moveconstructor.cpp (100%)
 rename {doc => docs}/examples/basic_json__moveconstructor.output (100%)
 rename {doc => docs}/examples/basic_json__nullptr_t.cpp (100%)
 rename {doc => docs}/examples/basic_json__nullptr_t.output (100%)
 rename {doc => docs}/examples/basic_json__size_type_basic_json.cpp (100%)
 rename {doc => docs}/examples/basic_json__size_type_basic_json.output (100%)
 rename {doc => docs}/examples/basic_json__value.cpp (100%)
 rename {doc => docs}/examples/basic_json__value.output (100%)
 rename {doc => docs}/examples/basic_json__value_ptr.cpp (100%)
 rename {doc => docs}/examples/basic_json__value_ptr.output (100%)
 rename {doc => docs}/examples/basic_json__value_t.cpp (100%)
 rename {doc => docs}/examples/basic_json__value_t.output (100%)
 rename {doc => docs}/examples/begin.cpp (100%)
 rename {doc => docs}/examples/begin.output (100%)
 rename {doc => docs}/examples/binary.cpp (100%)
 rename {doc => docs}/examples/binary.output (100%)
 rename {doc => docs}/examples/binary_t.cpp (100%)
 rename {doc => docs}/examples/binary_t.output (100%)
 rename {doc => docs}/examples/boolean_t.cpp (100%)
 rename {doc => docs}/examples/boolean_t.output (100%)
 rename {doc => docs}/examples/cbegin.cpp (100%)
 rename {doc => docs}/examples/cbegin.output (100%)
 rename {doc => docs}/examples/cend.cpp (100%)
 rename {doc => docs}/examples/cend.output (100%)
 rename {doc => docs}/examples/clear.cpp (100%)
 rename {doc => docs}/examples/clear.output (100%)
 rename {doc => docs}/examples/contains.cpp (100%)
 rename {doc => docs}/examples/contains.output (100%)
 rename {doc => docs}/examples/contains_json_pointer.cpp (100%)
 rename {doc => docs}/examples/contains_json_pointer.output (100%)
 rename {doc => docs}/examples/count.cpp (100%)
 rename {doc => docs}/examples/count.output (100%)
 rename {doc => docs}/examples/crbegin.cpp (100%)
 rename {doc => docs}/examples/crbegin.output (100%)
 rename {doc => docs}/examples/crend.cpp (100%)
 rename {doc => docs}/examples/crend.output (100%)
 rename {doc => docs}/examples/diagnostics_extended.cpp (100%)
 rename {doc => docs}/examples/diagnostics_extended.output (100%)
 rename {doc => docs}/examples/diagnostics_standard.cpp (100%)
 rename {doc => docs}/examples/diagnostics_standard.output (100%)
 rename {doc => docs}/examples/diff.cpp (100%)
 rename {doc => docs}/examples/diff.output (100%)
 rename {doc => docs}/examples/dump.cpp (100%)
 rename {doc => docs}/examples/dump.output (100%)
 rename {doc => docs}/examples/emplace.cpp (100%)
 rename {doc => docs}/examples/emplace.output (100%)
 rename {doc => docs}/examples/emplace_back.cpp (100%)
 rename {doc => docs}/examples/emplace_back.output (100%)
 rename {doc => docs}/examples/empty.cpp (100%)
 rename {doc => docs}/examples/empty.output (100%)
 rename {doc => docs}/examples/end.cpp (100%)
 rename {doc => docs}/examples/end.output (100%)
 rename {doc => docs}/examples/erase__IteratorType.cpp (100%)
 rename {doc => docs}/examples/erase__IteratorType.output (100%)
 rename {doc => docs}/examples/erase__IteratorType_IteratorType.cpp (100%)
 rename {doc => docs}/examples/erase__IteratorType_IteratorType.output (100%)
 rename {doc => docs}/examples/erase__key_type.cpp (100%)
 rename {doc => docs}/examples/erase__key_type.output (100%)
 rename {doc => docs}/examples/erase__size_type.cpp (100%)
 rename {doc => docs}/examples/erase__size_type.output (100%)
 rename {doc => docs}/examples/exception.cpp (100%)
 rename {doc => docs}/examples/exception.output (100%)
 rename {doc => docs}/examples/find__key_type.cpp (100%)
 rename {doc => docs}/examples/find__key_type.output (100%)
 rename {doc => docs}/examples/flatten.cpp (100%)
 rename {doc => docs}/examples/flatten.output (100%)
 rename {doc => docs}/examples/from_bson.cpp (100%)
 rename {doc => docs}/examples/from_bson.output (100%)
 rename {doc => docs}/examples/from_cbor.cpp (100%)
 rename {doc => docs}/examples/from_cbor.output (100%)
 rename {doc => docs}/examples/from_msgpack.cpp (100%)
 rename {doc => docs}/examples/from_msgpack.output (100%)
 rename {doc => docs}/examples/from_ubjson.cpp (100%)
 rename {doc => docs}/examples/from_ubjson.output (100%)
 rename {doc => docs}/examples/front.cpp (100%)
 rename {doc => docs}/examples/front.output (100%)
 rename {doc => docs}/examples/get__PointerType.cpp (100%)
 rename {doc => docs}/examples/get__PointerType.output (100%)
 rename {doc => docs}/examples/get__ValueType_const.cpp (100%)
 rename {doc => docs}/examples/get__ValueType_const.output (100%)
 rename {doc => docs}/examples/get_binary.cpp (100%)
 rename {doc => docs}/examples/get_binary.output (100%)
 rename {doc => docs}/examples/get_ptr.cpp (100%)
 rename {doc => docs}/examples/get_ptr.output (100%)
 rename {doc => docs}/examples/get_ref.cpp (100%)
 rename {doc => docs}/examples/get_ref.output (100%)
 rename {doc => docs}/examples/get_to.cpp (100%)
 rename {doc => docs}/examples/get_to.output (100%)
 rename {doc => docs}/examples/insert.cpp (100%)
 rename {doc => docs}/examples/insert.output (100%)
 rename {doc => docs}/examples/insert__count.cpp (100%)
 rename {doc => docs}/examples/insert__count.output (100%)
 rename {doc => docs}/examples/insert__ilist.cpp (100%)
 rename {doc => docs}/examples/insert__ilist.output (100%)
 rename {doc => docs}/examples/insert__range.cpp (100%)
 rename {doc => docs}/examples/insert__range.output (100%)
 rename {doc => docs}/examples/insert__range_object.cpp (100%)
 rename {doc => docs}/examples/insert__range_object.output (100%)
 rename {doc => docs}/examples/invalid_iterator.cpp (100%)
 rename {doc => docs}/examples/invalid_iterator.output (100%)
 rename {doc => docs}/examples/is_array.cpp (100%)
 rename {doc => docs}/examples/is_array.output (100%)
 rename {doc => docs}/examples/is_binary.cpp (100%)
 rename {doc => docs}/examples/is_binary.output (100%)
 rename {doc => docs}/examples/is_boolean.cpp (100%)
 rename {doc => docs}/examples/is_boolean.output (100%)
 rename {doc => docs}/examples/is_discarded.cpp (100%)
 rename {doc => docs}/examples/is_discarded.output (100%)
 rename {doc => docs}/examples/is_null.cpp (100%)
 rename {doc => docs}/examples/is_null.output (100%)
 rename {doc => docs}/examples/is_number.cpp (100%)
 rename {doc => docs}/examples/is_number.output (100%)
 rename {doc => docs}/examples/is_number_float.cpp (100%)
 rename {doc => docs}/examples/is_number_float.output (100%)
 rename {doc => docs}/examples/is_number_integer.cpp (100%)
 rename {doc => docs}/examples/is_number_integer.output (100%)
 rename {doc => docs}/examples/is_number_unsigned.cpp (100%)
 rename {doc => docs}/examples/is_number_unsigned.output (100%)
 rename {doc => docs}/examples/is_object.cpp (100%)
 rename {doc => docs}/examples/is_object.output (100%)
 rename {doc => docs}/examples/is_primitive.cpp (100%)
 rename {doc => docs}/examples/is_primitive.output (100%)
 rename {doc => docs}/examples/is_string.cpp (100%)
 rename {doc => docs}/examples/is_string.output (100%)
 rename {doc => docs}/examples/is_structured.cpp (100%)
 rename {doc => docs}/examples/is_structured.output (100%)
 rename {doc => docs}/examples/items.cpp (100%)
 rename {doc => docs}/examples/items.output (100%)
 rename {doc => docs}/examples/iterator_wrapper.cpp (100%)
 rename {doc => docs}/examples/iterator_wrapper.output (100%)
 rename {doc => docs}/examples/json_lines.cpp (100%)
 rename {doc => docs}/examples/json_lines.output (100%)
 rename {doc => docs}/examples/json_pointer.cpp (100%)
 rename {doc => docs}/examples/json_pointer.output (100%)
 rename {doc => docs}/examples/json_pointer__back.cpp (100%)
 rename {doc => docs}/examples/json_pointer__back.output (100%)
 rename {doc => docs}/examples/json_pointer__empty.cpp (100%)
 rename {doc => docs}/examples/json_pointer__empty.output (100%)
 rename {doc => docs}/examples/json_pointer__operator_add.cpp (100%)
 rename {doc => docs}/examples/json_pointer__operator_add.output (100%)
 rename {doc => docs}/examples/json_pointer__operator_add_binary.cpp (100%)
 rename {doc => docs}/examples/json_pointer__operator_add_binary.output (100%)
 rename {doc => docs}/examples/json_pointer__parent_pointer.cpp (100%)
 rename {doc => docs}/examples/json_pointer__parent_pointer.output (100%)
 rename {doc => docs}/examples/json_pointer__pop_back.cpp (100%)
 rename {doc => docs}/examples/json_pointer__pop_back.output (100%)
 rename {doc => docs}/examples/json_pointer__push_back.cpp (100%)
 rename {doc => docs}/examples/json_pointer__push_back.output (100%)
 rename {doc => docs}/examples/json_pointer__to_string.cpp (100%)
 rename {doc => docs}/examples/json_pointer__to_string.output (100%)
 rename {doc => docs}/examples/max_size.cpp (100%)
 rename {doc => docs}/examples/max_size.output (100%)
 rename {doc => docs}/examples/merge_patch.cpp (100%)
 rename {doc => docs}/examples/merge_patch.output (100%)
 rename {doc => docs}/examples/meta.cpp (100%)
 rename {doc => docs}/examples/meta.output (100%)
 rename {doc => docs}/examples/nlohmann_define_type_intrusive_explicit.cpp (100%)
 rename {doc => docs}/examples/nlohmann_define_type_intrusive_explicit.output (100%)
 rename {doc => docs}/examples/nlohmann_define_type_intrusive_macro.cpp (100%)
 rename {doc => docs}/examples/nlohmann_define_type_intrusive_macro.output (100%)
 rename {doc => docs}/examples/nlohmann_define_type_intrusive_with_default_explicit.cpp (100%)
 rename {doc => docs}/examples/nlohmann_define_type_intrusive_with_default_explicit.output (100%)
 rename {doc => docs}/examples/nlohmann_define_type_intrusive_with_default_macro.cpp (100%)
 rename {doc => docs}/examples/nlohmann_define_type_intrusive_with_default_macro.output (100%)
 rename {doc => docs}/examples/nlohmann_define_type_non_intrusive_explicit.cpp (100%)
 rename {doc => docs}/examples/nlohmann_define_type_non_intrusive_explicit.output (100%)
 rename {doc => docs}/examples/nlohmann_define_type_non_intrusive_macro.cpp (100%)
 rename {doc => docs}/examples/nlohmann_define_type_non_intrusive_macro.output (100%)
 rename {doc => docs}/examples/nlohmann_define_type_non_intrusive_with_default_explicit.cpp (100%)
 rename {doc => docs}/examples/nlohmann_define_type_non_intrusive_with_default_explicit.output (100%)
 rename {doc => docs}/examples/nlohmann_define_type_non_intrusive_with_default_macro.cpp (100%)
 rename {doc => docs}/examples/nlohmann_define_type_non_intrusive_with_default_macro.output (100%)
 rename {doc => docs}/examples/nlohmann_json_serialize_enum.cpp (100%)
 rename {doc => docs}/examples/nlohmann_json_serialize_enum.output (100%)
 rename {doc => docs}/examples/nlohmann_json_serialize_enum_2.cpp (100%)
 rename {doc => docs}/examples/nlohmann_json_serialize_enum_2.output (100%)
 rename {doc => docs}/examples/number_float_t.cpp (100%)
 rename {doc => docs}/examples/number_float_t.output (100%)
 rename {doc => docs}/examples/number_integer_t.cpp (100%)
 rename {doc => docs}/examples/number_integer_t.output (100%)
 rename {doc => docs}/examples/number_unsigned_t.cpp (100%)
 rename {doc => docs}/examples/number_unsigned_t.output (100%)
 rename {doc => docs}/examples/object.cpp (100%)
 rename {doc => docs}/examples/object.output (100%)
 rename {doc => docs}/examples/object_t.cpp (100%)
 rename {doc => docs}/examples/object_t.output (100%)
 rename {doc => docs}/examples/operator__ValueType.cpp (100%)
 rename {doc => docs}/examples/operator__ValueType.output (100%)
 rename {doc => docs}/examples/operator__equal.cpp (100%)
 rename {doc => docs}/examples/operator__equal.output (100%)
 rename {doc => docs}/examples/operator__equal__nullptr_t.cpp (100%)
 rename {doc => docs}/examples/operator__equal__nullptr_t.output (100%)
 rename {doc => docs}/examples/operator__greater.cpp (100%)
 rename {doc => docs}/examples/operator__greater.output (100%)
 rename {doc => docs}/examples/operator__greaterequal.cpp (100%)
 rename {doc => docs}/examples/operator__greaterequal.output (100%)
 rename {doc => docs}/examples/operator__less.cpp (100%)
 rename {doc => docs}/examples/operator__less.output (100%)
 rename {doc => docs}/examples/operator__lessequal.cpp (100%)
 rename {doc => docs}/examples/operator__lessequal.output (100%)
 rename {doc => docs}/examples/operator__notequal.cpp (100%)
 rename {doc => docs}/examples/operator__notequal.output (100%)
 rename {doc => docs}/examples/operator__notequal__nullptr_t.cpp (100%)
 rename {doc => docs}/examples/operator__notequal__nullptr_t.output (100%)
 rename {doc => docs}/examples/operator__value_t.cpp (100%)
 rename {doc => docs}/examples/operator__value_t.output (100%)
 rename {doc => docs}/examples/operator_deserialize.cpp (100%)
 rename {doc => docs}/examples/operator_deserialize.output (100%)
 rename {doc => docs}/examples/operator_literal_json.cpp (100%)
 rename {doc => docs}/examples/operator_literal_json.output (100%)
 rename {doc => docs}/examples/operator_literal_json_pointer.cpp (100%)
 rename {doc => docs}/examples/operator_literal_json_pointer.output (100%)
 rename {doc => docs}/examples/operator_serialize.cpp (100%)
 rename {doc => docs}/examples/operator_serialize.output (100%)
 rename {doc => docs}/examples/operatorarray__key_type.cpp (100%)
 rename {doc => docs}/examples/operatorarray__key_type.output (100%)
 rename {doc => docs}/examples/operatorarray__key_type_const.cpp (100%)
 rename {doc => docs}/examples/operatorarray__key_type_const.output (100%)
 rename {doc => docs}/examples/operatorarray__size_type.cpp (100%)
 rename {doc => docs}/examples/operatorarray__size_type.output (100%)
 rename {doc => docs}/examples/operatorarray__size_type_const.cpp (100%)
 rename {doc => docs}/examples/operatorarray__size_type_const.output (100%)
 rename {doc => docs}/examples/operatorjson_pointer.cpp (100%)
 rename {doc => docs}/examples/operatorjson_pointer.output (100%)
 rename {doc => docs}/examples/operatorjson_pointer_const.cpp (100%)
 rename {doc => docs}/examples/operatorjson_pointer_const.output (100%)
 rename {doc => docs}/examples/ordered_map.cpp (100%)
 rename {doc => docs}/examples/ordered_map.output (100%)
 rename {doc => docs}/examples/other_error.cpp (100%)
 rename {doc => docs}/examples/other_error.output (100%)
 rename {doc => docs}/examples/out_of_range.cpp (100%)
 rename {doc => docs}/examples/out_of_range.output (100%)
 rename {doc => docs}/examples/parse__allow_exceptions.cpp (100%)
 rename {doc => docs}/examples/parse__allow_exceptions.output (100%)
 rename {doc => docs}/examples/parse__array__parser_callback_t.cpp (100%)
 rename {doc => docs}/examples/parse__array__parser_callback_t.output (100%)
 rename {doc => docs}/examples/parse__contiguouscontainer__parser_callback_t.cpp (100%)
 rename {doc => docs}/examples/parse__contiguouscontainer__parser_callback_t.output (100%)
 rename {doc => docs}/examples/parse__istream__parser_callback_t.cpp (100%)
 rename {doc => docs}/examples/parse__istream__parser_callback_t.output (100%)
 rename {doc => docs}/examples/parse__iterator_pair.cpp (100%)
 rename {doc => docs}/examples/parse__iterator_pair.link (100%)
 rename {doc => docs}/examples/parse__iterator_pair.output (100%)
 rename {doc => docs}/examples/parse__pointers.cpp (100%)
 rename {doc => docs}/examples/parse__pointers.link (100%)
 rename {doc => docs}/examples/parse__pointers.output (100%)
 rename {doc => docs}/examples/parse__string__parser_callback_t.cpp (100%)
 rename {doc => docs}/examples/parse__string__parser_callback_t.output (100%)
 rename {doc => docs}/examples/parse_error.cpp (100%)
 rename {doc => docs}/examples/parse_error.output (100%)
 rename {doc => docs}/examples/patch.cpp (100%)
 rename {doc => docs}/examples/patch.output (100%)
 rename {doc => docs}/examples/push_back.cpp (100%)
 rename {doc => docs}/examples/push_back.output (100%)
 rename {doc => docs}/examples/push_back__initializer_list.cpp (100%)
 rename {doc => docs}/examples/push_back__initializer_list.output (100%)
 rename {doc => docs}/examples/push_back__object_t__value.cpp (100%)
 rename {doc => docs}/examples/push_back__object_t__value.output (100%)
 rename {doc => docs}/examples/rbegin.cpp (100%)
 rename {doc => docs}/examples/rbegin.output (100%)
 rename {doc => docs}/examples/rend.cpp (100%)
 rename {doc => docs}/examples/rend.output (100%)
 rename {doc => docs}/examples/sax_parse.cpp (100%)
 rename {doc => docs}/examples/sax_parse.output (100%)
 rename {doc => docs}/examples/size.cpp (100%)
 rename {doc => docs}/examples/size.output (100%)
 rename {doc => docs}/examples/std_hash.cpp (100%)
 rename {doc => docs}/examples/std_hash.output (100%)
 rename {doc => docs}/examples/std_swap.cpp (100%)
 rename {doc => docs}/examples/std_swap.output (100%)
 rename {doc => docs}/examples/string_t.cpp (100%)
 rename {doc => docs}/examples/string_t.output (100%)
 rename {doc => docs}/examples/swap__array_t.cpp (100%)
 rename {doc => docs}/examples/swap__array_t.output (100%)
 rename {doc => docs}/examples/swap__binary_t.cpp (100%)
 rename {doc => docs}/examples/swap__binary_t.output (100%)
 rename {doc => docs}/examples/swap__object_t.cpp (100%)
 rename {doc => docs}/examples/swap__object_t.output (100%)
 rename {doc => docs}/examples/swap__reference.cpp (100%)
 rename {doc => docs}/examples/swap__reference.output (100%)
 rename {doc => docs}/examples/swap__string_t.cpp (100%)
 rename {doc => docs}/examples/swap__string_t.output (100%)
 rename {doc => docs}/examples/to_bson.cpp (100%)
 rename {doc => docs}/examples/to_bson.output (100%)
 rename {doc => docs}/examples/to_cbor.cpp (100%)
 rename {doc => docs}/examples/to_cbor.output (100%)
 rename {doc => docs}/examples/to_msgpack.cpp (100%)
 rename {doc => docs}/examples/to_msgpack.output (100%)
 rename {doc => docs}/examples/to_string.cpp (100%)
 rename {doc => docs}/examples/to_string.output (100%)
 rename {doc => docs}/examples/to_ubjson.cpp (100%)
 rename {doc => docs}/examples/to_ubjson.output (100%)
 rename {doc => docs}/examples/type.cpp (100%)
 rename {doc => docs}/examples/type.output (100%)
 rename {doc => docs}/examples/type_error.cpp (100%)
 rename {doc => docs}/examples/type_error.output (100%)
 rename {doc => docs}/examples/type_name.cpp (100%)
 rename {doc => docs}/examples/type_name.output (100%)
 rename {doc => docs}/examples/unflatten.cpp (100%)
 rename {doc => docs}/examples/unflatten.output (100%)
 rename {doc => docs}/examples/update.cpp (100%)
 rename {doc => docs}/examples/update.output (100%)
 rename {doc => docs}/examples/update__range.cpp (100%)
 rename {doc => docs}/examples/update__range.output (100%)
 rename {doc => docs}/index.md (100%)
 rename {doc => docs}/json.gif (100%)
 rename {doc => docs}/mkdocs/Makefile (100%)
 rename {doc => docs}/mkdocs/docs/api/adl_serializer/from_json.md (100%)
 rename {doc => docs}/mkdocs/docs/api/adl_serializer/index.md (100%)
 rename {doc => docs}/mkdocs/docs/api/adl_serializer/to_json.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/accept.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/array.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/array_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/at.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/back.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/basic_json.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/begin.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/binary.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/binary_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/boolean_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/cbegin.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/cend.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/clear.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/contains.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/count.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/crbegin.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/crend.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/default_object_comparator_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/diff.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/dump.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/emplace.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/emplace_back.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/empty.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/end.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/erase.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/error_handler_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/exception.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/find.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/flatten.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/from_bson.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/from_cbor.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/from_msgpack.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/from_ubjson.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/front.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/get.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/get_allocator.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/get_binary.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/get_ptr.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/get_ref.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/get_to.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/index.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/input_format_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/insert.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/invalid_iterator.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/is_array.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/is_binary.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/is_boolean.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/is_discarded.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/is_null.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/is_number.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/is_number_float.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/is_number_integer.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/is_number_unsigned.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/is_object.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/is_primitive.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/is_string.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/is_structured.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/items.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/json_serializer.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/max_size.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/merge_patch.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/meta.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/number_float_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/number_integer_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/number_unsigned_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/object.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/object_comparator_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/object_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator+=.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator=.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator[].md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator_ValueType.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator_eq.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator_ge.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator_gt.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator_gtgt.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator_le.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator_literal_json.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator_literal_json_pointer.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator_lt.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator_ltlt.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator_ne.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/operator_value_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/other_error.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/out_of_range.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/parse.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/parse_error.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/parse_event_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/parser_callback_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/patch.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/push_back.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/rbegin.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/rend.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/sax_parse.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/size.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/std_hash.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/std_swap.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/string_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/swap.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/to_bson.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/to_cbor.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/to_msgpack.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/to_string.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/to_ubjson.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/type.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/type_error.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/type_name.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/unflatten.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/update.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/value.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/value_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/basic_json/~basic_json.md (100%)
 rename {doc => docs}/mkdocs/docs/api/byte_container_with_subtype/byte_container_with_subtype.md (100%)
 rename {doc => docs}/mkdocs/docs/api/byte_container_with_subtype/clear_subtype.md (100%)
 rename {doc => docs}/mkdocs/docs/api/byte_container_with_subtype/has_subtype.md (100%)
 rename {doc => docs}/mkdocs/docs/api/byte_container_with_subtype/index.md (100%)
 rename {doc => docs}/mkdocs/docs/api/byte_container_with_subtype/set_subtype.md (100%)
 rename {doc => docs}/mkdocs/docs/api/byte_container_with_subtype/subtype.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_pointer/back.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_pointer/empty.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_pointer/index.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_pointer/json_pointer.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_pointer/operator_slash.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_pointer/operator_slasheq.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_pointer/operator_string.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_pointer/parent_pointer.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_pointer/pop_back.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_pointer/push_back.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_pointer/string_t.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_pointer/to_string.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_sax/binary.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_sax/boolean.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_sax/end_array.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_sax/end_object.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_sax/index.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_sax/key.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_sax/null.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_sax/number_float.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_sax/number_integer.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_sax/number_unsigned.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_sax/parse_error.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_sax/start_array.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_sax/start_object.md (100%)
 rename {doc => docs}/mkdocs/docs/api/json_sax/string.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/index.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/json_assert.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/json_diagnostics.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/json_has_cpp_11.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/json_has_filesystem.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/json_no_io.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/json_noexception.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/json_skip_library_version_check.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/json_throw_user.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/json_use_implicit_conversions.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/nlohmann_define_type_intrusive.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/nlohmann_define_type_non_intrusive.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md (100%)
 rename {doc => docs}/mkdocs/docs/api/macros/nlohmann_json_version_major.md (100%)
 rename {doc => docs}/mkdocs/docs/api/ordered_json.md (100%)
 rename {doc => docs}/mkdocs/docs/api/ordered_map.md (100%)
 rename {doc => docs}/mkdocs/docs/features/arbitrary_types.md (100%)
 rename {doc => docs}/mkdocs/docs/features/assertions.md (100%)
 rename {doc => docs}/mkdocs/docs/features/binary_formats/bson.md (100%)
 rename {doc => docs}/mkdocs/docs/features/binary_formats/cbor.md (100%)
 rename {doc => docs}/mkdocs/docs/features/binary_formats/index.md (100%)
 rename {doc => docs}/mkdocs/docs/features/binary_formats/messagepack.md (100%)
 rename {doc => docs}/mkdocs/docs/features/binary_formats/ubjson.md (100%)
 rename {doc => docs}/mkdocs/docs/features/binary_values.md (100%)
 rename {doc => docs}/mkdocs/docs/features/comments.md (100%)
 rename {doc => docs}/mkdocs/docs/features/element_access/checked_access.md (100%)
 rename {doc => docs}/mkdocs/docs/features/element_access/default_value.md (100%)
 rename {doc => docs}/mkdocs/docs/features/element_access/index.md (100%)
 rename {doc => docs}/mkdocs/docs/features/element_access/unchecked_access.md (100%)
 rename {doc => docs}/mkdocs/docs/features/enum_conversion.md (100%)
 rename {doc => docs}/mkdocs/docs/features/iterators.md (100%)
 rename {doc => docs}/mkdocs/docs/features/json_patch.md (100%)
 rename {doc => docs}/mkdocs/docs/features/json_pointer.md (100%)
 rename {doc => docs}/mkdocs/docs/features/macros.md (100%)
 rename {doc => docs}/mkdocs/docs/features/merge_patch.md (100%)
 rename {doc => docs}/mkdocs/docs/features/object_order.md (100%)
 rename {doc => docs}/mkdocs/docs/features/parsing/index.md (100%)
 rename {doc => docs}/mkdocs/docs/features/parsing/json_lines.md (100%)
 rename {doc => docs}/mkdocs/docs/features/parsing/parse_exceptions.md (100%)
 rename {doc => docs}/mkdocs/docs/features/parsing/parser_callbacks.md (100%)
 rename {doc => docs}/mkdocs/docs/features/parsing/sax_interface.md (100%)
 rename {doc => docs}/mkdocs/docs/features/types/index.md (100%)
 rename {doc => docs}/mkdocs/docs/features/types/number_handling.md (100%)
 rename {doc => docs}/mkdocs/docs/home/code_of_conduct.md (100%)
 rename {doc => docs}/mkdocs/docs/home/design_goals.md (100%)
 rename {doc => docs}/mkdocs/docs/home/exceptions.md (100%)
 rename {doc => docs}/mkdocs/docs/home/faq.md (100%)
 rename {doc => docs}/mkdocs/docs/home/license.md (100%)
 rename {doc => docs}/mkdocs/docs/home/releases.md (100%)
 rename {doc => docs}/mkdocs/docs/home/sponsors.md (100%)
 rename {doc => docs}/mkdocs/docs/images/callback_events.png (100%)
 rename {doc => docs}/mkdocs/docs/images/json_syntax_number.png (100%)
 rename {doc => docs}/mkdocs/docs/images/range-begin-end.svg (100%)
 rename {doc => docs}/mkdocs/docs/images/range-rbegin-rend.svg (100%)
 rename {doc => docs}/mkdocs/docs/index.md (100%)
 rename {doc => docs}/mkdocs/docs/integration/cmake.md (100%)
 rename {doc => docs}/mkdocs/docs/integration/conan/CMakeLists.txt (100%)
 rename {doc => docs}/mkdocs/docs/integration/conan/Conanfile.txt (100%)
 rename {doc => docs}/mkdocs/docs/integration/conan/example.cpp (100%)
 rename {doc => docs}/mkdocs/docs/integration/example.cpp (100%)
 rename {doc => docs}/mkdocs/docs/integration/index.md (100%)
 rename {doc => docs}/mkdocs/docs/integration/package_managers.md (100%)
 rename {doc => docs}/mkdocs/docs/integration/pkg-config.md (100%)
 rename {doc => docs}/mkdocs/docs/integration/vcpkg/CMakeLists.txt (100%)
 rename {doc => docs}/mkdocs/docs/integration/vcpkg/example.cpp (100%)
 rename {doc => docs}/mkdocs/mkdocs.yml (99%)
 rename {doc => docs}/mkdocs/requirements.txt (100%)
 rename {doc => docs}/mkdocs/scripts/check_structure.py (100%)
 rename {doc => docs}/usages/ios.png (100%)
 rename {doc => docs}/usages/macos.png (100%)
 rename {test => tests}/CMakeLists.txt (100%)
 rename {test => tests}/Makefile (100%)
 rename {benchmarks => tests/benchmarks}/CMakeLists.txt (88%)
 rename {benchmarks => tests/benchmarks}/src/benchmarks.cpp (100%)
 rename {test => tests}/cmake_add_subdirectory/CMakeLists.txt (100%)
 rename {test => tests}/cmake_add_subdirectory/project/CMakeLists.txt (100%)
 rename {test => tests}/cmake_add_subdirectory/project/main.cpp (100%)
 rename {test => tests}/cmake_fetch_content/CMakeLists.txt (100%)
 rename {test => tests}/cmake_fetch_content/project/CMakeLists.txt (100%)
 rename {test => tests}/cmake_fetch_content/project/main.cpp (100%)
 rename {test => tests}/cmake_fetch_content2/CMakeLists.txt (100%)
 rename {test => tests}/cmake_fetch_content2/project/CMakeLists.txt (100%)
 rename {test => tests}/cmake_fetch_content2/project/main.cpp (100%)
 rename {test => tests}/cmake_import/CMakeLists.txt (100%)
 rename {test => tests}/cmake_import/project/CMakeLists.txt (100%)
 rename {test => tests}/cmake_import/project/main.cpp (100%)
 rename {test => tests}/cmake_import_minver/CMakeLists.txt (100%)
 rename {test => tests}/cmake_import_minver/project/CMakeLists.txt (100%)
 rename {test => tests}/cmake_import_minver/project/main.cpp (100%)
 rename {test => tests}/cmake_target_include_directories/CMakeLists.txt (100%)
 rename {test => tests}/cmake_target_include_directories/project/Bar.cpp (100%)
 rename {test => tests}/cmake_target_include_directories/project/Bar.hpp (100%)
 rename {test => tests}/cmake_target_include_directories/project/CMakeLists.txt (100%)
 rename {test => tests}/cmake_target_include_directories/project/Foo.cpp (100%)
 rename {test => tests}/cmake_target_include_directories/project/Foo.hpp (100%)
 rename {test => tests}/cmake_target_include_directories/project/main.cpp (100%)
 rename {test => tests}/cuda_example/CMakeLists.txt (100%)
 rename {test => tests}/cuda_example/json_cuda.cu (100%)
 rename {test => tests}/reports/2016-08-29-fuzz/exec_speed.png (100%)
 rename {test => tests}/reports/2016-08-29-fuzz/fuzz.tiff (100%)
 rename {test => tests}/reports/2016-08-29-fuzz/high_freq.png (100%)
 rename {test => tests}/reports/2016-08-29-fuzz/index.html (100%)
 rename {test => tests}/reports/2016-08-29-fuzz/low_freq.png (100%)
 rename {test => tests}/reports/2016-09-09-nativejson_benchmark/README.md (100%)
 rename {test => tests}/reports/2016-09-09-nativejson_benchmark/conformance_Nlohmann (C++11).md (100%)
 rename {test => tests}/reports/2016-09-09-nativejson_benchmark/conformance_overall_Result.png (100%)
 rename {test => tests}/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Memory_(byte).png (100%)
 rename {test => tests}/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Time_(ms).png (100%)
 rename {test => tests}/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_2._Stringify_Time_(ms).png (100%)
 rename {test => tests}/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_3._Prettify_Time_(ms).png (100%)
 rename {test => tests}/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_7._Code_size_FileSize_(byte).png (100%)
 rename {test => tests}/reports/2016-10-02-fuzz/exec_speed.png (100%)
 rename {test => tests}/reports/2016-10-02-fuzz/fuzz.tiff (100%)
 rename {test => tests}/reports/2016-10-02-fuzz/high_freq.png (100%)
 rename {test => tests}/reports/2016-10-02-fuzz/index.html (100%)
 rename {test => tests}/reports/2016-10-02-fuzz/low_freq.png (100%)
 rename {test => tests}/src/fuzzer-driver_afl.cpp (100%)
 rename {test => tests}/src/fuzzer-parse_bjdata.cpp (100%)
 rename {test => tests}/src/fuzzer-parse_bson.cpp (100%)
 rename {test => tests}/src/fuzzer-parse_cbor.cpp (100%)
 rename {test => tests}/src/fuzzer-parse_json.cpp (100%)
 rename {test => tests}/src/fuzzer-parse_msgpack.cpp (100%)
 rename {test => tests}/src/fuzzer-parse_ubjson.cpp (100%)
 rename {test => tests}/src/test_utils.hpp (100%)
 rename {test => tests}/src/unit-algorithms.cpp (100%)
 rename {test => tests}/src/unit-allocator.cpp (100%)
 rename {test => tests}/src/unit-alt-string.cpp (100%)
 rename {test => tests}/src/unit-assert_macro.cpp (100%)
 rename {test => tests}/src/unit-bjdata.cpp (100%)
 rename {test => tests}/src/unit-bson.cpp (100%)
 rename {test => tests}/src/unit-byte_container_with_subtype.cpp (100%)
 rename {test => tests}/src/unit-capacity.cpp (100%)
 rename {test => tests}/src/unit-cbor.cpp (100%)
 rename {test => tests}/src/unit-class_const_iterator.cpp (100%)
 rename {test => tests}/src/unit-class_iterator.cpp (100%)
 rename {test => tests}/src/unit-class_lexer.cpp (100%)
 rename {test => tests}/src/unit-class_parser.cpp (100%)
 rename {test => tests}/src/unit-comparison.cpp (100%)
 rename {test => tests}/src/unit-concepts.cpp (100%)
 rename {test => tests}/src/unit-constructor1.cpp (100%)
 rename {test => tests}/src/unit-constructor2.cpp (100%)
 rename {test => tests}/src/unit-convenience.cpp (100%)
 rename {test => tests}/src/unit-conversions.cpp (100%)
 rename {test => tests}/src/unit-deserialization.cpp (100%)
 rename {test => tests}/src/unit-diagnostics.cpp (100%)
 rename {test => tests}/src/unit-disabled_exceptions.cpp (100%)
 rename {test => tests}/src/unit-element_access1.cpp (100%)
 rename {test => tests}/src/unit-element_access2.cpp (100%)
 rename {test => tests}/src/unit-hash.cpp (100%)
 rename {test => tests}/src/unit-inspection.cpp (100%)
 rename {test => tests}/src/unit-items.cpp (100%)
 rename {test => tests}/src/unit-iterators1.cpp (100%)
 rename {test => tests}/src/unit-iterators2.cpp (100%)
 rename {test => tests}/src/unit-json_patch.cpp (100%)
 rename {test => tests}/src/unit-json_pointer.cpp (100%)
 rename {test => tests}/src/unit-large_json.cpp (100%)
 rename {test => tests}/src/unit-merge_patch.cpp (100%)
 rename {test => tests}/src/unit-meta.cpp (100%)
 rename {test => tests}/src/unit-modifiers.cpp (100%)
 rename {test => tests}/src/unit-msgpack.cpp (100%)
 rename {test => tests}/src/unit-noexcept.cpp (100%)
 rename {test => tests}/src/unit-ordered_json.cpp (100%)
 rename {test => tests}/src/unit-ordered_map.cpp (100%)
 rename {test => tests}/src/unit-pointer_access.cpp (100%)
 rename {test => tests}/src/unit-readme.cpp (100%)
 rename {test => tests}/src/unit-reference_access.cpp (100%)
 rename {test => tests}/src/unit-regression1.cpp (100%)
 rename {test => tests}/src/unit-regression2.cpp (100%)
 rename {test => tests}/src/unit-serialization.cpp (100%)
 rename {test => tests}/src/unit-testsuites.cpp (100%)
 rename {test => tests}/src/unit-to_chars.cpp (100%)
 rename {test => tests}/src/unit-ubjson.cpp (100%)
 rename {test => tests}/src/unit-udt.cpp (100%)
 rename {test => tests}/src/unit-udt_macro.cpp (100%)
 rename {test => tests}/src/unit-unicode1.cpp (100%)
 rename {test => tests}/src/unit-unicode2.cpp (100%)
 rename {test => tests}/src/unit-unicode3.cpp (100%)
 rename {test => tests}/src/unit-unicode4.cpp (100%)
 rename {test => tests}/src/unit-unicode5.cpp (100%)
 rename {test => tests}/src/unit-user_defined_input.cpp (100%)
 rename {test => tests}/src/unit-wstring.cpp (100%)
 rename {test => tests}/src/unit.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/CMakeLists.txt (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerCorpus.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerCrossOver.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerDefs.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerDictionary.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerDriver.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerExtFunctions.def (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerExtFunctions.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerExtFunctionsDlsym.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerExtFunctionsWeak.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerExtFunctionsWeakAlias.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerFlags.def (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerIO.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerIO.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerIOPosix.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerIOWindows.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerInterface.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerInternal.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerLoop.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerMain.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerMerge.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerMerge.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerMutate.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerMutate.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerOptions.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerRandom.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerSHA1.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerSHA1.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerTracePC.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerTracePC.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerTraceState.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerUtil.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerUtil.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerUtilDarwin.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerUtilLinux.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerUtilPosix.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerUtilWindows.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/FuzzerValueBitMap.h (100%)
 rename {test => tests}/thirdparty/Fuzzer/README.txt (100%)
 rename {test => tests}/thirdparty/Fuzzer/afl/afl_driver.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/build.sh (100%)
 rename {test => tests}/thirdparty/Fuzzer/cxx.dict (100%)
 rename {test => tests}/thirdparty/Fuzzer/standalone/StandaloneFuzzTargetMain.c (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/AFLDriverTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/AbsNegAndConstant64Test.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/AbsNegAndConstantTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/AccumulateAllocationsTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/BufferOverflowOnInput.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/CMakeLists.txt (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/CallerCalleeTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/CounterTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/CustomCrossOverTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/CustomMutatorTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/DSO1.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/DSO2.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/DSOTestExtra.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/DSOTestMain.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/DivTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/EmptyTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/FourIndependentBranchesTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/FullCoverageSetTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/FuzzerUnittest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/InitializeTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/LeakTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/LeakTimeoutTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/LoadTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/MemcmpTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/NthRunCrashTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/NullDerefOnEmptyTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/NullDerefTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/OneHugeAllocTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/OutOfMemorySingleLargeMallocTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/OutOfMemoryTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/RepeatedBytesTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/RepeatedMemcmp.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/ShrinkControlFlowTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/ShrinkValueProfileTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/SignedIntOverflowTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/SimpleCmpTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/SimpleDictionaryTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/SimpleHashTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/SimpleTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/SimpleThreadedTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/SingleMemcmpTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/SingleStrcmpTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/SingleStrncmpTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/SpamyTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/StrcmpTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/StrncmpOOBTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/StrncmpTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/StrstrTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/SwapCmpTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/Switch2Test.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/SwitchTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/ThreadedLeakTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/ThreadedTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/TimeoutEmptyTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/TimeoutTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/TraceMallocTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/UninstrumentedTest.cpp (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/afl-driver-extra-stats.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/afl-driver-stderr.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/caller-callee.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/coverage.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/dict1.txt (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/dump_coverage.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-customcrossover.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-custommutator.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-dict.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-dirs.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-fdmask.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-finalstats.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-flags.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-jobs.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-leak.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-oom-with-profile.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-oom.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-printcovpcs.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-runs.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-seed.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-segv.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-singleinputs.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-threaded.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-timeout.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-traces-hooks.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer-ubsan.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/fuzzer.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/hi.txt (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/lit.cfg (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/lit.site.cfg.in (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/merge.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/minimize_crash.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/no-coverage/CMakeLists.txt (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/repeated-bytes.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/shrink.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/simple-cmp.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/standalone.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/swap-cmp.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/trace-malloc.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/ubsan/CMakeLists.txt (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/ulimit.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/uninstrumented/CMakeLists.txt (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/unit/lit.cfg (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/unit/lit.site.cfg.in (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/value-profile-cmp.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/value-profile-cmp2.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/value-profile-cmp3.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/value-profile-cmp4.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/value-profile-div.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/value-profile-load.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/value-profile-mem.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/value-profile-set.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/value-profile-strcmp.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/value-profile-strncmp.test (100%)
 rename {test => tests}/thirdparty/Fuzzer/test/value-profile-switch.test (100%)
 rename {test => tests}/thirdparty/doctest/LICENSE.txt (100%)
 rename {test => tests}/thirdparty/doctest/doctest.h (100%)
 rename {test => tests}/thirdparty/doctest/doctest_compatibility.h (100%)
 rename {test => tests}/thirdparty/fifo_map/LICENSE.MIT (100%)
 rename {test => tests}/thirdparty/fifo_map/fifo_map.hpp (100%)
 rename {test => tests}/thirdparty/imapdl/filterbr.py (100%)
 rename {test => tests}/thirdparty/imapdl/gpl-3.0.txt (100%)
 rename {third_party => tools}/amalgamate/CHANGES.md (100%)
 rename {third_party => tools}/amalgamate/LICENSE.md (100%)
 rename {third_party => tools}/amalgamate/README.md (100%)
 rename {third_party => tools}/amalgamate/amalgamate.py (100%)
 rename {third_party => tools}/amalgamate/config.json (100%)
 rename {third_party => tools}/cpplint/LICENSE (100%)
 rename {third_party => tools}/cpplint/README.rst (100%)
 rename {third_party => tools}/cpplint/cpplint.py (100%)
 rename {third_party => tools}/cpplint/update.sh (100%)
 rename {third_party => tools}/gdb_pretty_printer/README.md (100%)
 rename {third_party => tools}/gdb_pretty_printer/nlohmann-json.py (100%)
 rename {third_party => tools}/macro_builder/main.cpp (100%)

diff --git a/CODE_OF_CONDUCT.md b/.github/CODE_OF_CONDUCT.md
similarity index 100%
rename from CODE_OF_CONDUCT.md
rename to .github/CODE_OF_CONDUCT.md
diff --git a/.drone.yml b/.github/external_ci/.drone.yml
similarity index 97%
rename from .drone.yml
rename to .github/external_ci/.drone.yml
index 3cdefe4b9..0d9e3d0be 100644
--- a/.drone.yml
+++ b/.github/external_ci/.drone.yml
@@ -18,5 +18,5 @@ steps:
   - cd build
   - ../cmake-3.20.2/bin/cmake .. -DJSON_FastTests=ON
   - make -j10
-  - cd test
+  - cd tests
   - ../../cmake-3.20.2/bin/ctest -j10
diff --git a/appveyor.yml b/.github/external_ci/appveyor.yml
similarity index 100%
rename from appveyor.yml
rename to .github/external_ci/appveyor.yml
diff --git a/.gitignore b/.gitignore
index e4f92117b..acd44d8d8 100644
--- a/.gitignore
+++ b/.gitignore
@@ -12,10 +12,10 @@
 
 /.vs
 
-/doc/mkdocs/docs/examples/
-/doc/mkdocs/docs/__pycache__/
-/doc/mkdocs/site/
-/doc/mkdocs/venv/
-/doc/docset/JSON_for_Modern_C++.docset/
-/doc/docset/JSON_for_Modern_C++.tgz
-/doc/mkdocs/docs/images/json.gif
+/docs/mkdocs/docs/examples/
+/docs/mkdocs/docs/__pycache__/
+/docs/mkdocs/site/
+/docs/mkdocs/venv/
+/docs/docset/JSON_for_Modern_C++.docset/
+/docs/docset/JSON_for_Modern_C++.tgz
+/docs/mkdocs/docs/images/json.gif
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 68bba9cf4..8f65d9a32 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -136,7 +136,7 @@ CONFIGURE_FILE(
 if (JSON_BuildTests)
     include(CTest)
     enable_testing()
-    add_subdirectory(test)
+    add_subdirectory(tests)
 endif()
 
 ##
diff --git a/Makefile b/Makefile
index 597c609cb..28de14dce 100644
--- a/Makefile
+++ b/Makefile
@@ -45,7 +45,7 @@ all:
 
 # compile example files and check output
 doctest:
-	$(MAKE) check_output -C doc
+	$(MAKE) check_output -C docs
 
 
 ##########################################################################
@@ -55,7 +55,7 @@ doctest:
 run_benchmarks:
 	rm -fr cmake-build-benchmarks
 	mkdir cmake-build-benchmarks
-	cd cmake-build-benchmarks ; cmake ../benchmarks -GNinja -DCMAKE_BUILD_TYPE=Release -DJSON_BuildTests=On
+	cd cmake-build-benchmarks ; cmake ../tests/benchmarks -GNinja -DCMAKE_BUILD_TYPE=Release
 	cd cmake-build-benchmarks ; ninja
 	cd cmake-build-benchmarks ; ./json_benchmarks
 
@@ -68,41 +68,41 @@ run_benchmarks:
 fuzz_testing:
 	rm -fr fuzz-testing
 	mkdir -p fuzz-testing fuzz-testing/testcases fuzz-testing/out
-	$(MAKE) parse_afl_fuzzer -C test CXX=afl-clang++
-	mv test/parse_afl_fuzzer fuzz-testing/fuzzer
-	find test/data/json_tests -size -5k -name *json | xargs -I{} cp "{}" fuzz-testing/testcases
+	$(MAKE) parse_afl_fuzzer -C tests CXX=afl-clang++
+	mv tests/parse_afl_fuzzer fuzz-testing/fuzzer
+	find tests/data/json_tests -size -5k -name *json | xargs -I{} cp "{}" fuzz-testing/testcases
 	@echo "Execute: afl-fuzz -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer"
 
 fuzz_testing_bson:
 	rm -fr fuzz-testing
 	mkdir -p fuzz-testing fuzz-testing/testcases fuzz-testing/out
-	$(MAKE) parse_bson_fuzzer -C test CXX=afl-clang++
-	mv test/parse_bson_fuzzer fuzz-testing/fuzzer
-	find test/data -size -5k -name *.bson | xargs -I{} cp "{}" fuzz-testing/testcases
+	$(MAKE) parse_bson_fuzzer -C tests CXX=afl-clang++
+	mv tests/parse_bson_fuzzer fuzz-testing/fuzzer
+	find tests/data -size -5k -name *.bson | xargs -I{} cp "{}" fuzz-testing/testcases
 	@echo "Execute: afl-fuzz -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer"
 
 fuzz_testing_cbor:
 	rm -fr fuzz-testing
 	mkdir -p fuzz-testing fuzz-testing/testcases fuzz-testing/out
-	$(MAKE) parse_cbor_fuzzer -C test CXX=afl-clang++
-	mv test/parse_cbor_fuzzer fuzz-testing/fuzzer
-	find test/data -size -5k -name *.cbor | xargs -I{} cp "{}" fuzz-testing/testcases
+	$(MAKE) parse_cbor_fuzzer -C tests CXX=afl-clang++
+	mv tests/parse_cbor_fuzzer fuzz-testing/fuzzer
+	find tests/data -size -5k -name *.cbor | xargs -I{} cp "{}" fuzz-testing/testcases
 	@echo "Execute: afl-fuzz -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer"
 
 fuzz_testing_msgpack:
 	rm -fr fuzz-testing
 	mkdir -p fuzz-testing fuzz-testing/testcases fuzz-testing/out
-	$(MAKE) parse_msgpack_fuzzer -C test CXX=afl-clang++
-	mv test/parse_msgpack_fuzzer fuzz-testing/fuzzer
-	find test/data -size -5k -name *.msgpack | xargs -I{} cp "{}" fuzz-testing/testcases
+	$(MAKE) parse_msgpack_fuzzer -C tests CXX=afl-clang++
+	mv tests/parse_msgpack_fuzzer fuzz-testing/fuzzer
+	find tests/data -size -5k -name *.msgpack | xargs -I{} cp "{}" fuzz-testing/testcases
 	@echo "Execute: afl-fuzz -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer"
 
 fuzz_testing_ubjson:
 	rm -fr fuzz-testing
 	mkdir -p fuzz-testing fuzz-testing/testcases fuzz-testing/out
-	$(MAKE) parse_ubjson_fuzzer -C test CXX=afl-clang++
-	mv test/parse_ubjson_fuzzer fuzz-testing/fuzzer
-	find test/data -size -5k -name *.ubjson | xargs -I{} cp "{}" fuzz-testing/testcases
+	$(MAKE) parse_ubjson_fuzzer -C tests CXX=afl-clang++
+	mv tests/parse_ubjson_fuzzer fuzz-testing/fuzzer
+	find tests/data -size -5k -name *.ubjson | xargs -I{} cp "{}" fuzz-testing/testcases
 	@echo "Execute: afl-fuzz -i fuzz-testing/testcases -o fuzz-testing/out fuzz-testing/fuzzer"
 
 fuzzing-start:
@@ -159,18 +159,18 @@ pretty:
 	    --preserve-date \
 	    --suffix=none \
 	    --formatted \
-	   $(SRCS) $(AMALGAMATED_FILE) test/src/*.cpp test/src/*.hpp benchmarks/src/benchmarks.cpp doc/examples/*.cpp
+	   $(SRCS) $(AMALGAMATED_FILE) tests/src/*.cpp tests/src/*.hpp tests/benchmarks/src/benchmarks.cpp docs/examples/*.cpp
 
 # call the Clang-Format on all source files
 pretty_format:
-	for FILE in $(SRCS) $(AMALGAMATED_FILE) test/src/*.cpp test/src/*.hpp benchmarks/src/benchmarks.cpp doc/examples/*.cpp; do echo $$FILE; clang-format -i $$FILE; done
+	for FILE in $(SRCS) $(AMALGAMATED_FILE) tests/src/*.cpp tests/src/*.hpp benchmarks/src/benchmarks.cpp docs/examples/*.cpp; do echo $$FILE; clang-format -i $$FILE; done
 
 # create single header file
 amalgamate: $(AMALGAMATED_FILE)
 
 # call the amalgamation tool and pretty print
 $(AMALGAMATED_FILE): $(SRCS)
-	third_party/amalgamate/amalgamate.py -c third_party/amalgamate/config.json -s . --verbose=yes
+	tools/amalgamate/amalgamate.py -c tools/amalgamate/config.json -s . --verbose=yes
 	$(MAKE) pretty
 
 # check if file single_include/nlohmann/json.hpp has been amalgamated from the nlohmann sources
@@ -233,10 +233,10 @@ release: include.zip json.tar.xz
 
 # clean up
 clean:
-	rm -fr fuzz fuzz-testing *.dSYM test/*.dSYM
+	rm -fr fuzz fuzz-testing *.dSYM tests/*.dSYM
 	rm -fr benchmarks/files/numbers/*.json
 	rm -fr cmake-build-benchmarks fuzz-testing cmake-build-pvs-studio release_files
-	$(MAKE) clean -Cdoc
+	$(MAKE) clean -Cdocs
 
 
 ##########################################################################
diff --git a/README.md b/README.md
index c3990a69b..a46a8569c 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-[![JSON for Modern C++](https://raw.githubusercontent.com/nlohmann/json/master/doc/json.gif)](https://github.com/nlohmann/json/releases)
+[![JSON for Modern C++](docs/json.gif)](https://github.com/nlohmann/json/releases)
 
 [![Build Status](https://ci.appveyor.com/api/projects/status/1acb366xfyg3qybk/branch/develop?svg=true)](https://ci.appveyor.com/project/nlohmann/json)
 [![Ubuntu](https://github.com/nlohmann/json/workflows/Ubuntu/badge.svg)](https://github.com/nlohmann/json/actions?query=workflow%3AUbuntu)
@@ -54,7 +54,7 @@ There are myriads of [JSON](https://json.org) libraries out there, and each may
 
 - **Trivial integration**. Our whole code consists of a single header file [`json.hpp`](https://github.com/nlohmann/json/blob/develop/single_include/nlohmann/json.hpp). That's it. No library, no subproject, no dependencies, no complex build system. The class is written in vanilla C++11. All in all, everything should require no adjustment of your compiler flags or project settings.
 
-- **Serious testing**. Our class is heavily [unit-tested](https://github.com/nlohmann/json/tree/develop/test/src) and covers [100%](https://coveralls.io/r/nlohmann/json) of the code, including all exceptional behavior. Furthermore, we checked with [Valgrind](https://valgrind.org) and the [Clang Sanitizers](https://clang.llvm.org/docs/index.html) that there are no memory leaks. [Google OSS-Fuzz](https://github.com/google/oss-fuzz/tree/master/projects/json) additionally runs fuzz tests against all parsers 24/7, effectively executing billions of tests so far. To maintain high quality, the project is following the [Core Infrastructure Initiative (CII) best practices](https://bestpractices.coreinfrastructure.org/projects/289).
+- **Serious testing**. Our class is heavily [unit-tested](https://github.com/nlohmann/json/tree/develop/tests/src) and covers [100%](https://coveralls.io/r/nlohmann/json) of the code, including all exceptional behavior. Furthermore, we checked with [Valgrind](https://valgrind.org) and the [Clang Sanitizers](https://clang.llvm.org/docs/index.html) that there are no memory leaks. [Google OSS-Fuzz](https://github.com/google/oss-fuzz/tree/master/projects/json) additionally runs fuzz tests against all parsers 24/7, effectively executing billions of tests so far. To maintain high quality, the project is following the [Core Infrastructure Initiative (CII) best practices](https://bestpractices.coreinfrastructure.org/projects/289).
 
 Other aspects were not so important to us:
 
@@ -83,7 +83,7 @@ Thanks everyone!
 
 :question: If you have a **question**, please check if it is already answered in the [**FAQ**](https://json.nlohmann.me/home/faq/) or the [**Q&A**](https://github.com/nlohmann/json/discussions/categories/q-a) section. If not, please [**ask a new question**](https://github.com/nlohmann/json/discussions/new) there.
 
-:books: If you want to **learn more** about how to use the library, check out the rest of the [**README**](#examples), have a look at [**code examples**](https://github.com/nlohmann/json/tree/develop/doc/examples), or browse through the [**help pages**](https://json.nlohmann.me).
+:books: If you want to **learn more** about how to use the library, check out the rest of the [**README**](#examples), have a look at [**code examples**](https://github.com/nlohmann/json/tree/develop/docs/examples), or browse through the [**help pages**](https://json.nlohmann.me).
 
 :construction: If you want to understand the **API** better, check out the [**API Reference**](https://json.nlohmann.me/api/basic_json/).
 
@@ -93,7 +93,7 @@ There is also a [**docset**](https://github.com/Kapeli/Dash-User-Contributions/t
 
 ## Examples
 
-Beside the examples below, you may want to check the [documentation](https://json.nlohmann.me/) where each function contains a separate code example (e.g., check out [`emplace()`](https://json.nlohmann.me/api/basic_json/emplace/)). All [example files](https://github.com/nlohmann/json/tree/develop/doc/examples) can be compiled and executed on their own (e.g., file [emplace.cpp](https://github.com/nlohmann/json/blob/develop/doc/examples/emplace.cpp)).
+Beside the examples below, you may want to check the [documentation](https://json.nlohmann.me/) where each function contains a separate code example (e.g., check out [`emplace()`](https://json.nlohmann.me/api/basic_json/emplace/)). All [example files](https://github.com/nlohmann/json/tree/develop/docs/examples) can be compiled and executed on their own (e.g., file [emplace.cpp](https://github.com/nlohmann/json/blob/develop/docs/examples/emplace.cpp)).
 
 ### JSON as first-class data type
 
@@ -857,7 +857,7 @@ namespace nlohmann {
 
 #### Can I write my own serializer? (Advanced use)
 
-Yes. You might want to take a look at [`unit-udt.cpp`](https://github.com/nlohmann/json/blob/develop/test/src/unit-udt.cpp) in the test suite, to see a few examples.
+Yes. You might want to take a look at [`unit-udt.cpp`](https://github.com/nlohmann/json/blob/develop/tests/src/unit-udt.cpp) in the test suite, to see a few examples.
 
 If you write your own serializer, you'll need to do a few things:
 
@@ -1329,7 +1329,7 @@ Only if your request would contain confidential information, please [send me an
 
 I deeply appreciate the help of the following people.
 
-<img src="https://raw.githubusercontent.com/nlohmann/json/develop/doc/avatars.png" align="right">
+<img src="https://raw.githubusercontent.com/nlohmann/json/develop/docs/avatars.png" align="right">
 
 - [Teemperor](https://github.com/Teemperor) implemented CMake support and lcov integration, realized escape and Unicode handling in the string parser, and fixed the JSON serialization.
 - [elliotgoodrich](https://github.com/elliotgoodrich) fixed an issue with double deletion in the iterator classes.
diff --git a/cmake/ci.cmake b/cmake/ci.cmake
index 5ae05a9d9..b2a2f470f 100644
--- a/cmake/ci.cmake
+++ b/cmake/ci.cmake
@@ -512,7 +512,7 @@ add_custom_target(ci_test_coverage
 
     COMMAND ${LCOV_TOOL} --directory . --capture --output-file json.info --rc lcov_branch_coverage=1
     COMMAND ${LCOV_TOOL} -e json.info ${SRC_FILES} --output-file json.info.filtered --rc lcov_branch_coverage=1
-    COMMAND ${CMAKE_SOURCE_DIR}/test/thirdparty/imapdl/filterbr.py json.info.filtered > json.info.filtered.noexcept
+    COMMAND ${CMAKE_SOURCE_DIR}/tests/thirdparty/imapdl/filterbr.py json.info.filtered > json.info.filtered.noexcept
     COMMAND genhtml --title "JSON for Modern C++" --legend --demangle-cpp --output-directory html --show-details --branch-coverage json.info.filtered.noexcept
 
     COMMENT "Compile and test with coverage"
@@ -542,16 +542,16 @@ set(ASTYLE_FLAGS --style=allman --indent=spaces=4 --indent-modifiers --indent-sw
 
 file(GLOB_RECURSE INDENT_FILES
     ${PROJECT_SOURCE_DIR}/include/nlohmann/*.hpp
-    ${PROJECT_SOURCE_DIR}/test/src/*.cpp
-    ${PROJECT_SOURCE_DIR}/test/src/*.hpp
-    ${PROJECT_SOURCE_DIR}/benchmarks/src/benchmarks.cpp
-    ${PROJECT_SOURCE_DIR}/doc/examples/*.cpp
+        ${PROJECT_SOURCE_DIR}/tests/src/*.cpp
+        ${PROJECT_SOURCE_DIR}/tests/src/*.hpp
+        ${PROJECT_SOURCE_DIR}/tests/benchmarks/src/benchmarks.cpp
+    ${PROJECT_SOURCE_DIR}/docs/examples/*.cpp
 )
 
 add_custom_target(ci_test_amalgamation
     COMMAND rm -fr ${PROJECT_SOURCE_DIR}/single_include/nlohmann/json.hpp~
     COMMAND cp ${PROJECT_SOURCE_DIR}/single_include/nlohmann/json.hpp ${PROJECT_SOURCE_DIR}/single_include/nlohmann/json.hpp~
-    COMMAND ${Python3_EXECUTABLE} ${PROJECT_SOURCE_DIR}/third_party/amalgamate/amalgamate.py -c ${PROJECT_SOURCE_DIR}/third_party/amalgamate/config.json -s .
+    COMMAND ${Python3_EXECUTABLE} ${PROJECT_SOURCE_DIR}/tools/amalgamate/amalgamate.py -c ${PROJECT_SOURCE_DIR}/tools/amalgamate/config.json -s .
     COMMAND ${ASTYLE_TOOL} ${ASTYLE_FLAGS} --suffix=none --quiet ${PROJECT_SOURCE_DIR}/single_include/nlohmann/json.hpp
     COMMAND diff ${PROJECT_SOURCE_DIR}/single_include/nlohmann/json.hpp~ ${PROJECT_SOURCE_DIR}/single_include/nlohmann/json.hpp
 
@@ -559,7 +559,7 @@ add_custom_target(ci_test_amalgamation
     COMMAND cd ${PROJECT_SOURCE_DIR} && for FILE in `find . -name '*.orig'`\; do false \; done
 
     WORKING_DIRECTORY ${PROJECT_SOURCE_DIR}
-    COMMENT "Check amalagamation and indentation"
+    COMMENT "Check amalgamation and indentation"
 )
 
 ###############################################################################
@@ -605,7 +605,7 @@ add_custom_target(ci_cppcheck
 ###############################################################################
 
 add_custom_target(ci_cpplint
-    COMMAND ${Python3_EXECUTABLE} ${CMAKE_SOURCE_DIR}/third_party/cpplint/cpplint.py --filter=-whitespace,-legal,-runtime/references,-runtime/explicit,-runtime/indentation_namespace,-readability/casting,-readability/nolint --quiet --recursive ${SRC_FILES}
+    COMMAND ${Python3_EXECUTABLE} ${CMAKE_SOURCE_DIR}/tools/cpplint/cpplint.py --filter=-whitespace,-legal,-runtime/references,-runtime/explicit,-runtime/indentation_namespace,-readability/casting,-readability/nolint --quiet --recursive ${SRC_FILES}
     COMMENT "Check code with cpplint"
 )
 
@@ -873,7 +873,7 @@ add_custom_target(ci_cuda_example
     COMMAND ${CMAKE_COMMAND}
         -DCMAKE_BUILD_TYPE=Debug -GNinja
         -DCMAKE_CUDA_HOST_COMPILER=g++-8
-        -S${PROJECT_SOURCE_DIR}/test/cuda_example -B${PROJECT_BINARY_DIR}/build_cuda_example
+        -S${PROJECT_SOURCE_DIR}/tests/cuda_example -B${PROJECT_BINARY_DIR}/build_cuda_example
     COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_cuda_example
 )
 
diff --git a/doc/Makefile b/docs/Makefile
similarity index 100%
rename from doc/Makefile
rename to docs/Makefile
diff --git a/doc/README.md b/docs/README.md
similarity index 95%
rename from doc/README.md
rename to docs/README.md
index ec5c25d49..b39d54e05 100644
--- a/doc/README.md
+++ b/docs/README.md
@@ -13,7 +13,7 @@ If you want to see the documentation for a specific tag or commit hash, you can
 git clone https://github.com/nlohmann/json.git
 cd json
 git checkout v3.10.2
-make install_venv serve -C doc/mkdocs
+make install_venv serve -C docs/mkdocs
 ```
 
 Open URL <http://127.0.0.1:8000/> in your browser. Replace from any URL from the source code `https://json.nlohmann.me`
diff --git a/doc/avatars.png b/docs/avatars.png
similarity index 100%
rename from doc/avatars.png
rename to docs/avatars.png
diff --git a/doc/docset/Info.plist b/docs/docset/Info.plist
similarity index 100%
rename from doc/docset/Info.plist
rename to docs/docset/Info.plist
diff --git a/doc/docset/Makefile b/docs/docset/Makefile
similarity index 100%
rename from doc/docset/Makefile
rename to docs/docset/Makefile
diff --git a/doc/docset/README.md b/docs/docset/README.md
similarity index 100%
rename from doc/docset/README.md
rename to docs/docset/README.md
diff --git a/doc/docset/docSet.sql b/docs/docset/docSet.sql
similarity index 100%
rename from doc/docset/docSet.sql
rename to docs/docset/docSet.sql
diff --git a/doc/docset/docset.json b/docs/docset/docset.json
similarity index 100%
rename from doc/docset/docset.json
rename to docs/docset/docset.json
diff --git a/doc/docset/icon.png b/docs/docset/icon.png
similarity index 100%
rename from doc/docset/icon.png
rename to docs/docset/icon.png
diff --git a/doc/docset/icon@2x.png b/docs/docset/icon@2x.png
similarity index 100%
rename from doc/docset/icon@2x.png
rename to docs/docset/icon@2x.png
diff --git a/doc/examples/README.cpp b/docs/examples/README.cpp
similarity index 100%
rename from doc/examples/README.cpp
rename to docs/examples/README.cpp
diff --git a/doc/examples/README.output b/docs/examples/README.output
similarity index 100%
rename from doc/examples/README.output
rename to docs/examples/README.output
diff --git a/doc/examples/accept__string.cpp b/docs/examples/accept__string.cpp
similarity index 100%
rename from doc/examples/accept__string.cpp
rename to docs/examples/accept__string.cpp
diff --git a/doc/examples/accept__string.output b/docs/examples/accept__string.output
similarity index 100%
rename from doc/examples/accept__string.output
rename to docs/examples/accept__string.output
diff --git a/doc/examples/array.cpp b/docs/examples/array.cpp
similarity index 100%
rename from doc/examples/array.cpp
rename to docs/examples/array.cpp
diff --git a/doc/examples/array.output b/docs/examples/array.output
similarity index 100%
rename from doc/examples/array.output
rename to docs/examples/array.output
diff --git a/doc/examples/array_t.cpp b/docs/examples/array_t.cpp
similarity index 100%
rename from doc/examples/array_t.cpp
rename to docs/examples/array_t.cpp
diff --git a/doc/examples/array_t.output b/docs/examples/array_t.output
similarity index 100%
rename from doc/examples/array_t.output
rename to docs/examples/array_t.output
diff --git a/doc/examples/at__object_t_key_type.cpp b/docs/examples/at__object_t_key_type.cpp
similarity index 100%
rename from doc/examples/at__object_t_key_type.cpp
rename to docs/examples/at__object_t_key_type.cpp
diff --git a/doc/examples/at__object_t_key_type.output b/docs/examples/at__object_t_key_type.output
similarity index 100%
rename from doc/examples/at__object_t_key_type.output
rename to docs/examples/at__object_t_key_type.output
diff --git a/doc/examples/at__object_t_key_type_const.cpp b/docs/examples/at__object_t_key_type_const.cpp
similarity index 100%
rename from doc/examples/at__object_t_key_type_const.cpp
rename to docs/examples/at__object_t_key_type_const.cpp
diff --git a/doc/examples/at__object_t_key_type_const.output b/docs/examples/at__object_t_key_type_const.output
similarity index 100%
rename from doc/examples/at__object_t_key_type_const.output
rename to docs/examples/at__object_t_key_type_const.output
diff --git a/doc/examples/at__size_type.cpp b/docs/examples/at__size_type.cpp
similarity index 100%
rename from doc/examples/at__size_type.cpp
rename to docs/examples/at__size_type.cpp
diff --git a/doc/examples/at__size_type.output b/docs/examples/at__size_type.output
similarity index 100%
rename from doc/examples/at__size_type.output
rename to docs/examples/at__size_type.output
diff --git a/doc/examples/at__size_type_const.cpp b/docs/examples/at__size_type_const.cpp
similarity index 100%
rename from doc/examples/at__size_type_const.cpp
rename to docs/examples/at__size_type_const.cpp
diff --git a/doc/examples/at__size_type_const.output b/docs/examples/at__size_type_const.output
similarity index 100%
rename from doc/examples/at__size_type_const.output
rename to docs/examples/at__size_type_const.output
diff --git a/doc/examples/at_json_pointer.cpp b/docs/examples/at_json_pointer.cpp
similarity index 100%
rename from doc/examples/at_json_pointer.cpp
rename to docs/examples/at_json_pointer.cpp
diff --git a/doc/examples/at_json_pointer.output b/docs/examples/at_json_pointer.output
similarity index 100%
rename from doc/examples/at_json_pointer.output
rename to docs/examples/at_json_pointer.output
diff --git a/doc/examples/at_json_pointer_const.cpp b/docs/examples/at_json_pointer_const.cpp
similarity index 100%
rename from doc/examples/at_json_pointer_const.cpp
rename to docs/examples/at_json_pointer_const.cpp
diff --git a/doc/examples/at_json_pointer_const.output b/docs/examples/at_json_pointer_const.output
similarity index 100%
rename from doc/examples/at_json_pointer_const.output
rename to docs/examples/at_json_pointer_const.output
diff --git a/doc/examples/back.cpp b/docs/examples/back.cpp
similarity index 100%
rename from doc/examples/back.cpp
rename to docs/examples/back.cpp
diff --git a/doc/examples/back.output b/docs/examples/back.output
similarity index 100%
rename from doc/examples/back.output
rename to docs/examples/back.output
diff --git a/doc/examples/basic_json__CompatibleType.cpp b/docs/examples/basic_json__CompatibleType.cpp
similarity index 100%
rename from doc/examples/basic_json__CompatibleType.cpp
rename to docs/examples/basic_json__CompatibleType.cpp
diff --git a/doc/examples/basic_json__CompatibleType.output b/docs/examples/basic_json__CompatibleType.output
similarity index 100%
rename from doc/examples/basic_json__CompatibleType.output
rename to docs/examples/basic_json__CompatibleType.output
diff --git a/doc/examples/basic_json__InputIt_InputIt.cpp b/docs/examples/basic_json__InputIt_InputIt.cpp
similarity index 100%
rename from doc/examples/basic_json__InputIt_InputIt.cpp
rename to docs/examples/basic_json__InputIt_InputIt.cpp
diff --git a/doc/examples/basic_json__InputIt_InputIt.output b/docs/examples/basic_json__InputIt_InputIt.output
similarity index 100%
rename from doc/examples/basic_json__InputIt_InputIt.output
rename to docs/examples/basic_json__InputIt_InputIt.output
diff --git a/doc/examples/basic_json__basic_json.cpp b/docs/examples/basic_json__basic_json.cpp
similarity index 100%
rename from doc/examples/basic_json__basic_json.cpp
rename to docs/examples/basic_json__basic_json.cpp
diff --git a/doc/examples/basic_json__basic_json.output b/docs/examples/basic_json__basic_json.output
similarity index 100%
rename from doc/examples/basic_json__basic_json.output
rename to docs/examples/basic_json__basic_json.output
diff --git a/doc/examples/basic_json__copyassignment.cpp b/docs/examples/basic_json__copyassignment.cpp
similarity index 100%
rename from doc/examples/basic_json__copyassignment.cpp
rename to docs/examples/basic_json__copyassignment.cpp
diff --git a/doc/examples/basic_json__copyassignment.output b/docs/examples/basic_json__copyassignment.output
similarity index 100%
rename from doc/examples/basic_json__copyassignment.output
rename to docs/examples/basic_json__copyassignment.output
diff --git a/doc/examples/basic_json__list_init_t.cpp b/docs/examples/basic_json__list_init_t.cpp
similarity index 100%
rename from doc/examples/basic_json__list_init_t.cpp
rename to docs/examples/basic_json__list_init_t.cpp
diff --git a/doc/examples/basic_json__list_init_t.output b/docs/examples/basic_json__list_init_t.output
similarity index 100%
rename from doc/examples/basic_json__list_init_t.output
rename to docs/examples/basic_json__list_init_t.output
diff --git a/doc/examples/basic_json__moveconstructor.cpp b/docs/examples/basic_json__moveconstructor.cpp
similarity index 100%
rename from doc/examples/basic_json__moveconstructor.cpp
rename to docs/examples/basic_json__moveconstructor.cpp
diff --git a/doc/examples/basic_json__moveconstructor.output b/docs/examples/basic_json__moveconstructor.output
similarity index 100%
rename from doc/examples/basic_json__moveconstructor.output
rename to docs/examples/basic_json__moveconstructor.output
diff --git a/doc/examples/basic_json__nullptr_t.cpp b/docs/examples/basic_json__nullptr_t.cpp
similarity index 100%
rename from doc/examples/basic_json__nullptr_t.cpp
rename to docs/examples/basic_json__nullptr_t.cpp
diff --git a/doc/examples/basic_json__nullptr_t.output b/docs/examples/basic_json__nullptr_t.output
similarity index 100%
rename from doc/examples/basic_json__nullptr_t.output
rename to docs/examples/basic_json__nullptr_t.output
diff --git a/doc/examples/basic_json__size_type_basic_json.cpp b/docs/examples/basic_json__size_type_basic_json.cpp
similarity index 100%
rename from doc/examples/basic_json__size_type_basic_json.cpp
rename to docs/examples/basic_json__size_type_basic_json.cpp
diff --git a/doc/examples/basic_json__size_type_basic_json.output b/docs/examples/basic_json__size_type_basic_json.output
similarity index 100%
rename from doc/examples/basic_json__size_type_basic_json.output
rename to docs/examples/basic_json__size_type_basic_json.output
diff --git a/doc/examples/basic_json__value.cpp b/docs/examples/basic_json__value.cpp
similarity index 100%
rename from doc/examples/basic_json__value.cpp
rename to docs/examples/basic_json__value.cpp
diff --git a/doc/examples/basic_json__value.output b/docs/examples/basic_json__value.output
similarity index 100%
rename from doc/examples/basic_json__value.output
rename to docs/examples/basic_json__value.output
diff --git a/doc/examples/basic_json__value_ptr.cpp b/docs/examples/basic_json__value_ptr.cpp
similarity index 100%
rename from doc/examples/basic_json__value_ptr.cpp
rename to docs/examples/basic_json__value_ptr.cpp
diff --git a/doc/examples/basic_json__value_ptr.output b/docs/examples/basic_json__value_ptr.output
similarity index 100%
rename from doc/examples/basic_json__value_ptr.output
rename to docs/examples/basic_json__value_ptr.output
diff --git a/doc/examples/basic_json__value_t.cpp b/docs/examples/basic_json__value_t.cpp
similarity index 100%
rename from doc/examples/basic_json__value_t.cpp
rename to docs/examples/basic_json__value_t.cpp
diff --git a/doc/examples/basic_json__value_t.output b/docs/examples/basic_json__value_t.output
similarity index 100%
rename from doc/examples/basic_json__value_t.output
rename to docs/examples/basic_json__value_t.output
diff --git a/doc/examples/begin.cpp b/docs/examples/begin.cpp
similarity index 100%
rename from doc/examples/begin.cpp
rename to docs/examples/begin.cpp
diff --git a/doc/examples/begin.output b/docs/examples/begin.output
similarity index 100%
rename from doc/examples/begin.output
rename to docs/examples/begin.output
diff --git a/doc/examples/binary.cpp b/docs/examples/binary.cpp
similarity index 100%
rename from doc/examples/binary.cpp
rename to docs/examples/binary.cpp
diff --git a/doc/examples/binary.output b/docs/examples/binary.output
similarity index 100%
rename from doc/examples/binary.output
rename to docs/examples/binary.output
diff --git a/doc/examples/binary_t.cpp b/docs/examples/binary_t.cpp
similarity index 100%
rename from doc/examples/binary_t.cpp
rename to docs/examples/binary_t.cpp
diff --git a/doc/examples/binary_t.output b/docs/examples/binary_t.output
similarity index 100%
rename from doc/examples/binary_t.output
rename to docs/examples/binary_t.output
diff --git a/doc/examples/boolean_t.cpp b/docs/examples/boolean_t.cpp
similarity index 100%
rename from doc/examples/boolean_t.cpp
rename to docs/examples/boolean_t.cpp
diff --git a/doc/examples/boolean_t.output b/docs/examples/boolean_t.output
similarity index 100%
rename from doc/examples/boolean_t.output
rename to docs/examples/boolean_t.output
diff --git a/doc/examples/cbegin.cpp b/docs/examples/cbegin.cpp
similarity index 100%
rename from doc/examples/cbegin.cpp
rename to docs/examples/cbegin.cpp
diff --git a/doc/examples/cbegin.output b/docs/examples/cbegin.output
similarity index 100%
rename from doc/examples/cbegin.output
rename to docs/examples/cbegin.output
diff --git a/doc/examples/cend.cpp b/docs/examples/cend.cpp
similarity index 100%
rename from doc/examples/cend.cpp
rename to docs/examples/cend.cpp
diff --git a/doc/examples/cend.output b/docs/examples/cend.output
similarity index 100%
rename from doc/examples/cend.output
rename to docs/examples/cend.output
diff --git a/doc/examples/clear.cpp b/docs/examples/clear.cpp
similarity index 100%
rename from doc/examples/clear.cpp
rename to docs/examples/clear.cpp
diff --git a/doc/examples/clear.output b/docs/examples/clear.output
similarity index 100%
rename from doc/examples/clear.output
rename to docs/examples/clear.output
diff --git a/doc/examples/contains.cpp b/docs/examples/contains.cpp
similarity index 100%
rename from doc/examples/contains.cpp
rename to docs/examples/contains.cpp
diff --git a/doc/examples/contains.output b/docs/examples/contains.output
similarity index 100%
rename from doc/examples/contains.output
rename to docs/examples/contains.output
diff --git a/doc/examples/contains_json_pointer.cpp b/docs/examples/contains_json_pointer.cpp
similarity index 100%
rename from doc/examples/contains_json_pointer.cpp
rename to docs/examples/contains_json_pointer.cpp
diff --git a/doc/examples/contains_json_pointer.output b/docs/examples/contains_json_pointer.output
similarity index 100%
rename from doc/examples/contains_json_pointer.output
rename to docs/examples/contains_json_pointer.output
diff --git a/doc/examples/count.cpp b/docs/examples/count.cpp
similarity index 100%
rename from doc/examples/count.cpp
rename to docs/examples/count.cpp
diff --git a/doc/examples/count.output b/docs/examples/count.output
similarity index 100%
rename from doc/examples/count.output
rename to docs/examples/count.output
diff --git a/doc/examples/crbegin.cpp b/docs/examples/crbegin.cpp
similarity index 100%
rename from doc/examples/crbegin.cpp
rename to docs/examples/crbegin.cpp
diff --git a/doc/examples/crbegin.output b/docs/examples/crbegin.output
similarity index 100%
rename from doc/examples/crbegin.output
rename to docs/examples/crbegin.output
diff --git a/doc/examples/crend.cpp b/docs/examples/crend.cpp
similarity index 100%
rename from doc/examples/crend.cpp
rename to docs/examples/crend.cpp
diff --git a/doc/examples/crend.output b/docs/examples/crend.output
similarity index 100%
rename from doc/examples/crend.output
rename to docs/examples/crend.output
diff --git a/doc/examples/diagnostics_extended.cpp b/docs/examples/diagnostics_extended.cpp
similarity index 100%
rename from doc/examples/diagnostics_extended.cpp
rename to docs/examples/diagnostics_extended.cpp
diff --git a/doc/examples/diagnostics_extended.output b/docs/examples/diagnostics_extended.output
similarity index 100%
rename from doc/examples/diagnostics_extended.output
rename to docs/examples/diagnostics_extended.output
diff --git a/doc/examples/diagnostics_standard.cpp b/docs/examples/diagnostics_standard.cpp
similarity index 100%
rename from doc/examples/diagnostics_standard.cpp
rename to docs/examples/diagnostics_standard.cpp
diff --git a/doc/examples/diagnostics_standard.output b/docs/examples/diagnostics_standard.output
similarity index 100%
rename from doc/examples/diagnostics_standard.output
rename to docs/examples/diagnostics_standard.output
diff --git a/doc/examples/diff.cpp b/docs/examples/diff.cpp
similarity index 100%
rename from doc/examples/diff.cpp
rename to docs/examples/diff.cpp
diff --git a/doc/examples/diff.output b/docs/examples/diff.output
similarity index 100%
rename from doc/examples/diff.output
rename to docs/examples/diff.output
diff --git a/doc/examples/dump.cpp b/docs/examples/dump.cpp
similarity index 100%
rename from doc/examples/dump.cpp
rename to docs/examples/dump.cpp
diff --git a/doc/examples/dump.output b/docs/examples/dump.output
similarity index 100%
rename from doc/examples/dump.output
rename to docs/examples/dump.output
diff --git a/doc/examples/emplace.cpp b/docs/examples/emplace.cpp
similarity index 100%
rename from doc/examples/emplace.cpp
rename to docs/examples/emplace.cpp
diff --git a/doc/examples/emplace.output b/docs/examples/emplace.output
similarity index 100%
rename from doc/examples/emplace.output
rename to docs/examples/emplace.output
diff --git a/doc/examples/emplace_back.cpp b/docs/examples/emplace_back.cpp
similarity index 100%
rename from doc/examples/emplace_back.cpp
rename to docs/examples/emplace_back.cpp
diff --git a/doc/examples/emplace_back.output b/docs/examples/emplace_back.output
similarity index 100%
rename from doc/examples/emplace_back.output
rename to docs/examples/emplace_back.output
diff --git a/doc/examples/empty.cpp b/docs/examples/empty.cpp
similarity index 100%
rename from doc/examples/empty.cpp
rename to docs/examples/empty.cpp
diff --git a/doc/examples/empty.output b/docs/examples/empty.output
similarity index 100%
rename from doc/examples/empty.output
rename to docs/examples/empty.output
diff --git a/doc/examples/end.cpp b/docs/examples/end.cpp
similarity index 100%
rename from doc/examples/end.cpp
rename to docs/examples/end.cpp
diff --git a/doc/examples/end.output b/docs/examples/end.output
similarity index 100%
rename from doc/examples/end.output
rename to docs/examples/end.output
diff --git a/doc/examples/erase__IteratorType.cpp b/docs/examples/erase__IteratorType.cpp
similarity index 100%
rename from doc/examples/erase__IteratorType.cpp
rename to docs/examples/erase__IteratorType.cpp
diff --git a/doc/examples/erase__IteratorType.output b/docs/examples/erase__IteratorType.output
similarity index 100%
rename from doc/examples/erase__IteratorType.output
rename to docs/examples/erase__IteratorType.output
diff --git a/doc/examples/erase__IteratorType_IteratorType.cpp b/docs/examples/erase__IteratorType_IteratorType.cpp
similarity index 100%
rename from doc/examples/erase__IteratorType_IteratorType.cpp
rename to docs/examples/erase__IteratorType_IteratorType.cpp
diff --git a/doc/examples/erase__IteratorType_IteratorType.output b/docs/examples/erase__IteratorType_IteratorType.output
similarity index 100%
rename from doc/examples/erase__IteratorType_IteratorType.output
rename to docs/examples/erase__IteratorType_IteratorType.output
diff --git a/doc/examples/erase__key_type.cpp b/docs/examples/erase__key_type.cpp
similarity index 100%
rename from doc/examples/erase__key_type.cpp
rename to docs/examples/erase__key_type.cpp
diff --git a/doc/examples/erase__key_type.output b/docs/examples/erase__key_type.output
similarity index 100%
rename from doc/examples/erase__key_type.output
rename to docs/examples/erase__key_type.output
diff --git a/doc/examples/erase__size_type.cpp b/docs/examples/erase__size_type.cpp
similarity index 100%
rename from doc/examples/erase__size_type.cpp
rename to docs/examples/erase__size_type.cpp
diff --git a/doc/examples/erase__size_type.output b/docs/examples/erase__size_type.output
similarity index 100%
rename from doc/examples/erase__size_type.output
rename to docs/examples/erase__size_type.output
diff --git a/doc/examples/exception.cpp b/docs/examples/exception.cpp
similarity index 100%
rename from doc/examples/exception.cpp
rename to docs/examples/exception.cpp
diff --git a/doc/examples/exception.output b/docs/examples/exception.output
similarity index 100%
rename from doc/examples/exception.output
rename to docs/examples/exception.output
diff --git a/doc/examples/find__key_type.cpp b/docs/examples/find__key_type.cpp
similarity index 100%
rename from doc/examples/find__key_type.cpp
rename to docs/examples/find__key_type.cpp
diff --git a/doc/examples/find__key_type.output b/docs/examples/find__key_type.output
similarity index 100%
rename from doc/examples/find__key_type.output
rename to docs/examples/find__key_type.output
diff --git a/doc/examples/flatten.cpp b/docs/examples/flatten.cpp
similarity index 100%
rename from doc/examples/flatten.cpp
rename to docs/examples/flatten.cpp
diff --git a/doc/examples/flatten.output b/docs/examples/flatten.output
similarity index 100%
rename from doc/examples/flatten.output
rename to docs/examples/flatten.output
diff --git a/doc/examples/from_bson.cpp b/docs/examples/from_bson.cpp
similarity index 100%
rename from doc/examples/from_bson.cpp
rename to docs/examples/from_bson.cpp
diff --git a/doc/examples/from_bson.output b/docs/examples/from_bson.output
similarity index 100%
rename from doc/examples/from_bson.output
rename to docs/examples/from_bson.output
diff --git a/doc/examples/from_cbor.cpp b/docs/examples/from_cbor.cpp
similarity index 100%
rename from doc/examples/from_cbor.cpp
rename to docs/examples/from_cbor.cpp
diff --git a/doc/examples/from_cbor.output b/docs/examples/from_cbor.output
similarity index 100%
rename from doc/examples/from_cbor.output
rename to docs/examples/from_cbor.output
diff --git a/doc/examples/from_msgpack.cpp b/docs/examples/from_msgpack.cpp
similarity index 100%
rename from doc/examples/from_msgpack.cpp
rename to docs/examples/from_msgpack.cpp
diff --git a/doc/examples/from_msgpack.output b/docs/examples/from_msgpack.output
similarity index 100%
rename from doc/examples/from_msgpack.output
rename to docs/examples/from_msgpack.output
diff --git a/doc/examples/from_ubjson.cpp b/docs/examples/from_ubjson.cpp
similarity index 100%
rename from doc/examples/from_ubjson.cpp
rename to docs/examples/from_ubjson.cpp
diff --git a/doc/examples/from_ubjson.output b/docs/examples/from_ubjson.output
similarity index 100%
rename from doc/examples/from_ubjson.output
rename to docs/examples/from_ubjson.output
diff --git a/doc/examples/front.cpp b/docs/examples/front.cpp
similarity index 100%
rename from doc/examples/front.cpp
rename to docs/examples/front.cpp
diff --git a/doc/examples/front.output b/docs/examples/front.output
similarity index 100%
rename from doc/examples/front.output
rename to docs/examples/front.output
diff --git a/doc/examples/get__PointerType.cpp b/docs/examples/get__PointerType.cpp
similarity index 100%
rename from doc/examples/get__PointerType.cpp
rename to docs/examples/get__PointerType.cpp
diff --git a/doc/examples/get__PointerType.output b/docs/examples/get__PointerType.output
similarity index 100%
rename from doc/examples/get__PointerType.output
rename to docs/examples/get__PointerType.output
diff --git a/doc/examples/get__ValueType_const.cpp b/docs/examples/get__ValueType_const.cpp
similarity index 100%
rename from doc/examples/get__ValueType_const.cpp
rename to docs/examples/get__ValueType_const.cpp
diff --git a/doc/examples/get__ValueType_const.output b/docs/examples/get__ValueType_const.output
similarity index 100%
rename from doc/examples/get__ValueType_const.output
rename to docs/examples/get__ValueType_const.output
diff --git a/doc/examples/get_binary.cpp b/docs/examples/get_binary.cpp
similarity index 100%
rename from doc/examples/get_binary.cpp
rename to docs/examples/get_binary.cpp
diff --git a/doc/examples/get_binary.output b/docs/examples/get_binary.output
similarity index 100%
rename from doc/examples/get_binary.output
rename to docs/examples/get_binary.output
diff --git a/doc/examples/get_ptr.cpp b/docs/examples/get_ptr.cpp
similarity index 100%
rename from doc/examples/get_ptr.cpp
rename to docs/examples/get_ptr.cpp
diff --git a/doc/examples/get_ptr.output b/docs/examples/get_ptr.output
similarity index 100%
rename from doc/examples/get_ptr.output
rename to docs/examples/get_ptr.output
diff --git a/doc/examples/get_ref.cpp b/docs/examples/get_ref.cpp
similarity index 100%
rename from doc/examples/get_ref.cpp
rename to docs/examples/get_ref.cpp
diff --git a/doc/examples/get_ref.output b/docs/examples/get_ref.output
similarity index 100%
rename from doc/examples/get_ref.output
rename to docs/examples/get_ref.output
diff --git a/doc/examples/get_to.cpp b/docs/examples/get_to.cpp
similarity index 100%
rename from doc/examples/get_to.cpp
rename to docs/examples/get_to.cpp
diff --git a/doc/examples/get_to.output b/docs/examples/get_to.output
similarity index 100%
rename from doc/examples/get_to.output
rename to docs/examples/get_to.output
diff --git a/doc/examples/insert.cpp b/docs/examples/insert.cpp
similarity index 100%
rename from doc/examples/insert.cpp
rename to docs/examples/insert.cpp
diff --git a/doc/examples/insert.output b/docs/examples/insert.output
similarity index 100%
rename from doc/examples/insert.output
rename to docs/examples/insert.output
diff --git a/doc/examples/insert__count.cpp b/docs/examples/insert__count.cpp
similarity index 100%
rename from doc/examples/insert__count.cpp
rename to docs/examples/insert__count.cpp
diff --git a/doc/examples/insert__count.output b/docs/examples/insert__count.output
similarity index 100%
rename from doc/examples/insert__count.output
rename to docs/examples/insert__count.output
diff --git a/doc/examples/insert__ilist.cpp b/docs/examples/insert__ilist.cpp
similarity index 100%
rename from doc/examples/insert__ilist.cpp
rename to docs/examples/insert__ilist.cpp
diff --git a/doc/examples/insert__ilist.output b/docs/examples/insert__ilist.output
similarity index 100%
rename from doc/examples/insert__ilist.output
rename to docs/examples/insert__ilist.output
diff --git a/doc/examples/insert__range.cpp b/docs/examples/insert__range.cpp
similarity index 100%
rename from doc/examples/insert__range.cpp
rename to docs/examples/insert__range.cpp
diff --git a/doc/examples/insert__range.output b/docs/examples/insert__range.output
similarity index 100%
rename from doc/examples/insert__range.output
rename to docs/examples/insert__range.output
diff --git a/doc/examples/insert__range_object.cpp b/docs/examples/insert__range_object.cpp
similarity index 100%
rename from doc/examples/insert__range_object.cpp
rename to docs/examples/insert__range_object.cpp
diff --git a/doc/examples/insert__range_object.output b/docs/examples/insert__range_object.output
similarity index 100%
rename from doc/examples/insert__range_object.output
rename to docs/examples/insert__range_object.output
diff --git a/doc/examples/invalid_iterator.cpp b/docs/examples/invalid_iterator.cpp
similarity index 100%
rename from doc/examples/invalid_iterator.cpp
rename to docs/examples/invalid_iterator.cpp
diff --git a/doc/examples/invalid_iterator.output b/docs/examples/invalid_iterator.output
similarity index 100%
rename from doc/examples/invalid_iterator.output
rename to docs/examples/invalid_iterator.output
diff --git a/doc/examples/is_array.cpp b/docs/examples/is_array.cpp
similarity index 100%
rename from doc/examples/is_array.cpp
rename to docs/examples/is_array.cpp
diff --git a/doc/examples/is_array.output b/docs/examples/is_array.output
similarity index 100%
rename from doc/examples/is_array.output
rename to docs/examples/is_array.output
diff --git a/doc/examples/is_binary.cpp b/docs/examples/is_binary.cpp
similarity index 100%
rename from doc/examples/is_binary.cpp
rename to docs/examples/is_binary.cpp
diff --git a/doc/examples/is_binary.output b/docs/examples/is_binary.output
similarity index 100%
rename from doc/examples/is_binary.output
rename to docs/examples/is_binary.output
diff --git a/doc/examples/is_boolean.cpp b/docs/examples/is_boolean.cpp
similarity index 100%
rename from doc/examples/is_boolean.cpp
rename to docs/examples/is_boolean.cpp
diff --git a/doc/examples/is_boolean.output b/docs/examples/is_boolean.output
similarity index 100%
rename from doc/examples/is_boolean.output
rename to docs/examples/is_boolean.output
diff --git a/doc/examples/is_discarded.cpp b/docs/examples/is_discarded.cpp
similarity index 100%
rename from doc/examples/is_discarded.cpp
rename to docs/examples/is_discarded.cpp
diff --git a/doc/examples/is_discarded.output b/docs/examples/is_discarded.output
similarity index 100%
rename from doc/examples/is_discarded.output
rename to docs/examples/is_discarded.output
diff --git a/doc/examples/is_null.cpp b/docs/examples/is_null.cpp
similarity index 100%
rename from doc/examples/is_null.cpp
rename to docs/examples/is_null.cpp
diff --git a/doc/examples/is_null.output b/docs/examples/is_null.output
similarity index 100%
rename from doc/examples/is_null.output
rename to docs/examples/is_null.output
diff --git a/doc/examples/is_number.cpp b/docs/examples/is_number.cpp
similarity index 100%
rename from doc/examples/is_number.cpp
rename to docs/examples/is_number.cpp
diff --git a/doc/examples/is_number.output b/docs/examples/is_number.output
similarity index 100%
rename from doc/examples/is_number.output
rename to docs/examples/is_number.output
diff --git a/doc/examples/is_number_float.cpp b/docs/examples/is_number_float.cpp
similarity index 100%
rename from doc/examples/is_number_float.cpp
rename to docs/examples/is_number_float.cpp
diff --git a/doc/examples/is_number_float.output b/docs/examples/is_number_float.output
similarity index 100%
rename from doc/examples/is_number_float.output
rename to docs/examples/is_number_float.output
diff --git a/doc/examples/is_number_integer.cpp b/docs/examples/is_number_integer.cpp
similarity index 100%
rename from doc/examples/is_number_integer.cpp
rename to docs/examples/is_number_integer.cpp
diff --git a/doc/examples/is_number_integer.output b/docs/examples/is_number_integer.output
similarity index 100%
rename from doc/examples/is_number_integer.output
rename to docs/examples/is_number_integer.output
diff --git a/doc/examples/is_number_unsigned.cpp b/docs/examples/is_number_unsigned.cpp
similarity index 100%
rename from doc/examples/is_number_unsigned.cpp
rename to docs/examples/is_number_unsigned.cpp
diff --git a/doc/examples/is_number_unsigned.output b/docs/examples/is_number_unsigned.output
similarity index 100%
rename from doc/examples/is_number_unsigned.output
rename to docs/examples/is_number_unsigned.output
diff --git a/doc/examples/is_object.cpp b/docs/examples/is_object.cpp
similarity index 100%
rename from doc/examples/is_object.cpp
rename to docs/examples/is_object.cpp
diff --git a/doc/examples/is_object.output b/docs/examples/is_object.output
similarity index 100%
rename from doc/examples/is_object.output
rename to docs/examples/is_object.output
diff --git a/doc/examples/is_primitive.cpp b/docs/examples/is_primitive.cpp
similarity index 100%
rename from doc/examples/is_primitive.cpp
rename to docs/examples/is_primitive.cpp
diff --git a/doc/examples/is_primitive.output b/docs/examples/is_primitive.output
similarity index 100%
rename from doc/examples/is_primitive.output
rename to docs/examples/is_primitive.output
diff --git a/doc/examples/is_string.cpp b/docs/examples/is_string.cpp
similarity index 100%
rename from doc/examples/is_string.cpp
rename to docs/examples/is_string.cpp
diff --git a/doc/examples/is_string.output b/docs/examples/is_string.output
similarity index 100%
rename from doc/examples/is_string.output
rename to docs/examples/is_string.output
diff --git a/doc/examples/is_structured.cpp b/docs/examples/is_structured.cpp
similarity index 100%
rename from doc/examples/is_structured.cpp
rename to docs/examples/is_structured.cpp
diff --git a/doc/examples/is_structured.output b/docs/examples/is_structured.output
similarity index 100%
rename from doc/examples/is_structured.output
rename to docs/examples/is_structured.output
diff --git a/doc/examples/items.cpp b/docs/examples/items.cpp
similarity index 100%
rename from doc/examples/items.cpp
rename to docs/examples/items.cpp
diff --git a/doc/examples/items.output b/docs/examples/items.output
similarity index 100%
rename from doc/examples/items.output
rename to docs/examples/items.output
diff --git a/doc/examples/iterator_wrapper.cpp b/docs/examples/iterator_wrapper.cpp
similarity index 100%
rename from doc/examples/iterator_wrapper.cpp
rename to docs/examples/iterator_wrapper.cpp
diff --git a/doc/examples/iterator_wrapper.output b/docs/examples/iterator_wrapper.output
similarity index 100%
rename from doc/examples/iterator_wrapper.output
rename to docs/examples/iterator_wrapper.output
diff --git a/doc/examples/json_lines.cpp b/docs/examples/json_lines.cpp
similarity index 100%
rename from doc/examples/json_lines.cpp
rename to docs/examples/json_lines.cpp
diff --git a/doc/examples/json_lines.output b/docs/examples/json_lines.output
similarity index 100%
rename from doc/examples/json_lines.output
rename to docs/examples/json_lines.output
diff --git a/doc/examples/json_pointer.cpp b/docs/examples/json_pointer.cpp
similarity index 100%
rename from doc/examples/json_pointer.cpp
rename to docs/examples/json_pointer.cpp
diff --git a/doc/examples/json_pointer.output b/docs/examples/json_pointer.output
similarity index 100%
rename from doc/examples/json_pointer.output
rename to docs/examples/json_pointer.output
diff --git a/doc/examples/json_pointer__back.cpp b/docs/examples/json_pointer__back.cpp
similarity index 100%
rename from doc/examples/json_pointer__back.cpp
rename to docs/examples/json_pointer__back.cpp
diff --git a/doc/examples/json_pointer__back.output b/docs/examples/json_pointer__back.output
similarity index 100%
rename from doc/examples/json_pointer__back.output
rename to docs/examples/json_pointer__back.output
diff --git a/doc/examples/json_pointer__empty.cpp b/docs/examples/json_pointer__empty.cpp
similarity index 100%
rename from doc/examples/json_pointer__empty.cpp
rename to docs/examples/json_pointer__empty.cpp
diff --git a/doc/examples/json_pointer__empty.output b/docs/examples/json_pointer__empty.output
similarity index 100%
rename from doc/examples/json_pointer__empty.output
rename to docs/examples/json_pointer__empty.output
diff --git a/doc/examples/json_pointer__operator_add.cpp b/docs/examples/json_pointer__operator_add.cpp
similarity index 100%
rename from doc/examples/json_pointer__operator_add.cpp
rename to docs/examples/json_pointer__operator_add.cpp
diff --git a/doc/examples/json_pointer__operator_add.output b/docs/examples/json_pointer__operator_add.output
similarity index 100%
rename from doc/examples/json_pointer__operator_add.output
rename to docs/examples/json_pointer__operator_add.output
diff --git a/doc/examples/json_pointer__operator_add_binary.cpp b/docs/examples/json_pointer__operator_add_binary.cpp
similarity index 100%
rename from doc/examples/json_pointer__operator_add_binary.cpp
rename to docs/examples/json_pointer__operator_add_binary.cpp
diff --git a/doc/examples/json_pointer__operator_add_binary.output b/docs/examples/json_pointer__operator_add_binary.output
similarity index 100%
rename from doc/examples/json_pointer__operator_add_binary.output
rename to docs/examples/json_pointer__operator_add_binary.output
diff --git a/doc/examples/json_pointer__parent_pointer.cpp b/docs/examples/json_pointer__parent_pointer.cpp
similarity index 100%
rename from doc/examples/json_pointer__parent_pointer.cpp
rename to docs/examples/json_pointer__parent_pointer.cpp
diff --git a/doc/examples/json_pointer__parent_pointer.output b/docs/examples/json_pointer__parent_pointer.output
similarity index 100%
rename from doc/examples/json_pointer__parent_pointer.output
rename to docs/examples/json_pointer__parent_pointer.output
diff --git a/doc/examples/json_pointer__pop_back.cpp b/docs/examples/json_pointer__pop_back.cpp
similarity index 100%
rename from doc/examples/json_pointer__pop_back.cpp
rename to docs/examples/json_pointer__pop_back.cpp
diff --git a/doc/examples/json_pointer__pop_back.output b/docs/examples/json_pointer__pop_back.output
similarity index 100%
rename from doc/examples/json_pointer__pop_back.output
rename to docs/examples/json_pointer__pop_back.output
diff --git a/doc/examples/json_pointer__push_back.cpp b/docs/examples/json_pointer__push_back.cpp
similarity index 100%
rename from doc/examples/json_pointer__push_back.cpp
rename to docs/examples/json_pointer__push_back.cpp
diff --git a/doc/examples/json_pointer__push_back.output b/docs/examples/json_pointer__push_back.output
similarity index 100%
rename from doc/examples/json_pointer__push_back.output
rename to docs/examples/json_pointer__push_back.output
diff --git a/doc/examples/json_pointer__to_string.cpp b/docs/examples/json_pointer__to_string.cpp
similarity index 100%
rename from doc/examples/json_pointer__to_string.cpp
rename to docs/examples/json_pointer__to_string.cpp
diff --git a/doc/examples/json_pointer__to_string.output b/docs/examples/json_pointer__to_string.output
similarity index 100%
rename from doc/examples/json_pointer__to_string.output
rename to docs/examples/json_pointer__to_string.output
diff --git a/doc/examples/max_size.cpp b/docs/examples/max_size.cpp
similarity index 100%
rename from doc/examples/max_size.cpp
rename to docs/examples/max_size.cpp
diff --git a/doc/examples/max_size.output b/docs/examples/max_size.output
similarity index 100%
rename from doc/examples/max_size.output
rename to docs/examples/max_size.output
diff --git a/doc/examples/merge_patch.cpp b/docs/examples/merge_patch.cpp
similarity index 100%
rename from doc/examples/merge_patch.cpp
rename to docs/examples/merge_patch.cpp
diff --git a/doc/examples/merge_patch.output b/docs/examples/merge_patch.output
similarity index 100%
rename from doc/examples/merge_patch.output
rename to docs/examples/merge_patch.output
diff --git a/doc/examples/meta.cpp b/docs/examples/meta.cpp
similarity index 100%
rename from doc/examples/meta.cpp
rename to docs/examples/meta.cpp
diff --git a/doc/examples/meta.output b/docs/examples/meta.output
similarity index 100%
rename from doc/examples/meta.output
rename to docs/examples/meta.output
diff --git a/doc/examples/nlohmann_define_type_intrusive_explicit.cpp b/docs/examples/nlohmann_define_type_intrusive_explicit.cpp
similarity index 100%
rename from doc/examples/nlohmann_define_type_intrusive_explicit.cpp
rename to docs/examples/nlohmann_define_type_intrusive_explicit.cpp
diff --git a/doc/examples/nlohmann_define_type_intrusive_explicit.output b/docs/examples/nlohmann_define_type_intrusive_explicit.output
similarity index 100%
rename from doc/examples/nlohmann_define_type_intrusive_explicit.output
rename to docs/examples/nlohmann_define_type_intrusive_explicit.output
diff --git a/doc/examples/nlohmann_define_type_intrusive_macro.cpp b/docs/examples/nlohmann_define_type_intrusive_macro.cpp
similarity index 100%
rename from doc/examples/nlohmann_define_type_intrusive_macro.cpp
rename to docs/examples/nlohmann_define_type_intrusive_macro.cpp
diff --git a/doc/examples/nlohmann_define_type_intrusive_macro.output b/docs/examples/nlohmann_define_type_intrusive_macro.output
similarity index 100%
rename from doc/examples/nlohmann_define_type_intrusive_macro.output
rename to docs/examples/nlohmann_define_type_intrusive_macro.output
diff --git a/doc/examples/nlohmann_define_type_intrusive_with_default_explicit.cpp b/docs/examples/nlohmann_define_type_intrusive_with_default_explicit.cpp
similarity index 100%
rename from doc/examples/nlohmann_define_type_intrusive_with_default_explicit.cpp
rename to docs/examples/nlohmann_define_type_intrusive_with_default_explicit.cpp
diff --git a/doc/examples/nlohmann_define_type_intrusive_with_default_explicit.output b/docs/examples/nlohmann_define_type_intrusive_with_default_explicit.output
similarity index 100%
rename from doc/examples/nlohmann_define_type_intrusive_with_default_explicit.output
rename to docs/examples/nlohmann_define_type_intrusive_with_default_explicit.output
diff --git a/doc/examples/nlohmann_define_type_intrusive_with_default_macro.cpp b/docs/examples/nlohmann_define_type_intrusive_with_default_macro.cpp
similarity index 100%
rename from doc/examples/nlohmann_define_type_intrusive_with_default_macro.cpp
rename to docs/examples/nlohmann_define_type_intrusive_with_default_macro.cpp
diff --git a/doc/examples/nlohmann_define_type_intrusive_with_default_macro.output b/docs/examples/nlohmann_define_type_intrusive_with_default_macro.output
similarity index 100%
rename from doc/examples/nlohmann_define_type_intrusive_with_default_macro.output
rename to docs/examples/nlohmann_define_type_intrusive_with_default_macro.output
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_explicit.cpp b/docs/examples/nlohmann_define_type_non_intrusive_explicit.cpp
similarity index 100%
rename from doc/examples/nlohmann_define_type_non_intrusive_explicit.cpp
rename to docs/examples/nlohmann_define_type_non_intrusive_explicit.cpp
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_explicit.output b/docs/examples/nlohmann_define_type_non_intrusive_explicit.output
similarity index 100%
rename from doc/examples/nlohmann_define_type_non_intrusive_explicit.output
rename to docs/examples/nlohmann_define_type_non_intrusive_explicit.output
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_macro.cpp b/docs/examples/nlohmann_define_type_non_intrusive_macro.cpp
similarity index 100%
rename from doc/examples/nlohmann_define_type_non_intrusive_macro.cpp
rename to docs/examples/nlohmann_define_type_non_intrusive_macro.cpp
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_macro.output b/docs/examples/nlohmann_define_type_non_intrusive_macro.output
similarity index 100%
rename from doc/examples/nlohmann_define_type_non_intrusive_macro.output
rename to docs/examples/nlohmann_define_type_non_intrusive_macro.output
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_with_default_explicit.cpp b/docs/examples/nlohmann_define_type_non_intrusive_with_default_explicit.cpp
similarity index 100%
rename from doc/examples/nlohmann_define_type_non_intrusive_with_default_explicit.cpp
rename to docs/examples/nlohmann_define_type_non_intrusive_with_default_explicit.cpp
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_with_default_explicit.output b/docs/examples/nlohmann_define_type_non_intrusive_with_default_explicit.output
similarity index 100%
rename from doc/examples/nlohmann_define_type_non_intrusive_with_default_explicit.output
rename to docs/examples/nlohmann_define_type_non_intrusive_with_default_explicit.output
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_with_default_macro.cpp b/docs/examples/nlohmann_define_type_non_intrusive_with_default_macro.cpp
similarity index 100%
rename from doc/examples/nlohmann_define_type_non_intrusive_with_default_macro.cpp
rename to docs/examples/nlohmann_define_type_non_intrusive_with_default_macro.cpp
diff --git a/doc/examples/nlohmann_define_type_non_intrusive_with_default_macro.output b/docs/examples/nlohmann_define_type_non_intrusive_with_default_macro.output
similarity index 100%
rename from doc/examples/nlohmann_define_type_non_intrusive_with_default_macro.output
rename to docs/examples/nlohmann_define_type_non_intrusive_with_default_macro.output
diff --git a/doc/examples/nlohmann_json_serialize_enum.cpp b/docs/examples/nlohmann_json_serialize_enum.cpp
similarity index 100%
rename from doc/examples/nlohmann_json_serialize_enum.cpp
rename to docs/examples/nlohmann_json_serialize_enum.cpp
diff --git a/doc/examples/nlohmann_json_serialize_enum.output b/docs/examples/nlohmann_json_serialize_enum.output
similarity index 100%
rename from doc/examples/nlohmann_json_serialize_enum.output
rename to docs/examples/nlohmann_json_serialize_enum.output
diff --git a/doc/examples/nlohmann_json_serialize_enum_2.cpp b/docs/examples/nlohmann_json_serialize_enum_2.cpp
similarity index 100%
rename from doc/examples/nlohmann_json_serialize_enum_2.cpp
rename to docs/examples/nlohmann_json_serialize_enum_2.cpp
diff --git a/doc/examples/nlohmann_json_serialize_enum_2.output b/docs/examples/nlohmann_json_serialize_enum_2.output
similarity index 100%
rename from doc/examples/nlohmann_json_serialize_enum_2.output
rename to docs/examples/nlohmann_json_serialize_enum_2.output
diff --git a/doc/examples/number_float_t.cpp b/docs/examples/number_float_t.cpp
similarity index 100%
rename from doc/examples/number_float_t.cpp
rename to docs/examples/number_float_t.cpp
diff --git a/doc/examples/number_float_t.output b/docs/examples/number_float_t.output
similarity index 100%
rename from doc/examples/number_float_t.output
rename to docs/examples/number_float_t.output
diff --git a/doc/examples/number_integer_t.cpp b/docs/examples/number_integer_t.cpp
similarity index 100%
rename from doc/examples/number_integer_t.cpp
rename to docs/examples/number_integer_t.cpp
diff --git a/doc/examples/number_integer_t.output b/docs/examples/number_integer_t.output
similarity index 100%
rename from doc/examples/number_integer_t.output
rename to docs/examples/number_integer_t.output
diff --git a/doc/examples/number_unsigned_t.cpp b/docs/examples/number_unsigned_t.cpp
similarity index 100%
rename from doc/examples/number_unsigned_t.cpp
rename to docs/examples/number_unsigned_t.cpp
diff --git a/doc/examples/number_unsigned_t.output b/docs/examples/number_unsigned_t.output
similarity index 100%
rename from doc/examples/number_unsigned_t.output
rename to docs/examples/number_unsigned_t.output
diff --git a/doc/examples/object.cpp b/docs/examples/object.cpp
similarity index 100%
rename from doc/examples/object.cpp
rename to docs/examples/object.cpp
diff --git a/doc/examples/object.output b/docs/examples/object.output
similarity index 100%
rename from doc/examples/object.output
rename to docs/examples/object.output
diff --git a/doc/examples/object_t.cpp b/docs/examples/object_t.cpp
similarity index 100%
rename from doc/examples/object_t.cpp
rename to docs/examples/object_t.cpp
diff --git a/doc/examples/object_t.output b/docs/examples/object_t.output
similarity index 100%
rename from doc/examples/object_t.output
rename to docs/examples/object_t.output
diff --git a/doc/examples/operator__ValueType.cpp b/docs/examples/operator__ValueType.cpp
similarity index 100%
rename from doc/examples/operator__ValueType.cpp
rename to docs/examples/operator__ValueType.cpp
diff --git a/doc/examples/operator__ValueType.output b/docs/examples/operator__ValueType.output
similarity index 100%
rename from doc/examples/operator__ValueType.output
rename to docs/examples/operator__ValueType.output
diff --git a/doc/examples/operator__equal.cpp b/docs/examples/operator__equal.cpp
similarity index 100%
rename from doc/examples/operator__equal.cpp
rename to docs/examples/operator__equal.cpp
diff --git a/doc/examples/operator__equal.output b/docs/examples/operator__equal.output
similarity index 100%
rename from doc/examples/operator__equal.output
rename to docs/examples/operator__equal.output
diff --git a/doc/examples/operator__equal__nullptr_t.cpp b/docs/examples/operator__equal__nullptr_t.cpp
similarity index 100%
rename from doc/examples/operator__equal__nullptr_t.cpp
rename to docs/examples/operator__equal__nullptr_t.cpp
diff --git a/doc/examples/operator__equal__nullptr_t.output b/docs/examples/operator__equal__nullptr_t.output
similarity index 100%
rename from doc/examples/operator__equal__nullptr_t.output
rename to docs/examples/operator__equal__nullptr_t.output
diff --git a/doc/examples/operator__greater.cpp b/docs/examples/operator__greater.cpp
similarity index 100%
rename from doc/examples/operator__greater.cpp
rename to docs/examples/operator__greater.cpp
diff --git a/doc/examples/operator__greater.output b/docs/examples/operator__greater.output
similarity index 100%
rename from doc/examples/operator__greater.output
rename to docs/examples/operator__greater.output
diff --git a/doc/examples/operator__greaterequal.cpp b/docs/examples/operator__greaterequal.cpp
similarity index 100%
rename from doc/examples/operator__greaterequal.cpp
rename to docs/examples/operator__greaterequal.cpp
diff --git a/doc/examples/operator__greaterequal.output b/docs/examples/operator__greaterequal.output
similarity index 100%
rename from doc/examples/operator__greaterequal.output
rename to docs/examples/operator__greaterequal.output
diff --git a/doc/examples/operator__less.cpp b/docs/examples/operator__less.cpp
similarity index 100%
rename from doc/examples/operator__less.cpp
rename to docs/examples/operator__less.cpp
diff --git a/doc/examples/operator__less.output b/docs/examples/operator__less.output
similarity index 100%
rename from doc/examples/operator__less.output
rename to docs/examples/operator__less.output
diff --git a/doc/examples/operator__lessequal.cpp b/docs/examples/operator__lessequal.cpp
similarity index 100%
rename from doc/examples/operator__lessequal.cpp
rename to docs/examples/operator__lessequal.cpp
diff --git a/doc/examples/operator__lessequal.output b/docs/examples/operator__lessequal.output
similarity index 100%
rename from doc/examples/operator__lessequal.output
rename to docs/examples/operator__lessequal.output
diff --git a/doc/examples/operator__notequal.cpp b/docs/examples/operator__notequal.cpp
similarity index 100%
rename from doc/examples/operator__notequal.cpp
rename to docs/examples/operator__notequal.cpp
diff --git a/doc/examples/operator__notequal.output b/docs/examples/operator__notequal.output
similarity index 100%
rename from doc/examples/operator__notequal.output
rename to docs/examples/operator__notequal.output
diff --git a/doc/examples/operator__notequal__nullptr_t.cpp b/docs/examples/operator__notequal__nullptr_t.cpp
similarity index 100%
rename from doc/examples/operator__notequal__nullptr_t.cpp
rename to docs/examples/operator__notequal__nullptr_t.cpp
diff --git a/doc/examples/operator__notequal__nullptr_t.output b/docs/examples/operator__notequal__nullptr_t.output
similarity index 100%
rename from doc/examples/operator__notequal__nullptr_t.output
rename to docs/examples/operator__notequal__nullptr_t.output
diff --git a/doc/examples/operator__value_t.cpp b/docs/examples/operator__value_t.cpp
similarity index 100%
rename from doc/examples/operator__value_t.cpp
rename to docs/examples/operator__value_t.cpp
diff --git a/doc/examples/operator__value_t.output b/docs/examples/operator__value_t.output
similarity index 100%
rename from doc/examples/operator__value_t.output
rename to docs/examples/operator__value_t.output
diff --git a/doc/examples/operator_deserialize.cpp b/docs/examples/operator_deserialize.cpp
similarity index 100%
rename from doc/examples/operator_deserialize.cpp
rename to docs/examples/operator_deserialize.cpp
diff --git a/doc/examples/operator_deserialize.output b/docs/examples/operator_deserialize.output
similarity index 100%
rename from doc/examples/operator_deserialize.output
rename to docs/examples/operator_deserialize.output
diff --git a/doc/examples/operator_literal_json.cpp b/docs/examples/operator_literal_json.cpp
similarity index 100%
rename from doc/examples/operator_literal_json.cpp
rename to docs/examples/operator_literal_json.cpp
diff --git a/doc/examples/operator_literal_json.output b/docs/examples/operator_literal_json.output
similarity index 100%
rename from doc/examples/operator_literal_json.output
rename to docs/examples/operator_literal_json.output
diff --git a/doc/examples/operator_literal_json_pointer.cpp b/docs/examples/operator_literal_json_pointer.cpp
similarity index 100%
rename from doc/examples/operator_literal_json_pointer.cpp
rename to docs/examples/operator_literal_json_pointer.cpp
diff --git a/doc/examples/operator_literal_json_pointer.output b/docs/examples/operator_literal_json_pointer.output
similarity index 100%
rename from doc/examples/operator_literal_json_pointer.output
rename to docs/examples/operator_literal_json_pointer.output
diff --git a/doc/examples/operator_serialize.cpp b/docs/examples/operator_serialize.cpp
similarity index 100%
rename from doc/examples/operator_serialize.cpp
rename to docs/examples/operator_serialize.cpp
diff --git a/doc/examples/operator_serialize.output b/docs/examples/operator_serialize.output
similarity index 100%
rename from doc/examples/operator_serialize.output
rename to docs/examples/operator_serialize.output
diff --git a/doc/examples/operatorarray__key_type.cpp b/docs/examples/operatorarray__key_type.cpp
similarity index 100%
rename from doc/examples/operatorarray__key_type.cpp
rename to docs/examples/operatorarray__key_type.cpp
diff --git a/doc/examples/operatorarray__key_type.output b/docs/examples/operatorarray__key_type.output
similarity index 100%
rename from doc/examples/operatorarray__key_type.output
rename to docs/examples/operatorarray__key_type.output
diff --git a/doc/examples/operatorarray__key_type_const.cpp b/docs/examples/operatorarray__key_type_const.cpp
similarity index 100%
rename from doc/examples/operatorarray__key_type_const.cpp
rename to docs/examples/operatorarray__key_type_const.cpp
diff --git a/doc/examples/operatorarray__key_type_const.output b/docs/examples/operatorarray__key_type_const.output
similarity index 100%
rename from doc/examples/operatorarray__key_type_const.output
rename to docs/examples/operatorarray__key_type_const.output
diff --git a/doc/examples/operatorarray__size_type.cpp b/docs/examples/operatorarray__size_type.cpp
similarity index 100%
rename from doc/examples/operatorarray__size_type.cpp
rename to docs/examples/operatorarray__size_type.cpp
diff --git a/doc/examples/operatorarray__size_type.output b/docs/examples/operatorarray__size_type.output
similarity index 100%
rename from doc/examples/operatorarray__size_type.output
rename to docs/examples/operatorarray__size_type.output
diff --git a/doc/examples/operatorarray__size_type_const.cpp b/docs/examples/operatorarray__size_type_const.cpp
similarity index 100%
rename from doc/examples/operatorarray__size_type_const.cpp
rename to docs/examples/operatorarray__size_type_const.cpp
diff --git a/doc/examples/operatorarray__size_type_const.output b/docs/examples/operatorarray__size_type_const.output
similarity index 100%
rename from doc/examples/operatorarray__size_type_const.output
rename to docs/examples/operatorarray__size_type_const.output
diff --git a/doc/examples/operatorjson_pointer.cpp b/docs/examples/operatorjson_pointer.cpp
similarity index 100%
rename from doc/examples/operatorjson_pointer.cpp
rename to docs/examples/operatorjson_pointer.cpp
diff --git a/doc/examples/operatorjson_pointer.output b/docs/examples/operatorjson_pointer.output
similarity index 100%
rename from doc/examples/operatorjson_pointer.output
rename to docs/examples/operatorjson_pointer.output
diff --git a/doc/examples/operatorjson_pointer_const.cpp b/docs/examples/operatorjson_pointer_const.cpp
similarity index 100%
rename from doc/examples/operatorjson_pointer_const.cpp
rename to docs/examples/operatorjson_pointer_const.cpp
diff --git a/doc/examples/operatorjson_pointer_const.output b/docs/examples/operatorjson_pointer_const.output
similarity index 100%
rename from doc/examples/operatorjson_pointer_const.output
rename to docs/examples/operatorjson_pointer_const.output
diff --git a/doc/examples/ordered_map.cpp b/docs/examples/ordered_map.cpp
similarity index 100%
rename from doc/examples/ordered_map.cpp
rename to docs/examples/ordered_map.cpp
diff --git a/doc/examples/ordered_map.output b/docs/examples/ordered_map.output
similarity index 100%
rename from doc/examples/ordered_map.output
rename to docs/examples/ordered_map.output
diff --git a/doc/examples/other_error.cpp b/docs/examples/other_error.cpp
similarity index 100%
rename from doc/examples/other_error.cpp
rename to docs/examples/other_error.cpp
diff --git a/doc/examples/other_error.output b/docs/examples/other_error.output
similarity index 100%
rename from doc/examples/other_error.output
rename to docs/examples/other_error.output
diff --git a/doc/examples/out_of_range.cpp b/docs/examples/out_of_range.cpp
similarity index 100%
rename from doc/examples/out_of_range.cpp
rename to docs/examples/out_of_range.cpp
diff --git a/doc/examples/out_of_range.output b/docs/examples/out_of_range.output
similarity index 100%
rename from doc/examples/out_of_range.output
rename to docs/examples/out_of_range.output
diff --git a/doc/examples/parse__allow_exceptions.cpp b/docs/examples/parse__allow_exceptions.cpp
similarity index 100%
rename from doc/examples/parse__allow_exceptions.cpp
rename to docs/examples/parse__allow_exceptions.cpp
diff --git a/doc/examples/parse__allow_exceptions.output b/docs/examples/parse__allow_exceptions.output
similarity index 100%
rename from doc/examples/parse__allow_exceptions.output
rename to docs/examples/parse__allow_exceptions.output
diff --git a/doc/examples/parse__array__parser_callback_t.cpp b/docs/examples/parse__array__parser_callback_t.cpp
similarity index 100%
rename from doc/examples/parse__array__parser_callback_t.cpp
rename to docs/examples/parse__array__parser_callback_t.cpp
diff --git a/doc/examples/parse__array__parser_callback_t.output b/docs/examples/parse__array__parser_callback_t.output
similarity index 100%
rename from doc/examples/parse__array__parser_callback_t.output
rename to docs/examples/parse__array__parser_callback_t.output
diff --git a/doc/examples/parse__contiguouscontainer__parser_callback_t.cpp b/docs/examples/parse__contiguouscontainer__parser_callback_t.cpp
similarity index 100%
rename from doc/examples/parse__contiguouscontainer__parser_callback_t.cpp
rename to docs/examples/parse__contiguouscontainer__parser_callback_t.cpp
diff --git a/doc/examples/parse__contiguouscontainer__parser_callback_t.output b/docs/examples/parse__contiguouscontainer__parser_callback_t.output
similarity index 100%
rename from doc/examples/parse__contiguouscontainer__parser_callback_t.output
rename to docs/examples/parse__contiguouscontainer__parser_callback_t.output
diff --git a/doc/examples/parse__istream__parser_callback_t.cpp b/docs/examples/parse__istream__parser_callback_t.cpp
similarity index 100%
rename from doc/examples/parse__istream__parser_callback_t.cpp
rename to docs/examples/parse__istream__parser_callback_t.cpp
diff --git a/doc/examples/parse__istream__parser_callback_t.output b/docs/examples/parse__istream__parser_callback_t.output
similarity index 100%
rename from doc/examples/parse__istream__parser_callback_t.output
rename to docs/examples/parse__istream__parser_callback_t.output
diff --git a/doc/examples/parse__iterator_pair.cpp b/docs/examples/parse__iterator_pair.cpp
similarity index 100%
rename from doc/examples/parse__iterator_pair.cpp
rename to docs/examples/parse__iterator_pair.cpp
diff --git a/doc/examples/parse__iterator_pair.link b/docs/examples/parse__iterator_pair.link
similarity index 100%
rename from doc/examples/parse__iterator_pair.link
rename to docs/examples/parse__iterator_pair.link
diff --git a/doc/examples/parse__iterator_pair.output b/docs/examples/parse__iterator_pair.output
similarity index 100%
rename from doc/examples/parse__iterator_pair.output
rename to docs/examples/parse__iterator_pair.output
diff --git a/doc/examples/parse__pointers.cpp b/docs/examples/parse__pointers.cpp
similarity index 100%
rename from doc/examples/parse__pointers.cpp
rename to docs/examples/parse__pointers.cpp
diff --git a/doc/examples/parse__pointers.link b/docs/examples/parse__pointers.link
similarity index 100%
rename from doc/examples/parse__pointers.link
rename to docs/examples/parse__pointers.link
diff --git a/doc/examples/parse__pointers.output b/docs/examples/parse__pointers.output
similarity index 100%
rename from doc/examples/parse__pointers.output
rename to docs/examples/parse__pointers.output
diff --git a/doc/examples/parse__string__parser_callback_t.cpp b/docs/examples/parse__string__parser_callback_t.cpp
similarity index 100%
rename from doc/examples/parse__string__parser_callback_t.cpp
rename to docs/examples/parse__string__parser_callback_t.cpp
diff --git a/doc/examples/parse__string__parser_callback_t.output b/docs/examples/parse__string__parser_callback_t.output
similarity index 100%
rename from doc/examples/parse__string__parser_callback_t.output
rename to docs/examples/parse__string__parser_callback_t.output
diff --git a/doc/examples/parse_error.cpp b/docs/examples/parse_error.cpp
similarity index 100%
rename from doc/examples/parse_error.cpp
rename to docs/examples/parse_error.cpp
diff --git a/doc/examples/parse_error.output b/docs/examples/parse_error.output
similarity index 100%
rename from doc/examples/parse_error.output
rename to docs/examples/parse_error.output
diff --git a/doc/examples/patch.cpp b/docs/examples/patch.cpp
similarity index 100%
rename from doc/examples/patch.cpp
rename to docs/examples/patch.cpp
diff --git a/doc/examples/patch.output b/docs/examples/patch.output
similarity index 100%
rename from doc/examples/patch.output
rename to docs/examples/patch.output
diff --git a/doc/examples/push_back.cpp b/docs/examples/push_back.cpp
similarity index 100%
rename from doc/examples/push_back.cpp
rename to docs/examples/push_back.cpp
diff --git a/doc/examples/push_back.output b/docs/examples/push_back.output
similarity index 100%
rename from doc/examples/push_back.output
rename to docs/examples/push_back.output
diff --git a/doc/examples/push_back__initializer_list.cpp b/docs/examples/push_back__initializer_list.cpp
similarity index 100%
rename from doc/examples/push_back__initializer_list.cpp
rename to docs/examples/push_back__initializer_list.cpp
diff --git a/doc/examples/push_back__initializer_list.output b/docs/examples/push_back__initializer_list.output
similarity index 100%
rename from doc/examples/push_back__initializer_list.output
rename to docs/examples/push_back__initializer_list.output
diff --git a/doc/examples/push_back__object_t__value.cpp b/docs/examples/push_back__object_t__value.cpp
similarity index 100%
rename from doc/examples/push_back__object_t__value.cpp
rename to docs/examples/push_back__object_t__value.cpp
diff --git a/doc/examples/push_back__object_t__value.output b/docs/examples/push_back__object_t__value.output
similarity index 100%
rename from doc/examples/push_back__object_t__value.output
rename to docs/examples/push_back__object_t__value.output
diff --git a/doc/examples/rbegin.cpp b/docs/examples/rbegin.cpp
similarity index 100%
rename from doc/examples/rbegin.cpp
rename to docs/examples/rbegin.cpp
diff --git a/doc/examples/rbegin.output b/docs/examples/rbegin.output
similarity index 100%
rename from doc/examples/rbegin.output
rename to docs/examples/rbegin.output
diff --git a/doc/examples/rend.cpp b/docs/examples/rend.cpp
similarity index 100%
rename from doc/examples/rend.cpp
rename to docs/examples/rend.cpp
diff --git a/doc/examples/rend.output b/docs/examples/rend.output
similarity index 100%
rename from doc/examples/rend.output
rename to docs/examples/rend.output
diff --git a/doc/examples/sax_parse.cpp b/docs/examples/sax_parse.cpp
similarity index 100%
rename from doc/examples/sax_parse.cpp
rename to docs/examples/sax_parse.cpp
diff --git a/doc/examples/sax_parse.output b/docs/examples/sax_parse.output
similarity index 100%
rename from doc/examples/sax_parse.output
rename to docs/examples/sax_parse.output
diff --git a/doc/examples/size.cpp b/docs/examples/size.cpp
similarity index 100%
rename from doc/examples/size.cpp
rename to docs/examples/size.cpp
diff --git a/doc/examples/size.output b/docs/examples/size.output
similarity index 100%
rename from doc/examples/size.output
rename to docs/examples/size.output
diff --git a/doc/examples/std_hash.cpp b/docs/examples/std_hash.cpp
similarity index 100%
rename from doc/examples/std_hash.cpp
rename to docs/examples/std_hash.cpp
diff --git a/doc/examples/std_hash.output b/docs/examples/std_hash.output
similarity index 100%
rename from doc/examples/std_hash.output
rename to docs/examples/std_hash.output
diff --git a/doc/examples/std_swap.cpp b/docs/examples/std_swap.cpp
similarity index 100%
rename from doc/examples/std_swap.cpp
rename to docs/examples/std_swap.cpp
diff --git a/doc/examples/std_swap.output b/docs/examples/std_swap.output
similarity index 100%
rename from doc/examples/std_swap.output
rename to docs/examples/std_swap.output
diff --git a/doc/examples/string_t.cpp b/docs/examples/string_t.cpp
similarity index 100%
rename from doc/examples/string_t.cpp
rename to docs/examples/string_t.cpp
diff --git a/doc/examples/string_t.output b/docs/examples/string_t.output
similarity index 100%
rename from doc/examples/string_t.output
rename to docs/examples/string_t.output
diff --git a/doc/examples/swap__array_t.cpp b/docs/examples/swap__array_t.cpp
similarity index 100%
rename from doc/examples/swap__array_t.cpp
rename to docs/examples/swap__array_t.cpp
diff --git a/doc/examples/swap__array_t.output b/docs/examples/swap__array_t.output
similarity index 100%
rename from doc/examples/swap__array_t.output
rename to docs/examples/swap__array_t.output
diff --git a/doc/examples/swap__binary_t.cpp b/docs/examples/swap__binary_t.cpp
similarity index 100%
rename from doc/examples/swap__binary_t.cpp
rename to docs/examples/swap__binary_t.cpp
diff --git a/doc/examples/swap__binary_t.output b/docs/examples/swap__binary_t.output
similarity index 100%
rename from doc/examples/swap__binary_t.output
rename to docs/examples/swap__binary_t.output
diff --git a/doc/examples/swap__object_t.cpp b/docs/examples/swap__object_t.cpp
similarity index 100%
rename from doc/examples/swap__object_t.cpp
rename to docs/examples/swap__object_t.cpp
diff --git a/doc/examples/swap__object_t.output b/docs/examples/swap__object_t.output
similarity index 100%
rename from doc/examples/swap__object_t.output
rename to docs/examples/swap__object_t.output
diff --git a/doc/examples/swap__reference.cpp b/docs/examples/swap__reference.cpp
similarity index 100%
rename from doc/examples/swap__reference.cpp
rename to docs/examples/swap__reference.cpp
diff --git a/doc/examples/swap__reference.output b/docs/examples/swap__reference.output
similarity index 100%
rename from doc/examples/swap__reference.output
rename to docs/examples/swap__reference.output
diff --git a/doc/examples/swap__string_t.cpp b/docs/examples/swap__string_t.cpp
similarity index 100%
rename from doc/examples/swap__string_t.cpp
rename to docs/examples/swap__string_t.cpp
diff --git a/doc/examples/swap__string_t.output b/docs/examples/swap__string_t.output
similarity index 100%
rename from doc/examples/swap__string_t.output
rename to docs/examples/swap__string_t.output
diff --git a/doc/examples/to_bson.cpp b/docs/examples/to_bson.cpp
similarity index 100%
rename from doc/examples/to_bson.cpp
rename to docs/examples/to_bson.cpp
diff --git a/doc/examples/to_bson.output b/docs/examples/to_bson.output
similarity index 100%
rename from doc/examples/to_bson.output
rename to docs/examples/to_bson.output
diff --git a/doc/examples/to_cbor.cpp b/docs/examples/to_cbor.cpp
similarity index 100%
rename from doc/examples/to_cbor.cpp
rename to docs/examples/to_cbor.cpp
diff --git a/doc/examples/to_cbor.output b/docs/examples/to_cbor.output
similarity index 100%
rename from doc/examples/to_cbor.output
rename to docs/examples/to_cbor.output
diff --git a/doc/examples/to_msgpack.cpp b/docs/examples/to_msgpack.cpp
similarity index 100%
rename from doc/examples/to_msgpack.cpp
rename to docs/examples/to_msgpack.cpp
diff --git a/doc/examples/to_msgpack.output b/docs/examples/to_msgpack.output
similarity index 100%
rename from doc/examples/to_msgpack.output
rename to docs/examples/to_msgpack.output
diff --git a/doc/examples/to_string.cpp b/docs/examples/to_string.cpp
similarity index 100%
rename from doc/examples/to_string.cpp
rename to docs/examples/to_string.cpp
diff --git a/doc/examples/to_string.output b/docs/examples/to_string.output
similarity index 100%
rename from doc/examples/to_string.output
rename to docs/examples/to_string.output
diff --git a/doc/examples/to_ubjson.cpp b/docs/examples/to_ubjson.cpp
similarity index 100%
rename from doc/examples/to_ubjson.cpp
rename to docs/examples/to_ubjson.cpp
diff --git a/doc/examples/to_ubjson.output b/docs/examples/to_ubjson.output
similarity index 100%
rename from doc/examples/to_ubjson.output
rename to docs/examples/to_ubjson.output
diff --git a/doc/examples/type.cpp b/docs/examples/type.cpp
similarity index 100%
rename from doc/examples/type.cpp
rename to docs/examples/type.cpp
diff --git a/doc/examples/type.output b/docs/examples/type.output
similarity index 100%
rename from doc/examples/type.output
rename to docs/examples/type.output
diff --git a/doc/examples/type_error.cpp b/docs/examples/type_error.cpp
similarity index 100%
rename from doc/examples/type_error.cpp
rename to docs/examples/type_error.cpp
diff --git a/doc/examples/type_error.output b/docs/examples/type_error.output
similarity index 100%
rename from doc/examples/type_error.output
rename to docs/examples/type_error.output
diff --git a/doc/examples/type_name.cpp b/docs/examples/type_name.cpp
similarity index 100%
rename from doc/examples/type_name.cpp
rename to docs/examples/type_name.cpp
diff --git a/doc/examples/type_name.output b/docs/examples/type_name.output
similarity index 100%
rename from doc/examples/type_name.output
rename to docs/examples/type_name.output
diff --git a/doc/examples/unflatten.cpp b/docs/examples/unflatten.cpp
similarity index 100%
rename from doc/examples/unflatten.cpp
rename to docs/examples/unflatten.cpp
diff --git a/doc/examples/unflatten.output b/docs/examples/unflatten.output
similarity index 100%
rename from doc/examples/unflatten.output
rename to docs/examples/unflatten.output
diff --git a/doc/examples/update.cpp b/docs/examples/update.cpp
similarity index 100%
rename from doc/examples/update.cpp
rename to docs/examples/update.cpp
diff --git a/doc/examples/update.output b/docs/examples/update.output
similarity index 100%
rename from doc/examples/update.output
rename to docs/examples/update.output
diff --git a/doc/examples/update__range.cpp b/docs/examples/update__range.cpp
similarity index 100%
rename from doc/examples/update__range.cpp
rename to docs/examples/update__range.cpp
diff --git a/doc/examples/update__range.output b/docs/examples/update__range.output
similarity index 100%
rename from doc/examples/update__range.output
rename to docs/examples/update__range.output
diff --git a/doc/index.md b/docs/index.md
similarity index 100%
rename from doc/index.md
rename to docs/index.md
diff --git a/doc/json.gif b/docs/json.gif
similarity index 100%
rename from doc/json.gif
rename to docs/json.gif
diff --git a/doc/mkdocs/Makefile b/docs/mkdocs/Makefile
similarity index 100%
rename from doc/mkdocs/Makefile
rename to docs/mkdocs/Makefile
diff --git a/doc/mkdocs/docs/api/adl_serializer/from_json.md b/docs/mkdocs/docs/api/adl_serializer/from_json.md
similarity index 100%
rename from doc/mkdocs/docs/api/adl_serializer/from_json.md
rename to docs/mkdocs/docs/api/adl_serializer/from_json.md
diff --git a/doc/mkdocs/docs/api/adl_serializer/index.md b/docs/mkdocs/docs/api/adl_serializer/index.md
similarity index 100%
rename from doc/mkdocs/docs/api/adl_serializer/index.md
rename to docs/mkdocs/docs/api/adl_serializer/index.md
diff --git a/doc/mkdocs/docs/api/adl_serializer/to_json.md b/docs/mkdocs/docs/api/adl_serializer/to_json.md
similarity index 100%
rename from doc/mkdocs/docs/api/adl_serializer/to_json.md
rename to docs/mkdocs/docs/api/adl_serializer/to_json.md
diff --git a/doc/mkdocs/docs/api/basic_json/accept.md b/docs/mkdocs/docs/api/basic_json/accept.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/accept.md
rename to docs/mkdocs/docs/api/basic_json/accept.md
diff --git a/doc/mkdocs/docs/api/basic_json/array.md b/docs/mkdocs/docs/api/basic_json/array.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/array.md
rename to docs/mkdocs/docs/api/basic_json/array.md
diff --git a/doc/mkdocs/docs/api/basic_json/array_t.md b/docs/mkdocs/docs/api/basic_json/array_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/array_t.md
rename to docs/mkdocs/docs/api/basic_json/array_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/at.md b/docs/mkdocs/docs/api/basic_json/at.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/at.md
rename to docs/mkdocs/docs/api/basic_json/at.md
diff --git a/doc/mkdocs/docs/api/basic_json/back.md b/docs/mkdocs/docs/api/basic_json/back.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/back.md
rename to docs/mkdocs/docs/api/basic_json/back.md
diff --git a/doc/mkdocs/docs/api/basic_json/basic_json.md b/docs/mkdocs/docs/api/basic_json/basic_json.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/basic_json.md
rename to docs/mkdocs/docs/api/basic_json/basic_json.md
diff --git a/doc/mkdocs/docs/api/basic_json/begin.md b/docs/mkdocs/docs/api/basic_json/begin.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/begin.md
rename to docs/mkdocs/docs/api/basic_json/begin.md
diff --git a/doc/mkdocs/docs/api/basic_json/binary.md b/docs/mkdocs/docs/api/basic_json/binary.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/binary.md
rename to docs/mkdocs/docs/api/basic_json/binary.md
diff --git a/doc/mkdocs/docs/api/basic_json/binary_t.md b/docs/mkdocs/docs/api/basic_json/binary_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/binary_t.md
rename to docs/mkdocs/docs/api/basic_json/binary_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/boolean_t.md b/docs/mkdocs/docs/api/basic_json/boolean_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/boolean_t.md
rename to docs/mkdocs/docs/api/basic_json/boolean_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/cbegin.md b/docs/mkdocs/docs/api/basic_json/cbegin.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/cbegin.md
rename to docs/mkdocs/docs/api/basic_json/cbegin.md
diff --git a/doc/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md b/docs/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md
rename to docs/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/cend.md b/docs/mkdocs/docs/api/basic_json/cend.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/cend.md
rename to docs/mkdocs/docs/api/basic_json/cend.md
diff --git a/doc/mkdocs/docs/api/basic_json/clear.md b/docs/mkdocs/docs/api/basic_json/clear.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/clear.md
rename to docs/mkdocs/docs/api/basic_json/clear.md
diff --git a/doc/mkdocs/docs/api/basic_json/contains.md b/docs/mkdocs/docs/api/basic_json/contains.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/contains.md
rename to docs/mkdocs/docs/api/basic_json/contains.md
diff --git a/doc/mkdocs/docs/api/basic_json/count.md b/docs/mkdocs/docs/api/basic_json/count.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/count.md
rename to docs/mkdocs/docs/api/basic_json/count.md
diff --git a/doc/mkdocs/docs/api/basic_json/crbegin.md b/docs/mkdocs/docs/api/basic_json/crbegin.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/crbegin.md
rename to docs/mkdocs/docs/api/basic_json/crbegin.md
diff --git a/doc/mkdocs/docs/api/basic_json/crend.md b/docs/mkdocs/docs/api/basic_json/crend.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/crend.md
rename to docs/mkdocs/docs/api/basic_json/crend.md
diff --git a/doc/mkdocs/docs/api/basic_json/default_object_comparator_t.md b/docs/mkdocs/docs/api/basic_json/default_object_comparator_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/default_object_comparator_t.md
rename to docs/mkdocs/docs/api/basic_json/default_object_comparator_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/diff.md b/docs/mkdocs/docs/api/basic_json/diff.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/diff.md
rename to docs/mkdocs/docs/api/basic_json/diff.md
diff --git a/doc/mkdocs/docs/api/basic_json/dump.md b/docs/mkdocs/docs/api/basic_json/dump.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/dump.md
rename to docs/mkdocs/docs/api/basic_json/dump.md
diff --git a/doc/mkdocs/docs/api/basic_json/emplace.md b/docs/mkdocs/docs/api/basic_json/emplace.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/emplace.md
rename to docs/mkdocs/docs/api/basic_json/emplace.md
diff --git a/doc/mkdocs/docs/api/basic_json/emplace_back.md b/docs/mkdocs/docs/api/basic_json/emplace_back.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/emplace_back.md
rename to docs/mkdocs/docs/api/basic_json/emplace_back.md
diff --git a/doc/mkdocs/docs/api/basic_json/empty.md b/docs/mkdocs/docs/api/basic_json/empty.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/empty.md
rename to docs/mkdocs/docs/api/basic_json/empty.md
diff --git a/doc/mkdocs/docs/api/basic_json/end.md b/docs/mkdocs/docs/api/basic_json/end.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/end.md
rename to docs/mkdocs/docs/api/basic_json/end.md
diff --git a/doc/mkdocs/docs/api/basic_json/erase.md b/docs/mkdocs/docs/api/basic_json/erase.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/erase.md
rename to docs/mkdocs/docs/api/basic_json/erase.md
diff --git a/doc/mkdocs/docs/api/basic_json/error_handler_t.md b/docs/mkdocs/docs/api/basic_json/error_handler_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/error_handler_t.md
rename to docs/mkdocs/docs/api/basic_json/error_handler_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/exception.md b/docs/mkdocs/docs/api/basic_json/exception.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/exception.md
rename to docs/mkdocs/docs/api/basic_json/exception.md
diff --git a/doc/mkdocs/docs/api/basic_json/find.md b/docs/mkdocs/docs/api/basic_json/find.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/find.md
rename to docs/mkdocs/docs/api/basic_json/find.md
diff --git a/doc/mkdocs/docs/api/basic_json/flatten.md b/docs/mkdocs/docs/api/basic_json/flatten.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/flatten.md
rename to docs/mkdocs/docs/api/basic_json/flatten.md
diff --git a/doc/mkdocs/docs/api/basic_json/from_bson.md b/docs/mkdocs/docs/api/basic_json/from_bson.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/from_bson.md
rename to docs/mkdocs/docs/api/basic_json/from_bson.md
diff --git a/doc/mkdocs/docs/api/basic_json/from_cbor.md b/docs/mkdocs/docs/api/basic_json/from_cbor.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/from_cbor.md
rename to docs/mkdocs/docs/api/basic_json/from_cbor.md
diff --git a/doc/mkdocs/docs/api/basic_json/from_msgpack.md b/docs/mkdocs/docs/api/basic_json/from_msgpack.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/from_msgpack.md
rename to docs/mkdocs/docs/api/basic_json/from_msgpack.md
diff --git a/doc/mkdocs/docs/api/basic_json/from_ubjson.md b/docs/mkdocs/docs/api/basic_json/from_ubjson.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/from_ubjson.md
rename to docs/mkdocs/docs/api/basic_json/from_ubjson.md
diff --git a/doc/mkdocs/docs/api/basic_json/front.md b/docs/mkdocs/docs/api/basic_json/front.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/front.md
rename to docs/mkdocs/docs/api/basic_json/front.md
diff --git a/doc/mkdocs/docs/api/basic_json/get.md b/docs/mkdocs/docs/api/basic_json/get.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/get.md
rename to docs/mkdocs/docs/api/basic_json/get.md
diff --git a/doc/mkdocs/docs/api/basic_json/get_allocator.md b/docs/mkdocs/docs/api/basic_json/get_allocator.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/get_allocator.md
rename to docs/mkdocs/docs/api/basic_json/get_allocator.md
diff --git a/doc/mkdocs/docs/api/basic_json/get_binary.md b/docs/mkdocs/docs/api/basic_json/get_binary.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/get_binary.md
rename to docs/mkdocs/docs/api/basic_json/get_binary.md
diff --git a/doc/mkdocs/docs/api/basic_json/get_ptr.md b/docs/mkdocs/docs/api/basic_json/get_ptr.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/get_ptr.md
rename to docs/mkdocs/docs/api/basic_json/get_ptr.md
diff --git a/doc/mkdocs/docs/api/basic_json/get_ref.md b/docs/mkdocs/docs/api/basic_json/get_ref.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/get_ref.md
rename to docs/mkdocs/docs/api/basic_json/get_ref.md
diff --git a/doc/mkdocs/docs/api/basic_json/get_to.md b/docs/mkdocs/docs/api/basic_json/get_to.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/get_to.md
rename to docs/mkdocs/docs/api/basic_json/get_to.md
diff --git a/doc/mkdocs/docs/api/basic_json/index.md b/docs/mkdocs/docs/api/basic_json/index.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/index.md
rename to docs/mkdocs/docs/api/basic_json/index.md
diff --git a/doc/mkdocs/docs/api/basic_json/input_format_t.md b/docs/mkdocs/docs/api/basic_json/input_format_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/input_format_t.md
rename to docs/mkdocs/docs/api/basic_json/input_format_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/insert.md b/docs/mkdocs/docs/api/basic_json/insert.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/insert.md
rename to docs/mkdocs/docs/api/basic_json/insert.md
diff --git a/doc/mkdocs/docs/api/basic_json/invalid_iterator.md b/docs/mkdocs/docs/api/basic_json/invalid_iterator.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/invalid_iterator.md
rename to docs/mkdocs/docs/api/basic_json/invalid_iterator.md
diff --git a/doc/mkdocs/docs/api/basic_json/is_array.md b/docs/mkdocs/docs/api/basic_json/is_array.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/is_array.md
rename to docs/mkdocs/docs/api/basic_json/is_array.md
diff --git a/doc/mkdocs/docs/api/basic_json/is_binary.md b/docs/mkdocs/docs/api/basic_json/is_binary.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/is_binary.md
rename to docs/mkdocs/docs/api/basic_json/is_binary.md
diff --git a/doc/mkdocs/docs/api/basic_json/is_boolean.md b/docs/mkdocs/docs/api/basic_json/is_boolean.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/is_boolean.md
rename to docs/mkdocs/docs/api/basic_json/is_boolean.md
diff --git a/doc/mkdocs/docs/api/basic_json/is_discarded.md b/docs/mkdocs/docs/api/basic_json/is_discarded.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/is_discarded.md
rename to docs/mkdocs/docs/api/basic_json/is_discarded.md
diff --git a/doc/mkdocs/docs/api/basic_json/is_null.md b/docs/mkdocs/docs/api/basic_json/is_null.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/is_null.md
rename to docs/mkdocs/docs/api/basic_json/is_null.md
diff --git a/doc/mkdocs/docs/api/basic_json/is_number.md b/docs/mkdocs/docs/api/basic_json/is_number.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/is_number.md
rename to docs/mkdocs/docs/api/basic_json/is_number.md
diff --git a/doc/mkdocs/docs/api/basic_json/is_number_float.md b/docs/mkdocs/docs/api/basic_json/is_number_float.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/is_number_float.md
rename to docs/mkdocs/docs/api/basic_json/is_number_float.md
diff --git a/doc/mkdocs/docs/api/basic_json/is_number_integer.md b/docs/mkdocs/docs/api/basic_json/is_number_integer.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/is_number_integer.md
rename to docs/mkdocs/docs/api/basic_json/is_number_integer.md
diff --git a/doc/mkdocs/docs/api/basic_json/is_number_unsigned.md b/docs/mkdocs/docs/api/basic_json/is_number_unsigned.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/is_number_unsigned.md
rename to docs/mkdocs/docs/api/basic_json/is_number_unsigned.md
diff --git a/doc/mkdocs/docs/api/basic_json/is_object.md b/docs/mkdocs/docs/api/basic_json/is_object.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/is_object.md
rename to docs/mkdocs/docs/api/basic_json/is_object.md
diff --git a/doc/mkdocs/docs/api/basic_json/is_primitive.md b/docs/mkdocs/docs/api/basic_json/is_primitive.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/is_primitive.md
rename to docs/mkdocs/docs/api/basic_json/is_primitive.md
diff --git a/doc/mkdocs/docs/api/basic_json/is_string.md b/docs/mkdocs/docs/api/basic_json/is_string.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/is_string.md
rename to docs/mkdocs/docs/api/basic_json/is_string.md
diff --git a/doc/mkdocs/docs/api/basic_json/is_structured.md b/docs/mkdocs/docs/api/basic_json/is_structured.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/is_structured.md
rename to docs/mkdocs/docs/api/basic_json/is_structured.md
diff --git a/doc/mkdocs/docs/api/basic_json/items.md b/docs/mkdocs/docs/api/basic_json/items.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/items.md
rename to docs/mkdocs/docs/api/basic_json/items.md
diff --git a/doc/mkdocs/docs/api/basic_json/json_serializer.md b/docs/mkdocs/docs/api/basic_json/json_serializer.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/json_serializer.md
rename to docs/mkdocs/docs/api/basic_json/json_serializer.md
diff --git a/doc/mkdocs/docs/api/basic_json/max_size.md b/docs/mkdocs/docs/api/basic_json/max_size.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/max_size.md
rename to docs/mkdocs/docs/api/basic_json/max_size.md
diff --git a/doc/mkdocs/docs/api/basic_json/merge_patch.md b/docs/mkdocs/docs/api/basic_json/merge_patch.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/merge_patch.md
rename to docs/mkdocs/docs/api/basic_json/merge_patch.md
diff --git a/doc/mkdocs/docs/api/basic_json/meta.md b/docs/mkdocs/docs/api/basic_json/meta.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/meta.md
rename to docs/mkdocs/docs/api/basic_json/meta.md
diff --git a/doc/mkdocs/docs/api/basic_json/number_float_t.md b/docs/mkdocs/docs/api/basic_json/number_float_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/number_float_t.md
rename to docs/mkdocs/docs/api/basic_json/number_float_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/number_integer_t.md b/docs/mkdocs/docs/api/basic_json/number_integer_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/number_integer_t.md
rename to docs/mkdocs/docs/api/basic_json/number_integer_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/number_unsigned_t.md b/docs/mkdocs/docs/api/basic_json/number_unsigned_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/number_unsigned_t.md
rename to docs/mkdocs/docs/api/basic_json/number_unsigned_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/object.md b/docs/mkdocs/docs/api/basic_json/object.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/object.md
rename to docs/mkdocs/docs/api/basic_json/object.md
diff --git a/doc/mkdocs/docs/api/basic_json/object_comparator_t.md b/docs/mkdocs/docs/api/basic_json/object_comparator_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/object_comparator_t.md
rename to docs/mkdocs/docs/api/basic_json/object_comparator_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/object_t.md b/docs/mkdocs/docs/api/basic_json/object_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/object_t.md
rename to docs/mkdocs/docs/api/basic_json/object_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/operator+=.md b/docs/mkdocs/docs/api/basic_json/operator+=.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator+=.md
rename to docs/mkdocs/docs/api/basic_json/operator+=.md
diff --git a/doc/mkdocs/docs/api/basic_json/operator=.md b/docs/mkdocs/docs/api/basic_json/operator=.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator=.md
rename to docs/mkdocs/docs/api/basic_json/operator=.md
diff --git a/doc/mkdocs/docs/api/basic_json/operator[].md b/docs/mkdocs/docs/api/basic_json/operator[].md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator[].md
rename to docs/mkdocs/docs/api/basic_json/operator[].md
diff --git a/doc/mkdocs/docs/api/basic_json/operator_ValueType.md b/docs/mkdocs/docs/api/basic_json/operator_ValueType.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator_ValueType.md
rename to docs/mkdocs/docs/api/basic_json/operator_ValueType.md
diff --git a/doc/mkdocs/docs/api/basic_json/operator_eq.md b/docs/mkdocs/docs/api/basic_json/operator_eq.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator_eq.md
rename to docs/mkdocs/docs/api/basic_json/operator_eq.md
diff --git a/doc/mkdocs/docs/api/basic_json/operator_ge.md b/docs/mkdocs/docs/api/basic_json/operator_ge.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator_ge.md
rename to docs/mkdocs/docs/api/basic_json/operator_ge.md
diff --git a/doc/mkdocs/docs/api/basic_json/operator_gt.md b/docs/mkdocs/docs/api/basic_json/operator_gt.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator_gt.md
rename to docs/mkdocs/docs/api/basic_json/operator_gt.md
diff --git a/doc/mkdocs/docs/api/basic_json/operator_gtgt.md b/docs/mkdocs/docs/api/basic_json/operator_gtgt.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator_gtgt.md
rename to docs/mkdocs/docs/api/basic_json/operator_gtgt.md
diff --git a/doc/mkdocs/docs/api/basic_json/operator_le.md b/docs/mkdocs/docs/api/basic_json/operator_le.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator_le.md
rename to docs/mkdocs/docs/api/basic_json/operator_le.md
diff --git a/doc/mkdocs/docs/api/basic_json/operator_literal_json.md b/docs/mkdocs/docs/api/basic_json/operator_literal_json.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator_literal_json.md
rename to docs/mkdocs/docs/api/basic_json/operator_literal_json.md
diff --git a/doc/mkdocs/docs/api/basic_json/operator_literal_json_pointer.md b/docs/mkdocs/docs/api/basic_json/operator_literal_json_pointer.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator_literal_json_pointer.md
rename to docs/mkdocs/docs/api/basic_json/operator_literal_json_pointer.md
diff --git a/doc/mkdocs/docs/api/basic_json/operator_lt.md b/docs/mkdocs/docs/api/basic_json/operator_lt.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator_lt.md
rename to docs/mkdocs/docs/api/basic_json/operator_lt.md
diff --git a/doc/mkdocs/docs/api/basic_json/operator_ltlt.md b/docs/mkdocs/docs/api/basic_json/operator_ltlt.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator_ltlt.md
rename to docs/mkdocs/docs/api/basic_json/operator_ltlt.md
diff --git a/doc/mkdocs/docs/api/basic_json/operator_ne.md b/docs/mkdocs/docs/api/basic_json/operator_ne.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator_ne.md
rename to docs/mkdocs/docs/api/basic_json/operator_ne.md
diff --git a/doc/mkdocs/docs/api/basic_json/operator_value_t.md b/docs/mkdocs/docs/api/basic_json/operator_value_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/operator_value_t.md
rename to docs/mkdocs/docs/api/basic_json/operator_value_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/other_error.md b/docs/mkdocs/docs/api/basic_json/other_error.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/other_error.md
rename to docs/mkdocs/docs/api/basic_json/other_error.md
diff --git a/doc/mkdocs/docs/api/basic_json/out_of_range.md b/docs/mkdocs/docs/api/basic_json/out_of_range.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/out_of_range.md
rename to docs/mkdocs/docs/api/basic_json/out_of_range.md
diff --git a/doc/mkdocs/docs/api/basic_json/parse.md b/docs/mkdocs/docs/api/basic_json/parse.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/parse.md
rename to docs/mkdocs/docs/api/basic_json/parse.md
diff --git a/doc/mkdocs/docs/api/basic_json/parse_error.md b/docs/mkdocs/docs/api/basic_json/parse_error.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/parse_error.md
rename to docs/mkdocs/docs/api/basic_json/parse_error.md
diff --git a/doc/mkdocs/docs/api/basic_json/parse_event_t.md b/docs/mkdocs/docs/api/basic_json/parse_event_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/parse_event_t.md
rename to docs/mkdocs/docs/api/basic_json/parse_event_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/parser_callback_t.md b/docs/mkdocs/docs/api/basic_json/parser_callback_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/parser_callback_t.md
rename to docs/mkdocs/docs/api/basic_json/parser_callback_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/patch.md b/docs/mkdocs/docs/api/basic_json/patch.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/patch.md
rename to docs/mkdocs/docs/api/basic_json/patch.md
diff --git a/doc/mkdocs/docs/api/basic_json/push_back.md b/docs/mkdocs/docs/api/basic_json/push_back.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/push_back.md
rename to docs/mkdocs/docs/api/basic_json/push_back.md
diff --git a/doc/mkdocs/docs/api/basic_json/rbegin.md b/docs/mkdocs/docs/api/basic_json/rbegin.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/rbegin.md
rename to docs/mkdocs/docs/api/basic_json/rbegin.md
diff --git a/doc/mkdocs/docs/api/basic_json/rend.md b/docs/mkdocs/docs/api/basic_json/rend.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/rend.md
rename to docs/mkdocs/docs/api/basic_json/rend.md
diff --git a/doc/mkdocs/docs/api/basic_json/sax_parse.md b/docs/mkdocs/docs/api/basic_json/sax_parse.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/sax_parse.md
rename to docs/mkdocs/docs/api/basic_json/sax_parse.md
diff --git a/doc/mkdocs/docs/api/basic_json/size.md b/docs/mkdocs/docs/api/basic_json/size.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/size.md
rename to docs/mkdocs/docs/api/basic_json/size.md
diff --git a/doc/mkdocs/docs/api/basic_json/std_hash.md b/docs/mkdocs/docs/api/basic_json/std_hash.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/std_hash.md
rename to docs/mkdocs/docs/api/basic_json/std_hash.md
diff --git a/doc/mkdocs/docs/api/basic_json/std_swap.md b/docs/mkdocs/docs/api/basic_json/std_swap.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/std_swap.md
rename to docs/mkdocs/docs/api/basic_json/std_swap.md
diff --git a/doc/mkdocs/docs/api/basic_json/string_t.md b/docs/mkdocs/docs/api/basic_json/string_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/string_t.md
rename to docs/mkdocs/docs/api/basic_json/string_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/swap.md b/docs/mkdocs/docs/api/basic_json/swap.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/swap.md
rename to docs/mkdocs/docs/api/basic_json/swap.md
diff --git a/doc/mkdocs/docs/api/basic_json/to_bson.md b/docs/mkdocs/docs/api/basic_json/to_bson.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/to_bson.md
rename to docs/mkdocs/docs/api/basic_json/to_bson.md
diff --git a/doc/mkdocs/docs/api/basic_json/to_cbor.md b/docs/mkdocs/docs/api/basic_json/to_cbor.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/to_cbor.md
rename to docs/mkdocs/docs/api/basic_json/to_cbor.md
diff --git a/doc/mkdocs/docs/api/basic_json/to_msgpack.md b/docs/mkdocs/docs/api/basic_json/to_msgpack.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/to_msgpack.md
rename to docs/mkdocs/docs/api/basic_json/to_msgpack.md
diff --git a/doc/mkdocs/docs/api/basic_json/to_string.md b/docs/mkdocs/docs/api/basic_json/to_string.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/to_string.md
rename to docs/mkdocs/docs/api/basic_json/to_string.md
diff --git a/doc/mkdocs/docs/api/basic_json/to_ubjson.md b/docs/mkdocs/docs/api/basic_json/to_ubjson.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/to_ubjson.md
rename to docs/mkdocs/docs/api/basic_json/to_ubjson.md
diff --git a/doc/mkdocs/docs/api/basic_json/type.md b/docs/mkdocs/docs/api/basic_json/type.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/type.md
rename to docs/mkdocs/docs/api/basic_json/type.md
diff --git a/doc/mkdocs/docs/api/basic_json/type_error.md b/docs/mkdocs/docs/api/basic_json/type_error.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/type_error.md
rename to docs/mkdocs/docs/api/basic_json/type_error.md
diff --git a/doc/mkdocs/docs/api/basic_json/type_name.md b/docs/mkdocs/docs/api/basic_json/type_name.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/type_name.md
rename to docs/mkdocs/docs/api/basic_json/type_name.md
diff --git a/doc/mkdocs/docs/api/basic_json/unflatten.md b/docs/mkdocs/docs/api/basic_json/unflatten.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/unflatten.md
rename to docs/mkdocs/docs/api/basic_json/unflatten.md
diff --git a/doc/mkdocs/docs/api/basic_json/update.md b/docs/mkdocs/docs/api/basic_json/update.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/update.md
rename to docs/mkdocs/docs/api/basic_json/update.md
diff --git a/doc/mkdocs/docs/api/basic_json/value.md b/docs/mkdocs/docs/api/basic_json/value.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/value.md
rename to docs/mkdocs/docs/api/basic_json/value.md
diff --git a/doc/mkdocs/docs/api/basic_json/value_t.md b/docs/mkdocs/docs/api/basic_json/value_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/value_t.md
rename to docs/mkdocs/docs/api/basic_json/value_t.md
diff --git a/doc/mkdocs/docs/api/basic_json/~basic_json.md b/docs/mkdocs/docs/api/basic_json/~basic_json.md
similarity index 100%
rename from doc/mkdocs/docs/api/basic_json/~basic_json.md
rename to docs/mkdocs/docs/api/basic_json/~basic_json.md
diff --git a/doc/mkdocs/docs/api/byte_container_with_subtype/byte_container_with_subtype.md b/docs/mkdocs/docs/api/byte_container_with_subtype/byte_container_with_subtype.md
similarity index 100%
rename from doc/mkdocs/docs/api/byte_container_with_subtype/byte_container_with_subtype.md
rename to docs/mkdocs/docs/api/byte_container_with_subtype/byte_container_with_subtype.md
diff --git a/doc/mkdocs/docs/api/byte_container_with_subtype/clear_subtype.md b/docs/mkdocs/docs/api/byte_container_with_subtype/clear_subtype.md
similarity index 100%
rename from doc/mkdocs/docs/api/byte_container_with_subtype/clear_subtype.md
rename to docs/mkdocs/docs/api/byte_container_with_subtype/clear_subtype.md
diff --git a/doc/mkdocs/docs/api/byte_container_with_subtype/has_subtype.md b/docs/mkdocs/docs/api/byte_container_with_subtype/has_subtype.md
similarity index 100%
rename from doc/mkdocs/docs/api/byte_container_with_subtype/has_subtype.md
rename to docs/mkdocs/docs/api/byte_container_with_subtype/has_subtype.md
diff --git a/doc/mkdocs/docs/api/byte_container_with_subtype/index.md b/docs/mkdocs/docs/api/byte_container_with_subtype/index.md
similarity index 100%
rename from doc/mkdocs/docs/api/byte_container_with_subtype/index.md
rename to docs/mkdocs/docs/api/byte_container_with_subtype/index.md
diff --git a/doc/mkdocs/docs/api/byte_container_with_subtype/set_subtype.md b/docs/mkdocs/docs/api/byte_container_with_subtype/set_subtype.md
similarity index 100%
rename from doc/mkdocs/docs/api/byte_container_with_subtype/set_subtype.md
rename to docs/mkdocs/docs/api/byte_container_with_subtype/set_subtype.md
diff --git a/doc/mkdocs/docs/api/byte_container_with_subtype/subtype.md b/docs/mkdocs/docs/api/byte_container_with_subtype/subtype.md
similarity index 100%
rename from doc/mkdocs/docs/api/byte_container_with_subtype/subtype.md
rename to docs/mkdocs/docs/api/byte_container_with_subtype/subtype.md
diff --git a/doc/mkdocs/docs/api/json.md b/docs/mkdocs/docs/api/json.md
similarity index 100%
rename from doc/mkdocs/docs/api/json.md
rename to docs/mkdocs/docs/api/json.md
diff --git a/doc/mkdocs/docs/api/json_pointer/back.md b/docs/mkdocs/docs/api/json_pointer/back.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_pointer/back.md
rename to docs/mkdocs/docs/api/json_pointer/back.md
diff --git a/doc/mkdocs/docs/api/json_pointer/empty.md b/docs/mkdocs/docs/api/json_pointer/empty.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_pointer/empty.md
rename to docs/mkdocs/docs/api/json_pointer/empty.md
diff --git a/doc/mkdocs/docs/api/json_pointer/index.md b/docs/mkdocs/docs/api/json_pointer/index.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_pointer/index.md
rename to docs/mkdocs/docs/api/json_pointer/index.md
diff --git a/doc/mkdocs/docs/api/json_pointer/json_pointer.md b/docs/mkdocs/docs/api/json_pointer/json_pointer.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_pointer/json_pointer.md
rename to docs/mkdocs/docs/api/json_pointer/json_pointer.md
diff --git a/doc/mkdocs/docs/api/json_pointer/operator_slash.md b/docs/mkdocs/docs/api/json_pointer/operator_slash.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_pointer/operator_slash.md
rename to docs/mkdocs/docs/api/json_pointer/operator_slash.md
diff --git a/doc/mkdocs/docs/api/json_pointer/operator_slasheq.md b/docs/mkdocs/docs/api/json_pointer/operator_slasheq.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_pointer/operator_slasheq.md
rename to docs/mkdocs/docs/api/json_pointer/operator_slasheq.md
diff --git a/doc/mkdocs/docs/api/json_pointer/operator_string.md b/docs/mkdocs/docs/api/json_pointer/operator_string.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_pointer/operator_string.md
rename to docs/mkdocs/docs/api/json_pointer/operator_string.md
diff --git a/doc/mkdocs/docs/api/json_pointer/parent_pointer.md b/docs/mkdocs/docs/api/json_pointer/parent_pointer.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_pointer/parent_pointer.md
rename to docs/mkdocs/docs/api/json_pointer/parent_pointer.md
diff --git a/doc/mkdocs/docs/api/json_pointer/pop_back.md b/docs/mkdocs/docs/api/json_pointer/pop_back.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_pointer/pop_back.md
rename to docs/mkdocs/docs/api/json_pointer/pop_back.md
diff --git a/doc/mkdocs/docs/api/json_pointer/push_back.md b/docs/mkdocs/docs/api/json_pointer/push_back.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_pointer/push_back.md
rename to docs/mkdocs/docs/api/json_pointer/push_back.md
diff --git a/doc/mkdocs/docs/api/json_pointer/string_t.md b/docs/mkdocs/docs/api/json_pointer/string_t.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_pointer/string_t.md
rename to docs/mkdocs/docs/api/json_pointer/string_t.md
diff --git a/doc/mkdocs/docs/api/json_pointer/to_string.md b/docs/mkdocs/docs/api/json_pointer/to_string.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_pointer/to_string.md
rename to docs/mkdocs/docs/api/json_pointer/to_string.md
diff --git a/doc/mkdocs/docs/api/json_sax/binary.md b/docs/mkdocs/docs/api/json_sax/binary.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_sax/binary.md
rename to docs/mkdocs/docs/api/json_sax/binary.md
diff --git a/doc/mkdocs/docs/api/json_sax/boolean.md b/docs/mkdocs/docs/api/json_sax/boolean.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_sax/boolean.md
rename to docs/mkdocs/docs/api/json_sax/boolean.md
diff --git a/doc/mkdocs/docs/api/json_sax/end_array.md b/docs/mkdocs/docs/api/json_sax/end_array.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_sax/end_array.md
rename to docs/mkdocs/docs/api/json_sax/end_array.md
diff --git a/doc/mkdocs/docs/api/json_sax/end_object.md b/docs/mkdocs/docs/api/json_sax/end_object.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_sax/end_object.md
rename to docs/mkdocs/docs/api/json_sax/end_object.md
diff --git a/doc/mkdocs/docs/api/json_sax/index.md b/docs/mkdocs/docs/api/json_sax/index.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_sax/index.md
rename to docs/mkdocs/docs/api/json_sax/index.md
diff --git a/doc/mkdocs/docs/api/json_sax/key.md b/docs/mkdocs/docs/api/json_sax/key.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_sax/key.md
rename to docs/mkdocs/docs/api/json_sax/key.md
diff --git a/doc/mkdocs/docs/api/json_sax/null.md b/docs/mkdocs/docs/api/json_sax/null.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_sax/null.md
rename to docs/mkdocs/docs/api/json_sax/null.md
diff --git a/doc/mkdocs/docs/api/json_sax/number_float.md b/docs/mkdocs/docs/api/json_sax/number_float.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_sax/number_float.md
rename to docs/mkdocs/docs/api/json_sax/number_float.md
diff --git a/doc/mkdocs/docs/api/json_sax/number_integer.md b/docs/mkdocs/docs/api/json_sax/number_integer.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_sax/number_integer.md
rename to docs/mkdocs/docs/api/json_sax/number_integer.md
diff --git a/doc/mkdocs/docs/api/json_sax/number_unsigned.md b/docs/mkdocs/docs/api/json_sax/number_unsigned.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_sax/number_unsigned.md
rename to docs/mkdocs/docs/api/json_sax/number_unsigned.md
diff --git a/doc/mkdocs/docs/api/json_sax/parse_error.md b/docs/mkdocs/docs/api/json_sax/parse_error.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_sax/parse_error.md
rename to docs/mkdocs/docs/api/json_sax/parse_error.md
diff --git a/doc/mkdocs/docs/api/json_sax/start_array.md b/docs/mkdocs/docs/api/json_sax/start_array.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_sax/start_array.md
rename to docs/mkdocs/docs/api/json_sax/start_array.md
diff --git a/doc/mkdocs/docs/api/json_sax/start_object.md b/docs/mkdocs/docs/api/json_sax/start_object.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_sax/start_object.md
rename to docs/mkdocs/docs/api/json_sax/start_object.md
diff --git a/doc/mkdocs/docs/api/json_sax/string.md b/docs/mkdocs/docs/api/json_sax/string.md
similarity index 100%
rename from doc/mkdocs/docs/api/json_sax/string.md
rename to docs/mkdocs/docs/api/json_sax/string.md
diff --git a/doc/mkdocs/docs/api/macros/index.md b/docs/mkdocs/docs/api/macros/index.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/index.md
rename to docs/mkdocs/docs/api/macros/index.md
diff --git a/doc/mkdocs/docs/api/macros/json_assert.md b/docs/mkdocs/docs/api/macros/json_assert.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/json_assert.md
rename to docs/mkdocs/docs/api/macros/json_assert.md
diff --git a/doc/mkdocs/docs/api/macros/json_diagnostics.md b/docs/mkdocs/docs/api/macros/json_diagnostics.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/json_diagnostics.md
rename to docs/mkdocs/docs/api/macros/json_diagnostics.md
diff --git a/doc/mkdocs/docs/api/macros/json_has_cpp_11.md b/docs/mkdocs/docs/api/macros/json_has_cpp_11.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/json_has_cpp_11.md
rename to docs/mkdocs/docs/api/macros/json_has_cpp_11.md
diff --git a/doc/mkdocs/docs/api/macros/json_has_filesystem.md b/docs/mkdocs/docs/api/macros/json_has_filesystem.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/json_has_filesystem.md
rename to docs/mkdocs/docs/api/macros/json_has_filesystem.md
diff --git a/doc/mkdocs/docs/api/macros/json_no_io.md b/docs/mkdocs/docs/api/macros/json_no_io.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/json_no_io.md
rename to docs/mkdocs/docs/api/macros/json_no_io.md
diff --git a/doc/mkdocs/docs/api/macros/json_noexception.md b/docs/mkdocs/docs/api/macros/json_noexception.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/json_noexception.md
rename to docs/mkdocs/docs/api/macros/json_noexception.md
diff --git a/doc/mkdocs/docs/api/macros/json_skip_library_version_check.md b/docs/mkdocs/docs/api/macros/json_skip_library_version_check.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/json_skip_library_version_check.md
rename to docs/mkdocs/docs/api/macros/json_skip_library_version_check.md
diff --git a/doc/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md b/docs/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md
rename to docs/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md
diff --git a/doc/mkdocs/docs/api/macros/json_throw_user.md b/docs/mkdocs/docs/api/macros/json_throw_user.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/json_throw_user.md
rename to docs/mkdocs/docs/api/macros/json_throw_user.md
diff --git a/doc/mkdocs/docs/api/macros/json_use_implicit_conversions.md b/docs/mkdocs/docs/api/macros/json_use_implicit_conversions.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/json_use_implicit_conversions.md
rename to docs/mkdocs/docs/api/macros/json_use_implicit_conversions.md
diff --git a/doc/mkdocs/docs/api/macros/nlohmann_define_type_intrusive.md b/docs/mkdocs/docs/api/macros/nlohmann_define_type_intrusive.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/nlohmann_define_type_intrusive.md
rename to docs/mkdocs/docs/api/macros/nlohmann_define_type_intrusive.md
diff --git a/doc/mkdocs/docs/api/macros/nlohmann_define_type_non_intrusive.md b/docs/mkdocs/docs/api/macros/nlohmann_define_type_non_intrusive.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/nlohmann_define_type_non_intrusive.md
rename to docs/mkdocs/docs/api/macros/nlohmann_define_type_non_intrusive.md
diff --git a/doc/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md b/docs/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md
rename to docs/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md
diff --git a/doc/mkdocs/docs/api/macros/nlohmann_json_version_major.md b/docs/mkdocs/docs/api/macros/nlohmann_json_version_major.md
similarity index 100%
rename from doc/mkdocs/docs/api/macros/nlohmann_json_version_major.md
rename to docs/mkdocs/docs/api/macros/nlohmann_json_version_major.md
diff --git a/doc/mkdocs/docs/api/ordered_json.md b/docs/mkdocs/docs/api/ordered_json.md
similarity index 100%
rename from doc/mkdocs/docs/api/ordered_json.md
rename to docs/mkdocs/docs/api/ordered_json.md
diff --git a/doc/mkdocs/docs/api/ordered_map.md b/docs/mkdocs/docs/api/ordered_map.md
similarity index 100%
rename from doc/mkdocs/docs/api/ordered_map.md
rename to docs/mkdocs/docs/api/ordered_map.md
diff --git a/doc/mkdocs/docs/features/arbitrary_types.md b/docs/mkdocs/docs/features/arbitrary_types.md
similarity index 100%
rename from doc/mkdocs/docs/features/arbitrary_types.md
rename to docs/mkdocs/docs/features/arbitrary_types.md
diff --git a/doc/mkdocs/docs/features/assertions.md b/docs/mkdocs/docs/features/assertions.md
similarity index 100%
rename from doc/mkdocs/docs/features/assertions.md
rename to docs/mkdocs/docs/features/assertions.md
diff --git a/doc/mkdocs/docs/features/binary_formats/bson.md b/docs/mkdocs/docs/features/binary_formats/bson.md
similarity index 100%
rename from doc/mkdocs/docs/features/binary_formats/bson.md
rename to docs/mkdocs/docs/features/binary_formats/bson.md
diff --git a/doc/mkdocs/docs/features/binary_formats/cbor.md b/docs/mkdocs/docs/features/binary_formats/cbor.md
similarity index 100%
rename from doc/mkdocs/docs/features/binary_formats/cbor.md
rename to docs/mkdocs/docs/features/binary_formats/cbor.md
diff --git a/doc/mkdocs/docs/features/binary_formats/index.md b/docs/mkdocs/docs/features/binary_formats/index.md
similarity index 100%
rename from doc/mkdocs/docs/features/binary_formats/index.md
rename to docs/mkdocs/docs/features/binary_formats/index.md
diff --git a/doc/mkdocs/docs/features/binary_formats/messagepack.md b/docs/mkdocs/docs/features/binary_formats/messagepack.md
similarity index 100%
rename from doc/mkdocs/docs/features/binary_formats/messagepack.md
rename to docs/mkdocs/docs/features/binary_formats/messagepack.md
diff --git a/doc/mkdocs/docs/features/binary_formats/ubjson.md b/docs/mkdocs/docs/features/binary_formats/ubjson.md
similarity index 100%
rename from doc/mkdocs/docs/features/binary_formats/ubjson.md
rename to docs/mkdocs/docs/features/binary_formats/ubjson.md
diff --git a/doc/mkdocs/docs/features/binary_values.md b/docs/mkdocs/docs/features/binary_values.md
similarity index 100%
rename from doc/mkdocs/docs/features/binary_values.md
rename to docs/mkdocs/docs/features/binary_values.md
diff --git a/doc/mkdocs/docs/features/comments.md b/docs/mkdocs/docs/features/comments.md
similarity index 100%
rename from doc/mkdocs/docs/features/comments.md
rename to docs/mkdocs/docs/features/comments.md
diff --git a/doc/mkdocs/docs/features/element_access/checked_access.md b/docs/mkdocs/docs/features/element_access/checked_access.md
similarity index 100%
rename from doc/mkdocs/docs/features/element_access/checked_access.md
rename to docs/mkdocs/docs/features/element_access/checked_access.md
diff --git a/doc/mkdocs/docs/features/element_access/default_value.md b/docs/mkdocs/docs/features/element_access/default_value.md
similarity index 100%
rename from doc/mkdocs/docs/features/element_access/default_value.md
rename to docs/mkdocs/docs/features/element_access/default_value.md
diff --git a/doc/mkdocs/docs/features/element_access/index.md b/docs/mkdocs/docs/features/element_access/index.md
similarity index 100%
rename from doc/mkdocs/docs/features/element_access/index.md
rename to docs/mkdocs/docs/features/element_access/index.md
diff --git a/doc/mkdocs/docs/features/element_access/unchecked_access.md b/docs/mkdocs/docs/features/element_access/unchecked_access.md
similarity index 100%
rename from doc/mkdocs/docs/features/element_access/unchecked_access.md
rename to docs/mkdocs/docs/features/element_access/unchecked_access.md
diff --git a/doc/mkdocs/docs/features/enum_conversion.md b/docs/mkdocs/docs/features/enum_conversion.md
similarity index 100%
rename from doc/mkdocs/docs/features/enum_conversion.md
rename to docs/mkdocs/docs/features/enum_conversion.md
diff --git a/doc/mkdocs/docs/features/iterators.md b/docs/mkdocs/docs/features/iterators.md
similarity index 100%
rename from doc/mkdocs/docs/features/iterators.md
rename to docs/mkdocs/docs/features/iterators.md
diff --git a/doc/mkdocs/docs/features/json_patch.md b/docs/mkdocs/docs/features/json_patch.md
similarity index 100%
rename from doc/mkdocs/docs/features/json_patch.md
rename to docs/mkdocs/docs/features/json_patch.md
diff --git a/doc/mkdocs/docs/features/json_pointer.md b/docs/mkdocs/docs/features/json_pointer.md
similarity index 100%
rename from doc/mkdocs/docs/features/json_pointer.md
rename to docs/mkdocs/docs/features/json_pointer.md
diff --git a/doc/mkdocs/docs/features/macros.md b/docs/mkdocs/docs/features/macros.md
similarity index 100%
rename from doc/mkdocs/docs/features/macros.md
rename to docs/mkdocs/docs/features/macros.md
diff --git a/doc/mkdocs/docs/features/merge_patch.md b/docs/mkdocs/docs/features/merge_patch.md
similarity index 100%
rename from doc/mkdocs/docs/features/merge_patch.md
rename to docs/mkdocs/docs/features/merge_patch.md
diff --git a/doc/mkdocs/docs/features/object_order.md b/docs/mkdocs/docs/features/object_order.md
similarity index 100%
rename from doc/mkdocs/docs/features/object_order.md
rename to docs/mkdocs/docs/features/object_order.md
diff --git a/doc/mkdocs/docs/features/parsing/index.md b/docs/mkdocs/docs/features/parsing/index.md
similarity index 100%
rename from doc/mkdocs/docs/features/parsing/index.md
rename to docs/mkdocs/docs/features/parsing/index.md
diff --git a/doc/mkdocs/docs/features/parsing/json_lines.md b/docs/mkdocs/docs/features/parsing/json_lines.md
similarity index 100%
rename from doc/mkdocs/docs/features/parsing/json_lines.md
rename to docs/mkdocs/docs/features/parsing/json_lines.md
diff --git a/doc/mkdocs/docs/features/parsing/parse_exceptions.md b/docs/mkdocs/docs/features/parsing/parse_exceptions.md
similarity index 100%
rename from doc/mkdocs/docs/features/parsing/parse_exceptions.md
rename to docs/mkdocs/docs/features/parsing/parse_exceptions.md
diff --git a/doc/mkdocs/docs/features/parsing/parser_callbacks.md b/docs/mkdocs/docs/features/parsing/parser_callbacks.md
similarity index 100%
rename from doc/mkdocs/docs/features/parsing/parser_callbacks.md
rename to docs/mkdocs/docs/features/parsing/parser_callbacks.md
diff --git a/doc/mkdocs/docs/features/parsing/sax_interface.md b/docs/mkdocs/docs/features/parsing/sax_interface.md
similarity index 100%
rename from doc/mkdocs/docs/features/parsing/sax_interface.md
rename to docs/mkdocs/docs/features/parsing/sax_interface.md
diff --git a/doc/mkdocs/docs/features/types/index.md b/docs/mkdocs/docs/features/types/index.md
similarity index 100%
rename from doc/mkdocs/docs/features/types/index.md
rename to docs/mkdocs/docs/features/types/index.md
diff --git a/doc/mkdocs/docs/features/types/number_handling.md b/docs/mkdocs/docs/features/types/number_handling.md
similarity index 100%
rename from doc/mkdocs/docs/features/types/number_handling.md
rename to docs/mkdocs/docs/features/types/number_handling.md
diff --git a/doc/mkdocs/docs/home/code_of_conduct.md b/docs/mkdocs/docs/home/code_of_conduct.md
similarity index 100%
rename from doc/mkdocs/docs/home/code_of_conduct.md
rename to docs/mkdocs/docs/home/code_of_conduct.md
diff --git a/doc/mkdocs/docs/home/design_goals.md b/docs/mkdocs/docs/home/design_goals.md
similarity index 100%
rename from doc/mkdocs/docs/home/design_goals.md
rename to docs/mkdocs/docs/home/design_goals.md
diff --git a/doc/mkdocs/docs/home/exceptions.md b/docs/mkdocs/docs/home/exceptions.md
similarity index 100%
rename from doc/mkdocs/docs/home/exceptions.md
rename to docs/mkdocs/docs/home/exceptions.md
diff --git a/doc/mkdocs/docs/home/faq.md b/docs/mkdocs/docs/home/faq.md
similarity index 100%
rename from doc/mkdocs/docs/home/faq.md
rename to docs/mkdocs/docs/home/faq.md
diff --git a/doc/mkdocs/docs/home/license.md b/docs/mkdocs/docs/home/license.md
similarity index 100%
rename from doc/mkdocs/docs/home/license.md
rename to docs/mkdocs/docs/home/license.md
diff --git a/doc/mkdocs/docs/home/releases.md b/docs/mkdocs/docs/home/releases.md
similarity index 100%
rename from doc/mkdocs/docs/home/releases.md
rename to docs/mkdocs/docs/home/releases.md
diff --git a/doc/mkdocs/docs/home/sponsors.md b/docs/mkdocs/docs/home/sponsors.md
similarity index 100%
rename from doc/mkdocs/docs/home/sponsors.md
rename to docs/mkdocs/docs/home/sponsors.md
diff --git a/doc/mkdocs/docs/images/callback_events.png b/docs/mkdocs/docs/images/callback_events.png
similarity index 100%
rename from doc/mkdocs/docs/images/callback_events.png
rename to docs/mkdocs/docs/images/callback_events.png
diff --git a/doc/mkdocs/docs/images/json_syntax_number.png b/docs/mkdocs/docs/images/json_syntax_number.png
similarity index 100%
rename from doc/mkdocs/docs/images/json_syntax_number.png
rename to docs/mkdocs/docs/images/json_syntax_number.png
diff --git a/doc/mkdocs/docs/images/range-begin-end.svg b/docs/mkdocs/docs/images/range-begin-end.svg
similarity index 100%
rename from doc/mkdocs/docs/images/range-begin-end.svg
rename to docs/mkdocs/docs/images/range-begin-end.svg
diff --git a/doc/mkdocs/docs/images/range-rbegin-rend.svg b/docs/mkdocs/docs/images/range-rbegin-rend.svg
similarity index 100%
rename from doc/mkdocs/docs/images/range-rbegin-rend.svg
rename to docs/mkdocs/docs/images/range-rbegin-rend.svg
diff --git a/doc/mkdocs/docs/index.md b/docs/mkdocs/docs/index.md
similarity index 100%
rename from doc/mkdocs/docs/index.md
rename to docs/mkdocs/docs/index.md
diff --git a/doc/mkdocs/docs/integration/cmake.md b/docs/mkdocs/docs/integration/cmake.md
similarity index 100%
rename from doc/mkdocs/docs/integration/cmake.md
rename to docs/mkdocs/docs/integration/cmake.md
diff --git a/doc/mkdocs/docs/integration/conan/CMakeLists.txt b/docs/mkdocs/docs/integration/conan/CMakeLists.txt
similarity index 100%
rename from doc/mkdocs/docs/integration/conan/CMakeLists.txt
rename to docs/mkdocs/docs/integration/conan/CMakeLists.txt
diff --git a/doc/mkdocs/docs/integration/conan/Conanfile.txt b/docs/mkdocs/docs/integration/conan/Conanfile.txt
similarity index 100%
rename from doc/mkdocs/docs/integration/conan/Conanfile.txt
rename to docs/mkdocs/docs/integration/conan/Conanfile.txt
diff --git a/doc/mkdocs/docs/integration/conan/example.cpp b/docs/mkdocs/docs/integration/conan/example.cpp
similarity index 100%
rename from doc/mkdocs/docs/integration/conan/example.cpp
rename to docs/mkdocs/docs/integration/conan/example.cpp
diff --git a/doc/mkdocs/docs/integration/example.cpp b/docs/mkdocs/docs/integration/example.cpp
similarity index 100%
rename from doc/mkdocs/docs/integration/example.cpp
rename to docs/mkdocs/docs/integration/example.cpp
diff --git a/doc/mkdocs/docs/integration/index.md b/docs/mkdocs/docs/integration/index.md
similarity index 100%
rename from doc/mkdocs/docs/integration/index.md
rename to docs/mkdocs/docs/integration/index.md
diff --git a/doc/mkdocs/docs/integration/package_managers.md b/docs/mkdocs/docs/integration/package_managers.md
similarity index 100%
rename from doc/mkdocs/docs/integration/package_managers.md
rename to docs/mkdocs/docs/integration/package_managers.md
diff --git a/doc/mkdocs/docs/integration/pkg-config.md b/docs/mkdocs/docs/integration/pkg-config.md
similarity index 100%
rename from doc/mkdocs/docs/integration/pkg-config.md
rename to docs/mkdocs/docs/integration/pkg-config.md
diff --git a/doc/mkdocs/docs/integration/vcpkg/CMakeLists.txt b/docs/mkdocs/docs/integration/vcpkg/CMakeLists.txt
similarity index 100%
rename from doc/mkdocs/docs/integration/vcpkg/CMakeLists.txt
rename to docs/mkdocs/docs/integration/vcpkg/CMakeLists.txt
diff --git a/doc/mkdocs/docs/integration/vcpkg/example.cpp b/docs/mkdocs/docs/integration/vcpkg/example.cpp
similarity index 100%
rename from doc/mkdocs/docs/integration/vcpkg/example.cpp
rename to docs/mkdocs/docs/integration/vcpkg/example.cpp
diff --git a/doc/mkdocs/mkdocs.yml b/docs/mkdocs/mkdocs.yml
similarity index 99%
rename from doc/mkdocs/mkdocs.yml
rename to docs/mkdocs/mkdocs.yml
index 302e827cf..38a8cadfa 100644
--- a/doc/mkdocs/mkdocs.yml
+++ b/docs/mkdocs/mkdocs.yml
@@ -6,7 +6,7 @@ site_url: https://json.nlohmann.me/
 # Repository
 repo_name: nlohmann/json
 repo_url: https://github.com/nlohmann/json
-edit_uri: edit/develop/doc/mkdocs/docs
+edit_uri: edit/develop/docs/mkdocs/docs
 
 # Copyright
 copyright: Copyright &copy; 2013 - 2022 Niels Lohmann
diff --git a/doc/mkdocs/requirements.txt b/docs/mkdocs/requirements.txt
similarity index 100%
rename from doc/mkdocs/requirements.txt
rename to docs/mkdocs/requirements.txt
diff --git a/doc/mkdocs/scripts/check_structure.py b/docs/mkdocs/scripts/check_structure.py
similarity index 100%
rename from doc/mkdocs/scripts/check_structure.py
rename to docs/mkdocs/scripts/check_structure.py
diff --git a/doc/usages/ios.png b/docs/usages/ios.png
similarity index 100%
rename from doc/usages/ios.png
rename to docs/usages/ios.png
diff --git a/doc/usages/macos.png b/docs/usages/macos.png
similarity index 100%
rename from doc/usages/macos.png
rename to docs/usages/macos.png
diff --git a/include/nlohmann/json.hpp b/include/nlohmann/json.hpp
index da9b3de6c..aed4a1a01 100644
--- a/include/nlohmann/json.hpp
+++ b/include/nlohmann/json.hpp
@@ -33,7 +33,7 @@ SOFTWARE.
  * contains the most recent documentation and should also be applicable to  *
  * previous versions; documentation for deprecated functions is not         *
  * removed, but marked deprecated. See "Generate documentation" section in  *
- * file doc/README.md.                                                      *
+ * file docs/README.md.                                                      *
 \****************************************************************************/
 
 #ifndef INCLUDE_NLOHMANN_JSON_HPP_
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index d5fe92c58..ad777c92c 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -33,7 +33,7 @@ SOFTWARE.
  * contains the most recent documentation and should also be applicable to  *
  * previous versions; documentation for deprecated functions is not         *
  * removed, but marked deprecated. See "Generate documentation" section in  *
- * file doc/README.md.                                                      *
+ * file docs/README.md.                                                      *
 \****************************************************************************/
 
 #ifndef INCLUDE_NLOHMANN_JSON_HPP_
diff --git a/test/CMakeLists.txt b/tests/CMakeLists.txt
similarity index 100%
rename from test/CMakeLists.txt
rename to tests/CMakeLists.txt
diff --git a/test/Makefile b/tests/Makefile
similarity index 100%
rename from test/Makefile
rename to tests/Makefile
diff --git a/benchmarks/CMakeLists.txt b/tests/benchmarks/CMakeLists.txt
similarity index 88%
rename from benchmarks/CMakeLists.txt
rename to tests/benchmarks/CMakeLists.txt
index 325904d12..92ff0ea7b 100644
--- a/benchmarks/CMakeLists.txt
+++ b/tests/benchmarks/CMakeLists.txt
@@ -23,6 +23,7 @@ if(NOT benchmark_POPULATED)
 endif()
 
 # download test data
+set(CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/../../cmake ${CMAKE_MODULE_PATH})
 include(download_test_data)
 
 # benchmark binary
@@ -30,4 +31,4 @@ add_executable(json_benchmarks src/benchmarks.cpp)
 target_compile_features(json_benchmarks PRIVATE cxx_std_11)
 target_link_libraries(json_benchmarks benchmark ${CMAKE_THREAD_LIBS_INIT})
 add_dependencies(json_benchmarks download_test_data)
-target_include_directories(json_benchmarks PRIVATE ${CMAKE_SOURCE_DIR}/../single_include ${CMAKE_BINARY_DIR}/include)
+target_include_directories(json_benchmarks PRIVATE ${CMAKE_SOURCE_DIR}/../../single_include ${CMAKE_BINARY_DIR}/include)
diff --git a/benchmarks/src/benchmarks.cpp b/tests/benchmarks/src/benchmarks.cpp
similarity index 100%
rename from benchmarks/src/benchmarks.cpp
rename to tests/benchmarks/src/benchmarks.cpp
diff --git a/test/cmake_add_subdirectory/CMakeLists.txt b/tests/cmake_add_subdirectory/CMakeLists.txt
similarity index 100%
rename from test/cmake_add_subdirectory/CMakeLists.txt
rename to tests/cmake_add_subdirectory/CMakeLists.txt
diff --git a/test/cmake_add_subdirectory/project/CMakeLists.txt b/tests/cmake_add_subdirectory/project/CMakeLists.txt
similarity index 100%
rename from test/cmake_add_subdirectory/project/CMakeLists.txt
rename to tests/cmake_add_subdirectory/project/CMakeLists.txt
diff --git a/test/cmake_add_subdirectory/project/main.cpp b/tests/cmake_add_subdirectory/project/main.cpp
similarity index 100%
rename from test/cmake_add_subdirectory/project/main.cpp
rename to tests/cmake_add_subdirectory/project/main.cpp
diff --git a/test/cmake_fetch_content/CMakeLists.txt b/tests/cmake_fetch_content/CMakeLists.txt
similarity index 100%
rename from test/cmake_fetch_content/CMakeLists.txt
rename to tests/cmake_fetch_content/CMakeLists.txt
diff --git a/test/cmake_fetch_content/project/CMakeLists.txt b/tests/cmake_fetch_content/project/CMakeLists.txt
similarity index 100%
rename from test/cmake_fetch_content/project/CMakeLists.txt
rename to tests/cmake_fetch_content/project/CMakeLists.txt
diff --git a/test/cmake_fetch_content/project/main.cpp b/tests/cmake_fetch_content/project/main.cpp
similarity index 100%
rename from test/cmake_fetch_content/project/main.cpp
rename to tests/cmake_fetch_content/project/main.cpp
diff --git a/test/cmake_fetch_content2/CMakeLists.txt b/tests/cmake_fetch_content2/CMakeLists.txt
similarity index 100%
rename from test/cmake_fetch_content2/CMakeLists.txt
rename to tests/cmake_fetch_content2/CMakeLists.txt
diff --git a/test/cmake_fetch_content2/project/CMakeLists.txt b/tests/cmake_fetch_content2/project/CMakeLists.txt
similarity index 100%
rename from test/cmake_fetch_content2/project/CMakeLists.txt
rename to tests/cmake_fetch_content2/project/CMakeLists.txt
diff --git a/test/cmake_fetch_content2/project/main.cpp b/tests/cmake_fetch_content2/project/main.cpp
similarity index 100%
rename from test/cmake_fetch_content2/project/main.cpp
rename to tests/cmake_fetch_content2/project/main.cpp
diff --git a/test/cmake_import/CMakeLists.txt b/tests/cmake_import/CMakeLists.txt
similarity index 100%
rename from test/cmake_import/CMakeLists.txt
rename to tests/cmake_import/CMakeLists.txt
diff --git a/test/cmake_import/project/CMakeLists.txt b/tests/cmake_import/project/CMakeLists.txt
similarity index 100%
rename from test/cmake_import/project/CMakeLists.txt
rename to tests/cmake_import/project/CMakeLists.txt
diff --git a/test/cmake_import/project/main.cpp b/tests/cmake_import/project/main.cpp
similarity index 100%
rename from test/cmake_import/project/main.cpp
rename to tests/cmake_import/project/main.cpp
diff --git a/test/cmake_import_minver/CMakeLists.txt b/tests/cmake_import_minver/CMakeLists.txt
similarity index 100%
rename from test/cmake_import_minver/CMakeLists.txt
rename to tests/cmake_import_minver/CMakeLists.txt
diff --git a/test/cmake_import_minver/project/CMakeLists.txt b/tests/cmake_import_minver/project/CMakeLists.txt
similarity index 100%
rename from test/cmake_import_minver/project/CMakeLists.txt
rename to tests/cmake_import_minver/project/CMakeLists.txt
diff --git a/test/cmake_import_minver/project/main.cpp b/tests/cmake_import_minver/project/main.cpp
similarity index 100%
rename from test/cmake_import_minver/project/main.cpp
rename to tests/cmake_import_minver/project/main.cpp
diff --git a/test/cmake_target_include_directories/CMakeLists.txt b/tests/cmake_target_include_directories/CMakeLists.txt
similarity index 100%
rename from test/cmake_target_include_directories/CMakeLists.txt
rename to tests/cmake_target_include_directories/CMakeLists.txt
diff --git a/test/cmake_target_include_directories/project/Bar.cpp b/tests/cmake_target_include_directories/project/Bar.cpp
similarity index 100%
rename from test/cmake_target_include_directories/project/Bar.cpp
rename to tests/cmake_target_include_directories/project/Bar.cpp
diff --git a/test/cmake_target_include_directories/project/Bar.hpp b/tests/cmake_target_include_directories/project/Bar.hpp
similarity index 100%
rename from test/cmake_target_include_directories/project/Bar.hpp
rename to tests/cmake_target_include_directories/project/Bar.hpp
diff --git a/test/cmake_target_include_directories/project/CMakeLists.txt b/tests/cmake_target_include_directories/project/CMakeLists.txt
similarity index 100%
rename from test/cmake_target_include_directories/project/CMakeLists.txt
rename to tests/cmake_target_include_directories/project/CMakeLists.txt
diff --git a/test/cmake_target_include_directories/project/Foo.cpp b/tests/cmake_target_include_directories/project/Foo.cpp
similarity index 100%
rename from test/cmake_target_include_directories/project/Foo.cpp
rename to tests/cmake_target_include_directories/project/Foo.cpp
diff --git a/test/cmake_target_include_directories/project/Foo.hpp b/tests/cmake_target_include_directories/project/Foo.hpp
similarity index 100%
rename from test/cmake_target_include_directories/project/Foo.hpp
rename to tests/cmake_target_include_directories/project/Foo.hpp
diff --git a/test/cmake_target_include_directories/project/main.cpp b/tests/cmake_target_include_directories/project/main.cpp
similarity index 100%
rename from test/cmake_target_include_directories/project/main.cpp
rename to tests/cmake_target_include_directories/project/main.cpp
diff --git a/test/cuda_example/CMakeLists.txt b/tests/cuda_example/CMakeLists.txt
similarity index 100%
rename from test/cuda_example/CMakeLists.txt
rename to tests/cuda_example/CMakeLists.txt
diff --git a/test/cuda_example/json_cuda.cu b/tests/cuda_example/json_cuda.cu
similarity index 100%
rename from test/cuda_example/json_cuda.cu
rename to tests/cuda_example/json_cuda.cu
diff --git a/test/reports/2016-08-29-fuzz/exec_speed.png b/tests/reports/2016-08-29-fuzz/exec_speed.png
similarity index 100%
rename from test/reports/2016-08-29-fuzz/exec_speed.png
rename to tests/reports/2016-08-29-fuzz/exec_speed.png
diff --git a/test/reports/2016-08-29-fuzz/fuzz.tiff b/tests/reports/2016-08-29-fuzz/fuzz.tiff
similarity index 100%
rename from test/reports/2016-08-29-fuzz/fuzz.tiff
rename to tests/reports/2016-08-29-fuzz/fuzz.tiff
diff --git a/test/reports/2016-08-29-fuzz/high_freq.png b/tests/reports/2016-08-29-fuzz/high_freq.png
similarity index 100%
rename from test/reports/2016-08-29-fuzz/high_freq.png
rename to tests/reports/2016-08-29-fuzz/high_freq.png
diff --git a/test/reports/2016-08-29-fuzz/index.html b/tests/reports/2016-08-29-fuzz/index.html
similarity index 100%
rename from test/reports/2016-08-29-fuzz/index.html
rename to tests/reports/2016-08-29-fuzz/index.html
diff --git a/test/reports/2016-08-29-fuzz/low_freq.png b/tests/reports/2016-08-29-fuzz/low_freq.png
similarity index 100%
rename from test/reports/2016-08-29-fuzz/low_freq.png
rename to tests/reports/2016-08-29-fuzz/low_freq.png
diff --git a/test/reports/2016-09-09-nativejson_benchmark/README.md b/tests/reports/2016-09-09-nativejson_benchmark/README.md
similarity index 100%
rename from test/reports/2016-09-09-nativejson_benchmark/README.md
rename to tests/reports/2016-09-09-nativejson_benchmark/README.md
diff --git a/test/reports/2016-09-09-nativejson_benchmark/conformance_Nlohmann (C++11).md b/tests/reports/2016-09-09-nativejson_benchmark/conformance_Nlohmann (C++11).md
similarity index 100%
rename from test/reports/2016-09-09-nativejson_benchmark/conformance_Nlohmann (C++11).md
rename to tests/reports/2016-09-09-nativejson_benchmark/conformance_Nlohmann (C++11).md
diff --git a/test/reports/2016-09-09-nativejson_benchmark/conformance_overall_Result.png b/tests/reports/2016-09-09-nativejson_benchmark/conformance_overall_Result.png
similarity index 100%
rename from test/reports/2016-09-09-nativejson_benchmark/conformance_overall_Result.png
rename to tests/reports/2016-09-09-nativejson_benchmark/conformance_overall_Result.png
diff --git a/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Memory_(byte).png b/tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Memory_(byte).png
similarity index 100%
rename from test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Memory_(byte).png
rename to tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Memory_(byte).png
diff --git a/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Time_(ms).png b/tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Time_(ms).png
similarity index 100%
rename from test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Time_(ms).png
rename to tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Time_(ms).png
diff --git a/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_2._Stringify_Time_(ms).png b/tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_2._Stringify_Time_(ms).png
similarity index 100%
rename from test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_2._Stringify_Time_(ms).png
rename to tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_2._Stringify_Time_(ms).png
diff --git a/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_3._Prettify_Time_(ms).png b/tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_3._Prettify_Time_(ms).png
similarity index 100%
rename from test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_3._Prettify_Time_(ms).png
rename to tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_3._Prettify_Time_(ms).png
diff --git a/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_7._Code_size_FileSize_(byte).png b/tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_7._Code_size_FileSize_(byte).png
similarity index 100%
rename from test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_7._Code_size_FileSize_(byte).png
rename to tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_7._Code_size_FileSize_(byte).png
diff --git a/test/reports/2016-10-02-fuzz/exec_speed.png b/tests/reports/2016-10-02-fuzz/exec_speed.png
similarity index 100%
rename from test/reports/2016-10-02-fuzz/exec_speed.png
rename to tests/reports/2016-10-02-fuzz/exec_speed.png
diff --git a/test/reports/2016-10-02-fuzz/fuzz.tiff b/tests/reports/2016-10-02-fuzz/fuzz.tiff
similarity index 100%
rename from test/reports/2016-10-02-fuzz/fuzz.tiff
rename to tests/reports/2016-10-02-fuzz/fuzz.tiff
diff --git a/test/reports/2016-10-02-fuzz/high_freq.png b/tests/reports/2016-10-02-fuzz/high_freq.png
similarity index 100%
rename from test/reports/2016-10-02-fuzz/high_freq.png
rename to tests/reports/2016-10-02-fuzz/high_freq.png
diff --git a/test/reports/2016-10-02-fuzz/index.html b/tests/reports/2016-10-02-fuzz/index.html
similarity index 100%
rename from test/reports/2016-10-02-fuzz/index.html
rename to tests/reports/2016-10-02-fuzz/index.html
diff --git a/test/reports/2016-10-02-fuzz/low_freq.png b/tests/reports/2016-10-02-fuzz/low_freq.png
similarity index 100%
rename from test/reports/2016-10-02-fuzz/low_freq.png
rename to tests/reports/2016-10-02-fuzz/low_freq.png
diff --git a/test/src/fuzzer-driver_afl.cpp b/tests/src/fuzzer-driver_afl.cpp
similarity index 100%
rename from test/src/fuzzer-driver_afl.cpp
rename to tests/src/fuzzer-driver_afl.cpp
diff --git a/test/src/fuzzer-parse_bjdata.cpp b/tests/src/fuzzer-parse_bjdata.cpp
similarity index 100%
rename from test/src/fuzzer-parse_bjdata.cpp
rename to tests/src/fuzzer-parse_bjdata.cpp
diff --git a/test/src/fuzzer-parse_bson.cpp b/tests/src/fuzzer-parse_bson.cpp
similarity index 100%
rename from test/src/fuzzer-parse_bson.cpp
rename to tests/src/fuzzer-parse_bson.cpp
diff --git a/test/src/fuzzer-parse_cbor.cpp b/tests/src/fuzzer-parse_cbor.cpp
similarity index 100%
rename from test/src/fuzzer-parse_cbor.cpp
rename to tests/src/fuzzer-parse_cbor.cpp
diff --git a/test/src/fuzzer-parse_json.cpp b/tests/src/fuzzer-parse_json.cpp
similarity index 100%
rename from test/src/fuzzer-parse_json.cpp
rename to tests/src/fuzzer-parse_json.cpp
diff --git a/test/src/fuzzer-parse_msgpack.cpp b/tests/src/fuzzer-parse_msgpack.cpp
similarity index 100%
rename from test/src/fuzzer-parse_msgpack.cpp
rename to tests/src/fuzzer-parse_msgpack.cpp
diff --git a/test/src/fuzzer-parse_ubjson.cpp b/tests/src/fuzzer-parse_ubjson.cpp
similarity index 100%
rename from test/src/fuzzer-parse_ubjson.cpp
rename to tests/src/fuzzer-parse_ubjson.cpp
diff --git a/test/src/test_utils.hpp b/tests/src/test_utils.hpp
similarity index 100%
rename from test/src/test_utils.hpp
rename to tests/src/test_utils.hpp
diff --git a/test/src/unit-algorithms.cpp b/tests/src/unit-algorithms.cpp
similarity index 100%
rename from test/src/unit-algorithms.cpp
rename to tests/src/unit-algorithms.cpp
diff --git a/test/src/unit-allocator.cpp b/tests/src/unit-allocator.cpp
similarity index 100%
rename from test/src/unit-allocator.cpp
rename to tests/src/unit-allocator.cpp
diff --git a/test/src/unit-alt-string.cpp b/tests/src/unit-alt-string.cpp
similarity index 100%
rename from test/src/unit-alt-string.cpp
rename to tests/src/unit-alt-string.cpp
diff --git a/test/src/unit-assert_macro.cpp b/tests/src/unit-assert_macro.cpp
similarity index 100%
rename from test/src/unit-assert_macro.cpp
rename to tests/src/unit-assert_macro.cpp
diff --git a/test/src/unit-bjdata.cpp b/tests/src/unit-bjdata.cpp
similarity index 100%
rename from test/src/unit-bjdata.cpp
rename to tests/src/unit-bjdata.cpp
diff --git a/test/src/unit-bson.cpp b/tests/src/unit-bson.cpp
similarity index 100%
rename from test/src/unit-bson.cpp
rename to tests/src/unit-bson.cpp
diff --git a/test/src/unit-byte_container_with_subtype.cpp b/tests/src/unit-byte_container_with_subtype.cpp
similarity index 100%
rename from test/src/unit-byte_container_with_subtype.cpp
rename to tests/src/unit-byte_container_with_subtype.cpp
diff --git a/test/src/unit-capacity.cpp b/tests/src/unit-capacity.cpp
similarity index 100%
rename from test/src/unit-capacity.cpp
rename to tests/src/unit-capacity.cpp
diff --git a/test/src/unit-cbor.cpp b/tests/src/unit-cbor.cpp
similarity index 100%
rename from test/src/unit-cbor.cpp
rename to tests/src/unit-cbor.cpp
diff --git a/test/src/unit-class_const_iterator.cpp b/tests/src/unit-class_const_iterator.cpp
similarity index 100%
rename from test/src/unit-class_const_iterator.cpp
rename to tests/src/unit-class_const_iterator.cpp
diff --git a/test/src/unit-class_iterator.cpp b/tests/src/unit-class_iterator.cpp
similarity index 100%
rename from test/src/unit-class_iterator.cpp
rename to tests/src/unit-class_iterator.cpp
diff --git a/test/src/unit-class_lexer.cpp b/tests/src/unit-class_lexer.cpp
similarity index 100%
rename from test/src/unit-class_lexer.cpp
rename to tests/src/unit-class_lexer.cpp
diff --git a/test/src/unit-class_parser.cpp b/tests/src/unit-class_parser.cpp
similarity index 100%
rename from test/src/unit-class_parser.cpp
rename to tests/src/unit-class_parser.cpp
diff --git a/test/src/unit-comparison.cpp b/tests/src/unit-comparison.cpp
similarity index 100%
rename from test/src/unit-comparison.cpp
rename to tests/src/unit-comparison.cpp
diff --git a/test/src/unit-concepts.cpp b/tests/src/unit-concepts.cpp
similarity index 100%
rename from test/src/unit-concepts.cpp
rename to tests/src/unit-concepts.cpp
diff --git a/test/src/unit-constructor1.cpp b/tests/src/unit-constructor1.cpp
similarity index 100%
rename from test/src/unit-constructor1.cpp
rename to tests/src/unit-constructor1.cpp
diff --git a/test/src/unit-constructor2.cpp b/tests/src/unit-constructor2.cpp
similarity index 100%
rename from test/src/unit-constructor2.cpp
rename to tests/src/unit-constructor2.cpp
diff --git a/test/src/unit-convenience.cpp b/tests/src/unit-convenience.cpp
similarity index 100%
rename from test/src/unit-convenience.cpp
rename to tests/src/unit-convenience.cpp
diff --git a/test/src/unit-conversions.cpp b/tests/src/unit-conversions.cpp
similarity index 100%
rename from test/src/unit-conversions.cpp
rename to tests/src/unit-conversions.cpp
diff --git a/test/src/unit-deserialization.cpp b/tests/src/unit-deserialization.cpp
similarity index 100%
rename from test/src/unit-deserialization.cpp
rename to tests/src/unit-deserialization.cpp
diff --git a/test/src/unit-diagnostics.cpp b/tests/src/unit-diagnostics.cpp
similarity index 100%
rename from test/src/unit-diagnostics.cpp
rename to tests/src/unit-diagnostics.cpp
diff --git a/test/src/unit-disabled_exceptions.cpp b/tests/src/unit-disabled_exceptions.cpp
similarity index 100%
rename from test/src/unit-disabled_exceptions.cpp
rename to tests/src/unit-disabled_exceptions.cpp
diff --git a/test/src/unit-element_access1.cpp b/tests/src/unit-element_access1.cpp
similarity index 100%
rename from test/src/unit-element_access1.cpp
rename to tests/src/unit-element_access1.cpp
diff --git a/test/src/unit-element_access2.cpp b/tests/src/unit-element_access2.cpp
similarity index 100%
rename from test/src/unit-element_access2.cpp
rename to tests/src/unit-element_access2.cpp
diff --git a/test/src/unit-hash.cpp b/tests/src/unit-hash.cpp
similarity index 100%
rename from test/src/unit-hash.cpp
rename to tests/src/unit-hash.cpp
diff --git a/test/src/unit-inspection.cpp b/tests/src/unit-inspection.cpp
similarity index 100%
rename from test/src/unit-inspection.cpp
rename to tests/src/unit-inspection.cpp
diff --git a/test/src/unit-items.cpp b/tests/src/unit-items.cpp
similarity index 100%
rename from test/src/unit-items.cpp
rename to tests/src/unit-items.cpp
diff --git a/test/src/unit-iterators1.cpp b/tests/src/unit-iterators1.cpp
similarity index 100%
rename from test/src/unit-iterators1.cpp
rename to tests/src/unit-iterators1.cpp
diff --git a/test/src/unit-iterators2.cpp b/tests/src/unit-iterators2.cpp
similarity index 100%
rename from test/src/unit-iterators2.cpp
rename to tests/src/unit-iterators2.cpp
diff --git a/test/src/unit-json_patch.cpp b/tests/src/unit-json_patch.cpp
similarity index 100%
rename from test/src/unit-json_patch.cpp
rename to tests/src/unit-json_patch.cpp
diff --git a/test/src/unit-json_pointer.cpp b/tests/src/unit-json_pointer.cpp
similarity index 100%
rename from test/src/unit-json_pointer.cpp
rename to tests/src/unit-json_pointer.cpp
diff --git a/test/src/unit-large_json.cpp b/tests/src/unit-large_json.cpp
similarity index 100%
rename from test/src/unit-large_json.cpp
rename to tests/src/unit-large_json.cpp
diff --git a/test/src/unit-merge_patch.cpp b/tests/src/unit-merge_patch.cpp
similarity index 100%
rename from test/src/unit-merge_patch.cpp
rename to tests/src/unit-merge_patch.cpp
diff --git a/test/src/unit-meta.cpp b/tests/src/unit-meta.cpp
similarity index 100%
rename from test/src/unit-meta.cpp
rename to tests/src/unit-meta.cpp
diff --git a/test/src/unit-modifiers.cpp b/tests/src/unit-modifiers.cpp
similarity index 100%
rename from test/src/unit-modifiers.cpp
rename to tests/src/unit-modifiers.cpp
diff --git a/test/src/unit-msgpack.cpp b/tests/src/unit-msgpack.cpp
similarity index 100%
rename from test/src/unit-msgpack.cpp
rename to tests/src/unit-msgpack.cpp
diff --git a/test/src/unit-noexcept.cpp b/tests/src/unit-noexcept.cpp
similarity index 100%
rename from test/src/unit-noexcept.cpp
rename to tests/src/unit-noexcept.cpp
diff --git a/test/src/unit-ordered_json.cpp b/tests/src/unit-ordered_json.cpp
similarity index 100%
rename from test/src/unit-ordered_json.cpp
rename to tests/src/unit-ordered_json.cpp
diff --git a/test/src/unit-ordered_map.cpp b/tests/src/unit-ordered_map.cpp
similarity index 100%
rename from test/src/unit-ordered_map.cpp
rename to tests/src/unit-ordered_map.cpp
diff --git a/test/src/unit-pointer_access.cpp b/tests/src/unit-pointer_access.cpp
similarity index 100%
rename from test/src/unit-pointer_access.cpp
rename to tests/src/unit-pointer_access.cpp
diff --git a/test/src/unit-readme.cpp b/tests/src/unit-readme.cpp
similarity index 100%
rename from test/src/unit-readme.cpp
rename to tests/src/unit-readme.cpp
diff --git a/test/src/unit-reference_access.cpp b/tests/src/unit-reference_access.cpp
similarity index 100%
rename from test/src/unit-reference_access.cpp
rename to tests/src/unit-reference_access.cpp
diff --git a/test/src/unit-regression1.cpp b/tests/src/unit-regression1.cpp
similarity index 100%
rename from test/src/unit-regression1.cpp
rename to tests/src/unit-regression1.cpp
diff --git a/test/src/unit-regression2.cpp b/tests/src/unit-regression2.cpp
similarity index 100%
rename from test/src/unit-regression2.cpp
rename to tests/src/unit-regression2.cpp
diff --git a/test/src/unit-serialization.cpp b/tests/src/unit-serialization.cpp
similarity index 100%
rename from test/src/unit-serialization.cpp
rename to tests/src/unit-serialization.cpp
diff --git a/test/src/unit-testsuites.cpp b/tests/src/unit-testsuites.cpp
similarity index 100%
rename from test/src/unit-testsuites.cpp
rename to tests/src/unit-testsuites.cpp
diff --git a/test/src/unit-to_chars.cpp b/tests/src/unit-to_chars.cpp
similarity index 100%
rename from test/src/unit-to_chars.cpp
rename to tests/src/unit-to_chars.cpp
diff --git a/test/src/unit-ubjson.cpp b/tests/src/unit-ubjson.cpp
similarity index 100%
rename from test/src/unit-ubjson.cpp
rename to tests/src/unit-ubjson.cpp
diff --git a/test/src/unit-udt.cpp b/tests/src/unit-udt.cpp
similarity index 100%
rename from test/src/unit-udt.cpp
rename to tests/src/unit-udt.cpp
diff --git a/test/src/unit-udt_macro.cpp b/tests/src/unit-udt_macro.cpp
similarity index 100%
rename from test/src/unit-udt_macro.cpp
rename to tests/src/unit-udt_macro.cpp
diff --git a/test/src/unit-unicode1.cpp b/tests/src/unit-unicode1.cpp
similarity index 100%
rename from test/src/unit-unicode1.cpp
rename to tests/src/unit-unicode1.cpp
diff --git a/test/src/unit-unicode2.cpp b/tests/src/unit-unicode2.cpp
similarity index 100%
rename from test/src/unit-unicode2.cpp
rename to tests/src/unit-unicode2.cpp
diff --git a/test/src/unit-unicode3.cpp b/tests/src/unit-unicode3.cpp
similarity index 100%
rename from test/src/unit-unicode3.cpp
rename to tests/src/unit-unicode3.cpp
diff --git a/test/src/unit-unicode4.cpp b/tests/src/unit-unicode4.cpp
similarity index 100%
rename from test/src/unit-unicode4.cpp
rename to tests/src/unit-unicode4.cpp
diff --git a/test/src/unit-unicode5.cpp b/tests/src/unit-unicode5.cpp
similarity index 100%
rename from test/src/unit-unicode5.cpp
rename to tests/src/unit-unicode5.cpp
diff --git a/test/src/unit-user_defined_input.cpp b/tests/src/unit-user_defined_input.cpp
similarity index 100%
rename from test/src/unit-user_defined_input.cpp
rename to tests/src/unit-user_defined_input.cpp
diff --git a/test/src/unit-wstring.cpp b/tests/src/unit-wstring.cpp
similarity index 100%
rename from test/src/unit-wstring.cpp
rename to tests/src/unit-wstring.cpp
diff --git a/test/src/unit.cpp b/tests/src/unit.cpp
similarity index 100%
rename from test/src/unit.cpp
rename to tests/src/unit.cpp
diff --git a/test/thirdparty/Fuzzer/CMakeLists.txt b/tests/thirdparty/Fuzzer/CMakeLists.txt
similarity index 100%
rename from test/thirdparty/Fuzzer/CMakeLists.txt
rename to tests/thirdparty/Fuzzer/CMakeLists.txt
diff --git a/test/thirdparty/Fuzzer/FuzzerCorpus.h b/tests/thirdparty/Fuzzer/FuzzerCorpus.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerCorpus.h
rename to tests/thirdparty/Fuzzer/FuzzerCorpus.h
diff --git a/test/thirdparty/Fuzzer/FuzzerCrossOver.cpp b/tests/thirdparty/Fuzzer/FuzzerCrossOver.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerCrossOver.cpp
rename to tests/thirdparty/Fuzzer/FuzzerCrossOver.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerDefs.h b/tests/thirdparty/Fuzzer/FuzzerDefs.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerDefs.h
rename to tests/thirdparty/Fuzzer/FuzzerDefs.h
diff --git a/test/thirdparty/Fuzzer/FuzzerDictionary.h b/tests/thirdparty/Fuzzer/FuzzerDictionary.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerDictionary.h
rename to tests/thirdparty/Fuzzer/FuzzerDictionary.h
diff --git a/test/thirdparty/Fuzzer/FuzzerDriver.cpp b/tests/thirdparty/Fuzzer/FuzzerDriver.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerDriver.cpp
rename to tests/thirdparty/Fuzzer/FuzzerDriver.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerExtFunctions.def b/tests/thirdparty/Fuzzer/FuzzerExtFunctions.def
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerExtFunctions.def
rename to tests/thirdparty/Fuzzer/FuzzerExtFunctions.def
diff --git a/test/thirdparty/Fuzzer/FuzzerExtFunctions.h b/tests/thirdparty/Fuzzer/FuzzerExtFunctions.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerExtFunctions.h
rename to tests/thirdparty/Fuzzer/FuzzerExtFunctions.h
diff --git a/test/thirdparty/Fuzzer/FuzzerExtFunctionsDlsym.cpp b/tests/thirdparty/Fuzzer/FuzzerExtFunctionsDlsym.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerExtFunctionsDlsym.cpp
rename to tests/thirdparty/Fuzzer/FuzzerExtFunctionsDlsym.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerExtFunctionsWeak.cpp b/tests/thirdparty/Fuzzer/FuzzerExtFunctionsWeak.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerExtFunctionsWeak.cpp
rename to tests/thirdparty/Fuzzer/FuzzerExtFunctionsWeak.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerExtFunctionsWeakAlias.cpp b/tests/thirdparty/Fuzzer/FuzzerExtFunctionsWeakAlias.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerExtFunctionsWeakAlias.cpp
rename to tests/thirdparty/Fuzzer/FuzzerExtFunctionsWeakAlias.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerFlags.def b/tests/thirdparty/Fuzzer/FuzzerFlags.def
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerFlags.def
rename to tests/thirdparty/Fuzzer/FuzzerFlags.def
diff --git a/test/thirdparty/Fuzzer/FuzzerIO.cpp b/tests/thirdparty/Fuzzer/FuzzerIO.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerIO.cpp
rename to tests/thirdparty/Fuzzer/FuzzerIO.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerIO.h b/tests/thirdparty/Fuzzer/FuzzerIO.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerIO.h
rename to tests/thirdparty/Fuzzer/FuzzerIO.h
diff --git a/test/thirdparty/Fuzzer/FuzzerIOPosix.cpp b/tests/thirdparty/Fuzzer/FuzzerIOPosix.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerIOPosix.cpp
rename to tests/thirdparty/Fuzzer/FuzzerIOPosix.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerIOWindows.cpp b/tests/thirdparty/Fuzzer/FuzzerIOWindows.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerIOWindows.cpp
rename to tests/thirdparty/Fuzzer/FuzzerIOWindows.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerInterface.h b/tests/thirdparty/Fuzzer/FuzzerInterface.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerInterface.h
rename to tests/thirdparty/Fuzzer/FuzzerInterface.h
diff --git a/test/thirdparty/Fuzzer/FuzzerInternal.h b/tests/thirdparty/Fuzzer/FuzzerInternal.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerInternal.h
rename to tests/thirdparty/Fuzzer/FuzzerInternal.h
diff --git a/test/thirdparty/Fuzzer/FuzzerLoop.cpp b/tests/thirdparty/Fuzzer/FuzzerLoop.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerLoop.cpp
rename to tests/thirdparty/Fuzzer/FuzzerLoop.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerMain.cpp b/tests/thirdparty/Fuzzer/FuzzerMain.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerMain.cpp
rename to tests/thirdparty/Fuzzer/FuzzerMain.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerMerge.cpp b/tests/thirdparty/Fuzzer/FuzzerMerge.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerMerge.cpp
rename to tests/thirdparty/Fuzzer/FuzzerMerge.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerMerge.h b/tests/thirdparty/Fuzzer/FuzzerMerge.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerMerge.h
rename to tests/thirdparty/Fuzzer/FuzzerMerge.h
diff --git a/test/thirdparty/Fuzzer/FuzzerMutate.cpp b/tests/thirdparty/Fuzzer/FuzzerMutate.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerMutate.cpp
rename to tests/thirdparty/Fuzzer/FuzzerMutate.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerMutate.h b/tests/thirdparty/Fuzzer/FuzzerMutate.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerMutate.h
rename to tests/thirdparty/Fuzzer/FuzzerMutate.h
diff --git a/test/thirdparty/Fuzzer/FuzzerOptions.h b/tests/thirdparty/Fuzzer/FuzzerOptions.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerOptions.h
rename to tests/thirdparty/Fuzzer/FuzzerOptions.h
diff --git a/test/thirdparty/Fuzzer/FuzzerRandom.h b/tests/thirdparty/Fuzzer/FuzzerRandom.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerRandom.h
rename to tests/thirdparty/Fuzzer/FuzzerRandom.h
diff --git a/test/thirdparty/Fuzzer/FuzzerSHA1.cpp b/tests/thirdparty/Fuzzer/FuzzerSHA1.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerSHA1.cpp
rename to tests/thirdparty/Fuzzer/FuzzerSHA1.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerSHA1.h b/tests/thirdparty/Fuzzer/FuzzerSHA1.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerSHA1.h
rename to tests/thirdparty/Fuzzer/FuzzerSHA1.h
diff --git a/test/thirdparty/Fuzzer/FuzzerTracePC.cpp b/tests/thirdparty/Fuzzer/FuzzerTracePC.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerTracePC.cpp
rename to tests/thirdparty/Fuzzer/FuzzerTracePC.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerTracePC.h b/tests/thirdparty/Fuzzer/FuzzerTracePC.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerTracePC.h
rename to tests/thirdparty/Fuzzer/FuzzerTracePC.h
diff --git a/test/thirdparty/Fuzzer/FuzzerTraceState.cpp b/tests/thirdparty/Fuzzer/FuzzerTraceState.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerTraceState.cpp
rename to tests/thirdparty/Fuzzer/FuzzerTraceState.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerUtil.cpp b/tests/thirdparty/Fuzzer/FuzzerUtil.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerUtil.cpp
rename to tests/thirdparty/Fuzzer/FuzzerUtil.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerUtil.h b/tests/thirdparty/Fuzzer/FuzzerUtil.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerUtil.h
rename to tests/thirdparty/Fuzzer/FuzzerUtil.h
diff --git a/test/thirdparty/Fuzzer/FuzzerUtilDarwin.cpp b/tests/thirdparty/Fuzzer/FuzzerUtilDarwin.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerUtilDarwin.cpp
rename to tests/thirdparty/Fuzzer/FuzzerUtilDarwin.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerUtilLinux.cpp b/tests/thirdparty/Fuzzer/FuzzerUtilLinux.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerUtilLinux.cpp
rename to tests/thirdparty/Fuzzer/FuzzerUtilLinux.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerUtilPosix.cpp b/tests/thirdparty/Fuzzer/FuzzerUtilPosix.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerUtilPosix.cpp
rename to tests/thirdparty/Fuzzer/FuzzerUtilPosix.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerUtilWindows.cpp b/tests/thirdparty/Fuzzer/FuzzerUtilWindows.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerUtilWindows.cpp
rename to tests/thirdparty/Fuzzer/FuzzerUtilWindows.cpp
diff --git a/test/thirdparty/Fuzzer/FuzzerValueBitMap.h b/tests/thirdparty/Fuzzer/FuzzerValueBitMap.h
similarity index 100%
rename from test/thirdparty/Fuzzer/FuzzerValueBitMap.h
rename to tests/thirdparty/Fuzzer/FuzzerValueBitMap.h
diff --git a/test/thirdparty/Fuzzer/README.txt b/tests/thirdparty/Fuzzer/README.txt
similarity index 100%
rename from test/thirdparty/Fuzzer/README.txt
rename to tests/thirdparty/Fuzzer/README.txt
diff --git a/test/thirdparty/Fuzzer/afl/afl_driver.cpp b/tests/thirdparty/Fuzzer/afl/afl_driver.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/afl/afl_driver.cpp
rename to tests/thirdparty/Fuzzer/afl/afl_driver.cpp
diff --git a/test/thirdparty/Fuzzer/build.sh b/tests/thirdparty/Fuzzer/build.sh
similarity index 100%
rename from test/thirdparty/Fuzzer/build.sh
rename to tests/thirdparty/Fuzzer/build.sh
diff --git a/test/thirdparty/Fuzzer/cxx.dict b/tests/thirdparty/Fuzzer/cxx.dict
similarity index 100%
rename from test/thirdparty/Fuzzer/cxx.dict
rename to tests/thirdparty/Fuzzer/cxx.dict
diff --git a/test/thirdparty/Fuzzer/standalone/StandaloneFuzzTargetMain.c b/tests/thirdparty/Fuzzer/standalone/StandaloneFuzzTargetMain.c
similarity index 100%
rename from test/thirdparty/Fuzzer/standalone/StandaloneFuzzTargetMain.c
rename to tests/thirdparty/Fuzzer/standalone/StandaloneFuzzTargetMain.c
diff --git a/test/thirdparty/Fuzzer/test/AFLDriverTest.cpp b/tests/thirdparty/Fuzzer/test/AFLDriverTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/AFLDriverTest.cpp
rename to tests/thirdparty/Fuzzer/test/AFLDriverTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/AbsNegAndConstant64Test.cpp b/tests/thirdparty/Fuzzer/test/AbsNegAndConstant64Test.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/AbsNegAndConstant64Test.cpp
rename to tests/thirdparty/Fuzzer/test/AbsNegAndConstant64Test.cpp
diff --git a/test/thirdparty/Fuzzer/test/AbsNegAndConstantTest.cpp b/tests/thirdparty/Fuzzer/test/AbsNegAndConstantTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/AbsNegAndConstantTest.cpp
rename to tests/thirdparty/Fuzzer/test/AbsNegAndConstantTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/AccumulateAllocationsTest.cpp b/tests/thirdparty/Fuzzer/test/AccumulateAllocationsTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/AccumulateAllocationsTest.cpp
rename to tests/thirdparty/Fuzzer/test/AccumulateAllocationsTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/BufferOverflowOnInput.cpp b/tests/thirdparty/Fuzzer/test/BufferOverflowOnInput.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/BufferOverflowOnInput.cpp
rename to tests/thirdparty/Fuzzer/test/BufferOverflowOnInput.cpp
diff --git a/test/thirdparty/Fuzzer/test/CMakeLists.txt b/tests/thirdparty/Fuzzer/test/CMakeLists.txt
similarity index 100%
rename from test/thirdparty/Fuzzer/test/CMakeLists.txt
rename to tests/thirdparty/Fuzzer/test/CMakeLists.txt
diff --git a/test/thirdparty/Fuzzer/test/CallerCalleeTest.cpp b/tests/thirdparty/Fuzzer/test/CallerCalleeTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/CallerCalleeTest.cpp
rename to tests/thirdparty/Fuzzer/test/CallerCalleeTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/CounterTest.cpp b/tests/thirdparty/Fuzzer/test/CounterTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/CounterTest.cpp
rename to tests/thirdparty/Fuzzer/test/CounterTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/CustomCrossOverTest.cpp b/tests/thirdparty/Fuzzer/test/CustomCrossOverTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/CustomCrossOverTest.cpp
rename to tests/thirdparty/Fuzzer/test/CustomCrossOverTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/CustomMutatorTest.cpp b/tests/thirdparty/Fuzzer/test/CustomMutatorTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/CustomMutatorTest.cpp
rename to tests/thirdparty/Fuzzer/test/CustomMutatorTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/DSO1.cpp b/tests/thirdparty/Fuzzer/test/DSO1.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/DSO1.cpp
rename to tests/thirdparty/Fuzzer/test/DSO1.cpp
diff --git a/test/thirdparty/Fuzzer/test/DSO2.cpp b/tests/thirdparty/Fuzzer/test/DSO2.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/DSO2.cpp
rename to tests/thirdparty/Fuzzer/test/DSO2.cpp
diff --git a/test/thirdparty/Fuzzer/test/DSOTestExtra.cpp b/tests/thirdparty/Fuzzer/test/DSOTestExtra.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/DSOTestExtra.cpp
rename to tests/thirdparty/Fuzzer/test/DSOTestExtra.cpp
diff --git a/test/thirdparty/Fuzzer/test/DSOTestMain.cpp b/tests/thirdparty/Fuzzer/test/DSOTestMain.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/DSOTestMain.cpp
rename to tests/thirdparty/Fuzzer/test/DSOTestMain.cpp
diff --git a/test/thirdparty/Fuzzer/test/DivTest.cpp b/tests/thirdparty/Fuzzer/test/DivTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/DivTest.cpp
rename to tests/thirdparty/Fuzzer/test/DivTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/EmptyTest.cpp b/tests/thirdparty/Fuzzer/test/EmptyTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/EmptyTest.cpp
rename to tests/thirdparty/Fuzzer/test/EmptyTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/FourIndependentBranchesTest.cpp b/tests/thirdparty/Fuzzer/test/FourIndependentBranchesTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/FourIndependentBranchesTest.cpp
rename to tests/thirdparty/Fuzzer/test/FourIndependentBranchesTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/FullCoverageSetTest.cpp b/tests/thirdparty/Fuzzer/test/FullCoverageSetTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/FullCoverageSetTest.cpp
rename to tests/thirdparty/Fuzzer/test/FullCoverageSetTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/FuzzerUnittest.cpp b/tests/thirdparty/Fuzzer/test/FuzzerUnittest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/FuzzerUnittest.cpp
rename to tests/thirdparty/Fuzzer/test/FuzzerUnittest.cpp
diff --git a/test/thirdparty/Fuzzer/test/InitializeTest.cpp b/tests/thirdparty/Fuzzer/test/InitializeTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/InitializeTest.cpp
rename to tests/thirdparty/Fuzzer/test/InitializeTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/LeakTest.cpp b/tests/thirdparty/Fuzzer/test/LeakTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/LeakTest.cpp
rename to tests/thirdparty/Fuzzer/test/LeakTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/LeakTimeoutTest.cpp b/tests/thirdparty/Fuzzer/test/LeakTimeoutTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/LeakTimeoutTest.cpp
rename to tests/thirdparty/Fuzzer/test/LeakTimeoutTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/LoadTest.cpp b/tests/thirdparty/Fuzzer/test/LoadTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/LoadTest.cpp
rename to tests/thirdparty/Fuzzer/test/LoadTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/MemcmpTest.cpp b/tests/thirdparty/Fuzzer/test/MemcmpTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/MemcmpTest.cpp
rename to tests/thirdparty/Fuzzer/test/MemcmpTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/NthRunCrashTest.cpp b/tests/thirdparty/Fuzzer/test/NthRunCrashTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/NthRunCrashTest.cpp
rename to tests/thirdparty/Fuzzer/test/NthRunCrashTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/NullDerefOnEmptyTest.cpp b/tests/thirdparty/Fuzzer/test/NullDerefOnEmptyTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/NullDerefOnEmptyTest.cpp
rename to tests/thirdparty/Fuzzer/test/NullDerefOnEmptyTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/NullDerefTest.cpp b/tests/thirdparty/Fuzzer/test/NullDerefTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/NullDerefTest.cpp
rename to tests/thirdparty/Fuzzer/test/NullDerefTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/OneHugeAllocTest.cpp b/tests/thirdparty/Fuzzer/test/OneHugeAllocTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/OneHugeAllocTest.cpp
rename to tests/thirdparty/Fuzzer/test/OneHugeAllocTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/OutOfMemorySingleLargeMallocTest.cpp b/tests/thirdparty/Fuzzer/test/OutOfMemorySingleLargeMallocTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/OutOfMemorySingleLargeMallocTest.cpp
rename to tests/thirdparty/Fuzzer/test/OutOfMemorySingleLargeMallocTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/OutOfMemoryTest.cpp b/tests/thirdparty/Fuzzer/test/OutOfMemoryTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/OutOfMemoryTest.cpp
rename to tests/thirdparty/Fuzzer/test/OutOfMemoryTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/RepeatedBytesTest.cpp b/tests/thirdparty/Fuzzer/test/RepeatedBytesTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/RepeatedBytesTest.cpp
rename to tests/thirdparty/Fuzzer/test/RepeatedBytesTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/RepeatedMemcmp.cpp b/tests/thirdparty/Fuzzer/test/RepeatedMemcmp.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/RepeatedMemcmp.cpp
rename to tests/thirdparty/Fuzzer/test/RepeatedMemcmp.cpp
diff --git a/test/thirdparty/Fuzzer/test/ShrinkControlFlowTest.cpp b/tests/thirdparty/Fuzzer/test/ShrinkControlFlowTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/ShrinkControlFlowTest.cpp
rename to tests/thirdparty/Fuzzer/test/ShrinkControlFlowTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/ShrinkValueProfileTest.cpp b/tests/thirdparty/Fuzzer/test/ShrinkValueProfileTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/ShrinkValueProfileTest.cpp
rename to tests/thirdparty/Fuzzer/test/ShrinkValueProfileTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/SignedIntOverflowTest.cpp b/tests/thirdparty/Fuzzer/test/SignedIntOverflowTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/SignedIntOverflowTest.cpp
rename to tests/thirdparty/Fuzzer/test/SignedIntOverflowTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/SimpleCmpTest.cpp b/tests/thirdparty/Fuzzer/test/SimpleCmpTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/SimpleCmpTest.cpp
rename to tests/thirdparty/Fuzzer/test/SimpleCmpTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/SimpleDictionaryTest.cpp b/tests/thirdparty/Fuzzer/test/SimpleDictionaryTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/SimpleDictionaryTest.cpp
rename to tests/thirdparty/Fuzzer/test/SimpleDictionaryTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/SimpleHashTest.cpp b/tests/thirdparty/Fuzzer/test/SimpleHashTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/SimpleHashTest.cpp
rename to tests/thirdparty/Fuzzer/test/SimpleHashTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/SimpleTest.cpp b/tests/thirdparty/Fuzzer/test/SimpleTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/SimpleTest.cpp
rename to tests/thirdparty/Fuzzer/test/SimpleTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/SimpleThreadedTest.cpp b/tests/thirdparty/Fuzzer/test/SimpleThreadedTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/SimpleThreadedTest.cpp
rename to tests/thirdparty/Fuzzer/test/SimpleThreadedTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/SingleMemcmpTest.cpp b/tests/thirdparty/Fuzzer/test/SingleMemcmpTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/SingleMemcmpTest.cpp
rename to tests/thirdparty/Fuzzer/test/SingleMemcmpTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/SingleStrcmpTest.cpp b/tests/thirdparty/Fuzzer/test/SingleStrcmpTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/SingleStrcmpTest.cpp
rename to tests/thirdparty/Fuzzer/test/SingleStrcmpTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/SingleStrncmpTest.cpp b/tests/thirdparty/Fuzzer/test/SingleStrncmpTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/SingleStrncmpTest.cpp
rename to tests/thirdparty/Fuzzer/test/SingleStrncmpTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/SpamyTest.cpp b/tests/thirdparty/Fuzzer/test/SpamyTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/SpamyTest.cpp
rename to tests/thirdparty/Fuzzer/test/SpamyTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/StrcmpTest.cpp b/tests/thirdparty/Fuzzer/test/StrcmpTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/StrcmpTest.cpp
rename to tests/thirdparty/Fuzzer/test/StrcmpTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/StrncmpOOBTest.cpp b/tests/thirdparty/Fuzzer/test/StrncmpOOBTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/StrncmpOOBTest.cpp
rename to tests/thirdparty/Fuzzer/test/StrncmpOOBTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/StrncmpTest.cpp b/tests/thirdparty/Fuzzer/test/StrncmpTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/StrncmpTest.cpp
rename to tests/thirdparty/Fuzzer/test/StrncmpTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/StrstrTest.cpp b/tests/thirdparty/Fuzzer/test/StrstrTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/StrstrTest.cpp
rename to tests/thirdparty/Fuzzer/test/StrstrTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/SwapCmpTest.cpp b/tests/thirdparty/Fuzzer/test/SwapCmpTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/SwapCmpTest.cpp
rename to tests/thirdparty/Fuzzer/test/SwapCmpTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/Switch2Test.cpp b/tests/thirdparty/Fuzzer/test/Switch2Test.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/Switch2Test.cpp
rename to tests/thirdparty/Fuzzer/test/Switch2Test.cpp
diff --git a/test/thirdparty/Fuzzer/test/SwitchTest.cpp b/tests/thirdparty/Fuzzer/test/SwitchTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/SwitchTest.cpp
rename to tests/thirdparty/Fuzzer/test/SwitchTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/ThreadedLeakTest.cpp b/tests/thirdparty/Fuzzer/test/ThreadedLeakTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/ThreadedLeakTest.cpp
rename to tests/thirdparty/Fuzzer/test/ThreadedLeakTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/ThreadedTest.cpp b/tests/thirdparty/Fuzzer/test/ThreadedTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/ThreadedTest.cpp
rename to tests/thirdparty/Fuzzer/test/ThreadedTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/TimeoutEmptyTest.cpp b/tests/thirdparty/Fuzzer/test/TimeoutEmptyTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/TimeoutEmptyTest.cpp
rename to tests/thirdparty/Fuzzer/test/TimeoutEmptyTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/TimeoutTest.cpp b/tests/thirdparty/Fuzzer/test/TimeoutTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/TimeoutTest.cpp
rename to tests/thirdparty/Fuzzer/test/TimeoutTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/TraceMallocTest.cpp b/tests/thirdparty/Fuzzer/test/TraceMallocTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/TraceMallocTest.cpp
rename to tests/thirdparty/Fuzzer/test/TraceMallocTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/UninstrumentedTest.cpp b/tests/thirdparty/Fuzzer/test/UninstrumentedTest.cpp
similarity index 100%
rename from test/thirdparty/Fuzzer/test/UninstrumentedTest.cpp
rename to tests/thirdparty/Fuzzer/test/UninstrumentedTest.cpp
diff --git a/test/thirdparty/Fuzzer/test/afl-driver-extra-stats.test b/tests/thirdparty/Fuzzer/test/afl-driver-extra-stats.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/afl-driver-extra-stats.test
rename to tests/thirdparty/Fuzzer/test/afl-driver-extra-stats.test
diff --git a/test/thirdparty/Fuzzer/test/afl-driver-stderr.test b/tests/thirdparty/Fuzzer/test/afl-driver-stderr.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/afl-driver-stderr.test
rename to tests/thirdparty/Fuzzer/test/afl-driver-stderr.test
diff --git a/test/thirdparty/Fuzzer/test/caller-callee.test b/tests/thirdparty/Fuzzer/test/caller-callee.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/caller-callee.test
rename to tests/thirdparty/Fuzzer/test/caller-callee.test
diff --git a/test/thirdparty/Fuzzer/test/coverage.test b/tests/thirdparty/Fuzzer/test/coverage.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/coverage.test
rename to tests/thirdparty/Fuzzer/test/coverage.test
diff --git a/test/thirdparty/Fuzzer/test/dict1.txt b/tests/thirdparty/Fuzzer/test/dict1.txt
similarity index 100%
rename from test/thirdparty/Fuzzer/test/dict1.txt
rename to tests/thirdparty/Fuzzer/test/dict1.txt
diff --git a/test/thirdparty/Fuzzer/test/dump_coverage.test b/tests/thirdparty/Fuzzer/test/dump_coverage.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/dump_coverage.test
rename to tests/thirdparty/Fuzzer/test/dump_coverage.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-customcrossover.test b/tests/thirdparty/Fuzzer/test/fuzzer-customcrossover.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-customcrossover.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-customcrossover.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-custommutator.test b/tests/thirdparty/Fuzzer/test/fuzzer-custommutator.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-custommutator.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-custommutator.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-dict.test b/tests/thirdparty/Fuzzer/test/fuzzer-dict.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-dict.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-dict.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-dirs.test b/tests/thirdparty/Fuzzer/test/fuzzer-dirs.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-dirs.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-dirs.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-fdmask.test b/tests/thirdparty/Fuzzer/test/fuzzer-fdmask.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-fdmask.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-fdmask.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-finalstats.test b/tests/thirdparty/Fuzzer/test/fuzzer-finalstats.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-finalstats.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-finalstats.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-flags.test b/tests/thirdparty/Fuzzer/test/fuzzer-flags.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-flags.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-flags.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-jobs.test b/tests/thirdparty/Fuzzer/test/fuzzer-jobs.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-jobs.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-jobs.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-leak.test b/tests/thirdparty/Fuzzer/test/fuzzer-leak.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-leak.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-leak.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-oom-with-profile.test b/tests/thirdparty/Fuzzer/test/fuzzer-oom-with-profile.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-oom-with-profile.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-oom-with-profile.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-oom.test b/tests/thirdparty/Fuzzer/test/fuzzer-oom.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-oom.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-oom.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-printcovpcs.test b/tests/thirdparty/Fuzzer/test/fuzzer-printcovpcs.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-printcovpcs.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-printcovpcs.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-runs.test b/tests/thirdparty/Fuzzer/test/fuzzer-runs.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-runs.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-runs.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-seed.test b/tests/thirdparty/Fuzzer/test/fuzzer-seed.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-seed.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-seed.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-segv.test b/tests/thirdparty/Fuzzer/test/fuzzer-segv.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-segv.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-segv.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-singleinputs.test b/tests/thirdparty/Fuzzer/test/fuzzer-singleinputs.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-singleinputs.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-singleinputs.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-threaded.test b/tests/thirdparty/Fuzzer/test/fuzzer-threaded.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-threaded.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-threaded.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-timeout.test b/tests/thirdparty/Fuzzer/test/fuzzer-timeout.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-timeout.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-timeout.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-traces-hooks.test b/tests/thirdparty/Fuzzer/test/fuzzer-traces-hooks.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-traces-hooks.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-traces-hooks.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer-ubsan.test b/tests/thirdparty/Fuzzer/test/fuzzer-ubsan.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer-ubsan.test
rename to tests/thirdparty/Fuzzer/test/fuzzer-ubsan.test
diff --git a/test/thirdparty/Fuzzer/test/fuzzer.test b/tests/thirdparty/Fuzzer/test/fuzzer.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/fuzzer.test
rename to tests/thirdparty/Fuzzer/test/fuzzer.test
diff --git a/test/thirdparty/Fuzzer/test/hi.txt b/tests/thirdparty/Fuzzer/test/hi.txt
similarity index 100%
rename from test/thirdparty/Fuzzer/test/hi.txt
rename to tests/thirdparty/Fuzzer/test/hi.txt
diff --git a/test/thirdparty/Fuzzer/test/lit.cfg b/tests/thirdparty/Fuzzer/test/lit.cfg
similarity index 100%
rename from test/thirdparty/Fuzzer/test/lit.cfg
rename to tests/thirdparty/Fuzzer/test/lit.cfg
diff --git a/test/thirdparty/Fuzzer/test/lit.site.cfg.in b/tests/thirdparty/Fuzzer/test/lit.site.cfg.in
similarity index 100%
rename from test/thirdparty/Fuzzer/test/lit.site.cfg.in
rename to tests/thirdparty/Fuzzer/test/lit.site.cfg.in
diff --git a/test/thirdparty/Fuzzer/test/merge.test b/tests/thirdparty/Fuzzer/test/merge.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/merge.test
rename to tests/thirdparty/Fuzzer/test/merge.test
diff --git a/test/thirdparty/Fuzzer/test/minimize_crash.test b/tests/thirdparty/Fuzzer/test/minimize_crash.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/minimize_crash.test
rename to tests/thirdparty/Fuzzer/test/minimize_crash.test
diff --git a/test/thirdparty/Fuzzer/test/no-coverage/CMakeLists.txt b/tests/thirdparty/Fuzzer/test/no-coverage/CMakeLists.txt
similarity index 100%
rename from test/thirdparty/Fuzzer/test/no-coverage/CMakeLists.txt
rename to tests/thirdparty/Fuzzer/test/no-coverage/CMakeLists.txt
diff --git a/test/thirdparty/Fuzzer/test/repeated-bytes.test b/tests/thirdparty/Fuzzer/test/repeated-bytes.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/repeated-bytes.test
rename to tests/thirdparty/Fuzzer/test/repeated-bytes.test
diff --git a/test/thirdparty/Fuzzer/test/shrink.test b/tests/thirdparty/Fuzzer/test/shrink.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/shrink.test
rename to tests/thirdparty/Fuzzer/test/shrink.test
diff --git a/test/thirdparty/Fuzzer/test/simple-cmp.test b/tests/thirdparty/Fuzzer/test/simple-cmp.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/simple-cmp.test
rename to tests/thirdparty/Fuzzer/test/simple-cmp.test
diff --git a/test/thirdparty/Fuzzer/test/standalone.test b/tests/thirdparty/Fuzzer/test/standalone.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/standalone.test
rename to tests/thirdparty/Fuzzer/test/standalone.test
diff --git a/test/thirdparty/Fuzzer/test/swap-cmp.test b/tests/thirdparty/Fuzzer/test/swap-cmp.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/swap-cmp.test
rename to tests/thirdparty/Fuzzer/test/swap-cmp.test
diff --git a/test/thirdparty/Fuzzer/test/trace-malloc.test b/tests/thirdparty/Fuzzer/test/trace-malloc.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/trace-malloc.test
rename to tests/thirdparty/Fuzzer/test/trace-malloc.test
diff --git a/test/thirdparty/Fuzzer/test/ubsan/CMakeLists.txt b/tests/thirdparty/Fuzzer/test/ubsan/CMakeLists.txt
similarity index 100%
rename from test/thirdparty/Fuzzer/test/ubsan/CMakeLists.txt
rename to tests/thirdparty/Fuzzer/test/ubsan/CMakeLists.txt
diff --git a/test/thirdparty/Fuzzer/test/ulimit.test b/tests/thirdparty/Fuzzer/test/ulimit.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/ulimit.test
rename to tests/thirdparty/Fuzzer/test/ulimit.test
diff --git a/test/thirdparty/Fuzzer/test/uninstrumented/CMakeLists.txt b/tests/thirdparty/Fuzzer/test/uninstrumented/CMakeLists.txt
similarity index 100%
rename from test/thirdparty/Fuzzer/test/uninstrumented/CMakeLists.txt
rename to tests/thirdparty/Fuzzer/test/uninstrumented/CMakeLists.txt
diff --git a/test/thirdparty/Fuzzer/test/unit/lit.cfg b/tests/thirdparty/Fuzzer/test/unit/lit.cfg
similarity index 100%
rename from test/thirdparty/Fuzzer/test/unit/lit.cfg
rename to tests/thirdparty/Fuzzer/test/unit/lit.cfg
diff --git a/test/thirdparty/Fuzzer/test/unit/lit.site.cfg.in b/tests/thirdparty/Fuzzer/test/unit/lit.site.cfg.in
similarity index 100%
rename from test/thirdparty/Fuzzer/test/unit/lit.site.cfg.in
rename to tests/thirdparty/Fuzzer/test/unit/lit.site.cfg.in
diff --git a/test/thirdparty/Fuzzer/test/value-profile-cmp.test b/tests/thirdparty/Fuzzer/test/value-profile-cmp.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/value-profile-cmp.test
rename to tests/thirdparty/Fuzzer/test/value-profile-cmp.test
diff --git a/test/thirdparty/Fuzzer/test/value-profile-cmp2.test b/tests/thirdparty/Fuzzer/test/value-profile-cmp2.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/value-profile-cmp2.test
rename to tests/thirdparty/Fuzzer/test/value-profile-cmp2.test
diff --git a/test/thirdparty/Fuzzer/test/value-profile-cmp3.test b/tests/thirdparty/Fuzzer/test/value-profile-cmp3.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/value-profile-cmp3.test
rename to tests/thirdparty/Fuzzer/test/value-profile-cmp3.test
diff --git a/test/thirdparty/Fuzzer/test/value-profile-cmp4.test b/tests/thirdparty/Fuzzer/test/value-profile-cmp4.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/value-profile-cmp4.test
rename to tests/thirdparty/Fuzzer/test/value-profile-cmp4.test
diff --git a/test/thirdparty/Fuzzer/test/value-profile-div.test b/tests/thirdparty/Fuzzer/test/value-profile-div.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/value-profile-div.test
rename to tests/thirdparty/Fuzzer/test/value-profile-div.test
diff --git a/test/thirdparty/Fuzzer/test/value-profile-load.test b/tests/thirdparty/Fuzzer/test/value-profile-load.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/value-profile-load.test
rename to tests/thirdparty/Fuzzer/test/value-profile-load.test
diff --git a/test/thirdparty/Fuzzer/test/value-profile-mem.test b/tests/thirdparty/Fuzzer/test/value-profile-mem.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/value-profile-mem.test
rename to tests/thirdparty/Fuzzer/test/value-profile-mem.test
diff --git a/test/thirdparty/Fuzzer/test/value-profile-set.test b/tests/thirdparty/Fuzzer/test/value-profile-set.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/value-profile-set.test
rename to tests/thirdparty/Fuzzer/test/value-profile-set.test
diff --git a/test/thirdparty/Fuzzer/test/value-profile-strcmp.test b/tests/thirdparty/Fuzzer/test/value-profile-strcmp.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/value-profile-strcmp.test
rename to tests/thirdparty/Fuzzer/test/value-profile-strcmp.test
diff --git a/test/thirdparty/Fuzzer/test/value-profile-strncmp.test b/tests/thirdparty/Fuzzer/test/value-profile-strncmp.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/value-profile-strncmp.test
rename to tests/thirdparty/Fuzzer/test/value-profile-strncmp.test
diff --git a/test/thirdparty/Fuzzer/test/value-profile-switch.test b/tests/thirdparty/Fuzzer/test/value-profile-switch.test
similarity index 100%
rename from test/thirdparty/Fuzzer/test/value-profile-switch.test
rename to tests/thirdparty/Fuzzer/test/value-profile-switch.test
diff --git a/test/thirdparty/doctest/LICENSE.txt b/tests/thirdparty/doctest/LICENSE.txt
similarity index 100%
rename from test/thirdparty/doctest/LICENSE.txt
rename to tests/thirdparty/doctest/LICENSE.txt
diff --git a/test/thirdparty/doctest/doctest.h b/tests/thirdparty/doctest/doctest.h
similarity index 100%
rename from test/thirdparty/doctest/doctest.h
rename to tests/thirdparty/doctest/doctest.h
diff --git a/test/thirdparty/doctest/doctest_compatibility.h b/tests/thirdparty/doctest/doctest_compatibility.h
similarity index 100%
rename from test/thirdparty/doctest/doctest_compatibility.h
rename to tests/thirdparty/doctest/doctest_compatibility.h
diff --git a/test/thirdparty/fifo_map/LICENSE.MIT b/tests/thirdparty/fifo_map/LICENSE.MIT
similarity index 100%
rename from test/thirdparty/fifo_map/LICENSE.MIT
rename to tests/thirdparty/fifo_map/LICENSE.MIT
diff --git a/test/thirdparty/fifo_map/fifo_map.hpp b/tests/thirdparty/fifo_map/fifo_map.hpp
similarity index 100%
rename from test/thirdparty/fifo_map/fifo_map.hpp
rename to tests/thirdparty/fifo_map/fifo_map.hpp
diff --git a/test/thirdparty/imapdl/filterbr.py b/tests/thirdparty/imapdl/filterbr.py
similarity index 100%
rename from test/thirdparty/imapdl/filterbr.py
rename to tests/thirdparty/imapdl/filterbr.py
diff --git a/test/thirdparty/imapdl/gpl-3.0.txt b/tests/thirdparty/imapdl/gpl-3.0.txt
similarity index 100%
rename from test/thirdparty/imapdl/gpl-3.0.txt
rename to tests/thirdparty/imapdl/gpl-3.0.txt
diff --git a/third_party/amalgamate/CHANGES.md b/tools/amalgamate/CHANGES.md
similarity index 100%
rename from third_party/amalgamate/CHANGES.md
rename to tools/amalgamate/CHANGES.md
diff --git a/third_party/amalgamate/LICENSE.md b/tools/amalgamate/LICENSE.md
similarity index 100%
rename from third_party/amalgamate/LICENSE.md
rename to tools/amalgamate/LICENSE.md
diff --git a/third_party/amalgamate/README.md b/tools/amalgamate/README.md
similarity index 100%
rename from third_party/amalgamate/README.md
rename to tools/amalgamate/README.md
diff --git a/third_party/amalgamate/amalgamate.py b/tools/amalgamate/amalgamate.py
similarity index 100%
rename from third_party/amalgamate/amalgamate.py
rename to tools/amalgamate/amalgamate.py
diff --git a/third_party/amalgamate/config.json b/tools/amalgamate/config.json
similarity index 100%
rename from third_party/amalgamate/config.json
rename to tools/amalgamate/config.json
diff --git a/third_party/cpplint/LICENSE b/tools/cpplint/LICENSE
similarity index 100%
rename from third_party/cpplint/LICENSE
rename to tools/cpplint/LICENSE
diff --git a/third_party/cpplint/README.rst b/tools/cpplint/README.rst
similarity index 100%
rename from third_party/cpplint/README.rst
rename to tools/cpplint/README.rst
diff --git a/third_party/cpplint/cpplint.py b/tools/cpplint/cpplint.py
similarity index 100%
rename from third_party/cpplint/cpplint.py
rename to tools/cpplint/cpplint.py
diff --git a/third_party/cpplint/update.sh b/tools/cpplint/update.sh
similarity index 100%
rename from third_party/cpplint/update.sh
rename to tools/cpplint/update.sh
diff --git a/third_party/gdb_pretty_printer/README.md b/tools/gdb_pretty_printer/README.md
similarity index 100%
rename from third_party/gdb_pretty_printer/README.md
rename to tools/gdb_pretty_printer/README.md
diff --git a/third_party/gdb_pretty_printer/nlohmann-json.py b/tools/gdb_pretty_printer/nlohmann-json.py
similarity index 100%
rename from third_party/gdb_pretty_printer/nlohmann-json.py
rename to tools/gdb_pretty_printer/nlohmann-json.py
diff --git a/third_party/macro_builder/main.cpp b/tools/macro_builder/main.cpp
similarity index 100%
rename from third_party/macro_builder/main.cpp
rename to tools/macro_builder/main.cpp

From 0c698b75ccb81c2218e0b0b3ae8e9e60ba97c6bb Mon Sep 17 00:00:00 2001
From: Florian Albrechtskirchinger <falbrechtskirchinger@gmail.com>
Date: Sun, 1 May 2022 13:52:52 +0200
Subject: [PATCH 07/30] Add serve_header.py for rapid testing on Compiler
 Explorer (#3456)

---
 .gitignore                                  |  14 +-
 Makefile                                    |   7 +
 tools/serve_header/README.md                |  91 +++++
 tools/serve_header/demo.png                 | Bin 0 -> 557446 bytes
 tools/serve_header/requirements.txt         |   2 +
 tools/serve_header/serve_header.py          | 410 ++++++++++++++++++++
 tools/serve_header/serve_header.yml.example |  15 +
 7 files changed, 538 insertions(+), 1 deletion(-)
 create mode 100644 tools/serve_header/README.md
 create mode 100644 tools/serve_header/demo.png
 create mode 100644 tools/serve_header/requirements.txt
 create mode 100755 tools/serve_header/serve_header.py
 create mode 100644 tools/serve_header/serve_header.yml.example

diff --git a/.gitignore b/.gitignore
index acd44d8d8..db6dcecb4 100644
--- a/.gitignore
+++ b/.gitignore
@@ -10,7 +10,14 @@
 /.idea
 /cmake-build-*
 
-/.vs
+/.vs/
+/.vscode/
+
+# clangd cache
+/.cache/
+
+# build directories (vscode-cmake-tools, user-defined, ...)
+/build*/
 
 /docs/mkdocs/docs/examples/
 /docs/mkdocs/docs/__pycache__/
@@ -19,3 +26,8 @@
 /docs/docset/JSON_for_Modern_C++.docset/
 /docs/docset/JSON_for_Modern_C++.tgz
 /docs/mkdocs/docs/images/json.gif
+
+# serve_header
+/serve_header.yml
+/localhost.pem
+/localhost-key.pem
diff --git a/Makefile b/Makefile
index 28de14dce..ce26524ad 100644
--- a/Makefile
+++ b/Makefile
@@ -251,3 +251,10 @@ update_hedley:
 	$(SED) -i '1s/^/#pragma once\n\n/' include/nlohmann/thirdparty/hedley/hedley.hpp
 	$(SED) -i '1s/^/#pragma once\n\n/' include/nlohmann/thirdparty/hedley/hedley_undef.hpp
 	$(MAKE) amalgamate
+
+##########################################################################
+# serve_header.py
+##########################################################################
+
+serve_header:
+	./tools/serve_header/serve_header.py --make $(MAKE)
diff --git a/tools/serve_header/README.md b/tools/serve_header/README.md
new file mode 100644
index 000000000..a95ef20e2
--- /dev/null
+++ b/tools/serve_header/README.md
@@ -0,0 +1,91 @@
+serve_header.py
+===============
+
+Serves the `single_include/nlohmann/json.hpp` header file over HTTP(S).
+
+The header file is automatically amalgamated on demand.
+
+![serve_header.py demo](demo.png)
+
+## Prerequisites
+
+1. Make sure these Python packages are installed.
+    ```
+    PyYAML
+    watchdog
+    ```
+    (see `tools/serve_header/requirements.txt`)
+
+2. To serve the header over HTTPS (which is required by Compiler Explorer at this time), a certificate is needed.
+   The recommended method for creating a locally-trusted certificate is to use [`mkcert`](https://github.com/FiloSottile/mkcert).
+   - Install the `mkcert` certificate authority into your trust store(s):
+     ```
+     $ mkcert -install
+     ```
+   - Create a certificate for `localhost`:
+     ```
+     $ mkcert localhost
+     ```
+     The command will create two files, `localhost.pem` and `localhost-key.pem`, in the current working directory. It is recommended to create them in the top level or project root directory.
+
+## Usage
+
+`serve_header.py` has a built-in default configuration that will serve the `single_include/nlohmann/json.hpp` header file relative to the top level or project root directory it is homed in.
+The built-in configuration expects the certificate `localhost.pem` and the private key `localhost-key.pem`to be located in the top level or project root directory.
+
+To start serving the `json.hpp` header file at `https://localhost:8443/json.hpp`, run this command from the top level or project root directory:
+```
+$ make serve_header
+```
+
+Open [Compiler Explorer](https://godbolt.org/) and try it out:
+```cpp
+#include <https://localhost:8443/json.hpp>
+using namespace nlohmann;
+
+#include <iostream>
+
+int main() {
+    // these macros are dynamically injected into the header file
+    std::cout << JSON_BUILD_TIME << " (" << JSON_BUILD_COUNT << ")\n";
+
+    return 0;
+}
+```
+
+> `serve_header.py` dynamically injects the macros `JSON_BUILD_COUNT` and `JSON_BUILD_TIME` into the served header file. By comparing build count or time output from the compiled program with the output from `serve_header.py`, one can be reasonably sure the compiled code uses the expected revision of the header file.
+
+## Configuration
+
+`serve_header.py` will try to read a configuration file `serve_header.yml` in the top level or project root directory, and will fall back on built-in defaults if the file cannot be read.
+An annotated example configuration can be found in `tools/serve_header/serve_header.yml.example`.
+
+## Serving `json.hpp` from multiple project directory instances or working trees
+
+`serve_header.py` was designed with the goal of supporting multiple project roots or working trees at the same time.
+The recommended directory structure is shown below but `serve_header.py` can work with other structures as well, including a nested hierarchy.
+```
+json/          ⮜ the parent or web server root directoy
+├── develop/   ⮜ the main git checkout
+│   └── ...
+├── feature1/
+│   └── ...      any number of additional
+├── feature2/  ⮜ working trees (e.g., created
+│   └── ...      with git worktree)
+└── feature3/
+    └── ...
+```
+
+To serve the header of each working tree at `https://localhost:8443/<worktree>/json.hpp`, a configuration file is needed.
+1. Create the file `serve_header.yml` in the top level or project root directory of any working tree:
+    ```yaml
+    root: ..
+    ```
+   By shifting the web server root directory up one level, the `single_include/nlohmann/json.hpp` header files relative to each sibling directory or working tree will be served.
+
+2. Start `serve_header.py` by running this command from the same top level or project root directory the configuration file is located in:
+    ```
+    $ make serve_header
+    ```
+
+`serve_header.py` will automatically detect the addition or removal of working trees anywhere within the configured web server root directory.
diff --git a/tools/serve_header/demo.png b/tools/serve_header/demo.png
new file mode 100644
index 0000000000000000000000000000000000000000..b777516087d820cf8bd22e7a9b98ec9c481fc401
GIT binary patch
literal 557446
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%0Dw9p+Z@y#xAwB@L_bQZbsFE<(m#MmzqHz1
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

literal 0
HcmV?d00001

diff --git a/tools/serve_header/requirements.txt b/tools/serve_header/requirements.txt
new file mode 100644
index 000000000..d32eed3bd
--- /dev/null
+++ b/tools/serve_header/requirements.txt
@@ -0,0 +1,2 @@
+PyYAML==6.0
+watchdog==2.1.7
diff --git a/tools/serve_header/serve_header.py b/tools/serve_header/serve_header.py
new file mode 100755
index 000000000..666fa57c3
--- /dev/null
+++ b/tools/serve_header/serve_header.py
@@ -0,0 +1,410 @@
+#!/usr/bin/env python3
+
+import contextlib
+import logging
+import os
+import re
+import shutil
+import sys
+import subprocess
+
+from datetime import datetime, timedelta
+from io import BytesIO
+from threading import Lock, Timer
+
+from watchdog.events import FileSystemEventHandler
+from watchdog.observers import Observer
+
+from http import HTTPStatus
+from http.server import ThreadingHTTPServer, SimpleHTTPRequestHandler
+
+CONFIG_FILE = 'serve_header.yml'
+MAKEFILE = 'Makefile'
+INCLUDE = 'include/nlohmann/'
+SINGLE_INCLUDE = 'single_include/nlohmann/'
+HEADER = 'json.hpp'
+
+DATETIME_FORMAT = '%Y-%m-%d %H:%M:%S'
+
+JSON_VERSION_RE = re.compile(r'\s*#\s*define\s+NLOHMANN_JSON_VERSION_MAJOR\s+')
+
+class ExitHandler(logging.StreamHandler):
+    def __init__(self, level):
+        """."""
+        super().__init__()
+        self.level = level
+
+    def emit(self, record):
+        if record.levelno >= self.level:
+            sys.exit(1)
+
+def is_project_root(test_dir='.'):
+    makefile = os.path.join(test_dir, MAKEFILE)
+    include = os.path.join(test_dir, INCLUDE)
+    single_include = os.path.join(test_dir, SINGLE_INCLUDE)
+
+    return (os.path.exists(makefile)
+            and os.path.isfile(makefile)
+            and os.path.exists(include)
+            and os.path.exists(single_include))
+
+class DirectoryEventBucket:
+    def __init__(self, callback, delay=1.2, threshold=0.8):
+        """."""
+        self.delay = delay
+        self.threshold = timedelta(seconds=threshold)
+        self.callback = callback
+        self.event_dirs = set([])
+        self.timer = None
+        self.lock = Lock()
+
+    def start_timer(self):
+        if self.timer is None:
+            self.timer = Timer(self.delay, self.process_dirs)
+            self.timer.start()
+
+    def process_dirs(self):
+        result_dirs = []
+        event_dirs = set([])
+        with self.lock:
+            self.timer = None
+            while self.event_dirs:
+                time, event_dir = self.event_dirs.pop()
+                delta = datetime.now() - time
+                if delta < self.threshold:
+                    event_dirs.add((time, event_dir))
+                else:
+                    result_dirs.append(event_dir)
+            self.event_dirs = event_dirs
+            if result_dirs:
+                self.callback(os.path.commonpath(result_dirs))
+            if self.event_dirs:
+                self.start_timer()
+
+    def add_dir(self, path):
+        with self.lock:
+            # add path to the set of event_dirs if it is not a sibling of
+            # a directory already in the set
+            if not any(os.path.commonpath([path, event_dir]) == event_dir
+               for (_, event_dir) in self.event_dirs):
+                self.event_dirs.add((datetime.now(), path))
+                if self.timer is None:
+                    self.start_timer()
+
+class WorkTree:
+    make_command = 'make'
+
+    def __init__(self, root_dir, tree_dir):
+        """."""
+        self.root_dir = root_dir
+        self.tree_dir = tree_dir
+        self.rel_dir = os.path.relpath(tree_dir, root_dir)
+        self.name = os.path.basename(tree_dir)
+        self.include_dir = os.path.abspath(os.path.join(tree_dir, INCLUDE))
+        self.header = os.path.abspath(os.path.join(tree_dir, SINGLE_INCLUDE, HEADER))
+        self.rel_header = os.path.relpath(self.header, root_dir)
+        self.dirty = True
+        self.build_count = 0
+        t = os.path.getmtime(self.header)
+        t = datetime.fromtimestamp(t)
+        self.build_time = t.strftime(DATETIME_FORMAT)
+
+    def __hash__(self):
+        """."""
+        return hash((self.tree_dir))
+
+    def __eq__(self, other):
+        """."""
+        if not isinstance(other, type(self)):
+            return NotImplemented
+        return self.tree_dir == other.tree_dir
+
+    def update_dirty(self, path):
+        if self.dirty:
+            return
+
+        path = os.path.abspath(path)
+        if os.path.commonpath([path, self.include_dir]) == self.include_dir:
+            logging.info(f'{self.name}: working tree marked dirty')
+            self.dirty = True
+
+    def amalgamate_header(self):
+        if not self.dirty:
+            return
+
+        mtime = os.path.getmtime(self.header)
+        subprocess.run([WorkTree.make_command, 'amalgamate'], cwd=self.tree_dir,
+                       stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+        if mtime == os.path.getmtime(self.header):
+            logging.info(f'{self.name}: no changes')
+        else:
+            self.build_count += 1
+            self.build_time = datetime.now().strftime(DATETIME_FORMAT)
+            logging.info(f'{self.name}: header amalgamated (build count {self.build_count})')
+
+        self.dirty = False
+
+class WorkTrees(FileSystemEventHandler):
+    def __init__(self, root_dir):
+        """."""
+        super().__init__()
+        self.root_dir = root_dir
+        self.trees = set([])
+        self.tree_lock = Lock()
+        self.scan(root_dir)
+        self.created_bucket = DirectoryEventBucket(self.scan)
+        self.observer = Observer()
+        self.observer.schedule(self, root_dir, recursive=True)
+        self.observer.start()
+
+    def scan(self, base_dir):
+        scan_dirs = set([base_dir])
+        # recursively scan base_dir for working trees
+
+        while scan_dirs:
+            scan_dir = os.path.abspath(scan_dirs.pop())
+            self.scan_tree(scan_dir)
+            try:
+                with os.scandir(scan_dir) as dir_it:
+                    for entry in dir_it:
+                        if entry.is_dir():
+                            scan_dirs.add(entry.path)
+            except FileNotFoundError as e:
+                logging.debug('path disappeared: %s', e)
+
+    def scan_tree(self, scan_dir):
+        if not is_project_root(scan_dir):
+            return
+
+        # skip source trees in build directories
+        # this check could be enhanced
+        if scan_dir.endswith('/_deps/json-src'):
+            return
+
+        tree = WorkTree(self.root_dir, scan_dir)
+        with self.tree_lock:
+            if not tree in self.trees:
+                if tree.name == tree.rel_dir:
+                    logging.info(f'adding working tree {tree.name}')
+                else:
+                    logging.info(f'adding working tree {tree.name} at {tree.rel_dir}')
+                url = os.path.join('/', tree.rel_dir, HEADER)
+                logging.info(f'{tree.name}: serving header at {url}')
+                self.trees.add(tree)
+
+    def rescan(self, path=None):
+        if path is not None:
+            path = os.path.abspath(path)
+        trees = set([])
+        # check if any working trees have been removed
+        with self.tree_lock:
+            while self.trees:
+                tree = self.trees.pop()
+                if ((path is None
+                    or os.path.commonpath([path, tree.tree_dir]) == tree.tree_dir)
+                    and not is_project_root(tree.tree_dir)):
+                    if tree.name == tree.rel_dir:
+                        logging.info(f'removing working tree {tree.name}')
+                    else:
+                        logging.info(f'removing working tree {tree.name} at {tree.rel_dir}')
+                else:
+                    trees.add(tree)
+            self.trees = trees
+
+    def find(self, path):
+        # find working tree for a given header file path
+        path = os.path.abspath(path)
+        with self.tree_lock:
+            for tree in self.trees:
+                if path == tree.header:
+                    return tree
+        return None
+
+    def on_any_event(self, event):
+        logging.debug('%s (is_dir=%s): %s', event.event_type,
+                      event.is_directory, event.src_path)
+        path = os.path.abspath(event.src_path)
+        if event.is_directory:
+            if event.event_type == 'created':
+                # check for new working trees
+                self.created_bucket.add_dir(path)
+            elif event.event_type == 'deleted':
+                # check for deleted working trees
+                self.rescan(path)
+        elif event.event_type == 'closed':
+            with self.tree_lock:
+                for tree in self.trees:
+                    tree.update_dirty(path)
+
+    def stop(self):
+        self.observer.stop()
+        self.observer.join()
+
+class HeaderRequestHandler(SimpleHTTPRequestHandler):
+    def __init__(self, request, client_address, server):
+        """."""
+        self.worktrees = server.worktrees
+        self.worktree = None
+        try:
+            super().__init__(request, client_address, server,
+                             directory=server.worktrees.root_dir)
+        except ConnectionResetError:
+            logging.debug('connection reset by peer')
+
+    def translate_path(self, path):
+        path = os.path.abspath(super().translate_path(path))
+
+        # add single_include/nlohmann into path, if needed
+        header = os.path.join('/', HEADER)
+        header_path = os.path.join('/', SINGLE_INCLUDE, HEADER)
+        if (path.endswith(header)
+            and not path.endswith(header_path)):
+            path = os.path.join(os.path.dirname(path), SINGLE_INCLUDE, HEADER)
+
+        return path
+
+    def send_head(self):
+        # check if the translated path matches a working tree
+        # and fullfill the request; otherwise, send 404
+        path = self.translate_path(self.path)
+        self.worktree = self.worktrees.find(path)
+        if self.worktree is not None:
+            self.worktree.amalgamate_header()
+            logging.info(f'{self.worktree.name}; serving header (build count {self.worktree.build_count})')
+            return super().send_head()
+        logging.info(f'invalid request path: {self.path}')
+        super().send_error(HTTPStatus.NOT_FOUND, 'Not Found')
+        return None
+
+    def send_header(self, keyword, value):
+        # intercept Content-Length header; sent in copyfile later
+        if keyword == 'Content-Length':
+            return
+        super().send_header(keyword, value)
+
+    def end_headers (self):
+        # intercept; called in copyfile() or indirectly
+        # by send_head via super().send_error()
+        pass
+
+    def copyfile(self, source, outputfile):
+        injected = False
+        content = BytesIO()
+        length = 0
+        # inject build count and time into served header
+        for line in source:
+            line = line.decode('utf-8')
+            if not injected and JSON_VERSION_RE.match(line):
+                length += content.write(bytes('#define JSON_BUILD_COUNT '\
+                                              f'{self.worktree.build_count}\n', 'utf-8'))
+                length += content.write(bytes('#define JSON_BUILD_TIME '\
+                                              f'"{self.worktree.build_time}"\n\n', 'utf-8'))
+                injected = True
+            length += content.write(bytes(line, 'utf-8'))
+
+        # set content length
+        super().send_header('Content-Length', length)
+        # CORS header
+        self.send_header('Access-Control-Allow-Origin', '*')
+        # prevent caching
+        self.send_header('Cache-Control', 'no-cache, no-store, must-revalidate')
+        self.send_header('Pragma', 'no-cache')
+        self.send_header('Expires', '0')
+        super().end_headers()
+
+        # send the header
+        content.seek(0)
+        shutil.copyfileobj(content, outputfile)
+
+    def log_message(self, format, *args):
+        pass
+
+class DualStackServer(ThreadingHTTPServer):
+    def __init__(self, addr, worktrees):
+        """."""
+        self.worktrees = worktrees
+        super().__init__(addr, HeaderRequestHandler)
+
+    def server_bind(self):
+        # suppress exception when protocol is IPv4
+        with contextlib.suppress(Exception):
+            self.socket.setsockopt(
+                socket.IPPROTO_IPV6, socket.IPV6_V6ONLY, 0)
+        return super().server_bind()
+
+if __name__ == '__main__':
+    import argparse
+    import ssl
+    import socket
+    import yaml
+
+    # exit code
+    ec = 0
+
+    # setup logging
+    logging.basicConfig(format='[%(asctime)s] %(levelname)s: %(message)s',
+                        datefmt=DATETIME_FORMAT, level=logging.INFO)
+    log = logging.getLogger()
+    log.addHandler(ExitHandler(logging.ERROR))
+
+    # parse command line arguments
+    parser = argparse.ArgumentParser()
+    parser.add_argument('--make', default='make',
+                        help='the make command (default: make)')
+    args = parser.parse_args()
+
+    # propagate the make command to use for amalgamating headers
+    WorkTree.make_command = args.make
+
+    worktrees = None
+    try:
+        # change working directory to project root
+        os.chdir(os.path.realpath(os.path.join(sys.path[0], '../../')))
+
+        if not is_project_root():
+            log.error('working directory does not look like project root')
+
+        # load config
+        config = {}
+        config_file = os.path.abspath(CONFIG_FILE)
+        try:
+            with open(config_file, 'r') as f:
+                config = yaml.safe_load(f)
+        except FileNotFoundError:
+            log.info(f'cannot find configuration file: {config_file}')
+            log.info('using default configuration')
+
+        # find and monitor working trees
+        worktrees = WorkTrees(config.get('root', '.'))
+
+        # start web server
+        infos = socket.getaddrinfo(config.get('bind', None), config.get('port', 8443),
+                                   type=socket.SOCK_STREAM, flags=socket.AI_PASSIVE)
+        DualStackServer.address_family = infos[0][0]
+        HeaderRequestHandler.protocol_version = 'HTTP/1.0'
+        with DualStackServer(infos[0][4], worktrees) as httpd:
+            scheme = 'HTTP'
+            https = config.get('https', {})
+            if https.get('enabled', True):
+                cert_file = https.get('cert_file', 'localhost.pem')
+                key_file = https.get('key_file', 'localhost-key.pem')
+                ssl.minimum_version = ssl.TLSVersion.TLSv1_3
+                ssl.maximum_version = ssl.TLSVersion.MAXIMUM_SUPPORTED
+                httpd.socket = ssl.wrap_socket(httpd.socket,
+                    certfile=cert_file, keyfile=key_file,
+                    server_side=True, ssl_version=ssl.PROTOCOL_TLS)
+                scheme = 'HTTPS'
+            host, port = httpd.socket.getsockname()[:2]
+            log.info(f'serving {scheme} on {host} port {port}')
+            log.info('press Ctrl+C to exit')
+            httpd.serve_forever()
+
+    except KeyboardInterrupt:
+        log.info('exiting')
+    except Exception:
+        log.exception('an error occurred:')
+        ec = 1
+    finally:
+        if worktrees is not None:
+            worktrees.stop()
+            sys.exit(ec)
diff --git a/tools/serve_header/serve_header.yml.example b/tools/serve_header/serve_header.yml.example
new file mode 100644
index 000000000..42310910e
--- /dev/null
+++ b/tools/serve_header/serve_header.yml.example
@@ -0,0 +1,15 @@
+# all paths are relative to the project root
+
+# the root directory for the web server
+# root: .
+
+# configure SSL
+# https:
+#   enabled: true
+# these filenames are listed in .gitignore
+#  cert_file: localhost.pem
+#  key_file: localhost-key.pem
+
+# address and port for the server to listen on
+# bind: null
+# port: 8443

From bdc21ad1a713f08241003daf77f40450a5bcfa1b Mon Sep 17 00:00:00 2001
From: Florian Albrechtskirchinger <falbrechtskirchinger@gmail.com>
Date: Sun, 1 May 2022 22:46:45 +0200
Subject: [PATCH 08/30] Add build step for ICPC (with fixes) (#3465)

* :arrow_up: Doctest 2.4.7

* :construction_worker: add CI step for ICPC

* :construction_worker: add CI step for ICPC

* :construction_worker: add CI step for ICPC

* :arrow_down: downgrade to Doctest 2.4.6

* :construction_worker: add CI step for ICPC

* :construction_worker: add CI step for ICPC

* :construction_worker: add CI step for ICPC

* :construction_worker: add CI step for ICPC

* :construction_worker: add CI step for ICPC

* :mute: suppress warning #2196: routine is both "inline" and "noinline"

* Re-enable <filesystem> detection on ICPC

* Limit regression test for #3070 to Clang and GCC >=8.4

* Disable deprecation warnings on ICPC

* Disable regression test for #1647 on ICPC (C++20)

* Fix compilation failure of regression test for #3077 on ICPC

* Disable wstring unit test on ICPC

Fixes:
  error 913: invalid multibyte character sequence

* Add ICPC to README

Co-authored-by: Niels Lohmann <mail@nlohmann.me>
---
 .github/workflows/ubuntu.yml                 | 12 ++++++++++
 README.md                                    | 25 ++++++++++----------
 cmake/ci.cmake                               | 15 ++++++++++++
 include/nlohmann/detail/meta/type_traits.hpp |  9 ++++++-
 single_include/nlohmann/json.hpp             |  9 ++++++-
 tests/CMakeLists.txt                         |  4 ++++
 tests/src/unit-regression2.cpp               |  7 ++++--
 tests/src/unit-wstring.cpp                   |  3 +++
 8 files changed, 68 insertions(+), 16 deletions(-)

diff --git a/.github/workflows/ubuntu.yml b/.github/workflows/ubuntu.yml
index b5f583367..4d037e060 100644
--- a/.github/workflows/ubuntu.yml
+++ b/.github/workflows/ubuntu.yml
@@ -112,3 +112,15 @@ jobs:
         run: cmake -S . -B build -DJSON_CI=On
       - name: build
         run: cmake --build build --target ci_cuda_example
+
+  ci_icpc:
+    runs-on: ubuntu-latest
+    container: ghcr.io/nlohmann/json-ci:v2.2.0
+    steps:
+      - uses: actions/checkout@v2
+      - name: cmake
+        run: cmake -S . -B build -DJSON_CI=On
+      - name: build
+        run: |
+          . /opt/intel/oneapi/setvars.sh
+          cmake --build build --target ci_icpc
diff --git a/README.md b/README.md
index a46a8569c..3f61377ba 100644
--- a/README.md
+++ b/README.md
@@ -1083,18 +1083,6 @@ The following compilers are currently used in continuous integration at [AppVeyo
 | Apple Clang 12.0.0 (clang-1200.0.32.27); Xcode 12.2                                                    | macOS 10.15.7      | GitHub Actions |
 | Apple Clang 12.0.0 (clang-1200.0.32.28); Xcode 12.3                                                    | macOS 10.15.7      | GitHub Actions |
 | Apple Clang 12.0.0 (clang-1200.0.32.29); Xcode 12.4                                                    | macOS 10.15.7      | GitHub Actions |
-| GCC 4.8.5 (Ubuntu 4.8.5-4ubuntu2)                                                                      | Ubuntu 20.04.3 LTS | GitHub Actions |
-| GCC 4.9.3 (Ubuntu 4.9.3-13ubuntu2)                                                                     | Ubuntu 20.04.3 LTS | GitHub Actions |
-| GCC 5.4.0 (Ubuntu 5.4.0-6ubuntu1~16.04.12)                                                             | Ubuntu 20.04.3 LTS | GitHub Actions |
-| GCC 6.4.0 (Ubuntu 6.4.0-17ubuntu1)                                                                     | Ubuntu 20.04.3 LTS | GitHub Actions |
-| GCC 7.5.0 (Ubuntu 7.5.0-6ubuntu2)                                                                      | Ubuntu 20.04.3 LTS | GitHub Actions |
-| GCC 8.1.0 (x86_64-posix-seh-rev0, Built by MinGW-W64 project)                                          | Windows-10.0.17763 | GitHub Actions |
-| GCC 8.1.0 (i686-posix-dwarf-rev0, Built by MinGW-W64 project)                                          | Windows-10.0.17763 | GitHub Actions |
-| GCC 8.4.0 (Ubuntu 8.4.0-3ubuntu2)                                                                      | Ubuntu 20.04.3 LTS | GitHub Actions |
-| GCC 9.3.0 (Ubuntu 9.3.0-17ubuntu1~20.04)                                                               | Ubuntu 20.04.3 LTS | GitHub Actions |
-| GCC 10.2.0 (Ubuntu 10.2.0-5ubuntu1~20.04)                                                              | Ubuntu 20.04.3 LTS | GitHub Actions |
-| GCC 11.1.0                                                                                             | Ubuntu (aarch64)   | Drone CI       |
-| GCC 12.0.0 20211219 (experimental)                                                                     | Ubuntu 20.04.3 LTS | GitHub Actions |
 | Clang 3.5.2 (3.5.2-3ubuntu1)                                                                           | Ubuntu 20.04.3 LTS | GitHub Actions |
 | Clang 3.6.2 (3.6.2-3ubuntu2)                                                                           | Ubuntu 20.04.3 LTS | GitHub Actions |
 | Clang 3.7.1 (3.7.1-2ubuntu2)                                                                           | Ubuntu 20.04.3 LTS | GitHub Actions |
@@ -1115,6 +1103,19 @@ The following compilers are currently used in continuous integration at [AppVeyo
 | Clang 13.0.1 (13.0.1-++20211015123032+cf15ccdeb6d5-1exp120211015003613.5)                              | Ubuntu 20.04.3 LTS | GitHub Actions |
 | Clang 14.0.0 (14.0.0-++20211221052852+55c71c9eac9b-1exp120211221172954.95)                             | Ubuntu 20.04.3 LTS | GitHub Actions |
 | Clang 15.0.0 (15.0.0-++20220403052648+896770c9a92e-1~exp1~20220403172744.209)                          | Ubuntu 20.04.3 LTS | GitHub Actions |
+| GCC 4.8.5 (Ubuntu 4.8.5-4ubuntu2)                                                                      | Ubuntu 20.04.3 LTS | GitHub Actions |
+| GCC 4.9.3 (Ubuntu 4.9.3-13ubuntu2)                                                                     | Ubuntu 20.04.3 LTS | GitHub Actions |
+| GCC 5.4.0 (Ubuntu 5.4.0-6ubuntu1~16.04.12)                                                             | Ubuntu 20.04.3 LTS | GitHub Actions |
+| GCC 6.4.0 (Ubuntu 6.4.0-17ubuntu1)                                                                     | Ubuntu 20.04.3 LTS | GitHub Actions |
+| GCC 7.5.0 (Ubuntu 7.5.0-6ubuntu2)                                                                      | Ubuntu 20.04.3 LTS | GitHub Actions |
+| GCC 8.1.0 (i686-posix-dwarf-rev0, Built by MinGW-W64 project)                                          | Windows-10.0.17763 | GitHub Actions |
+| GCC 8.1.0 (x86_64-posix-seh-rev0, Built by MinGW-W64 project)                                          | Windows-10.0.17763 | GitHub Actions |
+| GCC 8.4.0 (Ubuntu 8.4.0-3ubuntu2)                                                                      | Ubuntu 20.04.3 LTS | GitHub Actions |
+| GCC 9.3.0 (Ubuntu 9.3.0-17ubuntu1~20.04)                                                               | Ubuntu 20.04.3 LTS | GitHub Actions |
+| GCC 10.2.0 (Ubuntu 10.2.0-5ubuntu1~20.04)                                                              | Ubuntu 20.04.3 LTS | GitHub Actions |
+| GCC 11.1.0                                                                                             | Ubuntu (aarch64)   | Drone CI       |
+| GCC 12.0.0 20211219 (experimental)                                                                     | Ubuntu 20.04.3 LTS | GitHub Actions |
+| Intel C++ Compiler 2021.5.0.20211109                                                                   | Ubuntu 20.04.3 LTS | GitHub Actions |
 | NVCC 11.0.221                                                                                          | Ubuntu 20.04.3 LTS | GitHub Actions |
 | Visual Studio 14 2015 MSVC 19.0.24241.7 (Build Engine version 14.0.25420.1)                            | Windows-6.3.9600   | AppVeyor       |
 | Visual Studio 15 2017 MSVC 19.16.27035.0 (Build Engine version 15.9.21+g9802d43bc3 for .NET Framework) | Windows-10.0.14393 | AppVeyor       |
diff --git a/cmake/ci.cmake b/cmake/ci.cmake
index b2a2f470f..56a80c066 100644
--- a/cmake/ci.cmake
+++ b/cmake/ci.cmake
@@ -877,6 +877,21 @@ add_custom_target(ci_cuda_example
     COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_cuda_example
 )
 
+###############################################################################
+# Intel C++ Compiler
+###############################################################################
+
+add_custom_target(ci_icpc
+    COMMAND ${CMAKE_COMMAND}
+        -DCMAKE_BUILD_TYPE=Debug -GNinja
+        -DCMAKE_C_COMPILER=icc -DCMAKE_CXX_COMPILER=icpc
+        -DJSON_BuildTests=ON -DJSON_FastTests=ON
+        -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_icpc
+    COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_icpc
+    COMMAND cd ${PROJECT_BINARY_DIR}/build_icpc && ${CMAKE_CTEST_COMMAND} --parallel ${N} --exclude-regex "test-unicode" --output-on-failure
+    COMMENT "Compile and test with ICPC"
+)
+
 ###############################################################################
 # Clean up all generated files.
 ###############################################################################
diff --git a/include/nlohmann/detail/meta/type_traits.hpp b/include/nlohmann/detail/meta/type_traits.hpp
index 2cc13f3ac..5e3ea3737 100644
--- a/include/nlohmann/detail/meta/type_traits.hpp
+++ b/include/nlohmann/detail/meta/type_traits.hpp
@@ -347,8 +347,15 @@ struct is_compatible_string_type
 template<typename BasicJsonType, typename ConstructibleStringType>
 struct is_constructible_string_type
 {
+    // launder type through decltype() to fix compilation failure on ICPC
+#ifdef __INTEL_COMPILER
+    using laundered_type = decltype(std::declval<ConstructibleStringType>());
+#else
+    using laundered_type = ConstructibleStringType;
+#endif
+
     static constexpr auto value =
-        is_constructible<ConstructibleStringType,
+        is_constructible<laundered_type,
         typename BasicJsonType::string_t>::value;
 };
 
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index ad777c92c..949ac14be 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -3482,8 +3482,15 @@ struct is_compatible_string_type
 template<typename BasicJsonType, typename ConstructibleStringType>
 struct is_constructible_string_type
 {
+    // launder type through decltype() to fix compilation failure on ICPC
+#ifdef __INTEL_COMPILER
+    using laundered_type = decltype(std::declval<ConstructibleStringType>());
+#else
+    using laundered_type = ConstructibleStringType;
+#endif
+
     static constexpr auto value =
-        is_constructible<ConstructibleStringType,
+        is_constructible<laundered_type,
         typename BasicJsonType::string_t>::value;
 };
 
diff --git a/tests/CMakeLists.txt b/tests/CMakeLists.txt
index 1d5c78697..75bc6f980 100644
--- a/tests/CMakeLists.txt
+++ b/tests/CMakeLists.txt
@@ -49,8 +49,12 @@ target_compile_options(test_main PUBLIC
     # https://github.com/nlohmann/json/issues/1114
     $<$<CXX_COMPILER_ID:MSVC>:/bigobj> $<$<BOOL:${MINGW}>:-Wa,-mbig-obj>
 
+    # https://github.com/nlohmann/json/pull/3229
+    $<$<CXX_COMPILER_ID:Intel>:-diag-disable=2196>
+
     $<$<NOT:$<CXX_COMPILER_ID:MSVC>>:-Wno-deprecated;-Wno-float-equal>
     $<$<CXX_COMPILER_ID:GNU>:-Wno-deprecated-declarations>
+    $<$<CXX_COMPILER_ID:Intel>:-diag-disable=1786>
 )
 target_include_directories(test_main PUBLIC
     thirdparty/doctest
diff --git a/tests/src/unit-regression2.cpp b/tests/src/unit-regression2.cpp
index e034593ed..04cbac679 100644
--- a/tests/src/unit-regression2.cpp
+++ b/tests/src/unit-regression2.cpp
@@ -512,12 +512,15 @@ TEST_CASE("regression tests 2")
 
     SECTION("issue #1647 - compile error when deserializing enum if both non-default from_json and non-member operator== exists for other type")
     {
+        // does not compile on ICPC when targeting C++20
+#if !(defined(__INTEL_COMPILER) && __cplusplus >= 202000)
         {
             json j;
             NonDefaultFromJsonStruct x(j);
             NonDefaultFromJsonStruct y;
             CHECK(x == y);
         }
+#endif
 
         auto val = nlohmann::json("one").get<for_1647>();
         CHECK(val == for_1647::one);
@@ -793,8 +796,8 @@ TEST_CASE("regression tests 2")
         const auto j_path = j.get<nlohmann::detail::std_fs::path>();
         CHECK(j_path == text_path);
 
-#if !defined(_MSC_VER) && !(defined(__GNUC__) && __GNUC__ == 8 && __GNUC_MINOR__ < 4)
-        // works everywhere but on MSVC and GCC <8.4
+#if defined(__clang__) || ((defined(__GNUC__) && !defined(__INTEL_COMPILER)) && (__GNUC__ > 8 || (__GNUC__ == 8 && __GNUC_MINOR__ >= 4)))
+        // only known to work on Clang and GCC >=8.4
         CHECK_THROWS_WITH_AS(nlohmann::detail::std_fs::path(json(1)), "[json.exception.type_error.302] type must be string, but is number", json::type_error);
 #endif
     }
diff --git a/tests/src/unit-wstring.cpp b/tests/src/unit-wstring.cpp
index d15ac8491..fa655988c 100644
--- a/tests/src/unit-wstring.cpp
+++ b/tests/src/unit-wstring.cpp
@@ -32,6 +32,8 @@ SOFTWARE.
 #include <nlohmann/json.hpp>
 using nlohmann::json;
 
+// ICPC errors out on multibyte character sequences in source files
+#ifndef __INTEL_COMPILER
 namespace
 {
 bool wstring_is_utf16();
@@ -115,3 +117,4 @@ TEST_CASE("wide strings")
         }
     }
 }
+#endif

From b205361d8652759b6d850a37b227c8d57ee19005 Mon Sep 17 00:00:00 2001
From: Qianqian Fang <fangqq@gmail.com>
Date: Sun, 1 May 2022 16:47:06 -0400
Subject: [PATCH 09/30] Handle invalid BJData optimized type, fix #3461 (#3463)

* Handle invalid BJData optimized type, fix #3461

* Update unit test to handle bjdata optimized array type error
---
 .../nlohmann/detail/input/binary_reader.hpp   |  7 ++
 single_include/nlohmann/json.hpp              |  7 ++
 tests/src/unit-bjdata.cpp                     | 93 +++++++++++++------
 3 files changed, 77 insertions(+), 30 deletions(-)

diff --git a/include/nlohmann/detail/input/binary_reader.hpp b/include/nlohmann/detail/input/binary_reader.hpp
index 6474b8b05..75a20ed7b 100644
--- a/include/nlohmann/detail/input/binary_reader.hpp
+++ b/include/nlohmann/detail/input/binary_reader.hpp
@@ -2178,6 +2178,13 @@ class binary_reader
             std::vector<char_int_type> bjdx = {'[', '{', 'S', 'H', 'T', 'F', 'N', 'Z'}; // excluded markers in bjdata optimized type
 
             result.second = get();  // must not ignore 'N', because 'N' maybe the type
+            if (JSON_HEDLEY_UNLIKELY( input_format == input_format_t::bjdata && std::find(bjdx.begin(), bjdx.end(), result.second) != bjdx.end() ))
+            {
+                auto last_token = get_token_string();
+                return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+                                        exception_message(input_format, concat("marker 0x", last_token, " is not a permitted optimized array type"), "type"), nullptr));
+            }
+
             if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "type") || (input_format == input_format_t::bjdata && std::find(bjdx.begin(), bjdx.end(), result.second) != bjdx.end() )))
             {
                 return false;
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index 949ac14be..bbd84d2be 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -10652,6 +10652,13 @@ class binary_reader
             std::vector<char_int_type> bjdx = {'[', '{', 'S', 'H', 'T', 'F', 'N', 'Z'}; // excluded markers in bjdata optimized type
 
             result.second = get();  // must not ignore 'N', because 'N' maybe the type
+            if (JSON_HEDLEY_UNLIKELY( input_format == input_format_t::bjdata && std::find(bjdx.begin(), bjdx.end(), result.second) != bjdx.end() ))
+            {
+                auto last_token = get_token_string();
+                return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+                                        exception_message(input_format, concat("marker 0x", last_token, " is not a permitted optimized array type"), "type"), nullptr));
+            }
+
             if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "type") || (input_format == input_format_t::bjdata && std::find(bjdx.begin(), bjdx.end(), result.second) != bjdx.end() )))
             {
                 return false;
diff --git a/tests/src/unit-bjdata.cpp b/tests/src/unit-bjdata.cpp
index bc6c52833..dc2c63122 100644
--- a/tests/src/unit-bjdata.cpp
+++ b/tests/src/unit-bjdata.cpp
@@ -2408,34 +2408,6 @@ TEST_CASE("BJData")
                 CHECK(json::from_bjdata(json::to_bjdata(j_type), true, true) == j_type);
                 CHECK(json::from_bjdata(json::to_bjdata(j_size), true, true) == j_size);
             }
-
-            SECTION("do not accept NTFZ markers in ndarray optimized type")
-            {
-                json _;
-                std::vector<uint8_t> v_N = {'[', '$', 'N', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
-                std::vector<uint8_t> v_T = {'[', '$', 'T', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
-                std::vector<uint8_t> v_F = {'[', '$', 'F', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
-                std::vector<uint8_t> v_Z = {'[', '$', 'Z', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
-
-                CHECK(json::from_bjdata(v_N, true, true).is_discarded());
-                CHECK(json::from_bjdata(v_T, true, true).is_discarded());
-                CHECK(json::from_bjdata(v_F, true, true).is_discarded());
-                CHECK(json::from_bjdata(v_Z, true, true).is_discarded());
-            }
-
-            SECTION("do not accept NTFZ markers in ndarray optimized type")
-            {
-                json _;
-                std::vector<uint8_t> v_N = {'[', '$', 'N', '#', '[', 'i', 1, 'i', 2, ']'};
-                std::vector<uint8_t> v_T = {'[', '$', 'T', '#', '[', 'i', 1, 'i', 2, ']'};
-                std::vector<uint8_t> v_F = {'[', '$', 'F', '#', '[', 'i', 1, 'i', 2, ']'};
-                std::vector<uint8_t> v_Z = {'[', '$', 'Z', '#', '[', 'i', 1, 'i', 2, ']'};
-
-                CHECK(json::from_bjdata(v_N, true, true).is_discarded());
-                CHECK(json::from_bjdata(v_T, true, true).is_discarded());
-                CHECK(json::from_bjdata(v_F, true, true).is_discarded());
-                CHECK(json::from_bjdata(v_Z, true, true).is_discarded());
-            }
         }
     }
 
@@ -2515,6 +2487,56 @@ TEST_CASE("BJData")
                 CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
                 CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.112] parse error at byte 4: syntax error while parsing BJData size: expected '#' after type information; last byte: 0x02");
             }
+
+            SECTION("do not accept NTFZ markers in ndarray optimized type")
+            {
+                json _;
+                std::vector<uint8_t> v_N = {'[', '$', 'N', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
+                std::vector<uint8_t> v_T = {'[', '$', 'T', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
+                std::vector<uint8_t> v_F = {'[', '$', 'F', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
+                std::vector<uint8_t> v_Z = {'[', '$', 'Z', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
+
+                CHECK_THROWS_AS(_ = json::from_bjdata(v_N), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v_N), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x4E is not a permitted optimized array type");
+                CHECK(json::from_bjdata(v_N, true, false).is_discarded());
+
+                CHECK_THROWS_AS(_ = json::from_bjdata(v_T), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v_T), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x54 is not a permitted optimized array type");
+                CHECK(json::from_bjdata(v_T, true, false).is_discarded());
+
+                CHECK_THROWS_AS(_ = json::from_bjdata(v_F), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v_F), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x46 is not a permitted optimized array type");
+                CHECK(json::from_bjdata(v_F, true, false).is_discarded());
+
+                CHECK_THROWS_AS(_ = json::from_bjdata(v_Z), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v_Z), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x5A is not a permitted optimized array type");
+                CHECK(json::from_bjdata(v_Z, true, false).is_discarded());
+            }
+
+            SECTION("do not accept NTFZ markers in ndarray optimized type")
+            {
+                json _;
+                std::vector<uint8_t> v_N = {'[', '$', 'N', '#', '[', 'i', 1, 'i', 2, ']'};
+                std::vector<uint8_t> v_T = {'[', '$', 'T', '#', '[', 'i', 1, 'i', 2, ']'};
+                std::vector<uint8_t> v_F = {'[', '$', 'F', '#', '[', 'i', 1, 'i', 2, ']'};
+                std::vector<uint8_t> v_Z = {'[', '$', 'Z', '#', '[', 'i', 1, 'i', 2, ']'};
+
+                CHECK_THROWS_AS(_ = json::from_bjdata(v_N), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v_N), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x4E is not a permitted optimized array type");
+                CHECK(json::from_bjdata(v_N, true, false).is_discarded());
+
+                CHECK_THROWS_AS(_ = json::from_bjdata(v_T), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v_T), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x54 is not a permitted optimized array type");
+                CHECK(json::from_bjdata(v_T, true, false).is_discarded());
+
+                CHECK_THROWS_AS(_ = json::from_bjdata(v_F), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v_F), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x46 is not a permitted optimized array type");
+                CHECK(json::from_bjdata(v_F, true, false).is_discarded());
+
+                CHECK_THROWS_AS(_ = json::from_bjdata(v_Z), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v_Z), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x5A is not a permitted optimized array type");
+                CHECK(json::from_bjdata(v_Z, true, false).is_discarded());
+            }
         }
 
         SECTION("strings")
@@ -2626,6 +2648,11 @@ TEST_CASE("BJData")
             CHECK_THROWS_AS(_ = json::from_bjdata(vU), json::parse_error&);
             CHECK_THROWS_WITH(_ = json::from_bjdata(vU), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData value: unexpected end of input");
             CHECK(json::from_bjdata(vU, true, false).is_discarded());
+
+            std::vector<uint8_t> v1 = {'[', '$', '['};
+            CHECK_THROWS_AS(_ = json::from_bjdata(v1), json::parse_error&);
+            CHECK_THROWS_WITH(_ = json::from_bjdata(v1), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x5B is not a permitted optimized array type");
+            CHECK(json::from_bjdata(v1, true, false).is_discarded());
         }
 
         SECTION("arrays")
@@ -3188,14 +3215,20 @@ TEST_CASE("Universal Binary JSON Specification Examples 1")
         {
             SECTION("Array")
             {
+                json _;
                 std::vector<uint8_t> v = {'[', '$', 'N', '#', 'I', 0x00, 0x02};
-                CHECK(json::from_bjdata(v, true, true).is_discarded());
+                CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x4E is not a permitted optimized array type");
+                CHECK(json::from_bjdata(v, true, false).is_discarded());
             }
 
             SECTION("Object")
             {
+                json _;
                 std::vector<uint8_t> v = {'{', '$', 'Z', '#', 'i', 3, 'i', 4, 'n', 'a', 'm', 'e', 'i', 8, 'p', 'a', 's', 's', 'w', 'o', 'r', 'd', 'i', 5, 'e', 'm', 'a', 'i', 'l'};
-                CHECK(json::from_bjdata(v, true, true).is_discarded());
+                CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
+                CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x5A is not a permitted optimized array type");
+                CHECK(json::from_bjdata(v, true, false).is_discarded());
             }
         }
     }

From d6efe672b577098623f7a9ea28ccb777d04aa0cf Mon Sep 17 00:00:00 2001
From: Niels Lohmann <mail@nlohmann.me>
Date: Mon, 9 May 2022 08:02:41 +0200
Subject: [PATCH 10/30] Document fuzzer usage (#3478)

* :memo: document fuzzer usage

* :memo: address review comments
---
 .gitignore       |  4 +++
 tests/fuzzing.md | 81 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 85 insertions(+)
 create mode 100644 tests/fuzzing.md

diff --git a/.gitignore b/.gitignore
index db6dcecb4..72eb2c225 100644
--- a/.gitignore
+++ b/.gitignore
@@ -19,6 +19,10 @@
 # build directories (vscode-cmake-tools, user-defined, ...)
 /build*/
 
+# fuzzers
+/tests/parse_*_fuzzer
+/tests/corpus_*
+
 /docs/mkdocs/docs/examples/
 /docs/mkdocs/docs/__pycache__/
 /docs/mkdocs/site/
diff --git a/tests/fuzzing.md b/tests/fuzzing.md
new file mode 100644
index 000000000..cfbf4f249
--- /dev/null
+++ b/tests/fuzzing.md
@@ -0,0 +1,81 @@
+# Fuzz testing
+
+Each parser of the library (JSON, BJData, BSON, CBOR, MessagePack, and UBJSON) can be fuzz tested. Currently,
+[libFuzzer](https://llvm.org/docs/LibFuzzer.html) and [afl++](https://github.com/AFLplusplus/AFLplusplus) are supported.
+
+## Corpus creation
+
+For most effective fuzzing, a [corpus](https://llvm.org/docs/LibFuzzer.html#corpus) should be provided. A corpus is a
+directory with some simple input files that cover several features of the parser and is hence a good starting point
+for mutations.
+
+```shell
+TEST_DATA_VERSION=3.1.0
+wget https://github.com/nlohmann/json_test_data/archive/refs/tags/v$TEST_DATA_VERSION.zip
+unzip v$TEST_DATA_VERSION.zip
+rm v$TEST_DATA_VERSION.zip
+for FORMAT in json bjdata bson cbor msgpack ubjson
+do
+  rm -fr corpus_$FORMAT
+  mkdir corpus_$FORMAT
+  find json_test_data-$TEST_DATA_VERSION -size -5k -name "*.$FORMAT" -exec cp "{}" "corpus_$FORMAT" \;
+done
+rm -fr json_test_data-$TEST_DATA_VERSION
+```
+
+The generated corpus can be used with both libFuzzer and afl++. The remainder of this documentation assumes the corpus
+directories have been created in the `tests` directory.
+
+## libFuzzer
+
+To use libFuzzer, you need to pass `-fsanitize=fuzzer` as `FUZZER_ENGINE`. In the `tests` directory, call
+
+```shell
+make fuzzers FUZZER_ENGINE="-fsanitize=fuzzer"
+```
+
+This creates a fuzz tester binary for each parser that supports these
+[command line options](https://llvm.org/docs/LibFuzzer.html#options).
+
+In case your default compiler is not a Clang compiler that includes libFuzzer (Clang 6.0 or later), you need to set the
+`CXX` variable accordingly. Note the compiler provided by Xcode (AppleClang) does not contain libFuzzer. Please install
+Clang via Homebrew calling `brew install llvm` and add `CXX=$(brew --prefix llvm)/bin/clang` to the `make` call:
+
+```shell
+make fuzzers FUZZER_ENGINE="-fsanitize=fuzzer" CXX=$(brew --prefix llvm)/bin/clang
+```
+
+Then pass the corpus directory as command-line argument (assuming it is located in `tests`):
+
+```shell
+./parse_cbor_fuzzer corpus_cbor
+```
+
+The fuzzer should be able to run indefinitely without crashing. In case of a crash, the tested input is dumped into
+a file starting with `crash-`.
+
+## afl++
+
+To use afl++, you need to pass `-fsanitize=fuzzer` as `FUZZER_ENGINE`. It will be replaced by a `libAFLDriver.a` to
+re-use the same code written for libFuzzer with afl++. Furthermore, set `afl-clang-fast++` as compiler.
+
+```shell
+CXX=afl-clang-fast++ make fuzzers FUZZER_ENGINE="-fsanitize=fuzzer" 
+```
+
+Then the fuzzer is called like this in the `tests` directory:
+
+```shell
+afl-fuzz -i corpus_cbor -o out  -- ./parse_cbor_fuzzer 
+```
+
+The fuzzer should be able to run indefinitely without crashing. In case of a crash, the tested input is written to the
+directory `out`.
+
+## OSS-Fuzz
+
+The library is further fuzz-tested 24/7 by Google's [OSS-Fuzz project](https://github.com/google/oss-fuzz). It uses
+the same `fuzzers` target as above and also relies on the `FUZZER_ENGINE` variable. See the used
+[build script](https://github.com/google/oss-fuzz/blob/master/projects/json/build.sh) for more information.
+
+In case the build at OSS-Fuzz fails, an issue will be created automatically.

From a8a547d7a212a6a39943bbd5b4220be504a1a33e Mon Sep 17 00:00:00 2001
From: Qianqian Fang <fangqq@gmail.com>
Date: Tue, 10 May 2022 15:13:24 -0400
Subject: [PATCH 11/30] change bjdata ndarray flag to detect negative size, as
 part of #3475 (#3479)

* change bjdata ndarray flag to detect negative size, fix https://github.com/nlohmann/json/issues/3475

* fix CI error

* fix CI on 32bit windows

* remove platform specific out_of_range error messages

* Incorporate suggestions from @nlohmann and @falbrechtskirchinger

* fix CI errors

* add coverage

* fix sax event order

* fix coverage
---
 .../nlohmann/detail/input/binary_reader.hpp   | 55 ++++++++++----
 single_include/nlohmann/json.hpp              | 55 ++++++++++----
 tests/src/unit-bjdata.cpp                     | 76 ++++++++++++++++---
 3 files changed, 144 insertions(+), 42 deletions(-)

diff --git a/include/nlohmann/detail/input/binary_reader.hpp b/include/nlohmann/detail/input/binary_reader.hpp
index 75a20ed7b..703e6c0f6 100644
--- a/include/nlohmann/detail/input/binary_reader.hpp
+++ b/include/nlohmann/detail/input/binary_reader.hpp
@@ -1938,6 +1938,7 @@ class binary_reader
     {
         std::pair<std::size_t, char_int_type> size_and_type;
         size_t dimlen = 0;
+        bool is_ndarray = false;
 
         if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type)))
         {
@@ -1952,7 +1953,7 @@ class binary_reader
                 {
                     for (std::size_t i = 0; i < size_and_type.first; ++i)
                     {
-                        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, size_and_type.second)))
+                        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, is_ndarray, size_and_type.second)))
                         {
                             return false;
                         }
@@ -1964,7 +1965,7 @@ class binary_reader
             {
                 for (std::size_t i = 0; i < size_and_type.first; ++i)
                 {
-                    if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen)))
+                    if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, is_ndarray)))
                     {
                         return false;
                     }
@@ -1976,7 +1977,7 @@ class binary_reader
         {
             while (current != ']')
             {
-                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, current)))
+                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, is_ndarray, current)))
                 {
                     return false;
                 }
@@ -1991,8 +1992,9 @@ class binary_reader
     @param[out] result  determined size
     @return whether size determination completed
     */
-    bool get_ubjson_size_value(std::size_t& result, char_int_type prefix = 0)
+    bool get_ubjson_size_value(std::size_t& result, bool& is_ndarray, char_int_type prefix = 0)
     {
+        is_ndarray = false;
         if (prefix == 0)
         {
             prefix = get_ignore_noop();
@@ -2132,7 +2134,7 @@ class binary_reader
                             return false;
                         }
                     }
-                    result |= (1ull << (sizeof(result) * 8 - 1)); // low 63 bit of result stores the total element count, sign-bit indicates ndarray
+                    is_ndarray = true;
                     return sax->end_array();
                 }
                 result = 0;
@@ -2168,6 +2170,7 @@ class binary_reader
     */
     bool get_ubjson_size_type(std::pair<std::size_t, char_int_type>& result)
     {
+        bool is_ndarray = false;
         result.first = string_t::npos; // size
         result.second = 0; // type
 
@@ -2185,7 +2188,7 @@ class binary_reader
                                         exception_message(input_format, concat("marker 0x", last_token, " is not a permitted optimized array type"), "type"), nullptr));
             }
 
-            if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "type") || (input_format == input_format_t::bjdata && std::find(bjdx.begin(), bjdx.end(), result.second) != bjdx.end() )))
+            if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "type")))
             {
                 return false;
             }
@@ -2202,12 +2205,22 @@ class binary_reader
                                         exception_message(input_format, concat("expected '#' after type information; last byte: 0x", last_token), "size"), nullptr));
             }
 
-            return get_ubjson_size_value(result.first);
+            bool is_error = get_ubjson_size_value(result.first, is_ndarray);
+            if (input_format == input_format_t::bjdata && is_ndarray)
+            {
+                result.second |= (1 << 8); // use bit 8 to indicate ndarray, all UBJSON and BJData markers should be ASCII letters
+            }
+            return is_error;
         }
 
         if (current == '#')
         {
-            return get_ubjson_size_value(result.first);
+            bool is_error = get_ubjson_size_value(result.first, is_ndarray);
+            if (input_format == input_format_t::bjdata && is_ndarray)
+            {
+                result.second |= (1 << 8); // use bit 8 to indicate ndarray, all UBJSON and BJData markers should be ASCII letters
+            }
+            return is_error;
         }
 
         return true;
@@ -2408,17 +2421,26 @@ class binary_reader
             return false;
         }
 
-        // detect and encode bjdata ndarray as an object in JData annotated array format (https://github.com/NeuroJSON/jdata):
+        // if bit-8 of size_and_type.second is set to 1, encode bjdata ndarray as an object in JData annotated array format (https://github.com/NeuroJSON/jdata):
         // {"_ArrayType_" : "typeid", "_ArraySize_" : [n1, n2, ...], "_ArrayData_" : [v1, v2, ...]}
 
-        if (input_format == input_format_t::bjdata && size_and_type.first != string_t::npos && size_and_type.first >= (1ull << (sizeof(std::size_t) * 8 - 1)))
+        if (input_format == input_format_t::bjdata && size_and_type.first != string_t::npos && (size_and_type.second & (1 << 8)) != 0)
         {
             std::map<char_int_type, string_t> bjdtype = {{'U', "uint8"},  {'i', "int8"},  {'u', "uint16"}, {'I', "int16"},
                 {'m', "uint32"}, {'l', "int32"}, {'M', "uint64"}, {'L', "int64"}, {'d', "single"}, {'D', "double"}, {'C', "char"}
             };
 
+            size_and_type.second &= ~(static_cast<char_int_type>(1) << 8);  // use bit 8 to indicate ndarray, here we remove the bit to restore the type marker
+
             string_t key = "_ArrayType_";
-            if (JSON_HEDLEY_UNLIKELY(bjdtype.count(size_and_type.second) == 0 || !sax->key(key) || !sax->string(bjdtype[size_and_type.second]) ))
+            if (JSON_HEDLEY_UNLIKELY(bjdtype.count(size_and_type.second) == 0))
+            {
+                auto last_token = get_token_string();
+                return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+                                        exception_message(input_format, "invalid byte: 0x" + last_token, "type"), nullptr));
+            }
+
+            if (JSON_HEDLEY_UNLIKELY(!sax->key(key) || !sax->string(bjdtype[size_and_type.second]) ))
             {
                 return false;
             }
@@ -2428,7 +2450,6 @@ class binary_reader
                 size_and_type.second = 'U';
             }
 
-            size_and_type.first &= ~(1ull << (sizeof(std::size_t) * 8 - 1));
             key = "_ArrayData_";
             if (JSON_HEDLEY_UNLIKELY(!sax->key(key) || !sax->start_array(size_and_type.first) ))
             {
@@ -2508,9 +2529,12 @@ class binary_reader
             return false;
         }
 
-        if (input_format == input_format_t::bjdata && size_and_type.first != string_t::npos && size_and_type.first >= (1ull << (sizeof(std::size_t) * 8 - 1)))
+        // do not accept ND-array size in objects in BJData
+        if (input_format == input_format_t::bjdata && size_and_type.first != string_t::npos && (size_and_type.second & (1 << 8)) != 0)
         {
-            return false;
+            auto last_token = get_token_string();
+            return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+                                    exception_message(input_format, "BJData object does not support ND-array size in optimized format", "object"), nullptr));
         }
 
         string_t key;
@@ -2584,7 +2608,8 @@ class binary_reader
     {
         // get size of following number string
         std::size_t size{};
-        auto res = get_ubjson_size_value(size);
+        bool is_ndarray = false;
+        auto res = get_ubjson_size_value(size, is_ndarray);
         if (JSON_HEDLEY_UNLIKELY(!res))
         {
             return res;
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index bbd84d2be..a29f7bce9 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -10412,6 +10412,7 @@ class binary_reader
     {
         std::pair<std::size_t, char_int_type> size_and_type;
         size_t dimlen = 0;
+        bool is_ndarray = false;
 
         if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type)))
         {
@@ -10426,7 +10427,7 @@ class binary_reader
                 {
                     for (std::size_t i = 0; i < size_and_type.first; ++i)
                     {
-                        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, size_and_type.second)))
+                        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, is_ndarray, size_and_type.second)))
                         {
                             return false;
                         }
@@ -10438,7 +10439,7 @@ class binary_reader
             {
                 for (std::size_t i = 0; i < size_and_type.first; ++i)
                 {
-                    if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen)))
+                    if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, is_ndarray)))
                     {
                         return false;
                     }
@@ -10450,7 +10451,7 @@ class binary_reader
         {
             while (current != ']')
             {
-                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, current)))
+                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, is_ndarray, current)))
                 {
                     return false;
                 }
@@ -10465,8 +10466,9 @@ class binary_reader
     @param[out] result  determined size
     @return whether size determination completed
     */
-    bool get_ubjson_size_value(std::size_t& result, char_int_type prefix = 0)
+    bool get_ubjson_size_value(std::size_t& result, bool& is_ndarray, char_int_type prefix = 0)
     {
+        is_ndarray = false;
         if (prefix == 0)
         {
             prefix = get_ignore_noop();
@@ -10606,7 +10608,7 @@ class binary_reader
                             return false;
                         }
                     }
-                    result |= (1ull << (sizeof(result) * 8 - 1)); // low 63 bit of result stores the total element count, sign-bit indicates ndarray
+                    is_ndarray = true;
                     return sax->end_array();
                 }
                 result = 0;
@@ -10642,6 +10644,7 @@ class binary_reader
     */
     bool get_ubjson_size_type(std::pair<std::size_t, char_int_type>& result)
     {
+        bool is_ndarray = false;
         result.first = string_t::npos; // size
         result.second = 0; // type
 
@@ -10659,7 +10662,7 @@ class binary_reader
                                         exception_message(input_format, concat("marker 0x", last_token, " is not a permitted optimized array type"), "type"), nullptr));
             }
 
-            if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "type") || (input_format == input_format_t::bjdata && std::find(bjdx.begin(), bjdx.end(), result.second) != bjdx.end() )))
+            if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format, "type")))
             {
                 return false;
             }
@@ -10676,12 +10679,22 @@ class binary_reader
                                         exception_message(input_format, concat("expected '#' after type information; last byte: 0x", last_token), "size"), nullptr));
             }
 
-            return get_ubjson_size_value(result.first);
+            bool is_error = get_ubjson_size_value(result.first, is_ndarray);
+            if (input_format == input_format_t::bjdata && is_ndarray)
+            {
+                result.second |= (1 << 8); // use bit 8 to indicate ndarray, all UBJSON and BJData markers should be ASCII letters
+            }
+            return is_error;
         }
 
         if (current == '#')
         {
-            return get_ubjson_size_value(result.first);
+            bool is_error = get_ubjson_size_value(result.first, is_ndarray);
+            if (input_format == input_format_t::bjdata && is_ndarray)
+            {
+                result.second |= (1 << 8); // use bit 8 to indicate ndarray, all UBJSON and BJData markers should be ASCII letters
+            }
+            return is_error;
         }
 
         return true;
@@ -10882,17 +10895,26 @@ class binary_reader
             return false;
         }
 
-        // detect and encode bjdata ndarray as an object in JData annotated array format (https://github.com/NeuroJSON/jdata):
+        // if bit-8 of size_and_type.second is set to 1, encode bjdata ndarray as an object in JData annotated array format (https://github.com/NeuroJSON/jdata):
         // {"_ArrayType_" : "typeid", "_ArraySize_" : [n1, n2, ...], "_ArrayData_" : [v1, v2, ...]}
 
-        if (input_format == input_format_t::bjdata && size_and_type.first != string_t::npos && size_and_type.first >= (1ull << (sizeof(std::size_t) * 8 - 1)))
+        if (input_format == input_format_t::bjdata && size_and_type.first != string_t::npos && (size_and_type.second & (1 << 8)) != 0)
         {
             std::map<char_int_type, string_t> bjdtype = {{'U', "uint8"},  {'i', "int8"},  {'u', "uint16"}, {'I', "int16"},
                 {'m', "uint32"}, {'l', "int32"}, {'M', "uint64"}, {'L', "int64"}, {'d', "single"}, {'D', "double"}, {'C', "char"}
             };
 
+            size_and_type.second &= ~(static_cast<char_int_type>(1) << 8);  // use bit 8 to indicate ndarray, here we remove the bit to restore the type marker
+
             string_t key = "_ArrayType_";
-            if (JSON_HEDLEY_UNLIKELY(bjdtype.count(size_and_type.second) == 0 || !sax->key(key) || !sax->string(bjdtype[size_and_type.second]) ))
+            if (JSON_HEDLEY_UNLIKELY(bjdtype.count(size_and_type.second) == 0))
+            {
+                auto last_token = get_token_string();
+                return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+                                        exception_message(input_format, "invalid byte: 0x" + last_token, "type"), nullptr));
+            }
+
+            if (JSON_HEDLEY_UNLIKELY(!sax->key(key) || !sax->string(bjdtype[size_and_type.second]) ))
             {
                 return false;
             }
@@ -10902,7 +10924,6 @@ class binary_reader
                 size_and_type.second = 'U';
             }
 
-            size_and_type.first &= ~(1ull << (sizeof(std::size_t) * 8 - 1));
             key = "_ArrayData_";
             if (JSON_HEDLEY_UNLIKELY(!sax->key(key) || !sax->start_array(size_and_type.first) ))
             {
@@ -10982,9 +11003,12 @@ class binary_reader
             return false;
         }
 
-        if (input_format == input_format_t::bjdata && size_and_type.first != string_t::npos && size_and_type.first >= (1ull << (sizeof(std::size_t) * 8 - 1)))
+        // do not accept ND-array size in objects in BJData
+        if (input_format == input_format_t::bjdata && size_and_type.first != string_t::npos && (size_and_type.second & (1 << 8)) != 0)
         {
-            return false;
+            auto last_token = get_token_string();
+            return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+                                    exception_message(input_format, "BJData object does not support ND-array size in optimized format", "object"), nullptr));
         }
 
         string_t key;
@@ -11058,7 +11082,8 @@ class binary_reader
     {
         // get size of following number string
         std::size_t size{};
-        auto res = get_ubjson_size_value(size);
+        bool is_ndarray = false;
+        auto res = get_ubjson_size_value(size, is_ndarray);
         if (JSON_HEDLEY_UNLIKELY(!res))
         {
             return res;
diff --git a/tests/src/unit-bjdata.cpp b/tests/src/unit-bjdata.cpp
index dc2c63122..d2fa9a9b2 100644
--- a/tests/src/unit-bjdata.cpp
+++ b/tests/src/unit-bjdata.cpp
@@ -1130,7 +1130,7 @@ TEST_CASE("BJData")
                 {
                     json j = json::from_bjdata(std::vector<uint8_t>({'h', 0x00, 0x7c}));
                     json::number_float_t d{j};
-                    CHECK(!std::isfinite(d));
+                    CHECK_FALSE(std::isfinite(d));
                     CHECK(j.dump() == "null");
                 }
 
@@ -2035,77 +2035,98 @@ TEST_CASE("BJData")
         {
             std::vector<uint8_t> v = {'[', 'T', 'F', ']'};
             SaxCountdown scp(0);
-            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+            CHECK_FALSE(json::sax_parse(v, &scp, json::input_format_t::bjdata));
         }
 
         SECTION("start_object()")
         {
             std::vector<uint8_t> v = {'{', 'i', 3, 'f', 'o', 'o', 'F', '}'};
             SaxCountdown scp(0);
-            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+            CHECK_FALSE(json::sax_parse(v, &scp, json::input_format_t::bjdata));
         }
 
         SECTION("key() in object")
         {
             std::vector<uint8_t> v = {'{', 'i', 3, 'f', 'o', 'o', 'F', '}'};
             SaxCountdown scp(1);
-            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+            CHECK_FALSE(json::sax_parse(v, &scp, json::input_format_t::bjdata));
         }
 
         SECTION("start_array(len)")
         {
             std::vector<uint8_t> v = {'[', '#', 'i', '2', 'T', 'F'};
             SaxCountdown scp(0);
-            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+            CHECK_FALSE(json::sax_parse(v, &scp, json::input_format_t::bjdata));
         }
 
         SECTION("start_object(len)")
         {
             std::vector<uint8_t> v = {'{', '#', 'i', '1', 3, 'f', 'o', 'o', 'F'};
             SaxCountdown scp(0);
-            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+            CHECK_FALSE(json::sax_parse(v, &scp, json::input_format_t::bjdata));
         }
 
         SECTION("key() in object with length")
         {
             std::vector<uint8_t> v = {'{', 'i', 3, 'f', 'o', 'o', 'F', '}'};
             SaxCountdown scp(1);
-            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+            CHECK_FALSE(json::sax_parse(v, &scp, json::input_format_t::bjdata));
         }
 
         SECTION("start_array() in ndarray _ArraySize_")
         {
             std::vector<uint8_t> v = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'i', 2, 2, 1, 1, 2};
             SaxCountdown scp(2);
-            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+            CHECK_FALSE(json::sax_parse(v, &scp, json::input_format_t::bjdata));
         }
 
         SECTION("number_integer() in ndarray _ArraySize_")
         {
             std::vector<uint8_t> v = {'[', '$', 'U', '#', '[', '$', 'i', '#', 'i', 2, 2, 1, 1, 2};
             SaxCountdown scp(3);
-            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+            CHECK_FALSE(json::sax_parse(v, &scp, json::input_format_t::bjdata));
         }
 
         SECTION("key() in ndarray _ArrayType_")
+        {
+            std::vector<uint8_t> v = {'[', '$', 'U', '#', '[', '$', 'U', '#', 'i', 2, 2, 2, 1, 2, 3, 4};
+            SaxCountdown scp(6);
+            CHECK_FALSE(json::sax_parse(v, &scp, json::input_format_t::bjdata));
+        }
+
+        SECTION("string() in ndarray _ArrayType_")
+        {
+            std::vector<uint8_t> v = {'[', '$', 'U', '#', '[', '$', 'U', '#', 'i', 2, 2, 2, 1, 2, 3, 4};
+            SaxCountdown scp(7);
+            CHECK_FALSE(json::sax_parse(v, &scp, json::input_format_t::bjdata));
+        }
+
+        SECTION("key() in ndarray _ArrayData_")
         {
             std::vector<uint8_t> v = {'[', '$', 'U', '#', '[', '$', 'U', '#', 'i', 2, 2, 2, 1, 2, 3, 4};
             SaxCountdown scp(8);
-            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+            CHECK_FALSE(json::sax_parse(v, &scp, json::input_format_t::bjdata));
+        }
+
+        SECTION("string() in ndarray _ArrayData_")
+        {
+            std::vector<uint8_t> v = {'[', '$', 'U', '#', '[', '$', 'U', '#', 'i', 2, 2, 2, 1, 2, 3, 4};
+            SaxCountdown scp(9);
+            CHECK_FALSE(json::sax_parse(v, &scp, json::input_format_t::bjdata));
         }
 
         SECTION("string() in ndarray _ArrayType_")
         {
             std::vector<uint8_t> v = {'[', '$', 'U', '#', '[', '$', 'i', '#', 'i', 2, 3, 2, 6, 5, 4, 3, 2, 1};
             SaxCountdown scp(11);
-            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+            CHECK_FALSE(json::sax_parse(v, &scp, json::input_format_t::bjdata));
         }
 
         SECTION("start_array() in ndarray _ArrayData_")
         {
             std::vector<uint8_t> v = {'[', '$', 'U', '#', '[', 'i', 2, 'i', 3, ']', 6, 5, 4, 3, 2, 1};
             SaxCountdown scp(13);
-            CHECK(!json::sax_parse(v, &scp, json::input_format_t::bjdata));
+            CHECK_FALSE(json::sax_parse(v, &scp, json::input_format_t::bjdata));
         }
     }
 
@@ -2488,6 +2509,37 @@ TEST_CASE("BJData")
                 CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.112] parse error at byte 4: syntax error while parsing BJData size: expected '#' after type information; last byte: 0x02");
             }
 
+            SECTION("optimized array: negative size")
+            {
+                std::vector<uint8_t> v1 = {'[', '#', 'i', 0xF1};
+                std::vector<uint8_t> v2 = {'[', '$', 'I', '#', 'i', 0xF2};
+                std::vector<uint8_t> v3 = {'[', '$', 'I', '#', '[', 'i', 0xF4, 'i', 0x02, ']'};
+                std::vector<uint8_t> v4 = {'[', '$', 0xF6, '#', 'i', 0xF7};
+                std::vector<uint8_t> v5 = {'[', '$', 'I', '#', '[', 'i', 0xF5, 'i', 0xF1, ']'};
+                std::vector<uint8_t> v6 = {'[', '#', '[', 'i', 0xF3, 'i', 0x02, ']'};
+
+                json _;
+                static bool is_64bit = (sizeof(size_t) == 8);
+
+                if (is_64bit)
+                {
+                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v1), "[json.exception.out_of_range.408] excessive array size: 18446744073709551601", json::out_of_range&);
+                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v2), "[json.exception.out_of_range.408] excessive array size: 18446744073709551602", json::out_of_range&);
+                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v3), "[json.exception.out_of_range.408] excessive array size: 18446744073709551592", json::out_of_range&);
+                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v4), "[json.exception.out_of_range.408] excessive array size: 18446744073709551607", json::out_of_range&);
+                }
+                else
+                {
+                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v1), "[json.exception.out_of_range.408] excessive array size: 4294967281", json::out_of_range&);
+                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v2), "[json.exception.out_of_range.408] excessive array size: 4294967282", json::out_of_range&);
+                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v3), "[json.exception.out_of_range.408] excessive array size: 4294967272", json::out_of_range&);
+                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v4), "[json.exception.out_of_range.408] excessive array size: 4294967287", json::out_of_range&);
+                }
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v5), "[json.exception.parse_error.110] parse error at byte 11: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
+
+                CHECK(json::from_bjdata(v6, true, false).is_discarded());
+            }
+
             SECTION("do not accept NTFZ markers in ndarray optimized type")
             {
                 json _;

From 6a7392058e69956d610acefa7e3ce1cd60c8f5a6 Mon Sep 17 00:00:00 2001
From: Niels Lohmann <mail@nlohmann.me>
Date: Tue, 17 May 2022 13:08:56 +0200
Subject: [PATCH 12/30] Complete documentation for 3.11.0 (#3464)

* :busts_in_silhouette: update contributor and sponsor list

* :construction: document BJData format

* :construction: document BJData format

* :memo: clarified documentation of [json.exception.parse_error.112]

* :pencil2: adjust titles

* :memo: add more examples

* :rotating_light: adjust warnings for index.md files

* :memo: add more examples

* :fire: remove example for deprecated code

* :memo: add missing enum entry

* :memo: overwork table for binary formats

* :white_check_mark: add test to create table for binary formats

* :memo: fix wording in example

* :memo: add more examples

* Update iterators.md (#3481)

* :sparkles: add check for overloads to linter #3455

* :busts_in_silhouette: update contributor list

* :memo: add more examples

* :memo: fix documentation

* :memo: add more examples

* :art: fix indentation

* :fire: remove example for destructor

* :memo: overwork documentation

* Updated BJData documentation, #3464 (#3493)

* update bjdata.md for #3464

* Minor edit

* Fix URL typo

* Add info on demoting ND array to a 1-D optimized array when singleton dimension

Co-authored-by: Chaoqi Zhang <prncoprs@163.com>
Co-authored-by: Qianqian Fang <fangqq@gmail.com>
---
 README.md                                     |  22 +-
 ...h_subtype__byte_container_with_subtype.cpp |  23 ++
 ...ubtype__byte_container_with_subtype.output |   3 +
 ..._container_with_subtype__clear_subtype.cpp |  21 ++
 ...ntainer_with_subtype__clear_subtype.output |   2 +
 ...te_container_with_subtype__has_subtype.cpp |  19 ++
 ...container_with_subtype__has_subtype.output |   2 +
 ...te_container_with_subtype__set_subtype.cpp |  22 ++
 ...container_with_subtype__set_subtype.output |   2 +
 .../byte_container_with_subtype__subtype.cpp  |  22 ++
 ...yte_container_with_subtype__subtype.output |   2 +
 docs/examples/cbor_tag_handler_t.cpp          |  28 +++
 docs/examples/cbor_tag_handler_t.output       |   3 +
 docs/examples/default_object_comparator_t.cpp |  11 +
 .../default_object_comparator_t.output        |   2 +
 docs/examples/error_handler_t.cpp             |  24 ++
 docs/examples/error_handler_t.output          |   3 +
 docs/examples/from_bjdata.cpp                 |  20 ++
 docs/examples/from_bjdata.output              |   4 +
 docs/examples/get_allocator.cpp               |  18 ++
 docs/examples/get_allocator.output            |   1 +
 docs/examples/iterator_wrapper.cpp            |  29 ---
 docs/examples/iterator_wrapper.output         |   7 -
 .../json_pointer__operator_string.cpp         |  19 ++
 .../json_pointer__operator_string.output      |   2 +
 docs/examples/json_pointer__string_t.cpp      |  13 +
 docs/examples/json_pointer__string_t.output   |   2 +
 docs/examples/json_pointer__to_string.cpp     |   1 -
 docs/examples/nlohmann_json_version.cpp       |  12 +
 docs/examples/nlohmann_json_version.output    |   1 +
 docs/examples/object_comparator_t.cpp         |  11 +
 docs/examples/object_comparator_t.output      |   2 +
 docs/examples/ordered_json.cpp                |  14 ++
 docs/examples/ordered_json.output             |   5 +
 docs/examples/sax_parse.cpp                   |  37 +--
 docs/examples/sax_parse.output                |  39 ++-
 docs/examples/sax_parse__binary.cpp           | 114 +++++++++
 docs/examples/sax_parse__binary.output        |   3 +
 docs/examples/to_bjdata.cpp                   |  63 +++++
 docs/examples/to_bjdata.output                |   4 +
 docs/mkdocs/docs/api/basic_json/at.md         |   1 +
 docs/mkdocs/docs/api/basic_json/basic_json.md |   2 +-
 .../docs/api/basic_json/cbor_tag_handler_t.md |  17 ++
 docs/mkdocs/docs/api/basic_json/contains.md   |   4 +-
 .../basic_json/default_object_comparator_t.md |  16 ++
 .../docs/api/basic_json/error_handler_t.md    |  17 ++
 .../mkdocs/docs/api/basic_json/from_bjdata.md |  93 +++++++
 .../docs/api/basic_json/get_allocator.md      |  22 +-
 docs/mkdocs/docs/api/basic_json/index.md      |   2 +
 .../docs/api/basic_json/input_format_t.md     |  22 +-
 .../api/basic_json/object_comparator_t.md     |  17 +-
 docs/mkdocs/docs/api/basic_json/operator+=.md |   9 +-
 docs/mkdocs/docs/api/basic_json/operator[].md |   2 +
 .../docs/api/basic_json/operator_ValueType.md |   1 -
 .../mkdocs/docs/api/basic_json/operator_eq.md |   4 +-
 docs/mkdocs/docs/api/basic_json/push_back.md  |   9 +-
 docs/mkdocs/docs/api/basic_json/to_bjdata.md  |  70 ++++++
 docs/mkdocs/docs/api/basic_json/value_t.md    |  16 ++
 .../byte_container_with_subtype.md            |  16 ++
 .../clear_subtype.md                          |  16 ++
 .../has_subtype.md                            |  16 ++
 .../set_subtype.md                            |  16 ++
 .../byte_container_with_subtype/subtype.md    |  17 ++
 docs/mkdocs/docs/api/json.md                  |  16 ++
 docs/mkdocs/docs/api/json_pointer/index.md    |   8 +-
 .../docs/api/json_pointer/operator_string.md  |  16 ++
 docs/mkdocs/docs/api/json_pointer/string_t.md |  16 ++
 docs/mkdocs/docs/api/json_sax/binary.md       |  16 ++
 docs/mkdocs/docs/api/json_sax/boolean.md      |  16 ++
 docs/mkdocs/docs/api/json_sax/end_array.md    |  16 ++
 docs/mkdocs/docs/api/json_sax/end_object.md   |  16 ++
 docs/mkdocs/docs/api/json_sax/key.md          |  16 ++
 docs/mkdocs/docs/api/json_sax/null.md         |  16 ++
 docs/mkdocs/docs/api/json_sax/number_float.md |  16 ++
 .../docs/api/json_sax/number_integer.md       |  16 ++
 .../docs/api/json_sax/number_unsigned.md      |  16 ++
 docs/mkdocs/docs/api/json_sax/parse_error.md  |  16 ++
 docs/mkdocs/docs/api/json_sax/start_array.md  |  16 ++
 docs/mkdocs/docs/api/json_sax/start_object.md |  16 ++
 docs/mkdocs/docs/api/json_sax/string.md       |  16 ++
 .../mkdocs/docs/api/macros/json_has_cpp_11.md |  13 +
 .../docs/api/macros/json_has_filesystem.md    |  13 +
 docs/mkdocs/docs/api/macros/json_no_io.md     |  14 ++
 .../docs/api/macros/json_noexception.md       |  13 +
 .../json_skip_unsupported_compiler_check.md   |  13 +
 .../api/macros/nlohmann_json_version_major.md |  17 ++
 docs/mkdocs/docs/api/ordered_json.md          |  17 ++
 .../docs/features/binary_formats/bjdata.md    | 209 ++++++++++++++++
 .../docs/features/binary_formats/index.md     |  21 +-
 docs/mkdocs/docs/features/binary_values.md    | 100 +++++++-
 .../features/element_access/checked_access.md |  44 ++--
 .../element_access/unchecked_access.md        |  43 ++--
 docs/mkdocs/docs/features/iterators.md        |   2 +-
 docs/mkdocs/docs/features/object_order.md     |  21 +-
 docs/mkdocs/docs/home/exceptions.md           |  39 ++-
 docs/mkdocs/mkdocs.yml                        |   3 +
 docs/mkdocs/scripts/check_structure.py        |  59 +++--
 include/nlohmann/json.hpp                     |  23 --
 single_include/nlohmann/json.hpp              |  23 --
 tests/CMakeLists.txt                          |   2 +-
 tests/src/unit-binary_formats.cpp             | 232 ++++++++++++++++++
 tests/src/unit-bjdata.cpp                     |  15 --
 102 files changed, 1990 insertions(+), 247 deletions(-)
 create mode 100644 docs/examples/byte_container_with_subtype__byte_container_with_subtype.cpp
 create mode 100644 docs/examples/byte_container_with_subtype__byte_container_with_subtype.output
 create mode 100644 docs/examples/byte_container_with_subtype__clear_subtype.cpp
 create mode 100644 docs/examples/byte_container_with_subtype__clear_subtype.output
 create mode 100644 docs/examples/byte_container_with_subtype__has_subtype.cpp
 create mode 100644 docs/examples/byte_container_with_subtype__has_subtype.output
 create mode 100644 docs/examples/byte_container_with_subtype__set_subtype.cpp
 create mode 100644 docs/examples/byte_container_with_subtype__set_subtype.output
 create mode 100644 docs/examples/byte_container_with_subtype__subtype.cpp
 create mode 100644 docs/examples/byte_container_with_subtype__subtype.output
 create mode 100644 docs/examples/cbor_tag_handler_t.cpp
 create mode 100644 docs/examples/cbor_tag_handler_t.output
 create mode 100644 docs/examples/default_object_comparator_t.cpp
 create mode 100644 docs/examples/default_object_comparator_t.output
 create mode 100644 docs/examples/error_handler_t.cpp
 create mode 100644 docs/examples/error_handler_t.output
 create mode 100644 docs/examples/from_bjdata.cpp
 create mode 100644 docs/examples/from_bjdata.output
 create mode 100644 docs/examples/get_allocator.cpp
 create mode 100644 docs/examples/get_allocator.output
 delete mode 100644 docs/examples/iterator_wrapper.cpp
 delete mode 100644 docs/examples/iterator_wrapper.output
 create mode 100644 docs/examples/json_pointer__operator_string.cpp
 create mode 100644 docs/examples/json_pointer__operator_string.output
 create mode 100644 docs/examples/json_pointer__string_t.cpp
 create mode 100644 docs/examples/json_pointer__string_t.output
 create mode 100644 docs/examples/nlohmann_json_version.cpp
 create mode 100644 docs/examples/nlohmann_json_version.output
 create mode 100644 docs/examples/object_comparator_t.cpp
 create mode 100644 docs/examples/object_comparator_t.output
 create mode 100644 docs/examples/ordered_json.cpp
 create mode 100644 docs/examples/ordered_json.output
 create mode 100644 docs/examples/sax_parse__binary.cpp
 create mode 100644 docs/examples/sax_parse__binary.output
 create mode 100644 docs/examples/to_bjdata.cpp
 create mode 100644 docs/examples/to_bjdata.output
 create mode 100644 docs/mkdocs/docs/api/basic_json/from_bjdata.md
 create mode 100644 docs/mkdocs/docs/api/basic_json/to_bjdata.md
 create mode 100644 docs/mkdocs/docs/features/binary_formats/bjdata.md
 create mode 100644 tests/src/unit-binary_formats.cpp

diff --git a/README.md b/README.md
index 3f61377ba..96beb8899 100644
--- a/README.md
+++ b/README.md
@@ -54,7 +54,7 @@ There are myriads of [JSON](https://json.org) libraries out there, and each may
 
 - **Trivial integration**. Our whole code consists of a single header file [`json.hpp`](https://github.com/nlohmann/json/blob/develop/single_include/nlohmann/json.hpp). That's it. No library, no subproject, no dependencies, no complex build system. The class is written in vanilla C++11. All in all, everything should require no adjustment of your compiler flags or project settings.
 
-- **Serious testing**. Our class is heavily [unit-tested](https://github.com/nlohmann/json/tree/develop/tests/src) and covers [100%](https://coveralls.io/r/nlohmann/json) of the code, including all exceptional behavior. Furthermore, we checked with [Valgrind](https://valgrind.org) and the [Clang Sanitizers](https://clang.llvm.org/docs/index.html) that there are no memory leaks. [Google OSS-Fuzz](https://github.com/google/oss-fuzz/tree/master/projects/json) additionally runs fuzz tests against all parsers 24/7, effectively executing billions of tests so far. To maintain high quality, the project is following the [Core Infrastructure Initiative (CII) best practices](https://bestpractices.coreinfrastructure.org/projects/289).
+- **Serious testing**. Our code is heavily [unit-tested](https://github.com/nlohmann/json/tree/develop/tests/src) and covers [100%](https://coveralls.io/r/nlohmann/json) of the code, including all exceptional behavior. Furthermore, we checked with [Valgrind](https://valgrind.org) and the [Clang Sanitizers](https://clang.llvm.org/docs/index.html) that there are no memory leaks. [Google OSS-Fuzz](https://github.com/google/oss-fuzz/tree/master/projects/json) additionally runs fuzz tests against all parsers 24/7, effectively executing billions of tests so far. To maintain high quality, the project is following the [Core Infrastructure Initiative (CII) best practices](https://bestpractices.coreinfrastructure.org/projects/289).
 
 Other aspects were not so important to us:
 
@@ -69,6 +69,10 @@ See the [contribution guidelines](https://github.com/nlohmann/json/blob/master/.
 
 You can sponsor this library at [GitHub Sponsors](https://github.com/sponsors/nlohmann).
 
+### :office: Corporate Sponsor
+
+[![](https://upload.wikimedia.org/wikipedia/commons/thumb/9/9e/Codacy-logo-black.svg/320px-Codacy-logo-black.svg.png)](https://github.com/codacy)
+
 ### :label: Named Sponsors
 
 - [Michael Hartmann](https://github.com/reFX-Mike)
@@ -1599,6 +1603,20 @@ I deeply appreciate the help of the following people.
 - [Dirk Stolle](https://github.com/striezel) fixed typos in documentation.
 - [Daniel Albuschat](https://github.com/daniel-kun) corrected the parameter name in the `parse` documentation.
 - [Prince Mendiratta](https://github.com/Prince-Mendiratta) fixed a link to the FAQ.
+- [Florian Albrechtskirchinger](https://github.com/falbrechtskirchinger) implemented `std::string_view` support for object keys and made dozens of other improvements.
+- [Qianqian Fang](https://github.com/fangq) implemented the Binary JData (BJData) format.
+- [pketelsen](https://github.com/pketelsen) added macros `NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT` and `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT`.
+- [DarkZeros](https://github.com/DarkZeros) adjusted to code to not clash with Arduino defines.
+- [flagarde](https://github.com/flagarde) fixed the output of `meta()` for MSVC.
+- [Giovanni Cerretani](https://github.com/gcerretani) fixed a check for `std::filesystem`.
+- [Dimitris Apostolou](https://github.com/rex4539) fixed a typo.
+- [Ferry Huberts](https://github.com/fhuberts) fixed a typo.
+- [Michael Nosthoff](https://github.com/heinemml) fixed a typo.
+- [JungHoon Lee](https://github.com/jhnlee) fixed a typo.
+- [Faruk D.](https://github.com/fdiblen) fixed the CITATION.CFF file.
+- [Andrea Cocito](https://github.com/puffetto) added a clarification on macro usage to the documentation.
+- [Krzysiek Karbowiak](https://github.com/kkarbowiak) refactored the tests to use `CHECK_THROWS_WITH_AS`.
+- [Chaoqi Zhang](https://github.com/prncoprs) fixed a typo.
 
 Thanks a lot for helping out! Please [let me know](mailto:mail@nlohmann.me) if I forgot someone.
 
@@ -1613,7 +1631,7 @@ The library itself consists of a single header file licensed under the MIT licen
 - [**Artistic Style**](http://astyle.sourceforge.net) for automatic source code indentation
 - [**Clang**](https://clang.llvm.org) for compilation with code sanitizers
 - [**CMake**](https://cmake.org) for build automation
-- [**Codacity**](https://www.codacy.com) for further [code analysis](https://www.codacy.com/app/nlohmann/json)
+- [**Codacy**](https://www.codacy.com) for further [code analysis](https://www.codacy.com/app/nlohmann/json)
 - [**Coveralls**](https://coveralls.io) to measure [code coverage](https://coveralls.io/github/nlohmann/json)
 - [**Coverity Scan**](https://scan.coverity.com) for [static analysis](https://scan.coverity.com/projects/nlohmann-json)
 - [**cppcheck**](http://cppcheck.sourceforge.net) for static analysis
diff --git a/docs/examples/byte_container_with_subtype__byte_container_with_subtype.cpp b/docs/examples/byte_container_with_subtype__byte_container_with_subtype.cpp
new file mode 100644
index 000000000..1c10be5c2
--- /dev/null
+++ b/docs/examples/byte_container_with_subtype__byte_container_with_subtype.cpp
@@ -0,0 +1,23 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+// define a byte container based on std::vector
+using byte_container_with_subtype = nlohmann::byte_container_with_subtype<std::vector<std::uint8_t>>;
+
+using json = nlohmann::json;
+
+int main()
+{
+    // (1) create empty container
+    auto c1 = byte_container_with_subtype();
+
+    std::vector<std::uint8_t> bytes = {{0xca, 0xfe, 0xba, 0xbe}};
+
+    // (2) create container
+    auto c2 = byte_container_with_subtype(bytes);
+
+    // (3) create container with subtype
+    auto c3 = byte_container_with_subtype(bytes, 42);
+
+    std::cout << json(c1) << "\n" << json(c2) << "\n" << json(c3) << std::endl;
+}
diff --git a/docs/examples/byte_container_with_subtype__byte_container_with_subtype.output b/docs/examples/byte_container_with_subtype__byte_container_with_subtype.output
new file mode 100644
index 000000000..67ac1b2ef
--- /dev/null
+++ b/docs/examples/byte_container_with_subtype__byte_container_with_subtype.output
@@ -0,0 +1,3 @@
+{"bytes":[],"subtype":null}
+{"bytes":[202,254,186,190],"subtype":null}
+{"bytes":[202,254,186,190],"subtype":42}
diff --git a/docs/examples/byte_container_with_subtype__clear_subtype.cpp b/docs/examples/byte_container_with_subtype__clear_subtype.cpp
new file mode 100644
index 000000000..f9ce6842b
--- /dev/null
+++ b/docs/examples/byte_container_with_subtype__clear_subtype.cpp
@@ -0,0 +1,21 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+// define a byte container based on std::vector
+using byte_container_with_subtype = nlohmann::byte_container_with_subtype<std::vector<std::uint8_t>>;
+
+using json = nlohmann::json;
+
+int main()
+{
+    std::vector<std::uint8_t> bytes = {{0xca, 0xfe, 0xba, 0xbe}};
+
+    // create container with subtype
+    auto c1 = byte_container_with_subtype(bytes, 42);
+
+    std::cout << "before calling clear_subtype(): " << json(c1) << '\n';
+
+    c1.clear_subtype();
+
+    std::cout << "after calling clear_subtype(): " << json(c1) << '\n';
+}
diff --git a/docs/examples/byte_container_with_subtype__clear_subtype.output b/docs/examples/byte_container_with_subtype__clear_subtype.output
new file mode 100644
index 000000000..9d8212946
--- /dev/null
+++ b/docs/examples/byte_container_with_subtype__clear_subtype.output
@@ -0,0 +1,2 @@
+before calling clear_subtype(): {"bytes":[202,254,186,190],"subtype":42}
+after calling clear_subtype(): {"bytes":[202,254,186,190],"subtype":null}
diff --git a/docs/examples/byte_container_with_subtype__has_subtype.cpp b/docs/examples/byte_container_with_subtype__has_subtype.cpp
new file mode 100644
index 000000000..61c21eaae
--- /dev/null
+++ b/docs/examples/byte_container_with_subtype__has_subtype.cpp
@@ -0,0 +1,19 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+// define a byte container based on std::vector
+using byte_container_with_subtype = nlohmann::byte_container_with_subtype<std::vector<std::uint8_t>>;
+
+int main()
+{
+    std::vector<std::uint8_t> bytes = {{0xca, 0xfe, 0xba, 0xbe}};
+
+    // create container
+    auto c1 = byte_container_with_subtype(bytes);
+
+    // create container with subtype
+    auto c2 = byte_container_with_subtype(bytes, 42);
+
+    std::cout << std::boolalpha << "c1.has_subtype() = " << c1.has_subtype()
+              << "\nc2.has_subtype() = " << c2.has_subtype() << std::endl;
+}
diff --git a/docs/examples/byte_container_with_subtype__has_subtype.output b/docs/examples/byte_container_with_subtype__has_subtype.output
new file mode 100644
index 000000000..f4aade2a1
--- /dev/null
+++ b/docs/examples/byte_container_with_subtype__has_subtype.output
@@ -0,0 +1,2 @@
+c1.has_subtype() = false
+c2.has_subtype() = true
diff --git a/docs/examples/byte_container_with_subtype__set_subtype.cpp b/docs/examples/byte_container_with_subtype__set_subtype.cpp
new file mode 100644
index 000000000..b2694c54d
--- /dev/null
+++ b/docs/examples/byte_container_with_subtype__set_subtype.cpp
@@ -0,0 +1,22 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+// define a byte container based on std::vector
+using byte_container_with_subtype = nlohmann::byte_container_with_subtype<std::vector<std::uint8_t>>;
+
+using json = nlohmann::json;
+
+int main()
+{
+    std::vector<std::uint8_t> bytes = {{0xca, 0xfe, 0xba, 0xbe}};
+
+    // create container without subtype
+    auto c = byte_container_with_subtype(bytes);
+
+    std::cout << "before calling set_subtype(42): " << json(c) << '\n';
+
+    // set the subtype
+    c.set_subtype(42);
+
+    std::cout << "after calling set_subtype(42): " << json(c) << '\n';
+}
diff --git a/docs/examples/byte_container_with_subtype__set_subtype.output b/docs/examples/byte_container_with_subtype__set_subtype.output
new file mode 100644
index 000000000..648b3ef24
--- /dev/null
+++ b/docs/examples/byte_container_with_subtype__set_subtype.output
@@ -0,0 +1,2 @@
+before calling set_subtype(42): {"bytes":[202,254,186,190],"subtype":null}
+after calling set_subtype(42): {"bytes":[202,254,186,190],"subtype":42}
diff --git a/docs/examples/byte_container_with_subtype__subtype.cpp b/docs/examples/byte_container_with_subtype__subtype.cpp
new file mode 100644
index 000000000..cd230ade1
--- /dev/null
+++ b/docs/examples/byte_container_with_subtype__subtype.cpp
@@ -0,0 +1,22 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+// define a byte container based on std::vector
+using byte_container_with_subtype = nlohmann::byte_container_with_subtype<std::vector<std::uint8_t>>;
+
+int main()
+{
+    std::vector<std::uint8_t> bytes = {{0xca, 0xfe, 0xba, 0xbe}};
+
+    // create container
+    auto c1 = byte_container_with_subtype(bytes);
+
+    // create container with subtype
+    auto c2 = byte_container_with_subtype(bytes, 42);
+
+    std::cout << "c1.subtype() = " << c1.subtype()
+              << "\nc2.subtype() = " << c2.subtype() << std::endl;
+
+    // in case no subtype is set, return special value
+    assert(c1.subtype() == static_cast<byte_container_with_subtype::subtype_type>(-1));
+}
diff --git a/docs/examples/byte_container_with_subtype__subtype.output b/docs/examples/byte_container_with_subtype__subtype.output
new file mode 100644
index 000000000..47955277b
--- /dev/null
+++ b/docs/examples/byte_container_with_subtype__subtype.output
@@ -0,0 +1,2 @@
+c1.subtype() = 18446744073709551615
+c2.subtype() = 42
diff --git a/docs/examples/cbor_tag_handler_t.cpp b/docs/examples/cbor_tag_handler_t.cpp
new file mode 100644
index 000000000..79052c7a0
--- /dev/null
+++ b/docs/examples/cbor_tag_handler_t.cpp
@@ -0,0 +1,28 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+    // tagged byte string
+    std::vector<std::uint8_t> vec = {{0xd8, 0x42, 0x44, 0xcA, 0xfe, 0xba, 0xbe}};
+
+    // cbor_tag_handler_t::error throws
+    try
+    {
+        auto b_throw_on_tag = json::from_cbor(vec, true, true, json::cbor_tag_handler_t::error);
+    }
+    catch (json::parse_error& e)
+    {
+        std::cout << e.what() << std::endl;
+    }
+
+    // cbor_tag_handler_t::ignore ignores the tag
+    auto b_ignore_tag = json::from_cbor(vec, true, true, json::cbor_tag_handler_t::ignore);
+    std::cout << b_ignore_tag << std::endl;
+
+    // cbor_tag_handler_t::store stores the tag as binary subtype
+    auto b_store_tag = json::from_cbor(vec, true, true, json::cbor_tag_handler_t::store);
+    std::cout << b_store_tag << std::endl;
+}
diff --git a/docs/examples/cbor_tag_handler_t.output b/docs/examples/cbor_tag_handler_t.output
new file mode 100644
index 000000000..18920b137
--- /dev/null
+++ b/docs/examples/cbor_tag_handler_t.output
@@ -0,0 +1,3 @@
+[json.exception.parse_error.112] parse error at byte 1: syntax error while parsing CBOR value: invalid byte: 0xD8
+{"bytes":[202,254,186,190],"subtype":null}
+{"bytes":[202,254,186,190],"subtype":66}
diff --git a/docs/examples/default_object_comparator_t.cpp b/docs/examples/default_object_comparator_t.cpp
new file mode 100644
index 000000000..9f200fe6b
--- /dev/null
+++ b/docs/examples/default_object_comparator_t.cpp
@@ -0,0 +1,11 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+    std::cout << std::boolalpha
+              << "one < two : " << json::default_object_comparator_t{}("one", "two") << "\n"
+              << "three < four : " << json::default_object_comparator_t{}("three", "four") << std::endl;
+}
diff --git a/docs/examples/default_object_comparator_t.output b/docs/examples/default_object_comparator_t.output
new file mode 100644
index 000000000..b1daf3b96
--- /dev/null
+++ b/docs/examples/default_object_comparator_t.output
@@ -0,0 +1,2 @@
+one < two : true
+three < four : false
diff --git a/docs/examples/error_handler_t.cpp b/docs/examples/error_handler_t.cpp
new file mode 100644
index 000000000..add3f3b2d
--- /dev/null
+++ b/docs/examples/error_handler_t.cpp
@@ -0,0 +1,24 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+    // create JSON value with invalid UTF-8 byte sequence
+    json j_invalid = "ä\xA9ü";
+    try
+    {
+        std::cout << j_invalid.dump() << std::endl;
+    }
+    catch (json::type_error& e)
+    {
+        std::cout << e.what() << std::endl;
+    }
+
+    std::cout << "string with replaced invalid characters: "
+              << j_invalid.dump(-1, ' ', false, json::error_handler_t::replace)
+              << "\nstring with ignored invalid characters: "
+              << j_invalid.dump(-1, ' ', false, json::error_handler_t::ignore)
+              << '\n';
+}
diff --git a/docs/examples/error_handler_t.output b/docs/examples/error_handler_t.output
new file mode 100644
index 000000000..718d62bee
--- /dev/null
+++ b/docs/examples/error_handler_t.output
@@ -0,0 +1,3 @@
+[json.exception.type_error.316] invalid UTF-8 byte at index 2: 0xA9
+string with replaced invalid characters: "ä�ü"
+string with ignored invalid characters: "äü"
diff --git a/docs/examples/from_bjdata.cpp b/docs/examples/from_bjdata.cpp
new file mode 100644
index 000000000..961164c29
--- /dev/null
+++ b/docs/examples/from_bjdata.cpp
@@ -0,0 +1,20 @@
+#include <iostream>
+#include <iomanip>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+    // create byte vector
+    std::vector<std::uint8_t> v = {0x7B, 0x69, 0x07, 0x63, 0x6F, 0x6D, 0x70, 0x61,
+                                   0x63, 0x74, 0x54, 0x69, 0x06, 0x73, 0x63, 0x68,
+                                   0x65, 0x6D, 0x61, 0x69, 0x00, 0x7D
+                                  };
+
+    // deserialize it with BJData
+    json j = json::from_bjdata(v);
+
+    // print the deserialized JSON value
+    std::cout << std::setw(2) << j << std::endl;
+}
diff --git a/docs/examples/from_bjdata.output b/docs/examples/from_bjdata.output
new file mode 100644
index 000000000..259f63bd4
--- /dev/null
+++ b/docs/examples/from_bjdata.output
@@ -0,0 +1,4 @@
+{
+  "compact": true,
+  "schema": 0
+}
diff --git a/docs/examples/get_allocator.cpp b/docs/examples/get_allocator.cpp
new file mode 100644
index 000000000..35079a10c
--- /dev/null
+++ b/docs/examples/get_allocator.cpp
@@ -0,0 +1,18 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+    auto alloc = json::get_allocator();
+    using traits_t = std::allocator_traits<decltype(alloc)>;
+
+    json* j = traits_t::allocate(alloc, 1);
+    traits_t::construct(alloc, j, "Hello, world!");
+
+    std::cout << *j << std::endl;
+
+    traits_t::destroy(alloc, j);
+    traits_t::deallocate(alloc, j, 1);
+}
diff --git a/docs/examples/get_allocator.output b/docs/examples/get_allocator.output
new file mode 100644
index 000000000..8effb3e8c
--- /dev/null
+++ b/docs/examples/get_allocator.output
@@ -0,0 +1 @@
+"Hello, world!"
diff --git a/docs/examples/iterator_wrapper.cpp b/docs/examples/iterator_wrapper.cpp
deleted file mode 100644
index 84d37254b..000000000
--- a/docs/examples/iterator_wrapper.cpp
+++ /dev/null
@@ -1,29 +0,0 @@
-#include <iostream>
-#include <nlohmann/json.hpp>
-
-using json = nlohmann::json;
-
-int main()
-{
-    // create JSON values
-    json j_object = {{"one", 1}, {"two", 2}};
-    json j_array = {1, 2, 4, 8, 16};
-
-    //////////////////////////////////////////////////////////////////////////
-    // The static function iterator_wrapper was deprecated in version 3.1.0
-    // and will be removed in version 4.0.0. Please replace all occurrences
-    // of iterator_wrapper(j) with j.items().
-    //////////////////////////////////////////////////////////////////////////
-
-    // example for an object
-    for (auto& x : json::iterator_wrapper(j_object))
-    {
-        std::cout << "key: " << x.key() << ", value: " << x.value() << '\n';
-    }
-
-    // example for an array
-    for (auto& x : json::iterator_wrapper(j_array))
-    {
-        std::cout << "key: " << x.key() << ", value: " << x.value() << '\n';
-    }
-}
diff --git a/docs/examples/iterator_wrapper.output b/docs/examples/iterator_wrapper.output
deleted file mode 100644
index 89b09f524..000000000
--- a/docs/examples/iterator_wrapper.output
+++ /dev/null
@@ -1,7 +0,0 @@
-key: one, value: 1
-key: two, value: 2
-key: 0, value: 1
-key: 1, value: 2
-key: 2, value: 4
-key: 3, value: 8
-key: 4, value: 16
diff --git a/docs/examples/json_pointer__operator_string.cpp b/docs/examples/json_pointer__operator_string.cpp
new file mode 100644
index 000000000..56f213020
--- /dev/null
+++ b/docs/examples/json_pointer__operator_string.cpp
@@ -0,0 +1,19 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+    // different JSON Pointers
+    json::json_pointer ptr1("/foo/0");
+    json::json_pointer ptr2("/a~1b");
+
+    // implicit conversion to string
+    std::string s;
+    s += ptr1;
+    s += "\n";
+    s += ptr2;
+
+    std::cout << s << std::endl;
+}
diff --git a/docs/examples/json_pointer__operator_string.output b/docs/examples/json_pointer__operator_string.output
new file mode 100644
index 000000000..ec6aba2c2
--- /dev/null
+++ b/docs/examples/json_pointer__operator_string.output
@@ -0,0 +1,2 @@
+/foo/0
+/a~1b
diff --git a/docs/examples/json_pointer__string_t.cpp b/docs/examples/json_pointer__string_t.cpp
new file mode 100644
index 000000000..fbe0f179e
--- /dev/null
+++ b/docs/examples/json_pointer__string_t.cpp
@@ -0,0 +1,13 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+    json::json_pointer::string_t s = "This is a string.";
+
+    std::cout << s << std::endl;
+
+    std::cout << std::boolalpha << std::is_same<json::json_pointer::string_t, json::string_t>::value << std::endl;
+}
diff --git a/docs/examples/json_pointer__string_t.output b/docs/examples/json_pointer__string_t.output
new file mode 100644
index 000000000..d87113724
--- /dev/null
+++ b/docs/examples/json_pointer__string_t.output
@@ -0,0 +1,2 @@
+This is a string.
+true
diff --git a/docs/examples/json_pointer__to_string.cpp b/docs/examples/json_pointer__to_string.cpp
index da397cdf4..ae1361aaa 100644
--- a/docs/examples/json_pointer__to_string.cpp
+++ b/docs/examples/json_pointer__to_string.cpp
@@ -19,7 +19,6 @@ int main()
     json::json_pointer ptr11("/ ");
     json::json_pointer ptr12("/m~0n");
 
-
     std::cout << ptr1.to_string() << '\n'
               << ptr2.to_string() << '\n'
               << ptr3.to_string() << '\n'
diff --git a/docs/examples/nlohmann_json_version.cpp b/docs/examples/nlohmann_json_version.cpp
new file mode 100644
index 000000000..ca5f53728
--- /dev/null
+++ b/docs/examples/nlohmann_json_version.cpp
@@ -0,0 +1,12 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+    std::cout << "JSON for Modern C++ version "
+              << NLOHMANN_JSON_VERSION_MAJOR << "."
+              << NLOHMANN_JSON_VERSION_MINOR << "."
+              << NLOHMANN_JSON_VERSION_PATCH << std::endl;
+}
diff --git a/docs/examples/nlohmann_json_version.output b/docs/examples/nlohmann_json_version.output
new file mode 100644
index 000000000..600343999
--- /dev/null
+++ b/docs/examples/nlohmann_json_version.output
@@ -0,0 +1 @@
+JSON for Modern C++ version 3.10.5
diff --git a/docs/examples/object_comparator_t.cpp b/docs/examples/object_comparator_t.cpp
new file mode 100644
index 000000000..6b82c7ca6
--- /dev/null
+++ b/docs/examples/object_comparator_t.cpp
@@ -0,0 +1,11 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+    std::cout << std::boolalpha
+              << "json::object_comparator_t(\"one\", \"two\") = " << json::object_comparator_t{}("one", "two") << "\n"
+              << "json::object_comparator_t(\"three\", \"four\") = " << json::object_comparator_t{}("three", "four") << std::endl;
+}
diff --git a/docs/examples/object_comparator_t.output b/docs/examples/object_comparator_t.output
new file mode 100644
index 000000000..63620edb4
--- /dev/null
+++ b/docs/examples/object_comparator_t.output
@@ -0,0 +1,2 @@
+json::object_comparator_t("one", "two") = true
+json::object_comparator_t("three", "four") = false
diff --git a/docs/examples/ordered_json.cpp b/docs/examples/ordered_json.cpp
new file mode 100644
index 000000000..effad530c
--- /dev/null
+++ b/docs/examples/ordered_json.cpp
@@ -0,0 +1,14 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using ordered_json = nlohmann::ordered_json;
+
+int main()
+{
+    ordered_json j;
+    j["one"] = 1;
+    j["two"] = 2;
+    j["three"] = 3;
+
+    std::cout << j.dump(2) << '\n';
+}
diff --git a/docs/examples/ordered_json.output b/docs/examples/ordered_json.output
new file mode 100644
index 000000000..120cbb284
--- /dev/null
+++ b/docs/examples/ordered_json.output
@@ -0,0 +1,5 @@
+{
+  "one": 1,
+  "two": 2,
+  "three": 3
+}
diff --git a/docs/examples/sax_parse.cpp b/docs/examples/sax_parse.cpp
index 45273eb6c..8602687e3 100644
--- a/docs/examples/sax_parse.cpp
+++ b/docs/examples/sax_parse.cpp
@@ -6,7 +6,7 @@
 using json = nlohmann::json;
 
 // a simple event consumer that collects string representations of the passed
-// values; not inheriting from json::json_sax_t is not required, but can
+// values; note inheriting from json::json_sax_t is not required, but can
 // help not to forget a required function
 class sax_event_consumer : public json::json_sax_t
 {
@@ -15,79 +15,79 @@ class sax_event_consumer : public json::json_sax_t
 
     bool null() override
     {
-        events.push_back("value: null");
+        events.push_back("null()");
         return true;
     }
 
     bool boolean(bool val) override
     {
-        events.push_back("value: " + std::string(val ? "true" : "false"));
+        events.push_back("boolean(val=" + std::string(val ? "true" : "false") + ")");
         return true;
     }
 
     bool number_integer(number_integer_t val) override
     {
-        events.push_back("value: " + std::to_string(val));
+        events.push_back("number_integer(val=" + std::to_string(val) + ")");
         return true;
     }
 
     bool number_unsigned(number_unsigned_t val) override
     {
-        events.push_back("value: " + std::to_string(val));
+        events.push_back("number_unsigned(val=" + std::to_string(val) + ")");
         return true;
     }
 
     bool number_float(number_float_t val, const string_t& s) override
     {
-        events.push_back("value: " + s);
+        events.push_back("number_float(val=" + std::to_string(val) + ", s=" + s + ")");
         return true;
     }
 
     bool string(string_t& val) override
     {
-        events.push_back("value: " + val);
+        events.push_back("string(val=" + val + ")");
         return true;
     }
 
     bool start_object(std::size_t elements) override
     {
-        events.push_back("start: object");
+        events.push_back("start_object(elements=" + std::to_string(elements) + ")");
         return true;
     }
 
     bool end_object() override
     {
-        events.push_back("end: object");
+        events.push_back("end_object()");
         return true;
     }
 
     bool start_array(std::size_t elements) override
     {
-        events.push_back("start: array");
+        events.push_back("start_array(elements=" + std::to_string(elements) + ")");
         return true;
     }
 
     bool end_array() override
     {
-        events.push_back("end: array");
+        events.push_back("end_array()");
         return true;
     }
 
     bool key(string_t& val) override
     {
-        events.push_back("key: " + val);
+        events.push_back("key(val=" + val + ")");
         return true;
     }
 
     bool binary(json::binary_t& val) override
     {
-        events.push_back("binary");
+        events.push_back("binary(val=[...])");
         return true;
     }
 
     bool parse_error(std::size_t position, const std::string& last_token, const json::exception& ex) override
     {
-        events.push_back("error: " + std::string(ex.what()));
+        events.push_back("parse_error(position=" + std::to_string(position) + ", last_token=" + last_token + ",\n            ex=" + std::string(ex.what()) + ")");
         return false;
     }
 };
@@ -107,22 +107,23 @@ int main()
                 "Width":  100
             },
             "Animated" : false,
-            "IDs": [116, 943, 234, 38793],
+            "IDs": [116, 943, 234, -38793],
+            "DeletionDate": null,
             "Distance": 12.723374634
         }
-    }
+    }]
     )";
 
     // create a SAX event consumer object
     sax_event_consumer sec;
 
-    // parse and serialize JSON
+    // parse JSON
     bool result = json::sax_parse(text, &sec);
 
     // output the recorded events
     for (auto& event : sec.events)
     {
-        std::cout << "(" << event << ") ";
+        std::cout << event << "\n";
     }
 
     // output the result of sax_parse
diff --git a/docs/examples/sax_parse.output b/docs/examples/sax_parse.output
index e16c2c4de..dd2fc2f05 100644
--- a/docs/examples/sax_parse.output
+++ b/docs/examples/sax_parse.output
@@ -1,2 +1,37 @@
-(start: object) (key: Image) (start: object) (key: Width) (value: 800) (key: Height) (value: 600) (key: Title) (value: View from 15th Floor) (key: Thumbnail) (start: object) (key: Url) (value: http://www.example.com/image/481989943) (key: Height) (value: 125) (key: Width) (value: 100) (end: object) (key: Animated) (value: false) (key: IDs) (start: array) (value: 116) (value: 943) (value: 234) (value: 38793) (end: array) (key: Distance) (value: 12.723374634) (end: object) (end: object) 
-result: true
+start_object(elements=18446744073709551615)
+key(val=Image)
+start_object(elements=18446744073709551615)
+key(val=Width)
+number_unsigned(val=800)
+key(val=Height)
+number_unsigned(val=600)
+key(val=Title)
+string(val=View from 15th Floor)
+key(val=Thumbnail)
+start_object(elements=18446744073709551615)
+key(val=Url)
+string(val=http://www.example.com/image/481989943)
+key(val=Height)
+number_unsigned(val=125)
+key(val=Width)
+number_unsigned(val=100)
+end_object()
+key(val=Animated)
+boolean(val=false)
+key(val=IDs)
+start_array(elements=18446744073709551615)
+number_unsigned(val=116)
+number_unsigned(val=943)
+number_unsigned(val=234)
+number_integer(val=-38793)
+end_array()
+key(val=DeletionDate)
+null()
+key(val=Distance)
+number_float(val=12.723375, s=12.723374634)
+end_object()
+end_object()
+parse_error(position=460, last_token=12.723374634<U+000A>        }<U+000A>    }],
+            ex=[json.exception.parse_error.101] parse error at line 17, column 6: syntax error while parsing value - unexpected ']'; expected end of input)
+
+result: false
diff --git a/docs/examples/sax_parse__binary.cpp b/docs/examples/sax_parse__binary.cpp
new file mode 100644
index 000000000..08bc85df6
--- /dev/null
+++ b/docs/examples/sax_parse__binary.cpp
@@ -0,0 +1,114 @@
+#include <iostream>
+#include <iomanip>
+#include <sstream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+// a simple event consumer that collects string representations of the passed
+// values; note inheriting from json::json_sax_t is not required, but can
+// help not to forget a required function
+class sax_event_consumer : public json::json_sax_t
+{
+  public:
+    std::vector<std::string> events;
+
+    bool null() override
+    {
+        events.push_back("null()");
+        return true;
+    }
+
+    bool boolean(bool val) override
+    {
+        events.push_back("boolean(val=" + std::string(val ? "true" : "false") + ")");
+        return true;
+    }
+
+    bool number_integer(number_integer_t val) override
+    {
+        events.push_back("number_integer(val=" + std::to_string(val) + ")");
+        return true;
+    }
+
+    bool number_unsigned(number_unsigned_t val) override
+    {
+        events.push_back("number_unsigned(val=" + std::to_string(val) + ")");
+        return true;
+    }
+
+    bool number_float(number_float_t val, const string_t& s) override
+    {
+        events.push_back("number_float(val=" + std::to_string(val) + ", s=" + s + ")");
+        return true;
+    }
+
+    bool string(string_t& val) override
+    {
+        events.push_back("string(val=" + val + ")");
+        return true;
+    }
+
+    bool start_object(std::size_t elements) override
+    {
+        events.push_back("start_object(elements=" + std::to_string(elements) + ")");
+        return true;
+    }
+
+    bool end_object() override
+    {
+        events.push_back("end_object()");
+        return true;
+    }
+
+    bool start_array(std::size_t elements) override
+    {
+        events.push_back("start_array(elements=" + std::to_string(elements) + ")");
+        return true;
+    }
+
+    bool end_array() override
+    {
+        events.push_back("end_array()");
+        return true;
+    }
+
+    bool key(string_t& val) override
+    {
+        events.push_back("key(val=" + val + ")");
+        return true;
+    }
+
+    bool binary(json::binary_t& val) override
+    {
+        events.push_back("binary(val=[...])");
+        return true;
+    }
+
+    bool parse_error(std::size_t position, const std::string& last_token, const json::exception& ex) override
+    {
+        events.push_back("parse_error(position=" + std::to_string(position) + ", last_token=" + last_token + ",\n            ex=" + std::string(ex.what()) + ")");
+        return false;
+    }
+};
+
+int main()
+{
+    // CBOR byte string
+    std::vector<std::uint8_t> vec = {{0x44, 0xcA, 0xfe, 0xba, 0xbe}};
+
+    // create a SAX event consumer object
+    sax_event_consumer sec;
+
+    // parse CBOR
+    bool result = json::sax_parse(vec, &sec, json::input_format_t::cbor);
+
+    // output the recorded events
+    for (auto& event : sec.events)
+    {
+        std::cout << event << "\n";
+    }
+
+    // output the result of sax_parse
+    std::cout << "\nresult: " << std::boolalpha << result << std::endl;
+}
diff --git a/docs/examples/sax_parse__binary.output b/docs/examples/sax_parse__binary.output
new file mode 100644
index 000000000..f88089610
--- /dev/null
+++ b/docs/examples/sax_parse__binary.output
@@ -0,0 +1,3 @@
+binary(val=[...])
+
+result: true
diff --git a/docs/examples/to_bjdata.cpp b/docs/examples/to_bjdata.cpp
new file mode 100644
index 000000000..0bfe33323
--- /dev/null
+++ b/docs/examples/to_bjdata.cpp
@@ -0,0 +1,63 @@
+#include <iostream>
+#include <iomanip>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+// function to print BJData's diagnostic format
+void print_byte(uint8_t byte)
+{
+    if (32 < byte and byte < 128)
+    {
+        std::cout << (char)byte;
+    }
+    else
+    {
+        std::cout << (int)byte;
+    }
+}
+
+int main()
+{
+    // create a JSON value
+    json j = R"({"compact": true, "schema": false})"_json;
+
+    // serialize it to BJData
+    std::vector<std::uint8_t> v = json::to_bjdata(j);
+
+    // print the vector content
+    for (auto& byte : v)
+    {
+        print_byte(byte);
+    }
+    std::cout << std::endl;
+
+    // create an array of numbers
+    json array = {1, 2, 3, 4, 5, 6, 7, 8};
+
+    // serialize it to BJData using default representation
+    std::vector<std::uint8_t> v_array = json::to_bjdata(array);
+    // serialize it to BJData using size optimization
+    std::vector<std::uint8_t> v_array_size = json::to_bjdata(array, true);
+    // serialize it to BJData using type optimization
+    std::vector<std::uint8_t> v_array_size_and_type = json::to_bjdata(array, true, true);
+
+    // print the vector contents
+    for (auto& byte : v_array)
+    {
+        print_byte(byte);
+    }
+    std::cout << std::endl;
+
+    for (auto& byte : v_array_size)
+    {
+        print_byte(byte);
+    }
+    std::cout << std::endl;
+
+    for (auto& byte : v_array_size_and_type)
+    {
+        print_byte(byte);
+    }
+    std::cout << std::endl;
+}
diff --git a/docs/examples/to_bjdata.output b/docs/examples/to_bjdata.output
new file mode 100644
index 000000000..087980cb9
--- /dev/null
+++ b/docs/examples/to_bjdata.output
@@ -0,0 +1,4 @@
+{i7compactTi6schemaF}
+[i1i2i3i4i5i6i7i8]
+[#i8i1i2i3i4i5i6i7i8
+[$i#i812345678
diff --git a/docs/mkdocs/docs/api/basic_json/at.md b/docs/mkdocs/docs/api/basic_json/at.md
index dbd4cb6c9..3eea8dd15 100644
--- a/docs/mkdocs/docs/api/basic_json/at.md
+++ b/docs/mkdocs/docs/api/basic_json/at.md
@@ -184,6 +184,7 @@ Strong exception safety: if an exception occurs, the original value stays intact
 
 ## See also
 
+- documentation on [checked access](../../features/element_access/checked_access.md)
 - see [`operator[]`](operator%5B%5D.md) for unchecked access by reference
 - see [`value`](value.md) for access with default value
 
diff --git a/docs/mkdocs/docs/api/basic_json/basic_json.md b/docs/mkdocs/docs/api/basic_json/basic_json.md
index 9a289d6e9..365cd7c22 100644
--- a/docs/mkdocs/docs/api/basic_json/basic_json.md
+++ b/docs/mkdocs/docs/api/basic_json/basic_json.md
@@ -241,7 +241,7 @@ basic_json(basic_json&& other) noexcept;
 
 - Overload 5:
 
-    !!! note
+    !!! note "Empty initializer list"
 
         When used without parentheses around an empty initializer list, `basic_json()` is called instead of this
         function, yielding the JSON `#!json null` value.
diff --git a/docs/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md b/docs/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md
index 6622d8aca..e19c3edd9 100644
--- a/docs/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md
+++ b/docs/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md
@@ -20,6 +20,23 @@ ignore
 store
 :   store tagged values as binary container with subtype (for bytes 0xd8..0xdb)
 
+## Examples
+
+??? example
+
+    The example below shows how the different values of the `cbor_tag_handler_t` influence the behavior of
+    [`from_cbor`](from_cbor.md) when reading a tagged byte string.
+
+    ```cpp
+    --8<-- "examples/cbor_tag_handler_t.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/cbor_tag_handler_t.output"
+    ```
+
 ## Version history
 
 - Added in version 3.9.0. Added value `store` in 3.10.0.
diff --git a/docs/mkdocs/docs/api/basic_json/contains.md b/docs/mkdocs/docs/api/basic_json/contains.md
index 67a5ffcc0..e6d9df85c 100644
--- a/docs/mkdocs/docs/api/basic_json/contains.md
+++ b/docs/mkdocs/docs/api/basic_json/contains.md
@@ -60,8 +60,8 @@ Logarithmic in the size of the JSON object.
 
 ## Notes
 
-1. This method always returns `#!cpp false` when executed on a JSON type that is not an object.
-2. This method can be executed on any JSON value type.
+- This method always returns `#!cpp false` when executed on a JSON type that is not an object.
+- This method can be executed on any JSON value type.
 
 !!! info "Postconditions"
 
diff --git a/docs/mkdocs/docs/api/basic_json/default_object_comparator_t.md b/docs/mkdocs/docs/api/basic_json/default_object_comparator_t.md
index 9e5f6c5bd..8a237f662 100644
--- a/docs/mkdocs/docs/api/basic_json/default_object_comparator_t.md
+++ b/docs/mkdocs/docs/api/basic_json/default_object_comparator_t.md
@@ -14,6 +14,22 @@ when looking up a key in an object.
 The actual comparator used depends on [`object_t`](object_t.md) and can be obtained via
 [`object_comparator_t`](object_comparator_t.md).
 
+## Examples
+
+??? example
+
+    The example below demonstrates the default comparator.
+
+    ```cpp
+    --8<-- "examples/default_object_comparator_t.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/default_object_comparator_t.output"
+    ```
+
 ## Version history
 
 - Added in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/basic_json/error_handler_t.md b/docs/mkdocs/docs/api/basic_json/error_handler_t.md
index afd20f89d..dc32ced9b 100644
--- a/docs/mkdocs/docs/api/basic_json/error_handler_t.md
+++ b/docs/mkdocs/docs/api/basic_json/error_handler_t.md
@@ -20,6 +20,23 @@ replace
 ignore
 :   ignore invalid UTF-8 sequences; all bytes are copied to the output unchanged
 
+## Examples
+
+??? example
+
+    The example below shows how the different values of the `error_handler_t` influence the behavior of
+    [`dump`](dump.md) when reading serializing an invalid UTF-8 sequence.
+
+    ```cpp
+    --8<-- "examples/error_handler_t.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/error_handler_t.output"
+    ```
+
 ## Version history
 
 - Added in version 3.4.0.
diff --git a/docs/mkdocs/docs/api/basic_json/from_bjdata.md b/docs/mkdocs/docs/api/basic_json/from_bjdata.md
new file mode 100644
index 000000000..3c5eeb351
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/from_bjdata.md
@@ -0,0 +1,93 @@
+# <small>nlohmann::basic_json::</small>from_bjdata
+
+```cpp
+// (1)
+template<typename InputType>
+static basic_json from_bjdata(InputType&& i,
+                              const bool strict = true,
+                              const bool allow_exceptions = true);
+// (2)
+template<typename IteratorType>
+static basic_json from_bjdata(IteratorType first, IteratorType last,
+                              const bool strict = true,
+                              const bool allow_exceptions = true);
+```
+
+Deserializes a given input to a JSON value using the BJData (Binary JData) serialization format.
+
+1. Reads from a compatible input.
+2. Reads from an iterator range.
+
+The exact mapping and its limitations is described on a [dedicated page](../../features/binary_formats/bjdata.md).
+
+## Template parameters
+
+`InputType`
+:   A compatible input, for instance:
+
+    - an `std::istream` object
+    - a `FILE` pointer
+    - a C-style array of characters
+    - a pointer to a null-terminated string of single byte characters
+    - an object `obj` for which `begin(obj)` and `end(obj)` produces a valid pair of iterators.
+
+`IteratorType`
+:   a compatible iterator type
+
+## Parameters
+
+`i` (in)
+:   an input in BJData format convertible to an input adapter
+
+`first` (in)
+:   iterator to start of the input
+
+`last` (in)
+:   iterator to end of the input
+
+`strict` (in)
+:   whether to expect the input to be consumed until EOF (`#!cpp true` by default)
+
+`allow_exceptions` (in)
+:   whether to throw exceptions in case of a parse error (optional, `#!cpp true` by default)
+
+## Return value
+
+deserialized JSON value; in case of a parse error and `allow_exceptions` set to `#!cpp false`, the return value will be
+`value_t::discarded`. The latter can be checked with [`is_discarded`](is_discarded.md).
+
+## Exception safety
+
+Strong guarantee: if an exception is thrown, there are no changes in the JSON value.
+
+## Exceptions
+
+- Throws [parse_error.110](../../home/exceptions.md#jsonexceptionparse_error110) if the given input ends prematurely or
+  the end of file was not reached when `strict` was set to true
+- Throws [parse_error.112](../../home/exceptions.md#jsonexceptionparse_error112) if a parse error occurs
+- Throws [parse_error.113](../../home/exceptions.md#jsonexceptionparse_error113) if a string could not be parsed
+  successfully
+
+## Complexity
+
+Linear in the size of the input.
+
+## Examples
+
+??? example
+
+    The example shows the deserialization of a byte vector in BJData format to a JSON value.
+     
+    ```cpp
+    --8<-- "examples/from_bjdata.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/from_bjdata.output"
+    ```
+
+## Version history
+
+- Added in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/basic_json/get_allocator.md b/docs/mkdocs/docs/api/basic_json/get_allocator.md
index 1b7700c77..07a4d8456 100644
--- a/docs/mkdocs/docs/api/basic_json/get_allocator.md
+++ b/docs/mkdocs/docs/api/basic_json/get_allocator.md
@@ -10,10 +10,22 @@ Returns the allocator associated with the container.
 
 associated allocator
 
+## Examples
+
+??? example
+
+    The example shows how `get_allocator()` is used to created `json` values.
+    
+    ```cpp
+    --8<-- "examples/get_allocator.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/get_allocator.output"
+    ```
+
 ## Version history
 
-- Unknown.
-
-!!! note
-
-    This documentation page is a stub.
+- Added in version 1.0.0.
diff --git a/docs/mkdocs/docs/api/basic_json/index.md b/docs/mkdocs/docs/api/basic_json/index.md
index 68ac063ff..bc4dba153 100644
--- a/docs/mkdocs/docs/api/basic_json/index.md
+++ b/docs/mkdocs/docs/api/basic_json/index.md
@@ -268,10 +268,12 @@ Access to the JSON value
 
 ### Binary formats
 
+- [**from_bjdata**](from_bjdata.md) (_static_) - create a JSON value from an input in BJData format
 - [**from_bson**](from_bson.md) (_static_) - create a JSON value from an input in BSON format
 - [**from_cbor**](from_cbor.md) (_static_) - create a JSON value from an input in CBOR format
 - [**from_msgpack**](from_msgpack.md) (_static_) - create a JSON value from an input in MessagePack format
 - [**from_ubjson**](from_ubjson.md) (_static_) - create a JSON value from an input in UBJSON format
+- [**to_bjdata**](to_bjdata.md) (_static_) - create a BJData serialization of a given JSON value
 - [**to_bson**](to_bson.md) (_static_) - create a BSON serialization of a given JSON value
 - [**to_cbor**](to_cbor.md) (_static_) - create a CBOR serialization of a given JSON value
 - [**to_msgpack**](to_msgpack.md) (_static_) - create a MessagePack serialization of a given JSON value
diff --git a/docs/mkdocs/docs/api/basic_json/input_format_t.md b/docs/mkdocs/docs/api/basic_json/input_format_t.md
index 4accf6dee..a3baabab8 100644
--- a/docs/mkdocs/docs/api/basic_json/input_format_t.md
+++ b/docs/mkdocs/docs/api/basic_json/input_format_t.md
@@ -6,7 +6,8 @@ enum class input_format_t {
     cbor,
     msgpack,
     ubjson,
-    bson
+    bson,
+    bjdata
 };
 ```
 
@@ -27,6 +28,25 @@ ubjson
 bson
 :   BSON (Binary JSON)
 
+bjdata
+:   BJData (Binary JData)
+
+## Examples
+
+??? example
+
+    The example below shows how an `input_format_t` enum value is passed to `sax_parse` to set the input format to CBOR.
+
+    ```cpp
+    --8<-- "examples/sax_parse__binary.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/sax_parse__binary.output"
+    ```
+
 ## Version history
 
 - Added in version 3.2.0.
diff --git a/docs/mkdocs/docs/api/basic_json/object_comparator_t.md b/docs/mkdocs/docs/api/basic_json/object_comparator_t.md
index 6c64b6453..496a56267 100644
--- a/docs/mkdocs/docs/api/basic_json/object_comparator_t.md
+++ b/docs/mkdocs/docs/api/basic_json/object_comparator_t.md
@@ -1,6 +1,5 @@
 # <small>nlohmann::basic_json::</small>object_comparator_t
 
-
 ```cpp
 using object_comparator_t = typename object_t::key_compare;
 // or
@@ -10,6 +9,22 @@ using object_comparator_t = default_object_comparator_t;
 The comparator used by [`object_t`](object_t.md). Defined as `#!cpp typename object_t::key_compare` if available,
 and [`default_object_comparator_t`](default_object_comparator_t.md) otherwise.
 
+## Examples
+
+??? example
+
+    The example below demonstrates the used object comparator.
+
+    ```cpp
+    --8<-- "examples/object_comparator_t.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/object_comparator_t.output"
+    ```
+
 ## Version history
 
 - Added in version 3.0.0.
diff --git a/docs/mkdocs/docs/api/basic_json/operator+=.md b/docs/mkdocs/docs/api/basic_json/operator+=.md
index 074b30003..dc5f2ecc4 100644
--- a/docs/mkdocs/docs/api/basic_json/operator+=.md
+++ b/docs/mkdocs/docs/api/basic_json/operator+=.md
@@ -41,12 +41,9 @@ reference operator+=(initializer_list_t init);
 
 ## Exceptions
 
-1. The function can throw the following exceptions:
-    - Throws [`type_error.308`](../../home/exceptions.md#jsonexceptiontype_error308) when called on a type other than
-      JSON array or null; example: `"cannot use operator+=() with number"`
-2. The function can throw the following exceptions:
-    - Throws [`type_error.308`](../../home/exceptions.md#jsonexceptiontype_error308) when called on a type other than
-      JSON object or null; example: `"cannot use operator+=() with number"`
+All functions can throw the following exception:
+  - Throws [`type_error.308`](../../home/exceptions.md#jsonexceptiontype_error308) when called on a type other than
+    JSON array or null; example: `"cannot use operator+=() with number"`
 
 ## Complexity
 
diff --git a/docs/mkdocs/docs/api/basic_json/operator[].md b/docs/mkdocs/docs/api/basic_json/operator[].md
index cd5638b97..9fa0c8999 100644
--- a/docs/mkdocs/docs/api/basic_json/operator[].md
+++ b/docs/mkdocs/docs/api/basic_json/operator[].md
@@ -198,6 +198,8 @@ Strong exception safety: if an exception occurs, the original value stays intact
 
 ## See also
 
+- documentation on [unchecked access](../../features/element_access/unchecked_access.md)
+- documentation on [runtime assertions](../../features/assertions.md)
 - see [`at`](at.md) for access by reference with range checking
 - see [`value`](value.md) for access with default value
 
diff --git a/docs/mkdocs/docs/api/basic_json/operator_ValueType.md b/docs/mkdocs/docs/api/basic_json/operator_ValueType.md
index 787588781..7c1901668 100644
--- a/docs/mkdocs/docs/api/basic_json/operator_ValueType.md
+++ b/docs/mkdocs/docs/api/basic_json/operator_ValueType.md
@@ -56,7 +56,6 @@ Linear in the size of the JSON value.
     [`JSON_USE_IMPLICIT_CONVERSIONS`](../macros/json_use_implicit_conversions.md) to `0` and replace any implicit
     conversions with calls to [`get`](../basic_json/get.md).
 
-
 ## Examples
 
 ??? example
diff --git a/docs/mkdocs/docs/api/basic_json/operator_eq.md b/docs/mkdocs/docs/api/basic_json/operator_eq.md
index 49f96b1c0..3eec4fda4 100644
--- a/docs/mkdocs/docs/api/basic_json/operator_eq.md
+++ b/docs/mkdocs/docs/api/basic_json/operator_eq.md
@@ -44,13 +44,13 @@ Linear.
 
 ## Notes
 
-!!! note
+!!! note "Comparing special values"
 
     - NaN values never compare equal to themselves or to other NaN values.
     - JSON `#!cpp null` values are all equal.
     - Discarded values never compare equal to themselves.
 
-!!! note
+!!! note "Comparing floating-point numbers"
 
     Floating-point numbers inside JSON values numbers are compared with `json::number_float_t::operator==` which is
     `double::operator==` by default. To compare floating-point while respecting an epsilon, an alternative
diff --git a/docs/mkdocs/docs/api/basic_json/push_back.md b/docs/mkdocs/docs/api/basic_json/push_back.md
index 60bfed305..5c7d20dd6 100644
--- a/docs/mkdocs/docs/api/basic_json/push_back.md
+++ b/docs/mkdocs/docs/api/basic_json/push_back.md
@@ -37,12 +37,9 @@ void push_back(initializer_list_t init);
 
 ## Exceptions
 
-1. The function can throw the following exceptions:
-    - Throws [`type_error.308`](../../home/exceptions.md#jsonexceptiontype_error308) when called on a type other than
-      JSON array or null; example: `"cannot use push_back() with number"`
-2. The function can throw the following exceptions:
-    - Throws [`type_error.308`](../../home/exceptions.md#jsonexceptiontype_error308) when called on a type other than
-      JSON object or null; example: `"cannot use push_back() with number"`
+All functions can throw the following exception:
+  - Throws [`type_error.308`](../../home/exceptions.md#jsonexceptiontype_error308) when called on a type other than
+    JSON array or null; example: `"cannot use push_back() with number"`
 
 ## Complexity
 
diff --git a/docs/mkdocs/docs/api/basic_json/to_bjdata.md b/docs/mkdocs/docs/api/basic_json/to_bjdata.md
new file mode 100644
index 000000000..1ea850523
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/to_bjdata.md
@@ -0,0 +1,70 @@
+# <small>nlohmann::basic_json::</small>to_bjdata
+
+```cpp
+// (1)
+static std::vector<std::uint8_t> to_bjdata(const basic_json& j,
+                                           const bool use_size = false,
+                                           const bool use_type = false);
+
+// (2)
+static void to_bjdata(const basic_json& j, detail::output_adapter<std::uint8_t> o,
+                      const bool use_size = false, const bool use_type = false);
+static void to_bjdata(const basic_json& j, detail::output_adapter<char> o,
+                      const bool use_size = false, const bool use_type = false);
+```
+
+Serializes a given JSON value `j` to a byte vector using the BJData (Binary JData) serialization format. BJData
+aims to be more compact than JSON itself, yet more efficient to parse.
+
+1. Returns a byte vector containing the BJData serialization.
+2. Writes the BJData serialization to an output adapter.
+
+The exact mapping and its limitations is described on a [dedicated page](../../features/binary_formats/bjdata.md).
+
+## Parameters
+
+`j` (in)
+:   JSON value to serialize
+
+`o` (in)
+:   output adapter to write serialization to
+
+`use_size` (in)
+:   whether to add size annotations to container types; optional, `#!cpp false` by default.
+
+`use_type` (in)
+:   whether to add type annotations to container types (must be combined with `#!cpp use_size = true`); optional,
+`#!cpp false` by default.
+
+## Return value
+
+1. BJData serialization as byte vector
+2. (none)
+
+## Exception safety
+
+Strong guarantee: if an exception is thrown, there are no changes in the JSON value.
+
+## Complexity
+
+Linear in the size of the JSON value `j`.
+
+## Examples
+
+??? example
+
+    The example shows the serialization of a JSON value to a byte vector in BJData format.
+     
+    ```cpp
+    --8<-- "examples/to_bjdata.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/to_bjdata.output"
+    ```
+
+## Version history
+
+- Added in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/basic_json/value_t.md b/docs/mkdocs/docs/api/basic_json/value_t.md
index 768b13ca1..e7d32c480 100644
--- a/docs/mkdocs/docs/api/basic_json/value_t.md
+++ b/docs/mkdocs/docs/api/basic_json/value_t.md
@@ -29,6 +29,22 @@ distinguishes these three types for numbers: [`number_unsigned_t`](number_unsign
 [`number_integer_t`](number_integer_t.md) is used for signed integers, and [`number_float_t`](number_float_t.md) is used
 for floating-point numbers or to approximate integers which do not fit in the limits of their respective type.
 
+## Examples
+
+??? example
+
+    The following code how `type()` queries the `value_t` for all JSON types.
+    
+    ```cpp
+    --8<-- "examples/type.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/type.output"
+    ```
+
 ## Version history
 
 - Added in version 1.0.0.
diff --git a/docs/mkdocs/docs/api/byte_container_with_subtype/byte_container_with_subtype.md b/docs/mkdocs/docs/api/byte_container_with_subtype/byte_container_with_subtype.md
index caa273df5..9913a9b5c 100644
--- a/docs/mkdocs/docs/api/byte_container_with_subtype/byte_container_with_subtype.md
+++ b/docs/mkdocs/docs/api/byte_container_with_subtype/byte_container_with_subtype.md
@@ -25,6 +25,22 @@ byte_container_with_subtype(container_type&& container, subtype_type subtype);
 `subtype` (in)
 :   subtype
 
+## Examples
+
+??? example
+
+    The example below demonstrates how byte containers can be created.
+
+    ```cpp
+    --8<-- "examples/byte_container_with_subtype__byte_container_with_subtype.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/byte_container_with_subtype__byte_container_with_subtype.output"
+    ```
+
 ## Version history
 
 Since version 3.8.0.
diff --git a/docs/mkdocs/docs/api/byte_container_with_subtype/clear_subtype.md b/docs/mkdocs/docs/api/byte_container_with_subtype/clear_subtype.md
index 56f8ee0c1..c62dead36 100644
--- a/docs/mkdocs/docs/api/byte_container_with_subtype/clear_subtype.md
+++ b/docs/mkdocs/docs/api/byte_container_with_subtype/clear_subtype.md
@@ -15,6 +15,22 @@ No-throw guarantee: this function never throws exceptions.
 
 Constant.
 
+## Examples
+
+??? example
+
+    The example below demonstrates how `clear_subtype` can remove subtypes.
+
+    ```cpp
+    --8<-- "examples/byte_container_with_subtype__clear_subtype.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/byte_container_with_subtype__clear_subtype.output"
+    ```
+
 ## Version history
 
 Since version 3.8.0.
diff --git a/docs/mkdocs/docs/api/byte_container_with_subtype/has_subtype.md b/docs/mkdocs/docs/api/byte_container_with_subtype/has_subtype.md
index 2fe418132..e06286e29 100644
--- a/docs/mkdocs/docs/api/byte_container_with_subtype/has_subtype.md
+++ b/docs/mkdocs/docs/api/byte_container_with_subtype/has_subtype.md
@@ -18,6 +18,22 @@ No-throw guarantee: this function never throws exceptions.
 
 Constant.
 
+## Examples
+
+??? example
+
+    The example below demonstrates how `has_subtype` can check whether a subtype was set.
+
+    ```cpp
+    --8<-- "examples/byte_container_with_subtype__has_subtype.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/byte_container_with_subtype__has_subtype.output"
+    ```
+
 ## Version history
 
 Since version 3.8.0.
diff --git a/docs/mkdocs/docs/api/byte_container_with_subtype/set_subtype.md b/docs/mkdocs/docs/api/byte_container_with_subtype/set_subtype.md
index 40cc2722f..cf21732b8 100644
--- a/docs/mkdocs/docs/api/byte_container_with_subtype/set_subtype.md
+++ b/docs/mkdocs/docs/api/byte_container_with_subtype/set_subtype.md
@@ -20,6 +20,22 @@ No-throw guarantee: this function never throws exceptions.
 
 Constant.
 
+## Examples
+
+??? example
+
+    The example below demonstrates how a subtype can be set with `set_subtype`.
+
+    ```cpp
+    --8<-- "examples/byte_container_with_subtype__set_subtype.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/byte_container_with_subtype__set_subtype.output"
+    ```
+
 ## Version history
 
 Since version 3.8.0.
diff --git a/docs/mkdocs/docs/api/byte_container_with_subtype/subtype.md b/docs/mkdocs/docs/api/byte_container_with_subtype/subtype.md
index e78654b37..389241a79 100644
--- a/docs/mkdocs/docs/api/byte_container_with_subtype/subtype.md
+++ b/docs/mkdocs/docs/api/byte_container_with_subtype/subtype.md
@@ -19,6 +19,23 @@ No-throw guarantee: this function never throws exceptions.
 
 Constant.
 
+## Examples
+
+??? example
+
+    The example below demonstrates how the subtype can be retrieved with `subtype`. Note how `subtype_type(-1)` is
+    returned for container `c1`.
+
+    ```cpp
+    --8<-- "examples/byte_container_with_subtype__subtype.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/byte_container_with_subtype__subtype.output"
+    ```
+
 ## Version history
 
 - Added in version 3.8.0
diff --git a/docs/mkdocs/docs/api/json.md b/docs/mkdocs/docs/api/json.md
index 48d344183..36edcc2c1 100644
--- a/docs/mkdocs/docs/api/json.md
+++ b/docs/mkdocs/docs/api/json.md
@@ -7,6 +7,22 @@ using json = basic_json<>;
 This type is the default specialization of the [basic_json](basic_json/index.md) class which uses the standard template
 types.
 
+## Examples
+
+??? example
+
+    The example below demonstrates how to use the type `nlohmann::json`.
+
+    ```cpp
+    --8<-- "examples/README.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/README.output"
+    ```
+
 ## Version history
 
 Since version 1.0.0.
diff --git a/docs/mkdocs/docs/api/json_pointer/index.md b/docs/mkdocs/docs/api/json_pointer/index.md
index dca9c382c..dc07d89b3 100644
--- a/docs/mkdocs/docs/api/json_pointer/index.md
+++ b/docs/mkdocs/docs/api/json_pointer/index.md
@@ -14,11 +14,11 @@ are the base for JSON patches.
 `RefStringType`
 :   the string type used for the reference tokens making up the JSON pointer
 
-## Notes
+!!! warning "Deprecation"
 
-For backwards compatibility `RefStringType` may also be a specialization of [`basic_json`](../basic_json/index.md) in
-which case `string_t` will be deduced as [`basic_json::string_t`](../basic_json/string_t.md). This feature is deprecated
-and may be removed in a future major version.
+    For backwards compatibility `RefStringType` may also be a specialization of [`basic_json`](../basic_json/index.md)
+    in which case `string_t` will be deduced as [`basic_json::string_t`](../basic_json/string_t.md). This feature is
+    deprecated and may be removed in a future major version.
 
 ## Member types
 
diff --git a/docs/mkdocs/docs/api/json_pointer/operator_string.md b/docs/mkdocs/docs/api/json_pointer/operator_string.md
index 836728c18..f2f99cae7 100644
--- a/docs/mkdocs/docs/api/json_pointer/operator_string.md
+++ b/docs/mkdocs/docs/api/json_pointer/operator_string.md
@@ -19,6 +19,22 @@ operator string_t() const
 }
 ```
 
+## Examples
+
+??? example
+
+    The example shows how JSON Pointers can be implicitly converted to strings.
+     
+    ```cpp
+    --8<-- "examples/json_pointer__operator_string.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/json_pointer__operator_string.output"
+    ```
+
 ## Version history
 
 - Since version 2.0.0.
diff --git a/docs/mkdocs/docs/api/json_pointer/string_t.md b/docs/mkdocs/docs/api/json_pointer/string_t.md
index f18b51b81..c8527bc9c 100644
--- a/docs/mkdocs/docs/api/json_pointer/string_t.md
+++ b/docs/mkdocs/docs/api/json_pointer/string_t.md
@@ -7,6 +7,22 @@ The string type used for the reference tokens making up the JSON pointer.
 
 See [`basic_json::string_t`](../basic_json/string_t.md) for more information.
 
+## Examples
+
+??? example
+
+    The example shows the type `string_t` and its relation to `basic_json::string_t`.
+     
+    ```cpp
+    --8<-- "examples/json_pointer__string_t.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/json_pointer__string_t.output"
+    ```
+
 ## Version history
 
 - Added in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/json_sax/binary.md b/docs/mkdocs/docs/api/json_sax/binary.md
index e9a1d3974..753e99c00 100644
--- a/docs/mkdocs/docs/api/json_sax/binary.md
+++ b/docs/mkdocs/docs/api/json_sax/binary.md
@@ -19,6 +19,22 @@ Whether parsing should proceed.
 
 It is safe to move the passed binary value.
 
+## Examples
+
+??? example
+
+    .The example below shows how the SAX interface is used.
+
+    ```cpp
+    --8<-- "examples/sax_parse__binary.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/sax_parse__binary.output"
+    ```
+
 ## Version history
 
 - Added in version 3.8.0.
diff --git a/docs/mkdocs/docs/api/json_sax/boolean.md b/docs/mkdocs/docs/api/json_sax/boolean.md
index a5a8ddcb7..78163b331 100644
--- a/docs/mkdocs/docs/api/json_sax/boolean.md
+++ b/docs/mkdocs/docs/api/json_sax/boolean.md
@@ -15,6 +15,22 @@ A boolean value was read.
 
 Whether parsing should proceed.
 
+## Examples
+
+??? example
+
+    .The example below shows how the SAX interface is used.
+
+    ```cpp
+    --8<-- "examples/sax_parse.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/sax_parse.output"
+    ```
+
 ## Version history
 
 - Added in version 3.2.0.
diff --git a/docs/mkdocs/docs/api/json_sax/end_array.md b/docs/mkdocs/docs/api/json_sax/end_array.md
index 245cf974c..46b4c7a4b 100644
--- a/docs/mkdocs/docs/api/json_sax/end_array.md
+++ b/docs/mkdocs/docs/api/json_sax/end_array.md
@@ -10,6 +10,22 @@ The end of an array was read.
 
 Whether parsing should proceed.
 
+## Examples
+
+??? example
+
+    .The example below shows how the SAX interface is used.
+
+    ```cpp
+    --8<-- "examples/sax_parse.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/sax_parse.output"
+    ```
+
 ## Version history
 
 - Added in version 3.2.0.
diff --git a/docs/mkdocs/docs/api/json_sax/end_object.md b/docs/mkdocs/docs/api/json_sax/end_object.md
index 5654e262e..8df0ab4e1 100644
--- a/docs/mkdocs/docs/api/json_sax/end_object.md
+++ b/docs/mkdocs/docs/api/json_sax/end_object.md
@@ -10,6 +10,22 @@ The end of an object was read.
 
 Whether parsing should proceed.
 
+## Examples
+
+??? example
+
+    .The example below shows how the SAX interface is used.
+
+    ```cpp
+    --8<-- "examples/sax_parse.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/sax_parse.output"
+    ```
+
 ## Version history
 
 - Added in version 3.2.0.
diff --git a/docs/mkdocs/docs/api/json_sax/key.md b/docs/mkdocs/docs/api/json_sax/key.md
index 5e7927256..ebd3ae2b2 100644
--- a/docs/mkdocs/docs/api/json_sax/key.md
+++ b/docs/mkdocs/docs/api/json_sax/key.md
@@ -19,6 +19,22 @@ Whether parsing should proceed.
 
 It is safe to move the passed object key value.
 
+## Examples
+
+??? example
+
+    .The example below shows how the SAX interface is used.
+
+    ```cpp
+    --8<-- "examples/sax_parse.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/sax_parse.output"
+    ```
+
 ## Version history
 
 - Added in version 3.2.0.
diff --git a/docs/mkdocs/docs/api/json_sax/null.md b/docs/mkdocs/docs/api/json_sax/null.md
index bcbb4a348..71b2a458a 100644
--- a/docs/mkdocs/docs/api/json_sax/null.md
+++ b/docs/mkdocs/docs/api/json_sax/null.md
@@ -10,6 +10,22 @@ A null value was read.
 
 Whether parsing should proceed.
 
+## Examples
+
+??? example
+
+    .The example below shows how the SAX interface is used.
+
+    ```cpp
+    --8<-- "examples/sax_parse.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/sax_parse.output"
+    ```
+
 ## Version history
 
 - Added in version 3.2.0.
diff --git a/docs/mkdocs/docs/api/json_sax/number_float.md b/docs/mkdocs/docs/api/json_sax/number_float.md
index 94193280b..e1b3fb60f 100644
--- a/docs/mkdocs/docs/api/json_sax/number_float.md
+++ b/docs/mkdocs/docs/api/json_sax/number_float.md
@@ -18,6 +18,22 @@ A floating-point number was read.
 
 Whether parsing should proceed.
 
+## Examples
+
+??? example
+
+    .The example below shows how the SAX interface is used.
+
+    ```cpp
+    --8<-- "examples/sax_parse.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/sax_parse.output"
+    ```
+
 ## Version history
 
 - Added in version 3.2.0.
diff --git a/docs/mkdocs/docs/api/json_sax/number_integer.md b/docs/mkdocs/docs/api/json_sax/number_integer.md
index 00ff2eaa6..8628a655c 100644
--- a/docs/mkdocs/docs/api/json_sax/number_integer.md
+++ b/docs/mkdocs/docs/api/json_sax/number_integer.md
@@ -15,6 +15,22 @@ An integer number was read.
 
 Whether parsing should proceed.
 
+## Examples
+
+??? example
+
+    .The example below shows how the SAX interface is used.
+
+    ```cpp
+    --8<-- "examples/sax_parse.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/sax_parse.output"
+    ```
+
 ## Version history
 
 - Added in version 3.2.0.
diff --git a/docs/mkdocs/docs/api/json_sax/number_unsigned.md b/docs/mkdocs/docs/api/json_sax/number_unsigned.md
index 66d0bdac4..7b5974823 100644
--- a/docs/mkdocs/docs/api/json_sax/number_unsigned.md
+++ b/docs/mkdocs/docs/api/json_sax/number_unsigned.md
@@ -15,6 +15,22 @@ An unsigned integer number was read.
 
 Whether parsing should proceed.
 
+## Examples
+
+??? example
+
+    .The example below shows how the SAX interface is used.
+
+    ```cpp
+    --8<-- "examples/sax_parse.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/sax_parse.output"
+    ```
+
 ## Version history
 
 - Added in version 3.2.0.
diff --git a/docs/mkdocs/docs/api/json_sax/parse_error.md b/docs/mkdocs/docs/api/json_sax/parse_error.md
index 00f1aa950..d4405d09e 100644
--- a/docs/mkdocs/docs/api/json_sax/parse_error.md
+++ b/docs/mkdocs/docs/api/json_sax/parse_error.md
@@ -23,6 +23,22 @@ A parse error occurred.
 
 Whether parsing should proceed (**must return `#!cpp false`**).
 
+## Examples
+
+??? example
+
+    .The example below shows how the SAX interface is used.
+
+    ```cpp
+    --8<-- "examples/sax_parse.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/sax_parse.output"
+    ```
+
 ## Version history
 
 - Added in version 3.2.0.
diff --git a/docs/mkdocs/docs/api/json_sax/start_array.md b/docs/mkdocs/docs/api/json_sax/start_array.md
index d10a6e5a6..8ef10a4ab 100644
--- a/docs/mkdocs/docs/api/json_sax/start_array.md
+++ b/docs/mkdocs/docs/api/json_sax/start_array.md
@@ -19,6 +19,22 @@ Whether parsing should proceed.
 
 Binary formats may report the number of elements.
 
+## Examples
+
+??? example
+
+    .The example below shows how the SAX interface is used.
+
+    ```cpp
+    --8<-- "examples/sax_parse.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/sax_parse.output"
+    ```
+
 ## Version history
 
 - Added in version 3.2.0.
diff --git a/docs/mkdocs/docs/api/json_sax/start_object.md b/docs/mkdocs/docs/api/json_sax/start_object.md
index fd90f1947..24fedffc3 100644
--- a/docs/mkdocs/docs/api/json_sax/start_object.md
+++ b/docs/mkdocs/docs/api/json_sax/start_object.md
@@ -19,6 +19,22 @@ Whether parsing should proceed.
 
 Binary formats may report the number of elements.
 
+## Examples
+
+??? example
+
+    .The example below shows how the SAX interface is used.
+
+    ```cpp
+    --8<-- "examples/sax_parse.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/sax_parse.output"
+    ```
+
 ## Version history
 
 - Added in version 3.2.0.
diff --git a/docs/mkdocs/docs/api/json_sax/string.md b/docs/mkdocs/docs/api/json_sax/string.md
index 113fe1393..1cb6014ac 100644
--- a/docs/mkdocs/docs/api/json_sax/string.md
+++ b/docs/mkdocs/docs/api/json_sax/string.md
@@ -19,6 +19,22 @@ Whether parsing should proceed.
 
 It is safe to move the passed string value.
 
+## Examples
+
+??? example
+
+    .The example below shows how the SAX interface is used.
+
+    ```cpp
+    --8<-- "examples/sax_parse.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/sax_parse.output"
+    ```
+
 ## Version history
 
 - Added in version 3.2.0.
diff --git a/docs/mkdocs/docs/api/macros/json_has_cpp_11.md b/docs/mkdocs/docs/api/macros/json_has_cpp_11.md
index 3bee84324..f3eaa585c 100644
--- a/docs/mkdocs/docs/api/macros/json_has_cpp_11.md
+++ b/docs/mkdocs/docs/api/macros/json_has_cpp_11.md
@@ -23,6 +23,19 @@ The default value is detected based on preprocessor macros such as `#!cpp __cplu
 - `#!cpp JSON_HAS_CPP_11` is always defined.
 - All macros are undefined outside the library.
 
+## Examples
+
+??? example
+
+    The code below forces the library to use the C++14 standard:
+
+    ```cpp
+    #define JSON_HAS_CPP_14 1
+    #include <nlohmann/json.hpp>
+
+    ...
+    ```
+
 ## Version history
 
 - Added in version 3.10.5.
diff --git a/docs/mkdocs/docs/api/macros/json_has_filesystem.md b/docs/mkdocs/docs/api/macros/json_has_filesystem.md
index 160ad8c24..308aea2ac 100644
--- a/docs/mkdocs/docs/api/macros/json_has_filesystem.md
+++ b/docs/mkdocs/docs/api/macros/json_has_filesystem.md
@@ -25,6 +25,19 @@ The default value is detected based on the preprocessor macros `#!cpp __cpp_lib_
   filesystem support.
 - Both macros are undefined outside the library.
 
+## Examples
+
+??? example
+
+    The code below forces the library to use the header `<experimental/filesystem>`.
+
+    ```cpp
+    #define JSON_HAS_EXPERIMENTAL_FILESYSTEM 1
+    #include <nlohmann/json.hpp>
+
+    ...
+    ```
+
 ## Version history
 
 - Added in version 3.10.5.
diff --git a/docs/mkdocs/docs/api/macros/json_no_io.md b/docs/mkdocs/docs/api/macros/json_no_io.md
index 10ae24c8a..ef37384a5 100644
--- a/docs/mkdocs/docs/api/macros/json_no_io.md
+++ b/docs/mkdocs/docs/api/macros/json_no_io.md
@@ -16,6 +16,20 @@ By default, `#!cpp JSON_NO_IO` is not defined.
 #undef JSON_NO_IO
 ```
 
+## Examples
+
+??? example
+
+    The code below forces the library not to use the headers `<cstdio>`, `<ios>`, `<iosfwd>`, `<istream>`, and
+    `<ostream>`.
+
+    ```cpp
+    #define JSON_NO_IO 1
+    #include <nlohmann/json.hpp>
+
+    ...
+    ```
+
 ## Version history
 
 - Added in version 3.10.0.
diff --git a/docs/mkdocs/docs/api/macros/json_noexception.md b/docs/mkdocs/docs/api/macros/json_noexception.md
index 0f32b63e9..c801b8567 100644
--- a/docs/mkdocs/docs/api/macros/json_noexception.md
+++ b/docs/mkdocs/docs/api/macros/json_noexception.md
@@ -23,6 +23,19 @@ By default, the macro is not defined.
 The explanatory [`what()`](https://en.cppreference.com/w/cpp/error/exception/what) string of exceptions is not
 available for MSVC if exceptions are disabled, see [#2824](https://github.com/nlohmann/json/discussions/2824).
 
+## Examples
+
+??? example
+
+    The code below switches off exceptions in the library.
+
+    ```cpp
+    #define JSON_NOEXCEPTION 1
+    #include <nlohmann/json.hpp>
+
+    ...
+    ```
+
 ## See also
 
 - [Switch off exceptions](../../home/exceptions.md#switch-off-exceptions) for more information how to switch off exceptions
diff --git a/docs/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md b/docs/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md
index c58d0ea85..374fa4c27 100644
--- a/docs/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md
+++ b/docs/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md
@@ -15,6 +15,19 @@ By default, the macro is not defined.
 #undef JSON_SKIP_UNSUPPORTED_COMPILER_CHECK
 ```
 
+## Examples
+
+??? example
+
+    The code below switches off the check whether the compiler is supported.
+
+    ```cpp
+    #define JSON_SKIP_UNSUPPORTED_COMPILER_CHECK 1
+    #include <nlohmann/json.hpp>
+
+    ...
+    ```
+
 ## Version history
 
 Added in version 3.2.0.
diff --git a/docs/mkdocs/docs/api/macros/nlohmann_json_version_major.md b/docs/mkdocs/docs/api/macros/nlohmann_json_version_major.md
index 826785292..d7a314276 100644
--- a/docs/mkdocs/docs/api/macros/nlohmann_json_version_major.md
+++ b/docs/mkdocs/docs/api/macros/nlohmann_json_version_major.md
@@ -13,6 +13,23 @@ These macros are defined by the library and contain the version numbers accordin
 
 The macros are defined according to the current library version.
 
+## Examples
+
+??? example
+
+    The example below shows how `NLOHMANN_JSON_VERSION_MAJOR`, `NLOHMANN_JSON_VERSION_MINOR`, and
+    `NLOHMANN_JSON_VERSION_PATCH` are defined by the library.
+
+    ```cpp
+    --8<-- "examples/nlohmann_json_version.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/nlohmann_json_version.output"
+    ```
+
 ## See also
 
 - [meta](../basic_json/meta.md) - returns version information on the library
diff --git a/docs/mkdocs/docs/api/ordered_json.md b/docs/mkdocs/docs/api/ordered_json.md
index 8b122f90b..7cfd9f4dd 100644
--- a/docs/mkdocs/docs/api/ordered_json.md
+++ b/docs/mkdocs/docs/api/ordered_json.md
@@ -6,9 +6,26 @@ using ordered_json = basic_json<ordered_map>;
 
 This type preserves the insertion order of object keys.
 
+## Examples
+
+??? example
+
+    The example below demonstrates how `ordered_json` preserves the insertion order of object keys.
+
+    ```cpp
+    --8<-- "examples/ordered_json.cpp"
+    ```
+    
+    Output:
+    
+    ```json
+    --8<-- "examples/ordered_json.output"
+    ```
+
 ## See also
 
 - [ordered_map](ordered_map.md)
+- [Object Order](../features/object_order.md)
 
 ## Version history
 
diff --git a/docs/mkdocs/docs/features/binary_formats/bjdata.md b/docs/mkdocs/docs/features/binary_formats/bjdata.md
new file mode 100644
index 000000000..fae55658f
--- /dev/null
+++ b/docs/mkdocs/docs/features/binary_formats/bjdata.md
@@ -0,0 +1,209 @@
+# BJData
+
+The [BJData format](https://neurojson.org) was derived from and improved upon
+[Universal Binary JSON(UBJSON)](https://ubjson.org) specification (Draft 12).
+Specifically, it introduces an optimized array container for efficient storage
+of N-dimensional packed arrays (**ND-arrays**); it also adds 4 new type markers -
+`[u] - uint16`, `[m] - uint32`, `[M] - uint64` and `[h] - float16` - to
+unambigiously map common binary numeric types; furthermore, it uses little-endian
+(LE) to store all numerics instead of big-endian (BE) as in UBJSON to avoid
+unnecessary conversions on commonly available platforms.
+
+Compared to other binary-JSON-like formats such as MessagePack and CBOR, both BJData and
+UBJSON demonstrate a rare combination of being both binary and **quasi-human-readable**. This
+is because all semantic elements in BJData and UBJSON, including the data-type markers
+and name/string types are directly human-readable. Data stored in the BJData/UBJSON format
+are not only compact in size, fast to read/write, but also can be directly searched
+or read using simple processing.
+
+!!! abstract "References"
+
+	- [BJData Specification](https://neurojson.org/bjdata/draft2)
+
+## Serialization
+
+The library uses the following mapping from JSON values types to BJData types according to the BJData specification:
+
+| JSON value type | value/range                               | BJData type    | marker |
+|-----------------|-------------------------------------------|----------------|--------|
+| null            | `null`                                    | null           | `Z`    |
+| boolean         | `true`                                    | true           | `T`    |
+| boolean         | `false`                                   | false          | `F`    |
+| number_integer  | -9223372036854775808..-2147483649         | int64          | `L`    |
+| number_integer  | -2147483648..-32769                       | int32          | `l`    |
+| number_integer  | -32768..-129                              | int16          | `I`    |
+| number_integer  | -128..127                                 | int8           | `i`    |
+| number_integer  | 128..255                                  | uint8          | `U`    |
+| number_integer  | 256..32767                                | int16          | `I`    |
+| number_integer  | 32768..65535                              | uint16         | `u`    |
+| number_integer  | 65536..2147483647                         | int32          | `l`    |
+| number_integer  | 2147483648..4294967295                    | uint32         | `m`    |
+| number_integer  | 4294967296..9223372036854775807           | int64          | `L`    |
+| number_integer  | 9223372036854775808..18446744073709551615 | uint64         | `M`    |
+| number_unsigned | 0..127                                    | int8           | `i`    |
+| number_unsigned | 128..255                                  | uint8          | `U`    |
+| number_unsigned | 256..32767                                | int16          | `I`    |
+| number_unsigned | 32768..65535                              | uint16         | `u`    |
+| number_unsigned | 65536..2147483647                         | int32          | `l`    |
+| number_unsigned | 2147483648..4294967295                    | uint32         | `m`    |
+| number_unsigned | 4294967296..9223372036854775807           | int64          | `L`    |
+| number_unsigned | 9223372036854775808..18446744073709551615 | uint64         | `M`    |
+| number_float    | *any value*                               | float64        | `D`    |
+| string          | *with shortest length indicator*          | string         | `S`    |
+| array           | *see notes on optimized format/ND-array*  | array          | `[`    |
+| object          | *see notes on optimized format*           | map            | `{`    |
+
+!!! success "Complete mapping"
+
+	The mapping is **complete** in the sense that any JSON value type can be converted to a BJData value.
+
+	Any BJData output created by `to_bjdata` can be successfully parsed by `from_bjdata`.
+
+!!! warning "Size constraints"
+
+	The following values can **not** be converted to a BJData value:
+
+      - strings with more than 18446744073709551615 bytes (theoretical)
+
+!!! info "Unused BJData markers"
+
+	The following markers are not used in the conversion:
+
+    - `Z`: no-op values are not created.
+    - `C`: single-byte strings are serialized with `S` markers.
+
+!!! info "NaN/infinity handling"
+
+	If NaN or Infinity are stored inside a JSON number, they are
+    serialized properly. This behavior differs from the `dump()`
+    function which serializes NaN or Infinity to `null`.
+
+
+!!! info "Endianness"
+
+	A breaking difference between BJData and UBJSON is the endianness
+    of numerical values. In BJData, all numerical data types (integers
+    `UiuImlML` and floating-point values `hdD`) are stored in the little-endian (LE)
+    byte order as opposed to big-endian as used by UBJSON. To adopt LE
+    to store numeric records avoids unnecessary byte swapping on most modern
+    computers where LE is used as the default byte order.
+
+!!! info "Optimized formats"
+
+	The optimized formats for containers are supported: Parameter
+    `use_size` adds size information to the beginning of a container and
+    removes the closing marker. Parameter `use_type` further checks
+    whether all elements of a container have the same type and adds the
+    type marker to the beginning of the container. The `use_type`
+    parameter must only be used together with `use_size = true`.
+
+    Note that `use_size = true` alone may result in larger representations -
+    the benefit of this parameter is that the receiving side is
+    immediately informed on the number of elements of the container.
+
+!!! info "ND-array optimized format"
+
+	BJData extends UBJSON's optimized array **size** marker to support
+    ND-array of uniform numerical data types (referred to as the *packed array*).
+    For example, 2-D `uint8` integer array `[[1,2],[3,4],[5,6]]` that can be stored
+    as nested optimized array in UBJSON `[ [$U#i2 1 2 [$U#i2 3 4 [$U#i2 5 6 ]`,
+    can be further compressed in BJData and stored as `[$U#[$i#i2 2 3 1 2 3 4 5 6`
+    or `[$U#[i2 i3] 1 2 3 4 5 6`.
+
+    In order to maintain the type and dimension information of an ND-array,
+    when this library parses a BJData ND-array via `from_bjdata`, it converts the
+    data into a JSON object, following the **annotated array format** as defined in the
+    [JData specification (Draft 3)](https://github.com/NeuroJSON/jdata/blob/master/JData_specification.md#annotated-storage-of-n-d-arrays).
+    For example, the above 2-D `uint8` array can be parsed and accessed as
+
+    ```json
+    {
+        "_ArrayType_": "uint8",
+        "_ArraySize_": [2,3],
+        "_ArrayData_": [1,2,3,4,5,6]
+    }
+    ```
+
+    In the reversed direction, when `to_bjdata` detects a JSON object in the
+    above form, it automatically converts such object into a BJData ND-array
+    to generate compact output. The only exception is that when the 1-D dimensional
+    vector stored in `"_ArraySize_"` contains a single integer, or two integers with
+    one being 1, a regular 1-D optimized array is generated.
+
+    The current version of this library has not yet supported automatic
+    recognition and conversion from a nested JSON array input to a BJData ND-array.
+
+!!! info "Restrictions in optimized data types for arrays and objects"
+
+	Due to diminished space saving, hampered readability, and increased
+    security risks, in BJData, the allowed data types following the `$` marker
+    in an optimized array and object container are restricted to
+    **non-zero-fixed-length** data types. Therefore, the valid optimized
+    type markers can only be one of `UiuImlMLhdDC`. This also means other
+    variable (`[{SH`) or zero-length types (`TFN`) can not be used in an
+    optimized array or object in BJData.
+
+!!! info "Binary values"
+
+	If the JSON data contains the binary type, the value stored is a list
+    of integers, as suggested by the BJData documentation.  In particular,
+    this means that serialization and the deserialization of a JSON
+    containing binary values into BJData and back will result in a
+    different JSON object.
+
+
+??? example
+
+    ```cpp
+    --8<-- "examples/to_bjdata.cpp"
+    ```
+
+    Output:
+
+    ```c
+    --8<-- "examples/to_bjdata.output"
+    ```
+
+## Deserialization
+
+The library maps BJData types to JSON value types as follows:
+
+| BJData type | JSON value type                         | marker |
+|-------------|-----------------------------------------|--------|
+| no-op       | *no value, next value is read*          | `N`    |
+| null        | `null`                                  | `Z`    |
+| false       | `false`                                 | `F`    |
+| true        | `true`                                  | `T`    |
+| float16     | number_float                            | `h`    |
+| float32     | number_float                            | `d`    |
+| float64     | number_float                            | `D`    |
+| uint8       | number_unsigned                         | `U`    |
+| int8        | number_integer                          | `i`    |
+| uint16      | number_unsigned                         | `u`    |
+| int16       | number_integer                          | `I`    |
+| uint32      | number_unsigned                         | `m`    |
+| int32       | number_integer                          | `l`    |
+| uint64      | number_unsigned                         | `M`    |
+| int64       | number_integer                          | `L`    |
+| string      | string                                  | `S`    |
+| char        | string                                  | `C`    |
+| array       | array (optimized values are supported)  | `[`    |
+| ND-array    | object (in JData annotated array format)|`[$.#[.`|
+| object      | object (optimized values are supported) | `{`    |
+
+!!! success "Complete mapping"
+
+	The mapping is **complete** in the sense that any BJData value can be converted to a JSON value.
+
+
+??? example
+
+    ```cpp
+    --8<-- "examples/from_bjdata.cpp"
+    ```
+
+    Output:
+
+    ```json
+    --8<-- "examples/from_bjdata.output"
+    ```
diff --git a/docs/mkdocs/docs/features/binary_formats/index.md b/docs/mkdocs/docs/features/binary_formats/index.md
index 3a969a5dc..e74290b09 100644
--- a/docs/mkdocs/docs/features/binary_formats/index.md
+++ b/docs/mkdocs/docs/features/binary_formats/index.md
@@ -1,7 +1,9 @@
 # Binary Formats
 
-Though JSON is a ubiquitous data format, it is not a very compact format suitable for data exchange, for instance over a network. Hence, the library supports
+Though JSON is a ubiquitous data format, it is not a very compact format suitable for data exchange, for instance over
+a network. Hence, the library supports
 
+- [BJData](bjdata.md) (Binary JData),
 - [BSON](bson.md) (Binary JSON),
 - [CBOR](cbor.md) (Concise Binary Object Representation),
 - [MessagePack](messagepack.md), and
@@ -15,6 +17,7 @@ to efficiently encode JSON values to byte vectors and to decode such vectors.
 
 | Format      | Serialization                                 | Deserialization                              |
 |-------------|-----------------------------------------------|----------------------------------------------|
+| BJData      | complete                                      | complete                                     |
 | BSON        | incomplete: top-level value must be an object | incomplete, but all JSON types are supported |
 | CBOR        | complete                                      | incomplete, but all JSON types are supported |
 | MessagePack | complete                                      | complete                                     |
@@ -24,6 +27,7 @@ to efficiently encode JSON values to byte vectors and to decode such vectors.
 
 | Format      | Binary values | Binary subtypes |
 |-------------|---------------|-----------------|
+| BJData      | not supported | not supported   |
 | BSON        | supported     | supported       |
 | CBOR        | supported     | supported       |
 | MessagePack | supported     | supported       |
@@ -35,11 +39,14 @@ See [binary values](../binary_values.md) for more information.
 
 | Format             | canada.json | twitter.json | citm_catalog.json | jeopardy.json |
 |--------------------|-------------|--------------|-------------------|---------------|
-| BSON               | 85,8 %      | 95,2 %       | 95,8 %            | 106,7 %       |
-| CBOR               | 50,5 %      | 86,3 %       | 68,4 %            | 88,0 %        |
-| MessagePack        | 50,6 %      | 86,0 %       | 68,5 %            | 87,9 %        |
-| UBJSON             | 53,2 %      | 91,3 %       | 78,2 %            | 96,6 %        |
-| UBJSON (size)      | 58,6 %      | 92,3 %       | 86,8 %            | 97,4 %        |
-| UBJSON (size+type) | 55,9 %      | 92,3 %       | 85,0 %            | 95,0 %        |
+| BJData             | 53.2 %      | 91.1 %       | 78.1 %            | 96.6 %        |
+| BJData (size)      | 58.6 %      | 92.1 %       | 86.7 %            | 97.4 %        |
+| BJData (size+tyoe) | 58.6 %      | 92.1 %       | 86.5 %            | 97.4 %        |
+| BSON               | 85.8 %      | 95.2 %       | 95.8 %            | 106.7 %       |
+| CBOR               | 50.5 %      | 86.3 %       | 68.4 %            | 88.0 %        |
+| MessagePack        | 50.5 %      | 86.0 %       | 68.5 %            | 87.9 %        |
+| UBJSON             | 53.2 %      | 91.3 %       | 78.2 %            | 96.6 %        |
+| UBJSON (size)      | 58.6 %      | 92.3 %       | 86.8 %            | 97.4 %        |
+| UBJSON (size+type) | 55.9 %      | 92.3 %       | 85.0 %            | 95.0 %        |
 
 Sizes compared to minified JSON value.
diff --git a/docs/mkdocs/docs/features/binary_values.md b/docs/mkdocs/docs/features/binary_values.md
index c58834c05..5ad6433cf 100644
--- a/docs/mkdocs/docs/features/binary_values.md
+++ b/docs/mkdocs/docs/features/binary_values.md
@@ -1,8 +1,12 @@
 # Binary Values
 
-The library implements several [binary formats](binary_formats/index.md) that encode JSON in an efficient way. Most of these formats support binary values; that is, values that have semantics define outside the library and only define a sequence of bytes to be stored.
+The library implements several [binary formats](binary_formats/index.md) that encode JSON in an efficient way. Most of
+these formats support binary values; that is, values that have semantics define outside the library and only define a
+sequence of bytes to be stored.
 
-JSON itself does not have a binary value. As such, binary values are an extension that this library implements to store values received by a binary format. Binary values are never created by the JSON parser, and are only part of a serialized JSON text if they have been created manually or via a binary format.
+JSON itself does not have a binary value. As such, binary values are an extension that this library implements to store
+values received by a binary format. Binary values are never created by the JSON parser, and are only part of a
+serialized JSON text if they have been created manually or via a binary format.
 
 ## API for binary values
 
@@ -19,7 +23,9 @@ class json::binary_t {
 "std::vector<uint8_t>" <|-- json::binary_t
 ```
 
-By default, binary values are stored as `std::vector<std::uint8_t>`. This type can be changed by providing a template parameter to the `basic_json` type. To store binary subtypes, the storage type is extended and exposed as `json::binary_t`:
+By default, binary values are stored as `std::vector<std::uint8_t>`. This type can be changed by providing a template
+parameter to the `basic_json` type. To store binary subtypes, the storage type is extended and exposed as
+`json::binary_t`:
 
 ```cpp
 auto binary = json::binary_t({0xCA, 0xFE, 0xBA, 0xBE});
@@ -87,7 +93,9 @@ Binary values are serialized differently according to the formats.
 
 ### JSON
 
-JSON does not have a binary type, and this library does not introduce a new type as this would break conformance. Instead, binary values are serialized as an object with two keys: `bytes` holds an array of integers, and `subtype` is an integer or `null`.
+JSON does not have a binary type, and this library does not introduce a new type as this would break conformance.
+Instead, binary values are serialized as an object with two keys: `bytes` holds an array of integers, and `subtype`
+is an integer or `null`.
 
 ??? example
 
@@ -115,11 +123,72 @@ JSON does not have a binary type, and this library does not introduce a new type
 
 !!! warning "No roundtrip for binary values"
 
-    The JSON parser will not parse the objects generated by binary values back to binary values. This is by design to remain standards compliant. Serializing binary values to JSON is only implemented for debugging purposes.
+    The JSON parser will not parse the objects generated by binary values back to binary values. This is by design to
+    remain standards compliant. Serializing binary values to JSON is only implemented for debugging purposes.
+
+### BJData
+
+[BJData](binary_formats/bjdata.md) neither supports binary values nor subtypes, and proposes to serialize binary values
+as array of uint8 values. This translation is implemented by the library.
+
+??? example
+
+    Code:
+    
+    ```cpp
+    // create a binary value of subtype 42 (will be ignored in BJData)
+    json j;
+    j["binary"] = json::binary({0xCA, 0xFE, 0xBA, 0xBE}, 42);
+
+    // convert to BJData
+    auto v = json::to_bjdata(j);      
+    ```
+            
+    `v` is a `std::vector<std::uint8t>` with the following 20 elements:
+
+    ```c
+    0x7B                                             // '{'
+        0x69 0x06                                    // i 6 (length of the key)
+        0x62 0x69 0x6E 0x61 0x72 0x79                // "binary"
+        0x5B                                         // '['
+            0x55 0xCA 0x55 0xFE 0x55 0xBA 0x55 0xBE  // content (each byte prefixed with 'U')
+        0x5D                                         // ']'
+    0x7D                                             // '}'
+    ```
+
+    The following code uses the type and size optimization for UBJSON:
+
+    ```cpp
+    // convert to UBJSON using the size and type optimization
+    auto v = json::to_bjdata(j, true, true);
+    ```
+
+    The resulting vector has 22 elements; the optimization is not effective for examples with few values:
+
+    ```c
+    0x7B                                // '{'
+        0x23 0x69 0x01                  // '#' 'i' type of the array elements: unsigned integers
+        0x69 0x06                       // i 6 (length of the key)
+        0x62 0x69 0x6E 0x61 0x72 0x79   // "binary"
+        0x5B                            // '[' array
+            0x24 0x55                   // '$' 'U' type of the array elements: unsigned integers
+            0x23 0x69 0x04              // '#' i 4 number of array elements
+            0xCA 0xFE 0xBA 0xBE         // content
+    ```
+
+    Note that subtype (42) is **not** serialized and that UBJSON has **no binary type**, and deserializing `v` would
+    yield the following value:
+
+    ```json
+    {
+      "binary": [202, 254, 186, 190]
+    }
+    ```
 
 ### BSON
 
-[BSON](binary_formats/bson.md) supports binary values and subtypes. If a subtype is given, it is used and added as unsigned 8-bit integer. If no subtype is given, the generic binary subtype 0x00 is used.
+[BSON](binary_formats/bson.md) supports binary values and subtypes. If a subtype is given, it is used and added as
+unsigned 8-bit integer. If no subtype is given, the generic binary subtype 0x00 is used.
 
 ??? example
 
@@ -159,7 +228,9 @@ JSON does not have a binary type, and this library does not introduce a new type
 
 ### CBOR
 
-[CBOR](binary_formats/cbor.md) supports binary values, but no subtypes. Subtypes will be serialized as tags. Any binary value will be serialized as byte strings. The library will choose the smallest representation using the length of the byte array.
+[CBOR](binary_formats/cbor.md) supports binary values, but no subtypes. Subtypes will be serialized as tags. Any binary
+value will be serialized as byte strings. The library will choose the smallest representation using the length of the
+byte array.
 
 ??? example
 
@@ -185,7 +256,8 @@ JSON does not have a binary type, and this library does not introduce a new type
             0xCA 0xFE 0xBA 0xBE            // content
     ```
 
-    Note that the subtype is serialized as tag. However, parsing tagged values yield a parse error unless `json::cbor_tag_handler_t::ignore` or `json::cbor_tag_handler_t::store` is passed to `json::from_cbor`.
+    Note that the subtype is serialized as tag. However, parsing tagged values yield a parse error unless
+    `json::cbor_tag_handler_t::ignore` or `json::cbor_tag_handler_t::store` is passed to `json::from_cbor`.
 
     ```json
     {
@@ -198,7 +270,9 @@ JSON does not have a binary type, and this library does not introduce a new type
 
 ### MessagePack
 
-[MessagePack](binary_formats/messagepack.md) supports binary values and subtypes. If a subtype is given, the ext family is used. The library will choose the smallest representation among fixext1, fixext2, fixext4, fixext8, ext8, ext16, and ext32. The subtype is then added as signed 8-bit integer.
+[MessagePack](binary_formats/messagepack.md) supports binary values and subtypes. If a subtype is given, the ext family
+is used. The library will choose the smallest representation among fixext1, fixext2, fixext4, fixext8, ext8, ext16, and
+ext32. The subtype is then added as signed 8-bit integer.
 
 If no subtype is given, the bin family (bin8, bin16, bin32) is used.
 
@@ -239,7 +313,8 @@ If no subtype is given, the bin family (bin8, bin16, bin32) is used.
 
 ### UBJSON
 
-[UBJSON](binary_formats/ubjson.md) neither supports binary values nor subtypes, and proposes to serialize binary values as array of uint8 values. This translation is implemented by the library.
+[UBJSON](binary_formats/ubjson.md) neither supports binary values nor subtypes, and proposes to serialize binary values
+as array of uint8 values. This translation is implemented by the library.
 
 ??? example
 
@@ -251,7 +326,7 @@ If no subtype is given, the bin family (bin8, bin16, bin32) is used.
     j["binary"] = json::binary({0xCA, 0xFE, 0xBA, 0xBE}, 42);
 
     // convert to UBJSON
-    auto v = json::to_msgpack(j);      
+    auto v = json::to_ubjson(j);      
     ```
             
     `v` is a `std::vector<std::uint8t>` with the following 20 elements:
@@ -287,7 +362,8 @@ If no subtype is given, the bin family (bin8, bin16, bin32) is used.
             0xCA 0xFE 0xBA 0xBE         // content
     ```
 
-    Note that subtype (42) is **not** serialized and that UBJSON has **no binary type**, and deserializing `v` would yield the following value:
+    Note that subtype (42) is **not** serialized and that UBJSON has **no binary type**, and deserializing `v` would
+    yield the following value:
 
     ```json
     {
diff --git a/docs/mkdocs/docs/features/element_access/checked_access.md b/docs/mkdocs/docs/features/element_access/checked_access.md
index fd444bebe..c4023cce5 100644
--- a/docs/mkdocs/docs/features/element_access/checked_access.md
+++ b/docs/mkdocs/docs/features/element_access/checked_access.md
@@ -2,9 +2,11 @@
 
 ## Overview
 
-The `#!cpp at()` member function performs checked access; that is, it returns a reference to the desired value if it exists and throws a [`basic_json::out_of_range` exception](../../home/exceptions.md#out-of-range) otherwise.
+The [`at`](../../api/basic_json/at.md) member function performs checked access; that is, it returns a reference to the
+desired value if it exists and throws a [`basic_json::out_of_range` exception](../../home/exceptions.md#out-of-range)
+otherwise.
 
-??? example
+??? example "Read access"
 
     Consider the following JSON value:
     
@@ -18,18 +20,18 @@ The `#!cpp at()` member function performs checked access; that is, it returns a
     
     Assume the value is parsed to a `json` variable `j`.
 
-    | expression | value |
-    | ---------- | ----- |
-    | `#!cpp j`  | `#!json {"name": "Mary Smith", "age": 42, "hobbies": ["hiking", "reading"]}` |
-    | `#!cpp j.at("name")`  | `#!json "Mary Smith"` |
-    | `#!cpp j.at("age")`  | `#!json 42` |
-    | `#!cpp j.at("hobbies")`  | `#!json ["hiking", "reading"]` |
-    | `#!cpp j.at("hobbies").at(0)`  | `#!json "hiking"` |
-    | `#!cpp j.at("hobbies").at(1)`  | `#!json "reading"` |
+    | expression                    | value                                                                        |
+    |-------------------------------|------------------------------------------------------------------------------|
+    | `#!cpp j`                     | `#!json {"name": "Mary Smith", "age": 42, "hobbies": ["hiking", "reading"]}` |
+    | `#!cpp j.at("name")`          | `#!json "Mary Smith"`                                                        |
+    | `#!cpp j.at("age")`           | `#!json 42`                                                                  |
+    | `#!cpp j.at("hobbies")`       | `#!json ["hiking", "reading"]`                                               |
+    | `#!cpp j.at("hobbies").at(0)` | `#!json "hiking"`                                                            |
+    | `#!cpp j.at("hobbies").at(1)` | `#!json "reading"`                                                           |
 
 The return value is a reference, so it can be modified by the original value.
 
-??? example
+??? example "Write access"
 
     ```cpp
     j.at("name") = "John Smith";
@@ -45,9 +47,10 @@ The return value is a reference, so it can be modified by the original value.
     }
     ```
 
-When accessing an invalid index (i.e., an index greater than or equal to the array size) or the passed object key is non-existing, an exception is thrown.
+When accessing an invalid index (i.e., an index greater than or equal to the array size) or the passed object key is
+non-existing, an exception is thrown.
 
-??? example
+??? example "Accessing via invalid index or missing key"
 
     ```cpp
     j.at("hobbies").at(3) = "cooking";
@@ -59,13 +62,24 @@ When accessing an invalid index (i.e., an index greater than or equal to the arr
     [json.exception.out_of_range.401] array index 3 is out of range
     ```
 
+    When you [extended diagnostic messages](../../home/exceptions.md#extended-diagnostic-messages) are enabled by
+    defining [`JSON_DIAGNOSTICS`](../../api/macros/json_diagnostics.md), the exception further gives information where
+    the key or index is missing or out of range.
+    
+    ```
+    [json.exception.out_of_range.401] (/hobbies) array index 3 is out of range
+    ```
+
 ## Notes
 
 
 !!! failure "Exceptions"
 
-    - `at` can only be used with objects (with a string argument) or with arrays (with a numeric argument). For other types, a [`basic_json::type_error`](../../home/exceptions.md#jsonexceptiontype_error304) is thrown.
-    - [`basic_json::out_of_range` exception](../../home/exceptions.md#out-of-range) exceptions are thrown if the provided key is not found in an object or the provided index is invalid.
+    - [`at`](../../api/basic_json/at.md) can only be used with objects (with a string argument) or with arrays (with a
+      numeric argument). For other types, a [`basic_json::type_error`](../../home/exceptions.md#jsonexceptiontype_error304)
+      is thrown.
+    - [`basic_json::out_of_range` exception](../../home/exceptions.md#out-of-range) exceptions are thrown if the
+      provided key is not found in an object or the provided index is invalid.
 
 ## Summary
 
diff --git a/docs/mkdocs/docs/features/element_access/unchecked_access.md b/docs/mkdocs/docs/features/element_access/unchecked_access.md
index 4fdef35c7..1bdea94e7 100644
--- a/docs/mkdocs/docs/features/element_access/unchecked_access.md
+++ b/docs/mkdocs/docs/features/element_access/unchecked_access.md
@@ -2,9 +2,10 @@
 
 ## Overview
 
-Elements in a JSON object and a JSON array can be accessed via `#!cpp operator[]` similar to a `#!cpp std::map` and a `#!cpp std::vector`, respectively.
+Elements in a JSON object and a JSON array can be accessed via [`operator[]`](../../api/basic_json/operator%5B%5D.md)
+similar to a `#!cpp std::map` and a `#!cpp std::vector`, respectively.
 
-??? example
+??? example "Read access"
 
     Consider the following JSON value:
     
@@ -18,18 +19,19 @@ Elements in a JSON object and a JSON array can be accessed via `#!cpp operator[]
     
     Assume the value is parsed to a `json` variable `j`.
 
-    | expression | value |
-    | ---------- | ----- |
-    | `#!cpp j`  | `#!json {"name": "Mary Smith", "age": 42, "hobbies": ["hiking", "reading"]}` |
-    | `#!cpp j["name"]`  | `#!json "Mary Smith"` |
-    | `#!cpp j["age"]`  | `#!json 42` |
-    | `#!cpp j["hobbies"]`  | `#!json ["hiking", "reading"]` |
-    | `#!cpp j["hobbies"][0]`  | `#!json "hiking"` |
-    | `#!cpp j["hobbies"][1]`  | `#!json "reading"` |
+    | expression              | value                                                                        |
+    |-------------------------|------------------------------------------------------------------------------|
+    | `#!cpp j`               | `#!json {"name": "Mary Smith", "age": 42, "hobbies": ["hiking", "reading"]}` |
+    | `#!cpp j["name"]`       | `#!json "Mary Smith"`                                                        |
+    | `#!cpp j["age"]`        | `#!json 42`                                                                  |
+    | `#!cpp j["hobbies"]`    | `#!json ["hiking", "reading"]`                                               |
+    | `#!cpp j["hobbies"][0]` | `#!json "hiking"`                                                            |
+    | `#!cpp j["hobbies"][1]` | `#!json "reading"`                                                           |
 
-The return value is a reference, so it can modify the original value. In case the passed object key is non-existing, a `#!json null` value is inserted which can be immediately be overwritten.
+The return value is a reference, so it can modify the original value. In case the passed object key is non-existing, a
+`#!json null` value is inserted which can be immediately be overwritten.
 
-??? example
+??? example "Write access"
 
     ```cpp
     j["name"] = "John Smith";
@@ -47,9 +49,10 @@ The return value is a reference, so it can modify the original value. In case th
     }
     ```
 
-When accessing an invalid index (i.e., an index greater than or equal to the array size), the JSON array is resized such that the passed index is the new maximal index. Intermediate values are filled with `#!json null`.
+When accessing an invalid index (i.e., an index greater than or equal to the array size), the JSON array is resized such
+that the passed index is the new maximal index. Intermediate values are filled with `#!json null`.
 
-??? example
+??? example "Filling up arrays with `#!json null` values"
 
     ```cpp
     j["hobbies"][0] = "running";
@@ -76,17 +79,23 @@ When accessing an invalid index (i.e., an index greater than or equal to the arr
     - `#!cpp std::vector::operator[]` never inserts a new element.
     - `#!cpp std::map::operator[]` is not available for const values.
     
-    The type `#!cpp json` wraps all JSON value types. It would be impossible to remove `operator[]` for const objects. At the same time, inserting elements for non-const objects is really convenient as it avoids awkward `insert` calls. To this end, we decided to have an inserting non-const behavior for both arrays and objects.
+    The type `#!cpp json` wraps all JSON value types. It would be impossible to remove
+    [`operator[]`](../../api/basic_json/operator%5B%5D.md) for const objects. At the same time, inserting elements for
+    non-const objects is really convenient as it avoids awkward `insert` calls. To this end, we decided to have an
+    inserting non-const behavior for both arrays and objects.
 
 !!! info
 
-    The access is unchecked. In case the passed object key does not exist or the passed array index is invalid, no exception is thrown.
+    The access is unchecked. In case the passed object key does not exist or the passed array index is invalid, no
+    exception is thrown.
 
 !!! danger
 
     - It is **undefined behavior** to access a const object with a non-existing key.
     - It is **undefined behavior** to access a const array with an invalid index.
-    - In debug mode, an **assertion** will fire in both cases. You can disable assertions by defining the preprocessor symbol `#!cpp NDEBUG` or redefine the macro [`JSON_ASSERT(x)`](../macros.md#json_assertx).
+    - In debug mode, an **assertion** will fire in both cases. You can disable assertions by defining the preprocessor
+      symbol `#!cpp NDEBUG` or redefine the macro [`JSON_ASSERT(x)`](../macros.md#json_assertx). See the documentation
+      on [runtime assertions](../assertions.md) for more information.
 
 !!! failure "Exceptions"
 
diff --git a/docs/mkdocs/docs/features/iterators.md b/docs/mkdocs/docs/features/iterators.md
index 46f28f189..ce627e012 100644
--- a/docs/mkdocs/docs/features/iterators.md
+++ b/docs/mkdocs/docs/features/iterators.md
@@ -113,7 +113,7 @@ for (auto& [key, val] : j_object.items())
     ```cpp
     json j = {1, 2, 3, 4};
 
-    for (auto it = j.begin(); it != j.end(); ++it)
+    for (auto it = j.rbegin(); it != j.rend(); ++it)
     {
         std::cout << *it << std::endl;
     }
diff --git a/docs/mkdocs/docs/features/object_order.md b/docs/mkdocs/docs/features/object_order.md
index 0768f8020..3ee16a90e 100644
--- a/docs/mkdocs/docs/features/object_order.md
+++ b/docs/mkdocs/docs/features/object_order.md
@@ -42,30 +42,13 @@ If you do want to preserve the **insertion order**, you can try the type [`nlohm
 ??? example
 
     ```cpp
-    #include <iostream>
-    #include <nlohmann/json.hpp>
-    
-    using ordered_json = nlohmann::ordered_json;
-    
-    int main()
-    {
-        ordered_json j;
-        j["one"] = 1;
-        j["two"] = 2;
-        j["three"] = 3;
-        
-        std::cout << j.dump(2) << '\n';
-    }
+    --8<-- "examples/ordered_json.cpp"
     ```
     
     Output:
     
     ```json
-    {
-      "one": 1,
-      "two": 2,
-      "three": 3
-    }
+    --8<-- "examples/ordered_json.output"
     ```
 
 Alternatively, you can use a more sophisticated ordered map like [`tsl::ordered_map`](https://github.com/Tessil/ordered-map) ([integration](https://github.com/nlohmann/json/issues/546#issuecomment-304447518)) or [`nlohmann::fifo_map`](https://github.com/nlohmann/fifo_map) ([integration](https://github.com/nlohmann/json/issues/485#issuecomment-333652309)).
diff --git a/docs/mkdocs/docs/home/exceptions.md b/docs/mkdocs/docs/home/exceptions.md
index 666d225bd..c9885ae6f 100644
--- a/docs/mkdocs/docs/home/exceptions.md
+++ b/docs/mkdocs/docs/home/exceptions.md
@@ -271,7 +271,7 @@ In a JSON Pointer, only `~0` and `~1` are valid escape sequences.
 
 A JSON Pointer array index must be a number.
 
-!!! failure "Example message"
+!!! failure "Example messages"
 
     ```
     [json.exception.parse_error.109] parse error: array index 'one' is not a number
@@ -295,19 +295,34 @@ When parsing CBOR or MessagePack, the byte vector ends before the complete value
 
 ### json.exception.parse_error.112
 
-Not all types of CBOR or MessagePack are supported. This exception occurs if an unsupported byte was read.
+An unexpected byte was read in a [binary format](../features/binary_formats/index.md) or length information is invalid ([BSON](../features/binary_formats/bson.md)).
 
-!!! failure "Example message"
+!!! failure "Example messages"
 
     ```
     [json.exception.parse_error.112] parse error at byte 1: syntax error while parsing CBOR value: invalid byte: 0x1C
     ```
+    ```
+    [json.exception.parse_error.112] parse error at byte 1: syntax error while parsing MessagePack value: invalid byte: 0xC1
+    ```
+    ```
+    [json.exception.parse_error.112] parse error at byte 4: syntax error while parsing BJData size: expected '#' after type information; last byte: 0x02
+    ```
+    ```
+    [json.exception.parse_error.112] parse error at byte 4: syntax error while parsing UBJSON size: expected '#' after type information; last byte: 0x02
+    ```
+    ```
+    [json.exception.parse_error.112] parse error at byte 10: syntax error while parsing BSON string: string length must be at least 1, is -2147483648
+    ```
+    ```
+    [json.exception.parse_error.112] parse error at byte 15: syntax error while parsing BSON binary: byte array length cannot be negative, is -1
+    ```
 
 ### json.exception.parse_error.113
 
 While parsing a map key, a value that is not a string has been read.
 
-!!! failure "Example message"
+!!! failure "Example messages"
 
     ```
     [json.exception.parse_error.113] parse error at byte 2: syntax error while parsing CBOR string: expected length specification (0x60-0x7B) or indefinite string type (0x7F); last byte: 0xFF
@@ -374,7 +389,7 @@ The iterators passed to constructor `basic_json(InputIT first, InputIT last)` ar
 
 In the [erase](../api/basic_json/erase.md) or insert function, the passed iterator `pos` does not belong to the JSON value for which the function was called. It hence does not define a valid position for the deletion/insertion.
 
-!!! failure "Example message"
+!!! failure "Example messages"
 
     ```
     [json.exception.invalid_iterator.202] iterator does not fit current value
@@ -538,7 +553,7 @@ To create an object from an initializer list, the initializer list must consist
 
 During implicit or explicit value conversion, the JSON type must be compatible to the target type. For instance, a JSON string can only be converted into string types, but not into numbers or boolean types.
 
-!!! failure "Example message"
+!!! failure "Example messages"
 
     ```
     [json.exception.type_error.302] type must be object, but is null
@@ -551,7 +566,7 @@ During implicit or explicit value conversion, the JSON type must be compatible t
 
 To retrieve a reference to a value stored in a `basic_json` object with `get_ref`, the type of the reference must match the value type. For instance, for a JSON array, the `ReferenceType` must be `array_t &`.
 
-!!! failure "Example message"
+!!! failure "Example messages"
 
     ```
     [json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is object
@@ -564,7 +579,7 @@ To retrieve a reference to a value stored in a `basic_json` object with `get_ref
 
 The `at()` member functions can only be executed for certain JSON types.
 
-!!! failure "Example message"
+!!! failure "Example messages"
 
     ```
     [json.exception.type_error.304] cannot use at() with string
@@ -577,7 +592,7 @@ The `at()` member functions can only be executed for certain JSON types.
 
 The `operator[]` member functions can only be executed for certain JSON types.
 
-!!! failure "Example message"
+!!! failure "Example messages"
 
     ```
     [json.exception.type_error.305] cannot use operator[] with a string argument with array
@@ -620,7 +635,7 @@ The `push_back()` and `operator+=` member functions can only be executed for cer
 
 The `insert()` member functions can only be executed for certain JSON types.
 
-!!! failure "Example message"
+!!! failure "Example messages"
 
     ```
     [json.exception.type_error.309] cannot use insert() with array
@@ -643,7 +658,7 @@ The `swap()` member functions can only be executed for certain JSON types.
 
 The `emplace()` and `emplace_back()` member functions can only be executed for certain JSON types.
 
-!!! failure "Example message"
+!!! failure "Example messages"
 
     ```
     [json.exception.type_error.311] cannot use emplace() with number
@@ -718,7 +733,7 @@ The `dump()` function only works with UTF-8 encoded strings; that is, if you ass
 
 The dynamic type of the object cannot be represented in the requested serialization format (e.g. a raw `true` or `null` JSON object cannot be serialized to BSON)
 
-!!! failure "Example message"
+!!! failure "Example messages"
 
     Serializing `#!json null` to BSON:
     ```
diff --git a/docs/mkdocs/mkdocs.yml b/docs/mkdocs/mkdocs.yml
index 38a8cadfa..dd4da8a0c 100644
--- a/docs/mkdocs/mkdocs.yml
+++ b/docs/mkdocs/mkdocs.yml
@@ -42,6 +42,7 @@ nav:
     - features/arbitrary_types.md
     - Binary Formats:
       - features/binary_formats/index.md
+      - features/binary_formats/bjdata.md
       - features/binary_formats/bson.md
       - features/binary_formats/cbor.md
       - features/binary_formats/messagepack.md
@@ -109,6 +110,7 @@ nav:
         - 'exception': api/basic_json/exception.md
         - 'find': api/basic_json/find.md
         - 'flatten': api/basic_json/flatten.md
+        - 'from_bjdata': api/basic_json/from_bjdata.md
         - 'from_bson': api/basic_json/from_bson.md
         - 'from_cbor': api/basic_json/from_cbor.md
         - 'from_msgpack': api/basic_json/from_msgpack.md
@@ -178,6 +180,7 @@ nav:
         - 'string_t': api/basic_json/string_t.md
         - 'swap': api/basic_json/swap.md
         - 'std::swap&lt;basic_json&gt;': api/basic_json/std_swap.md
+        - 'to_bjdata': api/basic_json/to_bjdata.md
         - 'to_bson': api/basic_json/to_bson.md
         - 'to_cbor': api/basic_json/to_cbor.md
         - 'to_msgpack': api/basic_json/to_msgpack.md
diff --git a/docs/mkdocs/scripts/check_structure.py b/docs/mkdocs/scripts/check_structure.py
index 92f6ff182..56de6e89f 100755
--- a/docs/mkdocs/scripts/check_structure.py
+++ b/docs/mkdocs/scripts/check_structure.py
@@ -47,14 +47,17 @@ def check_structure():
     files = sorted(glob.glob('api/**/*.md', recursive=True))
     for file in files:
         with open(file) as file_content:
-            section_idx = -1
-            existing_sections = []
-            in_initial_code_example = False
-            previous_line = None
-            h1sections = 0
+            section_idx = -1                 # the index of the current h2 section
+            existing_sections = []           # the list of h2 sections in the file
+            in_initial_code_example = False  # whether we are inside the first code example block
+            previous_line = None             # the previous read line
+            h1sections = 0                   # the number of h1 sections in the file
+            last_overload = 0                # the last seen overload number in the code example
+            documented_overloads = {}        # the overloads that have been documented in the current block
+            current_section = None           # the name of the current section
 
-            for lineno, line in enumerate(file_content.readlines()):
-                line = line.strip()
+            for lineno, original_line in enumerate(file_content.readlines()):
+                line = original_line.strip()
 
                 if line.startswith('# '):
                     h1sections += 1
@@ -70,10 +73,21 @@ def check_structure():
 
                 # lines longer than 160 characters are bad (unless they are tables)
                 if len(line) > 160 and '|' not in line:
-                    report('whitespace/line_length', f'{file}:{lineno+1}', f'line is too long ({len(line)} vs. 160 chars)')
+                    report('whitespace/line_length', f'{file}:{lineno+1} ({current_section})', f'line is too long ({len(line)} vs. 160 chars)')
 
                 # check if sections are correct
                 if line.startswith('## '):
+                    # before starting a new section, check if the previous one documented all overloads
+                    if current_section in documented_overloads and last_overload != 0:
+                        if len(documented_overloads[current_section]) > 0 and len(documented_overloads[current_section]) != last_overload:
+                            expected = list(range(1, last_overload+1))
+                            undocumented = [x for x in expected if x not in documented_overloads[current_section]]
+                            unexpected = [x for x in documented_overloads[current_section] if x not in expected]
+                            if len(undocumented):
+                                report('style/numbering', f'{file}:{lineno} ({current_section})', f'undocumented overloads: {", ".join([f"({x})" for x in undocumented])}')
+                            if len(unexpected):
+                                report('style/numbering', f'{file}:{lineno} ({current_section})', f'unexpected overloads: {", ".join([f"({x})" for x in unexpected])}')
+
                     current_section = line.strip('## ')
                     existing_sections.append(current_section)
 
@@ -83,13 +97,29 @@ def check_structure():
                             report('structure/section_order', f'{file}:{lineno+1}', f'section "{current_section}" is in an unexpected order (should be before "{expected_sections[section_idx]}")')
                         section_idx = idx
                     else:
-                        report('structure/unknown_section', f'{file}:{lineno+1}', f'section "{current_section}" is not part of the expected sections')
+                        if 'index.md' not in file:  # index.md files may have a different structure
+                            report('structure/unknown_section', f'{file}:{lineno+1}', f'section "{current_section}" is not part of the expected sections')
+
+                # collect the numbered items of the current section to later check if they match the number of overloads
+                if last_overload != 0 and not in_initial_code_example:
+                    if len(original_line) and original_line[0].isdigit():
+                        number = int(re.findall(r"^(\d+).", original_line)[0])
+                        if current_section not in documented_overloads:
+                            documented_overloads[current_section] = []
+                        documented_overloads[current_section].append(number)
 
                 # code example
                 if line == '```cpp' and section_idx == -1:
                     in_initial_code_example = True
 
                 if in_initial_code_example and line.startswith('//'):
+                    # check numbering of overloads
+                    if any(map(str.isdigit, line)):
+                        number = int(re.findall(r'\d+', line)[0])
+                        if number != last_overload + 1:
+                            report('style/numbering', f'{file}:{lineno+1}', f'expected number ({number}) to be ({last_overload +1 })')
+                        last_overload = number
+
                     if any(map(str.isdigit, line)) and '(' not in line:
                         report('style/numbering', f'{file}:{lineno+1}', 'number should be in parentheses: {line}')
 
@@ -98,18 +128,19 @@ def check_structure():
 
                 # consecutive blank lines are bad
                 if line == '' and previous_line == '':
-                    report('whitespace/blank_lines', f'{file}:{lineno}-{lineno+1}', 'consecutive blank lines')
+                    report('whitespace/blank_lines', f'{file}:{lineno}-{lineno+1} ({current_section})', 'consecutive blank lines')
 
                 # check that non-example admonitions have titles
                 untitled_admonition = re.match(r'^(\?\?\?|!!!) ([^ ]+)$', line)
                 if untitled_admonition and untitled_admonition.group(2) != 'example':
-                    report('style/admonition_title', f'{file}:{lineno}', f'"{untitled_admonition.group(2)}" admonitions should have a title')
+                    report('style/admonition_title', f'{file}:{lineno} ({current_section})', f'"{untitled_admonition.group(2)}" admonitions should have a title')
 
                 previous_line = line
 
-            for required_section in required_sections:
-                if required_section not in existing_sections:
-                    report('structure/missing_section', f'{file}:{lineno+1}', f'required section "{required_section}" was not found')
+            if 'index.md' not in file:  # index.md files may have a different structure
+                for required_section in required_sections:
+                    if required_section not in existing_sections:
+                        report('structure/missing_section', f'{file}:{lineno+1}', f'required section "{required_section}" was not found')
 
 
 def check_examples():
diff --git a/include/nlohmann/json.hpp b/include/nlohmann/json.hpp
index aed4a1a01..fb0f5fc18 100644
--- a/include/nlohmann/json.hpp
+++ b/include/nlohmann/json.hpp
@@ -4403,29 +4403,6 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         return res ? result : basic_json(value_t::discarded);
     }
 
-    template<typename T>
-    JSON_HEDLEY_WARN_UNUSED_RESULT
-    static basic_json from_bjdata(const T* ptr, std::size_t len,
-                                  const bool strict = true,
-                                  const bool allow_exceptions = true)
-    {
-        return from_bjdata(ptr, ptr + len, strict, allow_exceptions);
-    }
-
-    JSON_HEDLEY_WARN_UNUSED_RESULT
-    static basic_json from_bjdata(detail::span_input_adapter&& i,
-                                  const bool strict = true,
-                                  const bool allow_exceptions = true)
-    {
-        basic_json result;
-        detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
-        auto ia = i.get();
-        // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
-        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::bjdata).sax_parse(input_format_t::bjdata, &sdp, strict);
-        return res ? result : basic_json(value_t::discarded);
-    }
-
-
     /// @brief create a JSON value from an input in BSON format
     /// @sa https://json.nlohmann.me/api/basic_json/from_bson/
     template<typename InputType>
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index a29f7bce9..e2cd6bc2d 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -22512,29 +22512,6 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
         return res ? result : basic_json(value_t::discarded);
     }
 
-    template<typename T>
-    JSON_HEDLEY_WARN_UNUSED_RESULT
-    static basic_json from_bjdata(const T* ptr, std::size_t len,
-                                  const bool strict = true,
-                                  const bool allow_exceptions = true)
-    {
-        return from_bjdata(ptr, ptr + len, strict, allow_exceptions);
-    }
-
-    JSON_HEDLEY_WARN_UNUSED_RESULT
-    static basic_json from_bjdata(detail::span_input_adapter&& i,
-                                  const bool strict = true,
-                                  const bool allow_exceptions = true)
-    {
-        basic_json result;
-        detail::json_sax_dom_parser<basic_json> sdp(result, allow_exceptions);
-        auto ia = i.get();
-        // NOLINTNEXTLINE(hicpp-move-const-arg,performance-move-const-arg)
-        const bool res = binary_reader<decltype(ia)>(std::move(ia), input_format_t::bjdata).sax_parse(input_format_t::bjdata, &sdp, strict);
-        return res ? result : basic_json(value_t::discarded);
-    }
-
-
     /// @brief create a JSON value from an input in BSON format
     /// @sa https://json.nlohmann.me/api/basic_json/from_bson/
     template<typename InputType>
diff --git a/tests/CMakeLists.txt b/tests/CMakeLists.txt
index 75bc6f980..2f6409c57 100644
--- a/tests/CMakeLists.txt
+++ b/tests/CMakeLists.txt
@@ -76,7 +76,7 @@ endif()
 
 if (CMAKE_CXX_COMPILER_ID STREQUAL "MSVC")
     # avoid stack overflow, see https://github.com/nlohmann/json/issues/2955
-    json_test_set_test_options("test-cbor;test-msgpack;test-ubjson;test-bjdata" LINK_OPTIONS /STACK:4000000)
+    json_test_set_test_options("test-cbor;test-msgpack;test-ubjson;test-bjdata;test-binary_formats" LINK_OPTIONS /STACK:4000000)
 endif()
 
 # disable exceptions for test-disabled_exceptions
diff --git a/tests/src/unit-binary_formats.cpp b/tests/src/unit-binary_formats.cpp
new file mode 100644
index 000000000..05e889b0f
--- /dev/null
+++ b/tests/src/unit-binary_formats.cpp
@@ -0,0 +1,232 @@
+/*
+    __ _____ _____ _____
+ __|  |   __|     |   | |  JSON for Modern C++ (test suite)
+|  |  |__   |  |  | | | |  version 3.10.5
+|_____|_____|_____|_|___|  https://github.com/nlohmann/json
+
+Licensed under the MIT License <http://opensource.org/licenses/MIT>.
+SPDX-License-Identifier: MIT
+Copyright (c) 2013-2019 Niels Lohmann <http://nlohmann.me>.
+
+Permission is hereby  granted, free of charge, to any  person obtaining a copy
+of this software and associated  documentation files (the "Software"), to deal
+in the Software  without restriction, including without  limitation the rights
+to  use, copy,  modify, merge,  publish, distribute,  sublicense, and/or  sell
+copies  of  the Software,  and  to  permit persons  to  whom  the Software  is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE  IS PROVIDED "AS  IS", WITHOUT WARRANTY  OF ANY KIND,  EXPRESS OR
+IMPLIED,  INCLUDING BUT  NOT  LIMITED TO  THE  WARRANTIES OF  MERCHANTABILITY,
+FITNESS FOR  A PARTICULAR PURPOSE AND  NONINFRINGEMENT. IN NO EVENT  SHALL THE
+AUTHORS  OR COPYRIGHT  HOLDERS  BE  LIABLE FOR  ANY  CLAIM,  DAMAGES OR  OTHER
+LIABILITY, WHETHER IN AN ACTION OF  CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE  OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+*/
+
+#include "doctest_compatibility.h"
+
+#include <nlohmann/json.hpp>
+using nlohmann::json;
+
+#include <fstream>
+#include <test_data.hpp>
+
+TEST_CASE("Binary Formats" * doctest::skip())
+{
+    SECTION("canada.json")
+    {
+        const auto* filename = TEST_DATA_DIRECTORY "/nativejson-benchmark/canada.json";
+        json j = json::parse(std::ifstream(filename));
+
+        const auto json_size = j.dump().size();
+        const auto bjdata_1_size = json::to_bjdata(j).size();
+        const auto bjdata_2_size = json::to_bjdata(j, true).size();
+        const auto bjdata_3_size = json::to_bjdata(j, true, true).size();
+        const auto bson_size = json::to_bson(j).size();
+        const auto cbor_size = json::to_cbor(j).size();
+        const auto msgpack_size = json::to_msgpack(j).size();
+        const auto ubjson_1_size = json::to_ubjson(j).size();
+        const auto ubjson_2_size = json::to_ubjson(j, true).size();
+        const auto ubjson_3_size = json::to_ubjson(j, true, true).size();
+
+        CHECK(json_size == 2090303);
+        CHECK(bjdata_1_size == 1112030);
+        CHECK(bjdata_2_size == 1224148);
+        CHECK(bjdata_3_size == 1224148);
+        CHECK(bson_size == 1794522);
+        CHECK(cbor_size == 1055552);
+        CHECK(msgpack_size == 1056145);
+        CHECK(ubjson_1_size == 1112030);
+        CHECK(ubjson_2_size == 1224148);
+        CHECK(ubjson_3_size == 1169069);
+
+        CHECK((100.0 * double(json_size) / double(json_size)) == Approx(100.0));
+        CHECK((100.0 * double(bjdata_1_size) / double(json_size)) == Approx(53.199));
+        CHECK((100.0 * double(bjdata_2_size) / double(json_size)) == Approx(58.563));
+        CHECK((100.0 * double(bjdata_3_size) / double(json_size)) == Approx(58.563));
+        CHECK((100.0 * double(bson_size) / double(json_size)) == Approx(85.849));
+        CHECK((100.0 * double(cbor_size) / double(json_size)) == Approx(50.497));
+        CHECK((100.0 * double(msgpack_size) / double(json_size)) == Approx(50.526));
+        CHECK((100.0 * double(ubjson_1_size) / double(json_size)) == Approx(53.199));
+        CHECK((100.0 * double(ubjson_2_size) / double(json_size)) == Approx(58.563));
+        CHECK((100.0 * double(ubjson_3_size) / double(json_size)) == Approx(55.928));
+    }
+
+    SECTION("twitter.json")
+    {
+        const auto* filename = TEST_DATA_DIRECTORY "/nativejson-benchmark/twitter.json";
+        json j = json::parse(std::ifstream(filename));
+
+        const auto json_size = j.dump().size();
+        const auto bjdata_1_size = json::to_bjdata(j).size();
+        const auto bjdata_2_size = json::to_bjdata(j, true).size();
+        const auto bjdata_3_size = json::to_bjdata(j, true, true).size();
+        const auto bson_size = json::to_bson(j).size();
+        const auto cbor_size = json::to_cbor(j).size();
+        const auto msgpack_size = json::to_msgpack(j).size();
+        const auto ubjson_1_size = json::to_ubjson(j).size();
+        const auto ubjson_2_size = json::to_ubjson(j, true).size();
+        const auto ubjson_3_size = json::to_ubjson(j, true, true).size();
+
+        CHECK(json_size == 466906);
+        CHECK(bjdata_1_size == 425342);
+        CHECK(bjdata_2_size == 429970);
+        CHECK(bjdata_3_size == 429970);
+        CHECK(bson_size == 444568);
+        CHECK(cbor_size == 402814);
+        CHECK(msgpack_size == 401510);
+        CHECK(ubjson_1_size == 426160);
+        CHECK(ubjson_2_size == 430788);
+        CHECK(ubjson_3_size == 430798);
+
+        CHECK((100.0 * double(json_size) / double(json_size)) == Approx(100.0));
+        CHECK((100.0 * double(bjdata_1_size) / double(json_size)) == Approx(91.097));
+        CHECK((100.0 * double(bjdata_2_size) / double(json_size)) == Approx(92.089));
+        CHECK((100.0 * double(bjdata_3_size) / double(json_size)) == Approx(92.089));
+        CHECK((100.0 * double(bson_size) / double(json_size)) == Approx(95.215));
+        CHECK((100.0 * double(cbor_size) / double(json_size)) == Approx(86.273));
+        CHECK((100.0 * double(msgpack_size) / double(json_size)) == Approx(85.993));
+        CHECK((100.0 * double(ubjson_1_size) / double(json_size)) == Approx(91.273));
+        CHECK((100.0 * double(ubjson_2_size) / double(json_size)) == Approx(92.264));
+        CHECK((100.0 * double(ubjson_3_size) / double(json_size)) == Approx(92.266));
+    }
+
+    SECTION("citm_catalog.json")
+    {
+        const auto* filename = TEST_DATA_DIRECTORY "/nativejson-benchmark/citm_catalog.json";
+        json j = json::parse(std::ifstream(filename));
+
+        const auto json_size = j.dump().size();
+        const auto bjdata_1_size = json::to_bjdata(j).size();
+        const auto bjdata_2_size = json::to_bjdata(j, true).size();
+        const auto bjdata_3_size = json::to_bjdata(j, true, true).size();
+        const auto bson_size = json::to_bson(j).size();
+        const auto cbor_size = json::to_cbor(j).size();
+        const auto msgpack_size = json::to_msgpack(j).size();
+        const auto ubjson_1_size = json::to_ubjson(j).size();
+        const auto ubjson_2_size = json::to_ubjson(j, true).size();
+        const auto ubjson_3_size = json::to_ubjson(j, true, true).size();
+
+        CHECK(json_size == 500299);
+        CHECK(bjdata_1_size == 390781);
+        CHECK(bjdata_2_size == 433557);
+        CHECK(bjdata_3_size == 432964);
+        CHECK(bson_size == 479430);
+        CHECK(cbor_size == 342373);
+        CHECK(msgpack_size == 342473);
+        CHECK(ubjson_1_size == 391463);
+        CHECK(ubjson_2_size == 434239);
+        CHECK(ubjson_3_size == 425073);
+
+        CHECK((100.0 * double(json_size) / double(json_size)) == Approx(100.0));
+        CHECK((100.0 * double(bjdata_1_size) / double(json_size)) == Approx(78.109));
+        CHECK((100.0 * double(bjdata_2_size) / double(json_size)) == Approx(86.659));
+        CHECK((100.0 * double(bjdata_3_size) / double(json_size)) == Approx(86.541));
+        CHECK((100.0 * double(bson_size) / double(json_size)) == Approx(95.828));
+        CHECK((100.0 * double(cbor_size) / double(json_size)) == Approx(68.433));
+        CHECK((100.0 * double(msgpack_size) / double(json_size)) == Approx(68.453));
+        CHECK((100.0 * double(ubjson_1_size) / double(json_size)) == Approx(78.245));
+        CHECK((100.0 * double(ubjson_2_size) / double(json_size)) == Approx(86.795));
+        CHECK((100.0 * double(ubjson_3_size) / double(json_size)) == Approx(84.963));
+    }
+
+    SECTION("jeopardy.json")
+    {
+        const auto* filename = TEST_DATA_DIRECTORY "/jeopardy/jeopardy.json";
+        json j = json::parse(std::ifstream(filename));
+
+        const auto json_size = j.dump().size();
+        const auto bjdata_1_size = json::to_bjdata(j).size();
+        const auto bjdata_2_size = json::to_bjdata(j, true).size();
+        const auto bjdata_3_size = json::to_bjdata(j, true, true).size();
+        const auto bson_size = json::to_bson({{"", j}}).size(); // wrap array in object for BSON
+        const auto cbor_size = json::to_cbor(j).size();
+        const auto msgpack_size = json::to_msgpack(j).size();
+        const auto ubjson_1_size = json::to_ubjson(j).size();
+        const auto ubjson_2_size = json::to_ubjson(j, true).size();
+        const auto ubjson_3_size = json::to_ubjson(j, true, true).size();
+
+        CHECK(json_size == 52508728);
+        CHECK(bjdata_1_size == 50710965);
+        CHECK(bjdata_2_size == 51144830);
+        CHECK(bjdata_3_size == 51144830);
+        CHECK(bson_size == 56008520);
+        CHECK(cbor_size == 46187320);
+        CHECK(msgpack_size == 46158575);
+        CHECK(ubjson_1_size == 50710965);
+        CHECK(ubjson_2_size == 51144830);
+        CHECK(ubjson_3_size == 49861422);
+
+        CHECK((100.0 * double(json_size) / double(json_size)) == Approx(100.0));
+        CHECK((100.0 * double(bjdata_1_size) / double(json_size)) == Approx(96.576));
+        CHECK((100.0 * double(bjdata_2_size) / double(json_size)) == Approx(97.402));
+        CHECK((100.0 * double(bjdata_3_size) / double(json_size)) == Approx(97.402));
+        CHECK((100.0 * double(bson_size) / double(json_size)) == Approx(106.665));
+        CHECK((100.0 * double(cbor_size) / double(json_size)) == Approx(87.961));
+        CHECK((100.0 * double(msgpack_size) / double(json_size)) == Approx(87.906));
+        CHECK((100.0 * double(ubjson_1_size) / double(json_size)) == Approx(96.576));
+        CHECK((100.0 * double(ubjson_2_size) / double(json_size)) == Approx(97.402));
+        CHECK((100.0 * double(ubjson_3_size) / double(json_size)) == Approx(94.958));
+    }
+
+    SECTION("sample.json")
+    {
+        const auto* filename = TEST_DATA_DIRECTORY "/json_testsuite/sample.json";
+        json j = json::parse(std::ifstream(filename));
+
+        const auto json_size = j.dump().size();
+        const auto bjdata_1_size = json::to_bjdata(j).size();
+        const auto bjdata_2_size = json::to_bjdata(j, true).size();
+        const auto bjdata_3_size = json::to_bjdata(j, true, true).size();
+        // BSON cannot process the file as it contains code point  U+0000
+        const auto cbor_size = json::to_cbor(j).size();
+        const auto msgpack_size = json::to_msgpack(j).size();
+        const auto ubjson_1_size = json::to_ubjson(j).size();
+        const auto ubjson_2_size = json::to_ubjson(j, true).size();
+        const auto ubjson_3_size = json::to_ubjson(j, true, true).size();
+
+        CHECK(json_size == 168677);
+        CHECK(bjdata_1_size == 148695);
+        CHECK(bjdata_2_size == 150569);
+        CHECK(bjdata_3_size == 150569);
+        CHECK(cbor_size == 147095);
+        CHECK(msgpack_size == 147017);
+        CHECK(ubjson_1_size == 148695);
+        CHECK(ubjson_2_size == 150569);
+        CHECK(ubjson_3_size == 150883);
+
+        CHECK((100.0 * double(json_size) / double(json_size)) == Approx(100.0));
+        CHECK((100.0 * double(bjdata_1_size) / double(json_size)) == Approx(88.153));
+        CHECK((100.0 * double(bjdata_2_size) / double(json_size)) == Approx(89.264));
+        CHECK((100.0 * double(bjdata_3_size) / double(json_size)) == Approx(89.264));
+        CHECK((100.0 * double(cbor_size) / double(json_size)) == Approx(87.205));
+        CHECK((100.0 * double(msgpack_size) / double(json_size)) == Approx(87.158));
+        CHECK((100.0 * double(ubjson_1_size) / double(json_size)) == Approx(88.153));
+        CHECK((100.0 * double(ubjson_2_size) / double(json_size)) == Approx(89.264));
+        CHECK((100.0 * double(ubjson_3_size) / double(json_size)) == Approx(89.450));
+    }
+}
diff --git a/tests/src/unit-bjdata.cpp b/tests/src/unit-bjdata.cpp
index d2fa9a9b2..0a1e6e02d 100644
--- a/tests/src/unit-bjdata.cpp
+++ b/tests/src/unit-bjdata.cpp
@@ -3404,21 +3404,6 @@ TEST_CASE("BJData roundtrips" * doctest::skip())
                 CHECK(j1 == j2);
             }
 
-            {
-                INFO_WITH_TEMP(filename + ": uint8_t* and size");
-                // parse JSON file
-                std::ifstream f_json(filename);
-                json j1 = json::parse(f_json);
-
-                // parse BJData file
-                auto packed = utils::read_binary_file(filename + ".bjdata");
-                json j2;
-                CHECK_NOTHROW(j2 = json::from_bjdata({packed.data(), packed.size()}));
-
-                // compare parsed JSON values
-                CHECK(j1 == j2);
-            }
-
             {
                 INFO_WITH_TEMP(filename + ": output to output adapters");
                 // parse JSON file

From 93c9e0c703b98f5082413920a62067ae0b68671e Mon Sep 17 00:00:00 2001
From: Qianqian Fang <fangqq@gmail.com>
Date: Wed, 18 May 2022 12:38:15 -0400
Subject: [PATCH 13/30] Discard optimized containers with negative counts in
 UBJSON/BJData (#3491,#3492,#3490) (#3500)

* Discard optimized containers with negative counts in UBJSON/BJData (#3491,#3492,#3490)

* fix msvc error

* update unit tests for negative sized containers

* use a loop to test 0 ndarray dimension

* throw an error when count is negative, merge CHECK_THROW_AS and _WITH with _WITH_AS
---
 .../nlohmann/detail/input/binary_reader.hpp   |  29 +++
 single_include/nlohmann/json.hpp              |  29 +++
 tests/src/unit-bjdata.cpp                     | 234 +++++++-----------
 3 files changed, 149 insertions(+), 143 deletions(-)

diff --git a/include/nlohmann/detail/input/binary_reader.hpp b/include/nlohmann/detail/input/binary_reader.hpp
index 703e6c0f6..10f8f000f 100644
--- a/include/nlohmann/detail/input/binary_reader.hpp
+++ b/include/nlohmann/detail/input/binary_reader.hpp
@@ -2020,6 +2020,11 @@ class binary_reader
                 {
                     return false;
                 }
+                if (number < 0)
+                {
+                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read,
+                                            exception_message(input_format, "count in an optimized container must be positive", "size"), nullptr));
+                }
                 result = static_cast<std::size_t>(number); // NOLINT(bugprone-signed-char-misuse,cert-str34-c): number is not a char
                 return true;
             }
@@ -2031,6 +2036,11 @@ class binary_reader
                 {
                     return false;
                 }
+                if (number < 0)
+                {
+                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read,
+                                            exception_message(input_format, "count in an optimized container must be positive", "size"), nullptr));
+                }
                 result = static_cast<std::size_t>(number);
                 return true;
             }
@@ -2042,6 +2052,11 @@ class binary_reader
                 {
                     return false;
                 }
+                if (number < 0)
+                {
+                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read,
+                                            exception_message(input_format, "count in an optimized container must be positive", "size"), nullptr));
+                }
                 result = static_cast<std::size_t>(number);
                 return true;
             }
@@ -2053,6 +2068,11 @@ class binary_reader
                 {
                     return false;
                 }
+                if (number < 0)
+                {
+                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read,
+                                            exception_message(input_format, "count in an optimized container must be positive", "size"), nullptr));
+                }
                 result = static_cast<std::size_t>(number);
                 return true;
             }
@@ -2120,6 +2140,15 @@ class binary_reader
                 }
                 if (!dim.empty())  // if ndarray, convert to an object in JData annotated array format
                 {
+                    for (auto i : dim) // test if any dimension in an ndarray is 0, if so, return a 1D empty container
+                    {
+                        if ( i == 0 )
+                        {
+                            result = 0;
+                            return true;
+                        }
+                    }
+
                     string_t key = "_ArraySize_";
                     if (JSON_HEDLEY_UNLIKELY(!sax->start_object(3) || !sax->key(key) || !sax->start_array(dim.size())))
                     {
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index e2cd6bc2d..e1c352d82 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -10494,6 +10494,11 @@ class binary_reader
                 {
                     return false;
                 }
+                if (number < 0)
+                {
+                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read,
+                                            exception_message(input_format, "count in an optimized container must be positive", "size"), nullptr));
+                }
                 result = static_cast<std::size_t>(number); // NOLINT(bugprone-signed-char-misuse,cert-str34-c): number is not a char
                 return true;
             }
@@ -10505,6 +10510,11 @@ class binary_reader
                 {
                     return false;
                 }
+                if (number < 0)
+                {
+                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read,
+                                            exception_message(input_format, "count in an optimized container must be positive", "size"), nullptr));
+                }
                 result = static_cast<std::size_t>(number);
                 return true;
             }
@@ -10516,6 +10526,11 @@ class binary_reader
                 {
                     return false;
                 }
+                if (number < 0)
+                {
+                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read,
+                                            exception_message(input_format, "count in an optimized container must be positive", "size"), nullptr));
+                }
                 result = static_cast<std::size_t>(number);
                 return true;
             }
@@ -10527,6 +10542,11 @@ class binary_reader
                 {
                     return false;
                 }
+                if (number < 0)
+                {
+                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read,
+                                            exception_message(input_format, "count in an optimized container must be positive", "size"), nullptr));
+                }
                 result = static_cast<std::size_t>(number);
                 return true;
             }
@@ -10594,6 +10614,15 @@ class binary_reader
                 }
                 if (!dim.empty())  // if ndarray, convert to an object in JData annotated array format
                 {
+                    for (auto i : dim) // test if any dimension in an ndarray is 0, if so, return a 1D empty container
+                    {
+                        if ( i == 0 )
+                        {
+                            result = 0;
+                            return true;
+                        }
+                    }
+
                     string_t key = "_ArraySize_";
                     if (JSON_HEDLEY_UNLIKELY(!sax->start_object(3) || !sax->key(key) || !sax->start_array(dim.size())))
                     {
diff --git a/tests/src/unit-bjdata.cpp b/tests/src/unit-bjdata.cpp
index 0a1e6e02d..e9ce1b14e 100644
--- a/tests/src/unit-bjdata.cpp
+++ b/tests/src/unit-bjdata.cpp
@@ -1041,8 +1041,7 @@ TEST_CASE("BJData")
                     {
                         json _;
                         std::vector<uint8_t> vec0 = {'h'};
-                        CHECK_THROWS_AS(_ = json::from_bjdata(vec0), json::parse_error&);
-                        CHECK_THROWS_WITH(_ = json::from_bjdata(vec0), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData number: unexpected end of input");
+                        CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vec0), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
                         CHECK(json::from_bjdata(vec0, true, false).is_discarded());
                     }
 
@@ -1050,8 +1049,7 @@ TEST_CASE("BJData")
                     {
                         json _;
                         std::vector<uint8_t> vec1 = {'h', 0x00};
-                        CHECK_THROWS_AS(_ = json::from_bjdata(vec1), json::parse_error&);
-                        CHECK_THROWS_WITH(_ = json::from_bjdata(vec1), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing BJData number: unexpected end of input");
+                        CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vec1), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
                         CHECK(json::from_bjdata(vec1, true, false).is_discarded());
                     }
                 }
@@ -2022,9 +2020,8 @@ TEST_CASE("BJData")
             SECTION("strict mode")
             {
                 json _;
-                CHECK_THROWS_AS(_ = json::from_bjdata(vec), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(vec),
-                                  "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData value: expected end of input; last byte: 0x5A");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vec),
+                                     "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData value: expected end of input; last byte: 0x5A", json::parse_error&);
             }
         }
     }
@@ -2363,6 +2360,7 @@ TEST_CASE("BJData")
             {
                 // create vector with two elements of the same type
                 std::vector<uint8_t> v_0 = {'[', '$', 'i', '#', '[', ']'};
+                std::vector<uint8_t> v_E = {'[', '$', 'i', '#', '[', 'i', 2, 'i', 0, ']'};
                 std::vector<uint8_t> v_i = {'[', '$', 'i', '#', '[', 'i', 1, 'i', 2, ']', 0x7F, 0x7F};
                 std::vector<uint8_t> v_U = {'[', '$', 'U', '#', '[', 'i', 1, 'i', 2, ']', 0xFF, 0xFF};
                 std::vector<uint8_t> v_I = {'[', '$', 'I', '#', '[', 'i', 1, 'i', 2, ']', 0xFF, 0x7F, 0xFF, 0x7F};
@@ -2377,6 +2375,7 @@ TEST_CASE("BJData")
 
                 // check if vector is parsed correctly
                 CHECK(json::from_bjdata(v_0) == json::array());
+                CHECK(json::from_bjdata(v_E) == json::array());
                 CHECK(json::from_bjdata(v_i) == json({127, 127}));
                 CHECK(json::from_bjdata(v_U) == json({255, 255}));
                 CHECK(json::from_bjdata(v_I) == json({32767, 32767}));
@@ -2437,9 +2436,8 @@ TEST_CASE("BJData")
         SECTION("empty byte vector")
         {
             json _;
-            CHECK_THROWS_AS(_ = json::from_bjdata(std::vector<uint8_t>()), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(std::vector<uint8_t>()),
-                              "[json.exception.parse_error.110] parse error at byte 1: syntax error while parsing BJData value: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(std::vector<uint8_t>()),
+                                 "[json.exception.parse_error.110] parse error at byte 1: syntax error while parsing BJData value: unexpected end of input", json::parse_error&);
         }
 
         SECTION("char")
@@ -2448,15 +2446,13 @@ TEST_CASE("BJData")
             {
                 std::vector<uint8_t> v = {'C'};
                 json _;
-                CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData char: unexpected end of input");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData char: unexpected end of input", json::parse_error&);
             }
 
             SECTION("byte out of range")
             {
                 std::vector<uint8_t> v = {'C', 130};
                 json _;
-                CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
                 CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing BJData char: byte after 'C' must be in range 0x00..0x7F; last byte: 0x82");
             }
         }
@@ -2467,16 +2463,14 @@ TEST_CASE("BJData")
             {
                 std::vector<uint8_t> v = {'S'};
                 json _;
-                CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData value: unexpected end of input");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData value: unexpected end of input", json::parse_error&);
             }
 
             SECTION("invalid byte")
             {
                 std::vector<uint8_t> v = {'S', '1', 'a'};
                 json _;
-                CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing BJData string: expected length type specification (U, i, u, I, m, l, M, L); last byte: 0x31");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing BJData string: expected length type specification (U, i, u, I, m, l, M, L); last byte: 0x31", json::parse_error&);
             }
 
             SECTION("parse bjdata markers in ubjson")
@@ -2488,14 +2482,9 @@ TEST_CASE("BJData")
 
                 json _;
                 // check if string is parsed correctly to "a"
-                CHECK_THROWS_AS(_ = json::from_ubjson(s_u), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_ubjson(s_u), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing UBJSON string: expected length type specification (U, i, I, l, L); last byte: 0x75");
-
-                CHECK_THROWS_AS(_ = json::from_ubjson(s_m), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_ubjson(s_m), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing UBJSON string: expected length type specification (U, i, I, l, L); last byte: 0x6D");
-
-                CHECK_THROWS_AS(_ = json::from_ubjson(s_M), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_ubjson(s_M), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing UBJSON string: expected length type specification (U, i, I, l, L); last byte: 0x4D");
+                CHECK_THROWS_WITH_AS(_ = json::from_ubjson(s_u), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing UBJSON string: expected length type specification (U, i, I, l, L); last byte: 0x75", json::parse_error&);
+                CHECK_THROWS_WITH_AS(_ = json::from_ubjson(s_m), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing UBJSON string: expected length type specification (U, i, I, l, L); last byte: 0x6D", json::parse_error&);
+                CHECK_THROWS_WITH_AS(_ = json::from_ubjson(s_M), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing UBJSON string: expected length type specification (U, i, I, l, L); last byte: 0x4D", json::parse_error&);
             }
         }
 
@@ -2505,8 +2494,7 @@ TEST_CASE("BJData")
             {
                 std::vector<uint8_t> v = {'[', '$', 'i', 2};
                 json _;
-                CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.112] parse error at byte 4: syntax error while parsing BJData size: expected '#' after type information; last byte: 0x02");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v), "[json.exception.parse_error.112] parse error at byte 4: syntax error while parsing BJData size: expected '#' after type information; last byte: 0x02", json::parse_error&);
             }
 
             SECTION("optimized array: negative size")
@@ -2518,26 +2506,37 @@ TEST_CASE("BJData")
                 std::vector<uint8_t> v5 = {'[', '$', 'I', '#', '[', 'i', 0xF5, 'i', 0xF1, ']'};
                 std::vector<uint8_t> v6 = {'[', '#', '[', 'i', 0xF3, 'i', 0x02, ']'};
 
+                std::vector<uint8_t> vI = {'[', '#', 'I', 0x00, 0xF1};
+                std::vector<uint8_t> vl = {'[', '#', 'l', 0x00, 0x00, 0x00, 0xF2};
+                std::vector<uint8_t> vL = {'[', '#', 'L', 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xF3};
+
                 json _;
-                static bool is_64bit = (sizeof(size_t) == 8);
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v1), "[json.exception.parse_error.113] parse error at byte 4: syntax error while parsing BJData size: count in an optimized container must be positive", json::parse_error&);
+                CHECK(json::from_bjdata(v1, true, false).is_discarded());
 
-                if (is_64bit)
-                {
-                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v1), "[json.exception.out_of_range.408] excessive array size: 18446744073709551601", json::out_of_range&);
-                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v2), "[json.exception.out_of_range.408] excessive array size: 18446744073709551602", json::out_of_range&);
-                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v3), "[json.exception.out_of_range.408] excessive array size: 18446744073709551592", json::out_of_range&);
-                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v4), "[json.exception.out_of_range.408] excessive array size: 18446744073709551607", json::out_of_range&);
-                }
-                else
-                {
-                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v1), "[json.exception.out_of_range.408] excessive array size: 4294967281", json::out_of_range&);
-                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v2), "[json.exception.out_of_range.408] excessive array size: 4294967282", json::out_of_range&);
-                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v3), "[json.exception.out_of_range.408] excessive array size: 4294967272", json::out_of_range&);
-                    CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v4), "[json.exception.out_of_range.408] excessive array size: 4294967287", json::out_of_range&);
-                }
-                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v5), "[json.exception.parse_error.110] parse error at byte 11: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v2), "[json.exception.parse_error.113] parse error at byte 6: syntax error while parsing BJData size: count in an optimized container must be positive", json::parse_error&);
+                CHECK(json::from_bjdata(v2, true, false).is_discarded());
 
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v3), "[json.exception.parse_error.113] parse error at byte 7: syntax error while parsing BJData size: count in an optimized container must be positive", json::parse_error&);
+                CHECK(json::from_bjdata(v3, true, false).is_discarded());
+
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v4), "[json.exception.parse_error.113] parse error at byte 6: syntax error while parsing BJData size: count in an optimized container must be positive", json::parse_error&);
+                CHECK(json::from_bjdata(v4, true, false).is_discarded());
+
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v5), "[json.exception.parse_error.113] parse error at byte 7: syntax error while parsing BJData size: count in an optimized container must be positive", json::parse_error&);
+                CHECK(json::from_bjdata(v5, true, false).is_discarded());
+
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v6), "[json.exception.parse_error.113] parse error at byte 5: syntax error while parsing BJData size: count in an optimized container must be positive", json::parse_error&);
                 CHECK(json::from_bjdata(v6, true, false).is_discarded());
+
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vI), "[json.exception.parse_error.113] parse error at byte 5: syntax error while parsing BJData size: count in an optimized container must be positive", json::parse_error&);
+                CHECK(json::from_bjdata(vI, true, false).is_discarded());
+
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vl), "[json.exception.parse_error.113] parse error at byte 7: syntax error while parsing BJData size: count in an optimized container must be positive", json::parse_error&);
+                CHECK(json::from_bjdata(vI, true, false).is_discarded());
+
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vL), "[json.exception.parse_error.113] parse error at byte 11: syntax error while parsing BJData size: count in an optimized container must be positive", json::parse_error&);
+                CHECK(json::from_bjdata(vI, true, false).is_discarded());
             }
 
             SECTION("do not accept NTFZ markers in ndarray optimized type")
@@ -2548,20 +2547,16 @@ TEST_CASE("BJData")
                 std::vector<uint8_t> v_F = {'[', '$', 'F', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
                 std::vector<uint8_t> v_Z = {'[', '$', 'Z', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
 
-                CHECK_THROWS_AS(_ = json::from_bjdata(v_N), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(v_N), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x4E is not a permitted optimized array type");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v_N), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x4E is not a permitted optimized array type", json::parse_error&);
                 CHECK(json::from_bjdata(v_N, true, false).is_discarded());
 
-                CHECK_THROWS_AS(_ = json::from_bjdata(v_T), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(v_T), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x54 is not a permitted optimized array type");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v_T), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x54 is not a permitted optimized array type", json::parse_error&);
                 CHECK(json::from_bjdata(v_T, true, false).is_discarded());
 
-                CHECK_THROWS_AS(_ = json::from_bjdata(v_F), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(v_F), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x46 is not a permitted optimized array type");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v_F), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x46 is not a permitted optimized array type", json::parse_error&);
                 CHECK(json::from_bjdata(v_F, true, false).is_discarded());
 
-                CHECK_THROWS_AS(_ = json::from_bjdata(v_Z), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(v_Z), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x5A is not a permitted optimized array type");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v_Z), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x5A is not a permitted optimized array type", json::parse_error&);
                 CHECK(json::from_bjdata(v_Z, true, false).is_discarded());
             }
 
@@ -2573,20 +2568,16 @@ TEST_CASE("BJData")
                 std::vector<uint8_t> v_F = {'[', '$', 'F', '#', '[', 'i', 1, 'i', 2, ']'};
                 std::vector<uint8_t> v_Z = {'[', '$', 'Z', '#', '[', 'i', 1, 'i', 2, ']'};
 
-                CHECK_THROWS_AS(_ = json::from_bjdata(v_N), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(v_N), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x4E is not a permitted optimized array type");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v_N), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x4E is not a permitted optimized array type", json::parse_error&);
                 CHECK(json::from_bjdata(v_N, true, false).is_discarded());
 
-                CHECK_THROWS_AS(_ = json::from_bjdata(v_T), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(v_T), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x54 is not a permitted optimized array type");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v_T), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x54 is not a permitted optimized array type", json::parse_error&);
                 CHECK(json::from_bjdata(v_T, true, false).is_discarded());
 
-                CHECK_THROWS_AS(_ = json::from_bjdata(v_F), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(v_F), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x46 is not a permitted optimized array type");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v_F), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x46 is not a permitted optimized array type", json::parse_error&);
                 CHECK(json::from_bjdata(v_F, true, false).is_discarded());
 
-                CHECK_THROWS_AS(_ = json::from_bjdata(v_Z), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(v_Z), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x5A is not a permitted optimized array type");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v_Z), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x5A is not a permitted optimized array type", json::parse_error&);
                 CHECK(json::from_bjdata(v_Z, true, false).is_discarded());
             }
         }
@@ -2595,18 +2586,15 @@ TEST_CASE("BJData")
         {
             std::vector<uint8_t> vS = {'S'};
             json _;
-            CHECK_THROWS_AS(_ = json::from_bjdata(vS), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vS), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData value: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vS), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData value: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vS, true, false).is_discarded());
 
             std::vector<uint8_t> v = {'S', 'i', '2', 'a'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing BJData string: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing BJData string: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(v, true, false).is_discarded());
 
             std::vector<uint8_t> vC = {'C'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vC), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vC), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData char: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vC), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing BJData char: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vC, true, false).is_discarded());
         }
 
@@ -2614,47 +2602,38 @@ TEST_CASE("BJData")
         {
             std::vector<uint8_t> vU = {'[', '#', 'U'};
             json _;
-            CHECK_THROWS_AS(_ = json::from_bjdata(vU), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vU), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vU), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vU, true, false).is_discarded());
 
             std::vector<uint8_t> vi = {'[', '#', 'i'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vi), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vi), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vi), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vi, true, false).is_discarded());
 
             std::vector<uint8_t> vI = {'[', '#', 'I'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vI), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vI), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vI), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vI, true, false).is_discarded());
 
             std::vector<uint8_t> vu = {'[', '#', 'u'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vu), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vu), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vu), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vu, true, false).is_discarded());
 
             std::vector<uint8_t> vl = {'[', '#', 'l'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vl), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vl), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vl), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vl, true, false).is_discarded());
 
             std::vector<uint8_t> vm = {'[', '#', 'm'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vm), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vm), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vm), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vm, true, false).is_discarded());
 
             std::vector<uint8_t> vL = {'[', '#', 'L'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vL), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vL), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vL), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vL, true, false).is_discarded());
 
             std::vector<uint8_t> vM = {'[', '#', 'M'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vM), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vM), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vM), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vM, true, false).is_discarded());
 
             std::vector<uint8_t> v0 = {'[', '#', 'T', ']'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(v0), json::parse_error&);
             CHECK_THROWS_WITH(_ = json::from_bjdata(v0), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing BJData size: expected length type specification (U, i, u, I, m, l, M, L) after '#'; last byte: 0x54");
             CHECK(json::from_bjdata(v0, true, false).is_discarded());
         }
@@ -2663,23 +2642,19 @@ TEST_CASE("BJData")
         {
             json _;
             std::vector<uint8_t> vu = {'[', '#', 'u'};
-            CHECK_THROWS_AS(_ = json::from_ubjson(vu), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_ubjson(vu), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing UBJSON size: expected length type specification (U, i, I, l, L) after '#'; last byte: 0x75");
+            CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vu), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing UBJSON size: expected length type specification (U, i, I, l, L) after '#'; last byte: 0x75", json::parse_error&);
             CHECK(json::from_ubjson(vu, true, false).is_discarded());
 
             std::vector<uint8_t> vm = {'[', '#', 'm'};
-            CHECK_THROWS_AS(_ = json::from_ubjson(vm), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_ubjson(vm), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing UBJSON size: expected length type specification (U, i, I, l, L) after '#'; last byte: 0x6D");
+            CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vm), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing UBJSON size: expected length type specification (U, i, I, l, L) after '#'; last byte: 0x6D", json::parse_error&);
             CHECK(json::from_ubjson(vm, true, false).is_discarded());
 
             std::vector<uint8_t> vM = {'[', '#', 'M'};
-            CHECK_THROWS_AS(_ = json::from_ubjson(vM), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_ubjson(vM), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing UBJSON size: expected length type specification (U, i, I, l, L) after '#'; last byte: 0x4D");
+            CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vM), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing UBJSON size: expected length type specification (U, i, I, l, L) after '#'; last byte: 0x4D", json::parse_error&);
             CHECK(json::from_ubjson(vM, true, false).is_discarded());
 
             std::vector<uint8_t> v0 = {'[', '#', '['};
-            CHECK_THROWS_AS(_ = json::from_ubjson(v0), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_ubjson(v0), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing UBJSON size: expected length type specification (U, i, I, l, L) after '#'; last byte: 0x5B");
+            CHECK_THROWS_WITH_AS(_ = json::from_ubjson(v0), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing UBJSON size: expected length type specification (U, i, I, l, L) after '#'; last byte: 0x5B", json::parse_error&);
             CHECK(json::from_ubjson(v0, true, false).is_discarded());
         }
 
@@ -2687,23 +2662,19 @@ TEST_CASE("BJData")
         {
             std::vector<uint8_t> v0 = {'[', '$'};
             json _;
-            CHECK_THROWS_AS(_ = json::from_bjdata(v0), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(v0), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing BJData type: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v0), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing BJData type: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(v0, true, false).is_discarded());
 
             std::vector<uint8_t> vi = {'[', '$', '#'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vi), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vi), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData value: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vi), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData value: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vi, true, false).is_discarded());
 
             std::vector<uint8_t> vU = {'[', '$', 'U'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vU), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vU), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData value: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vU), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing BJData value: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vU, true, false).is_discarded());
 
             std::vector<uint8_t> v1 = {'[', '$', '['};
-            CHECK_THROWS_AS(_ = json::from_bjdata(v1), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(v1), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x5B is not a permitted optimized array type");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v1), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x5B is not a permitted optimized array type", json::parse_error&);
             CHECK(json::from_bjdata(v1, true, false).is_discarded());
         }
 
@@ -2711,18 +2682,15 @@ TEST_CASE("BJData")
         {
             std::vector<uint8_t> vST = {'[', '$', 'i', '#', 'i', 2, 1};
             json _;
-            CHECK_THROWS_AS(_ = json::from_bjdata(vST), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vST), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vST), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vST, true, false).is_discarded());
 
             std::vector<uint8_t> vS = {'[', '#', 'i', 2, 'i', 1};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vS), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vS), "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing BJData value: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vS), "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing BJData value: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vS, true, false).is_discarded());
 
             std::vector<uint8_t> v = {'[', 'i', 2, 'i', 1};
-            CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 6: syntax error while parsing BJData value: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 6: syntax error while parsing BJData value: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(v, true, false).is_discarded());
         }
 
@@ -2730,53 +2698,43 @@ TEST_CASE("BJData")
         {
             std::vector<uint8_t> vST = {'[', '$', 'i', '#', '[', '$', 'i', '#'};
             json _;
-            CHECK_THROWS_AS(_ = json::from_bjdata(vST), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vST), "[json.exception.parse_error.113] parse error at byte 9: syntax error while parsing BJData size: expected length type specification (U, i, u, I, m, l, M, L) after '#'; last byte: 0xFF");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vST), "[json.exception.parse_error.113] parse error at byte 9: syntax error while parsing BJData size: expected length type specification (U, i, u, I, m, l, M, L) after '#'; last byte: 0xFF", json::parse_error&);
             CHECK(json::from_bjdata(vST, true, false).is_discarded());
 
             std::vector<uint8_t> v = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'i', 2, 1, 2};
-            CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 13: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 13: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(v, true, false).is_discarded());
 
             std::vector<uint8_t> vS0 = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'i', 2, 1};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vS0), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vS0), "[json.exception.parse_error.110] parse error at byte 12: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vS0), "[json.exception.parse_error.110] parse error at byte 12: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vS0, true, false).is_discarded());
 
             std::vector<uint8_t> vS = {'[', '$', 'i', '#', '[', '#', 'i', 2, 1, 2, 1};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vS), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vS), "[json.exception.parse_error.113] parse error at byte 9: syntax error while parsing BJData size: expected length type specification (U, i, u, I, m, l, M, L) after '#'; last byte: 0x01");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vS), "[json.exception.parse_error.113] parse error at byte 9: syntax error while parsing BJData size: expected length type specification (U, i, u, I, m, l, M, L) after '#'; last byte: 0x01", json::parse_error&);
             CHECK(json::from_bjdata(vS, true, false).is_discarded());
 
             std::vector<uint8_t> vT = {'[', '$', 'i', '#', '[', 'i', 2, 'i'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vT), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vT), "[json.exception.parse_error.110] parse error at byte 9: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vT), "[json.exception.parse_error.110] parse error at byte 9: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vT, true, false).is_discarded());
 
             std::vector<uint8_t> vT0 = {'[', '$', 'i', '#', '[', 'i'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vT0), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vT0), "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vT0), "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vT0, true, false).is_discarded());
 
             std::vector<uint8_t> vu = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'u', 1, 0};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vu), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vu), "[json.exception.parse_error.110] parse error at byte 12: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vu), "[json.exception.parse_error.110] parse error at byte 12: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vu, true, false).is_discarded());
 
             std::vector<uint8_t> vm = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'm', 1, 0, 0, 0};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vm), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vm), "[json.exception.parse_error.110] parse error at byte 14: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vm), "[json.exception.parse_error.110] parse error at byte 14: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vm, true, false).is_discarded());
 
             std::vector<uint8_t> vM = {'[', '$', 'i', '#', '[', '$', 'i', '#', 'M', 1, 0, 0, 0, 0, 0, 0, 0};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vM), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vM), "[json.exception.parse_error.110] parse error at byte 18: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vM), "[json.exception.parse_error.110] parse error at byte 18: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vM, true, false).is_discarded());
 
             std::vector<uint8_t> vU = {'[', '$', 'U', '#', '[', '$', 'i', '#', 'i', 2, 2, 3, 1, 2, 3, 4, 5};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vU), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vU), "[json.exception.parse_error.110] parse error at byte 18: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vU), "[json.exception.parse_error.110] parse error at byte 18: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vU, true, false).is_discarded());
 
             std::vector<uint8_t> vT1 = {'[', '$', 'T', '#', '[', '$', 'i', '#', 'i', 2, 2, 3};
@@ -2790,43 +2748,35 @@ TEST_CASE("BJData")
         {
             std::vector<uint8_t> vST = {'{', '$', 'i', '#', 'i', 2, 'i', 1, 'a', 1};
             json _;
-            CHECK_THROWS_AS(_ = json::from_bjdata(vST), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vST), "[json.exception.parse_error.110] parse error at byte 11: syntax error while parsing BJData value: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vST), "[json.exception.parse_error.110] parse error at byte 11: syntax error while parsing BJData value: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vST, true, false).is_discarded());
 
             std::vector<uint8_t> vT = {'{', '$', 'i', 'i', 1, 'a', 1};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vT), json::parse_error&);
             CHECK_THROWS_WITH(_ = json::from_bjdata(vT), "[json.exception.parse_error.112] parse error at byte 4: syntax error while parsing BJData size: expected '#' after type information; last byte: 0x69");
             CHECK(json::from_bjdata(vT, true, false).is_discarded());
 
             std::vector<uint8_t> vS = {'{', '#', 'i', 2, 'i', 1, 'a', 'i', 1};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vS), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vS), "[json.exception.parse_error.110] parse error at byte 10: syntax error while parsing BJData value: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vS), "[json.exception.parse_error.110] parse error at byte 10: syntax error while parsing BJData value: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vS, true, false).is_discarded());
 
             std::vector<uint8_t> v = {'{', 'i', 1, 'a', 'i', 1};
-            CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing BJData value: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v), "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing BJData value: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(v, true, false).is_discarded());
 
             std::vector<uint8_t> v2 = {'{', 'i', 1, 'a', 'i', 1, 'i'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(v2), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(v2), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v2), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(v2, true, false).is_discarded());
 
             std::vector<uint8_t> v3 = {'{', 'i', 1, 'a'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(v3), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(v3), "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing BJData value: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v3), "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing BJData value: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(v3, true, false).is_discarded());
 
             std::vector<uint8_t> vST1 = {'{', '$', 'd', '#', 'i', 2, 'i', 1, 'a'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vST1), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vST1), "[json.exception.parse_error.110] parse error at byte 10: syntax error while parsing BJData number: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vST1), "[json.exception.parse_error.110] parse error at byte 10: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vST1, true, false).is_discarded());
 
             std::vector<uint8_t> vST2 = {'{', '#', 'i', 2, 'i', 1, 'a'};
-            CHECK_THROWS_AS(_ = json::from_bjdata(vST2), json::parse_error&);
-            CHECK_THROWS_WITH(_ = json::from_bjdata(vST2), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing BJData value: unexpected end of input");
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vST2), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing BJData value: unexpected end of input", json::parse_error&);
             CHECK(json::from_bjdata(vST2, true, false).is_discarded());
 
             std::vector<uint8_t> vO = {'{', '#', '[', 'i', 2, 'i', 1, ']', 'i', 1, 'a', 'i', 1, 'i', 1, 'b', 'i', 2};
@@ -3269,8 +3219,7 @@ TEST_CASE("Universal Binary JSON Specification Examples 1")
             {
                 json _;
                 std::vector<uint8_t> v = {'[', '$', 'N', '#', 'I', 0x00, 0x02};
-                CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x4E is not a permitted optimized array type");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x4E is not a permitted optimized array type", json::parse_error&);
                 CHECK(json::from_bjdata(v, true, false).is_discarded());
             }
 
@@ -3278,8 +3227,7 @@ TEST_CASE("Universal Binary JSON Specification Examples 1")
             {
                 json _;
                 std::vector<uint8_t> v = {'{', '$', 'Z', '#', 'i', 3, 'i', 4, 'n', 'a', 'm', 'e', 'i', 8, 'p', 'a', 's', 's', 'w', 'o', 'r', 'd', 'i', 5, 'e', 'm', 'a', 'i', 'l'};
-                CHECK_THROWS_AS(_ = json::from_bjdata(v), json::parse_error&);
-                CHECK_THROWS_WITH(_ = json::from_bjdata(v), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x5A is not a permitted optimized array type");
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v), "[json.exception.parse_error.112] parse error at byte 3: syntax error while parsing BJData type: marker 0x5A is not a permitted optimized array type", json::parse_error&);
                 CHECK(json::from_bjdata(v, true, false).is_discarded());
             }
         }

From 6ff2ea3aed110c17c2a4d9180dd5d422e1dfe6d0 Mon Sep 17 00:00:00 2001
From: Niels Lohmann <mail@nlohmann.me>
Date: Thu, 19 May 2022 19:56:33 +0200
Subject: [PATCH 14/30] :goal_net: add assertion for invariant in SAX-DOM
 parser (#3498)

---
 include/nlohmann/detail/input/json_sax.hpp | 9 +++++++++
 single_include/nlohmann/json.hpp           | 9 +++++++++
 2 files changed, 18 insertions(+)

diff --git a/include/nlohmann/detail/input/json_sax.hpp b/include/nlohmann/detail/input/json_sax.hpp
index 406008167..9355137cf 100644
--- a/include/nlohmann/detail/input/json_sax.hpp
+++ b/include/nlohmann/detail/input/json_sax.hpp
@@ -233,6 +233,9 @@ class json_sax_dom_parser
 
     bool key(string_t& val)
     {
+        JSON_ASSERT(!ref_stack.empty());
+        JSON_ASSERT(ref_stack.back()->is_object());
+
         // add null at given key and store the reference for later
         object_element = &(ref_stack.back()->m_value.object->operator[](val));
         return true;
@@ -240,6 +243,9 @@ class json_sax_dom_parser
 
     bool end_object()
     {
+        JSON_ASSERT(!ref_stack.empty());
+        JSON_ASSERT(ref_stack.back()->is_object());
+
         ref_stack.back()->set_parents();
         ref_stack.pop_back();
         return true;
@@ -259,6 +265,9 @@ class json_sax_dom_parser
 
     bool end_array()
     {
+        JSON_ASSERT(!ref_stack.empty());
+        JSON_ASSERT(ref_stack.back()->is_array());
+
         ref_stack.back()->set_parents();
         ref_stack.pop_back();
         return true;
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index e1c352d82..9ddddb17c 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -6230,6 +6230,9 @@ class json_sax_dom_parser
 
     bool key(string_t& val)
     {
+        JSON_ASSERT(!ref_stack.empty());
+        JSON_ASSERT(ref_stack.back()->is_object());
+
         // add null at given key and store the reference for later
         object_element = &(ref_stack.back()->m_value.object->operator[](val));
         return true;
@@ -6237,6 +6240,9 @@ class json_sax_dom_parser
 
     bool end_object()
     {
+        JSON_ASSERT(!ref_stack.empty());
+        JSON_ASSERT(ref_stack.back()->is_object());
+
         ref_stack.back()->set_parents();
         ref_stack.pop_back();
         return true;
@@ -6256,6 +6262,9 @@ class json_sax_dom_parser
 
     bool end_array()
     {
+        JSON_ASSERT(!ref_stack.empty());
+        JSON_ASSERT(ref_stack.back()->is_array());
+
         ref_stack.back()->set_parents();
         ref_stack.pop_back();
         return true;

From 41226d0a03ef3e1f832af4c5cdda1e354fa4fce0 Mon Sep 17 00:00:00 2001
From: Qianqian Fang <fangqq@gmail.com>
Date: Fri, 20 May 2022 03:41:51 -0400
Subject: [PATCH 15/30] prevent ndarray dimension vector from recusive array,
 nlohmann/json#3500 (#3502)

---
 include/nlohmann/detail/input/binary_reader.hpp | 7 +++++--
 single_include/nlohmann/json.hpp                | 7 +++++--
 tests/src/unit-bjdata.cpp                       | 8 ++++++++
 3 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/include/nlohmann/detail/input/binary_reader.hpp b/include/nlohmann/detail/input/binary_reader.hpp
index 10f8f000f..f2dea07c8 100644
--- a/include/nlohmann/detail/input/binary_reader.hpp
+++ b/include/nlohmann/detail/input/binary_reader.hpp
@@ -1938,7 +1938,7 @@ class binary_reader
     {
         std::pair<std::size_t, char_int_type> size_and_type;
         size_t dimlen = 0;
-        bool is_ndarray = false;
+        bool is_ndarray = true;
 
         if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type)))
         {
@@ -1994,7 +1994,6 @@ class binary_reader
     */
     bool get_ubjson_size_value(std::size_t& result, bool& is_ndarray, char_int_type prefix = 0)
     {
-        is_ndarray = false;
         if (prefix == 0)
         {
             prefix = get_ignore_noop();
@@ -2128,6 +2127,10 @@ class binary_reader
                 {
                     break;
                 }
+                if (is_ndarray) // ndarray dimensional vector can only contain integers, and can not embed another array
+                {
+                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read, exception_message(input_format, "ndarray dimention vector can only contain integers", "size"), nullptr));
+                }
                 std::vector<size_t> dim;
                 if (JSON_HEDLEY_UNLIKELY(!get_ubjson_ndarray_size(dim)))
                 {
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index 9ddddb17c..e793abf1e 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -10421,7 +10421,7 @@ class binary_reader
     {
         std::pair<std::size_t, char_int_type> size_and_type;
         size_t dimlen = 0;
-        bool is_ndarray = false;
+        bool is_ndarray = true;
 
         if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type)))
         {
@@ -10477,7 +10477,6 @@ class binary_reader
     */
     bool get_ubjson_size_value(std::size_t& result, bool& is_ndarray, char_int_type prefix = 0)
     {
-        is_ndarray = false;
         if (prefix == 0)
         {
             prefix = get_ignore_noop();
@@ -10611,6 +10610,10 @@ class binary_reader
                 {
                     break;
                 }
+                if (is_ndarray) // ndarray dimensional vector can only contain integers, and can not embed another array
+                {
+                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read, exception_message(input_format, "ndarray dimention vector can only contain integers", "size"), nullptr));
+                }
                 std::vector<size_t> dim;
                 if (JSON_HEDLEY_UNLIKELY(!get_ubjson_ndarray_size(dim)))
                 {
diff --git a/tests/src/unit-bjdata.cpp b/tests/src/unit-bjdata.cpp
index e9ce1b14e..296a8864c 100644
--- a/tests/src/unit-bjdata.cpp
+++ b/tests/src/unit-bjdata.cpp
@@ -2742,6 +2742,14 @@ TEST_CASE("BJData")
 
             std::vector<uint8_t> vh = {'[', '$', 'h', '#', '[', '$', 'i', '#', 'i', 2, 2, 3};
             CHECK(json::from_bjdata(vh, true, false).is_discarded());
+
+            std::vector<uint8_t> vR = {'[', '$', 'i', '#', '[', 'i', 1, '[', ']', ']', 1};
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vR), "[json.exception.parse_error.113] parse error at byte 8: syntax error while parsing BJData size: ndarray dimention vector can only contain integers", json::parse_error&);
+            CHECK(json::from_bjdata(vR, true, false).is_discarded());
+
+            std::vector<uint8_t> vRo = {'[', '$', 'i', '#', '[', 'i', 0, '{', '}', ']', 1};
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vRo), "[json.exception.parse_error.113] parse error at byte 8: syntax error while parsing BJData size: expected length type specification (U, i, u, I, m, l, M, L) after '#'; last byte: 0x7B", json::parse_error&);
+            CHECK(json::from_bjdata(vRo, true, false).is_discarded());
         }
 
         SECTION("objects")

From ede66678580596028bcd6e18871a35a54bac01d7 Mon Sep 17 00:00:00 2001
From: Qianqian Fang <fangqq@gmail.com>
Date: Mon, 23 May 2022 00:07:22 -0400
Subject: [PATCH 16/30] Prevent ndarray size vector from recursive use, fix
 nlohmann/json#3503 (#3505)

* Prevent ndarray size vector from recursive use, fix nlohmann/json#3503

* fix ci error

* complete coverage

* add missing coverage

* fix style issue in added test
---
 .../nlohmann/detail/input/binary_reader.hpp   | 36 ++++++++++++-------
 single_include/nlohmann/json.hpp              | 36 ++++++++++++-------
 tests/src/unit-bjdata.cpp                     | 31 ++++++++++++++++
 3 files changed, 77 insertions(+), 26 deletions(-)

diff --git a/include/nlohmann/detail/input/binary_reader.hpp b/include/nlohmann/detail/input/binary_reader.hpp
index f2dea07c8..d259e0448 100644
--- a/include/nlohmann/detail/input/binary_reader.hpp
+++ b/include/nlohmann/detail/input/binary_reader.hpp
@@ -1938,9 +1938,9 @@ class binary_reader
     {
         std::pair<std::size_t, char_int_type> size_and_type;
         size_t dimlen = 0;
-        bool is_ndarray = true;
+        bool inside_ndarray = true;
 
-        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type)))
+        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type, inside_ndarray)))
         {
             return false;
         }
@@ -1953,7 +1953,7 @@ class binary_reader
                 {
                     for (std::size_t i = 0; i < size_and_type.first; ++i)
                     {
-                        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, is_ndarray, size_and_type.second)))
+                        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, inside_ndarray, size_and_type.second)))
                         {
                             return false;
                         }
@@ -1965,7 +1965,7 @@ class binary_reader
             {
                 for (std::size_t i = 0; i < size_and_type.first; ++i)
                 {
-                    if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, is_ndarray)))
+                    if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, inside_ndarray)))
                     {
                         return false;
                     }
@@ -1977,7 +1977,7 @@ class binary_reader
         {
             while (current != ']')
             {
-                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, is_ndarray, current)))
+                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, inside_ndarray, current)))
                 {
                     return false;
                 }
@@ -1990,9 +1990,12 @@ class binary_reader
 
     /*!
     @param[out] result  determined size
+    @param[in,out] inside_ndarray  whether the parser is parsing an ND array dimensional vector
+    @param[in] prefix  type marker if already read, otherwise set to 0
+
     @return whether size determination completed
     */
-    bool get_ubjson_size_value(std::size_t& result, bool& is_ndarray, char_int_type prefix = 0)
+    bool get_ubjson_size_value(std::size_t& result, bool& inside_ndarray, char_int_type prefix = 0)
     {
         if (prefix == 0)
         {
@@ -2127,7 +2130,7 @@ class binary_reader
                 {
                     break;
                 }
-                if (is_ndarray) // ndarray dimensional vector can only contain integers, and can not embed another array
+                if (inside_ndarray) // ndarray dimensional vector can only contain integers, and can not embed another array
                 {
                     return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read, exception_message(input_format, "ndarray dimention vector can only contain integers", "size"), nullptr));
                 }
@@ -2166,7 +2169,7 @@ class binary_reader
                             return false;
                         }
                     }
-                    is_ndarray = true;
+                    inside_ndarray = true;
                     return sax->end_array();
                 }
                 result = 0;
@@ -2197,14 +2200,15 @@ class binary_reader
     for a more compact representation.
 
     @param[out] result  pair of the size and the type
+    @param[in] inside_ndarray  whether the parser is parsing an ND array dimensional vector
 
     @return whether pair creation completed
     */
-    bool get_ubjson_size_type(std::pair<std::size_t, char_int_type>& result)
+    bool get_ubjson_size_type(std::pair<std::size_t, char_int_type>& result, bool inside_ndarray = false)
     {
-        bool is_ndarray = false;
         result.first = string_t::npos; // size
         result.second = 0; // type
+        bool is_ndarray = false;
 
         get_ignore_noop();
 
@@ -2240,6 +2244,11 @@ class binary_reader
             bool is_error = get_ubjson_size_value(result.first, is_ndarray);
             if (input_format == input_format_t::bjdata && is_ndarray)
             {
+                if (inside_ndarray)
+                {
+                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(112, chars_read,
+                                            exception_message(input_format, "ndarray can not be recursive", "size"), nullptr));
+                }
                 result.second |= (1 << 8); // use bit 8 to indicate ndarray, all UBJSON and BJData markers should be ASCII letters
             }
             return is_error;
@@ -2250,7 +2259,8 @@ class binary_reader
             bool is_error = get_ubjson_size_value(result.first, is_ndarray);
             if (input_format == input_format_t::bjdata && is_ndarray)
             {
-                result.second |= (1 << 8); // use bit 8 to indicate ndarray, all UBJSON and BJData markers should be ASCII letters
+                return sax->parse_error(chars_read, get_token_string(), parse_error::create(112, chars_read,
+                                        exception_message(input_format, "ndarray requires both type and size", "size"), nullptr));
             }
             return is_error;
         }
@@ -2640,8 +2650,8 @@ class binary_reader
     {
         // get size of following number string
         std::size_t size{};
-        bool is_ndarray = false;
-        auto res = get_ubjson_size_value(size, is_ndarray);
+        bool inside_ndarray = false;
+        auto res = get_ubjson_size_value(size, inside_ndarray);
         if (JSON_HEDLEY_UNLIKELY(!res))
         {
             return res;
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index e793abf1e..5993ce32a 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -10421,9 +10421,9 @@ class binary_reader
     {
         std::pair<std::size_t, char_int_type> size_and_type;
         size_t dimlen = 0;
-        bool is_ndarray = true;
+        bool inside_ndarray = true;
 
-        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type)))
+        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type, inside_ndarray)))
         {
             return false;
         }
@@ -10436,7 +10436,7 @@ class binary_reader
                 {
                     for (std::size_t i = 0; i < size_and_type.first; ++i)
                     {
-                        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, is_ndarray, size_and_type.second)))
+                        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, inside_ndarray, size_and_type.second)))
                         {
                             return false;
                         }
@@ -10448,7 +10448,7 @@ class binary_reader
             {
                 for (std::size_t i = 0; i < size_and_type.first; ++i)
                 {
-                    if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, is_ndarray)))
+                    if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, inside_ndarray)))
                     {
                         return false;
                     }
@@ -10460,7 +10460,7 @@ class binary_reader
         {
             while (current != ']')
             {
-                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, is_ndarray, current)))
+                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, inside_ndarray, current)))
                 {
                     return false;
                 }
@@ -10473,9 +10473,12 @@ class binary_reader
 
     /*!
     @param[out] result  determined size
+    @param[in,out] inside_ndarray  whether the parser is parsing an ND array dimensional vector
+    @param[in] prefix  type marker if already read, otherwise set to 0
+
     @return whether size determination completed
     */
-    bool get_ubjson_size_value(std::size_t& result, bool& is_ndarray, char_int_type prefix = 0)
+    bool get_ubjson_size_value(std::size_t& result, bool& inside_ndarray, char_int_type prefix = 0)
     {
         if (prefix == 0)
         {
@@ -10610,7 +10613,7 @@ class binary_reader
                 {
                     break;
                 }
-                if (is_ndarray) // ndarray dimensional vector can only contain integers, and can not embed another array
+                if (inside_ndarray) // ndarray dimensional vector can only contain integers, and can not embed another array
                 {
                     return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read, exception_message(input_format, "ndarray dimention vector can only contain integers", "size"), nullptr));
                 }
@@ -10649,7 +10652,7 @@ class binary_reader
                             return false;
                         }
                     }
-                    is_ndarray = true;
+                    inside_ndarray = true;
                     return sax->end_array();
                 }
                 result = 0;
@@ -10680,14 +10683,15 @@ class binary_reader
     for a more compact representation.
 
     @param[out] result  pair of the size and the type
+    @param[in] inside_ndarray  whether the parser is parsing an ND array dimensional vector
 
     @return whether pair creation completed
     */
-    bool get_ubjson_size_type(std::pair<std::size_t, char_int_type>& result)
+    bool get_ubjson_size_type(std::pair<std::size_t, char_int_type>& result, bool inside_ndarray = false)
     {
-        bool is_ndarray = false;
         result.first = string_t::npos; // size
         result.second = 0; // type
+        bool is_ndarray = false;
 
         get_ignore_noop();
 
@@ -10723,6 +10727,11 @@ class binary_reader
             bool is_error = get_ubjson_size_value(result.first, is_ndarray);
             if (input_format == input_format_t::bjdata && is_ndarray)
             {
+                if (inside_ndarray)
+                {
+                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(112, chars_read,
+                                            exception_message(input_format, "ndarray can not be recursive", "size"), nullptr));
+                }
                 result.second |= (1 << 8); // use bit 8 to indicate ndarray, all UBJSON and BJData markers should be ASCII letters
             }
             return is_error;
@@ -10733,7 +10742,8 @@ class binary_reader
             bool is_error = get_ubjson_size_value(result.first, is_ndarray);
             if (input_format == input_format_t::bjdata && is_ndarray)
             {
-                result.second |= (1 << 8); // use bit 8 to indicate ndarray, all UBJSON and BJData markers should be ASCII letters
+                return sax->parse_error(chars_read, get_token_string(), parse_error::create(112, chars_read,
+                                        exception_message(input_format, "ndarray requires both type and size", "size"), nullptr));
             }
             return is_error;
         }
@@ -11123,8 +11133,8 @@ class binary_reader
     {
         // get size of following number string
         std::size_t size{};
-        bool is_ndarray = false;
-        auto res = get_ubjson_size_value(size, is_ndarray);
+        bool inside_ndarray = false;
+        auto res = get_ubjson_size_value(size, inside_ndarray);
         if (JSON_HEDLEY_UNLIKELY(!res))
         {
             return res;
diff --git a/tests/src/unit-bjdata.cpp b/tests/src/unit-bjdata.cpp
index 296a8864c..c93a5de51 100644
--- a/tests/src/unit-bjdata.cpp
+++ b/tests/src/unit-bjdata.cpp
@@ -2372,6 +2372,7 @@ TEST_CASE("BJData")
                 std::vector<uint8_t> v_D = {'[', '$', 'D', '#', '[', 'i', 1, 'i', 2, ']', 0x4a, 0xd8, 0x12, 0x4d, 0xfb, 0x21, 0x09, 0x40, 0x4a, 0xd8, 0x12, 0x4d, 0xfb, 0x21, 0x09, 0x40};
                 std::vector<uint8_t> v_S = {'[', '#', '[', 'i', 1, 'i', 2, ']', 'S', 'i', 1, 'a', 'S', 'i', 1, 'a'};
                 std::vector<uint8_t> v_C = {'[', '$', 'C', '#', '[', 'i', 1, 'i', 2, ']', 'a', 'a'};
+                std::vector<uint8_t> v_R = {'[', '#', '[', 'i', 2, ']', 'i', 6, 'U', 7};
 
                 // check if vector is parsed correctly
                 CHECK(json::from_bjdata(v_0) == json::array());
@@ -2387,6 +2388,7 @@ TEST_CASE("BJData")
                 CHECK(json::from_bjdata(v_D) == json({3.1415926, 3.1415926}));
                 CHECK(json::from_bjdata(v_S) == json({"a", "a"}));
                 CHECK(json::from_bjdata(v_C) == json({"a", "a"}));
+                CHECK(json::from_bjdata(v_R) == json({6, 7}));
             }
 
             SECTION("optimized ndarray (type and vector-size as size-optimized array)")
@@ -2750,6 +2752,30 @@ TEST_CASE("BJData")
             std::vector<uint8_t> vRo = {'[', '$', 'i', '#', '[', 'i', 0, '{', '}', ']', 1};
             CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vRo), "[json.exception.parse_error.113] parse error at byte 8: syntax error while parsing BJData size: expected length type specification (U, i, u, I, m, l, M, L) after '#'; last byte: 0x7B", json::parse_error&);
             CHECK(json::from_bjdata(vRo, true, false).is_discarded());
+
+            std::vector<uint8_t> vR1 = {'[', '$', 'i', '#', '[', '[', 'i', 1, ']', ']', 1};
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vR1), "[json.exception.parse_error.113] parse error at byte 6: syntax error while parsing BJData size: ndarray dimention vector can only contain integers", json::parse_error&);
+            CHECK(json::from_bjdata(vR1, true, false).is_discarded());
+
+            std::vector<uint8_t> vR2 = {'[', '$', 'i', '#', '[', '#', '[', 'i', 1, ']', ']', 1};
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vR2), "[json.exception.parse_error.113] parse error at byte 11: syntax error while parsing BJData size: expected length type specification (U, i, u, I, m, l, M, L) after '#'; last byte: 0x5D", json::parse_error&);
+            CHECK(json::from_bjdata(vR2, true, false).is_discarded());
+
+            std::vector<uint8_t> vR3 = {'[', '#', '[', 'i', '2', 'i', 2, ']'};
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vR3), "[json.exception.parse_error.112] parse error at byte 8: syntax error while parsing BJData size: ndarray requires both type and size", json::parse_error&);
+            CHECK(json::from_bjdata(vR3, true, false).is_discarded());
+
+            std::vector<uint8_t> vR4 = {'[', '$', 'i', '#', '[', '$', 'i', '#', '[', 'i', 1, ']', 1};
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vR4), "[json.exception.parse_error.110] parse error at byte 14: syntax error while parsing BJData number: unexpected end of input", json::parse_error&);
+            CHECK(json::from_bjdata(vR4, true, false).is_discarded());
+
+            std::vector<uint8_t> vR5 = {'[', '$', 'i', '#', '[', '[', '[', ']', ']', ']'};
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vR5), "[json.exception.parse_error.113] parse error at byte 6: syntax error while parsing BJData size: ndarray dimention vector can only contain integers", json::parse_error&);
+            CHECK(json::from_bjdata(vR5, true, false).is_discarded());
+
+            std::vector<uint8_t> vR6 = {'[', '$', 'i', '#', '[', '$', 'i', '#', '[', 'i', '2', 'i', 2, ']'};
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vR6), "[json.exception.parse_error.112] parse error at byte 14: syntax error while parsing BJData size: ndarray can not be recursive", json::parse_error&);
+            CHECK(json::from_bjdata(vR6, true, false).is_discarded());
         }
 
         SECTION("objects")
@@ -2788,7 +2814,12 @@ TEST_CASE("BJData")
             CHECK(json::from_bjdata(vST2, true, false).is_discarded());
 
             std::vector<uint8_t> vO = {'{', '#', '[', 'i', 2, 'i', 1, ']', 'i', 1, 'a', 'i', 1, 'i', 1, 'b', 'i', 2};
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vO), "[json.exception.parse_error.112] parse error at byte 8: syntax error while parsing BJData size: ndarray requires both type and size", json::parse_error&);
             CHECK(json::from_bjdata(vO, true, false).is_discarded());
+
+            std::vector<uint8_t> vO2 = {'{', '$', 'i', '#', '[', 'i', 2, 'i', 1, ']', 'i', 1, 'a', 1, 'i', 1, 'b', 2};
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vO2), "[json.exception.parse_error.112] parse error at byte 10: syntax error while parsing BJData object: BJData object does not support ND-array size in optimized format", json::parse_error&);
+            CHECK(json::from_bjdata(vO2, true, false).is_discarded());
         }
     }
 

From 6b97599a274b9b72caffa1332d5384c9aac27590 Mon Sep 17 00:00:00 2001
From: Florian Albrechtskirchinger <falbrechtskirchinger@gmail.com>
Date: Sun, 29 May 2022 13:08:06 +0200
Subject: [PATCH 17/30] Fix C++20/gcc-12 issues (Part 2) (#3446)

* Add C++20 3-way comparison operator and fix broken comparisons

Fixes #3207.
Fixes #3409.

* Fix iterators to meet (more) std::ranges requirements

Fixes #3130.
Related discussion: #3408

* Add note about CMake standard version selection to unit tests

Document how CMake chooses which C++ standard version to use when
building tests.

* Update documentation

* CI: add legacy discarded value comparison

* Fix internal linkage errors when building a module
---
 .github/workflows/ubuntu.yml                  |   2 +-
 CMakeLists.txt                                |  24 +-
 cmake/ci.cmake                                |  19 +-
 cmake/test.cmake                              |  17 +-
 docs/mkdocs/docs/api/basic_json/index.md      |   3 +-
 .../mkdocs/docs/api/basic_json/operator_eq.md |  37 +-
 .../mkdocs/docs/api/basic_json/operator_ge.md |  40 +-
 .../mkdocs/docs/api/basic_json/operator_gt.md |  38 +-
 .../mkdocs/docs/api/basic_json/operator_le.md |  40 +-
 .../mkdocs/docs/api/basic_json/operator_lt.md |  61 +-
 .../mkdocs/docs/api/basic_json/operator_ne.md |  39 +-
 .../docs/api/basic_json/operator_spaceship.md |  70 ++
 docs/mkdocs/docs/api/basic_json/value_t.md    |  39 +-
 docs/mkdocs/docs/api/macros/index.md          |   8 +
 .../mkdocs/docs/api/macros/json_has_ranges.md |  18 +
 .../macros/json_has_three_way_comparison.md   |  19 +
 ...n_use_legacy_discarded_value_comparison.md |  61 ++
 docs/mkdocs/docs/css/custom.css               |   4 +
 docs/mkdocs/mkdocs.yml                        |  15 +-
 .../nlohmann/detail/conversions/from_json.hpp |  49 +-
 .../nlohmann/detail/conversions/to_json.hpp   |  47 +-
 .../nlohmann/detail/iterators/iter_impl.hpp   |   5 +-
 .../detail/iterators/iteration_proxy.hpp      |  65 +-
 include/nlohmann/detail/macro_scope.hpp       |  31 +-
 include/nlohmann/detail/macro_unscope.hpp     |   3 +
 include/nlohmann/detail/value_t.hpp           |  30 +-
 include/nlohmann/json.hpp                     | 374 +++++----
 single_include/nlohmann/json.hpp              | 759 +++++++++++-------
 tests/CMakeLists.txt                          |   9 +
 tests/src/unit-class_parser.cpp               |   8 +-
 tests/src/unit-comparison.cpp                 | 554 ++++++++++---
 tests/src/unit-conversions.cpp                |  15 +-
 tests/src/unit-items.cpp                      |  32 +-
 tests/src/unit-iterators2.cpp                 | 109 +++
 tests/src/unit-regression2.cpp                |   9 +-
 35 files changed, 1963 insertions(+), 690 deletions(-)
 create mode 100644 docs/mkdocs/docs/api/basic_json/operator_spaceship.md
 create mode 100644 docs/mkdocs/docs/api/macros/json_has_ranges.md
 create mode 100644 docs/mkdocs/docs/api/macros/json_has_three_way_comparison.md
 create mode 100644 docs/mkdocs/docs/api/macros/json_use_legacy_discarded_value_comparison.md
 create mode 100644 docs/mkdocs/docs/css/custom.css

diff --git a/.github/workflows/ubuntu.yml b/.github/workflows/ubuntu.yml
index 4d037e060..39098e4d7 100644
--- a/.github/workflows/ubuntu.yml
+++ b/.github/workflows/ubuntu.yml
@@ -48,7 +48,7 @@ jobs:
     container: ghcr.io/nlohmann/json-ci:v2.3.0
     strategy:
       matrix:
-        target: [ci_test_diagnostics, ci_test_noexceptions, ci_test_noimplicitconversions]
+        target: [ci_test_diagnostics, ci_test_noexceptions, ci_test_noimplicitconversions, ci_test_legacycomparison]
     steps:
       - uses: actions/checkout@v3
       - name: cmake
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 8f65d9a32..632e6dec2 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -37,13 +37,14 @@ if(${MAIN_PROJECT} AND (${CMAKE_VERSION} VERSION_EQUAL 3.13 OR ${CMAKE_VERSION}
 else()
     set(JSON_BuildTests_INIT OFF)
 endif()
-option(JSON_BuildTests          "Build the unit tests when BUILD_TESTING is enabled." ${JSON_BuildTests_INIT})
-option(JSON_CI                  "Enable CI build targets." OFF)
-option(JSON_Diagnostics         "Use extended diagnostic messages." OFF)
-option(JSON_ImplicitConversions "Enable implicit conversions." ON)
-option(JSON_Install             "Install CMake targets during install step." ${MAIN_PROJECT})
-option(JSON_MultipleHeaders     "Use non-amalgamated version of the library." OFF)
-option(JSON_SystemInclude       "Include as system headers (skip for clang-tidy)." OFF)
+option(JSON_BuildTests                     "Build the unit tests when BUILD_TESTING is enabled." ${JSON_BuildTests_INIT})
+option(JSON_CI                             "Enable CI build targets." OFF)
+option(JSON_Diagnostics                    "Use extended diagnostic messages." OFF)
+option(JSON_ImplicitConversions            "Enable implicit conversions." ON)
+option(JSON_LegacyDiscardedValueComparison "Enable legacy discarded value comparison." OFF)           
+option(JSON_Install                        "Install CMake targets during install step." ${MAIN_PROJECT})
+option(JSON_MultipleHeaders                "Use non-amalgamated version of the library." OFF)
+option(JSON_SystemInclude                  "Include as system headers (skip for clang-tidy)." OFF)
 
 if (JSON_CI)
     include(ci)
@@ -77,6 +78,10 @@ if (NOT JSON_ImplicitConversions)
     message(STATUS "Implicit conversions are disabled")
 endif()
 
+if (JSON_LegacyDiscardedValueComparison)
+    message(STATUS "Legacy discarded value comparison enabled")
+endif()
+
 if (JSON_Diagnostics)
     message(STATUS "Diagnostics enabled")
 endif()
@@ -100,8 +105,9 @@ endif()
 target_compile_definitions(
     ${NLOHMANN_JSON_TARGET_NAME}
     INTERFACE
-    JSON_USE_IMPLICIT_CONVERSIONS=$<BOOL:${JSON_ImplicitConversions}>
-    JSON_DIAGNOSTICS=$<BOOL:${JSON_Diagnostics}>
+    $<$<NOT:$<BOOL:${JSON_ImplicitConversions}>>:JSON_USE_IMPLICIT_CONVERSIONS=0>
+    $<$<BOOL:${JSON_Diagnostics}>:JSON_DIAGNOSTICS=1>
+    $<$<BOOL:${JSON_LegacyDiscardedValueComparison}>:JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON=1>
 )
 
 target_include_directories(
diff --git a/cmake/ci.cmake b/cmake/ci.cmake
index 56a80c066..ed26e02b5 100644
--- a/cmake/ci.cmake
+++ b/cmake/ci.cmake
@@ -498,6 +498,20 @@ add_custom_target(ci_test_diagnostics
     COMMENT "Compile and test with improved diagnostics enabled"
 )
 
+###############################################################################
+# Enable legacy discarded value comparison.
+###############################################################################
+
+add_custom_target(ci_test_legacycomparison
+    COMMAND CXX=${CLANG_TOOL} ${CMAKE_COMMAND}
+    -DCMAKE_BUILD_TYPE=Debug -GNinja
+    -DJSON_BuildTests=ON -DJSON_MultipleHeaders=ON -DJSON_LegacyDiscardedValueComparison=ON
+    -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_legacycomparison
+    COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_legacycomparison
+    COMMAND cd ${PROJECT_BINARY_DIR}/build_legacycomparison && ${CMAKE_CTEST_COMMAND} --parallel ${N} --output-on-failure
+    COMMENT "Compile and test with legacy discarded value comparison enabled"
+)
+
 ###############################################################################
 # Coverage.
 ###############################################################################
@@ -797,8 +811,9 @@ endfunction()
 ci_get_cmake(3.1.0 CMAKE_3_1_0_BINARY)
 ci_get_cmake(3.13.0 CMAKE_3_13_0_BINARY)
 
-set(JSON_CMAKE_FLAGS_3_1_0 "JSON_Install;JSON_MultipleHeaders;JSON_ImplicitConversions;JSON_Valgrind;JSON_Diagnostics;JSON_SystemInclude")
-set(JSON_CMAKE_FLAGS_3_13_0 "JSON_BuildTests")
+set(JSON_CMAKE_FLAGS_3_1_0 JSON_Diagnostics JSON_ImplicitConversions JSON_LegacyDiscardedValueComparison 
+    JSON_Install JSON_MultipleHeaders JSON_SystemInclude JSON_Valgrind)
+set(JSON_CMAKE_FLAGS_3_13_0 JSON_BuildTests)
 
 function(ci_add_cmake_flags_targets flag min_version)
     string(TOLOWER "ci_cmake_flag_${flag}" flag_target)
diff --git a/cmake/test.cmake b/cmake/test.cmake
index 1d146646b..89b7c6ec7 100644
--- a/cmake/test.cmake
+++ b/cmake/test.cmake
@@ -156,6 +156,7 @@ endfunction()
 #############################################################################
 # json_test_add_test_for(
 #     <file>
+#     [NAME <name>]
 #     MAIN <main>
 #     [CXX_STANDARDS <version_number>...] [FORCE])
 #
@@ -165,6 +166,7 @@ endfunction()
 #
 # if C++ standard <version_number> is supported by the compiler and the
 # source file contains JSON_HAS_CPP_<version_number>.
+# Use NAME <name> to override the filename-derived test name.
 # Use FORCE to create the test regardless of the file containing
 # JSON_HAS_CPP_<version_number>.
 # Test targets are linked against <main>.
@@ -172,15 +174,22 @@ endfunction()
 #############################################################################
 
 function(json_test_add_test_for file)
-    cmake_parse_arguments(args "FORCE" "MAIN" "CXX_STANDARDS" ${ARGN})
-
-    get_filename_component(file_basename ${file} NAME_WE)
-    string(REGEX REPLACE "unit-([^$]+)" "test-\\1" test_name ${file_basename})
+    cmake_parse_arguments(args "FORCE" "MAIN;NAME" "CXX_STANDARDS" ${ARGN})
 
     if("${args_MAIN}" STREQUAL "")
         message(FATAL_ERROR "Required argument MAIN <main> missing.")
     endif()
 
+    if("${args_NAME}" STREQUAL "")
+        get_filename_component(file_basename ${file} NAME_WE)
+        string(REGEX REPLACE "unit-([^$]+)" "test-\\1" test_name ${file_basename})
+    else()
+        set(test_name ${args_NAME})
+        if(NOT test_name MATCHES "test-[^$]+")
+            message(FATAL_ERROR "Test name must start with 'test-'.")
+        endif()
+    endif()
+
     if("${args_CXX_STANDARDS}" STREQUAL "")
         set(args_CXX_STANDARDS 11)
     endif()
diff --git a/docs/mkdocs/docs/api/basic_json/index.md b/docs/mkdocs/docs/api/basic_json/index.md
index bc4dba153..2191d671f 100644
--- a/docs/mkdocs/docs/api/basic_json/index.md
+++ b/docs/mkdocs/docs/api/basic_json/index.md
@@ -233,9 +233,10 @@ Access to the JSON value
 - [**operator==**](operator_eq.md) - comparison: equal
 - [**operator!=**](operator_ne.md) - comparison: not equal
 - [**operator<**](operator_lt.md) - comparison: less than
-- [**operator<=**](operator_le.md) - comparison: less than or equal
 - [**operator>**](operator_gt.md) - comparison: greater than
+- [**operator<=**](operator_le.md) - comparison: less than or equal
 - [**operator>=**](operator_ge.md) - comparison: greater than or equal
+- [**operator<=>**](operator_spaceship.md) - comparison: 3-way
 
 ### Serialization / Dumping
 
diff --git a/docs/mkdocs/docs/api/basic_json/operator_eq.md b/docs/mkdocs/docs/api/basic_json/operator_eq.md
index 3eec4fda4..6c86bf13e 100644
--- a/docs/mkdocs/docs/api/basic_json/operator_eq.md
+++ b/docs/mkdocs/docs/api/basic_json/operator_eq.md
@@ -1,21 +1,31 @@
 # <small>nlohmann::basic_json::</small>operator==
 
 ```cpp
-bool operator==(const_reference lhs, const_reference rhs) noexcept;
+// until C++20
+bool operator==(const_reference lhs, const_reference rhs) noexcept;   // (1)
 
 template<typename ScalarType>
-bool operator==(const_reference lhs, const ScalarType rhs) noexcept;
+bool operator==(const_reference lhs, const ScalarType rhs) noexcept;  // (2)
 
 template<typename ScalarType>
-bool operator==(ScalarType lhs, const const_reference rhs) noexcept;
+bool operator==(ScalarType lhs, const const_reference rhs) noexcept;  // (2)
+
+// since C++20
+class basic_json {
+    bool operator==(const_reference rhs) const noexcept;              // (1)
+
+    template<typename ScalarType>
+    bool operator==(ScalarType rhs) const noexcept;                   // (2)
+};
 ```
 
-Compares two JSON values for equality according to the following rules:
+1. Compares two JSON values for equality according to the following rules:
+    - Two JSON values are equal if (1) neither value is discarded, or (2) they are of the same
+      type and their stored values are the same according to their respective `operator==`.
+    - Integer and floating-point numbers are automatically converted before comparison.
 
-- Two JSON values are equal if (1) they are not discarded, (2) they are from the same type, and (3) their stored values
-  are the same according to their respective `operator==`.
-- Integer and floating-point numbers are automatically converted before comparison. Note that two NaN values are always
-  treated as unequal.
+2. Compares a JSON value and a scalar or a scalar and a JSON value for equality by converting the
+   scalar to a JSON value and comparing both JSON values according to 1.
 
 ## Template parameters
 
@@ -32,7 +42,7 @@ Compares two JSON values for equality according to the following rules:
 
 ## Return value
 
-whether the values `lhs` and `rhs` are equal
+whether the values `lhs`/`*this` and `rhs` are equal
 
 ## Exception safety
 
@@ -46,7 +56,11 @@ Linear.
 
 !!! note "Comparing special values"
 
-    - NaN values never compare equal to themselves or to other NaN values.
+    - `NaN` values are unordered within the domain of numbers.
+      The following comparisons all yield `#!cpp false`:
+        1. Comparing a `NaN` with itself.
+        2. Comparing a `NaN` with another `NaN`.
+        3. Comparing a `NaN` and any other number.
     - JSON `#!cpp null` values are all equal.
     - Discarded values never compare equal to themselves.
 
@@ -117,4 +131,5 @@ Linear.
 
 ## Version history
 
-- Added in version 1.0.0.
+1. Added in version 1.0.0. Added C++20 member functions in version 3.11.0.
+2. Added in version 1.0.0. Added C++20 member functions in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/basic_json/operator_ge.md b/docs/mkdocs/docs/api/basic_json/operator_ge.md
index 68aac6557..6730f6809 100644
--- a/docs/mkdocs/docs/api/basic_json/operator_ge.md
+++ b/docs/mkdocs/docs/api/basic_json/operator_ge.md
@@ -1,17 +1,25 @@
 # <small>nlohmann::basic_json::</small>operator>=
 
 ```cpp
-bool operator>=(const_reference lhs, const_reference rhs) noexcept,
+// until C++20
+bool operator>=(const_reference lhs, const_reference rhs) noexcept;   // (1)
 
 template<typename ScalarType>
-bool operator>=(const_reference lhs, const ScalarType rhs) noexcept;
+bool operator>=(const_reference lhs, const ScalarType rhs) noexcept;  // (2)
 
 template<typename ScalarType>
-bool operator>=(ScalarType lhs, const const_reference rhs) noexcept;
+bool operator>=(ScalarType lhs, const const_reference rhs) noexcept;  // (2)
 ```
 
-Compares whether one JSON value `lhs` is greater than or equal to another JSON value `rhs` by calculating
-`#!cpp !(lhs < rhs)`.
+1. Compares whether one JSON value `lhs` is greater than or equal to another JSON value `rhs`
+   according to the following rules:
+    - The comparison always yields `#!cpp false` if (1) either operand is discarded, or (2) either
+      operand is `NaN` and the other operand is either `NaN` or any other number.
+    - Otherwise, returns the result of `#!cpp !(lhs < rhs)`.
+
+2. Compares wether a JSON value is greater than or equal to a scalar or a scalar is greater than or
+   equal to a JSON value by converting the scalar to a JSON value and comparing both JSON values
+   according to 1.
 
 ## Template parameters
 
@@ -38,6 +46,21 @@ No-throw guarantee: this function never throws exceptions.
 
 Linear.
 
+## Notes
+
+!!! note "Comparing `NaN`"
+
+    `NaN` values are unordered within the domain of numbers.
+    The following comparisons all yield `#!cpp false`:
+      1. Comparing a `NaN` with itself.
+      2. Comparing a `NaN` with another `NaN`.
+      3. Comparing a `NaN` and any other number.
+
+!!! note "Operator overload resolution"
+
+    Since C++20 overload resolution will consider the _rewritten candidate_ generated from
+    [`operator<=>`](operator_spaceship.md).
+
 ## Examples
 
 ??? example
@@ -54,6 +77,11 @@ Linear.
     --8<-- "examples/operator__greaterequal.output"
     ```
 
+## See also
+
+- [**operator<=>**](operator_spaceship.md) comparison: 3-way
+
 ## Version history
 
-- Added in version 1.0.0.
+1. Added in version 1.0.0. Conditionally removed since C++20 in version 3.11.0.
+2. Added in version 1.0.0. Conditionally removed since C++20 in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/basic_json/operator_gt.md b/docs/mkdocs/docs/api/basic_json/operator_gt.md
index 92ec30594..540e6076d 100644
--- a/docs/mkdocs/docs/api/basic_json/operator_gt.md
+++ b/docs/mkdocs/docs/api/basic_json/operator_gt.md
@@ -1,16 +1,24 @@
 # <small>nlohmann::basic_json::</small>operator>
 
 ```cpp
-bool operator>(const_reference lhs, const_reference rhs) noexcept,
+// until C++20
+bool operator>(const_reference lhs, const_reference rhs) noexcept;   // (1)
 
 template<typename ScalarType>
-bool operator>(const_reference lhs, const ScalarType rhs) noexcept;
+bool operator>(const_reference lhs, const ScalarType rhs) noexcept;  // (2)
 
 template<typename ScalarType>
-bool operator>(ScalarType lhs, const const_reference rhs) noexcept;
+bool operator>(ScalarType lhs, const const_reference rhs) noexcept;  // (2)
 ```
 
-Compares whether one JSON value `lhs` is greater than another JSON value `rhs` by calculating `#!cpp !(lhs <= rhs)`.
+1. Compares whether one JSON value `lhs` is greater than another JSON value `rhs` according to the
+  following rules:
+    - The comparison always yields `#!cpp false` if (1) either operand is discarded, or (2) either
+      operand is `NaN` and the other operand is either `NaN` or any other number.
+    - Otherwise, returns the result of `#!cpp !(lhs <= rhs)`.
+
+2. Compares wether a JSON value is greater than a scalar or a scalar is greater than a JSON value by
+   converting the scalar to a JSON value and comparing both JSON values according to 1.
 
 ## Template parameters
 
@@ -37,6 +45,21 @@ No-throw guarantee: this function never throws exceptions.
 
 Linear.
 
+## Notes
+
+!!! note "Comparing `NaN`"
+
+    `NaN` values are unordered within the domain of numbers.
+    The following comparisons all yield `#!cpp false`:
+      1. Comparing a `NaN` with itself.
+      2. Comparing a `NaN` with another `NaN`.
+      3. Comparing a `NaN` and any other number.
+
+!!! note "Operator overload resolution"
+
+    Since C++20 overload resolution will consider the _rewritten candidate_ generated from
+    [`operator<=>`](operator_spaceship.md).
+
 ## Examples
 
 ??? example
@@ -53,6 +76,11 @@ Linear.
     --8<-- "examples/operator__greater.output"
     ```
 
+## See also
+
+- [**operator<=>**](operator_spaceship.md) comparison: 3-way
+
 ## Version history
 
-- Added in version 1.0.0.
+1. Added in version 1.0.0. Conditionally removed since C++20 in version 3.11.0.
+2. Added in version 1.0.0. Conditionally removed since C++20 in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/basic_json/operator_le.md b/docs/mkdocs/docs/api/basic_json/operator_le.md
index 54f9a2809..c0f90acb2 100644
--- a/docs/mkdocs/docs/api/basic_json/operator_le.md
+++ b/docs/mkdocs/docs/api/basic_json/operator_le.md
@@ -1,17 +1,25 @@
 # <small>nlohmann::basic_json::</small>operator<=
 
 ```cpp
-bool operator<=(const_reference lhs, const_reference rhs) noexcept,
+// until C++20
+bool operator<=(const_reference lhs, const_reference rhs) noexcept;   // (1)
 
 template<typename ScalarType>
-bool operator<=(const_reference lhs, const ScalarType rhs) noexcept;
+bool operator<=(const_reference lhs, const ScalarType rhs) noexcept;  // (2)
 
 template<typename ScalarType>
-bool operator<=(ScalarType lhs, const const_reference rhs) noexcept;
+bool operator<=(ScalarType lhs, const const_reference rhs) noexcept;  // (2)
 ```
 
-Compares whether one JSON value `lhs` is less than or equal to another JSON value `rhs` by calculating
-`#cpp !(rhs < lhs)`.
+1. Compares whether one JSON value `lhs` is less than or equal to another JSON value `rhs`
+   according to the following rules:
+    - The comparison always yields `#!cpp false` if (1) either operand is discarded, or (2) either
+      operand is `NaN` and the other operand is either `NaN` or any other number.
+    - Otherwise, returns the result of `#!cpp !(rhs < lhs)`.
+
+1. Compares wether a JSON value is less than or equal to a scalar or a scalar is less than or equal
+   to a JSON value by converting the scalar to a JSON value and comparing both JSON values according
+   to 1.
 
 ## Template parameters
 
@@ -38,6 +46,21 @@ No-throw guarantee: this function never throws exceptions.
 
 Linear.
 
+## Notes
+
+!!! note "Comparing `NaN`"
+
+    `NaN` values are unordered within the domain of numbers.
+    The following comparisons all yield `#!cpp false`:
+      1. Comparing a `NaN` with itself.
+      2. Comparing a `NaN` with another `NaN`.
+      3. Comparing a `NaN` and any other number.
+
+!!! note "Operator overload resolution"
+
+    Since C++20 overload resolution will consider the _rewritten candidate_ generated from
+    [`operator<=>`](operator_spaceship.md).
+
 ## Examples
 
 ??? example
@@ -54,6 +77,11 @@ Linear.
     --8<-- "examples/operator__lessequal.output"
     ```
 
+## See also
+
+- [**operator<=>**](operator_spaceship.md) comparison: 3-way
+
 ## Version history
 
-- Added in version 1.0.0.
+1. Added in version 1.0.0. Conditionally removed since C++20 in version 3.11.0.
+2. Added in version 1.0.0. Conditionally removed since C++20 in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/basic_json/operator_lt.md b/docs/mkdocs/docs/api/basic_json/operator_lt.md
index d1a4999b4..b5d191ec4 100644
--- a/docs/mkdocs/docs/api/basic_json/operator_lt.md
+++ b/docs/mkdocs/docs/api/basic_json/operator_lt.md
@@ -1,31 +1,34 @@
 # <small>nlohmann::basic_json::</small>operator<
 
 ```cpp
-bool operator<(const_reference lhs, const_reference rhs) noexcept;
+// until C++20
+bool operator<(const_reference lhs, const_reference rhs) noexcept;   // (1)
 
 template<typename ScalarType>
-bool operator<(const_reference lhs, const ScalarType rhs) noexcept;
+bool operator<(const_reference lhs, const ScalarType rhs) noexcept;  // (2)
 
 template<typename ScalarType>
-bool operator<(ScalarType lhs, const const_reference rhs) noexcept;
+bool operator<(ScalarType lhs, const const_reference rhs) noexcept;  // (2)
 ```
 
-Compares whether one JSON value `lhs` is less than another JSON value `rhs` according to the following rules:
+1. Compares whether one JSON value `lhs` is less than another JSON value `rhs` according to the
+  following rules:
+    - If either operand is discarded, the comparison yields `#!cpp false`.
+    - If both operands have the same type, the values are compared using their respective `operator<`.
+    - Integer and floating-point numbers are automatically converted before comparison.
+    - In case `lhs` and `rhs` have different types, the values are ignored and the order of the types
+      is considered, which is:
+        1. null
+        2. boolean
+        3. number (all types)
+        4. object
+        5. array
+        6. string
+        7. binary
+      For instance, any boolean value is considered less than any string.
 
-- If `lhs` and `rhs` have the same type, the values are compared using the default `<` operator.
-- Integer and floating-point numbers are automatically converted before comparison
-- Discarded values a
-- In case `lhs` and `rhs` have different types, the values are ignored and the order of the types is considered, which
-  is:
-    1. null
-    2. boolean
-    3. number (all types)
-    4. object
-    5. array
-    6. string
-    7. binary
-
-    For instance, any boolean value is considered less than any string.
+2. Compares wether a JSON value is less than a scalar or a scalar is less than a JSON value by converting
+   the scalar to a JSON value and comparing both JSON values according to 1.
 
 ## Template parameters
 
@@ -52,6 +55,21 @@ No-throw guarantee: this function never throws exceptions.
 
 Linear.
 
+## Notes
+
+!!! note "Comparing `NaN`"
+
+    `NaN` values are unordered within the domain of numbers.
+    The following comparisons all yield `#!cpp false`:
+      1. Comparing a `NaN` with itself.
+      2. Comparing a `NaN` with another `NaN`.
+      3. Comparing a `NaN` and any other number.
+
+!!! note "Operator overload resolution"
+
+    Since C++20 overload resolution will consider the _rewritten candidate_ generated from
+    [`operator<=>`](operator_spaceship.md).
+
 ## Examples
 
 ??? example
@@ -68,6 +86,11 @@ Linear.
     --8<-- "examples/operator__less.output"
     ```
 
+## See also
+
+- [**operator<=>**](operator_spaceship.md) comparison: 3-way
+
 ## Version history
 
-- Added in version 1.0.0.
+1. Added in version 1.0.0. Conditionally removed since C++20 in version 3.11.0.
+2. Added in version 1.0.0. Conditionally removed since C++20 in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/basic_json/operator_ne.md b/docs/mkdocs/docs/api/basic_json/operator_ne.md
index e94da9b76..f5d989b50 100644
--- a/docs/mkdocs/docs/api/basic_json/operator_ne.md
+++ b/docs/mkdocs/docs/api/basic_json/operator_ne.md
@@ -1,16 +1,32 @@
 # <small>nlohmann::basic_json::</small>operator!=
 
 ```cpp
-bool operator!=(const_reference lhs, const_reference rhs) noexcept;
+// until C++20
+bool operator!=(const_reference lhs, const_reference rhs) noexcept;   // (1)
 
 template<typename ScalarType>
-bool operator!=(const_reference lhs, const ScalarType rhs) noexcept;
+bool operator!=(const_reference lhs, const ScalarType rhs) noexcept;  // (2)
 
 template<typename ScalarType>
-bool operator!=(ScalarType lhs, const const_reference rhs) noexcept;
+bool operator!=(ScalarType lhs, const const_reference rhs) noexcept;  // (2)
+
+// since C++20
+class basic_json {
+    bool operator!=(const_reference rhs) const noexcept;              // (1)
+
+    template<typename ScalarType>
+    bool operator!=(ScalarType rhs) const noexcept;                   // (2)
+};
 ```
 
-Compares two JSON values for inequality by calculating `#!cpp !(lhs == rhs)`.
+1. Compares two JSON values for inequality according to the following rules:
+    - The comparison always yields `#!cpp false` if (1) either operand is discarded, or (2) either
+      operand is `NaN` and the other operand is either `NaN` or any other number.
+    - Otherwise, returns the result of `#!cpp !(lhs == rhs)` (until C++20) or
+      `#!cpp !(*this == rhs)` (since C++20).
+
+2. Compares a JSON value and a scalar or a scalar and a JSON value for inequality by converting the
+   scalar to a JSON value and comparing both JSON values according to 1.
 
 ## Template parameters
 
@@ -27,7 +43,7 @@ Compares two JSON values for inequality by calculating `#!cpp !(lhs == rhs)`.
 
 ## Return value
 
-whether the values `lhs` and `rhs` are not equal
+whether the values `lhs`/`*this` and `rhs` are not equal
 
 ## Exception safety
 
@@ -37,6 +53,16 @@ No-throw guarantee: this function never throws exceptions.
 
 Linear.
 
+## Notes
+
+!!! note "Comparing `NaN`"
+
+    `NaN` values are unordered within the domain of numbers.
+    The following comparisons all yield `#!cpp false`:
+      1. Comparing a `NaN` with itself.
+      2. Comparing a `NaN` with another `NaN`.
+      3. Comparing a `NaN` and any other number.
+
 ## Examples
 
 ??? example
@@ -69,4 +95,5 @@ Linear.
 
 ## Version history
 
-- Added in version 1.0.0.
+1. Added in version 1.0.0. Added C++20 member functions in version 3.11.0.
+2. Added in version 1.0.0. Added C++20 member functions in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/basic_json/operator_spaceship.md b/docs/mkdocs/docs/api/basic_json/operator_spaceship.md
new file mode 100644
index 000000000..4beba4f86
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/operator_spaceship.md
@@ -0,0 +1,70 @@
+# <small>nlohmann::basic_json::</small>operator<=>
+
+```cpp
+// since C++20
+class basic_json {
+    std::partial_ordering operator<=>(const_reference rhs) const noexcept;  // (1)
+
+    template<typename ScalarType>
+    std::partial_ordering operator<=>(const ScalarType rhs) const noexcept; // (2)
+};
+```
+
+1. 3-way compares two JSON values producing a result of type `std::partial_ordering` according to the following rules:
+    - Two JSON values compare with a result of `std::partial_ordering::unordered` if either value is discarded.
+    - If both JSON values are of the same type, the result is produced by 3-way comparing their stored values using their
+      respective `operator<=>`.
+    - Integer and floating-point numbers are converted to their common type and then 3-way compared using their respective
+      `operator<=>`.
+      For instance, comparing an integer and a floating-point value will 3-way compare the first value convertered to
+      floating-point with the second value.
+    - Otherwise, yields a result by comparing the type (see [`value_t`](value_t.md)).
+  
+2. 3-way compares a JSON value and a scalar or a scalar and a JSON value by converting the scalar to a JSON value and 3-way
+   comparing both JSON values (see 1).
+
+## Template parameters
+
+`ScalarType`
+:   a scalar type according to `std::is_scalar<ScalarType>::value`
+
+## Parameters
+
+`rhs` (in)
+:   second value to consider 
+
+## Return value
+
+the `std::partial_ordering` of the 3-way comparison of `*this` and `rhs`
+
+## Exception safety
+
+No-throw guarantee: this function never throws exceptions.
+
+## Complexity
+
+Linear.
+
+## Notes
+
+!!! note "Comparing `NaN`"
+
+    - `NaN` values are unordered within the domain of numbers.
+      The following comparisons all yield `std::partial_ordering::unordered`:
+        1. Comparing a `NaN` with itself.
+        2. Comparing a `NaN` with another `NaN`.
+        3. Comparing a `NaN` and any other number.
+
+## See also
+
+- [**operator==**](operator_eq.md) - comparison: equal
+- [**operator!=**](operator_ne.md) - comparison: not equal
+- [**operator<**](operator_lt.md) - comparison: less than
+- [**operator<=**](operator_le.md) - comparison: less than or equal
+- [**operator>**](operator_gt.md) - comparison: greater than
+- [**operator>=**](operator_ge.md) - comparison: greater than or equal
+
+## Version history
+
+1. Added in version 3.11.0.
+2. Added in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/basic_json/value_t.md b/docs/mkdocs/docs/api/basic_json/value_t.md
index e7d32c480..f83574083 100644
--- a/docs/mkdocs/docs/api/basic_json/value_t.md
+++ b/docs/mkdocs/docs/api/basic_json/value_t.md
@@ -24,10 +24,41 @@ functions [`is_null`](is_null.md), [`is_object`](is_object.md), [`is_array`](is_
 
 ## Notes
 
-There are three enumeration entries (number_integer, number_unsigned, and number_float), because the library
-distinguishes these three types for numbers: [`number_unsigned_t`](number_unsigned_t.md) is used for unsigned integers,
-[`number_integer_t`](number_integer_t.md) is used for signed integers, and [`number_float_t`](number_float_t.md) is used
-for floating-point numbers or to approximate integers which do not fit in the limits of their respective type.
+!!! note "Ordering"
+
+    The order of types is as follows:
+
+    1. `null`
+    2. `boolean`
+    3. `number_integer`, `number_unsigned`, `number_float`
+    4. `object`
+    5. `array`
+    6. `string`
+    7. `binary`
+
+    `discarded` is unordered.
+
+!!! note "Types of numbers"
+
+    There are three enumerators for numbers (`number_integer`, `number_unsigned`, and `number_float`) to distinguish
+    between different types of numbers:
+
+      - [`number_unsigned_t`](number_unsigned_t.md) for unsigned integers
+      - [`number_integer_t`](number_integer_t.md) for signed integers
+      - [`number_float_t`](number_float_t.md) for floating-point numbers or to approximate integers which do not fit
+        into the limits of their respective type
+
+!!! warning "Comparison operators"
+
+    `operator<` and `operator<=>` (since C++20) are overloaded and compare according to the ordering described above.
+    Until C++20 all other relational and equality operators yield results according to the integer value of each
+    enumerator.
+    Since C++20 some compilers consider the _rewritten candidates_ generated from `operator<=>` during overload
+    resolution, while others do not.
+    For predictable and portable behavior use:
+
+      - `operator<` or `operator<=>` when wanting to compare according to the order described above
+      - `operator==` or `operator!=` when wanting to compare according to each enumerators integer value
 
 ## Examples
 
diff --git a/docs/mkdocs/docs/api/macros/index.md b/docs/mkdocs/docs/api/macros/index.md
index 56924da44..5f0a7a194 100644
--- a/docs/mkdocs/docs/api/macros/index.md
+++ b/docs/mkdocs/docs/api/macros/index.md
@@ -17,6 +17,8 @@ header. See also the [macro overview page](../../features/macros.md).
 
 - [**JSON_HAS_CPP_11**<br>**JSON_HAS_CPP_14**<br>**JSON_HAS_CPP_17**<br>**JSON_HAS_CPP_20**](json_has_cpp_11.md) - set supported C++ standard
 - [**JSON_HAS_FILESYSTEM**<br>**JSON_HAS_EXPERIMENTAL_FILESYSTEM**](json_has_filesystem.md) - control `std::filesystem` support
+- [**JSON_HAS_RANGES**](json_has_ranges.md) - control `std::ranges` support
+- [**JSON_HAS_THREE_WAY_COMPARISON**](json_has_three_way_comparison.md) - control 3-way comparison support
 - [**JSON_NO_IO**](json_no_io.md) - switch off functions relying on certain C++ I/O headers
 - [**JSON_SKIP_UNSUPPORTED_COMPILER_CHECK**](json_skip_unsupported_compiler_check.md) - do not warn about unsupported compilers
 
@@ -29,6 +31,12 @@ header. See also the [macro overview page](../../features/macros.md).
 
 - [**JSON_USE_IMPLICIT_CONVERSIONS**](json_use_implicit_conversions.md) - control implicit conversions
 
+<!-- comment-->
+## Comparison behavior
+
+- [**JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON**](json_use_legacy_discarded_value_comparison.md) -
+  control comparison of discarded values
+
 ## Serialization/deserialization macros
 
 - [**NLOHMANN_DEFINE_TYPE_INTRUSIVE(type, member...)**<br>**NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT(type, member...)**](nlohmann_define_type_intrusive.md) - serialization/deserialization of types _with_ access to private variables
diff --git a/docs/mkdocs/docs/api/macros/json_has_ranges.md b/docs/mkdocs/docs/api/macros/json_has_ranges.md
new file mode 100644
index 000000000..ae596979e
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_has_ranges.md
@@ -0,0 +1,18 @@
+# JSON_HAS_RANGES
+
+```cpp
+#define JSON_HAS_RANGES /* value */
+```
+
+This macro indicates whether the standard library has any support for ranges. Implies support for concepts.
+Possible values are `1` when supported or `0` when unsupported.
+
+## Default definition
+
+The default value is detected based on the preprocessor macro `#!cpp __cpp_lib_ranges`.
+
+When the macro is not defined, the library will define it to its default value.
+
+## Version history
+
+- Added in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/macros/json_has_three_way_comparison.md b/docs/mkdocs/docs/api/macros/json_has_three_way_comparison.md
new file mode 100644
index 000000000..fc1dcb43c
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_has_three_way_comparison.md
@@ -0,0 +1,19 @@
+# JSON_HAS_THREE_WAY_COMPARISON
+
+```cpp
+#define JSON_HAS_THREE_WAY_COMPARISON /* value */
+```
+
+This macro indicates whether the compiler and standard library support 3-way comparison.
+Possible values are `1` when supported or `0` when unsupported.
+
+## Default definition
+
+The default value is detected based on the preprocessor macros `#!cpp __cpp_impl_three_way_comparison`
+and `#!cpp __cpp_lib_three_way_comparison`.
+
+When the macro is not defined, the library will define it to its default value.
+
+## Version history
+
+- Added in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/macros/json_use_legacy_discarded_value_comparison.md b/docs/mkdocs/docs/api/macros/json_use_legacy_discarded_value_comparison.md
new file mode 100644
index 000000000..4f630db12
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_use_legacy_discarded_value_comparison.md
@@ -0,0 +1,61 @@
+# JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
+
+```cpp
+#define JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON /* value */
+```
+
+This macro enables the (incorrect) legacy comparison behavior of discarded JSON values.
+Possible values are `1` to enable or `0` to disable (default).
+
+When enabled, comparisons involving at least one discarded JSON value yield results as follows:
+
+| **Operator** | **Result**    |
+|--------------|---------------|
+| `==`         | `#!cpp false` |
+| `!=`         | `#!cpp true`  |
+| `<`          | `#!cpp false` |
+| `<=`         | `#!cpp true`  |
+| `>=`         | `#!cpp true`  |
+| `>`          | `#!cpp false` |
+
+Otherwise, comparisons involving at least one discarded JSON value always yield `#!cpp false`.
+
+## Default definition
+
+The default value is `0`.
+
+```cpp
+#define JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON 0
+```
+
+When the macro is not defined, the library will define it to its default value.
+
+## Notes
+
+!!! warning "Inconsistent behavior in C++20 and beyond"
+
+    When targeting C++20 or above, enabling the legacy comparison behavior is _strongly_
+    discouraged.
+
+      - The 3-way comparison operator (`<=>`) will always give the correct result
+        (`#!cpp std::partial_ordering::unordered`) regardless of the value of
+        `JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON`.
+      - Overloads for the equality and relational operators emulate the legacy behavior.
+
+    Code outside your control may use either 3-way comparison or the equality and
+    relational operators, resulting in inconsistent and unpredictable behavior.
+
+    See [`operator<=>`](../basic_json/operator_spaceship.md) for more information on 3-way
+    comparison.
+
+!!! warning "Deprecation"
+
+    The legacy comparison behavior is deprecated and may be removed in a future major
+    version release.
+
+    New code should not depend on it and existing code should try to remove or rewrite
+    expressions relying on it.
+
+## Version history
+
+- Added in version 3.11.0.
diff --git a/docs/mkdocs/docs/css/custom.css b/docs/mkdocs/docs/css/custom.css
new file mode 100644
index 000000000..7a1008b0b
--- /dev/null
+++ b/docs/mkdocs/docs/css/custom.css
@@ -0,0 +1,4 @@
+/* disable ligatures in code and preformatted blocks */
+code, pre {
+    font-variant-ligatures: none;
+}
diff --git a/docs/mkdocs/mkdocs.yml b/docs/mkdocs/mkdocs.yml
index dd4da8a0c..08ef336db 100644
--- a/docs/mkdocs/mkdocs.yml
+++ b/docs/mkdocs/mkdocs.yml
@@ -154,15 +154,16 @@ nav:
         - 'operator value_t': api/basic_json/operator_value_t.md
         - 'operator[]': api/basic_json/operator[].md
         - 'operator=': api/basic_json/operator=.md
+        - 'operator+=': api/basic_json/operator+=.md
         - 'operator==': api/basic_json/operator_eq.md
         - 'operator!=': api/basic_json/operator_ne.md
         - 'operator<': api/basic_json/operator_lt.md
-        - 'operator<<': api/basic_json/operator_ltlt.md
-        - 'operator<=': api/basic_json/operator_le.md
         - 'operator>': api/basic_json/operator_gt.md
-        - 'operator>>': api/basic_json/operator_gtgt.md
+        - 'operator<=': api/basic_json/operator_le.md
         - 'operator>=': api/basic_json/operator_ge.md
-        - 'operator+=': api/basic_json/operator+=.md
+        - 'operator<=>': api/basic_json/operator_spaceship.md
+        - 'operator<<': api/basic_json/operator_ltlt.md
+        - 'operator>>': api/basic_json/operator_gtgt.md
         - 'operator""_json': api/basic_json/operator_literal_json.md
         - 'operator""_json_pointer': api/basic_json/operator_literal_json_pointer.md
         - 'out_of_range': api/basic_json/out_of_range.md
@@ -246,6 +247,8 @@ nav:
         - 'JSON_HAS_CPP_20': api/macros/json_has_cpp_11.md
         - 'JSON_HAS_EXPERIMENTAL_FILESYSTEM': api/macros/json_has_filesystem.md
         - 'JSON_HAS_FILESYSTEM': api/macros/json_has_filesystem.md
+        - 'JSON_HAS_RANGES': api/macros/json_has_ranges.md
+        - 'JSON_HAS_THREE_WAY_COMPARISON': api/macros/json_has_three_way_comparison.md
         - 'JSON_NOEXCEPTION': api/macros/json_noexception.md
         - 'JSON_NO_IO': api/macros/json_no_io.md
         - 'JSON_SKIP_LIBRARY_VERSION_CHECK': api/macros/json_skip_library_version_check.md
@@ -253,6 +256,7 @@ nav:
         - 'JSON_THROW_USER': api/macros/json_throw_user.md
         - 'JSON_TRY_USER': api/macros/json_throw_user.md
         - 'JSON_USE_IMPLICIT_CONVERSIONS': api/macros/json_use_implicit_conversions.md
+        - 'JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON': api/macros/json_use_legacy_discarded_value_comparison.md
         - 'NLOHMANN_DEFINE_TYPE_INTRUSIVE': api/macros/nlohmann_define_type_intrusive.md
         - 'NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT': api/macros/nlohmann_define_type_intrusive.md
         - 'NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE': api/macros/nlohmann_define_type_non_intrusive.md
@@ -319,5 +323,8 @@ plugins:
         minify_html: true
     - git-revision-date-localized
 
+extra_css:
+    - css/custom.css
+
 extra_javascript:
   - https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-MML-AM_CHTML
diff --git a/include/nlohmann/detail/conversions/from_json.hpp b/include/nlohmann/detail/conversions/from_json.hpp
index 079baa723..f0a93f291 100644
--- a/include/nlohmann/detail/conversions/from_json.hpp
+++ b/include/nlohmann/detail/conversions/from_json.hpp
@@ -39,7 +39,7 @@ namespace nlohmann
 namespace detail
 {
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, typename std::nullptr_t& n)
+inline void from_json(const BasicJsonType& j, typename std::nullptr_t& n)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_null()))
     {
@@ -86,7 +86,7 @@ void get_arithmetic_value(const BasicJsonType& j, ArithmeticType& val)
 }
 
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, typename BasicJsonType::boolean_t& b)
+inline void from_json(const BasicJsonType& j, typename BasicJsonType::boolean_t& b)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_boolean()))
     {
@@ -96,7 +96,7 @@ void from_json(const BasicJsonType& j, typename BasicJsonType::boolean_t& b)
 }
 
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, typename BasicJsonType::string_t& s)
+inline void from_json(const BasicJsonType& j, typename BasicJsonType::string_t& s)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_string()))
     {
@@ -111,7 +111,7 @@ template <
         std::is_assignable<StringType&, const typename BasicJsonType::string_t>::value
         && !std::is_same<typename BasicJsonType::string_t, StringType>::value
         && !is_json_ref<StringType>::value, int > = 0 >
-void from_json(const BasicJsonType& j, StringType& s)
+inline void from_json(const BasicJsonType& j, StringType& s)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_string()))
     {
@@ -122,26 +122,26 @@ void from_json(const BasicJsonType& j, StringType& s)
 }
 
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, typename BasicJsonType::number_float_t& val)
+inline void from_json(const BasicJsonType& j, typename BasicJsonType::number_float_t& val)
 {
     get_arithmetic_value(j, val);
 }
 
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, typename BasicJsonType::number_unsigned_t& val)
+inline void from_json(const BasicJsonType& j, typename BasicJsonType::number_unsigned_t& val)
 {
     get_arithmetic_value(j, val);
 }
 
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, typename BasicJsonType::number_integer_t& val)
+inline void from_json(const BasicJsonType& j, typename BasicJsonType::number_integer_t& val)
 {
     get_arithmetic_value(j, val);
 }
 
 template<typename BasicJsonType, typename EnumType,
          enable_if_t<std::is_enum<EnumType>::value, int> = 0>
-void from_json(const BasicJsonType& j, EnumType& e)
+inline void from_json(const BasicJsonType& j, EnumType& e)
 {
     typename std::underlying_type<EnumType>::type val;
     get_arithmetic_value(j, val);
@@ -151,7 +151,7 @@ void from_json(const BasicJsonType& j, EnumType& e)
 // forward_list doesn't have an insert method
 template<typename BasicJsonType, typename T, typename Allocator,
          enable_if_t<is_getable<BasicJsonType, T>::value, int> = 0>
-void from_json(const BasicJsonType& j, std::forward_list<T, Allocator>& l)
+inline void from_json(const BasicJsonType& j, std::forward_list<T, Allocator>& l)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
     {
@@ -168,7 +168,7 @@ void from_json(const BasicJsonType& j, std::forward_list<T, Allocator>& l)
 // valarray doesn't have an insert method
 template<typename BasicJsonType, typename T,
          enable_if_t<is_getable<BasicJsonType, T>::value, int> = 0>
-void from_json(const BasicJsonType& j, std::valarray<T>& l)
+inline void from_json(const BasicJsonType& j, std::valarray<T>& l)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
     {
@@ -193,7 +193,7 @@ auto from_json(const BasicJsonType& j, T (&arr)[N])  // NOLINT(cppcoreguidelines
 }
 
 template<typename BasicJsonType>
-void from_json_array_impl(const BasicJsonType& j, typename BasicJsonType::array_t& arr, priority_tag<3> /*unused*/)
+inline void from_json_array_impl(const BasicJsonType& j, typename BasicJsonType::array_t& arr, priority_tag<3> /*unused*/)
 {
     arr = *j.template get_ptr<const typename BasicJsonType::array_t*>();
 }
@@ -237,8 +237,8 @@ template<typename BasicJsonType, typename ConstructibleArrayType,
          enable_if_t<
              std::is_assignable<ConstructibleArrayType&, ConstructibleArrayType>::value,
              int> = 0>
-void from_json_array_impl(const BasicJsonType& j, ConstructibleArrayType& arr,
-                          priority_tag<0> /*unused*/)
+inline void from_json_array_impl(const BasicJsonType& j, ConstructibleArrayType& arr,
+                                 priority_tag<0> /*unused*/)
 {
     using std::end;
 
@@ -295,7 +295,7 @@ auto from_json(BasicJsonType&& j, identity_tag<std::array<T, N>> tag)
 }
 
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, typename BasicJsonType::binary_t& bin)
+inline void from_json(const BasicJsonType& j, typename BasicJsonType::binary_t& bin)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_binary()))
     {
@@ -307,7 +307,7 @@ void from_json(const BasicJsonType& j, typename BasicJsonType::binary_t& bin)
 
 template<typename BasicJsonType, typename ConstructibleObjectType,
          enable_if_t<is_constructible_object_type<BasicJsonType, ConstructibleObjectType>::value, int> = 0>
-void from_json(const BasicJsonType& j, ConstructibleObjectType& obj)
+inline void from_json(const BasicJsonType& j, ConstructibleObjectType& obj)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_object()))
     {
@@ -339,7 +339,7 @@ template < typename BasicJsonType, typename ArithmeticType,
                !std::is_same<ArithmeticType, typename BasicJsonType::number_float_t>::value&&
                !std::is_same<ArithmeticType, typename BasicJsonType::boolean_t>::value,
                int > = 0 >
-void from_json(const BasicJsonType& j, ArithmeticType& val)
+inline void from_json(const BasicJsonType& j, ArithmeticType& val)
 {
     switch (static_cast<value_t>(j))
     {
@@ -389,7 +389,7 @@ std::pair<A1, A2> from_json_tuple_impl(BasicJsonType&& j, identity_tag<std::pair
 }
 
 template<typename BasicJsonType, typename A1, typename A2>
-void from_json_tuple_impl(BasicJsonType&& j, std::pair<A1, A2>& p, priority_tag<1> /*unused*/)
+inline void from_json_tuple_impl(BasicJsonType&& j, std::pair<A1, A2>& p, priority_tag<1> /*unused*/)
 {
     p = from_json_tuple_impl(std::forward<BasicJsonType>(j), identity_tag<std::pair<A1, A2>> {}, priority_tag<0> {});
 }
@@ -401,7 +401,7 @@ std::tuple<Args...> from_json_tuple_impl(BasicJsonType&& j, identity_tag<std::tu
 }
 
 template<typename BasicJsonType, typename... Args>
-void from_json_tuple_impl(BasicJsonType&& j, std::tuple<Args...>& t, priority_tag<3> /*unused*/)
+inline void from_json_tuple_impl(BasicJsonType&& j, std::tuple<Args...>& t, priority_tag<3> /*unused*/)
 {
     t = from_json_tuple_impl_base<BasicJsonType, Args...>(std::forward<BasicJsonType>(j), index_sequence_for<Args...> {});
 }
@@ -421,7 +421,7 @@ auto from_json(BasicJsonType&& j, TupleRelated&& t)
 template < typename BasicJsonType, typename Key, typename Value, typename Compare, typename Allocator,
            typename = enable_if_t < !std::is_constructible <
                                         typename BasicJsonType::string_t, Key >::value >>
-void from_json(const BasicJsonType& j, std::map<Key, Value, Compare, Allocator>& m)
+inline void from_json(const BasicJsonType& j, std::map<Key, Value, Compare, Allocator>& m)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
     {
@@ -441,7 +441,7 @@ void from_json(const BasicJsonType& j, std::map<Key, Value, Compare, Allocator>&
 template < typename BasicJsonType, typename Key, typename Value, typename Hash, typename KeyEqual, typename Allocator,
            typename = enable_if_t < !std::is_constructible <
                                         typename BasicJsonType::string_t, Key >::value >>
-void from_json(const BasicJsonType& j, std::unordered_map<Key, Value, Hash, KeyEqual, Allocator>& m)
+inline void from_json(const BasicJsonType& j, std::unordered_map<Key, Value, Hash, KeyEqual, Allocator>& m)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
     {
@@ -460,7 +460,7 @@ void from_json(const BasicJsonType& j, std::unordered_map<Key, Value, Hash, KeyE
 
 #if JSON_HAS_FILESYSTEM || JSON_HAS_EXPERIMENTAL_FILESYSTEM
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, std_fs::path& p)
+inline void from_json(const BasicJsonType& j, std_fs::path& p)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_string()))
     {
@@ -482,11 +482,16 @@ struct from_json_fn
 };
 }  // namespace detail
 
+#ifndef JSON_HAS_CPP_17
 /// namespace to hold default `from_json` function
 /// to see why this is required:
 /// http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/n4381.html
 namespace // NOLINT(cert-dcl59-cpp,fuchsia-header-anon-namespaces,google-build-namespaces)
 {
-constexpr const auto& from_json = detail::static_const<detail::from_json_fn>::value; // NOLINT(misc-definitions-in-headers)
+#endif
+JSON_INLINE_VARIABLE constexpr const auto& from_json = // NOLINT(misc-definitions-in-headers)
+    detail::static_const<detail::from_json_fn>::value;
+#ifndef JSON_HAS_CPP_17
 } // namespace
+#endif
 } // namespace nlohmann
diff --git a/include/nlohmann/detail/conversions/to_json.hpp b/include/nlohmann/detail/conversions/to_json.hpp
index 7628ae011..fde46ef7c 100644
--- a/include/nlohmann/detail/conversions/to_json.hpp
+++ b/include/nlohmann/detail/conversions/to_json.hpp
@@ -267,55 +267,55 @@ struct external_constructor<value_t::object>
 
 template<typename BasicJsonType, typename T,
          enable_if_t<std::is_same<T, typename BasicJsonType::boolean_t>::value, int> = 0>
-void to_json(BasicJsonType& j, T b) noexcept
+inline void to_json(BasicJsonType& j, T b) noexcept
 {
     external_constructor<value_t::boolean>::construct(j, b);
 }
 
 template<typename BasicJsonType, typename CompatibleString,
          enable_if_t<std::is_constructible<typename BasicJsonType::string_t, CompatibleString>::value, int> = 0>
-void to_json(BasicJsonType& j, const CompatibleString& s)
+inline void to_json(BasicJsonType& j, const CompatibleString& s)
 {
     external_constructor<value_t::string>::construct(j, s);
 }
 
 template<typename BasicJsonType>
-void to_json(BasicJsonType& j, typename BasicJsonType::string_t&& s)
+inline void to_json(BasicJsonType& j, typename BasicJsonType::string_t&& s)
 {
     external_constructor<value_t::string>::construct(j, std::move(s));
 }
 
 template<typename BasicJsonType, typename FloatType,
          enable_if_t<std::is_floating_point<FloatType>::value, int> = 0>
-void to_json(BasicJsonType& j, FloatType val) noexcept
+inline void to_json(BasicJsonType& j, FloatType val) noexcept
 {
     external_constructor<value_t::number_float>::construct(j, static_cast<typename BasicJsonType::number_float_t>(val));
 }
 
 template<typename BasicJsonType, typename CompatibleNumberUnsignedType,
          enable_if_t<is_compatible_integer_type<typename BasicJsonType::number_unsigned_t, CompatibleNumberUnsignedType>::value, int> = 0>
-void to_json(BasicJsonType& j, CompatibleNumberUnsignedType val) noexcept
+inline void to_json(BasicJsonType& j, CompatibleNumberUnsignedType val) noexcept
 {
     external_constructor<value_t::number_unsigned>::construct(j, static_cast<typename BasicJsonType::number_unsigned_t>(val));
 }
 
 template<typename BasicJsonType, typename CompatibleNumberIntegerType,
          enable_if_t<is_compatible_integer_type<typename BasicJsonType::number_integer_t, CompatibleNumberIntegerType>::value, int> = 0>
-void to_json(BasicJsonType& j, CompatibleNumberIntegerType val) noexcept
+inline void to_json(BasicJsonType& j, CompatibleNumberIntegerType val) noexcept
 {
     external_constructor<value_t::number_integer>::construct(j, static_cast<typename BasicJsonType::number_integer_t>(val));
 }
 
 template<typename BasicJsonType, typename EnumType,
          enable_if_t<std::is_enum<EnumType>::value, int> = 0>
-void to_json(BasicJsonType& j, EnumType e) noexcept
+inline void to_json(BasicJsonType& j, EnumType e) noexcept
 {
     using underlying_type = typename std::underlying_type<EnumType>::type;
     external_constructor<value_t::number_integer>::construct(j, static_cast<underlying_type>(e));
 }
 
 template<typename BasicJsonType>
-void to_json(BasicJsonType& j, const std::vector<bool>& e)
+inline void to_json(BasicJsonType& j, const std::vector<bool>& e)
 {
     external_constructor<value_t::array>::construct(j, e);
 }
@@ -328,39 +328,39 @@ template < typename BasicJsonType, typename CompatibleArrayType,
                          !std::is_same<typename BasicJsonType::binary_t, CompatibleArrayType>::value&&
                          !is_basic_json<CompatibleArrayType>::value,
                          int > = 0 >
-void to_json(BasicJsonType& j, const CompatibleArrayType& arr)
+inline void to_json(BasicJsonType& j, const CompatibleArrayType& arr)
 {
     external_constructor<value_t::array>::construct(j, arr);
 }
 
 template<typename BasicJsonType>
-void to_json(BasicJsonType& j, const typename BasicJsonType::binary_t& bin)
+inline void to_json(BasicJsonType& j, const typename BasicJsonType::binary_t& bin)
 {
     external_constructor<value_t::binary>::construct(j, bin);
 }
 
 template<typename BasicJsonType, typename T,
          enable_if_t<std::is_convertible<T, BasicJsonType>::value, int> = 0>
-void to_json(BasicJsonType& j, const std::valarray<T>& arr)
+inline void to_json(BasicJsonType& j, const std::valarray<T>& arr)
 {
     external_constructor<value_t::array>::construct(j, std::move(arr));
 }
 
 template<typename BasicJsonType>
-void to_json(BasicJsonType& j, typename BasicJsonType::array_t&& arr)
+inline void to_json(BasicJsonType& j, typename BasicJsonType::array_t&& arr)
 {
     external_constructor<value_t::array>::construct(j, std::move(arr));
 }
 
 template < typename BasicJsonType, typename CompatibleObjectType,
            enable_if_t < is_compatible_object_type<BasicJsonType, CompatibleObjectType>::value&& !is_basic_json<CompatibleObjectType>::value, int > = 0 >
-void to_json(BasicJsonType& j, const CompatibleObjectType& obj)
+inline void to_json(BasicJsonType& j, const CompatibleObjectType& obj)
 {
     external_constructor<value_t::object>::construct(j, obj);
 }
 
 template<typename BasicJsonType>
-void to_json(BasicJsonType& j, typename BasicJsonType::object_t&& obj)
+inline void to_json(BasicJsonType& j, typename BasicJsonType::object_t&& obj)
 {
     external_constructor<value_t::object>::construct(j, std::move(obj));
 }
@@ -370,13 +370,13 @@ template <
     enable_if_t < !std::is_constructible<typename BasicJsonType::string_t,
                   const T(&)[N]>::value, // NOLINT(cppcoreguidelines-avoid-c-arrays,hicpp-avoid-c-arrays,modernize-avoid-c-arrays)
                   int > = 0 >
-void to_json(BasicJsonType& j, const T(&arr)[N]) // NOLINT(cppcoreguidelines-avoid-c-arrays,hicpp-avoid-c-arrays,modernize-avoid-c-arrays)
+inline void to_json(BasicJsonType& j, const T(&arr)[N]) // NOLINT(cppcoreguidelines-avoid-c-arrays,hicpp-avoid-c-arrays,modernize-avoid-c-arrays)
 {
     external_constructor<value_t::array>::construct(j, arr);
 }
 
 template < typename BasicJsonType, typename T1, typename T2, enable_if_t < std::is_constructible<BasicJsonType, T1>::value&& std::is_constructible<BasicJsonType, T2>::value, int > = 0 >
-void to_json(BasicJsonType& j, const std::pair<T1, T2>& p)
+inline void to_json(BasicJsonType& j, const std::pair<T1, T2>& p)
 {
     j = { p.first, p.second };
 }
@@ -384,26 +384,26 @@ void to_json(BasicJsonType& j, const std::pair<T1, T2>& p)
 // for https://github.com/nlohmann/json/pull/1134
 template<typename BasicJsonType, typename T,
          enable_if_t<std::is_same<T, iteration_proxy_value<typename BasicJsonType::iterator>>::value, int> = 0>
-void to_json(BasicJsonType& j, const T& b)
+inline void to_json(BasicJsonType& j, const T& b)
 {
     j = { {b.key(), b.value()} };
 }
 
 template<typename BasicJsonType, typename Tuple, std::size_t... Idx>
-void to_json_tuple_impl(BasicJsonType& j, const Tuple& t, index_sequence<Idx...> /*unused*/)
+inline void to_json_tuple_impl(BasicJsonType& j, const Tuple& t, index_sequence<Idx...> /*unused*/)
 {
     j = { std::get<Idx>(t)... };
 }
 
 template<typename BasicJsonType, typename T, enable_if_t<is_constructible_tuple<BasicJsonType, T>::value, int > = 0>
-void to_json(BasicJsonType& j, const T& t)
+inline void to_json(BasicJsonType& j, const T& t)
 {
     to_json_tuple_impl(j, t, make_index_sequence<std::tuple_size<T>::value> {});
 }
 
 #if JSON_HAS_FILESYSTEM || JSON_HAS_EXPERIMENTAL_FILESYSTEM
 template<typename BasicJsonType>
-void to_json(BasicJsonType& j, const std_fs::path& p)
+inline void to_json(BasicJsonType& j, const std_fs::path& p)
 {
     j = p.string();
 }
@@ -420,11 +420,16 @@ struct to_json_fn
 };
 }  // namespace detail
 
+#ifndef JSON_HAS_CPP_17
 /// namespace to hold default `to_json` function
 /// to see why this is required:
 /// http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/n4381.html
 namespace // NOLINT(cert-dcl59-cpp,fuchsia-header-anon-namespaces,google-build-namespaces)
 {
-constexpr const auto& to_json = detail::static_const<detail::to_json_fn>::value; // NOLINT(misc-definitions-in-headers)
+#endif
+JSON_INLINE_VARIABLE constexpr const auto& to_json = // NOLINT(misc-definitions-in-headers)
+    detail::static_const<detail::to_json_fn>::value;
+#ifndef JSON_HAS_CPP_17
 } // namespace
+#endif
 } // namespace nlohmann
diff --git a/include/nlohmann/detail/iterators/iter_impl.hpp b/include/nlohmann/detail/iterators/iter_impl.hpp
index cdcdaff1f..81c61b3e0 100644
--- a/include/nlohmann/detail/iterators/iter_impl.hpp
+++ b/include/nlohmann/detail/iterators/iter_impl.hpp
@@ -51,9 +51,12 @@ class iter_impl // NOLINT(cppcoreguidelines-special-member-functions,hicpp-speci
     // make sure BasicJsonType is basic_json or const basic_json
     static_assert(is_basic_json<typename std::remove_const<BasicJsonType>::type>::value,
                   "iter_impl only accepts (const) basic_json");
+    // superficial check for the LegacyBidirectionalIterator named requirement
+    static_assert(std::is_base_of<std::bidirectional_iterator_tag, std::bidirectional_iterator_tag>::value
+                  &&  std::is_base_of<std::bidirectional_iterator_tag, typename array_t::iterator::iterator_category>::value,
+                  "basic_json iterator assumes array and object type iterators satisfy the LegacyBidirectionalIterator named requirement.");
 
   public:
-
     /// The std::iterator class template (used as a base class to provide typedefs) is deprecated in C++17.
     /// The C++ Standard has never required user-defined iterators to derive from std::iterator.
     /// A user-defined iterator should provide publicly accessible typedefs named
diff --git a/include/nlohmann/detail/iterators/iteration_proxy.hpp b/include/nlohmann/detail/iterators/iteration_proxy.hpp
index 9994b364c..a75614de1 100644
--- a/include/nlohmann/detail/iterators/iteration_proxy.hpp
+++ b/include/nlohmann/detail/iterators/iteration_proxy.hpp
@@ -6,6 +6,10 @@
 #include <tuple> // tuple_size, get, tuple_element
 #include <utility> // move
 
+#if JSON_HAS_RANGES
+    #include <ranges> // enable_borrowed_range
+#endif
+
 #include <nlohmann/detail/meta/type_traits.hpp>
 #include <nlohmann/detail/value_t.hpp>
 
@@ -25,14 +29,14 @@ template<typename IteratorType> class iteration_proxy_value
   public:
     using difference_type = std::ptrdiff_t;
     using value_type = iteration_proxy_value;
-    using pointer = value_type * ;
-    using reference = value_type & ;
+    using pointer = value_type *;
+    using reference = value_type &;
     using iterator_category = std::input_iterator_tag;
     using string_type = typename std::remove_cv< typename std::remove_reference<decltype( std::declval<IteratorType>().key() ) >::type >::type;
 
   private:
     /// the iterator
-    IteratorType anchor;
+    IteratorType anchor{};
     /// an index for arrays (used to create key names)
     std::size_t array_index = 0;
     /// last stringified array index
@@ -40,15 +44,30 @@ template<typename IteratorType> class iteration_proxy_value
     /// a string representation of the array index
     mutable string_type array_index_str = "0";
     /// an empty string (to return a reference for primitive values)
-    const string_type empty_str{};
+    string_type empty_str{};
 
   public:
-    explicit iteration_proxy_value(IteratorType it) noexcept
+    explicit iteration_proxy_value() = default;
+    explicit iteration_proxy_value(IteratorType it, std::size_t array_index_ = 0)
+    noexcept(std::is_nothrow_move_constructible<IteratorType>::value
+             && std::is_nothrow_default_constructible<string_type>::value)
         : anchor(std::move(it))
+        , array_index(array_index_)
     {}
 
+    iteration_proxy_value(iteration_proxy_value const&) = default;
+    iteration_proxy_value& operator=(iteration_proxy_value const&) = default;
+    // older GCCs are a bit fussy and require explicit noexcept specifiers on defaulted functions
+    iteration_proxy_value(iteration_proxy_value&&)
+    noexcept(std::is_nothrow_move_constructible<IteratorType>::value
+             && std::is_nothrow_move_constructible<string_type>::value) = default;
+    iteration_proxy_value& operator=(iteration_proxy_value&&)
+    noexcept(std::is_nothrow_move_assignable<IteratorType>::value
+             && std::is_nothrow_move_assignable<string_type>::value) = default;
+    ~iteration_proxy_value() = default;
+
     /// dereference operator (needed for range-based for)
-    iteration_proxy_value& operator*()
+    const iteration_proxy_value& operator*() const
     {
         return *this;
     }
@@ -62,6 +81,14 @@ template<typename IteratorType> class iteration_proxy_value
         return *this;
     }
 
+    iteration_proxy_value operator++(int)& // NOLINT(cert-dcl21-cpp)
+    {
+        auto tmp = iteration_proxy_value(anchor, array_index);
+        ++anchor;
+        ++array_index;
+        return tmp;
+    }
+
     /// equality operator (needed for InputIterator)
     bool operator==(const iteration_proxy_value& o) const
     {
@@ -122,25 +149,34 @@ template<typename IteratorType> class iteration_proxy
 {
   private:
     /// the container to iterate
-    typename IteratorType::reference container;
+    typename IteratorType::pointer container = nullptr;
 
   public:
+    explicit iteration_proxy() = default;
+
     /// construct iteration proxy from a container
     explicit iteration_proxy(typename IteratorType::reference cont) noexcept
-        : container(cont) {}
+        : container(&cont) {}
+
+    iteration_proxy(iteration_proxy const&) = default;
+    iteration_proxy& operator=(iteration_proxy const&) = default;
+    iteration_proxy(iteration_proxy&&) noexcept = default;
+    iteration_proxy& operator=(iteration_proxy&&) noexcept = default;
+    ~iteration_proxy() = default;
 
     /// return iterator begin (needed for range-based for)
-    iteration_proxy_value<IteratorType> begin() noexcept
+    iteration_proxy_value<IteratorType> begin() const noexcept
     {
-        return iteration_proxy_value<IteratorType>(container.begin());
+        return iteration_proxy_value<IteratorType>(container->begin());
     }
 
     /// return iterator end (needed for range-based for)
-    iteration_proxy_value<IteratorType> end() noexcept
+    iteration_proxy_value<IteratorType> end() const noexcept
     {
-        return iteration_proxy_value<IteratorType>(container.end());
+        return iteration_proxy_value<IteratorType>(container->end());
     }
 };
+
 // Structured Bindings Support
 // For further reference see https://blog.tartanllama.xyz/structured-bindings/
 // And see https://github.com/nlohmann/json/pull/1391
@@ -187,3 +223,8 @@ class tuple_element<N, ::nlohmann::detail::iteration_proxy_value<IteratorType >>
     #pragma clang diagnostic pop
 #endif
 } // namespace std
+
+#if JSON_HAS_RANGES
+    template <typename IteratorType>
+    inline constexpr bool ::std::ranges::enable_borrowed_range<::nlohmann::detail::iteration_proxy<IteratorType>> = true;
+#endif
diff --git a/include/nlohmann/detail/macro_scope.hpp b/include/nlohmann/detail/macro_scope.hpp
index cc9ac5fc7..18a527c19 100644
--- a/include/nlohmann/detail/macro_scope.hpp
+++ b/include/nlohmann/detail/macro_scope.hpp
@@ -37,6 +37,12 @@
     #define JSON_HAS_CPP_11
 #endif
 
+#ifdef __has_include
+    #if __has_include(<version>)
+        #include <version>
+    #endif
+#endif
+
 #if !defined(JSON_HAS_FILESYSTEM) && !defined(JSON_HAS_EXPERIMENTAL_FILESYSTEM)
     #ifdef JSON_HAS_CPP_17
         #if defined(__cpp_lib_filesystem)
@@ -98,14 +104,31 @@
 #endif
 
 #ifndef JSON_HAS_THREE_WAY_COMPARISON
-    #if defined(__cpp_lib_three_way_comparison) && __cpp_lib_three_way_comparison >= 201907L \
-        && defined(__cpp_impl_three_way_comparison)&& __cpp_impl_three_way_comparison >= 201907L
+    #if defined(__cpp_impl_three_way_comparison) && __cpp_impl_three_way_comparison >= 201907L \
+        && defined(__cpp_lib_three_way_comparison) && __cpp_lib_three_way_comparison >= 201907L
         #define JSON_HAS_THREE_WAY_COMPARISON 1
     #else
         #define JSON_HAS_THREE_WAY_COMPARISON 0
     #endif
 #endif
 
+#ifndef JSON_HAS_RANGES
+    // ranges header shipping in GCC 11.1.0 (released 2021-04-27) has syntax error
+    #if defined(__GLIBCXX__) && __GLIBCXX__ == 20210427
+        #define JSON_HAS_RANGES 0
+    #elif defined(__cpp_lib_ranges)
+        #define JSON_HAS_RANGES 1
+    #else
+        #define JSON_HAS_RANGES 0
+    #endif
+#endif
+
+#ifdef JSON_HAS_CPP_17
+    #define JSON_INLINE_VARIABLE inline
+#else
+    #define JSON_INLINE_VARIABLE
+#endif
+
 #if JSON_HEDLEY_HAS_ATTRIBUTE(no_unique_address)
     #define JSON_NO_UNIQUE_ADDRESS [[no_unique_address]]
 #else
@@ -429,3 +452,7 @@
 #ifndef JSON_DIAGNOSTICS
     #define JSON_DIAGNOSTICS 0
 #endif
+
+#ifndef JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
+    #define JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON 0
+#endif
diff --git a/include/nlohmann/detail/macro_unscope.hpp b/include/nlohmann/detail/macro_unscope.hpp
index ec57b02cc..396fe1a33 100644
--- a/include/nlohmann/detail/macro_unscope.hpp
+++ b/include/nlohmann/detail/macro_unscope.hpp
@@ -14,6 +14,7 @@
 #undef NLOHMANN_BASIC_JSON_TPL
 #undef JSON_EXPLICIT
 #undef NLOHMANN_CAN_CALL_STD_FUNC_IMPL
+#undef JSON_INLINE_VARIABLE
 #undef JSON_NO_UNIQUE_ADDRESS
 
 #ifndef JSON_TEST_KEEP_MACROS
@@ -26,6 +27,8 @@
     #undef JSON_HAS_FILESYSTEM
     #undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
     #undef JSON_HAS_THREE_WAY_COMPARISON
+    #undef JSON_HAS_RANGES
+    #undef JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
 #endif
 
 #include <nlohmann/thirdparty/hedley/hedley_undef.hpp>
diff --git a/include/nlohmann/detail/value_t.hpp b/include/nlohmann/detail/value_t.hpp
index a98c4355a..5a32b646e 100644
--- a/include/nlohmann/detail/value_t.hpp
+++ b/include/nlohmann/detail/value_t.hpp
@@ -5,6 +5,11 @@
 #include <cstdint> // uint8_t
 #include <string> // string
 
+#include <nlohmann/detail/macro_scope.hpp>
+#if JSON_HAS_THREE_WAY_COMPARISON
+    #include <compare> // partial_ordering
+#endif
+
 namespace nlohmann
 {
 namespace detail
@@ -64,7 +69,11 @@ Returns an ordering that is similar to Python:
 
 @since version 1.0.0
 */
-inline bool operator<(const value_t lhs, const value_t rhs) noexcept
+#if JSON_HAS_THREE_WAY_COMPARISON
+    inline std::partial_ordering operator<=>(const value_t lhs, const value_t rhs) noexcept // *NOPAD*
+#else
+    inline bool operator<(const value_t lhs, const value_t rhs) noexcept
+#endif
 {
     static constexpr std::array<std::uint8_t, 9> order = {{
             0 /* null */, 3 /* object */, 4 /* array */, 5 /* string */,
@@ -75,7 +84,26 @@ inline bool operator<(const value_t lhs, const value_t rhs) noexcept
 
     const auto l_index = static_cast<std::size_t>(lhs);
     const auto r_index = static_cast<std::size_t>(rhs);
+#if JSON_HAS_THREE_WAY_COMPARISON
+    if (l_index < order.size() && r_index < order.size())
+    {
+        return order[l_index] <=> order[r_index]; // *NOPAD*
+    }
+    return std::partial_ordering::unordered;
+#else
     return l_index < order.size() && r_index < order.size() && order[l_index] < order[r_index];
+#endif
 }
+
+// GCC selects the built-in operator< over an operator rewritten from
+// a user-defined spaceship operator
+// Clang, MSVC, and ICC select the rewritten candidate
+// (see GCC bug https://gcc.gnu.org/bugzilla/show_bug.cgi?id=105200)
+#if JSON_HAS_THREE_WAY_COMPARISON && defined(__GNUC__)
+inline bool operator<(const value_t lhs, const value_t rhs) noexcept
+{
+    return std::is_lt(lhs <=> rhs); // *NOPAD*
+}
+#endif
 }  // namespace detail
 }  // namespace nlohmann
diff --git a/include/nlohmann/json.hpp b/include/nlohmann/json.hpp
index fb0f5fc18..7a1030c76 100644
--- a/include/nlohmann/json.hpp
+++ b/include/nlohmann/json.hpp
@@ -1905,7 +1905,6 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
                                         detail::negation<std::is_same<ValueType, typename string_t::value_type>>,
                                         detail::negation<detail::is_basic_json<ValueType>>,
                                         detail::negation<std::is_same<ValueType, std::initializer_list<typename string_t::value_type>>>,
-
 #if defined(JSON_HAS_CPP_17) && (defined(__GNUC__) || (defined(_MSC_VER) && _MSC_VER >= 1910 && _MSC_VER <= 1914))
                                                 detail::negation<std::is_same<ValueType, std::string_view>>,
 #endif
@@ -3538,7 +3537,6 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @}
 
-  public:
     //////////////////////////////////////////
     // lexicographical comparison operators //
     //////////////////////////////////////////
@@ -3546,6 +3544,212 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// @name lexicographical comparison operators
     /// @{
 
+    // note parentheses around operands are necessary; see
+    // https://github.com/nlohmann/json/issues/1530
+#define JSON_IMPLEMENT_OPERATOR(op, null_result, unordered_result, default_result)                       \
+    const auto lhs_type = lhs.type();                                                                    \
+    const auto rhs_type = rhs.type();                                                                    \
+    \
+    if (lhs_type == rhs_type) /* NOLINT(readability/braces) */                                           \
+    {                                                                                                    \
+        switch (lhs_type)                                                                                \
+        {                                                                                                \
+            case value_t::array:                                                                         \
+                return (*lhs.m_value.array) op (*rhs.m_value.array);                                     \
+                \
+            case value_t::object:                                                                        \
+                return (*lhs.m_value.object) op (*rhs.m_value.object);                                   \
+                \
+            case value_t::null:                                                                          \
+                return (null_result);                                                                    \
+                \
+            case value_t::string:                                                                        \
+                return (*lhs.m_value.string) op (*rhs.m_value.string);                                   \
+                \
+            case value_t::boolean:                                                                       \
+                return (lhs.m_value.boolean) op (rhs.m_value.boolean);                                   \
+                \
+            case value_t::number_integer:                                                                \
+                return (lhs.m_value.number_integer) op (rhs.m_value.number_integer);                     \
+                \
+            case value_t::number_unsigned:                                                               \
+                return (lhs.m_value.number_unsigned) op (rhs.m_value.number_unsigned);                   \
+                \
+            case value_t::number_float:                                                                  \
+                return (lhs.m_value.number_float) op (rhs.m_value.number_float);                         \
+                \
+            case value_t::binary:                                                                        \
+                return (*lhs.m_value.binary) op (*rhs.m_value.binary);                                   \
+                \
+            case value_t::discarded:                                                                     \
+            default:                                                                                     \
+                return (unordered_result);                                                               \
+        }                                                                                                \
+    }                                                                                                    \
+    else if (lhs_type == value_t::number_integer && rhs_type == value_t::number_float)                   \
+    {                                                                                                    \
+        return static_cast<number_float_t>(lhs.m_value.number_integer) op rhs.m_value.number_float;      \
+    }                                                                                                    \
+    else if (lhs_type == value_t::number_float && rhs_type == value_t::number_integer)                   \
+    {                                                                                                    \
+        return lhs.m_value.number_float op static_cast<number_float_t>(rhs.m_value.number_integer);      \
+    }                                                                                                    \
+    else if (lhs_type == value_t::number_unsigned && rhs_type == value_t::number_float)                  \
+    {                                                                                                    \
+        return static_cast<number_float_t>(lhs.m_value.number_unsigned) op rhs.m_value.number_float;     \
+    }                                                                                                    \
+    else if (lhs_type == value_t::number_float && rhs_type == value_t::number_unsigned)                  \
+    {                                                                                                    \
+        return lhs.m_value.number_float op static_cast<number_float_t>(rhs.m_value.number_unsigned);     \
+    }                                                                                                    \
+    else if (lhs_type == value_t::number_unsigned && rhs_type == value_t::number_integer)                \
+    {                                                                                                    \
+        return static_cast<number_integer_t>(lhs.m_value.number_unsigned) op rhs.m_value.number_integer; \
+    }                                                                                                    \
+    else if (lhs_type == value_t::number_integer && rhs_type == value_t::number_unsigned)                \
+    {                                                                                                    \
+        return lhs.m_value.number_integer op static_cast<number_integer_t>(rhs.m_value.number_unsigned); \
+    }                                                                                                    \
+    else if(compares_unordered(lhs, rhs))\
+    {\
+        return (unordered_result);\
+    }\
+    \
+    return (default_result);
+
+  JSON_PRIVATE_UNLESS_TESTED:
+    // returns true if:
+    // - any operand is NaN and the other operand is of number type
+    // - any operand is discarded
+    // in legacy mode, discarded values are considered ordered if
+    // an operation is computed as an odd number of inverses of others
+    static bool compares_unordered(const_reference lhs, const_reference rhs, bool inverse = false) noexcept
+    {
+        if ((lhs.is_number_float() && std::isnan(lhs.m_value.number_float) && rhs.is_number())
+                || (rhs.is_number_float() && std::isnan(rhs.m_value.number_float) && lhs.is_number()))
+        {
+            return true;
+        }
+#if JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
+        return (lhs.is_discarded() || rhs.is_discarded()) && !inverse;
+#else
+        static_cast<void>(inverse);
+        return lhs.is_discarded() || rhs.is_discarded();
+#endif
+    }
+
+  private:
+    bool compares_unordered(const_reference rhs, bool inverse = false) const noexcept
+    {
+        return compares_unordered(*this, rhs, inverse);
+    }
+
+  public:
+#if JSON_HAS_THREE_WAY_COMPARISON
+    /// @brief comparison: equal
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_eq/
+    bool operator==(const_reference rhs) const noexcept
+    {
+#ifdef __GNUC__
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wfloat-equal"
+#endif
+        const_reference lhs = *this;
+        JSON_IMPLEMENT_OPERATOR( ==, true, false, false)
+#ifdef __GNUC__
+#pragma GCC diagnostic pop
+#endif
+    }
+
+    /// @brief comparison: equal
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_eq/
+    template<typename ScalarType>
+    requires std::is_scalar_v<ScalarType>
+    bool operator==(ScalarType rhs) const noexcept
+    {
+        return *this == basic_json(rhs);
+    }
+
+    /// @brief comparison: not equal
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_ne/
+    bool operator!=(const_reference rhs) const noexcept
+    {
+        if (compares_unordered(rhs, true))
+        {
+            return false;
+        }
+        return !operator==(rhs);
+    }
+
+    /// @brief comparison: 3-way
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_spaceship/
+    std::partial_ordering operator<=>(const_reference rhs) const noexcept // *NOPAD*
+    {
+        const_reference lhs = *this;
+        // default_result is used if we cannot compare values. In that case,
+        // we compare types.
+        JSON_IMPLEMENT_OPERATOR(<=>, // *NOPAD*
+                                std::partial_ordering::equivalent,
+                                std::partial_ordering::unordered,
+                                lhs_type <=> rhs_type) // *NOPAD*
+    }
+
+    /// @brief comparison: 3-way
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_spaceship/
+    template<typename ScalarType>
+    requires std::is_scalar_v<ScalarType>
+    std::partial_ordering operator<=>(ScalarType rhs) const noexcept // *NOPAD*
+    {
+        return *this <=> basic_json(rhs); // *NOPAD*
+    }
+
+#if JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
+    // all operators that are computed as an odd number of inverses of others
+    // need to be overloaded to emulate the legacy comparison behavior
+
+    /// @brief comparison: less than or equal
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_le/
+    JSON_HEDLEY_DEPRECATED_FOR(3.11.0, undef JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON)
+    bool operator<=(const_reference rhs) const noexcept
+    {
+        if (compares_unordered(rhs, true))
+        {
+            return false;
+        }
+        return !(rhs < *this);
+    }
+
+    /// @brief comparison: less than or equal
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_le/
+    template<typename ScalarType>
+    requires std::is_scalar_v<ScalarType>
+    bool operator<=(ScalarType rhs) const noexcept
+    {
+        return *this <= basic_json(rhs);
+    }
+
+    /// @brief comparison: greater than or equal
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_ge/
+    JSON_HEDLEY_DEPRECATED_FOR(3.11.0, undef JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON)
+    bool operator>=(const_reference rhs) const noexcept
+    {
+        if (compares_unordered(rhs, true))
+        {
+            return false;
+        }
+        return !(*this < rhs);
+    }
+
+    /// @brief comparison: greater than or equal
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_ge/
+    template<typename ScalarType>
+    requires std::is_scalar_v<ScalarType>
+    bool operator>=(ScalarType rhs) const noexcept
+    {
+        return *this >= basic_json(rhs);
+    }
+#endif
+#else
     /// @brief comparison: equal
     /// @sa https://json.nlohmann.me/api/basic_json/operator_eq/
     friend bool operator==(const_reference lhs, const_reference rhs) noexcept
@@ -3554,71 +3758,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 #pragma GCC diagnostic push
 #pragma GCC diagnostic ignored "-Wfloat-equal"
 #endif
-        const auto lhs_type = lhs.type();
-        const auto rhs_type = rhs.type();
-
-        if (lhs_type == rhs_type)
-        {
-            switch (lhs_type)
-            {
-                case value_t::array:
-                    return *lhs.m_value.array == *rhs.m_value.array;
-
-                case value_t::object:
-                    return *lhs.m_value.object == *rhs.m_value.object;
-
-                case value_t::null:
-                    return true;
-
-                case value_t::string:
-                    return *lhs.m_value.string == *rhs.m_value.string;
-
-                case value_t::boolean:
-                    return lhs.m_value.boolean == rhs.m_value.boolean;
-
-                case value_t::number_integer:
-                    return lhs.m_value.number_integer == rhs.m_value.number_integer;
-
-                case value_t::number_unsigned:
-                    return lhs.m_value.number_unsigned == rhs.m_value.number_unsigned;
-
-                case value_t::number_float:
-                    return lhs.m_value.number_float == rhs.m_value.number_float;
-
-                case value_t::binary:
-                    return *lhs.m_value.binary == *rhs.m_value.binary;
-
-                case value_t::discarded:
-                default:
-                    return false;
-            }
-        }
-        else if (lhs_type == value_t::number_integer && rhs_type == value_t::number_float)
-        {
-            return static_cast<number_float_t>(lhs.m_value.number_integer) == rhs.m_value.number_float;
-        }
-        else if (lhs_type == value_t::number_float && rhs_type == value_t::number_integer)
-        {
-            return lhs.m_value.number_float == static_cast<number_float_t>(rhs.m_value.number_integer);
-        }
-        else if (lhs_type == value_t::number_unsigned && rhs_type == value_t::number_float)
-        {
-            return static_cast<number_float_t>(lhs.m_value.number_unsigned) == rhs.m_value.number_float;
-        }
-        else if (lhs_type == value_t::number_float && rhs_type == value_t::number_unsigned)
-        {
-            return lhs.m_value.number_float == static_cast<number_float_t>(rhs.m_value.number_unsigned);
-        }
-        else if (lhs_type == value_t::number_unsigned && rhs_type == value_t::number_integer)
-        {
-            return static_cast<number_integer_t>(lhs.m_value.number_unsigned) == rhs.m_value.number_integer;
-        }
-        else if (lhs_type == value_t::number_integer && rhs_type == value_t::number_unsigned)
-        {
-            return lhs.m_value.number_integer == static_cast<number_integer_t>(rhs.m_value.number_unsigned);
-        }
-
-        return false;
+        JSON_IMPLEMENT_OPERATOR( ==, true, false, false)
 #ifdef __GNUC__
 #pragma GCC diagnostic pop
 #endif
@@ -3646,6 +3786,10 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// @sa https://json.nlohmann.me/api/basic_json/operator_ne/
     friend bool operator!=(const_reference lhs, const_reference rhs) noexcept
     {
+        if (compares_unordered(lhs, rhs, true))
+        {
+            return false;
+        }
         return !(lhs == rhs);
     }
 
@@ -3671,76 +3815,10 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// @sa https://json.nlohmann.me/api/basic_json/operator_lt/
     friend bool operator<(const_reference lhs, const_reference rhs) noexcept
     {
-        const auto lhs_type = lhs.type();
-        const auto rhs_type = rhs.type();
-
-        if (lhs_type == rhs_type)
-        {
-            switch (lhs_type)
-            {
-                case value_t::array:
-                    // note parentheses are necessary, see
-                    // https://github.com/nlohmann/json/issues/1530
-                    return (*lhs.m_value.array) < (*rhs.m_value.array);
-
-                case value_t::object:
-                    return (*lhs.m_value.object) < (*rhs.m_value.object);
-
-                case value_t::null:
-                    return false;
-
-                case value_t::string:
-                    return (*lhs.m_value.string) < (*rhs.m_value.string);
-
-                case value_t::boolean:
-                    return (lhs.m_value.boolean) < (rhs.m_value.boolean);
-
-                case value_t::number_integer:
-                    return (lhs.m_value.number_integer) < (rhs.m_value.number_integer);
-
-                case value_t::number_unsigned:
-                    return (lhs.m_value.number_unsigned) < (rhs.m_value.number_unsigned);
-
-                case value_t::number_float:
-                    return (lhs.m_value.number_float) < (rhs.m_value.number_float);
-
-                case value_t::binary:
-                    return (*lhs.m_value.binary) < (*rhs.m_value.binary);
-
-                case value_t::discarded:
-                default:
-                    return false;
-            }
-        }
-        else if (lhs_type == value_t::number_integer && rhs_type == value_t::number_float)
-        {
-            return static_cast<number_float_t>(lhs.m_value.number_integer) < rhs.m_value.number_float;
-        }
-        else if (lhs_type == value_t::number_float && rhs_type == value_t::number_integer)
-        {
-            return lhs.m_value.number_float < static_cast<number_float_t>(rhs.m_value.number_integer);
-        }
-        else if (lhs_type == value_t::number_unsigned && rhs_type == value_t::number_float)
-        {
-            return static_cast<number_float_t>(lhs.m_value.number_unsigned) < rhs.m_value.number_float;
-        }
-        else if (lhs_type == value_t::number_float && rhs_type == value_t::number_unsigned)
-        {
-            return lhs.m_value.number_float < static_cast<number_float_t>(rhs.m_value.number_unsigned);
-        }
-        else if (lhs_type == value_t::number_integer && rhs_type == value_t::number_unsigned)
-        {
-            return lhs.m_value.number_integer < static_cast<number_integer_t>(rhs.m_value.number_unsigned);
-        }
-        else if (lhs_type == value_t::number_unsigned && rhs_type == value_t::number_integer)
-        {
-            return static_cast<number_integer_t>(lhs.m_value.number_unsigned) < rhs.m_value.number_integer;
-        }
-
-        // We only reach this line if we cannot compare values. In that case,
+        // default_result is used if we cannot compare values. In that case,
         // we compare types. Note we have to call the operator explicitly,
         // because MSVC has problems otherwise.
-        return operator<(lhs_type, rhs_type);
+        JSON_IMPLEMENT_OPERATOR( <, false, false, operator<(lhs_type, rhs_type))
     }
 
     /// @brief comparison: less than
@@ -3765,6 +3843,10 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// @sa https://json.nlohmann.me/api/basic_json/operator_le/
     friend bool operator<=(const_reference lhs, const_reference rhs) noexcept
     {
+        if (compares_unordered(lhs, rhs, true))
+        {
+            return false;
+        }
         return !(rhs < lhs);
     }
 
@@ -3790,6 +3872,11 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// @sa https://json.nlohmann.me/api/basic_json/operator_gt/
     friend bool operator>(const_reference lhs, const_reference rhs) noexcept
     {
+        // double inverse
+        if (compares_unordered(lhs, rhs))
+        {
+            return false;
+        }
         return !(lhs <= rhs);
     }
 
@@ -3815,6 +3902,10 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// @sa https://json.nlohmann.me/api/basic_json/operator_ge/
     friend bool operator>=(const_reference lhs, const_reference rhs) noexcept
     {
+        if (compares_unordered(lhs, rhs, true))
+        {
+            return false;
+        }
         return !(lhs < rhs);
     }
 
@@ -3835,6 +3926,9 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     {
         return basic_json(lhs) >= rhs;
     }
+#endif
+
+#undef JSON_IMPLEMENT_OPERATOR
 
     /// @}
 
@@ -5031,10 +5125,14 @@ struct less< ::nlohmann::detail::value_t> // do not remove the space after '<',
     @brief compare two value_t enum values
     @since version 3.0.0
     */
-    bool operator()(nlohmann::detail::value_t lhs,
-                    nlohmann::detail::value_t rhs) const noexcept
+    bool operator()(::nlohmann::detail::value_t lhs,
+                    ::nlohmann::detail::value_t rhs) const noexcept
     {
-        return nlohmann::detail::operator<(lhs, rhs);
+#if JSON_HAS_THREE_WAY_COMPARISON
+        return std::is_lt(lhs <=> rhs); // *NOPAD*
+#else
+        return ::nlohmann::detail::operator<(lhs, rhs);
+#endif
     }
 };
 
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index 5993ce32a..30386c5e8 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -103,84 +103,6 @@ SOFTWARE.
 #include <cstdint> // uint8_t
 #include <string> // string
 
-namespace nlohmann
-{
-namespace detail
-{
-///////////////////////////
-// JSON type enumeration //
-///////////////////////////
-
-/*!
-@brief the JSON type enumeration
-
-This enumeration collects the different JSON types. It is internally used to
-distinguish the stored values, and the functions @ref basic_json::is_null(),
-@ref basic_json::is_object(), @ref basic_json::is_array(),
-@ref basic_json::is_string(), @ref basic_json::is_boolean(),
-@ref basic_json::is_number() (with @ref basic_json::is_number_integer(),
-@ref basic_json::is_number_unsigned(), and @ref basic_json::is_number_float()),
-@ref basic_json::is_discarded(), @ref basic_json::is_primitive(), and
-@ref basic_json::is_structured() rely on it.
-
-@note There are three enumeration entries (number_integer, number_unsigned, and
-number_float), because the library distinguishes these three types for numbers:
-@ref basic_json::number_unsigned_t is used for unsigned integers,
-@ref basic_json::number_integer_t is used for signed integers, and
-@ref basic_json::number_float_t is used for floating-point numbers or to
-approximate integers which do not fit in the limits of their respective type.
-
-@sa see @ref basic_json::basic_json(const value_t value_type) -- create a JSON
-value with the default value for a given type
-
-@since version 1.0.0
-*/
-enum class value_t : std::uint8_t
-{
-    null,             ///< null value
-    object,           ///< object (unordered set of name/value pairs)
-    array,            ///< array (ordered collection of values)
-    string,           ///< string value
-    boolean,          ///< boolean value
-    number_integer,   ///< number value (signed integer)
-    number_unsigned,  ///< number value (unsigned integer)
-    number_float,     ///< number value (floating-point)
-    binary,           ///< binary array (ordered collection of bytes)
-    discarded         ///< discarded by the parser callback function
-};
-
-/*!
-@brief comparison operator for JSON types
-
-Returns an ordering that is similar to Python:
-- order: null < boolean < number < object < array < string < binary
-- furthermore, each type is not smaller than itself
-- discarded values are not comparable
-- binary is represented as a b"" string in python and directly comparable to a
-  string; however, making a binary array directly comparable with a string would
-  be surprising behavior in a JSON file.
-
-@since version 1.0.0
-*/
-inline bool operator<(const value_t lhs, const value_t rhs) noexcept
-{
-    static constexpr std::array<std::uint8_t, 9> order = {{
-            0 /* null */, 3 /* object */, 4 /* array */, 5 /* string */,
-            1 /* boolean */, 2 /* integer */, 2 /* unsigned */, 2 /* float */,
-            6 /* binary */
-        }
-    };
-
-    const auto l_index = static_cast<std::size_t>(lhs);
-    const auto r_index = static_cast<std::size_t>(rhs);
-    return l_index < order.size() && r_index < order.size() && order[l_index] < order[r_index];
-}
-}  // namespace detail
-}  // namespace nlohmann
-
-// #include <nlohmann/detail/string_escape.hpp>
-
-
 // #include <nlohmann/detail/macro_scope.hpp>
 
 
@@ -2342,6 +2264,12 @@ using is_detected_convertible =
     #define JSON_HAS_CPP_11
 #endif
 
+#ifdef __has_include
+    #if __has_include(<version>)
+        #include <version>
+    #endif
+#endif
+
 #if !defined(JSON_HAS_FILESYSTEM) && !defined(JSON_HAS_EXPERIMENTAL_FILESYSTEM)
     #ifdef JSON_HAS_CPP_17
         #if defined(__cpp_lib_filesystem)
@@ -2403,14 +2331,31 @@ using is_detected_convertible =
 #endif
 
 #ifndef JSON_HAS_THREE_WAY_COMPARISON
-    #if defined(__cpp_lib_three_way_comparison) && __cpp_lib_three_way_comparison >= 201907L \
-        && defined(__cpp_impl_three_way_comparison)&& __cpp_impl_three_way_comparison >= 201907L
+    #if defined(__cpp_impl_three_way_comparison) && __cpp_impl_three_way_comparison >= 201907L \
+        && defined(__cpp_lib_three_way_comparison) && __cpp_lib_three_way_comparison >= 201907L
         #define JSON_HAS_THREE_WAY_COMPARISON 1
     #else
         #define JSON_HAS_THREE_WAY_COMPARISON 0
     #endif
 #endif
 
+#ifndef JSON_HAS_RANGES
+    // ranges header shipping in GCC 11.1.0 (released 2021-04-27) has syntax error
+    #if defined(__GLIBCXX__) && __GLIBCXX__ == 20210427
+        #define JSON_HAS_RANGES 0
+    #elif defined(__cpp_lib_ranges)
+        #define JSON_HAS_RANGES 1
+    #else
+        #define JSON_HAS_RANGES 0
+    #endif
+#endif
+
+#ifdef JSON_HAS_CPP_17
+    #define JSON_INLINE_VARIABLE inline
+#else
+    #define JSON_INLINE_VARIABLE
+#endif
+
 #if JSON_HEDLEY_HAS_ATTRIBUTE(no_unique_address)
     #define JSON_NO_UNIQUE_ADDRESS [[no_unique_address]]
 #else
@@ -2735,6 +2680,117 @@ using is_detected_convertible =
     #define JSON_DIAGNOSTICS 0
 #endif
 
+#ifndef JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
+    #define JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON 0
+#endif
+
+#if JSON_HAS_THREE_WAY_COMPARISON
+    #include <compare> // partial_ordering
+#endif
+
+namespace nlohmann
+{
+namespace detail
+{
+///////////////////////////
+// JSON type enumeration //
+///////////////////////////
+
+/*!
+@brief the JSON type enumeration
+
+This enumeration collects the different JSON types. It is internally used to
+distinguish the stored values, and the functions @ref basic_json::is_null(),
+@ref basic_json::is_object(), @ref basic_json::is_array(),
+@ref basic_json::is_string(), @ref basic_json::is_boolean(),
+@ref basic_json::is_number() (with @ref basic_json::is_number_integer(),
+@ref basic_json::is_number_unsigned(), and @ref basic_json::is_number_float()),
+@ref basic_json::is_discarded(), @ref basic_json::is_primitive(), and
+@ref basic_json::is_structured() rely on it.
+
+@note There are three enumeration entries (number_integer, number_unsigned, and
+number_float), because the library distinguishes these three types for numbers:
+@ref basic_json::number_unsigned_t is used for unsigned integers,
+@ref basic_json::number_integer_t is used for signed integers, and
+@ref basic_json::number_float_t is used for floating-point numbers or to
+approximate integers which do not fit in the limits of their respective type.
+
+@sa see @ref basic_json::basic_json(const value_t value_type) -- create a JSON
+value with the default value for a given type
+
+@since version 1.0.0
+*/
+enum class value_t : std::uint8_t
+{
+    null,             ///< null value
+    object,           ///< object (unordered set of name/value pairs)
+    array,            ///< array (ordered collection of values)
+    string,           ///< string value
+    boolean,          ///< boolean value
+    number_integer,   ///< number value (signed integer)
+    number_unsigned,  ///< number value (unsigned integer)
+    number_float,     ///< number value (floating-point)
+    binary,           ///< binary array (ordered collection of bytes)
+    discarded         ///< discarded by the parser callback function
+};
+
+/*!
+@brief comparison operator for JSON types
+
+Returns an ordering that is similar to Python:
+- order: null < boolean < number < object < array < string < binary
+- furthermore, each type is not smaller than itself
+- discarded values are not comparable
+- binary is represented as a b"" string in python and directly comparable to a
+  string; however, making a binary array directly comparable with a string would
+  be surprising behavior in a JSON file.
+
+@since version 1.0.0
+*/
+#if JSON_HAS_THREE_WAY_COMPARISON
+    inline std::partial_ordering operator<=>(const value_t lhs, const value_t rhs) noexcept // *NOPAD*
+#else
+    inline bool operator<(const value_t lhs, const value_t rhs) noexcept
+#endif
+{
+    static constexpr std::array<std::uint8_t, 9> order = {{
+            0 /* null */, 3 /* object */, 4 /* array */, 5 /* string */,
+            1 /* boolean */, 2 /* integer */, 2 /* unsigned */, 2 /* float */,
+            6 /* binary */
+        }
+    };
+
+    const auto l_index = static_cast<std::size_t>(lhs);
+    const auto r_index = static_cast<std::size_t>(rhs);
+#if JSON_HAS_THREE_WAY_COMPARISON
+    if (l_index < order.size() && r_index < order.size())
+    {
+        return order[l_index] <=> order[r_index]; // *NOPAD*
+    }
+    return std::partial_ordering::unordered;
+#else
+    return l_index < order.size() && r_index < order.size() && order[l_index] < order[r_index];
+#endif
+}
+
+// GCC selects the built-in operator< over an operator rewritten from
+// a user-defined spaceship operator
+// Clang, MSVC, and ICC select the rewritten candidate
+// (see GCC bug https://gcc.gnu.org/bugzilla/show_bug.cgi?id=105200)
+#if JSON_HAS_THREE_WAY_COMPARISON && defined(__GNUC__)
+inline bool operator<(const value_t lhs, const value_t rhs) noexcept
+{
+    return std::is_lt(lhs <=> rhs); // *NOPAD*
+}
+#endif
+}  // namespace detail
+}  // namespace nlohmann
+
+// #include <nlohmann/detail/string_escape.hpp>
+
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
 
 namespace nlohmann
 {
@@ -4133,7 +4189,7 @@ namespace nlohmann
 namespace detail
 {
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, typename std::nullptr_t& n)
+inline void from_json(const BasicJsonType& j, typename std::nullptr_t& n)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_null()))
     {
@@ -4180,7 +4236,7 @@ void get_arithmetic_value(const BasicJsonType& j, ArithmeticType& val)
 }
 
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, typename BasicJsonType::boolean_t& b)
+inline void from_json(const BasicJsonType& j, typename BasicJsonType::boolean_t& b)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_boolean()))
     {
@@ -4190,7 +4246,7 @@ void from_json(const BasicJsonType& j, typename BasicJsonType::boolean_t& b)
 }
 
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, typename BasicJsonType::string_t& s)
+inline void from_json(const BasicJsonType& j, typename BasicJsonType::string_t& s)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_string()))
     {
@@ -4205,7 +4261,7 @@ template <
         std::is_assignable<StringType&, const typename BasicJsonType::string_t>::value
         && !std::is_same<typename BasicJsonType::string_t, StringType>::value
         && !is_json_ref<StringType>::value, int > = 0 >
-void from_json(const BasicJsonType& j, StringType& s)
+inline void from_json(const BasicJsonType& j, StringType& s)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_string()))
     {
@@ -4216,26 +4272,26 @@ void from_json(const BasicJsonType& j, StringType& s)
 }
 
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, typename BasicJsonType::number_float_t& val)
+inline void from_json(const BasicJsonType& j, typename BasicJsonType::number_float_t& val)
 {
     get_arithmetic_value(j, val);
 }
 
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, typename BasicJsonType::number_unsigned_t& val)
+inline void from_json(const BasicJsonType& j, typename BasicJsonType::number_unsigned_t& val)
 {
     get_arithmetic_value(j, val);
 }
 
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, typename BasicJsonType::number_integer_t& val)
+inline void from_json(const BasicJsonType& j, typename BasicJsonType::number_integer_t& val)
 {
     get_arithmetic_value(j, val);
 }
 
 template<typename BasicJsonType, typename EnumType,
          enable_if_t<std::is_enum<EnumType>::value, int> = 0>
-void from_json(const BasicJsonType& j, EnumType& e)
+inline void from_json(const BasicJsonType& j, EnumType& e)
 {
     typename std::underlying_type<EnumType>::type val;
     get_arithmetic_value(j, val);
@@ -4245,7 +4301,7 @@ void from_json(const BasicJsonType& j, EnumType& e)
 // forward_list doesn't have an insert method
 template<typename BasicJsonType, typename T, typename Allocator,
          enable_if_t<is_getable<BasicJsonType, T>::value, int> = 0>
-void from_json(const BasicJsonType& j, std::forward_list<T, Allocator>& l)
+inline void from_json(const BasicJsonType& j, std::forward_list<T, Allocator>& l)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
     {
@@ -4262,7 +4318,7 @@ void from_json(const BasicJsonType& j, std::forward_list<T, Allocator>& l)
 // valarray doesn't have an insert method
 template<typename BasicJsonType, typename T,
          enable_if_t<is_getable<BasicJsonType, T>::value, int> = 0>
-void from_json(const BasicJsonType& j, std::valarray<T>& l)
+inline void from_json(const BasicJsonType& j, std::valarray<T>& l)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
     {
@@ -4287,7 +4343,7 @@ auto from_json(const BasicJsonType& j, T (&arr)[N])  // NOLINT(cppcoreguidelines
 }
 
 template<typename BasicJsonType>
-void from_json_array_impl(const BasicJsonType& j, typename BasicJsonType::array_t& arr, priority_tag<3> /*unused*/)
+inline void from_json_array_impl(const BasicJsonType& j, typename BasicJsonType::array_t& arr, priority_tag<3> /*unused*/)
 {
     arr = *j.template get_ptr<const typename BasicJsonType::array_t*>();
 }
@@ -4331,8 +4387,8 @@ template<typename BasicJsonType, typename ConstructibleArrayType,
          enable_if_t<
              std::is_assignable<ConstructibleArrayType&, ConstructibleArrayType>::value,
              int> = 0>
-void from_json_array_impl(const BasicJsonType& j, ConstructibleArrayType& arr,
-                          priority_tag<0> /*unused*/)
+inline void from_json_array_impl(const BasicJsonType& j, ConstructibleArrayType& arr,
+                                 priority_tag<0> /*unused*/)
 {
     using std::end;
 
@@ -4389,7 +4445,7 @@ auto from_json(BasicJsonType&& j, identity_tag<std::array<T, N>> tag)
 }
 
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, typename BasicJsonType::binary_t& bin)
+inline void from_json(const BasicJsonType& j, typename BasicJsonType::binary_t& bin)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_binary()))
     {
@@ -4401,7 +4457,7 @@ void from_json(const BasicJsonType& j, typename BasicJsonType::binary_t& bin)
 
 template<typename BasicJsonType, typename ConstructibleObjectType,
          enable_if_t<is_constructible_object_type<BasicJsonType, ConstructibleObjectType>::value, int> = 0>
-void from_json(const BasicJsonType& j, ConstructibleObjectType& obj)
+inline void from_json(const BasicJsonType& j, ConstructibleObjectType& obj)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_object()))
     {
@@ -4433,7 +4489,7 @@ template < typename BasicJsonType, typename ArithmeticType,
                !std::is_same<ArithmeticType, typename BasicJsonType::number_float_t>::value&&
                !std::is_same<ArithmeticType, typename BasicJsonType::boolean_t>::value,
                int > = 0 >
-void from_json(const BasicJsonType& j, ArithmeticType& val)
+inline void from_json(const BasicJsonType& j, ArithmeticType& val)
 {
     switch (static_cast<value_t>(j))
     {
@@ -4483,7 +4539,7 @@ std::pair<A1, A2> from_json_tuple_impl(BasicJsonType&& j, identity_tag<std::pair
 }
 
 template<typename BasicJsonType, typename A1, typename A2>
-void from_json_tuple_impl(BasicJsonType&& j, std::pair<A1, A2>& p, priority_tag<1> /*unused*/)
+inline void from_json_tuple_impl(BasicJsonType&& j, std::pair<A1, A2>& p, priority_tag<1> /*unused*/)
 {
     p = from_json_tuple_impl(std::forward<BasicJsonType>(j), identity_tag<std::pair<A1, A2>> {}, priority_tag<0> {});
 }
@@ -4495,7 +4551,7 @@ std::tuple<Args...> from_json_tuple_impl(BasicJsonType&& j, identity_tag<std::tu
 }
 
 template<typename BasicJsonType, typename... Args>
-void from_json_tuple_impl(BasicJsonType&& j, std::tuple<Args...>& t, priority_tag<3> /*unused*/)
+inline void from_json_tuple_impl(BasicJsonType&& j, std::tuple<Args...>& t, priority_tag<3> /*unused*/)
 {
     t = from_json_tuple_impl_base<BasicJsonType, Args...>(std::forward<BasicJsonType>(j), index_sequence_for<Args...> {});
 }
@@ -4515,7 +4571,7 @@ auto from_json(BasicJsonType&& j, TupleRelated&& t)
 template < typename BasicJsonType, typename Key, typename Value, typename Compare, typename Allocator,
            typename = enable_if_t < !std::is_constructible <
                                         typename BasicJsonType::string_t, Key >::value >>
-void from_json(const BasicJsonType& j, std::map<Key, Value, Compare, Allocator>& m)
+inline void from_json(const BasicJsonType& j, std::map<Key, Value, Compare, Allocator>& m)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
     {
@@ -4535,7 +4591,7 @@ void from_json(const BasicJsonType& j, std::map<Key, Value, Compare, Allocator>&
 template < typename BasicJsonType, typename Key, typename Value, typename Hash, typename KeyEqual, typename Allocator,
            typename = enable_if_t < !std::is_constructible <
                                         typename BasicJsonType::string_t, Key >::value >>
-void from_json(const BasicJsonType& j, std::unordered_map<Key, Value, Hash, KeyEqual, Allocator>& m)
+inline void from_json(const BasicJsonType& j, std::unordered_map<Key, Value, Hash, KeyEqual, Allocator>& m)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
     {
@@ -4554,7 +4610,7 @@ void from_json(const BasicJsonType& j, std::unordered_map<Key, Value, Hash, KeyE
 
 #if JSON_HAS_FILESYSTEM || JSON_HAS_EXPERIMENTAL_FILESYSTEM
 template<typename BasicJsonType>
-void from_json(const BasicJsonType& j, std_fs::path& p)
+inline void from_json(const BasicJsonType& j, std_fs::path& p)
 {
     if (JSON_HEDLEY_UNLIKELY(!j.is_string()))
     {
@@ -4576,13 +4632,18 @@ struct from_json_fn
 };
 }  // namespace detail
 
+#ifndef JSON_HAS_CPP_17
 /// namespace to hold default `from_json` function
 /// to see why this is required:
 /// http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/n4381.html
 namespace // NOLINT(cert-dcl59-cpp,fuchsia-header-anon-namespaces,google-build-namespaces)
 {
-constexpr const auto& from_json = detail::static_const<detail::from_json_fn>::value; // NOLINT(misc-definitions-in-headers)
+#endif
+JSON_INLINE_VARIABLE constexpr const auto& from_json = // NOLINT(misc-definitions-in-headers)
+    detail::static_const<detail::from_json_fn>::value;
+#ifndef JSON_HAS_CPP_17
 } // namespace
+#endif
 } // namespace nlohmann
 
 // #include <nlohmann/detail/conversions/to_json.hpp>
@@ -4608,6 +4669,10 @@ constexpr const auto& from_json = detail::static_const<detail::from_json_fn>::va
 #include <tuple> // tuple_size, get, tuple_element
 #include <utility> // move
 
+#if JSON_HAS_RANGES
+    #include <ranges> // enable_borrowed_range
+#endif
+
 // #include <nlohmann/detail/meta/type_traits.hpp>
 
 // #include <nlohmann/detail/value_t.hpp>
@@ -4629,14 +4694,14 @@ template<typename IteratorType> class iteration_proxy_value
   public:
     using difference_type = std::ptrdiff_t;
     using value_type = iteration_proxy_value;
-    using pointer = value_type * ;
-    using reference = value_type & ;
+    using pointer = value_type *;
+    using reference = value_type &;
     using iterator_category = std::input_iterator_tag;
     using string_type = typename std::remove_cv< typename std::remove_reference<decltype( std::declval<IteratorType>().key() ) >::type >::type;
 
   private:
     /// the iterator
-    IteratorType anchor;
+    IteratorType anchor{};
     /// an index for arrays (used to create key names)
     std::size_t array_index = 0;
     /// last stringified array index
@@ -4644,15 +4709,30 @@ template<typename IteratorType> class iteration_proxy_value
     /// a string representation of the array index
     mutable string_type array_index_str = "0";
     /// an empty string (to return a reference for primitive values)
-    const string_type empty_str{};
+    string_type empty_str{};
 
   public:
-    explicit iteration_proxy_value(IteratorType it) noexcept
+    explicit iteration_proxy_value() = default;
+    explicit iteration_proxy_value(IteratorType it, std::size_t array_index_ = 0)
+    noexcept(std::is_nothrow_move_constructible<IteratorType>::value
+             && std::is_nothrow_default_constructible<string_type>::value)
         : anchor(std::move(it))
+        , array_index(array_index_)
     {}
 
+    iteration_proxy_value(iteration_proxy_value const&) = default;
+    iteration_proxy_value& operator=(iteration_proxy_value const&) = default;
+    // older GCCs are a bit fussy and require explicit noexcept specifiers on defaulted functions
+    iteration_proxy_value(iteration_proxy_value&&)
+    noexcept(std::is_nothrow_move_constructible<IteratorType>::value
+             && std::is_nothrow_move_constructible<string_type>::value) = default;
+    iteration_proxy_value& operator=(iteration_proxy_value&&)
+    noexcept(std::is_nothrow_move_assignable<IteratorType>::value
+             && std::is_nothrow_move_assignable<string_type>::value) = default;
+    ~iteration_proxy_value() = default;
+
     /// dereference operator (needed for range-based for)
-    iteration_proxy_value& operator*()
+    const iteration_proxy_value& operator*() const
     {
         return *this;
     }
@@ -4666,6 +4746,14 @@ template<typename IteratorType> class iteration_proxy_value
         return *this;
     }
 
+    iteration_proxy_value operator++(int)& // NOLINT(cert-dcl21-cpp)
+    {
+        auto tmp = iteration_proxy_value(anchor, array_index);
+        ++anchor;
+        ++array_index;
+        return tmp;
+    }
+
     /// equality operator (needed for InputIterator)
     bool operator==(const iteration_proxy_value& o) const
     {
@@ -4726,25 +4814,34 @@ template<typename IteratorType> class iteration_proxy
 {
   private:
     /// the container to iterate
-    typename IteratorType::reference container;
+    typename IteratorType::pointer container = nullptr;
 
   public:
+    explicit iteration_proxy() = default;
+
     /// construct iteration proxy from a container
     explicit iteration_proxy(typename IteratorType::reference cont) noexcept
-        : container(cont) {}
+        : container(&cont) {}
+
+    iteration_proxy(iteration_proxy const&) = default;
+    iteration_proxy& operator=(iteration_proxy const&) = default;
+    iteration_proxy(iteration_proxy&&) noexcept = default;
+    iteration_proxy& operator=(iteration_proxy&&) noexcept = default;
+    ~iteration_proxy() = default;
 
     /// return iterator begin (needed for range-based for)
-    iteration_proxy_value<IteratorType> begin() noexcept
+    iteration_proxy_value<IteratorType> begin() const noexcept
     {
-        return iteration_proxy_value<IteratorType>(container.begin());
+        return iteration_proxy_value<IteratorType>(container->begin());
     }
 
     /// return iterator end (needed for range-based for)
-    iteration_proxy_value<IteratorType> end() noexcept
+    iteration_proxy_value<IteratorType> end() const noexcept
     {
-        return iteration_proxy_value<IteratorType>(container.end());
+        return iteration_proxy_value<IteratorType>(container->end());
     }
 };
+
 // Structured Bindings Support
 // For further reference see https://blog.tartanllama.xyz/structured-bindings/
 // And see https://github.com/nlohmann/json/pull/1391
@@ -4792,6 +4889,11 @@ class tuple_element<N, ::nlohmann::detail::iteration_proxy_value<IteratorType >>
 #endif
 } // namespace std
 
+#if JSON_HAS_RANGES
+    template <typename IteratorType>
+    inline constexpr bool ::std::ranges::enable_borrowed_range<::nlohmann::detail::iteration_proxy<IteratorType>> = true;
+#endif
+
 // #include <nlohmann/detail/meta/cpp_future.hpp>
 
 // #include <nlohmann/detail/meta/type_traits.hpp>
@@ -5051,55 +5153,55 @@ struct external_constructor<value_t::object>
 
 template<typename BasicJsonType, typename T,
          enable_if_t<std::is_same<T, typename BasicJsonType::boolean_t>::value, int> = 0>
-void to_json(BasicJsonType& j, T b) noexcept
+inline void to_json(BasicJsonType& j, T b) noexcept
 {
     external_constructor<value_t::boolean>::construct(j, b);
 }
 
 template<typename BasicJsonType, typename CompatibleString,
          enable_if_t<std::is_constructible<typename BasicJsonType::string_t, CompatibleString>::value, int> = 0>
-void to_json(BasicJsonType& j, const CompatibleString& s)
+inline void to_json(BasicJsonType& j, const CompatibleString& s)
 {
     external_constructor<value_t::string>::construct(j, s);
 }
 
 template<typename BasicJsonType>
-void to_json(BasicJsonType& j, typename BasicJsonType::string_t&& s)
+inline void to_json(BasicJsonType& j, typename BasicJsonType::string_t&& s)
 {
     external_constructor<value_t::string>::construct(j, std::move(s));
 }
 
 template<typename BasicJsonType, typename FloatType,
          enable_if_t<std::is_floating_point<FloatType>::value, int> = 0>
-void to_json(BasicJsonType& j, FloatType val) noexcept
+inline void to_json(BasicJsonType& j, FloatType val) noexcept
 {
     external_constructor<value_t::number_float>::construct(j, static_cast<typename BasicJsonType::number_float_t>(val));
 }
 
 template<typename BasicJsonType, typename CompatibleNumberUnsignedType,
          enable_if_t<is_compatible_integer_type<typename BasicJsonType::number_unsigned_t, CompatibleNumberUnsignedType>::value, int> = 0>
-void to_json(BasicJsonType& j, CompatibleNumberUnsignedType val) noexcept
+inline void to_json(BasicJsonType& j, CompatibleNumberUnsignedType val) noexcept
 {
     external_constructor<value_t::number_unsigned>::construct(j, static_cast<typename BasicJsonType::number_unsigned_t>(val));
 }
 
 template<typename BasicJsonType, typename CompatibleNumberIntegerType,
          enable_if_t<is_compatible_integer_type<typename BasicJsonType::number_integer_t, CompatibleNumberIntegerType>::value, int> = 0>
-void to_json(BasicJsonType& j, CompatibleNumberIntegerType val) noexcept
+inline void to_json(BasicJsonType& j, CompatibleNumberIntegerType val) noexcept
 {
     external_constructor<value_t::number_integer>::construct(j, static_cast<typename BasicJsonType::number_integer_t>(val));
 }
 
 template<typename BasicJsonType, typename EnumType,
          enable_if_t<std::is_enum<EnumType>::value, int> = 0>
-void to_json(BasicJsonType& j, EnumType e) noexcept
+inline void to_json(BasicJsonType& j, EnumType e) noexcept
 {
     using underlying_type = typename std::underlying_type<EnumType>::type;
     external_constructor<value_t::number_integer>::construct(j, static_cast<underlying_type>(e));
 }
 
 template<typename BasicJsonType>
-void to_json(BasicJsonType& j, const std::vector<bool>& e)
+inline void to_json(BasicJsonType& j, const std::vector<bool>& e)
 {
     external_constructor<value_t::array>::construct(j, e);
 }
@@ -5112,39 +5214,39 @@ template < typename BasicJsonType, typename CompatibleArrayType,
                          !std::is_same<typename BasicJsonType::binary_t, CompatibleArrayType>::value&&
                          !is_basic_json<CompatibleArrayType>::value,
                          int > = 0 >
-void to_json(BasicJsonType& j, const CompatibleArrayType& arr)
+inline void to_json(BasicJsonType& j, const CompatibleArrayType& arr)
 {
     external_constructor<value_t::array>::construct(j, arr);
 }
 
 template<typename BasicJsonType>
-void to_json(BasicJsonType& j, const typename BasicJsonType::binary_t& bin)
+inline void to_json(BasicJsonType& j, const typename BasicJsonType::binary_t& bin)
 {
     external_constructor<value_t::binary>::construct(j, bin);
 }
 
 template<typename BasicJsonType, typename T,
          enable_if_t<std::is_convertible<T, BasicJsonType>::value, int> = 0>
-void to_json(BasicJsonType& j, const std::valarray<T>& arr)
+inline void to_json(BasicJsonType& j, const std::valarray<T>& arr)
 {
     external_constructor<value_t::array>::construct(j, std::move(arr));
 }
 
 template<typename BasicJsonType>
-void to_json(BasicJsonType& j, typename BasicJsonType::array_t&& arr)
+inline void to_json(BasicJsonType& j, typename BasicJsonType::array_t&& arr)
 {
     external_constructor<value_t::array>::construct(j, std::move(arr));
 }
 
 template < typename BasicJsonType, typename CompatibleObjectType,
            enable_if_t < is_compatible_object_type<BasicJsonType, CompatibleObjectType>::value&& !is_basic_json<CompatibleObjectType>::value, int > = 0 >
-void to_json(BasicJsonType& j, const CompatibleObjectType& obj)
+inline void to_json(BasicJsonType& j, const CompatibleObjectType& obj)
 {
     external_constructor<value_t::object>::construct(j, obj);
 }
 
 template<typename BasicJsonType>
-void to_json(BasicJsonType& j, typename BasicJsonType::object_t&& obj)
+inline void to_json(BasicJsonType& j, typename BasicJsonType::object_t&& obj)
 {
     external_constructor<value_t::object>::construct(j, std::move(obj));
 }
@@ -5154,13 +5256,13 @@ template <
     enable_if_t < !std::is_constructible<typename BasicJsonType::string_t,
                   const T(&)[N]>::value, // NOLINT(cppcoreguidelines-avoid-c-arrays,hicpp-avoid-c-arrays,modernize-avoid-c-arrays)
                   int > = 0 >
-void to_json(BasicJsonType& j, const T(&arr)[N]) // NOLINT(cppcoreguidelines-avoid-c-arrays,hicpp-avoid-c-arrays,modernize-avoid-c-arrays)
+inline void to_json(BasicJsonType& j, const T(&arr)[N]) // NOLINT(cppcoreguidelines-avoid-c-arrays,hicpp-avoid-c-arrays,modernize-avoid-c-arrays)
 {
     external_constructor<value_t::array>::construct(j, arr);
 }
 
 template < typename BasicJsonType, typename T1, typename T2, enable_if_t < std::is_constructible<BasicJsonType, T1>::value&& std::is_constructible<BasicJsonType, T2>::value, int > = 0 >
-void to_json(BasicJsonType& j, const std::pair<T1, T2>& p)
+inline void to_json(BasicJsonType& j, const std::pair<T1, T2>& p)
 {
     j = { p.first, p.second };
 }
@@ -5168,26 +5270,26 @@ void to_json(BasicJsonType& j, const std::pair<T1, T2>& p)
 // for https://github.com/nlohmann/json/pull/1134
 template<typename BasicJsonType, typename T,
          enable_if_t<std::is_same<T, iteration_proxy_value<typename BasicJsonType::iterator>>::value, int> = 0>
-void to_json(BasicJsonType& j, const T& b)
+inline void to_json(BasicJsonType& j, const T& b)
 {
     j = { {b.key(), b.value()} };
 }
 
 template<typename BasicJsonType, typename Tuple, std::size_t... Idx>
-void to_json_tuple_impl(BasicJsonType& j, const Tuple& t, index_sequence<Idx...> /*unused*/)
+inline void to_json_tuple_impl(BasicJsonType& j, const Tuple& t, index_sequence<Idx...> /*unused*/)
 {
     j = { std::get<Idx>(t)... };
 }
 
 template<typename BasicJsonType, typename T, enable_if_t<is_constructible_tuple<BasicJsonType, T>::value, int > = 0>
-void to_json(BasicJsonType& j, const T& t)
+inline void to_json(BasicJsonType& j, const T& t)
 {
     to_json_tuple_impl(j, t, make_index_sequence<std::tuple_size<T>::value> {});
 }
 
 #if JSON_HAS_FILESYSTEM || JSON_HAS_EXPERIMENTAL_FILESYSTEM
 template<typename BasicJsonType>
-void to_json(BasicJsonType& j, const std_fs::path& p)
+inline void to_json(BasicJsonType& j, const std_fs::path& p)
 {
     j = p.string();
 }
@@ -5204,13 +5306,18 @@ struct to_json_fn
 };
 }  // namespace detail
 
+#ifndef JSON_HAS_CPP_17
 /// namespace to hold default `to_json` function
 /// to see why this is required:
 /// http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/n4381.html
 namespace // NOLINT(cert-dcl59-cpp,fuchsia-header-anon-namespaces,google-build-namespaces)
 {
-constexpr const auto& to_json = detail::static_const<detail::to_json_fn>::value; // NOLINT(misc-definitions-in-headers)
+#endif
+JSON_INLINE_VARIABLE constexpr const auto& to_json = // NOLINT(misc-definitions-in-headers)
+    detail::static_const<detail::to_json_fn>::value;
+#ifndef JSON_HAS_CPP_17
 } // namespace
+#endif
 } // namespace nlohmann
 
 // #include <nlohmann/detail/meta/identity_tag.hpp>
@@ -12155,9 +12262,12 @@ class iter_impl // NOLINT(cppcoreguidelines-special-member-functions,hicpp-speci
     // make sure BasicJsonType is basic_json or const basic_json
     static_assert(is_basic_json<typename std::remove_const<BasicJsonType>::type>::value,
                   "iter_impl only accepts (const) basic_json");
+    // superficial check for the LegacyBidirectionalIterator named requirement
+    static_assert(std::is_base_of<std::bidirectional_iterator_tag, std::bidirectional_iterator_tag>::value
+                  &&  std::is_base_of<std::bidirectional_iterator_tag, typename array_t::iterator::iterator_category>::value,
+                  "basic_json iterator assumes array and object type iterators satisfy the LegacyBidirectionalIterator named requirement.");
 
   public:
-
     /// The std::iterator class template (used as a base class to provide typedefs) is deprecated in C++17.
     /// The C++ Standard has never required user-defined iterators to derive from std::iterator.
     /// A user-defined iterator should provide publicly accessible typedefs named
@@ -20065,7 +20175,6 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
                                         detail::negation<std::is_same<ValueType, typename string_t::value_type>>,
                                         detail::negation<detail::is_basic_json<ValueType>>,
                                         detail::negation<std::is_same<ValueType, std::initializer_list<typename string_t::value_type>>>,
-
 #if defined(JSON_HAS_CPP_17) && (defined(__GNUC__) || (defined(_MSC_VER) && _MSC_VER >= 1910 && _MSC_VER <= 1914))
                                                 detail::negation<std::is_same<ValueType, std::string_view>>,
 #endif
@@ -21698,7 +21807,6 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 
     /// @}
 
-  public:
     //////////////////////////////////////////
     // lexicographical comparison operators //
     //////////////////////////////////////////
@@ -21706,6 +21814,212 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// @name lexicographical comparison operators
     /// @{
 
+    // note parentheses around operands are necessary; see
+    // https://github.com/nlohmann/json/issues/1530
+#define JSON_IMPLEMENT_OPERATOR(op, null_result, unordered_result, default_result)                       \
+    const auto lhs_type = lhs.type();                                                                    \
+    const auto rhs_type = rhs.type();                                                                    \
+    \
+    if (lhs_type == rhs_type) /* NOLINT(readability/braces) */                                           \
+    {                                                                                                    \
+        switch (lhs_type)                                                                                \
+        {                                                                                                \
+            case value_t::array:                                                                         \
+                return (*lhs.m_value.array) op (*rhs.m_value.array);                                     \
+                \
+            case value_t::object:                                                                        \
+                return (*lhs.m_value.object) op (*rhs.m_value.object);                                   \
+                \
+            case value_t::null:                                                                          \
+                return (null_result);                                                                    \
+                \
+            case value_t::string:                                                                        \
+                return (*lhs.m_value.string) op (*rhs.m_value.string);                                   \
+                \
+            case value_t::boolean:                                                                       \
+                return (lhs.m_value.boolean) op (rhs.m_value.boolean);                                   \
+                \
+            case value_t::number_integer:                                                                \
+                return (lhs.m_value.number_integer) op (rhs.m_value.number_integer);                     \
+                \
+            case value_t::number_unsigned:                                                               \
+                return (lhs.m_value.number_unsigned) op (rhs.m_value.number_unsigned);                   \
+                \
+            case value_t::number_float:                                                                  \
+                return (lhs.m_value.number_float) op (rhs.m_value.number_float);                         \
+                \
+            case value_t::binary:                                                                        \
+                return (*lhs.m_value.binary) op (*rhs.m_value.binary);                                   \
+                \
+            case value_t::discarded:                                                                     \
+            default:                                                                                     \
+                return (unordered_result);                                                               \
+        }                                                                                                \
+    }                                                                                                    \
+    else if (lhs_type == value_t::number_integer && rhs_type == value_t::number_float)                   \
+    {                                                                                                    \
+        return static_cast<number_float_t>(lhs.m_value.number_integer) op rhs.m_value.number_float;      \
+    }                                                                                                    \
+    else if (lhs_type == value_t::number_float && rhs_type == value_t::number_integer)                   \
+    {                                                                                                    \
+        return lhs.m_value.number_float op static_cast<number_float_t>(rhs.m_value.number_integer);      \
+    }                                                                                                    \
+    else if (lhs_type == value_t::number_unsigned && rhs_type == value_t::number_float)                  \
+    {                                                                                                    \
+        return static_cast<number_float_t>(lhs.m_value.number_unsigned) op rhs.m_value.number_float;     \
+    }                                                                                                    \
+    else if (lhs_type == value_t::number_float && rhs_type == value_t::number_unsigned)                  \
+    {                                                                                                    \
+        return lhs.m_value.number_float op static_cast<number_float_t>(rhs.m_value.number_unsigned);     \
+    }                                                                                                    \
+    else if (lhs_type == value_t::number_unsigned && rhs_type == value_t::number_integer)                \
+    {                                                                                                    \
+        return static_cast<number_integer_t>(lhs.m_value.number_unsigned) op rhs.m_value.number_integer; \
+    }                                                                                                    \
+    else if (lhs_type == value_t::number_integer && rhs_type == value_t::number_unsigned)                \
+    {                                                                                                    \
+        return lhs.m_value.number_integer op static_cast<number_integer_t>(rhs.m_value.number_unsigned); \
+    }                                                                                                    \
+    else if(compares_unordered(lhs, rhs))\
+    {\
+        return (unordered_result);\
+    }\
+    \
+    return (default_result);
+
+  JSON_PRIVATE_UNLESS_TESTED:
+    // returns true if:
+    // - any operand is NaN and the other operand is of number type
+    // - any operand is discarded
+    // in legacy mode, discarded values are considered ordered if
+    // an operation is computed as an odd number of inverses of others
+    static bool compares_unordered(const_reference lhs, const_reference rhs, bool inverse = false) noexcept
+    {
+        if ((lhs.is_number_float() && std::isnan(lhs.m_value.number_float) && rhs.is_number())
+                || (rhs.is_number_float() && std::isnan(rhs.m_value.number_float) && lhs.is_number()))
+        {
+            return true;
+        }
+#if JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
+        return (lhs.is_discarded() || rhs.is_discarded()) && !inverse;
+#else
+        static_cast<void>(inverse);
+        return lhs.is_discarded() || rhs.is_discarded();
+#endif
+    }
+
+  private:
+    bool compares_unordered(const_reference rhs, bool inverse = false) const noexcept
+    {
+        return compares_unordered(*this, rhs, inverse);
+    }
+
+  public:
+#if JSON_HAS_THREE_WAY_COMPARISON
+    /// @brief comparison: equal
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_eq/
+    bool operator==(const_reference rhs) const noexcept
+    {
+#ifdef __GNUC__
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wfloat-equal"
+#endif
+        const_reference lhs = *this;
+        JSON_IMPLEMENT_OPERATOR( ==, true, false, false)
+#ifdef __GNUC__
+#pragma GCC diagnostic pop
+#endif
+    }
+
+    /// @brief comparison: equal
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_eq/
+    template<typename ScalarType>
+    requires std::is_scalar_v<ScalarType>
+    bool operator==(ScalarType rhs) const noexcept
+    {
+        return *this == basic_json(rhs);
+    }
+
+    /// @brief comparison: not equal
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_ne/
+    bool operator!=(const_reference rhs) const noexcept
+    {
+        if (compares_unordered(rhs, true))
+        {
+            return false;
+        }
+        return !operator==(rhs);
+    }
+
+    /// @brief comparison: 3-way
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_spaceship/
+    std::partial_ordering operator<=>(const_reference rhs) const noexcept // *NOPAD*
+    {
+        const_reference lhs = *this;
+        // default_result is used if we cannot compare values. In that case,
+        // we compare types.
+        JSON_IMPLEMENT_OPERATOR(<=>, // *NOPAD*
+                                std::partial_ordering::equivalent,
+                                std::partial_ordering::unordered,
+                                lhs_type <=> rhs_type) // *NOPAD*
+    }
+
+    /// @brief comparison: 3-way
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_spaceship/
+    template<typename ScalarType>
+    requires std::is_scalar_v<ScalarType>
+    std::partial_ordering operator<=>(ScalarType rhs) const noexcept // *NOPAD*
+    {
+        return *this <=> basic_json(rhs); // *NOPAD*
+    }
+
+#if JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
+    // all operators that are computed as an odd number of inverses of others
+    // need to be overloaded to emulate the legacy comparison behavior
+
+    /// @brief comparison: less than or equal
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_le/
+    JSON_HEDLEY_DEPRECATED_FOR(3.11.0, undef JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON)
+    bool operator<=(const_reference rhs) const noexcept
+    {
+        if (compares_unordered(rhs, true))
+        {
+            return false;
+        }
+        return !(rhs < *this);
+    }
+
+    /// @brief comparison: less than or equal
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_le/
+    template<typename ScalarType>
+    requires std::is_scalar_v<ScalarType>
+    bool operator<=(ScalarType rhs) const noexcept
+    {
+        return *this <= basic_json(rhs);
+    }
+
+    /// @brief comparison: greater than or equal
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_ge/
+    JSON_HEDLEY_DEPRECATED_FOR(3.11.0, undef JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON)
+    bool operator>=(const_reference rhs) const noexcept
+    {
+        if (compares_unordered(rhs, true))
+        {
+            return false;
+        }
+        return !(*this < rhs);
+    }
+
+    /// @brief comparison: greater than or equal
+    /// @sa https://json.nlohmann.me/api/basic_json/operator_ge/
+    template<typename ScalarType>
+    requires std::is_scalar_v<ScalarType>
+    bool operator>=(ScalarType rhs) const noexcept
+    {
+        return *this >= basic_json(rhs);
+    }
+#endif
+#else
     /// @brief comparison: equal
     /// @sa https://json.nlohmann.me/api/basic_json/operator_eq/
     friend bool operator==(const_reference lhs, const_reference rhs) noexcept
@@ -21714,71 +22028,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
 #pragma GCC diagnostic push
 #pragma GCC diagnostic ignored "-Wfloat-equal"
 #endif
-        const auto lhs_type = lhs.type();
-        const auto rhs_type = rhs.type();
-
-        if (lhs_type == rhs_type)
-        {
-            switch (lhs_type)
-            {
-                case value_t::array:
-                    return *lhs.m_value.array == *rhs.m_value.array;
-
-                case value_t::object:
-                    return *lhs.m_value.object == *rhs.m_value.object;
-
-                case value_t::null:
-                    return true;
-
-                case value_t::string:
-                    return *lhs.m_value.string == *rhs.m_value.string;
-
-                case value_t::boolean:
-                    return lhs.m_value.boolean == rhs.m_value.boolean;
-
-                case value_t::number_integer:
-                    return lhs.m_value.number_integer == rhs.m_value.number_integer;
-
-                case value_t::number_unsigned:
-                    return lhs.m_value.number_unsigned == rhs.m_value.number_unsigned;
-
-                case value_t::number_float:
-                    return lhs.m_value.number_float == rhs.m_value.number_float;
-
-                case value_t::binary:
-                    return *lhs.m_value.binary == *rhs.m_value.binary;
-
-                case value_t::discarded:
-                default:
-                    return false;
-            }
-        }
-        else if (lhs_type == value_t::number_integer && rhs_type == value_t::number_float)
-        {
-            return static_cast<number_float_t>(lhs.m_value.number_integer) == rhs.m_value.number_float;
-        }
-        else if (lhs_type == value_t::number_float && rhs_type == value_t::number_integer)
-        {
-            return lhs.m_value.number_float == static_cast<number_float_t>(rhs.m_value.number_integer);
-        }
-        else if (lhs_type == value_t::number_unsigned && rhs_type == value_t::number_float)
-        {
-            return static_cast<number_float_t>(lhs.m_value.number_unsigned) == rhs.m_value.number_float;
-        }
-        else if (lhs_type == value_t::number_float && rhs_type == value_t::number_unsigned)
-        {
-            return lhs.m_value.number_float == static_cast<number_float_t>(rhs.m_value.number_unsigned);
-        }
-        else if (lhs_type == value_t::number_unsigned && rhs_type == value_t::number_integer)
-        {
-            return static_cast<number_integer_t>(lhs.m_value.number_unsigned) == rhs.m_value.number_integer;
-        }
-        else if (lhs_type == value_t::number_integer && rhs_type == value_t::number_unsigned)
-        {
-            return lhs.m_value.number_integer == static_cast<number_integer_t>(rhs.m_value.number_unsigned);
-        }
-
-        return false;
+        JSON_IMPLEMENT_OPERATOR( ==, true, false, false)
 #ifdef __GNUC__
 #pragma GCC diagnostic pop
 #endif
@@ -21806,6 +22056,10 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// @sa https://json.nlohmann.me/api/basic_json/operator_ne/
     friend bool operator!=(const_reference lhs, const_reference rhs) noexcept
     {
+        if (compares_unordered(lhs, rhs, true))
+        {
+            return false;
+        }
         return !(lhs == rhs);
     }
 
@@ -21831,76 +22085,10 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// @sa https://json.nlohmann.me/api/basic_json/operator_lt/
     friend bool operator<(const_reference lhs, const_reference rhs) noexcept
     {
-        const auto lhs_type = lhs.type();
-        const auto rhs_type = rhs.type();
-
-        if (lhs_type == rhs_type)
-        {
-            switch (lhs_type)
-            {
-                case value_t::array:
-                    // note parentheses are necessary, see
-                    // https://github.com/nlohmann/json/issues/1530
-                    return (*lhs.m_value.array) < (*rhs.m_value.array);
-
-                case value_t::object:
-                    return (*lhs.m_value.object) < (*rhs.m_value.object);
-
-                case value_t::null:
-                    return false;
-
-                case value_t::string:
-                    return (*lhs.m_value.string) < (*rhs.m_value.string);
-
-                case value_t::boolean:
-                    return (lhs.m_value.boolean) < (rhs.m_value.boolean);
-
-                case value_t::number_integer:
-                    return (lhs.m_value.number_integer) < (rhs.m_value.number_integer);
-
-                case value_t::number_unsigned:
-                    return (lhs.m_value.number_unsigned) < (rhs.m_value.number_unsigned);
-
-                case value_t::number_float:
-                    return (lhs.m_value.number_float) < (rhs.m_value.number_float);
-
-                case value_t::binary:
-                    return (*lhs.m_value.binary) < (*rhs.m_value.binary);
-
-                case value_t::discarded:
-                default:
-                    return false;
-            }
-        }
-        else if (lhs_type == value_t::number_integer && rhs_type == value_t::number_float)
-        {
-            return static_cast<number_float_t>(lhs.m_value.number_integer) < rhs.m_value.number_float;
-        }
-        else if (lhs_type == value_t::number_float && rhs_type == value_t::number_integer)
-        {
-            return lhs.m_value.number_float < static_cast<number_float_t>(rhs.m_value.number_integer);
-        }
-        else if (lhs_type == value_t::number_unsigned && rhs_type == value_t::number_float)
-        {
-            return static_cast<number_float_t>(lhs.m_value.number_unsigned) < rhs.m_value.number_float;
-        }
-        else if (lhs_type == value_t::number_float && rhs_type == value_t::number_unsigned)
-        {
-            return lhs.m_value.number_float < static_cast<number_float_t>(rhs.m_value.number_unsigned);
-        }
-        else if (lhs_type == value_t::number_integer && rhs_type == value_t::number_unsigned)
-        {
-            return lhs.m_value.number_integer < static_cast<number_integer_t>(rhs.m_value.number_unsigned);
-        }
-        else if (lhs_type == value_t::number_unsigned && rhs_type == value_t::number_integer)
-        {
-            return static_cast<number_integer_t>(lhs.m_value.number_unsigned) < rhs.m_value.number_integer;
-        }
-
-        // We only reach this line if we cannot compare values. In that case,
+        // default_result is used if we cannot compare values. In that case,
         // we compare types. Note we have to call the operator explicitly,
         // because MSVC has problems otherwise.
-        return operator<(lhs_type, rhs_type);
+        JSON_IMPLEMENT_OPERATOR( <, false, false, operator<(lhs_type, rhs_type))
     }
 
     /// @brief comparison: less than
@@ -21925,6 +22113,10 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// @sa https://json.nlohmann.me/api/basic_json/operator_le/
     friend bool operator<=(const_reference lhs, const_reference rhs) noexcept
     {
+        if (compares_unordered(lhs, rhs, true))
+        {
+            return false;
+        }
         return !(rhs < lhs);
     }
 
@@ -21950,6 +22142,11 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// @sa https://json.nlohmann.me/api/basic_json/operator_gt/
     friend bool operator>(const_reference lhs, const_reference rhs) noexcept
     {
+        // double inverse
+        if (compares_unordered(lhs, rhs))
+        {
+            return false;
+        }
         return !(lhs <= rhs);
     }
 
@@ -21975,6 +22172,10 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     /// @sa https://json.nlohmann.me/api/basic_json/operator_ge/
     friend bool operator>=(const_reference lhs, const_reference rhs) noexcept
     {
+        if (compares_unordered(lhs, rhs, true))
+        {
+            return false;
+        }
         return !(lhs < rhs);
     }
 
@@ -21995,6 +22196,9 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
     {
         return basic_json(lhs) >= rhs;
     }
+#endif
+
+#undef JSON_IMPLEMENT_OPERATOR
 
     /// @}
 
@@ -23191,10 +23395,14 @@ struct less< ::nlohmann::detail::value_t> // do not remove the space after '<',
     @brief compare two value_t enum values
     @since version 3.0.0
     */
-    bool operator()(nlohmann::detail::value_t lhs,
-                    nlohmann::detail::value_t rhs) const noexcept
+    bool operator()(::nlohmann::detail::value_t lhs,
+                    ::nlohmann::detail::value_t rhs) const noexcept
     {
-        return nlohmann::detail::operator<(lhs, rhs);
+#if JSON_HAS_THREE_WAY_COMPARISON
+        return std::is_lt(lhs <=> rhs); // *NOPAD*
+#else
+        return ::nlohmann::detail::operator<(lhs, rhs);
+#endif
     }
 };
 
@@ -23248,6 +23456,7 @@ inline nlohmann::json::json_pointer operator "" _json_pointer(const char* s, std
 #undef NLOHMANN_BASIC_JSON_TPL
 #undef JSON_EXPLICIT
 #undef NLOHMANN_CAN_CALL_STD_FUNC_IMPL
+#undef JSON_INLINE_VARIABLE
 #undef JSON_NO_UNIQUE_ADDRESS
 
 #ifndef JSON_TEST_KEEP_MACROS
@@ -23260,6 +23469,8 @@ inline nlohmann::json::json_pointer operator "" _json_pointer(const char* s, std
     #undef JSON_HAS_FILESYSTEM
     #undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
     #undef JSON_HAS_THREE_WAY_COMPARISON
+    #undef JSON_HAS_RANGES
+    #undef JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
 #endif
 
 // #include <nlohmann/thirdparty/hedley/hedley_undef.hpp>
diff --git a/tests/CMakeLists.txt b/tests/CMakeLists.txt
index 2f6409c57..010c4950e 100644
--- a/tests/CMakeLists.txt
+++ b/tests/CMakeLists.txt
@@ -123,6 +123,15 @@ foreach(file ${files})
     json_test_add_test_for(${file} MAIN test_main CXX_STANDARDS ${test_cxx_standards} ${test_force})
 endforeach()
 
+# test legacy comparison of discarded values
+json_test_set_test_options(test-comparison_legacy
+    COMPILE_DEFINITIONS JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON=1
+)
+json_test_add_test_for(src/unit-comparison.cpp
+    NAME test-comparison_legacy
+    MAIN test_main CXX_STANDARDS ${test_cxx_standards} ${test_force}
+)
+
 # *DO NOT* use json_test_set_test_options() below this line
 
 #############################################################################
diff --git a/tests/src/unit-class_parser.cpp b/tests/src/unit-class_parser.cpp
index 95a958d1f..3d2677394 100644
--- a/tests/src/unit-class_parser.cpp
+++ b/tests/src/unit-class_parser.cpp
@@ -1454,17 +1454,17 @@ TEST_CASE("parser class")
 
         SECTION("filter specific element")
         {
-            json j_object = json::parse(s_object, [](int /*unused*/, json::parse_event_t /*unused*/, const json & j) noexcept
+            json j_object = json::parse(s_object, [](int /*unused*/, json::parse_event_t event, const json & j) noexcept
             {
                 // filter all number(2) elements
-                return j != json(2);
+                return event != json::parse_event_t::value || j != json(2);
             });
 
             CHECK (j_object == json({{"bar", {{"baz", 1}}}}));
 
-            json j_array = json::parse(s_array, [](int /*unused*/, json::parse_event_t /*unused*/, const json & j) noexcept
+            json j_array = json::parse(s_array, [](int /*unused*/, json::parse_event_t event, const json & j) noexcept
             {
-                return j != json(2);
+                return event != json::parse_event_t::value || j != json(2);
             });
 
             CHECK (j_array == json({1, {3, 4, 5}, 4, 5}));
diff --git a/tests/src/unit-comparison.cpp b/tests/src/unit-comparison.cpp
index 6c94add60..f310a70d1 100644
--- a/tests/src/unit-comparison.cpp
+++ b/tests/src/unit-comparison.cpp
@@ -27,11 +27,49 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE  OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 */
 
+// cmake/test.cmake selects the C++ standard versions with which to build a
+// unit test based on the presence of JSON_HAS_CPP_<VERSION> macros.
+// When using macros that are only defined for particular versions of the standard
+// (e.g., JSON_HAS_FILESYSTEM for C++17 and up), please mention the corresponding
+// version macro in a comment close by, like this:
+// JSON_HAS_CPP_<VERSION> (do not remove; see note at top of file)
+
 #include "doctest_compatibility.h"
 
+#define JSON_TESTS_PRIVATE
 #include <nlohmann/json.hpp>
 using nlohmann::json;
 
+#if JSON_HAS_THREE_WAY_COMPARISON
+// this can be replaced with the doctest stl extension header in version 2.5
+namespace doctest
+{
+template<> struct StringMaker<std::partial_ordering>
+{
+    static String convert(const std::partial_ordering& order)
+    {
+        if (order == std::partial_ordering::less)
+        {
+            return "std::partial_ordering::less";
+        }
+        if (order == std::partial_ordering::equivalent)
+        {
+            return "std::partial_ordering::equivalent";
+        }
+        if (order == std::partial_ordering::greater)
+        {
+            return "std::partial_ordering::greater";
+        }
+        if (order == std::partial_ordering::unordered)
+        {
+            return "std::partial_ordering::unordered";
+        }
+        return "{?}";
+    }
+};
+} // namespace doctest
+#endif
+
 namespace
 {
 // helper function to check std::less<json::value_t>
@@ -45,6 +83,27 @@ bool f(A a, B b, U u = U())
 
 TEST_CASE("lexicographical comparison operators")
 {
+    constexpr auto f_ = false;
+    constexpr auto _t = true;
+    constexpr auto nan = std::numeric_limits<json::number_float_t>::quiet_NaN();
+#if JSON_HAS_THREE_WAY_COMPARISON
+    constexpr auto lt = std::partial_ordering::less;
+    constexpr auto gt = std::partial_ordering::greater;
+    constexpr auto eq = std::partial_ordering::equivalent;
+    constexpr auto un = std::partial_ordering::unordered;
+#endif
+
+#if JSON_HAS_THREE_WAY_COMPARISON
+    INFO("using 3-way comparison");
+#endif
+
+#if JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
+    INFO("using legacy comparison");
+#endif
+
+    //REQUIRE(std::numeric_limits<json::number_float_t>::has_quiet_NaN);
+    REQUIRE(std::isnan(nan));
+
     SECTION("types")
     {
         std::vector<json::value_t> j_types =
@@ -57,97 +116,268 @@ TEST_CASE("lexicographical comparison operators")
             json::value_t::object,
             json::value_t::array,
             json::value_t::string,
-            json::value_t::binary
+            json::value_t::binary,
+            json::value_t::discarded
+        };
+
+        std::vector<std::vector<bool>> expected_lt =
+        {
+            //0   1   2   3   4   5   6   7   8   9
+            {f_, _t, _t, _t, _t, _t, _t, _t, _t, f_}, //  0
+            {f_, f_, _t, _t, _t, _t, _t, _t, _t, f_}, //  1
+            {f_, f_, f_, f_, f_, _t, _t, _t, _t, f_}, //  2
+            {f_, f_, f_, f_, f_, _t, _t, _t, _t, f_}, //  3
+            {f_, f_, f_, f_, f_, _t, _t, _t, _t, f_}, //  4
+            {f_, f_, f_, f_, f_, f_, _t, _t, _t, f_}, //  5
+            {f_, f_, f_, f_, f_, f_, f_, _t, _t, f_}, //  6
+            {f_, f_, f_, f_, f_, f_, f_, f_, _t, f_}, //  7
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  8
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  9
         };
 
         SECTION("comparison: less")
         {
-            std::vector<std::vector<bool>> expected =
-            {
-                {false, true, true, true, true, true, true, true, true},
-                {false, false, true, true, true, true, true, true, true},
-                {false, false, false, false, false, true, true, true, true},
-                {false, false, false, false, false, true, true, true, true},
-                {false, false, false, false, false, true, true, true, true},
-                {false, false, false, false, false, false, true, true, true},
-                {false, false, false, false, false, false, false, true, true},
-                {false, false, false, false, false, false, false, false, true},
-                {false, false, false, false, false, false, false, false, false}
-            };
-
+            REQUIRE(expected_lt.size() == j_types.size());
             for (size_t i = 0; i < j_types.size(); ++i)
             {
+                REQUIRE(expected_lt[i].size() == j_types.size());
                 for (size_t j = 0; j < j_types.size(); ++j)
                 {
                     CAPTURE(i)
                     CAPTURE(j)
                     // check precomputed values
-                    CHECK(operator<(j_types[i], j_types[j]) == expected[i][j]);
-                    CHECK(f(j_types[i], j_types[j]) == expected[i][j]);
+#if JSON_HAS_THREE_WAY_COMPARISON
+                    // JSON_HAS_CPP_20 (do not remove; see note at top of file)
+                    CHECK((j_types[i] < j_types[j]) == expected_lt[i][j]);
+#else
+                    CHECK(operator<(j_types[i], j_types[j]) == expected_lt[i][j]);
+#endif
+                    CHECK(f(j_types[i], j_types[j]) == expected_lt[i][j]);
                 }
             }
         }
+#if JSON_HAS_THREE_WAY_COMPARISON
+        // JSON_HAS_CPP_20 (do not remove; see note at top of file)
+        SECTION("comparison: 3-way")
+        {
+            std::vector<std::vector<std::partial_ordering>> expected =
+            {
+                //0   1   2   3   4   5   6   7   8   9
+                {eq, lt, lt, lt, lt, lt, lt, lt, lt, un}, //  0
+                {gt, eq, lt, lt, lt, lt, lt, lt, lt, un}, //  1
+                {gt, gt, eq, eq, eq, lt, lt, lt, lt, un}, //  2
+                {gt, gt, eq, eq, eq, lt, lt, lt, lt, un}, //  3
+                {gt, gt, eq, eq, eq, lt, lt, lt, lt, un}, //  4
+                {gt, gt, gt, gt, gt, eq, lt, lt, lt, un}, //  5
+                {gt, gt, gt, gt, gt, gt, eq, lt, lt, un}, //  6
+                {gt, gt, gt, gt, gt, gt, gt, eq, lt, un}, //  7
+                {gt, gt, gt, gt, gt, gt, gt, gt, eq, un}, //  8
+                {un, un, un, un, un, un, un, un, un, un}, //  9
+            };
+
+            // check expected partial_ordering against expected boolean
+            REQUIRE(expected.size() == expected_lt.size());
+            for (size_t i = 0; i < expected.size(); ++i)
+            {
+                REQUIRE(expected[i].size() == expected_lt[i].size());
+                for (size_t j = 0; j < expected[i].size(); ++j)
+                {
+                    CAPTURE(i)
+                    CAPTURE(j)
+                    CHECK(std::is_lt(expected[i][j]) == expected_lt[i][j]);
+                }
+            }
+
+            // check 3-way comparison against expected partial_ordering
+            REQUIRE(expected.size() == j_types.size());
+            for (size_t i = 0; i < j_types.size(); ++i)
+            {
+                REQUIRE(expected[i].size() == j_types.size());
+                for (size_t j = 0; j < j_types.size(); ++j)
+                {
+                    CAPTURE(i)
+                    CAPTURE(j)
+                    CHECK((j_types[i] <=> j_types[j]) == expected[i][j]); // *NOPAD*
+                }
+            }
+        }
+#endif
     }
 
     SECTION("values")
     {
         json j_values =
         {
-            nullptr, nullptr,
-            -17, 42,
-            8u, 13u,
-            3.14159, 23.42,
-            "foo", "bar",
-            true, false,
-            {1, 2, 3}, {"one", "two", "three"},
-            {{"first", 1}, {"second", 2}}, {{"a", "A"}, {"b", {"B"}}},
-            json::binary({1, 2, 3}), json::binary({1, 2, 4})
+            nullptr, nullptr,                                              // 0 1
+            -17, 42,                                                       // 2 3
+            8u, 13u,                                                       // 4 5
+            3.14159, 23.42,                                                // 6 7
+            nan, nan,                                                      // 8 9
+            "foo", "bar",                                                  // 10 11
+            true, false,                                                   // 12 13
+            {1, 2, 3}, {"one", "two", "three"},                            // 14 15
+            {{"first", 1}, {"second", 2}}, {{"a", "A"}, {"b", {"B"}}},     // 16 17
+            json::binary({1, 2, 3}), json::binary({1, 2, 4}),              // 18 19
+            json(json::value_t::discarded), json(json::value_t::discarded) // 20 21
         };
 
-        SECTION("comparison: equal")
+        std::vector<std::vector<bool>> expected_eq =
+        {
+            //0   1   2   3   4   5   6   7   8   9  10  11  12  13  14  15  16  17  18  19  20  21
+            {_t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  0
+            {_t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  1
+            {f_, f_, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  2
+            {f_, f_, f_, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  3
+            {f_, f_, f_, f_, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  4
+            {f_, f_, f_, f_, f_, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  5
+            {f_, f_, f_, f_, f_, f_, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  6
+            {f_, f_, f_, f_, f_, f_, f_, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  7
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  8
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  9
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 10
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 11
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 12
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, f_, f_, f_, f_, f_, f_, f_, f_}, // 13
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, f_, f_, f_, f_, f_, f_, f_}, // 14
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, f_, f_, f_, f_, f_, f_}, // 15
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, f_, f_, f_, f_, f_}, // 16
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, f_, f_, f_, f_}, // 17
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, f_, f_, f_}, // 18
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, f_, f_}, // 19
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 20
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 21
+        };
+
+        std::vector<std::vector<bool>> expected_lt =
+        {
+            //0   1   2   3   4   5   6   7   8   9  10  11  12  13  14  15  16  17  18  19  20  21
+            {f_, f_, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, f_, f_}, //  0
+            {f_, f_, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, f_, f_}, //  1
+            {f_, f_, f_, _t, _t, _t, _t, _t, f_, f_, _t, _t, f_, f_, _t, _t, _t, _t, _t, _t, f_, f_}, //  2
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, _t, _t, _t, _t, _t, _t, f_, f_}, //  3
+            {f_, f_, f_, _t, f_, _t, f_, _t, f_, f_, _t, _t, f_, f_, _t, _t, _t, _t, _t, _t, f_, f_}, //  4
+            {f_, f_, f_, _t, f_, f_, f_, _t, f_, f_, _t, _t, f_, f_, _t, _t, _t, _t, _t, _t, f_, f_}, //  5
+            {f_, f_, f_, _t, _t, _t, f_, _t, f_, f_, _t, _t, f_, f_, _t, _t, _t, _t, _t, _t, f_, f_}, //  6
+            {f_, f_, f_, _t, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, _t, _t, _t, _t, _t, _t, f_, f_}, //  7
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, _t, _t, _t, _t, _t, _t, f_, f_}, //  8
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, _t, _t, _t, _t, _t, _t, f_, f_}, //  9
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_}, // 10
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_}, // 11
+            {f_, f_, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, f_, f_, _t, _t, _t, _t, _t, _t, f_, f_}, // 12
+            {f_, f_, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, f_, _t, _t, _t, _t, _t, _t, f_, f_}, // 13
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, f_, _t, f_, f_, _t, _t, f_, f_}, // 14
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_}, // 15
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, _t, _t, f_, f_, _t, _t, f_, f_}, // 16
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, _t, _t, _t, f_, _t, _t, f_, f_}, // 17
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, f_, f_}, // 18
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 19
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 20
+            {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 21
+        };
+
+        SECTION("compares unordered")
         {
             std::vector<std::vector<bool>> expected =
             {
-                {true, true, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false},
-                {true, true, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false},
-                {false, false, true, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false},
-                {false, false, false, true, false, false, false, false, false, false, false, false, false, false, false, false, false, false},
-                {false, false, false, false, true, false, false, false, false, false, false, false, false, false, false, false, false, false},
-                {false, false, false, false, false, true, false, false, false, false, false, false, false, false, false, false, false, false},
-                {false, false, false, false, false, false, true, false, false, false, false, false, false, false, false, false, false, false},
-                {false, false, false, false, false, false, false, true, false, false, false, false, false, false, false, false, false, false},
-                {false, false, false, false, false, false, false, false, true, false, false, false, false, false, false, false, false, false},
-                {false, false, false, false, false, false, false, false, false, true, false, false, false, false, false, false, false, false},
-                {false, false, false, false, false, false, false, false, false, false, true, false, false, false, false, false, false, false},
-                {false, false, false, false, false, false, false, false, false, false, false, true, false, false, false, false, false, false},
-                {false, false, false, false, false, false, false, false, false, false, false, false, true, false, false, false, false, false},
-                {false, false, false, false, false, false, false, false, false, false, false, false, false, true, false, false, false, false},
-                {false, false, false, false, false, false, false, false, false, false, false, false, false, false, true, false, false, false},
-                {false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, true, false, false},
-                {false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, true, false},
-                {false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, true}
+                //0   1   2   3   4   5   6   7   8   9  10  11  12  13  14  15  16  17  18  19  20  21
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, //  0
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, //  1
+                {f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, //  2
+                {f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, //  3
+                {f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, //  4
+                {f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, //  5
+                {f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, //  6
+                {f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, //  7
+                {f_, f_, _t, _t, _t, _t, _t, _t, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, //  8
+                {f_, f_, _t, _t, _t, _t, _t, _t, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, //  9
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, // 10
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, // 11
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, // 12
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, // 13
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, // 14
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, // 15
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, // 16
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, // 17
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, // 18
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, _t, _t}, // 19
+                {_t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t}, // 20
+                {_t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t, _t}, // 21
             };
 
+            // check if two values compare unordered as expected
+            REQUIRE(expected.size() == j_values.size());
             for (size_t i = 0; i < j_values.size(); ++i)
             {
+                REQUIRE(expected[i].size() == j_values.size());
+                for (size_t j = 0; j < j_values.size(); ++j)
+                {
+                    CAPTURE(i)
+                    CAPTURE(j)
+                    CHECK(json::compares_unordered(j_values[i], j_values[j]) == expected[i][j]);
+                }
+            }
+        }
+
+#if JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
+        SECTION("compares unordered (inverse)")
+        {
+            std::vector<std::vector<bool>> expected =
+            {
+                //0   1   2   3   4   5   6   7   8   9  10  11  12  13  14  15  16  17  18  19  20  21
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  0
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  1
+                {f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  2
+                {f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  3
+                {f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  4
+                {f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  5
+                {f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  6
+                {f_, f_, f_, f_, f_, f_, f_, f_, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  7
+                {f_, f_, _t, _t, _t, _t, _t, _t, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  8
+                {f_, f_, _t, _t, _t, _t, _t, _t, _t, _t, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, //  9
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 10
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 11
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 12
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 13
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 14
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 15
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 16
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 17
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 18
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 19
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 20
+                {f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_, f_}, // 21
+            };
+
+            // check that two values compare unordered as expected (with legacy-mode enabled)
+            REQUIRE(expected.size() == j_values.size());
+            for (size_t i = 0; i < j_values.size(); ++i)
+            {
+                REQUIRE(expected[i].size() == j_values.size());
                 for (size_t j = 0; j < j_values.size(); ++j)
                 {
                     CAPTURE(i)
                     CAPTURE(j)
                     CAPTURE(j_values[i])
                     CAPTURE(j_values[j])
-                    // check precomputed values
-                    CHECK( (j_values[i] == j_values[j]) == expected[i][j] );
+                    CHECK(json::compares_unordered(j_values[i], j_values[j], true) == expected[i][j]);
                 }
             }
+        }
+#endif
 
-            // comparison with discarded elements
-            json j_discarded(json::value_t::discarded);
-            for (const auto& v : j_values)
+        SECTION("comparison: equal")
+        {
+            // check that two values compare equal
+            REQUIRE(expected_eq.size() == j_values.size());
+            for (size_t i = 0; i < j_values.size(); ++i)
             {
-                CHECK( (v == j_discarded) == false);
-                CHECK( (j_discarded == v) == false);
-                CHECK( (j_discarded == j_discarded) == false);
+                REQUIRE(expected_eq[i].size() == j_values.size());
+                for (size_t j = 0; j < j_values.size(); ++j)
+                {
+                    CAPTURE(i)
+                    CAPTURE(j)
+                    CHECK((j_values[i] == j_values[j]) == expected_eq[i][j]);
+                }
             }
 
             // compare with null pointer
@@ -158,121 +388,229 @@ TEST_CASE("lexicographical comparison operators")
 
         SECTION("comparison: not equal")
         {
+            // check that two values compare unequal as expected
             for (size_t i = 0; i < j_values.size(); ++i)
             {
                 for (size_t j = 0; j < j_values.size(); ++j)
                 {
                     CAPTURE(i)
                     CAPTURE(j)
-                    // check definition
-                    CHECK( (j_values[i] != j_values[j]) == !(j_values[i] == j_values[j]) );
+
+                    if (json::compares_unordered(j_values[i], j_values[j], true))
+                    {
+                        // if two values compare unordered,
+                        // check that the boolean comparison result is always false
+                        CHECK_FALSE(j_values[i] != j_values[j]);
+                    }
+                    else
+                    {
+                        // otherwise, check that they compare according to their definition
+                        // as the inverse of equal
+                        CHECK((j_values[i] != j_values[j]) == !(j_values[i] == j_values[j]));
+                    }
                 }
             }
 
             // compare with null pointer
             json j_null;
-            CHECK( (j_null != nullptr) == false);
-            CHECK( (nullptr != j_null) == false);
-            CHECK( (j_null != nullptr) == !(j_null == nullptr));
-            CHECK( (nullptr != j_null) == !(nullptr == j_null));
+            CHECK((j_null != nullptr) == false);
+            CHECK((nullptr != j_null) == false);
+            CHECK((j_null != nullptr) == !(j_null == nullptr));
+            CHECK((nullptr != j_null) == !(nullptr == j_null));
         }
 
         SECTION("comparison: less")
         {
-            std::vector<std::vector<bool>> expected =
-            {
-                {false, false, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true},
-                {false, false, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true},
-                {false, false, false, true, true, true, true, true, true, true, false, false, true, true, true, true, true, true},
-                {false, false, false, false, false, false, false, false, true, true, false, false, true, true, true, true, true, true},
-                {false, false, false, true, false, true, false, true, true, true, false, false, true, true, true, true, true, true},
-                {false, false, false, true, false, false, false, true, true, true, false, false, true, true, true, true, true, true},
-                {false, false, false, true, true, true, false, true, true, true, false, false, true, true, true, true, true, true},
-                {false, false, false, true, false, false, false, false, true, true, false, false, true, true, true, true, true, true},
-                {false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, true, true},
-                {false, false, false, false, false, false, false, false, true, false, false, false, false, false, false, false, true, true},
-                {false, false, true, true, true, true, true, true, true, true, false, false, true, true, true, true, true, true},
-                {false, false, true, true, true, true, true, true, true, true, true, false, true, true, true, true, true, true},
-                {false, false, false, false, false, false, false, false, true, true, false, false, false, true, false, false, true, true},
-                {false, false, false, false, false, false, false, false, true, true, false, false, false, false, false, false, true, true},
-                {false, false, false, false, false, false, false, false, true, true, false, false, true, true, false, false, true, true},
-                {false, false, false, false, false, false, false, false, true, true, false, false, true, true, true, false, true, true},
-                {false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, true},
-                {false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false}
-            };
-
+            // check that two values compare less than as expected
+            REQUIRE(expected_lt.size() == j_values.size());
             for (size_t i = 0; i < j_values.size(); ++i)
             {
+                REQUIRE(expected_lt[i].size() == j_values.size());
                 for (size_t j = 0; j < j_values.size(); ++j)
                 {
-                    // Skip comparing indicies 12 and 13, and 13 and 12 in C++20 pending fix
-                    // See issue #3207
-#if defined(JSON_HAS_CPP_20) || JSON_HAS_THREE_WAY_COMPARISON
-                    if ((i == 12 && j == 13) || (i == 13 && j == 12))
-                    {
-                        continue;
-                    }
-#endif
                     CAPTURE(i)
                     CAPTURE(j)
-                    CAPTURE(j_values[i])
-                    CAPTURE(j_values[j])
-                    // check precomputed values
-                    CHECK( (j_values[i] < j_values[j]) == expected[i][j] );
+                    CHECK((j_values[i] < j_values[j]) == expected_lt[i][j]);
                 }
             }
-
-            // comparison with discarded elements
-            json j_discarded(json::value_t::discarded);
-            for (size_t i = 0; i < j_values.size(); ++i)
-            {
-                CAPTURE(i)
-                CHECK( (j_values[i] < j_discarded) == false);
-                CHECK( (j_discarded < j_values[i]) == false);
-                CHECK( (j_discarded < j_discarded) == false);
-            }
         }
 
         SECTION("comparison: less than or equal equal")
         {
+            // check that two values compare less than or equal as expected
             for (size_t i = 0; i < j_values.size(); ++i)
             {
                 for (size_t j = 0; j < j_values.size(); ++j)
                 {
                     CAPTURE(i)
                     CAPTURE(j)
-                    // check definition
-                    CHECK( (j_values[i] <= j_values[j]) == !(j_values[j] < j_values[i]) );
+                    if (json::compares_unordered(j_values[i], j_values[j], true))
+                    {
+                        // if two values compare unordered,
+                        // check that the boolean comparison result is always false
+                        CHECK_FALSE(j_values[i] <= j_values[j]);
+                    }
+                    else
+                    {
+                        // otherwise, check that they compare according to their definition
+                        // as the inverse of less than with the operand order reversed
+                        CHECK((j_values[i] <= j_values[j]) == !(j_values[j] < j_values[i]));
+                    }
                 }
             }
         }
 
         SECTION("comparison: greater than")
         {
+            // check that two values compare greater than as expected
             for (size_t i = 0; i < j_values.size(); ++i)
             {
                 for (size_t j = 0; j < j_values.size(); ++j)
                 {
                     CAPTURE(i)
                     CAPTURE(j)
-                    // check definition
-                    CHECK( (j_values[i] > j_values[j]) == (j_values[j] < j_values[i]) );
+                    if (json::compares_unordered(j_values[i], j_values[j]))
+                    {
+                        // if two values compare unordered,
+                        // check that the boolean comparison result is always false
+                        CHECK_FALSE(j_values[i] > j_values[j]);
+                    }
+                    else
+                    {
+                        // otherwise, check that they compare according to their definition
+                        // as the inverse of less than or equal which is defined as
+                        // the inverse of less than with the operand order reversed
+                        CHECK((j_values[i] > j_values[j]) == !(j_values[i] <= j_values[j]));
+                        CHECK((j_values[i] > j_values[j]) == !!(j_values[j] < j_values[i]));
+                    }
                 }
             }
         }
 
         SECTION("comparison: greater than or equal")
         {
+            // check that two values compare greater than or equal as expected
             for (size_t i = 0; i < j_values.size(); ++i)
             {
                 for (size_t j = 0; j < j_values.size(); ++j)
                 {
                     CAPTURE(i)
                     CAPTURE(j)
-                    // check definition
-                    CHECK( (j_values[i] >= j_values[j]) == !(j_values[i] < j_values[j]) );
+                    if (json::compares_unordered(j_values[i], j_values[j], true))
+                    {
+                        // if two values compare unordered,
+                        // check that the boolean result is always false
+                        CHECK_FALSE(j_values[i] >= j_values[j]);
+                    }
+                    else
+                    {
+                        // otherwise, check that they compare according to their definition
+                        // as the inverse of less than
+                        CHECK((j_values[i] >= j_values[j]) == !(j_values[i] < j_values[j]));
+                    }
                 }
             }
         }
+
+#if JSON_HAS_THREE_WAY_COMPARISON
+        // JSON_HAS_CPP_20 (do not remove; see note at top of file)
+        SECTION("comparison: 3-way")
+        {
+            std::vector<std::vector<std::partial_ordering>> expected =
+            {
+                //0   1   2   3   4   5   6   7   8   9  10  11  12  13  14  15  16  17  18  19  20  21
+                {eq, eq, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, un, un}, //  0
+                {eq, eq, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, un, un}, //  1
+                {gt, gt, eq, lt, lt, lt, lt, lt, un, un, lt, lt, gt, gt, lt, lt, lt, lt, lt, lt, un, un}, //  2
+                {gt, gt, gt, eq, gt, gt, gt, gt, un, un, lt, lt, gt, gt, lt, lt, lt, lt, lt, lt, un, un}, //  3
+                {gt, gt, gt, lt, eq, lt, gt, lt, un, un, lt, lt, gt, gt, lt, lt, lt, lt, lt, lt, un, un}, //  4
+                {gt, gt, gt, lt, gt, eq, gt, lt, un, un, lt, lt, gt, gt, lt, lt, lt, lt, lt, lt, un, un}, //  5
+                {gt, gt, gt, lt, lt, lt, eq, lt, un, un, lt, lt, gt, gt, lt, lt, lt, lt, lt, lt, un, un}, //  6
+                {gt, gt, gt, lt, gt, gt, gt, eq, un, un, lt, lt, gt, gt, lt, lt, lt, lt, lt, lt, un, un}, //  7
+                {gt, gt, un, un, un, un, un, un, un, un, lt, lt, gt, gt, lt, lt, lt, lt, lt, lt, un, un}, //  8
+                {gt, gt, un, un, un, un, un, un, un, un, lt, lt, gt, gt, lt, lt, lt, lt, lt, lt, un, un}, //  9
+                {gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, eq, gt, gt, gt, gt, gt, gt, gt, lt, lt, un, un}, // 10
+                {gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, lt, eq, gt, gt, gt, gt, gt, gt, lt, lt, un, un}, // 11
+                {gt, gt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, eq, gt, lt, lt, lt, lt, lt, lt, un, un}, // 12
+                {gt, gt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, lt, eq, lt, lt, lt, lt, lt, lt, un, un}, // 13
+                {gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, lt, lt, gt, gt, eq, lt, gt, gt, lt, lt, un, un}, // 14
+                {gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, lt, lt, gt, gt, gt, eq, gt, gt, lt, lt, un, un}, // 15
+                {gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, lt, lt, gt, gt, lt, lt, eq, gt, lt, lt, un, un}, // 16
+                {gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, lt, lt, gt, gt, lt, lt, lt, eq, lt, lt, un, un}, // 17
+                {gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, eq, lt, un, un}, // 18
+                {gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, gt, eq, un, un}, // 19
+                {un, un, un, un, un, un, un, un, un, un, un, un, un, un, un, un, un, un, un, un, un, un}, // 20
+                {un, un, un, un, un, un, un, un, un, un, un, un, un, un, un, un, un, un, un, un, un, un}, // 21
+            };
+
+            // check expected partial_ordering against expected booleans
+            REQUIRE(expected.size() == expected_eq.size());
+            REQUIRE(expected.size() == expected_lt.size());
+            for (size_t i = 0; i < expected.size(); ++i)
+            {
+                REQUIRE(expected[i].size() == expected_eq[i].size());
+                REQUIRE(expected[i].size() == expected_lt[i].size());
+                for (size_t j = 0; j < expected[i].size(); ++j)
+                {
+                    CAPTURE(i)
+                    CAPTURE(j)
+                    CHECK(std::is_eq(expected[i][j]) == expected_eq[i][j]);
+                    CHECK(std::is_lt(expected[i][j]) == expected_lt[i][j]);
+                    if (std::is_gt(expected[i][j]))
+                    {
+                        CHECK((!expected_eq[i][j] && !expected_lt[i][j]));
+                    }
+                }
+            }
+
+            // check that two values compare according to their expected ordering
+            REQUIRE(expected.size() == j_values.size());
+            for (size_t i = 0; i < j_values.size(); ++i)
+            {
+                REQUIRE(expected[i].size() == j_values.size());
+                for (size_t j = 0; j < j_values.size(); ++j)
+                {
+                    CAPTURE(i)
+                    CAPTURE(j)
+                    CHECK((j_values[i] <=> j_values[j]) == expected[i][j]); // *NOPAD*
+                }
+            }
+        }
+#endif
     }
+
+#if JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
+    SECTION("parser callback regression")
+    {
+        SECTION("filter specific element")
+        {
+            const auto* s_object = R"(
+                {
+                    "foo": 2,
+                    "bar": {
+                        "baz": 1
+                    }
+                }
+            )";
+            const auto* s_array = R"(
+                [1,2,[3,4,5],4,5]
+            )";
+
+            json j_object = json::parse(s_object, [](int /*unused*/, json::parse_event_t /*unused*/, const json & j) noexcept
+            {
+                // filter all number(2) elements
+                return j != json(2);
+            });
+
+            CHECK (j_object == json({{"bar", {{"baz", 1}}}}));
+
+            json j_array = json::parse(s_array, [](int /*unused*/, json::parse_event_t /*unused*/, const json & j) noexcept
+            {
+                return j != json(2);
+            });
+
+            CHECK (j_array == json({1, {3, 4, 5}, 4, 5}));
+        }
+    }
+#endif
 }
diff --git a/tests/src/unit-conversions.cpp b/tests/src/unit-conversions.cpp
index c61b249c2..bfa9bb98f 100644
--- a/tests/src/unit-conversions.cpp
+++ b/tests/src/unit-conversions.cpp
@@ -27,6 +27,13 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE  OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 */
 
+// cmake/test.cmake selects the C++ standard versions with which to build a
+// unit test based on the presence of JSON_HAS_CPP_<VERSION> macros.
+// When using macros that are only defined for particular versions of the standard
+// (e.g., JSON_HAS_FILESYSTEM for C++17 and up), please mention the corresponding
+// version macro in a comment close by, like this:
+// JSON_HAS_CPP_<VERSION> (do not remove; see note at top of file)
+
 #include "doctest_compatibility.h"
 
 #define JSON_TESTS_PRIVATE
@@ -1582,12 +1589,4 @@ TEST_CASE("JSON to enum mapping")
     }
 }
 
-#ifdef JSON_HAS_CPP_17
-    #undef JSON_HAS_CPP_17
-#endif
-
-#ifdef JSON_HAS_CPP_14
-    #undef JSON_HAS_CPP_14
-#endif
-
 DOCTEST_CLANG_SUPPRESS_WARNING_POP
diff --git a/tests/src/unit-items.cpp b/tests/src/unit-items.cpp
index fa40f46d9..64d92b59e 100644
--- a/tests/src/unit-items.cpp
+++ b/tests/src/unit-items.cpp
@@ -80,7 +80,7 @@ TEST_CASE("iterator_wrapper")
             json j = { {"A", 1}, {"B", 2} };
             int counter = 1;
 
-            for (auto& i : json::iterator_wrapper(j))
+            for (auto& i : json::iterator_wrapper(j)) // NOLINT(readability-qualified-auto)
             {
                 switch (counter++)
                 {
@@ -226,7 +226,7 @@ TEST_CASE("iterator_wrapper")
             const json j = { {"A", 1}, {"B", 2} };
             int counter = 1;
 
-            for (auto& i : json::iterator_wrapper(j))
+            for (auto& i : json::iterator_wrapper(j)) // NOLINT(readability-qualified-auto)
             {
                 switch (counter++)
                 {
@@ -361,7 +361,7 @@ TEST_CASE("iterator_wrapper")
             json j = { "A", "B" };
             int counter = 1;
 
-            for (auto& i : json::iterator_wrapper(j))
+            for (auto& i : json::iterator_wrapper(j)) // NOLINT(readability-qualified-auto)
             {
                 switch (counter++)
                 {
@@ -507,7 +507,7 @@ TEST_CASE("iterator_wrapper")
             const json j = { "A", "B" };
             int counter = 1;
 
-            for (auto& i : json::iterator_wrapper(j))
+            for (auto& i : json::iterator_wrapper(j)) // NOLINT(readability-qualified-auto)
             {
                 switch (counter++)
                 {
@@ -624,7 +624,7 @@ TEST_CASE("iterator_wrapper")
             json j = 1;
             int counter = 1;
 
-            for (auto& i : json::iterator_wrapper(j))
+            for (auto& i : json::iterator_wrapper(j)) // NOLINT(readability-qualified-auto)
             {
                 ++counter;
                 CHECK(i.key() == "");
@@ -693,7 +693,7 @@ TEST_CASE("iterator_wrapper")
             const json j = 1;
             int counter = 1;
 
-            for (auto& i : json::iterator_wrapper(j))
+            for (auto& i : json::iterator_wrapper(j)) // NOLINT(readability-qualified-auto)
             {
                 ++counter;
                 CHECK(i.key() == "");
@@ -777,7 +777,7 @@ TEST_CASE("items()")
             json j = { {"A", 1}, {"B", 2} };
             int counter = 1;
 
-            for (auto& i : j.items())
+            for (auto& i : j.items()) // NOLINT(readability-qualified-auto)
             {
                 switch (counter++)
                 {
@@ -939,7 +939,7 @@ TEST_CASE("items()")
             const json j = { {"A", 1}, {"B", 2} };
             int counter = 1;
 
-            for (auto& i : j.items())
+            for (auto& i : j.items()) // NOLINT(readability-qualified-auto)
             {
                 switch (counter++)
                 {
@@ -1074,7 +1074,7 @@ TEST_CASE("items()")
             json j = { "A", "B" };
             int counter = 1;
 
-            for (auto& i : j.items())
+            for (auto& i : j.items()) // NOLINT(readability-qualified-auto)
             {
                 switch (counter++)
                 {
@@ -1220,7 +1220,7 @@ TEST_CASE("items()")
             const json j = { "A", "B" };
             int counter = 1;
 
-            for (auto& i : j.items())
+            for (auto& i : j.items()) // NOLINT(readability-qualified-auto)
             {
                 switch (counter++)
                 {
@@ -1337,7 +1337,7 @@ TEST_CASE("items()")
             json j = 1;
             int counter = 1;
 
-            for (auto& i : j.items())
+            for (auto& i : j.items()) // NOLINT(readability-qualified-auto)
             {
                 ++counter;
                 CHECK(i.key() == "");
@@ -1406,7 +1406,7 @@ TEST_CASE("items()")
             const json j = 1;
             int counter = 1;
 
-            for (auto& i : j.items())
+            for (auto& i : j.items()) // NOLINT(readability-qualified-auto)
             {
                 ++counter;
                 CHECK(i.key() == "");
@@ -1448,13 +1448,5 @@ TEST_CASE("items()")
     }
 }
 
-#ifdef JSON_HAS_CPP_17
-    #undef JSON_HAS_CPP_17
-#endif
-
-#ifdef JSON_HAS_CPP_14
-    #undef JSON_HAS_CPP_14
-#endif
-
 DOCTEST_GCC_SUPPRESS_WARNING_POP
 DOCTEST_CLANG_SUPPRESS_WARNING_POP
diff --git a/tests/src/unit-iterators2.cpp b/tests/src/unit-iterators2.cpp
index 976d0bcda..b9c418c16 100644
--- a/tests/src/unit-iterators2.cpp
+++ b/tests/src/unit-iterators2.cpp
@@ -27,11 +27,23 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE  OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 */
 
+// cmake/test.cmake selects the C++ standard versions with which to build a
+// unit test based on the presence of JSON_HAS_CPP_<VERSION> macros.
+// When using macros that are only defined for particular versions of the standard
+// (e.g., JSON_HAS_FILESYSTEM for C++17 and up), please mention the corresponding
+// version macro in a comment close by, like this:
+// JSON_HAS_CPP_<VERSION> (do not remove; see note at top of file)
+
 #include "doctest_compatibility.h"
 
 #include <nlohmann/json.hpp>
 using nlohmann::json;
 
+#if JSON_HAS_RANGES
+    #include <algorithm>
+    #include <ranges>
+#endif
+
 TEST_CASE("iterators 2")
 {
     SECTION("iterator comparisons")
@@ -881,4 +893,101 @@ TEST_CASE("iterators 2")
             }
         }
     }
+
+
+#if JSON_HAS_RANGES
+    // JSON_HAS_CPP_20 (do not remove; see note at top of file)
+    SECTION("ranges")
+    {
+        SECTION("concepts")
+        {
+            using nlohmann::detail::iteration_proxy_value;
+            CHECK(std::bidirectional_iterator<json::iterator>);
+            CHECK(std::input_iterator<iteration_proxy_value<json::iterator>>);
+
+            CHECK(std::is_same<json::iterator, std::ranges::iterator_t<json>>::value);
+            CHECK(std::ranges::bidirectional_range<json>);
+
+            using nlohmann::detail::iteration_proxy;
+            using items_type = decltype(std::declval<json&>().items());
+            CHECK(std::is_same<items_type, iteration_proxy<json::iterator>>::value);
+            CHECK(std::is_same<iteration_proxy_value<json::iterator>, std::ranges::iterator_t<items_type>>::value);
+            CHECK(std::ranges::input_range<items_type>);
+        }
+
+        // libstdc++ algorithms don't work with Clang 15 (04/2022)
+#if !defined(__clang__) || (defined(__clang__) && defined(__GLIBCXX__))
+        SECTION("algorithms")
+        {
+            SECTION("copy")
+            {
+                json j{"foo", "bar"};
+                auto j_copied = json::array();
+
+                std::ranges::copy(j, std::back_inserter(j_copied));
+
+                CHECK(j == j_copied);
+            }
+
+            SECTION("find_if")
+            {
+                json j{1, 3, 2, 4};
+                auto j_even = json::array();
+
+#if JSON_USE_IMPLICIT_CONVERSIONS
+                auto it = std::ranges::find_if(j, [](int v) noexcept
+                {
+                    return (v % 2) == 0;
+                });
+#else
+                auto it = std::ranges::find_if(j, [](const json & j) noexcept
+                {
+                    int v;
+                    j.get_to(v);
+                    return (v % 2) == 0;
+                });
+#endif
+
+                CHECK(*it == 2);
+            }
+        }
+#endif
+
+        // libstdc++ views don't work with Clang 15 (04/2022)
+        // libc++ hides limited ranges implementation behind guard macro
+#if !(defined(__clang__) && (defined(__GLIBCXX__) || defined(_LIBCPP_HAS_NO_INCOMPLETE_RANGES)))
+        SECTION("views")
+        {
+            SECTION("reverse")
+            {
+                json j{1, 2, 3, 4, 5};
+                json j_expected{5, 4, 3, 2, 1};
+
+                auto reversed = j | std::views::reverse;
+                CHECK(reversed == j_expected);
+            }
+
+            SECTION("transform")
+            {
+                json j
+                {
+                    { "a_key", "a_value"},
+                    { "b_key", "b_value"},
+                    { "c_key", "c_value"},
+                };
+                json j_expected{"a_key", "b_key", "c_key"};
+
+                auto transformed = j.items() | std::views::transform([](const auto & item)
+                {
+                    return item.key();
+                });
+                auto j_transformed = json::array();
+                std::ranges::copy(transformed, std::back_inserter(j_transformed));
+
+                CHECK(j_transformed == j_expected);
+            }
+        }
+#endif
+    }
+#endif
 }
diff --git a/tests/src/unit-regression2.cpp b/tests/src/unit-regression2.cpp
index 04cbac679..3ee234eee 100644
--- a/tests/src/unit-regression2.cpp
+++ b/tests/src/unit-regression2.cpp
@@ -27,6 +27,13 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE  OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 */
 
+// cmake/test.cmake selects the C++ standard versions with which to build a
+// unit test based on the presence of JSON_HAS_CPP_<VERSION> macros.
+// When using macros that are only defined for particular versions of the standard
+// (e.g., JSON_HAS_FILESYSTEM for C++17 and up), please mention the corresponding
+// version macro in a comment close by, like this:
+// JSON_HAS_CPP_<VERSION> (do not remove; see note at top of file)
+
 #include "doctest_compatibility.h"
 
 // for some reason including this after the json header leads to linker errors with VS 2017...
@@ -48,7 +55,6 @@ using ordered_json = nlohmann::ordered_json;
 #endif
 
 #if JSON_HAS_EXPERIMENTAL_FILESYSTEM
-// JSON_HAS_CPP_17 (magic keyword; do not remove)
 #include <experimental/filesystem>
 namespace nlohmann::detail
 {
@@ -788,6 +794,7 @@ TEST_CASE("regression tests 2")
     }
 
 #if JSON_HAS_FILESYSTEM || JSON_HAS_EXPERIMENTAL_FILESYSTEM
+    // JSON_HAS_CPP_17 (do not remove; see note at top of file)
     SECTION("issue #3070 - Version 3.10.3 breaks backward-compatibility with 3.10.2 ")
     {
         nlohmann::detail::std_fs::path text_path("/tmp/text.txt");

From 046927cc29e4c5ce56adb9777103755318a5e28a Mon Sep 17 00:00:00 2001
From: Qianqian Fang <fangqq@gmail.com>
Date: Fri, 3 Jun 2022 02:51:33 -0400
Subject: [PATCH 18/30] Fix nlohmann/json#3513, explain is_ndarray flag (#3514)

* Fix nlohmann/json#3513, explain is_ndarray flag

* add test for ndarray size following H
---
 .../nlohmann/detail/input/binary_reader.hpp   | 28 +++++++++++--------
 single_include/nlohmann/json.hpp              | 28 +++++++++++--------
 tests/src/unit-bjdata.cpp                     | 14 ++++++----
 3 files changed, 41 insertions(+), 29 deletions(-)

diff --git a/include/nlohmann/detail/input/binary_reader.hpp b/include/nlohmann/detail/input/binary_reader.hpp
index d259e0448..cbcb41588 100644
--- a/include/nlohmann/detail/input/binary_reader.hpp
+++ b/include/nlohmann/detail/input/binary_reader.hpp
@@ -1938,9 +1938,9 @@ class binary_reader
     {
         std::pair<std::size_t, char_int_type> size_and_type;
         size_t dimlen = 0;
-        bool inside_ndarray = true;
+        bool no_ndarray = true;
 
-        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type, inside_ndarray)))
+        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type, no_ndarray)))
         {
             return false;
         }
@@ -1953,7 +1953,7 @@ class binary_reader
                 {
                     for (std::size_t i = 0; i < size_and_type.first; ++i)
                     {
-                        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, inside_ndarray, size_and_type.second)))
+                        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, no_ndarray, size_and_type.second)))
                         {
                             return false;
                         }
@@ -1965,7 +1965,7 @@ class binary_reader
             {
                 for (std::size_t i = 0; i < size_and_type.first; ++i)
                 {
-                    if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, inside_ndarray)))
+                    if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, no_ndarray)))
                     {
                         return false;
                     }
@@ -1977,7 +1977,7 @@ class binary_reader
         {
             while (current != ']')
             {
-                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, inside_ndarray, current)))
+                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, no_ndarray, current)))
                 {
                     return false;
                 }
@@ -1990,12 +1990,16 @@ class binary_reader
 
     /*!
     @param[out] result  determined size
-    @param[in,out] inside_ndarray  whether the parser is parsing an ND array dimensional vector
+    @param[in,out] is_ndarray  for input, `true` means already inside an ndarray vector
+                               or ndarray dimension is not allowed; `false` means ndarray
+                               is allowed; for output, `true` means an ndarray is found;
+                               is_ndarray can only return `true` when its initial value
+                               is `false`
     @param[in] prefix  type marker if already read, otherwise set to 0
 
     @return whether size determination completed
     */
-    bool get_ubjson_size_value(std::size_t& result, bool& inside_ndarray, char_int_type prefix = 0)
+    bool get_ubjson_size_value(std::size_t& result, bool& is_ndarray, char_int_type prefix = 0)
     {
         if (prefix == 0)
         {
@@ -2130,9 +2134,9 @@ class binary_reader
                 {
                     break;
                 }
-                if (inside_ndarray) // ndarray dimensional vector can only contain integers, and can not embed another array
+                if (is_ndarray) // ndarray dimensional vector can only contain integers, and can not embed another array
                 {
-                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read, exception_message(input_format, "ndarray dimention vector can only contain integers", "size"), nullptr));
+                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read, exception_message(input_format, "ndarray dimentional vector is not allowed", "size"), nullptr));
                 }
                 std::vector<size_t> dim;
                 if (JSON_HEDLEY_UNLIKELY(!get_ubjson_ndarray_size(dim)))
@@ -2169,7 +2173,7 @@ class binary_reader
                             return false;
                         }
                     }
-                    inside_ndarray = true;
+                    is_ndarray = true;
                     return sax->end_array();
                 }
                 result = 0;
@@ -2650,8 +2654,8 @@ class binary_reader
     {
         // get size of following number string
         std::size_t size{};
-        bool inside_ndarray = false;
-        auto res = get_ubjson_size_value(size, inside_ndarray);
+        bool no_ndarray = true;
+        auto res = get_ubjson_size_value(size, no_ndarray);
         if (JSON_HEDLEY_UNLIKELY(!res))
         {
             return res;
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index 30386c5e8..91b31eda4 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -10528,9 +10528,9 @@ class binary_reader
     {
         std::pair<std::size_t, char_int_type> size_and_type;
         size_t dimlen = 0;
-        bool inside_ndarray = true;
+        bool no_ndarray = true;
 
-        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type, inside_ndarray)))
+        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type, no_ndarray)))
         {
             return false;
         }
@@ -10543,7 +10543,7 @@ class binary_reader
                 {
                     for (std::size_t i = 0; i < size_and_type.first; ++i)
                     {
-                        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, inside_ndarray, size_and_type.second)))
+                        if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, no_ndarray, size_and_type.second)))
                         {
                             return false;
                         }
@@ -10555,7 +10555,7 @@ class binary_reader
             {
                 for (std::size_t i = 0; i < size_and_type.first; ++i)
                 {
-                    if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, inside_ndarray)))
+                    if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, no_ndarray)))
                     {
                         return false;
                     }
@@ -10567,7 +10567,7 @@ class binary_reader
         {
             while (current != ']')
             {
-                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, inside_ndarray, current)))
+                if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, no_ndarray, current)))
                 {
                     return false;
                 }
@@ -10580,12 +10580,16 @@ class binary_reader
 
     /*!
     @param[out] result  determined size
-    @param[in,out] inside_ndarray  whether the parser is parsing an ND array dimensional vector
+    @param[in,out] is_ndarray  for input, `true` means already inside an ndarray vector
+                               or ndarray dimension is not allowed; `false` means ndarray
+                               is allowed; for output, `true` means an ndarray is found;
+                               is_ndarray can only return `true` when its initial value
+                               is `false`
     @param[in] prefix  type marker if already read, otherwise set to 0
 
     @return whether size determination completed
     */
-    bool get_ubjson_size_value(std::size_t& result, bool& inside_ndarray, char_int_type prefix = 0)
+    bool get_ubjson_size_value(std::size_t& result, bool& is_ndarray, char_int_type prefix = 0)
     {
         if (prefix == 0)
         {
@@ -10720,9 +10724,9 @@ class binary_reader
                 {
                     break;
                 }
-                if (inside_ndarray) // ndarray dimensional vector can only contain integers, and can not embed another array
+                if (is_ndarray) // ndarray dimensional vector can only contain integers, and can not embed another array
                 {
-                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read, exception_message(input_format, "ndarray dimention vector can only contain integers", "size"), nullptr));
+                    return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read, exception_message(input_format, "ndarray dimentional vector is not allowed", "size"), nullptr));
                 }
                 std::vector<size_t> dim;
                 if (JSON_HEDLEY_UNLIKELY(!get_ubjson_ndarray_size(dim)))
@@ -10759,7 +10763,7 @@ class binary_reader
                             return false;
                         }
                     }
-                    inside_ndarray = true;
+                    is_ndarray = true;
                     return sax->end_array();
                 }
                 result = 0;
@@ -11240,8 +11244,8 @@ class binary_reader
     {
         // get size of following number string
         std::size_t size{};
-        bool inside_ndarray = false;
-        auto res = get_ubjson_size_value(size, inside_ndarray);
+        bool no_ndarray = true;
+        auto res = get_ubjson_size_value(size, no_ndarray);
         if (JSON_HEDLEY_UNLIKELY(!res))
         {
             return res;
diff --git a/tests/src/unit-bjdata.cpp b/tests/src/unit-bjdata.cpp
index c93a5de51..a2ea7820f 100644
--- a/tests/src/unit-bjdata.cpp
+++ b/tests/src/unit-bjdata.cpp
@@ -2541,7 +2541,7 @@ TEST_CASE("BJData")
                 CHECK(json::from_bjdata(vI, true, false).is_discarded());
             }
 
-            SECTION("do not accept NTFZ markers in ndarray optimized type")
+            SECTION("do not accept NTFZ markers in ndarray optimized type (with count)")
             {
                 json _;
                 std::vector<uint8_t> v_N = {'[', '$', 'N', '#', '[', '#', 'i', 2, 'i', 1, 'i', 2};
@@ -2562,7 +2562,7 @@ TEST_CASE("BJData")
                 CHECK(json::from_bjdata(v_Z, true, false).is_discarded());
             }
 
-            SECTION("do not accept NTFZ markers in ndarray optimized type")
+            SECTION("do not accept NTFZ markers in ndarray optimized type (without count)")
             {
                 json _;
                 std::vector<uint8_t> v_N = {'[', '$', 'N', '#', '[', 'i', 1, 'i', 2, ']'};
@@ -2746,7 +2746,7 @@ TEST_CASE("BJData")
             CHECK(json::from_bjdata(vh, true, false).is_discarded());
 
             std::vector<uint8_t> vR = {'[', '$', 'i', '#', '[', 'i', 1, '[', ']', ']', 1};
-            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vR), "[json.exception.parse_error.113] parse error at byte 8: syntax error while parsing BJData size: ndarray dimention vector can only contain integers", json::parse_error&);
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vR), "[json.exception.parse_error.113] parse error at byte 8: syntax error while parsing BJData size: ndarray dimentional vector is not allowed", json::parse_error&);
             CHECK(json::from_bjdata(vR, true, false).is_discarded());
 
             std::vector<uint8_t> vRo = {'[', '$', 'i', '#', '[', 'i', 0, '{', '}', ']', 1};
@@ -2754,7 +2754,7 @@ TEST_CASE("BJData")
             CHECK(json::from_bjdata(vRo, true, false).is_discarded());
 
             std::vector<uint8_t> vR1 = {'[', '$', 'i', '#', '[', '[', 'i', 1, ']', ']', 1};
-            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vR1), "[json.exception.parse_error.113] parse error at byte 6: syntax error while parsing BJData size: ndarray dimention vector can only contain integers", json::parse_error&);
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vR1), "[json.exception.parse_error.113] parse error at byte 6: syntax error while parsing BJData size: ndarray dimentional vector is not allowed", json::parse_error&);
             CHECK(json::from_bjdata(vR1, true, false).is_discarded());
 
             std::vector<uint8_t> vR2 = {'[', '$', 'i', '#', '[', '#', '[', 'i', 1, ']', ']', 1};
@@ -2770,12 +2770,16 @@ TEST_CASE("BJData")
             CHECK(json::from_bjdata(vR4, true, false).is_discarded());
 
             std::vector<uint8_t> vR5 = {'[', '$', 'i', '#', '[', '[', '[', ']', ']', ']'};
-            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vR5), "[json.exception.parse_error.113] parse error at byte 6: syntax error while parsing BJData size: ndarray dimention vector can only contain integers", json::parse_error&);
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vR5), "[json.exception.parse_error.113] parse error at byte 6: syntax error while parsing BJData size: ndarray dimentional vector is not allowed", json::parse_error&);
             CHECK(json::from_bjdata(vR5, true, false).is_discarded());
 
             std::vector<uint8_t> vR6 = {'[', '$', 'i', '#', '[', '$', 'i', '#', '[', 'i', '2', 'i', 2, ']'};
             CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vR6), "[json.exception.parse_error.112] parse error at byte 14: syntax error while parsing BJData size: ndarray can not be recursive", json::parse_error&);
             CHECK(json::from_bjdata(vR6, true, false).is_discarded());
+
+            std::vector<uint8_t> vH = {'[', 'H', '[', '#', '[', '$', 'i', '#', '[', 'i', '2', 'i', 2, ']'};
+            CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vH), "[json.exception.parse_error.113] parse error at byte 3: syntax error while parsing BJData size: ndarray dimentional vector is not allowed", json::parse_error&);
+            CHECK(json::from_bjdata(vH, true, false).is_discarded());
         }
 
         SECTION("objects")

From 6058d9a8b37568a3e857966adcb970f905639a4d Mon Sep 17 00:00:00 2001
From: Niels Lohmann <mail@nlohmann.me>
Date: Fri, 3 Jun 2022 14:03:14 +0200
Subject: [PATCH 19/30] Add more macOS builders (#3485)

* :construction_worker: add more macOS builders

* :construction_worker: add more macOS builders

* :green_heart: fix macOS build

* :memo: document new Xcode versions
---
 .github/workflows/macos.yml | 21 +++++++++++++++++++--
 README.md                   |  5 +++++
 2 files changed, 24 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/macos.yml b/.github/workflows/macos.yml
index 03c652a81..28e0b74fd 100644
--- a/.github/workflows/macos.yml
+++ b/.github/workflows/macos.yml
@@ -10,7 +10,7 @@ on:
   workflow_dispatch:
 
 jobs:
-  xcode:
+  xcode_1:
     runs-on: macos-10.15
     strategy:
       matrix:
@@ -27,8 +27,25 @@ jobs:
       - name: test
         run: cd build ; ctest -j 10 --output-on-failure
 
+  xcode_2:
+    runs-on: macos-12
+    strategy:
+      matrix:
+        xcode: [13.3.1, 13.3, 13.2.1, 13.2, 13.1]
+    env:
+      DEVELOPER_DIR: /Applications/Xcode_${{ matrix.xcode }}.app/Contents/Developer
+
+    steps:
+      - uses: actions/checkout@v3
+      - name: cmake
+        run: cmake -S . -B build -D CMAKE_BUILD_TYPE=Debug -DJSON_BuildTests=On -DJSON_FastTests=ON
+      - name: build
+        run: cmake --build build --parallel 10
+      - name: test
+        run: cd build ; ctest -j 10 --output-on-failure
+
   xcode_standards:
-    runs-on: macos-10.15
+    runs-on: macos-latest
     strategy:
       matrix:
         standard: [11, 14, 17, 20]
diff --git a/README.md b/README.md
index 96beb8899..bed9b4911 100644
--- a/README.md
+++ b/README.md
@@ -1087,6 +1087,11 @@ The following compilers are currently used in continuous integration at [AppVeyo
 | Apple Clang 12.0.0 (clang-1200.0.32.27); Xcode 12.2                                                    | macOS 10.15.7      | GitHub Actions |
 | Apple Clang 12.0.0 (clang-1200.0.32.28); Xcode 12.3                                                    | macOS 10.15.7      | GitHub Actions |
 | Apple Clang 12.0.0 (clang-1200.0.32.29); Xcode 12.4                                                    | macOS 10.15.7      | GitHub Actions |
+| Apple Clang 13.0.0 (clang-1300.0.29.3); Xcode 13.1                                                     | macOS 12.3.1       | GitHub Actions |
+| Apple Clang 13.0.0 (clang-1300.0.29.30); Xcode 13.2                                                    | macOS 12.3.1       | GitHub Actions |
+| Apple Clang 13.0.0 (clang-1300.0.29.30); Xcode 13.2.1                                                  | macOS 12.3.1       | GitHub Actions |
+| Apple Clang 13.1.6 (clang-1316.0.21.2); Xcode 13.3                                                     | macOS 12.3.1       | GitHub Actions |
+| Apple Clang 13.1.6 (clang-1316.0.21.2.3); Xcode 13.3.1                                                 | macOS 12.3.1       | GitHub Actions |
 | Clang 3.5.2 (3.5.2-3ubuntu1)                                                                           | Ubuntu 20.04.3 LTS | GitHub Actions |
 | Clang 3.6.2 (3.6.2-3ubuntu2)                                                                           | Ubuntu 20.04.3 LTS | GitHub Actions |
 | Clang 3.7.1 (3.7.1-2ubuntu2)                                                                           | Ubuntu 20.04.3 LTS | GitHub Actions |

From 560cede06da882bb730a24363e5bf4eafaa484dc Mon Sep 17 00:00:00 2001
From: Florian Albrechtskirchinger <falbrechtskirchinger@gmail.com>
Date: Fri, 3 Jun 2022 20:39:24 +0200
Subject: [PATCH 20/30] CI: Remove -Wstrict-overflow (#3516)

---
 cmake/ci.cmake | 2 --
 1 file changed, 2 deletions(-)

diff --git a/cmake/ci.cmake b/cmake/ci.cmake
index ed26e02b5..a571c493b 100644
--- a/cmake/ci.cmake
+++ b/cmake/ci.cmake
@@ -343,8 +343,6 @@ set(GCC_CXXFLAGS
     -Wstrict-aliasing
     -Wstrict-aliasing=3
     -Wstrict-null-sentinel
-    -Wstrict-overflow
-    -Wstrict-overflow=5
     -Wstring-compare
     -Wstringop-overflow=4
     -Wstringop-overread

From 7a6e28acfaeb52ba322116e188cb2b7ce1603dc2 Mon Sep 17 00:00:00 2001
From: Florian Albrechtskirchinger <falbrechtskirchinger@gmail.com>
Date: Fri, 3 Jun 2022 21:05:44 +0200
Subject: [PATCH 21/30] Add assertion to converting constructor (#3517)

The converting basic_json constructor can inadvertently change the value
type of its parameter. Assert that both basic_json values are of the
same value type after conversion.
---
 include/nlohmann/json.hpp        | 1 +
 single_include/nlohmann/json.hpp | 1 +
 2 files changed, 2 insertions(+)

diff --git a/include/nlohmann/json.hpp b/include/nlohmann/json.hpp
index 7a1030c76..629a3edef 100644
--- a/include/nlohmann/json.hpp
+++ b/include/nlohmann/json.hpp
@@ -916,6 +916,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
             default:            // LCOV_EXCL_LINE
                 JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert) LCOV_EXCL_LINE
         }
+        JSON_ASSERT(m_type == val.type());
         set_parents();
         assert_invariant();
     }
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index 91b31eda4..c342172b4 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -19190,6 +19190,7 @@ class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-spec
             default:            // LCOV_EXCL_LINE
                 JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert) LCOV_EXCL_LINE
         }
+        JSON_ASSERT(m_type == val.type());
         set_parents();
         assert_invariant();
     }

From 7c65b5cdbdb15805749175fa26ce0a6644e85221 Mon Sep 17 00:00:00 2001
From: ivanovmp <ivanovmihail99@gmail.com>
Date: Mon, 6 Jun 2022 14:01:46 +0300
Subject: [PATCH 22/30] Update json.hpp (#3499)

* Update json.hpp

* Remove a space
---
 include/nlohmann/json.hpp        | 2 +-
 single_include/nlohmann/json.hpp | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/include/nlohmann/json.hpp b/include/nlohmann/json.hpp
index 629a3edef..8fb894ce7 100644
--- a/include/nlohmann/json.hpp
+++ b/include/nlohmann/json.hpp
@@ -33,7 +33,7 @@ SOFTWARE.
  * contains the most recent documentation and should also be applicable to  *
  * previous versions; documentation for deprecated functions is not         *
  * removed, but marked deprecated. See "Generate documentation" section in  *
- * file docs/README.md.                                                      *
+ * file docs/README.md.                                                     *
 \****************************************************************************/
 
 #ifndef INCLUDE_NLOHMANN_JSON_HPP_
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index c342172b4..2837e74b9 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -33,7 +33,7 @@ SOFTWARE.
  * contains the most recent documentation and should also be applicable to  *
  * previous versions; documentation for deprecated functions is not         *
  * removed, but marked deprecated. See "Generate documentation" section in  *
- * file docs/README.md.                                                      *
+ * file docs/README.md.                                                     *
 \****************************************************************************/
 
 #ifndef INCLUDE_NLOHMANN_JSON_HPP_

From b6d00d18974358ab1d55dcc3379d0ee3052deb4e Mon Sep 17 00:00:00 2001
From: Niels Lohmann <mail@nlohmann.me>
Date: Mon, 6 Jun 2022 16:46:55 +0200
Subject: [PATCH 23/30] Small documentation fixes (#3520)

---
 README.md                                 | 3 ++-
 docs/mkdocs/docs/features/json_pointer.md | 7 +++++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index bed9b4911..1f4ea0e61 100644
--- a/README.md
+++ b/README.md
@@ -1622,6 +1622,7 @@ I deeply appreciate the help of the following people.
 - [Andrea Cocito](https://github.com/puffetto) added a clarification on macro usage to the documentation.
 - [Krzysiek Karbowiak](https://github.com/kkarbowiak) refactored the tests to use `CHECK_THROWS_WITH_AS`.
 - [Chaoqi Zhang](https://github.com/prncoprs) fixed a typo.
+- [ivanovmp](https://github.com/ivanovmp) fixed a whitespace error.
 
 Thanks a lot for helping out! Please [let me know](mailto:mail@nlohmann.me) if I forgot someone.
 
@@ -1656,7 +1657,7 @@ The library itself consists of a single header file licensed under the MIT licen
 
 ## Projects using JSON for Modern C++
 
-The library is currently used in Apple macOS Sierra and iOS 10. I am not sure what they are using the library for, but I am happy that it runs on so many devices.
+The library is currently used in Apple macOS Sierra-Monterey and iOS 10-15. I am not sure what they are using the library for, but I am happy that it runs on so many devices.
 
 
 ## Notes
diff --git a/docs/mkdocs/docs/features/json_pointer.md b/docs/mkdocs/docs/features/json_pointer.md
index a7861ec7d..a3980b4c6 100644
--- a/docs/mkdocs/docs/features/json_pointer.md
+++ b/docs/mkdocs/docs/features/json_pointer.md
@@ -18,11 +18,11 @@ Consider the following JSON document
 }
 ```
 
-Then every value inside the JSON document can be idientified as follows:
+Then every value inside the JSON document can be identified as follows:
 
 | JSON Pointer      | JSON value                                                                       |
 |-------------------|----------------------------------------------------------------------------------|
-| `/`               | `#!json {"array":["A","B","C"],"nested":{"one":1,"two":2,"three":[true,false]}}` |
+| ``                | `#!json {"array":["A","B","C"],"nested":{"one":1,"two":2,"three":[true,false]}}` |
 | `/array`          | `#!json ["A","B","C"]`                                                           |
 | `/array/0`        | `#!json A`                                                                       |
 | `/array/1`        | `#!json B`                                                                       |
@@ -34,6 +34,9 @@ Then every value inside the JSON document can be idientified as follows:
 | `/nested/three/0` | `#!json true`                                                                    |
 | `/nested/three/1` | `#!json false`                                                                   |
 
+Note `/` does not identify the root (i.e., the whole document), but an object entry with empty key `""`. See
+[RFC 6901](https://tools.ietf.org/html/rfc6901) for more information.
+
 ## JSON Pointer creation
 
 JSON Pointers can be created from a string:

From 48a102c2c5ef7c2552ea291f5527a8481c98a7a7 Mon Sep 17 00:00:00 2001
From: Florian Albrechtskirchinger <falbrechtskirchinger@gmail.com>
Date: Thu, 9 Jun 2022 08:22:58 +0200
Subject: [PATCH 24/30] Fix ndarray dimension signedness, fix ndarray length
 overflow (2); add 32bit unit test (#3523)

* Fix ndarray dimension signness, fix ndarray length overflow, close #3519

* detect size overflow in ubjson and bjdata

* force reformatting

* Fix MSVC compiler warning

* Add value_in_range_of trait

* Use value_in_range_of trait

* Correct 408 parse_errors to out_of_range

* Add 32bit unit test

The test can be enabled by setting JSON_32bitTest=ON.

* Exclude unreachable lines from coverage

Certain lines are unreachable in 64bit builds.

Co-authored-by: Qianqian Fang <fangqq@gmail.com>
---
 .../nlohmann/detail/input/binary_reader.hpp   |  18 ++-
 include/nlohmann/detail/meta/type_traits.hpp  |  95 ++++++++++++++
 single_include/nlohmann/json.hpp              | 113 ++++++++++++++++-
 tests/CMakeLists.txt                          |  68 ++++++----
 tests/src/unit-32bit.cpp                      | 117 +++++++++++++++++
 tests/src/unit-bjdata.cpp                     | 120 +++++++++++++++++-
 6 files changed, 503 insertions(+), 28 deletions(-)
 create mode 100644 tests/src/unit-32bit.cpp

diff --git a/include/nlohmann/detail/input/binary_reader.hpp b/include/nlohmann/detail/input/binary_reader.hpp
index cbcb41588..9332af3e6 100644
--- a/include/nlohmann/detail/input/binary_reader.hpp
+++ b/include/nlohmann/detail/input/binary_reader.hpp
@@ -2079,6 +2079,12 @@ class binary_reader
                     return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read,
                                             exception_message(input_format, "count in an optimized container must be positive", "size"), nullptr));
                 }
+                if (!value_in_range_of<std::size_t>(number))
+                {
+                    // undo coverage exclusion once the 32bit test is run as part of CI (#3524)
+                    return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408, // LCOV_EXCL_LINE
+                                            exception_message(input_format, "integer value overflow", "size"), nullptr)); // LCOV_EXCL_LINE
+                }
                 result = static_cast<std::size_t>(number);
                 return true;
             }
@@ -2124,6 +2130,12 @@ class binary_reader
                 {
                     return false;
                 }
+                if (!value_in_range_of<std::size_t>(number))
+                {
+                    // undo coverage exclusion once the 32bit test is run as part of CI (#3524)
+                    return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408, // LCOV_EXCL_LINE
+                                            exception_message(input_format, "integer value overflow", "size"), nullptr)); // LCOV_EXCL_LINE
+                }
                 result = detail::conditional_static_cast<std::size_t>(number);
                 return true;
             }
@@ -2168,7 +2180,11 @@ class binary_reader
                     for (auto i : dim)
                     {
                         result *= i;
-                        if (JSON_HEDLEY_UNLIKELY(!sax->number_integer(static_cast<number_integer_t>(i))))
+                        if (result == 0) // because dim elements shall not have zeros, result = 0 means overflow happened
+                        {
+                            return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408, exception_message(input_format, "excessive ndarray size caused overflow", "size"), nullptr));
+                        }
+                        if (JSON_HEDLEY_UNLIKELY(!sax->number_unsigned(static_cast<number_unsigned_t>(i))))
                         {
                             return false;
                         }
diff --git a/include/nlohmann/detail/meta/type_traits.hpp b/include/nlohmann/detail/meta/type_traits.hpp
index 5e3ea3737..0901b71bb 100644
--- a/include/nlohmann/detail/meta/type_traits.hpp
+++ b/include/nlohmann/detail/meta/type_traits.hpp
@@ -577,5 +577,100 @@ T conditional_static_cast(U value)
     return value;
 }
 
+template<typename... Types>
+using all_integral = conjunction<std::is_integral<Types>...>;
+
+template<typename... Types>
+using all_signed = conjunction<std::is_signed<Types>...>;
+
+template<typename... Types>
+using all_unsigned = conjunction<std::is_unsigned<Types>...>;
+
+// there's a disjunction trait in another PR; replace when merged
+template<typename... Types>
+using same_sign = std::integral_constant < bool,
+      all_signed<Types...>::value || all_unsigned<Types...>::value >;
+
+template<typename OfType, typename T>
+using never_out_of_range = std::integral_constant < bool,
+      (std::is_signed<OfType>::value && (sizeof(T) < sizeof(OfType)))
+      || (same_sign<OfType, T>::value && sizeof(OfType) == sizeof(T)) >;
+
+template<typename OfType, typename T,
+         bool OfTypeSigned = std::is_signed<OfType>::value,
+         bool TSigned = std::is_signed<T>::value>
+struct value_in_range_of_impl2;
+
+template<typename OfType, typename T>
+struct value_in_range_of_impl2<OfType, T, false, false>
+{
+    static constexpr bool test(T val)
+    {
+        using CommonType = typename std::common_type<OfType, T>::type;
+        return static_cast<CommonType>(val) <= static_cast<CommonType>(std::numeric_limits<OfType>::max());
+    }
+};
+
+template<typename OfType, typename T>
+struct value_in_range_of_impl2<OfType, T, true, false>
+{
+    static constexpr bool test(T val)
+    {
+        using CommonType = typename std::common_type<OfType, T>::type;
+        return static_cast<CommonType>(val) <= static_cast<CommonType>(std::numeric_limits<OfType>::max());
+    }
+};
+
+template<typename OfType, typename T>
+struct value_in_range_of_impl2<OfType, T, false, true>
+{
+    static constexpr bool test(T val)
+    {
+        using CommonType = typename std::common_type<OfType, T>::type;
+        return val >= 0 && static_cast<CommonType>(val) <= static_cast<CommonType>(std::numeric_limits<OfType>::max());
+    }
+};
+
+
+template<typename OfType, typename T>
+struct value_in_range_of_impl2<OfType, T, true, true>
+{
+    static constexpr bool test(T val)
+    {
+        using CommonType = typename std::common_type<OfType, T>::type;
+        return static_cast<CommonType>(val) >= static_cast<CommonType>(std::numeric_limits<OfType>::min())
+               && static_cast<CommonType>(val) <= static_cast<CommonType>(std::numeric_limits<OfType>::max());
+    }
+};
+
+template<typename OfType, typename T,
+         bool NeverOutOfRange = never_out_of_range<OfType, T>::value,
+         typename = detail::enable_if_t<all_integral<OfType, T>::value>>
+struct value_in_range_of_impl1;
+
+template<typename OfType, typename T>
+struct value_in_range_of_impl1<OfType, T, false>
+{
+    static constexpr bool test(T val)
+    {
+        return value_in_range_of_impl2<OfType, T>::test(val);
+    }
+};
+
+template<typename OfType, typename T>
+struct value_in_range_of_impl1<OfType, T, true>
+{
+    static constexpr bool test(T /*val*/)
+    {
+        return true;
+    }
+};
+
+template<typename OfType, typename T>
+inline constexpr bool value_in_range_of(T val)
+{
+    return value_in_range_of_impl1<OfType, T>::test(val);
+}
+
 }  // namespace detail
 }  // namespace nlohmann
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index 2837e74b9..3dcd48027 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -3768,6 +3768,101 @@ T conditional_static_cast(U value)
     return value;
 }
 
+template<typename... Types>
+using all_integral = conjunction<std::is_integral<Types>...>;
+
+template<typename... Types>
+using all_signed = conjunction<std::is_signed<Types>...>;
+
+template<typename... Types>
+using all_unsigned = conjunction<std::is_unsigned<Types>...>;
+
+// there's a disjunction trait in another PR; replace when merged
+template<typename... Types>
+using same_sign = std::integral_constant < bool,
+      all_signed<Types...>::value || all_unsigned<Types...>::value >;
+
+template<typename OfType, typename T>
+using never_out_of_range = std::integral_constant < bool,
+      (std::is_signed<OfType>::value && (sizeof(T) < sizeof(OfType)))
+      || (same_sign<OfType, T>::value && sizeof(OfType) == sizeof(T)) >;
+
+template<typename OfType, typename T,
+         bool OfTypeSigned = std::is_signed<OfType>::value,
+         bool TSigned = std::is_signed<T>::value>
+struct value_in_range_of_impl2;
+
+template<typename OfType, typename T>
+struct value_in_range_of_impl2<OfType, T, false, false>
+{
+    static constexpr bool test(T val)
+    {
+        using CommonType = typename std::common_type<OfType, T>::type;
+        return static_cast<CommonType>(val) <= static_cast<CommonType>(std::numeric_limits<OfType>::max());
+    }
+};
+
+template<typename OfType, typename T>
+struct value_in_range_of_impl2<OfType, T, true, false>
+{
+    static constexpr bool test(T val)
+    {
+        using CommonType = typename std::common_type<OfType, T>::type;
+        return static_cast<CommonType>(val) <= static_cast<CommonType>(std::numeric_limits<OfType>::max());
+    }
+};
+
+template<typename OfType, typename T>
+struct value_in_range_of_impl2<OfType, T, false, true>
+{
+    static constexpr bool test(T val)
+    {
+        using CommonType = typename std::common_type<OfType, T>::type;
+        return val >= 0 && static_cast<CommonType>(val) <= static_cast<CommonType>(std::numeric_limits<OfType>::max());
+    }
+};
+
+
+template<typename OfType, typename T>
+struct value_in_range_of_impl2<OfType, T, true, true>
+{
+    static constexpr bool test(T val)
+    {
+        using CommonType = typename std::common_type<OfType, T>::type;
+        return static_cast<CommonType>(val) >= static_cast<CommonType>(std::numeric_limits<OfType>::min())
+               && static_cast<CommonType>(val) <= static_cast<CommonType>(std::numeric_limits<OfType>::max());
+    }
+};
+
+template<typename OfType, typename T,
+         bool NeverOutOfRange = never_out_of_range<OfType, T>::value,
+         typename = detail::enable_if_t<all_integral<OfType, T>::value>>
+struct value_in_range_of_impl1;
+
+template<typename OfType, typename T>
+struct value_in_range_of_impl1<OfType, T, false>
+{
+    static constexpr bool test(T val)
+    {
+        return value_in_range_of_impl2<OfType, T>::test(val);
+    }
+};
+
+template<typename OfType, typename T>
+struct value_in_range_of_impl1<OfType, T, true>
+{
+    static constexpr bool test(T /*val*/)
+    {
+        return true;
+    }
+};
+
+template<typename OfType, typename T>
+inline constexpr bool value_in_range_of(T val)
+{
+    return value_in_range_of_impl1<OfType, T>::test(val);
+}
+
 }  // namespace detail
 }  // namespace nlohmann
 
@@ -10669,6 +10764,12 @@ class binary_reader
                     return sax->parse_error(chars_read, get_token_string(), parse_error::create(113, chars_read,
                                             exception_message(input_format, "count in an optimized container must be positive", "size"), nullptr));
                 }
+                if (!value_in_range_of<std::size_t>(number))
+                {
+                    // undo coverage exclusion once the 32bit test is run as part of CI (#3524)
+                    return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408, // LCOV_EXCL_LINE
+                                            exception_message(input_format, "integer value overflow", "size"), nullptr)); // LCOV_EXCL_LINE
+                }
                 result = static_cast<std::size_t>(number);
                 return true;
             }
@@ -10714,6 +10815,12 @@ class binary_reader
                 {
                     return false;
                 }
+                if (!value_in_range_of<std::size_t>(number))
+                {
+                    // undo coverage exclusion once the 32bit test is run as part of CI (#3524)
+                    return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408, // LCOV_EXCL_LINE
+                                            exception_message(input_format, "integer value overflow", "size"), nullptr)); // LCOV_EXCL_LINE
+                }
                 result = detail::conditional_static_cast<std::size_t>(number);
                 return true;
             }
@@ -10758,7 +10865,11 @@ class binary_reader
                     for (auto i : dim)
                     {
                         result *= i;
-                        if (JSON_HEDLEY_UNLIKELY(!sax->number_integer(static_cast<number_integer_t>(i))))
+                        if (result == 0) // because dim elements shall not have zeros, result = 0 means overflow happened
+                        {
+                            return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408, exception_message(input_format, "excessive ndarray size caused overflow", "size"), nullptr));
+                        }
+                        if (JSON_HEDLEY_UNLIKELY(!sax->number_unsigned(static_cast<number_unsigned_t>(i))))
                         {
                             return false;
                         }
diff --git a/tests/CMakeLists.txt b/tests/CMakeLists.txt
index 010c4950e..ef87c4909 100644
--- a/tests/CMakeLists.txt
+++ b/tests/CMakeLists.txt
@@ -2,6 +2,7 @@ cmake_minimum_required(VERSION 3.13)
 
 option(JSON_Valgrind    "Execute test suite with Valgrind." OFF)
 option(JSON_FastTests   "Skip expensive/slow tests." OFF)
+option(JSON_32bitTest   "Enable the 32bit unit test." OFF)
 
 set(JSON_TestStandards "" CACHE STRING "The list of standards to test explicitly.")
 
@@ -33,35 +34,40 @@ endif()
 # test_main library with shared code to speed up build and common settings
 #############################################################################
 
-add_library(test_main OBJECT src/unit.cpp)
-target_compile_definitions(test_main PUBLIC
+set(test_main_SOURCES src/unit.cpp)
+set(test_main_COMPILE_DEFINITIONS PUBLIC
     DOCTEST_CONFIG_SUPER_FAST_ASSERTS
-    JSON_TEST_KEEP_MACROS
-)
-target_compile_features(test_main PRIVATE cxx_std_11)
-target_compile_options(test_main PUBLIC
-    $<$<CXX_COMPILER_ID:MSVC>:/EHsc;$<$<CONFIG:Release>:/Od>>
-    # MSVC: Force to always compile with W4
-    #       Disable warning C4566: character represented by universal-character-name '\uFF01'
-    #                              cannot be represented in the current code page (1252)
-    #       Disable warning C4996: 'nlohmann::basic_json<...>::operator <<': was declared deprecated
-    $<$<CXX_COMPILER_ID:MSVC>:/W4 /wd4566 /wd4996>
-    # https://github.com/nlohmann/json/issues/1114
-    $<$<CXX_COMPILER_ID:MSVC>:/bigobj> $<$<BOOL:${MINGW}>:-Wa,-mbig-obj>
+    JSON_TEST_KEEP_MACROS)
+set(test_main_COMPILE_FEATURES PRIVATE cxx_std_11)
+set(test_main_COMPILE_OPTIONS
+    PUBLIC
+        $<$<CXX_COMPILER_ID:MSVC>:/EHsc;$<$<CONFIG:Release>:/Od>>
+        # MSVC: Force to always compile with W4
+        #       Disable warning C4566: character represented by universal-character-name '\uFF01'
+        #                              cannot be represented in the current code page (1252)
+        #       Disable warning C4996: 'nlohmann::basic_json<...>::operator <<': was declared deprecated
+        $<$<CXX_COMPILER_ID:MSVC>:/W4 /wd4566 /wd4996>
+        # https://github.com/nlohmann/json/issues/1114
+        $<$<CXX_COMPILER_ID:MSVC>:/bigobj> $<$<BOOL:${MINGW}>:-Wa,-mbig-obj>
 
-    # https://github.com/nlohmann/json/pull/3229
-    $<$<CXX_COMPILER_ID:Intel>:-diag-disable=2196>
+        # https://github.com/nlohmann/json/pull/3229
+        $<$<CXX_COMPILER_ID:Intel>:-diag-disable=2196>
 
-    $<$<NOT:$<CXX_COMPILER_ID:MSVC>>:-Wno-deprecated;-Wno-float-equal>
-    $<$<CXX_COMPILER_ID:GNU>:-Wno-deprecated-declarations>
-    $<$<CXX_COMPILER_ID:Intel>:-diag-disable=1786>
-)
-target_include_directories(test_main PUBLIC
+        $<$<NOT:$<CXX_COMPILER_ID:MSVC>>:-Wno-deprecated;-Wno-float-equal>
+        $<$<CXX_COMPILER_ID:GNU>:-Wno-deprecated-declarations>
+        $<$<CXX_COMPILER_ID:Intel>:-diag-disable=1786>)
+set(test_main_INCLUDE_DIRECTORIES PUBLIC
     thirdparty/doctest
     thirdparty/fifo_map
-    ${PROJECT_BINARY_DIR}/include
-)
-target_link_libraries(test_main PUBLIC ${NLOHMANN_JSON_TARGET_NAME})
+    ${PROJECT_BINARY_DIR}/include)
+set(test_main_LINK_LIBRARIES PUBLIC ${NLOHMANN_JSON_TARGET_NAME})
+
+add_library(test_main OBJECT ${test_main_SOURCES})
+target_compile_definitions(test_main ${test_main_COMPILE_DEFINITIONS})
+target_compile_features(test_main ${test_main_COMPILE_FEATURES})
+target_compile_options(test_main ${test_main_COMPILE_OPTIONS})
+target_include_directories(test_main ${test_main_INCLUDE_DIRECTORIES})
+target_link_libraries(test_main ${test_main_LINK_LIBRARIES})
 
 #############################################################################
 # define test- and standard-specific build settings
@@ -119,10 +125,24 @@ message(STATUS "${msg}")
 # *DO* use json_test_set_test_options() above this line
 
 file(GLOB files src/unit-*.cpp)
+list(FILTER files EXCLUDE REGEX "src/unit-32bit.cpp")
 foreach(file ${files})
     json_test_add_test_for(${file} MAIN test_main CXX_STANDARDS ${test_cxx_standards} ${test_force})
 endforeach()
 
+if(JSON_32bitTest)
+    add_library(test_main32 OBJECT ${test_main_SOURCES})
+    target_compile_definitions(test_main32 ${test_main_COMPILE_DEFINITIONS})
+    target_compile_features(test_main32 ${test_main_COMPILE_FEATURES})
+    target_compile_options(test_main32 ${test_main_COMPILE_OPTIONS} -m32)
+    target_include_directories(test_main32 ${test_main_INCLUDE_DIRECTORIES})
+    target_link_libraries(test_main32 ${test_main_LINK_LIBRARIES})
+    target_link_options(test_main32 PUBLIC -m32)
+
+    json_test_add_test_for("src/unit-32bit.cpp" MAIN test_main32
+        CXX_STANDARDS ${test_cxx_standards} ${test_force})
+endif()
+
 # test legacy comparison of discarded values
 json_test_set_test_options(test-comparison_legacy
     COMPILE_DEFINITIONS JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON=1
diff --git a/tests/src/unit-32bit.cpp b/tests/src/unit-32bit.cpp
new file mode 100644
index 000000000..711dda5a0
--- /dev/null
+++ b/tests/src/unit-32bit.cpp
@@ -0,0 +1,117 @@
+#include "doctest_compatibility.h"
+
+#include <nlohmann/json.hpp>
+using nlohmann::json;
+
+#include <climits> // SIZE_MAX
+#include <limits> // numeric_limits
+
+
+template <typename OfType, typename T, bool MinInRange, bool MaxInRange>
+struct trait_test_arg
+{
+    using of_type = OfType;
+    using type = T;
+    static constexpr bool min_in_range = MinInRange;
+    static constexpr bool max_in_range = MaxInRange;
+};
+
+TEST_CASE_TEMPLATE_DEFINE("value_in_range_of trait", T, value_in_range_of_test)
+{
+    using nlohmann::detail::value_in_range_of;
+
+    using of_type = typename T::of_type;
+    using type = typename T::type;
+    constexpr bool min_in_range = T::min_in_range;
+    constexpr bool max_in_range = T::max_in_range;
+
+    type val_min = std::numeric_limits<type>::min();
+    type val_min2 = val_min + 1;
+    type val_max = std::numeric_limits<type>::max();
+    type val_max2 = val_max - 1;
+
+    REQUIRE(CHAR_BIT == 8);
+
+    std::string of_type_str;
+    if (std::is_unsigned<of_type>::value)
+    {
+        of_type_str += "u";
+    }
+    of_type_str += "int";
+    of_type_str += std::to_string(sizeof(of_type) * 8);
+
+    INFO("of_type := ", of_type_str);
+
+    std::string type_str;
+    if (std::is_unsigned<type>::value)
+    {
+        type_str += "u";
+    }
+    type_str += "int";
+    type_str += std::to_string(sizeof(type) * 8);
+
+    INFO("type := ", type_str);
+
+    CAPTURE(val_min);
+    CAPTURE(min_in_range);
+    CAPTURE(val_max);
+    CAPTURE(max_in_range);
+
+    if (min_in_range)
+    {
+        CHECK(value_in_range_of<of_type>(val_min));
+        CHECK(value_in_range_of<of_type>(val_min2));
+    }
+    else
+    {
+        CHECK_FALSE(value_in_range_of<of_type>(val_min));
+        CHECK_FALSE(value_in_range_of<of_type>(val_min2));
+    }
+
+    if (max_in_range)
+    {
+        CHECK(value_in_range_of<of_type>(val_max));
+        CHECK(value_in_range_of<of_type>(val_max2));
+    }
+    else
+    {
+        CHECK_FALSE(value_in_range_of<of_type>(val_max));
+        CHECK_FALSE(value_in_range_of<of_type>(val_max2));
+    }
+}
+
+
+TEST_CASE("32bit")
+{
+    REQUIRE(SIZE_MAX == 0xffffffff);
+}
+
+TEST_CASE_TEMPLATE_INVOKE(value_in_range_of_test, \
+                          trait_test_arg<std::size_t, std::int32_t, false, true>, \
+                          trait_test_arg<std::size_t, std::uint32_t, true, true>, \
+                          trait_test_arg<std::size_t, std::int64_t, false, false>, \
+                          trait_test_arg<std::size_t, std::uint64_t, true, false>);
+
+TEST_CASE("BJData")
+{
+    SECTION("parse errors")
+    {
+        SECTION("array")
+        {
+            SECTION("optimized array: no size following type")
+            {
+                std::vector<uint8_t> v = {'[', '$', 'i', 2};
+                json _;
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v), "[json.exception.parse_error.112] parse error at byte 4: syntax error while parsing BJData size: expected '#' after type information; last byte: 0x02", json::parse_error&);
+            }
+
+            SECTION("optimized array: negative size")
+            {
+                std::vector<uint8_t> vM = {'[', '$', 'M', '#', '[', 'I', 0x00, 0x20, 'M', 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x20, 0xFF, ']'};
+
+                json _;
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vM), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
+            }
+        }
+    }
+}
diff --git a/tests/src/unit-bjdata.cpp b/tests/src/unit-bjdata.cpp
index a2ea7820f..974ee3a0a 100644
--- a/tests/src/unit-bjdata.cpp
+++ b/tests/src/unit-bjdata.cpp
@@ -29,6 +29,8 @@ SOFTWARE.
 
 #include "doctest_compatibility.h"
 
+#include <climits>
+#include <limits>
 #include <nlohmann/json.hpp>
 using nlohmann::json;
 
@@ -116,6 +118,112 @@ class SaxCountdown
 };
 } // namespace
 
+// at some point in the future, a unit test dedicated to type traits might be a good idea
+template <typename OfType, typename T, bool MinInRange, bool MaxInRange>
+struct trait_test_arg
+{
+    using of_type = OfType;
+    using type = T;
+    static constexpr bool min_in_range = MinInRange;
+    static constexpr bool max_in_range = MaxInRange;
+};
+
+TEST_CASE_TEMPLATE_DEFINE("value_in_range_of trait", T, value_in_range_of_test)
+{
+    using nlohmann::detail::value_in_range_of;
+
+    using of_type = typename T::of_type;
+    using type = typename T::type;
+    constexpr bool min_in_range = T::min_in_range;
+    constexpr bool max_in_range = T::max_in_range;
+
+    type val_min = std::numeric_limits<type>::min();
+    type val_min2 = val_min + 1;
+    type val_max = std::numeric_limits<type>::max();
+    type val_max2 = val_max - 1;
+
+    REQUIRE(CHAR_BIT == 8);
+
+    std::string of_type_str;
+    if (std::is_unsigned<of_type>::value)
+    {
+        of_type_str += "u";
+    }
+    of_type_str += "int";
+    of_type_str += std::to_string(sizeof(of_type) * 8);
+
+    INFO("of_type := ", of_type_str);
+
+    std::string type_str;
+    if (std::is_unsigned<type>::value)
+    {
+        type_str += "u";
+    }
+    type_str += "int";
+    type_str += std::to_string(sizeof(type) * 8);
+
+    INFO("type := ", type_str);
+
+    CAPTURE(val_min);
+    CAPTURE(min_in_range);
+    CAPTURE(val_max);
+    CAPTURE(max_in_range);
+
+    if (min_in_range)
+    {
+        CHECK(value_in_range_of<of_type>(val_min));
+        CHECK(value_in_range_of<of_type>(val_min2));
+    }
+    else
+    {
+        CHECK_FALSE(value_in_range_of<of_type>(val_min));
+        CHECK_FALSE(value_in_range_of<of_type>(val_min2));
+    }
+
+    if (max_in_range)
+    {
+        CHECK(value_in_range_of<of_type>(val_max));
+        CHECK(value_in_range_of<of_type>(val_max2));
+    }
+    else
+    {
+        CHECK_FALSE(value_in_range_of<of_type>(val_max));
+        CHECK_FALSE(value_in_range_of<of_type>(val_max2));
+    }
+}
+
+TEST_CASE_TEMPLATE_INVOKE(value_in_range_of_test, \
+                          trait_test_arg<std::int32_t, std::int32_t, true, true>, \
+                          trait_test_arg<std::int32_t, std::uint32_t, true, false>, \
+                          trait_test_arg<std::uint32_t, std::int32_t, false, true>, \
+                          trait_test_arg<std::uint32_t, std::uint32_t, true, true>, \
+                          trait_test_arg<std::int32_t, std::int64_t, false, false>, \
+                          trait_test_arg<std::int32_t, std::uint64_t, true, false>, \
+                          trait_test_arg<std::uint32_t, std::int64_t, false, false>, \
+                          trait_test_arg<std::uint32_t, std::uint64_t, true, false>, \
+                          trait_test_arg<std::int64_t, std::int32_t, true, true>, \
+                          trait_test_arg<std::int64_t, std::uint32_t, true, true>, \
+                          trait_test_arg<std::uint64_t, std::int32_t, false, true>, \
+                          trait_test_arg<std::uint64_t, std::uint32_t, true, true>, \
+                          trait_test_arg<std::int64_t, std::int64_t, true, true>, \
+                          trait_test_arg<std::int64_t, std::uint64_t, true, false>, \
+                          trait_test_arg<std::uint64_t, std::int64_t, false, true>, \
+                          trait_test_arg<std::uint64_t, std::uint64_t, true, true>);
+
+#if SIZE_MAX == 0xffffffff
+TEST_CASE_TEMPLATE_INVOKE(value_in_range_of_test, \
+                          trait_test_arg<std::size_t, std::int32_t, false, true>, \
+                          trait_test_arg<std::size_t, std::uint32_t, true, true>, \
+                          trait_test_arg<std::size_t, std::int64_t, false, false>, \
+                          trait_test_arg<std::size_t, std::uint64_t, true, false>);
+#else
+TEST_CASE_TEMPLATE_INVOKE(value_in_range_of_test, \
+                          trait_test_arg<std::size_t, std::int32_t, false, true>, \
+                          trait_test_arg<std::size_t, std::uint32_t, true, true>, \
+                          trait_test_arg<std::size_t, std::int64_t, false, true>, \
+                          trait_test_arg<std::size_t, std::uint64_t, true, true>);
+#endif
+
 TEST_CASE("BJData")
 {
     SECTION("individual values")
@@ -2511,6 +2619,7 @@ TEST_CASE("BJData")
                 std::vector<uint8_t> vI = {'[', '#', 'I', 0x00, 0xF1};
                 std::vector<uint8_t> vl = {'[', '#', 'l', 0x00, 0x00, 0x00, 0xF2};
                 std::vector<uint8_t> vL = {'[', '#', 'L', 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xF3};
+                std::vector<uint8_t> vM = {'[', '$', 'M', '#', '[', 'I', 0x00, 0x20, 'M', 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x20, 0xFF, ']'};
 
                 json _;
                 CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v1), "[json.exception.parse_error.113] parse error at byte 4: syntax error while parsing BJData size: count in an optimized container must be positive", json::parse_error&);
@@ -2535,10 +2644,17 @@ TEST_CASE("BJData")
                 CHECK(json::from_bjdata(vI, true, false).is_discarded());
 
                 CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vl), "[json.exception.parse_error.113] parse error at byte 7: syntax error while parsing BJData size: count in an optimized container must be positive", json::parse_error&);
-                CHECK(json::from_bjdata(vI, true, false).is_discarded());
+                CHECK(json::from_bjdata(vl, true, false).is_discarded());
 
                 CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vL), "[json.exception.parse_error.113] parse error at byte 11: syntax error while parsing BJData size: count in an optimized container must be positive", json::parse_error&);
-                CHECK(json::from_bjdata(vI, true, false).is_discarded());
+                CHECK(json::from_bjdata(vL, true, false).is_discarded());
+
+#if SIZE_MAX == 0xffffffff
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vM), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
+#else
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vM), "[json.exception.out_of_range.408] syntax error while parsing BJData size: excessive ndarray size caused overflow", json::out_of_range&);
+#endif
+                CHECK(json::from_bjdata(vM, true, false).is_discarded());
             }
 
             SECTION("do not accept NTFZ markers in ndarray optimized type (with count)")

From af34396129098e5702f6b611811c43f30827b247 Mon Sep 17 00:00:00 2001
From: Niels Lohmann <mail@nlohmann.me>
Date: Sun, 12 Jun 2022 14:31:07 +0200
Subject: [PATCH 25/30] Use new CI image (#3528)

* :arrow_up: use new CI image

* :arrow_up: use new CI image

* :rotating_light: fix warning

* :wrench: remove duplicate warning flags

* :green_heart: fix test

* :memo: update compiler versions
---
 .clang-tidy                                  |  1 +
 .github/workflows/ubuntu.yml                 | 18 +++++++++---------
 README.md                                    |  7 ++++---
 cmake/ci.cmake                               | 16 ++++++++++++----
 include/nlohmann/detail/meta/type_traits.hpp |  2 +-
 single_include/nlohmann/json.hpp             |  2 +-
 6 files changed, 28 insertions(+), 18 deletions(-)

diff --git a/.clang-tidy b/.clang-tidy
index 3673930d4..b981348f3 100644
--- a/.clang-tidy
+++ b/.clang-tidy
@@ -43,6 +43,7 @@ Checks: '*,
          -readability-identifier-length,
          -readability-magic-numbers,
          -readability-redundant-access-specifiers,
+         -readability-simplify-boolean-expr
          -readability-uppercase-literal-suffix'
 
 CheckOptions:
diff --git a/.github/workflows/ubuntu.yml b/.github/workflows/ubuntu.yml
index 39098e4d7..c24332628 100644
--- a/.github/workflows/ubuntu.yml
+++ b/.github/workflows/ubuntu.yml
@@ -12,7 +12,7 @@ on:
 jobs:
   ci_test_clang:
     runs-on: ubuntu-latest
-    container: ghcr.io/nlohmann/json-ci:v2.3.0
+    container: ghcr.io/nlohmann/json-ci:v2.4.0
     steps:
       - uses: actions/checkout@v3
       - name: cmake
@@ -22,7 +22,7 @@ jobs:
 
   ci_test_gcc:
     runs-on: ubuntu-latest
-    container: ghcr.io/nlohmann/json-ci:v2.3.0
+    container: ghcr.io/nlohmann/json-ci:v2.4.0
     steps:
       - uses: actions/checkout@v3
       - name: cmake
@@ -32,7 +32,7 @@ jobs:
 
   ci_static_analysis:
     runs-on: ubuntu-latest
-    container: ghcr.io/nlohmann/json-ci:v2.3.0
+    container: ghcr.io/nlohmann/json-ci:v2.4.0
     strategy:
       matrix:
         target: [ci_clang_tidy, ci_cppcheck, ci_test_valgrind, ci_test_clang_sanitizer, ci_test_amalgamation, ci_clang_analyze, ci_cpplint, ci_cmake_flags, ci_single_binaries, ci_reproducible_tests, ci_non_git_tests, ci_offline_testdata, ci_infer]
@@ -45,7 +45,7 @@ jobs:
 
   ci_cmake_options:
     runs-on: ubuntu-latest
-    container: ghcr.io/nlohmann/json-ci:v2.3.0
+    container: ghcr.io/nlohmann/json-ci:v2.4.0
     strategy:
       matrix:
         target: [ci_test_diagnostics, ci_test_noexceptions, ci_test_noimplicitconversions, ci_test_legacycomparison]
@@ -58,7 +58,7 @@ jobs:
 
   ci_test_coverage:
     runs-on: ubuntu-latest
-    container: ghcr.io/nlohmann/json-ci:v2.3.0
+    container: ghcr.io/nlohmann/json-ci:v2.4.0
     steps:
       - uses: actions/checkout@v3
       - name: cmake
@@ -78,10 +78,10 @@ jobs:
 
   ci_test_compilers:
     runs-on: ubuntu-latest
-    container: ghcr.io/nlohmann/json-ci:v2.3.0
+    container: ghcr.io/nlohmann/json-ci:v2.4.0
     strategy:
       matrix:
-        compiler: [g++-4.8, g++-4.9, g++-5, g++-6, g++-7, g++-8, g++-9, g++-10, clang++-3.5, clang++-3.6, clang++-3.7, clang++-3.8, clang++-3.9, clang++-4.0, clang++-5.0, clang++-6.0, clang++-7, clang++-8, clang++-9, clang++-10, clang++-11, clang++-12, clang++-13, clang++-14]
+        compiler: [g++-4.8, g++-4.9, g++-5, g++-6, g++-7, g++-8, g++-9, g++-10, g++-11, clang++-3.5, clang++-3.6, clang++-3.7, clang++-3.8, clang++-3.9, clang++-4.0, clang++-5.0, clang++-6.0, clang++-7, clang++-8, clang++-9, clang++-10, clang++-11, clang++-12, clang++-13, clang++-14]
     steps:
       - uses: actions/checkout@v3
       - name: cmake
@@ -91,7 +91,7 @@ jobs:
 
   ci_test_standards:
     runs-on: ubuntu-latest
-    container: ghcr.io/nlohmann/json-ci:v2.3.0
+    container: ghcr.io/nlohmann/json-ci:v2.4.0
     strategy:
       matrix:
         standard: [11, 14, 17, 20]
@@ -105,7 +105,7 @@ jobs:
 
   ci_cuda_example:
     runs-on: ubuntu-latest
-    container: ghcr.io/nlohmann/json-ci:v2.3.0
+    container: ghcr.io/nlohmann/json-ci:v2.4.0
     steps:
       - uses: actions/checkout@v3
       - name: cmake
diff --git a/README.md b/README.md
index 1f4ea0e61..220b3a9f1 100644
--- a/README.md
+++ b/README.md
@@ -1110,8 +1110,8 @@ The following compilers are currently used in continuous integration at [AppVeyo
 | Clang 11.0.0 (11.0.0-2~ubuntu20.04.1)                                                                  | Ubuntu 20.04.3 LTS | GitHub Actions |
 | Clang 12.0.0 (12.0.0-3ubuntu1~20.04.3)                                                                 | Ubuntu 20.04.3 LTS | GitHub Actions |
 | Clang 13.0.1 (13.0.1-++20211015123032+cf15ccdeb6d5-1exp120211015003613.5)                              | Ubuntu 20.04.3 LTS | GitHub Actions |
-| Clang 14.0.0 (14.0.0-++20211221052852+55c71c9eac9b-1exp120211221172954.95)                             | Ubuntu 20.04.3 LTS | GitHub Actions |
-| Clang 15.0.0 (15.0.0-++20220403052648+896770c9a92e-1~exp1~20220403172744.209)                          | Ubuntu 20.04.3 LTS | GitHub Actions |
+| Clang 14.0.5-++20220603124341+2f0a69c32a4c-1~exp1~20220603124352.149                                   | Ubuntu 20.04.3 LTS | GitHub Actions |
+| Clang 15.0.0 (15.0.0-++20220530052901+b7d2b160c3ba-1~exp1~20220530172952.268)                          | Ubuntu 20.04.3 LTS | GitHub Actions |
 | GCC 4.8.5 (Ubuntu 4.8.5-4ubuntu2)                                                                      | Ubuntu 20.04.3 LTS | GitHub Actions |
 | GCC 4.9.3 (Ubuntu 4.9.3-13ubuntu2)                                                                     | Ubuntu 20.04.3 LTS | GitHub Actions |
 | GCC 5.4.0 (Ubuntu 5.4.0-6ubuntu1~16.04.12)                                                             | Ubuntu 20.04.3 LTS | GitHub Actions |
@@ -1123,7 +1123,8 @@ The following compilers are currently used in continuous integration at [AppVeyo
 | GCC 9.3.0 (Ubuntu 9.3.0-17ubuntu1~20.04)                                                               | Ubuntu 20.04.3 LTS | GitHub Actions |
 | GCC 10.2.0 (Ubuntu 10.2.0-5ubuntu1~20.04)                                                              | Ubuntu 20.04.3 LTS | GitHub Actions |
 | GCC 11.1.0                                                                                             | Ubuntu (aarch64)   | Drone CI       |
-| GCC 12.0.0 20211219 (experimental)                                                                     | Ubuntu 20.04.3 LTS | GitHub Actions |
+| GCC 11.1.0 (Ubuntu 11.1.0-1ubuntu1~20.04)                                                              | Ubuntu 20.04.3 LTS | GitHub Actions |
+| GCC 13.0.0 13.0.0 20220605 (experimental)                                                              | Ubuntu 20.04.3 LTS | GitHub Actions |
 | Intel C++ Compiler 2021.5.0.20211109                                                                   | Ubuntu 20.04.3 LTS | GitHub Actions |
 | NVCC 11.0.221                                                                                          | Ubuntu 20.04.3 LTS | GitHub Actions |
 | Visual Studio 14 2015 MSVC 19.0.24241.7 (Build Engine version 14.0.25420.1)                            | Windows-6.3.9600   | AppVeyor       |
diff --git a/cmake/ci.cmake b/cmake/ci.cmake
index a571c493b..d813a1773 100644
--- a/cmake/ci.cmake
+++ b/cmake/ci.cmake
@@ -111,7 +111,7 @@ set(CLANG_CXXFLAGS
     -Wno-reserved-identifier
 )
 
-# Warning flags determined for GCC 12.0 (experimental) with https://github.com/nlohmann/gcc_flags:
+# Warning flags determined for GCC 13.0 (experimental) with https://github.com/nlohmann/gcc_flags:
 # Ignored GCC warnings:
 # -Wno-abi-tag                    We do not care about ABI tags.
 # -Wno-aggregate-return           The library uses aggregate returns.
@@ -161,10 +161,13 @@ set(GCC_CXXFLAGS
     -Wanalyzer-use-after-free
     -Wanalyzer-use-of-pointer-in-stale-stack-frame
     -Wanalyzer-use-of-uninitialized-value
+    -Wanalyzer-va-arg-type-mismatch
+    -Wanalyzer-va-list-exhausted
+    -Wanalyzer-va-list-leak
+    -Wanalyzer-va-list-use-after-va-end
     -Wanalyzer-write-to-const
     -Wanalyzer-write-to-string-literal
     -Warith-conversion
-    -Warray-bounds
     -Warray-bounds=2
     -Warray-compare
     -Warray-parameter=2
@@ -209,6 +212,7 @@ set(GCC_CXXFLAGS
     -Wctad-maybe-unsupported
     -Wctor-dtor-privacy
     -Wdangling-else
+    -Wdangling-pointer=2
     -Wdate-time
     -Wdelete-incomplete
     -Wdelete-non-virtual-dtor
@@ -279,6 +283,7 @@ set(GCC_CXXFLAGS
     -Wmissing-include-dirs
     -Wmissing-profile
     -Wmissing-requires
+    -Wmissing-template-keyword
     -Wmultichar
     -Wmultiple-inheritance
     -Wmultistatement-macros
@@ -340,9 +345,9 @@ set(GCC_CXXFLAGS
     -Wsizeof-pointer-div
     -Wsizeof-pointer-memaccess
     -Wstack-protector
-    -Wstrict-aliasing
     -Wstrict-aliasing=3
     -Wstrict-null-sentinel
+    -Wno-strict-overflow
     -Wstring-compare
     -Wstringop-overflow=4
     -Wstringop-overread
@@ -371,6 +376,7 @@ set(GCC_CXXFLAGS
     -Wterminate
     -Wtrampolines
     -Wtrigraphs
+    -Wtrivial-auto-var-init
     -Wtsan
     -Wtype-limits
     -Wundef
@@ -390,6 +396,7 @@ set(GCC_CXXFLAGS
     -Wunused-result
     -Wunused-value
     -Wunused-variable
+    -Wuse-after-free=3
     -Wuseless-cast
     -Wvarargs
     -Wvariadic-macros
@@ -710,6 +717,7 @@ add_custom_target(ci_offline_testdata
 ###############################################################################
 
 add_custom_target(ci_non_git_tests
+    COMMAND git config --global --add safe.directory ${PROJECT_SOURCE_DIR}
     COMMAND mkdir -p ${PROJECT_BINARY_DIR}/build_non_git_tests/sources
     COMMAND cd ${PROJECT_SOURCE_DIR} && for FILE in `${GIT_TOOL} ls-tree --name-only HEAD`\; do cp -r $$FILE ${PROJECT_BINARY_DIR}/build_non_git_tests/sources \; done
     COMMAND ${CMAKE_COMMAND}
@@ -854,7 +862,7 @@ add_custom_target(ci_cmake_flags
 # Use more installed compilers.
 ###############################################################################
 
-foreach(COMPILER g++-4.8 g++-4.9 g++-5 g++-6 g++-7 g++-8 g++-9 g++-10 clang++-3.5 clang++-3.6 clang++-3.7 clang++-3.8 clang++-3.9 clang++-4.0 clang++-5.0 clang++-6.0 clang++-7 clang++-8 clang++-9 clang++-10 clang++-11 clang++-12 clang++-13 clang++-14)
+foreach(COMPILER g++-4.8 g++-4.9 g++-5 g++-6 g++-7 g++-8 g++-9 g++-10 g++-11 clang++-3.5 clang++-3.6 clang++-3.7 clang++-3.8 clang++-3.9 clang++-4.0 clang++-5.0 clang++-6.0 clang++-7 clang++-8 clang++-9 clang++-10 clang++-11 clang++-12 clang++-13 clang++-14)
     find_program(COMPILER_TOOL NAMES ${COMPILER})
     if (COMPILER_TOOL)
         if ("${COMPILER}" STREQUAL "clang++-9")
diff --git a/include/nlohmann/detail/meta/type_traits.hpp b/include/nlohmann/detail/meta/type_traits.hpp
index 0901b71bb..cc3483122 100644
--- a/include/nlohmann/detail/meta/type_traits.hpp
+++ b/include/nlohmann/detail/meta/type_traits.hpp
@@ -183,7 +183,7 @@ template<class...> struct conjunction : std::true_type { };
 template<class B> struct conjunction<B> : B { };
 template<class B, class... Bn>
 struct conjunction<B, Bn...>
-: std::conditional<bool(B::value), conjunction<Bn...>, B>::type {};
+: std::conditional<static_cast<bool>(B::value), conjunction<Bn...>, B>::type {};
 
 // https://en.cppreference.com/w/cpp/types/negation
 template<class B> struct negation : std::integral_constant < bool, !B::value > { };
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index 3dcd48027..c5fd3fd0b 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -3374,7 +3374,7 @@ template<class...> struct conjunction : std::true_type { };
 template<class B> struct conjunction<B> : B { };
 template<class B, class... Bn>
 struct conjunction<B, Bn...>
-: std::conditional<bool(B::value), conjunction<Bn...>, B>::type {};
+: std::conditional<static_cast<bool>(B::value), conjunction<Bn...>, B>::type {};
 
 // https://en.cppreference.com/w/cpp/types/negation
 template<class B> struct negation : std::integral_constant < bool, !B::value > { };

From 9c31d543890ce0b1b5fe5a4bb07465a289cc60ec Mon Sep 17 00:00:00 2001
From: Florian Albrechtskirchinger <falbrechtskirchinger@gmail.com>
Date: Mon, 13 Jun 2022 13:21:55 +0200
Subject: [PATCH 26/30] Add to_json() for std::vector<bool>::reference (#3534)

---
 include/nlohmann/detail/conversions/to_json.hpp | 7 +++++++
 single_include/nlohmann/json.hpp                | 7 +++++++
 tests/src/unit-constructor1.cpp                 | 7 +++++++
 3 files changed, 21 insertions(+)

diff --git a/include/nlohmann/detail/conversions/to_json.hpp b/include/nlohmann/detail/conversions/to_json.hpp
index fde46ef7c..b59077338 100644
--- a/include/nlohmann/detail/conversions/to_json.hpp
+++ b/include/nlohmann/detail/conversions/to_json.hpp
@@ -272,6 +272,13 @@ inline void to_json(BasicJsonType& j, T b) noexcept
     external_constructor<value_t::boolean>::construct(j, b);
 }
 
+template<typename BasicJsonType,
+         enable_if_t<std::is_convertible<const std::vector<bool>::reference&, typename BasicJsonType::boolean_t>::value, int> = 0>
+inline void to_json(BasicJsonType& j, const std::vector<bool>::reference& b) noexcept
+{
+    external_constructor<value_t::boolean>::construct(j, static_cast<typename BasicJsonType::boolean_t>(b));
+}
+
 template<typename BasicJsonType, typename CompatibleString,
          enable_if_t<std::is_constructible<typename BasicJsonType::string_t, CompatibleString>::value, int> = 0>
 inline void to_json(BasicJsonType& j, const CompatibleString& s)
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index c5fd3fd0b..4a73ce5d3 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -5253,6 +5253,13 @@ inline void to_json(BasicJsonType& j, T b) noexcept
     external_constructor<value_t::boolean>::construct(j, b);
 }
 
+template<typename BasicJsonType,
+         enable_if_t<std::is_convertible<const std::vector<bool>::reference&, typename BasicJsonType::boolean_t>::value, int> = 0>
+inline void to_json(BasicJsonType& j, const std::vector<bool>::reference& b) noexcept
+{
+    external_constructor<value_t::boolean>::construct(j, static_cast<typename BasicJsonType::boolean_t>(b));
+}
+
 template<typename BasicJsonType, typename CompatibleString,
          enable_if_t<std::is_constructible<typename BasicJsonType::string_t, CompatibleString>::value, int> = 0>
 inline void to_json(BasicJsonType& j, const CompatibleString& s)
diff --git a/tests/src/unit-constructor1.cpp b/tests/src/unit-constructor1.cpp
index 195521226..21f21e380 100644
--- a/tests/src/unit-constructor1.cpp
+++ b/tests/src/unit-constructor1.cpp
@@ -474,6 +474,13 @@ TEST_CASE("constructors")
             json j(false);
             CHECK(j.type() == json::value_t::boolean);
         }
+
+        SECTION("from std::vector<bool>::refrence")
+        {
+            std::vector<bool> v{true};
+            json j(v[0]);
+            CHECK(j.type() == json::value_t::boolean);
+        }
     }
 
     SECTION("create a binary (explicit)")

From e80945da2cecab8ed1b6a35c4784614801222d58 Mon Sep 17 00:00:00 2001
From: Florian Albrechtskirchinger <falbrechtskirchinger@gmail.com>
Date: Tue, 14 Jun 2022 08:54:12 +0200
Subject: [PATCH 27/30] CI: Enable 32bit unit test (3) (#3532)

* Enable JSON_MultipleHeaders by default

* CI: Add single-header build

* CI: Enable 32bit unit test

* Fix "-Wuseless-cast" warnings

* Remove coverage exclusion

* Fix 32bit test case
---
 .github/workflows/ubuntu.yml                  | 10 +++
 CMakeLists.txt                                |  2 +-
 cmake/ci.cmake                                | 39 ++++++++---
 cmake/test.cmake                              | 29 ++++++++
 .../nlohmann/detail/input/binary_reader.hpp   | 33 +++++----
 single_include/nlohmann/json.hpp              | 33 +++++----
 tests/CMakeLists.txt                          | 70 ++++++++-----------
 tests/src/unit-32bit.cpp                      | 12 ++--
 tests/src/unit-bjdata.cpp                     | 19 ++++-
 9 files changed, 152 insertions(+), 95 deletions(-)

diff --git a/.github/workflows/ubuntu.yml b/.github/workflows/ubuntu.yml
index c24332628..440710427 100644
--- a/.github/workflows/ubuntu.yml
+++ b/.github/workflows/ubuntu.yml
@@ -43,6 +43,16 @@ jobs:
       - name: build
         run: cmake --build build --target ${{ matrix.target }}
 
+  ci_test_single_header:
+    runs-on: ubuntu-latest
+    container: ghcr.io/nlohmann/json-ci:v2.4.0
+    steps:
+      - uses: actions/checkout@v3
+      - name: cmake
+        run: cmake -S . -B build -DJSON_CI=On
+      - name: build
+        run: cmake --build build --target ci_test_single_header
+
   ci_cmake_options:
     runs-on: ubuntu-latest
     container: ghcr.io/nlohmann/json-ci:v2.4.0
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 632e6dec2..aae5fb6e3 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -43,7 +43,7 @@ option(JSON_Diagnostics                    "Use extended diagnostic messages." O
 option(JSON_ImplicitConversions            "Enable implicit conversions." ON)
 option(JSON_LegacyDiscardedValueComparison "Enable legacy discarded value comparison." OFF)           
 option(JSON_Install                        "Install CMake targets during install step." ${MAIN_PROJECT})
-option(JSON_MultipleHeaders                "Use non-amalgamated version of the library." OFF)
+option(JSON_MultipleHeaders                "Use non-amalgamated version of the library." ON)
 option(JSON_SystemInclude                  "Include as system headers (skip for clang-tidy)." OFF)
 
 if (JSON_CI)
diff --git a/cmake/ci.cmake b/cmake/ci.cmake
index d813a1773..8704d4a54 100644
--- a/cmake/ci.cmake
+++ b/cmake/ci.cmake
@@ -416,7 +416,7 @@ set(GCC_CXXFLAGS
 add_custom_target(ci_test_gcc
     COMMAND CXX=${GCC_TOOL} CXXFLAGS="${GCC_CXXFLAGS}" ${CMAKE_COMMAND}
         -DCMAKE_BUILD_TYPE=Debug -GNinja
-        -DJSON_BuildTests=ON -DJSON_MultipleHeaders=ON
+        -DJSON_BuildTests=ON
         -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_gcc
     COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_gcc
     COMMAND cd ${PROJECT_BINARY_DIR}/build_gcc && ${CMAKE_CTEST_COMMAND} --parallel ${N} --output-on-failure
@@ -426,7 +426,7 @@ add_custom_target(ci_test_gcc
 add_custom_target(ci_test_clang
     COMMAND CXX=${CLANG_TOOL} CXXFLAGS="${CLANG_CXXFLAGS}" ${CMAKE_COMMAND}
         -DCMAKE_BUILD_TYPE=Debug -GNinja
-        -DJSON_BuildTests=ON -DJSON_MultipleHeaders=ON
+        -DJSON_BuildTests=ON
         -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_clang
     COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_clang
     COMMAND cd ${PROJECT_BINARY_DIR}/build_clang && ${CMAKE_CTEST_COMMAND} --parallel ${N} --output-on-failure
@@ -468,7 +468,7 @@ endforeach()
 add_custom_target(ci_test_noexceptions
     COMMAND CXX=${CLANG_TOOL} ${CMAKE_COMMAND}
     -DCMAKE_BUILD_TYPE=Debug -GNinja
-    -DJSON_BuildTests=ON -DJSON_MultipleHeaders=ON -DCMAKE_CXX_FLAGS=-DJSON_NOEXCEPTION -DDOCTEST_TEST_FILTER=--no-throw
+    -DJSON_BuildTests=ON -DCMAKE_CXX_FLAGS=-DJSON_NOEXCEPTION -DDOCTEST_TEST_FILTER=--no-throw
     -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_noexceptions
     COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_noexceptions
     COMMAND cd ${PROJECT_BINARY_DIR}/build_noexceptions && ${CMAKE_CTEST_COMMAND} --parallel ${N} --output-on-failure
@@ -482,7 +482,7 @@ add_custom_target(ci_test_noexceptions
 add_custom_target(ci_test_noimplicitconversions
     COMMAND CXX=${CLANG_TOOL} ${CMAKE_COMMAND}
     -DCMAKE_BUILD_TYPE=Debug -GNinja
-    -DJSON_BuildTests=ON -DJSON_MultipleHeaders=ON -DJSON_ImplicitConversions=OFF
+    -DJSON_BuildTests=ON -DJSON_ImplicitConversions=OFF
     -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_noimplicitconversions
     COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_noimplicitconversions
     COMMAND cd ${PROJECT_BINARY_DIR}/build_noimplicitconversions && ${CMAKE_CTEST_COMMAND} --parallel ${N} --output-on-failure
@@ -496,7 +496,7 @@ add_custom_target(ci_test_noimplicitconversions
 add_custom_target(ci_test_diagnostics
     COMMAND CXX=${CLANG_TOOL} ${CMAKE_COMMAND}
     -DCMAKE_BUILD_TYPE=Debug -GNinja
-    -DJSON_BuildTests=ON -DJSON_MultipleHeaders=ON -DJSON_Diagnostics=ON
+    -DJSON_BuildTests=ON -DJSON_Diagnostics=ON
     -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_diagnostics
     COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_diagnostics
     COMMAND cd ${PROJECT_BINARY_DIR}/build_diagnostics && ${CMAKE_CTEST_COMMAND} --parallel ${N} --output-on-failure
@@ -510,7 +510,7 @@ add_custom_target(ci_test_diagnostics
 add_custom_target(ci_test_legacycomparison
     COMMAND CXX=${CLANG_TOOL} ${CMAKE_COMMAND}
     -DCMAKE_BUILD_TYPE=Debug -GNinja
-    -DJSON_BuildTests=ON -DJSON_MultipleHeaders=ON -DJSON_LegacyDiscardedValueComparison=ON
+    -DJSON_BuildTests=ON -DJSON_LegacyDiscardedValueComparison=ON
     -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_legacycomparison
     COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_legacycomparison
     COMMAND cd ${PROJECT_BINARY_DIR}/build_legacycomparison && ${CMAKE_CTEST_COMMAND} --parallel ${N} --output-on-failure
@@ -524,11 +524,18 @@ add_custom_target(ci_test_legacycomparison
 add_custom_target(ci_test_coverage
     COMMAND CXX=g++ ${CMAKE_COMMAND}
         -DCMAKE_BUILD_TYPE=Debug -GNinja -DCMAKE_CXX_FLAGS="--coverage;-fprofile-arcs;-ftest-coverage"
-        -DJSON_BuildTests=ON -DJSON_MultipleHeaders=ON
+        -DJSON_BuildTests=ON
         -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_coverage
     COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_coverage
     COMMAND cd ${PROJECT_BINARY_DIR}/build_coverage && ${CMAKE_CTEST_COMMAND} --parallel ${N} --output-on-failure
 
+    COMMAND CXX=g++ ${CMAKE_COMMAND}
+        -DCMAKE_BUILD_TYPE=Debug -GNinja -DCMAKE_CXX_FLAGS="-m32;--coverage;-fprofile-arcs;-ftest-coverage"
+        -DJSON_BuildTests=ON -DJSON_32bitTest=ONLY
+        -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_coverage32
+    COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_coverage32
+    COMMAND cd ${PROJECT_BINARY_DIR}/build_coverage32 && ${CMAKE_CTEST_COMMAND} --parallel ${N} --output-on-failure
+
     COMMAND ${LCOV_TOOL} --directory . --capture --output-file json.info --rc lcov_branch_coverage=1
     COMMAND ${LCOV_TOOL} -e json.info ${SRC_FILES} --output-file json.info.filtered --rc lcov_branch_coverage=1
     COMMAND ${CMAKE_SOURCE_DIR}/tests/thirdparty/imapdl/filterbr.py json.info.filtered > json.info.filtered.noexcept
@@ -581,6 +588,20 @@ add_custom_target(ci_test_amalgamation
     COMMENT "Check amalgamation and indentation"
 )
 
+###############################################################################
+# Build and test using the amalgamated header
+###############################################################################
+
+add_custom_target(ci_test_single_header
+    COMMAND CXX=${GCC_TOOL} CXXFLAGS="${GCC_CXXFLAGS}" ${CMAKE_COMMAND}
+        -DCMAKE_BUILD_TYPE=Debug -GNinja
+        -DJSON_BuildTests=ON -DJSON_MultipleHeader=OFF -DJSON_FastTests=ON
+        -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_single_header
+    COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_single_header
+    COMMAND cd ${PROJECT_BINARY_DIR}/build_single_header && ${CMAKE_CTEST_COMMAND} --parallel ${N} --output-on-failure
+    COMMENT "Compile and test single-header version"
+)
+
 ###############################################################################
 # Valgrind.
 ###############################################################################
@@ -664,7 +685,7 @@ add_custom_target(ci_clang_tidy
     COMMAND CXX=${CLANG_TOOL} ${CMAKE_COMMAND}
         -DCMAKE_BUILD_TYPE=Debug -GNinja
         -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -DCMAKE_CXX_CLANG_TIDY=${CLANG_TIDY_TOOL}
-        -DJSON_BuildTests=ON -DJSON_MultipleHeaders=ON
+        -DJSON_BuildTests=ON
         -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_clang_tidy
     COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_clang_tidy
     COMMENT "Check code with Clang-Tidy"
@@ -691,7 +712,7 @@ add_custom_target(ci_pvs_studio
 
 add_custom_target(ci_infer
     COMMAND mkdir -p ${PROJECT_BINARY_DIR}/build_infer
-    COMMAND cd ${PROJECT_BINARY_DIR}/build_infer && ${INFER_TOOL} compile -- ${CMAKE_COMMAND} -DCMAKE_BUILD_TYPE=Debug ${PROJECT_SOURCE_DIR} -DJSON_BuildTests=ON -DJSON_MultipleHeaders=ON
+    COMMAND cd ${PROJECT_BINARY_DIR}/build_infer && ${INFER_TOOL} compile -- ${CMAKE_COMMAND} -DCMAKE_BUILD_TYPE=Debug ${PROJECT_SOURCE_DIR} -DJSON_BuildTests=ON
     COMMAND cd ${PROJECT_BINARY_DIR}/build_infer && ${INFER_TOOL} run -- make
     COMMENT "Check code with Infer"
 )
diff --git a/cmake/test.cmake b/cmake/test.cmake
index 89b7c6ec7..b8b1250fb 100644
--- a/cmake/test.cmake
+++ b/cmake/test.cmake
@@ -211,3 +211,32 @@ function(json_test_add_test_for file)
         _json_test_add_test(${test_name} ${file} ${args_MAIN} ${cxx_standard})
     endforeach()
 endfunction()
+
+#############################################################################
+# json_test_should_build_32bit_test(
+#     <build_32bit_var> <build_32bit_only_var> <input>)
+#
+# Check if the 32bit unit test should be built based on the value of <input>
+# and store the result in the variables <build_32bit_var> and
+# <build_32bit_only_var>.
+#############################################################################
+
+function(json_test_should_build_32bit_test build_32bit_var build_32bit_only_var input)
+    set(${build_32bit_only_var} OFF PARENT_SCOPE)
+    string(TOUPPER "${input}" ${build_32bit_var})
+    if("${${build_32bit_var}}" STREQUAL AUTO)
+        # check if compiler is targeting 32bit by default
+        include(CheckTypeSize)
+        check_type_size("size_t" sizeof_size_t LANGUAGE CXX)
+        if(sizeof_size_t AND ${sizeof_size_t} EQUAL 4)
+            message(STATUS "Auto-enabling 32bit unit test.")
+            set(${build_32bit_var} ON)
+        else()
+            set(${build_32bit_var} OFF)
+        endif()
+    elseif("${${build_32bit_var}}" STREQUAL ONLY)
+        set(${build_32bit_only_var} ON PARENT_SCOPE)
+    endif()
+
+    set(${build_32bit_var} "${${build_32bit_var}}" PARENT_SCOPE)
+endfunction()
diff --git a/include/nlohmann/detail/input/binary_reader.hpp b/include/nlohmann/detail/input/binary_reader.hpp
index 9332af3e6..f5871ddf6 100644
--- a/include/nlohmann/detail/input/binary_reader.hpp
+++ b/include/nlohmann/detail/input/binary_reader.hpp
@@ -618,7 +618,8 @@ class binary_reader
             case 0x95:
             case 0x96:
             case 0x97:
-                return get_cbor_array(static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x1Fu), tag_handler);
+                return get_cbor_array(
+                           conditional_static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x1Fu), tag_handler);
 
             case 0x98: // array (one-byte uint8_t for n follows)
             {
@@ -635,13 +636,13 @@ class binary_reader
             case 0x9A: // array (four-byte uint32_t for n follow)
             {
                 std::uint32_t len{};
-                return get_number(input_format_t::cbor, len) && get_cbor_array(static_cast<std::size_t>(len), tag_handler);
+                return get_number(input_format_t::cbor, len) && get_cbor_array(conditional_static_cast<std::size_t>(len), tag_handler);
             }
 
             case 0x9B: // array (eight-byte uint64_t for n follow)
             {
                 std::uint64_t len{};
-                return get_number(input_format_t::cbor, len) && get_cbor_array(detail::conditional_static_cast<std::size_t>(len), tag_handler);
+                return get_number(input_format_t::cbor, len) && get_cbor_array(conditional_static_cast<std::size_t>(len), tag_handler);
             }
 
             case 0x9F: // array (indefinite length)
@@ -672,7 +673,7 @@ class binary_reader
             case 0xB5:
             case 0xB6:
             case 0xB7:
-                return get_cbor_object(static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x1Fu), tag_handler);
+                return get_cbor_object(conditional_static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x1Fu), tag_handler);
 
             case 0xB8: // map (one-byte uint8_t for n follows)
             {
@@ -689,13 +690,13 @@ class binary_reader
             case 0xBA: // map (four-byte uint32_t for n follow)
             {
                 std::uint32_t len{};
-                return get_number(input_format_t::cbor, len) && get_cbor_object(static_cast<std::size_t>(len), tag_handler);
+                return get_number(input_format_t::cbor, len) && get_cbor_object(conditional_static_cast<std::size_t>(len), tag_handler);
             }
 
             case 0xBB: // map (eight-byte uint64_t for n follow)
             {
                 std::uint64_t len{};
-                return get_number(input_format_t::cbor, len) && get_cbor_object(detail::conditional_static_cast<std::size_t>(len), tag_handler);
+                return get_number(input_format_t::cbor, len) && get_cbor_object(conditional_static_cast<std::size_t>(len), tag_handler);
             }
 
             case 0xBF: // map (indefinite length)
@@ -1342,7 +1343,7 @@ class binary_reader
             case 0x8D:
             case 0x8E:
             case 0x8F:
-                return get_msgpack_object(static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x0Fu));
+                return get_msgpack_object(conditional_static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x0Fu));
 
             // fixarray
             case 0x90:
@@ -1361,7 +1362,7 @@ class binary_reader
             case 0x9D:
             case 0x9E:
             case 0x9F:
-                return get_msgpack_array(static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x0Fu));
+                return get_msgpack_array(conditional_static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x0Fu));
 
             // fixstr
             case 0xA0:
@@ -1498,7 +1499,7 @@ class binary_reader
             case 0xDD: // array 32
             {
                 std::uint32_t len{};
-                return get_number(input_format_t::msgpack, len) && get_msgpack_array(static_cast<std::size_t>(len));
+                return get_number(input_format_t::msgpack, len) && get_msgpack_array(conditional_static_cast<std::size_t>(len));
             }
 
             case 0xDE: // map 16
@@ -1510,7 +1511,7 @@ class binary_reader
             case 0xDF: // map 32
             {
                 std::uint32_t len{};
-                return get_number(input_format_t::msgpack, len) && get_msgpack_object(static_cast<std::size_t>(len));
+                return get_number(input_format_t::msgpack, len) && get_msgpack_object(conditional_static_cast<std::size_t>(len));
             }
 
             // negative fixint
@@ -2081,9 +2082,8 @@ class binary_reader
                 }
                 if (!value_in_range_of<std::size_t>(number))
                 {
-                    // undo coverage exclusion once the 32bit test is run as part of CI (#3524)
-                    return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408, // LCOV_EXCL_LINE
-                                            exception_message(input_format, "integer value overflow", "size"), nullptr)); // LCOV_EXCL_LINE
+                    return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408,
+                                            exception_message(input_format, "integer value overflow", "size"), nullptr));
                 }
                 result = static_cast<std::size_t>(number);
                 return true;
@@ -2115,7 +2115,7 @@ class binary_reader
                 {
                     return false;
                 }
-                result = static_cast<std::size_t>(number);
+                result = conditional_static_cast<std::size_t>(number);
                 return true;
             }
 
@@ -2132,9 +2132,8 @@ class binary_reader
                 }
                 if (!value_in_range_of<std::size_t>(number))
                 {
-                    // undo coverage exclusion once the 32bit test is run as part of CI (#3524)
-                    return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408, // LCOV_EXCL_LINE
-                                            exception_message(input_format, "integer value overflow", "size"), nullptr)); // LCOV_EXCL_LINE
+                    return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408,
+                                            exception_message(input_format, "integer value overflow", "size"), nullptr));
                 }
                 result = detail::conditional_static_cast<std::size_t>(number);
                 return true;
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index 4a73ce5d3..4a9c4bf83 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -9310,7 +9310,8 @@ class binary_reader
             case 0x95:
             case 0x96:
             case 0x97:
-                return get_cbor_array(static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x1Fu), tag_handler);
+                return get_cbor_array(
+                           conditional_static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x1Fu), tag_handler);
 
             case 0x98: // array (one-byte uint8_t for n follows)
             {
@@ -9327,13 +9328,13 @@ class binary_reader
             case 0x9A: // array (four-byte uint32_t for n follow)
             {
                 std::uint32_t len{};
-                return get_number(input_format_t::cbor, len) && get_cbor_array(static_cast<std::size_t>(len), tag_handler);
+                return get_number(input_format_t::cbor, len) && get_cbor_array(conditional_static_cast<std::size_t>(len), tag_handler);
             }
 
             case 0x9B: // array (eight-byte uint64_t for n follow)
             {
                 std::uint64_t len{};
-                return get_number(input_format_t::cbor, len) && get_cbor_array(detail::conditional_static_cast<std::size_t>(len), tag_handler);
+                return get_number(input_format_t::cbor, len) && get_cbor_array(conditional_static_cast<std::size_t>(len), tag_handler);
             }
 
             case 0x9F: // array (indefinite length)
@@ -9364,7 +9365,7 @@ class binary_reader
             case 0xB5:
             case 0xB6:
             case 0xB7:
-                return get_cbor_object(static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x1Fu), tag_handler);
+                return get_cbor_object(conditional_static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x1Fu), tag_handler);
 
             case 0xB8: // map (one-byte uint8_t for n follows)
             {
@@ -9381,13 +9382,13 @@ class binary_reader
             case 0xBA: // map (four-byte uint32_t for n follow)
             {
                 std::uint32_t len{};
-                return get_number(input_format_t::cbor, len) && get_cbor_object(static_cast<std::size_t>(len), tag_handler);
+                return get_number(input_format_t::cbor, len) && get_cbor_object(conditional_static_cast<std::size_t>(len), tag_handler);
             }
 
             case 0xBB: // map (eight-byte uint64_t for n follow)
             {
                 std::uint64_t len{};
-                return get_number(input_format_t::cbor, len) && get_cbor_object(detail::conditional_static_cast<std::size_t>(len), tag_handler);
+                return get_number(input_format_t::cbor, len) && get_cbor_object(conditional_static_cast<std::size_t>(len), tag_handler);
             }
 
             case 0xBF: // map (indefinite length)
@@ -10034,7 +10035,7 @@ class binary_reader
             case 0x8D:
             case 0x8E:
             case 0x8F:
-                return get_msgpack_object(static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x0Fu));
+                return get_msgpack_object(conditional_static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x0Fu));
 
             // fixarray
             case 0x90:
@@ -10053,7 +10054,7 @@ class binary_reader
             case 0x9D:
             case 0x9E:
             case 0x9F:
-                return get_msgpack_array(static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x0Fu));
+                return get_msgpack_array(conditional_static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x0Fu));
 
             // fixstr
             case 0xA0:
@@ -10190,7 +10191,7 @@ class binary_reader
             case 0xDD: // array 32
             {
                 std::uint32_t len{};
-                return get_number(input_format_t::msgpack, len) && get_msgpack_array(static_cast<std::size_t>(len));
+                return get_number(input_format_t::msgpack, len) && get_msgpack_array(conditional_static_cast<std::size_t>(len));
             }
 
             case 0xDE: // map 16
@@ -10202,7 +10203,7 @@ class binary_reader
             case 0xDF: // map 32
             {
                 std::uint32_t len{};
-                return get_number(input_format_t::msgpack, len) && get_msgpack_object(static_cast<std::size_t>(len));
+                return get_number(input_format_t::msgpack, len) && get_msgpack_object(conditional_static_cast<std::size_t>(len));
             }
 
             // negative fixint
@@ -10773,9 +10774,8 @@ class binary_reader
                 }
                 if (!value_in_range_of<std::size_t>(number))
                 {
-                    // undo coverage exclusion once the 32bit test is run as part of CI (#3524)
-                    return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408, // LCOV_EXCL_LINE
-                                            exception_message(input_format, "integer value overflow", "size"), nullptr)); // LCOV_EXCL_LINE
+                    return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408,
+                                            exception_message(input_format, "integer value overflow", "size"), nullptr));
                 }
                 result = static_cast<std::size_t>(number);
                 return true;
@@ -10807,7 +10807,7 @@ class binary_reader
                 {
                     return false;
                 }
-                result = static_cast<std::size_t>(number);
+                result = conditional_static_cast<std::size_t>(number);
                 return true;
             }
 
@@ -10824,9 +10824,8 @@ class binary_reader
                 }
                 if (!value_in_range_of<std::size_t>(number))
                 {
-                    // undo coverage exclusion once the 32bit test is run as part of CI (#3524)
-                    return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408, // LCOV_EXCL_LINE
-                                            exception_message(input_format, "integer value overflow", "size"), nullptr)); // LCOV_EXCL_LINE
+                    return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408,
+                                            exception_message(input_format, "integer value overflow", "size"), nullptr));
                 }
                 result = detail::conditional_static_cast<std::size_t>(number);
                 return true;
diff --git a/tests/CMakeLists.txt b/tests/CMakeLists.txt
index ef87c4909..8f9240f1a 100644
--- a/tests/CMakeLists.txt
+++ b/tests/CMakeLists.txt
@@ -2,8 +2,8 @@ cmake_minimum_required(VERSION 3.13)
 
 option(JSON_Valgrind    "Execute test suite with Valgrind." OFF)
 option(JSON_FastTests   "Skip expensive/slow tests." OFF)
-option(JSON_32bitTest   "Enable the 32bit unit test." OFF)
 
+set(JSON_32bitTest     AUTO CACHE STRING "Enable the 32bit unit test (ON/OFF/AUTO/ONLY).")
 set(JSON_TestStandards "" CACHE STRING "The list of standards to test explicitly.")
 
 include(test)
@@ -34,40 +34,32 @@ endif()
 # test_main library with shared code to speed up build and common settings
 #############################################################################
 
-set(test_main_SOURCES src/unit.cpp)
-set(test_main_COMPILE_DEFINITIONS PUBLIC
+add_library(test_main OBJECT src/unit.cpp)
+target_compile_definitions(test_main PUBLIC
     DOCTEST_CONFIG_SUPER_FAST_ASSERTS
     JSON_TEST_KEEP_MACROS)
-set(test_main_COMPILE_FEATURES PRIVATE cxx_std_11)
-set(test_main_COMPILE_OPTIONS
-    PUBLIC
-        $<$<CXX_COMPILER_ID:MSVC>:/EHsc;$<$<CONFIG:Release>:/Od>>
-        # MSVC: Force to always compile with W4
-        #       Disable warning C4566: character represented by universal-character-name '\uFF01'
-        #                              cannot be represented in the current code page (1252)
-        #       Disable warning C4996: 'nlohmann::basic_json<...>::operator <<': was declared deprecated
-        $<$<CXX_COMPILER_ID:MSVC>:/W4 /wd4566 /wd4996>
-        # https://github.com/nlohmann/json/issues/1114
-        $<$<CXX_COMPILER_ID:MSVC>:/bigobj> $<$<BOOL:${MINGW}>:-Wa,-mbig-obj>
+target_compile_features(test_main PRIVATE cxx_std_11)
+target_compile_options(test_main PUBLIC
+    $<$<CXX_COMPILER_ID:MSVC>:/EHsc;$<$<CONFIG:Release>:/Od>>
+    # MSVC: Force to always compile with W4
+    #       Disable warning C4566: character represented by universal-character-name '\uFF01'
+    #                              cannot be represented in the current code page (1252)
+    #       Disable warning C4996: 'nlohmann::basic_json<...>::operator <<': was declared deprecated
+    $<$<CXX_COMPILER_ID:MSVC>:/W4 /wd4566 /wd4996>
+    # https://github.com/nlohmann/json/issues/1114
+    $<$<CXX_COMPILER_ID:MSVC>:/bigobj> $<$<BOOL:${MINGW}>:-Wa,-mbig-obj>
 
-        # https://github.com/nlohmann/json/pull/3229
-        $<$<CXX_COMPILER_ID:Intel>:-diag-disable=2196>
+    # https://github.com/nlohmann/json/pull/3229
+    $<$<CXX_COMPILER_ID:Intel>:-diag-disable=2196>
 
-        $<$<NOT:$<CXX_COMPILER_ID:MSVC>>:-Wno-deprecated;-Wno-float-equal>
-        $<$<CXX_COMPILER_ID:GNU>:-Wno-deprecated-declarations>
-        $<$<CXX_COMPILER_ID:Intel>:-diag-disable=1786>)
-set(test_main_INCLUDE_DIRECTORIES PUBLIC
+    $<$<NOT:$<CXX_COMPILER_ID:MSVC>>:-Wno-deprecated;-Wno-float-equal>
+    $<$<CXX_COMPILER_ID:GNU>:-Wno-deprecated-declarations>
+    $<$<CXX_COMPILER_ID:Intel>:-diag-disable=1786>)
+target_include_directories(test_main PUBLIC
     thirdparty/doctest
     thirdparty/fifo_map
     ${PROJECT_BINARY_DIR}/include)
-set(test_main_LINK_LIBRARIES PUBLIC ${NLOHMANN_JSON_TARGET_NAME})
-
-add_library(test_main OBJECT ${test_main_SOURCES})
-target_compile_definitions(test_main ${test_main_COMPILE_DEFINITIONS})
-target_compile_features(test_main ${test_main_COMPILE_FEATURES})
-target_compile_options(test_main ${test_main_COMPILE_OPTIONS})
-target_include_directories(test_main ${test_main_INCLUDE_DIRECTORIES})
-target_link_libraries(test_main ${test_main_LINK_LIBRARIES})
+target_link_libraries(test_main PUBLIC ${NLOHMANN_JSON_TARGET_NAME})
 
 #############################################################################
 # define test- and standard-specific build settings
@@ -124,23 +116,21 @@ message(STATUS "${msg}")
 
 # *DO* use json_test_set_test_options() above this line
 
+json_test_should_build_32bit_test(json_32bit_test json_32bit_test_only "${JSON_32bitTest}")
 file(GLOB files src/unit-*.cpp)
-list(FILTER files EXCLUDE REGEX "src/unit-32bit.cpp")
+if(json_32bit_test_only)
+    set(files src/unit-32bit.cpp)    
+elseif(NOT json_32bit_test)
+    list(FILTER files EXCLUDE REGEX src/unit-32bit.cpp)
+endif()
+
 foreach(file ${files})
     json_test_add_test_for(${file} MAIN test_main CXX_STANDARDS ${test_cxx_standards} ${test_force})
 endforeach()
 
-if(JSON_32bitTest)
-    add_library(test_main32 OBJECT ${test_main_SOURCES})
-    target_compile_definitions(test_main32 ${test_main_COMPILE_DEFINITIONS})
-    target_compile_features(test_main32 ${test_main_COMPILE_FEATURES})
-    target_compile_options(test_main32 ${test_main_COMPILE_OPTIONS} -m32)
-    target_include_directories(test_main32 ${test_main_INCLUDE_DIRECTORIES})
-    target_link_libraries(test_main32 ${test_main_LINK_LIBRARIES})
-    target_link_options(test_main32 PUBLIC -m32)
-
-    json_test_add_test_for("src/unit-32bit.cpp" MAIN test_main32
-        CXX_STANDARDS ${test_cxx_standards} ${test_force})
+if(json_32bit_test_only)
+    # Skip all other tests in this file
+    return()
 endif()
 
 # test legacy comparison of discarded values
diff --git a/tests/src/unit-32bit.cpp b/tests/src/unit-32bit.cpp
index 711dda5a0..25da44f4d 100644
--- a/tests/src/unit-32bit.cpp
+++ b/tests/src/unit-32bit.cpp
@@ -98,18 +98,14 @@ TEST_CASE("BJData")
     {
         SECTION("array")
         {
-            SECTION("optimized array: no size following type")
-            {
-                std::vector<uint8_t> v = {'[', '$', 'i', 2};
-                json _;
-                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v), "[json.exception.parse_error.112] parse error at byte 4: syntax error while parsing BJData size: expected '#' after type information; last byte: 0x02", json::parse_error&);
-            }
-
-            SECTION("optimized array: negative size")
+            SECTION("optimized array: integer value overflow")
             {
+                std::vector<uint8_t> vL = {'[', '#', 'L', 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7F};
                 std::vector<uint8_t> vM = {'[', '$', 'M', '#', '[', 'I', 0x00, 0x20, 'M', 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x20, 0xFF, ']'};
 
                 json _;
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vL), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
+
                 CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vM), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
             }
         }
diff --git a/tests/src/unit-bjdata.cpp b/tests/src/unit-bjdata.cpp
index 974ee3a0a..ab046a602 100644
--- a/tests/src/unit-bjdata.cpp
+++ b/tests/src/unit-bjdata.cpp
@@ -2649,14 +2649,27 @@ TEST_CASE("BJData")
                 CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vL), "[json.exception.parse_error.113] parse error at byte 11: syntax error while parsing BJData size: count in an optimized container must be positive", json::parse_error&);
                 CHECK(json::from_bjdata(vL, true, false).is_discarded());
 
-#if SIZE_MAX == 0xffffffff
-                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vM), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
-#else
+#if SIZE_MAX != 0xffffffff
                 CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vM), "[json.exception.out_of_range.408] syntax error while parsing BJData size: excessive ndarray size caused overflow", json::out_of_range&);
 #endif
                 CHECK(json::from_bjdata(vM, true, false).is_discarded());
             }
 
+            SECTION("optimized array: integer value overflow")
+            {
+                std::vector<uint8_t> vL = {'[', '#', 'L', 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7F};
+                std::vector<uint8_t> vM = {'[', '$', 'M', '#', '[', 'I', 0x00, 0x20, 'M', 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x20, 0xFF, ']'};
+
+                json _;
+#if SIZE_MAX == 0xffffffff
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vL), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
+#endif
+
+#if SIZE_MAX == 0xffffffff
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vM), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
+#endif
+            }
+
             SECTION("do not accept NTFZ markers in ndarray optimized type (with count)")
             {
                 json _;

From f6acdbec2c99670cf932d83cd797f08662e0b564 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Richard=20Hoz=C3=A1k?= <r.hozak@seznam.cz>
Date: Thu, 16 Jun 2022 19:34:32 +0200
Subject: [PATCH 28/30] Allow disabling default enum conversions (#3536)

---
 CMakeLists.txt                                |   6 +
 cmake/ci.cmake                                |   4 +-
 docs/docset/docSet.sql                        |   1 +
 docs/mkdocs/docs/api/macros/index.md          |   1 +
 .../macros/json_disable_enum_serialization.md | 135 ++++++++++++++++++
 .../macros/nlohmann_json_serialize_enum.md    |   1 +
 docs/mkdocs/docs/features/enum_conversion.md  |   1 +
 docs/mkdocs/docs/features/macros.md           |   6 +
 docs/mkdocs/mkdocs.yml                        |   1 +
 .../nlohmann/detail/conversions/from_json.hpp |   2 +
 .../nlohmann/detail/conversions/to_json.hpp   |   2 +
 include/nlohmann/detail/macro_scope.hpp       |   4 +
 include/nlohmann/detail/macro_unscope.hpp     |   1 +
 single_include/nlohmann/json.hpp              |   9 ++
 14 files changed, 172 insertions(+), 2 deletions(-)
 create mode 100644 docs/mkdocs/docs/api/macros/json_disable_enum_serialization.md

diff --git a/CMakeLists.txt b/CMakeLists.txt
index aae5fb6e3..f20d56137 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -41,6 +41,7 @@ option(JSON_BuildTests                     "Build the unit tests when BUILD_TEST
 option(JSON_CI                             "Enable CI build targets." OFF)
 option(JSON_Diagnostics                    "Use extended diagnostic messages." OFF)
 option(JSON_ImplicitConversions            "Enable implicit conversions." ON)
+option(JSON_DisableEnumSerialization       "Disable default integer enum serialization." OFF)
 option(JSON_LegacyDiscardedValueComparison "Enable legacy discarded value comparison." OFF)           
 option(JSON_Install                        "Install CMake targets during install step." ${MAIN_PROJECT})
 option(JSON_MultipleHeaders                "Use non-amalgamated version of the library." ON)
@@ -78,6 +79,10 @@ if (NOT JSON_ImplicitConversions)
     message(STATUS "Implicit conversions are disabled")
 endif()
 
+if (JSON_DisableEnumSerialization)
+    message(STATUS "Enum integer serialization is disabled")
+endif()
+
 if (JSON_LegacyDiscardedValueComparison)
     message(STATUS "Legacy discarded value comparison enabled")
 endif()
@@ -106,6 +111,7 @@ target_compile_definitions(
     ${NLOHMANN_JSON_TARGET_NAME}
     INTERFACE
     $<$<NOT:$<BOOL:${JSON_ImplicitConversions}>>:JSON_USE_IMPLICIT_CONVERSIONS=0>
+    $<$<BOOL:${JSON_DisableEnumSerialization}>:JSON_DISABLE_ENUM_SERIALIZATION=1>
     $<$<BOOL:${JSON_Diagnostics}>:JSON_DIAGNOSTICS=1>
     $<$<BOOL:${JSON_LegacyDiscardedValueComparison}>:JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON=1>
 )
diff --git a/cmake/ci.cmake b/cmake/ci.cmake
index 8704d4a54..4fcff86aa 100644
--- a/cmake/ci.cmake
+++ b/cmake/ci.cmake
@@ -838,8 +838,8 @@ endfunction()
 ci_get_cmake(3.1.0 CMAKE_3_1_0_BINARY)
 ci_get_cmake(3.13.0 CMAKE_3_13_0_BINARY)
 
-set(JSON_CMAKE_FLAGS_3_1_0 JSON_Diagnostics JSON_ImplicitConversions JSON_LegacyDiscardedValueComparison 
-    JSON_Install JSON_MultipleHeaders JSON_SystemInclude JSON_Valgrind)
+set(JSON_CMAKE_FLAGS_3_1_0 JSON_Diagnostics JSON_ImplicitConversions JSON_DisableEnumSerialization 
+    JSON_LegacyDiscardedValueComparison JSON_Install JSON_MultipleHeaders JSON_SystemInclude JSON_Valgrind)
 set(JSON_CMAKE_FLAGS_3_13_0 JSON_BuildTests)
 
 function(ci_add_cmake_flags_targets flag min_version)
diff --git a/docs/docset/docSet.sql b/docs/docset/docSet.sql
index 8bd4e0678..30c4a48de 100644
--- a/docs/docset/docSet.sql
+++ b/docs/docset/docSet.sql
@@ -140,6 +140,7 @@ INSERT INTO searchIndex(name, type, path) VALUES ('SAX Interface', 'Guide', 'fea
 INSERT INTO searchIndex(name, type, path) VALUES ('JSON_ASSERT', 'Macro', 'features/macros/index.html#json_assertx');
 INSERT INTO searchIndex(name, type, path) VALUES ('JSON_CATCH_USER', 'Macro', 'features/macros/index.html#json_catch_userexception');
 INSERT INTO searchIndex(name, type, path) VALUES ('JSON_DIAGNOSTICS', 'Macro', 'features/macros/index.html#json_diagnostics');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_DISABLE_ENUM_SERIALIZATION', 'Macro', 'features/macros/index.html#json_disable_enum_serialization');
 INSERT INTO searchIndex(name, type, path) VALUES ('JSON_HAS_CPP_11', 'Macro', 'features/macros/index.html#json_has_cpp_11-json_has_cpp_14-json_has_cpp_17-json_has_cpp_20');
 INSERT INTO searchIndex(name, type, path) VALUES ('JSON_HAS_CPP_14', 'Macro', 'features/macros/index.html#json_has_cpp_11-json_has_cpp_14-json_has_cpp_17-json_has_cpp_20');
 INSERT INTO searchIndex(name, type, path) VALUES ('JSON_HAS_CPP_17', 'Macro', 'features/macros/index.html#json_has_cpp_11-json_has_cpp_14-json_has_cpp_17-json_has_cpp_20');
diff --git a/docs/mkdocs/docs/api/macros/index.md b/docs/mkdocs/docs/api/macros/index.md
index 5f0a7a194..d95869b93 100644
--- a/docs/mkdocs/docs/api/macros/index.md
+++ b/docs/mkdocs/docs/api/macros/index.md
@@ -29,6 +29,7 @@ header. See also the [macro overview page](../../features/macros.md).
 
 ## Type conversions
 
+- [**JSON_DISABLE_ENUM_SERIALIZATION**](json_disable_enum_serialization.md) - switch off default serialization/deserialization functions for enums
 - [**JSON_USE_IMPLICIT_CONVERSIONS**](json_use_implicit_conversions.md) - control implicit conversions
 
 <!-- comment-->
diff --git a/docs/mkdocs/docs/api/macros/json_disable_enum_serialization.md b/docs/mkdocs/docs/api/macros/json_disable_enum_serialization.md
new file mode 100644
index 000000000..ea291f9a0
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_disable_enum_serialization.md
@@ -0,0 +1,135 @@
+# JSON_DISABLE_ENUM_SERIALIZATION
+
+```cpp
+#define JSON_DISABLE_ENUM_SERIALIZATION
+```
+
+When defined, default serialization and deserialization functions for enums are excluded and have to be provided by the user, for example, using [`NLOHMANN_JSON_SERIALIZE_ENUM`](nlohmann_json_serialize_enum.md) (see [arbitrary type conversions](../../features/arbitrary_types.md) for more details).
+
+Parsing or serializing an enum will result in a compiler error.
+
+This works for both unscoped and scoped enums.
+
+## Default definition
+
+By default, `#!cpp JSON_DISABLE_ENUM_SERIALIZATION` is not defined.
+
+```cpp
+#undef JSON_DISABLE_ENUM_SERIALIZATION
+```
+
+## Examples
+
+??? example "Example 1: Disabled behavior"
+
+    The code below forces the library **not** to create default serialization/deserialization functions `from_json` and `to_json`, meaning the code below **does not** compile.
+
+    ```cpp
+    #define JSON_DISABLE_ENUM_SERIALIZATION 1
+    #include <nlohmann/json.hpp>
+
+    using json = nlohmann::json;
+
+    enum class Choice
+    {
+        first,
+        second,
+    };
+    
+    int main()
+    {
+        // normally invokes to_json serialization function but with JSON_DISABLE_ENUM_SERIALIZATION defined, it does not
+        const json j = Choice::first; 
+
+        // normally invokes from_json parse function but with JSON_DISABLE_ENUM_SERIALIZATION defined, it does not
+        Choice ch = j.get<Choice>();
+    }
+    ```
+
+??? example "Example 2: Serialize enum macro"
+
+    The code below forces the library **not** to create default serialization/deserialization functions `from_json` and `to_json`, but uses [`NLOHMANN_JSON_SERIALIZE_ENUM`](nlohmann_json_serialize_enum.md) to parse and serialize the enum.
+
+    ```cpp
+    #define JSON_DISABLE_ENUM_SERIALIZATION 1
+    #include <nlohmann/json.hpp>
+
+    using json = nlohmann::json;
+
+    enum class Choice
+    {
+        first,
+        second,
+    };
+
+    NLOHMANN_JSON_SERIALIZE_ENUM(Choice,
+    {
+        { Choice::first, "first" },
+        { Choice::second, "second" },
+    })
+    
+    int main()
+    {
+        // uses user-defined to_json function defined by macro
+        const json j = Choice::first; 
+
+        // uses user-defined from_json function defined by macro
+        Choice ch = j.get<Choice>();
+    }
+    ```
+
+??? example "Example 3: User-defined serialization/deserialization functions"
+
+    The code below forces the library **not** to create default serialization/deserialization functions `from_json` and `to_json`, but uses user-defined functions to parse and serialize the enum.
+
+    ```cpp
+    #define JSON_DISABLE_ENUM_SERIALIZATION 1
+    #include <nlohmann/json.hpp>
+
+    using json = nlohmann::json;
+
+    enum class Choice
+    {
+        first,
+        second,
+    };
+
+    void from_json(const json& j, Choice& ch)
+    {
+        auto value = j.get<std::string>();
+        if (value == "first")
+        {
+            ch = Choice::first;
+        }
+        else if (value == "second")
+        {
+            ch = Choice::second;
+        }
+    }
+
+    void to_json(json& j, const Choice& ch)
+    {
+        auto value = j.get<std::string>();
+        if (value == "first")
+        {
+            ch = Choice::first;
+        }
+        else if (value == "second")
+        {
+            ch = Choice::second;
+        }
+    }
+    
+    int main()
+    {
+        // uses user-defined to_json function
+        const json j = Choice::first; 
+
+        // uses user-defined from_json function
+        Choice ch = j.get<Choice>();
+    }
+    ```
+
+## See also
+
+- [`NLOHMANN_JSON_SERIALIZE_ENUM`](nlohmann_json_serialize_enum.md)
\ No newline at end of file
diff --git a/docs/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md b/docs/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md
index 7b0f89802..b7204a808 100644
--- a/docs/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md
+++ b/docs/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md
@@ -78,6 +78,7 @@ inline void from_json(const BasicJsonType& j, type& e);
 ## See also
 
 - [Specializing enum conversion](../../features/enum_conversion.md)
+- [`JSON_DISABLE_ENUM_SERIALIZATION`](json_disable_enum_serialization.md)
 
 ## Version history
 
diff --git a/docs/mkdocs/docs/features/enum_conversion.md b/docs/mkdocs/docs/features/enum_conversion.md
index 7e61f67bb..59ffbd5f1 100644
--- a/docs/mkdocs/docs/features/enum_conversion.md
+++ b/docs/mkdocs/docs/features/enum_conversion.md
@@ -58,3 +58,4 @@ Other Important points:
   default pair carefully.
 - If an enum or JSON value is specified more than once in your map, the first matching occurrence from the top of the
   map will be returned when converting to or from JSON.
+- To disable the default serialization of enumerators as integers and force a compiler error instead, see [`JSON_DISABLE_ENUM_SERIALIZATION`](../api/macros/json_disable_enum_serialization.md).
diff --git a/docs/mkdocs/docs/features/macros.md b/docs/mkdocs/docs/features/macros.md
index e04a426a5..1be95d35d 100644
--- a/docs/mkdocs/docs/features/macros.md
+++ b/docs/mkdocs/docs/features/macros.md
@@ -54,6 +54,12 @@ Exceptions can be switched off by defining the symbol `JSON_NOEXCEPTION`.
 
 See [full documentation of `JSON_NOEXCEPTION`](../api/macros/json_noexception.md).
 
+## `JSON_DISABLE_ENUM_SERIALIZATION`
+
+When defined, default parse and serialize functions for enums are excluded and have to be provided by the user, for example, using [`NLOHMANN_JSON_SERIALIZE_ENUM`](../api/macros/nlohmann_json_serialize_enum.md).
+
+See [full documentation of `JSON_DISABLE_ENUM_SERIALIZATION`](../api/macros/json_disable_enum_serialization.md).
+
 ## `JSON_NO_IO`
 
 When defined, headers `<cstdio>`, `<ios>`, `<iosfwd>`, `<istream>`, and `<ostream>` are not included and parse functions
diff --git a/docs/mkdocs/mkdocs.yml b/docs/mkdocs/mkdocs.yml
index 08ef336db..c583ed78f 100644
--- a/docs/mkdocs/mkdocs.yml
+++ b/docs/mkdocs/mkdocs.yml
@@ -241,6 +241,7 @@ nav:
         - 'JSON_ASSERT': api/macros/json_assert.md
         - 'JSON_CATCH_USER': api/macros/json_throw_user.md
         - 'JSON_DIAGNOSTICS': api/macros/json_diagnostics.md
+        - 'JSON_DISABLE_ENUM_SERIALIZATION': api/macros/json_disable_enum_serialization.md
         - 'JSON_HAS_CPP_11': api/macros/json_has_cpp_11.md
         - 'JSON_HAS_CPP_14': api/macros/json_has_cpp_11.md
         - 'JSON_HAS_CPP_17': api/macros/json_has_cpp_11.md
diff --git a/include/nlohmann/detail/conversions/from_json.hpp b/include/nlohmann/detail/conversions/from_json.hpp
index f0a93f291..ed4e6de5f 100644
--- a/include/nlohmann/detail/conversions/from_json.hpp
+++ b/include/nlohmann/detail/conversions/from_json.hpp
@@ -139,6 +139,7 @@ inline void from_json(const BasicJsonType& j, typename BasicJsonType::number_int
     get_arithmetic_value(j, val);
 }
 
+#if !JSON_DISABLE_ENUM_SERIALIZATION
 template<typename BasicJsonType, typename EnumType,
          enable_if_t<std::is_enum<EnumType>::value, int> = 0>
 inline void from_json(const BasicJsonType& j, EnumType& e)
@@ -147,6 +148,7 @@ inline void from_json(const BasicJsonType& j, EnumType& e)
     get_arithmetic_value(j, val);
     e = static_cast<EnumType>(val);
 }
+#endif  // JSON_DISABLE_ENUM_SERIALIZATION
 
 // forward_list doesn't have an insert method
 template<typename BasicJsonType, typename T, typename Allocator,
diff --git a/include/nlohmann/detail/conversions/to_json.hpp b/include/nlohmann/detail/conversions/to_json.hpp
index b59077338..1d7a86a53 100644
--- a/include/nlohmann/detail/conversions/to_json.hpp
+++ b/include/nlohmann/detail/conversions/to_json.hpp
@@ -313,6 +313,7 @@ inline void to_json(BasicJsonType& j, CompatibleNumberIntegerType val) noexcept
     external_constructor<value_t::number_integer>::construct(j, static_cast<typename BasicJsonType::number_integer_t>(val));
 }
 
+#if !JSON_DISABLE_ENUM_SERIALIZATION
 template<typename BasicJsonType, typename EnumType,
          enable_if_t<std::is_enum<EnumType>::value, int> = 0>
 inline void to_json(BasicJsonType& j, EnumType e) noexcept
@@ -320,6 +321,7 @@ inline void to_json(BasicJsonType& j, EnumType e) noexcept
     using underlying_type = typename std::underlying_type<EnumType>::type;
     external_constructor<value_t::number_integer>::construct(j, static_cast<underlying_type>(e));
 }
+#endif  // JSON_DISABLE_ENUM_SERIALIZATION
 
 template<typename BasicJsonType>
 inline void to_json(BasicJsonType& j, const std::vector<bool>& e)
diff --git a/include/nlohmann/detail/macro_scope.hpp b/include/nlohmann/detail/macro_scope.hpp
index 18a527c19..706f1b971 100644
--- a/include/nlohmann/detail/macro_scope.hpp
+++ b/include/nlohmann/detail/macro_scope.hpp
@@ -456,3 +456,7 @@
 #ifndef JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
     #define JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON 0
 #endif
+
+#ifndef JSON_DISABLE_ENUM_SERIALIZATION
+    #define JSON_DISABLE_ENUM_SERIALIZATION 0
+#endif
diff --git a/include/nlohmann/detail/macro_unscope.hpp b/include/nlohmann/detail/macro_unscope.hpp
index 396fe1a33..09f677b3d 100644
--- a/include/nlohmann/detail/macro_unscope.hpp
+++ b/include/nlohmann/detail/macro_unscope.hpp
@@ -16,6 +16,7 @@
 #undef NLOHMANN_CAN_CALL_STD_FUNC_IMPL
 #undef JSON_INLINE_VARIABLE
 #undef JSON_NO_UNIQUE_ADDRESS
+#undef JSON_DISABLE_ENUM_SERIALIZATION
 
 #ifndef JSON_TEST_KEEP_MACROS
     #undef JSON_CATCH
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index 4a9c4bf83..98c8dd664 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -2684,6 +2684,10 @@ using is_detected_convertible =
     #define JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON 0
 #endif
 
+#ifndef JSON_DISABLE_ENUM_SERIALIZATION
+    #define JSON_DISABLE_ENUM_SERIALIZATION 0
+#endif
+
 #if JSON_HAS_THREE_WAY_COMPARISON
     #include <compare> // partial_ordering
 #endif
@@ -4384,6 +4388,7 @@ inline void from_json(const BasicJsonType& j, typename BasicJsonType::number_int
     get_arithmetic_value(j, val);
 }
 
+#if !JSON_DISABLE_ENUM_SERIALIZATION
 template<typename BasicJsonType, typename EnumType,
          enable_if_t<std::is_enum<EnumType>::value, int> = 0>
 inline void from_json(const BasicJsonType& j, EnumType& e)
@@ -4392,6 +4397,7 @@ inline void from_json(const BasicJsonType& j, EnumType& e)
     get_arithmetic_value(j, val);
     e = static_cast<EnumType>(val);
 }
+#endif  // JSON_DISABLE_ENUM_SERIALIZATION
 
 // forward_list doesn't have an insert method
 template<typename BasicJsonType, typename T, typename Allocator,
@@ -5294,6 +5300,7 @@ inline void to_json(BasicJsonType& j, CompatibleNumberIntegerType val) noexcept
     external_constructor<value_t::number_integer>::construct(j, static_cast<typename BasicJsonType::number_integer_t>(val));
 }
 
+#if !JSON_DISABLE_ENUM_SERIALIZATION
 template<typename BasicJsonType, typename EnumType,
          enable_if_t<std::is_enum<EnumType>::value, int> = 0>
 inline void to_json(BasicJsonType& j, EnumType e) noexcept
@@ -5301,6 +5308,7 @@ inline void to_json(BasicJsonType& j, EnumType e) noexcept
     using underlying_type = typename std::underlying_type<EnumType>::type;
     external_constructor<value_t::number_integer>::construct(j, static_cast<underlying_type>(e));
 }
+#endif  // JSON_DISABLE_ENUM_SERIALIZATION
 
 template<typename BasicJsonType>
 inline void to_json(BasicJsonType& j, const std::vector<bool>& e)
@@ -23580,6 +23588,7 @@ inline nlohmann::json::json_pointer operator "" _json_pointer(const char* s, std
 #undef NLOHMANN_CAN_CALL_STD_FUNC_IMPL
 #undef JSON_INLINE_VARIABLE
 #undef JSON_NO_UNIQUE_ADDRESS
+#undef JSON_DISABLE_ENUM_SERIALIZATION
 
 #ifndef JSON_TEST_KEEP_MACROS
     #undef JSON_CATCH

From 13730235f2430e0071cdd5e61479eeb1e7eb0e4f Mon Sep 17 00:00:00 2001
From: Qianqian Fang <fangqq@gmail.com>
Date: Sat, 18 Jun 2022 13:12:22 -0400
Subject: [PATCH 29/30] BJData dimension length can not be string_t::npos, fix
 #3541 (#3543)

* BJData dimension length can not be string_t::npos, fix #3541

* handle error messages on 32bit machine

* add explanation to why size can not be string_t::npos

* add test cases to 32bit unit test

Co-authored-by: Florian Albrechtskirchinger <falbrechtskirchinger@gmail.com>
---
 include/nlohmann/detail/input/binary_reader.hpp |  2 +-
 single_include/nlohmann/json.hpp                |  2 +-
 tests/src/unit-32bit.cpp                        | 15 +++++++++++++++
 tests/src/unit-bjdata.cpp                       | 12 ++++++++++++
 4 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/include/nlohmann/detail/input/binary_reader.hpp b/include/nlohmann/detail/input/binary_reader.hpp
index f5871ddf6..103f7a752 100644
--- a/include/nlohmann/detail/input/binary_reader.hpp
+++ b/include/nlohmann/detail/input/binary_reader.hpp
@@ -2179,7 +2179,7 @@ class binary_reader
                     for (auto i : dim)
                     {
                         result *= i;
-                        if (result == 0) // because dim elements shall not have zeros, result = 0 means overflow happened
+                        if (result == 0 || result == string_t::npos) // because dim elements shall not have zeros, result = 0 means overflow happened; it also can't be string_t::npos as it is used to initialize size in get_ubjson_size_type()
                         {
                             return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408, exception_message(input_format, "excessive ndarray size caused overflow", "size"), nullptr));
                         }
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index 98c8dd664..834c6fc87 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -10879,7 +10879,7 @@ class binary_reader
                     for (auto i : dim)
                     {
                         result *= i;
-                        if (result == 0) // because dim elements shall not have zeros, result = 0 means overflow happened
+                        if (result == 0 || result == string_t::npos) // because dim elements shall not have zeros, result = 0 means overflow happened; it also can't be string_t::npos as it is used to initialize size in get_ubjson_size_type()
                         {
                             return sax->parse_error(chars_read, get_token_string(), out_of_range::create(408, exception_message(input_format, "excessive ndarray size caused overflow", "size"), nullptr));
                         }
diff --git a/tests/src/unit-32bit.cpp b/tests/src/unit-32bit.cpp
index 25da44f4d..cbe07b49f 100644
--- a/tests/src/unit-32bit.cpp
+++ b/tests/src/unit-32bit.cpp
@@ -98,6 +98,19 @@ TEST_CASE("BJData")
     {
         SECTION("array")
         {
+            SECTION("optimized array: negative size")
+            {
+                std::vector<uint8_t> vM = {'[', '$', 'M', '#', '[', 'I', 0x00, 0x20, 'M', 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x20, 0xFF, ']'};
+                std::vector<uint8_t> vMX = {'[', '$', 'U', '#', '[', 'M', 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 'U', 0x01, ']'};
+
+                json _;
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vM), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
+                CHECK(json::from_bjdata(vM, true, false).is_discarded());
+
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vMX), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
+                CHECK(json::from_bjdata(vMX, true, false).is_discarded());
+            }
+
             SECTION("optimized array: integer value overflow")
             {
                 std::vector<uint8_t> vL = {'[', '#', 'L', 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7F};
@@ -105,8 +118,10 @@ TEST_CASE("BJData")
 
                 json _;
                 CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vL), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
+                CHECK(json::from_bjdata(vL, true, false).is_discarded());
 
                 CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vM), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
+                CHECK(json::from_bjdata(vM, true, false).is_discarded());
             }
         }
     }
diff --git a/tests/src/unit-bjdata.cpp b/tests/src/unit-bjdata.cpp
index ab046a602..7442ea588 100644
--- a/tests/src/unit-bjdata.cpp
+++ b/tests/src/unit-bjdata.cpp
@@ -2620,6 +2620,7 @@ TEST_CASE("BJData")
                 std::vector<uint8_t> vl = {'[', '#', 'l', 0x00, 0x00, 0x00, 0xF2};
                 std::vector<uint8_t> vL = {'[', '#', 'L', 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xF3};
                 std::vector<uint8_t> vM = {'[', '$', 'M', '#', '[', 'I', 0x00, 0x20, 'M', 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x20, 0xFF, ']'};
+                std::vector<uint8_t> vMX = {'[', '$', 'U', '#', '[', 'M', 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 'U', 0x01, ']'};
 
                 json _;
                 CHECK_THROWS_WITH_AS(_ = json::from_bjdata(v1), "[json.exception.parse_error.113] parse error at byte 4: syntax error while parsing BJData size: count in an optimized container must be positive", json::parse_error&);
@@ -2651,8 +2652,17 @@ TEST_CASE("BJData")
 
 #if SIZE_MAX != 0xffffffff
                 CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vM), "[json.exception.out_of_range.408] syntax error while parsing BJData size: excessive ndarray size caused overflow", json::out_of_range&);
+#else
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vM), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
 #endif
                 CHECK(json::from_bjdata(vM, true, false).is_discarded());
+
+#if SIZE_MAX != 0xffffffff
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vMX), "[json.exception.out_of_range.408] syntax error while parsing BJData size: excessive ndarray size caused overflow", json::out_of_range&);
+#else
+                CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vMX), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
+#endif
+                CHECK(json::from_bjdata(vMX, true, false).is_discarded());
             }
 
             SECTION("optimized array: integer value overflow")
@@ -2663,10 +2673,12 @@ TEST_CASE("BJData")
                 json _;
 #if SIZE_MAX == 0xffffffff
                 CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vL), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
+                CHECK(json::from_bjdata(vL, true, false).is_discarded());
 #endif
 
 #if SIZE_MAX == 0xffffffff
                 CHECK_THROWS_WITH_AS(_ = json::from_bjdata(vM), "[json.exception.out_of_range.408] syntax error while parsing BJData size: integer value overflow", json::out_of_range&);
+                CHECK(json::from_bjdata(vM, true, false).is_discarded());
 #endif
             }
 

From 87cda1d6646592ac5866dc703c8e1839046a6806 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=83=91=E5=B0=91=E9=94=9F?= <Mango@Live.cn>
Date: Sun, 19 Jun 2022 01:14:03 +0800
Subject: [PATCH 30/30] Use `std::iterator_traits` to extract
 `iterator_category` (#3544)

* Use `std::iterator_traits` to extract `iterator_category`

In third-party STL implementations, `array_t::iterator` might be a pointer (e.g., `vector` in [EASTL](https://github.com/electronicarts/EASTL)) rather than a class, in which case directly using `array_t::iterator::iterator_category` is invalid. This commit fixes it with `std::iterator_traits`, which handles pointers correctly.

* add the changes to the single-header version
---
 include/nlohmann/detail/iterators/iter_impl.hpp | 2 +-
 single_include/nlohmann/json.hpp                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/include/nlohmann/detail/iterators/iter_impl.hpp b/include/nlohmann/detail/iterators/iter_impl.hpp
index 81c61b3e0..028de4047 100644
--- a/include/nlohmann/detail/iterators/iter_impl.hpp
+++ b/include/nlohmann/detail/iterators/iter_impl.hpp
@@ -53,7 +53,7 @@ class iter_impl // NOLINT(cppcoreguidelines-special-member-functions,hicpp-speci
                   "iter_impl only accepts (const) basic_json");
     // superficial check for the LegacyBidirectionalIterator named requirement
     static_assert(std::is_base_of<std::bidirectional_iterator_tag, std::bidirectional_iterator_tag>::value
-                  &&  std::is_base_of<std::bidirectional_iterator_tag, typename array_t::iterator::iterator_category>::value,
+                  &&  std::is_base_of<std::bidirectional_iterator_tag, typename std::iterator_traits<typename array_t::iterator>::iterator_category>::value,
                   "basic_json iterator assumes array and object type iterators satisfy the LegacyBidirectionalIterator named requirement.");
 
   public:
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index 834c6fc87..50e5c805c 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -12393,7 +12393,7 @@ class iter_impl // NOLINT(cppcoreguidelines-special-member-functions,hicpp-speci
                   "iter_impl only accepts (const) basic_json");
     // superficial check for the LegacyBidirectionalIterator named requirement
     static_assert(std::is_base_of<std::bidirectional_iterator_tag, std::bidirectional_iterator_tag>::value
-                  &&  std::is_base_of<std::bidirectional_iterator_tag, typename array_t::iterator::iterator_category>::value,
+                  &&  std::is_base_of<std::bidirectional_iterator_tag, typename std::iterator_traits<typename array_t::iterator>::iterator_category>::value,
                   "basic_json iterator assumes array and object type iterators satisfy the LegacyBidirectionalIterator named requirement.");
 
   public: