Merge branch 'release/3.11.0'
diff --git a/.clang-tidy b/.clang-tidy
index 30886d7..4d4238a 100644
--- a/.clang-tidy
+++ b/.clang-tidy
@@ -4,6 +4,7 @@
-altera-unroll-loops,
-android-cloexec-fopen,
-bugprone-easily-swappable-parameters,
+ -cert-err58-cpp,
-concurrency-mt-unsafe,
-cppcoreguidelines-avoid-goto,
-cppcoreguidelines-avoid-magic-numbers,
@@ -42,6 +43,7 @@
-readability-identifier-length,
-readability-magic-numbers,
-readability-redundant-access-specifiers,
+ -readability-simplify-boolean-expr,
-readability-uppercase-literal-suffix'
CheckOptions:
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/.github/ISSUE_TEMPLATE/Bug_report.md b/.github/ISSUE_TEMPLATE/Bug_report.md
deleted file mode 100644
index d0fbbdd..0000000
--- a/.github/ISSUE_TEMPLATE/Bug_report.md
+++ /dev/null
@@ -1,57 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ''
-labels: 'kind: bug'
-assignees: ''
-
----
-
-<!-- Provide a concise summary of the issue in the title above. -->
-
-#### What is the issue you have?
-
-<!-- Provide a detailed introduction to the issue itself, and why you consider it to be a bug. -->
-<!-- If possible, be specific and add stack traces, error messages, etc. Avoid vague terms like "crash" or "doesn't work". -->
-
-#### Please describe the steps to reproduce the issue.
-
-<!-- Provide a link to a live example, or an unambiguous set of steps to -->
-<!-- reproduce this bug. Include code to reproduce, if relevant -->
-
-1.
-2.
-3.
-
-#### Can you provide a small but working code example?
-
-<!-- Please understand that we cannot analyze and debug large code bases. -->
-
-#### What is the expected behavior?
-
-<!-- Tell us what should happen -->
-
-#### And what is the actual behavior instead?
-
-<!-- Tell us what happens instead. -->
-
-#### Which compiler and operating system are you using?
-
-<!-- Include as many relevant details about the environment you experienced the bug in. -->
-<!-- Make sure you use a supported compiler, see https://github.com/nlohmann/json#supported-compilers. -->
-
-- Compiler: ___
-- Operating system: ___
-
-#### Which version of the library did you use?
-
-<!-- Please add an `x` to the respective line. -->
-
-- [ ] latest release version 3.10.5
-- [ ] other release - please state the version: ___
-- [ ] the `develop` branch
-
-#### If you experience a compilation error: can you [compile and run the unit tests](https://github.com/nlohmann/json#execute-unit-tests)?
-
-- [ ] yes
-- [ ] no - please copy/paste the error message below
diff --git a/.github/ISSUE_TEMPLATE/bug.yaml b/.github/ISSUE_TEMPLATE/bug.yaml
new file mode 100644
index 0000000..762b08e
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug.yaml
@@ -0,0 +1,93 @@
+name: Bug Report
+description: Create a bug report
+labels:
+ - 'kind: bug'
+body:
+ - type: markdown
+ attributes:
+ value: >
+ Thanks for taking the time to fill out this bug report!
+
+ Make sure you give it a short and specific **title** so that the report
+ is searchable and uniquely identifiable.
+
+ Note that this form is for bug reports only. Please
+ [open a discussion](https://github.com/nlohmann/json/discussions/new)
+ for questions, feature requests, or support requests
+ - type: textarea
+ id: summary
+ attributes:
+ label: Description
+ description: >
+ Please provide an abstract description of the issue to the developers,
+ and why you consider it to be a bug. Please include any specific links
+ to the documentation, JSON specification, or code.
+ validations:
+ required: true
+ - type: textarea
+ id: reproduce
+ attributes:
+ label: Reproduction steps
+ description: >
+ How do you trigger the bug? Please walk us through step by step. Be as
+ specific as possible.
+ validations:
+ required: true
+ - type: textarea
+ id: results
+ attributes:
+ label: Expected vs. actual results
+ description: >
+ Please describe what you expected to happen after the steps above and
+ what actually happened.
+ validations:
+ required: true
+ - type: textarea
+ id: code
+ attributes:
+ label: Minimal code example
+ description: >
+ If possible, provide a small and self-contained example that triggers
+ the bug. Please understand that we cannot analyze and debug large code
+ bases. Please do not paste screenshots here.
+ render: Shell
+ - type: textarea
+ id: output
+ attributes:
+ label: Error messages
+ description: >
+ Please provide any kind of error output (compilation errors, exception
+ messages, stack traces, etc.) which can help to diagnose the error.
+ render: Shell
+ - type: input
+ id: compiler
+ attributes:
+ label: Compiler and operating system
+ description: >
+ On which operating systems and compilers have you observed the issue?
+ Include as many relevant details about the environment you experienced
+ the bug in. Make sure you use a
+ [supported compiler](https://github.com/nlohmann/json#supported-compilers).
+ validations:
+ required: true
+ - type: input
+ id: version
+ attributes:
+ label: Library version
+ description: >
+ Which version of the library did you use? If it is a released version,
+ please enter the version number (e.g., 3.11.0). Otherwise, please enter
+ the commit hash. If you got the library from another source as the
+ GitHub repository (e.g., via a package manager), please also state
+ this.
+ validations:
+ required: true
+ - type: checkboxes
+ id: validation
+ attributes:
+ label: Validation
+ description: >
+ Please check these additional steps:
+ options:
+ - label: The bug also occurs if the latest version from the [`develop`](https://github.com/nlohmann/json/tree/develop) branch is used.
+ - label: I can successfully [compile and run the unit tests](https://github.com/nlohmann/json#execute-unit-tests).
diff --git a/.drone.yml b/.github/external_ci/.drone.yml
similarity index 96%
rename from .drone.yml
rename to .github/external_ci/.drone.yml
index 3cdefe4..0d9e3d0 100644
--- a/.drone.yml
+++ b/.github/external_ci/.drone.yml
@@ -18,5 +18,5 @@
- 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 94%
rename from appveyor.yml
rename to .github/external_ci/appveyor.yml
index b04ac24..0a7de68 100644
--- a/appveyor.yml
+++ b/.github/external_ci/appveyor.yml
@@ -66,15 +66,15 @@
- cmake . -G "%GENERATOR%" -A "%GENERATOR_PLATFORM%" -DCMAKE_CXX_FLAGS="%CXX_FLAGS%" -DCMAKE_IGNORE_PATH="C:/Program Files/Git/usr/bin" -DJSON_BuildTests=On "%CMAKE_OPTIONS%"
build_script:
- - cmake --build . --config "%configuration%"
+ - cmake --build . --config "%configuration%" --parallel 2
test_script:
- - if "%configuration%"=="Release" ctest -C "%configuration%" -V -j
+ - if "%configuration%"=="Release" ctest -C "%configuration%" --parallel 2 --output-on-failure
# On Debug builds, skip test-unicode_all
# as it is extremely slow to run and cause
# occasional timeouts on AppVeyor.
# More info: https://github.com/nlohmann/json/pull/1570
- - if "%configuration%"=="Debug" ctest --exclude-regex "test-unicode" -C "%configuration%" -V -j
+ - if "%configuration%"=="Debug" ctest --exclude-regex "test-unicode" -C "%configuration%" --parallel 2 --output-on-failure
# only build PRs and commits to develop branch
# (see https://help.appveyor.com/discussions/questions/55079-two-builds-per-commit-to-pull-request)
diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index 20275fe..1ba938c 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -9,6 +9,11 @@
pull_request:
schedule:
- cron: '0 19 * * 1'
+ workflow_dispatch:
+
+concurrency:
+ group: ${{ github.workflow }}-${{ github.ref || github.run_id }}
+ cancel-in-progress: true
jobs:
CodeQL-Build:
@@ -17,10 +22,10 @@
steps:
- name: Checkout repository
- uses: actions/checkout@v2
+ uses: actions/checkout@v3
with:
# We must fetch at least the immediate parents so that if this is
- # a pull request then we can checkout the head.
+ # a pull request then we can check out the head.
fetch-depth: 2
# If this run was triggered by a pull request event, then checkout
@@ -30,7 +35,7 @@
# Initializes the CodeQL tools for scanning.
- name: Initialize CodeQL
- uses: github/codeql-action/init@v1
+ uses: github/codeql-action/init@v2
# Override language selection by uncommenting this and choosing your languages
# with:
# languages: go, javascript, csharp, python, cpp, java
@@ -38,7 +43,7 @@
# Autobuild attempts to build any compiled languages (C/C++, C#, or Java).
# If this step fails, then you should remove it and run the build manually (see below)
- name: Autobuild
- uses: github/codeql-action/autobuild@v1
+ uses: github/codeql-action/autobuild@v2
# âšī¸ Command-line programs to run using the OS shell.
# đ https://git.io/JvXDl
@@ -52,4 +57,4 @@
# make release
- name: Perform CodeQL Analysis
- uses: github/codeql-action/analyze@v1
+ uses: github/codeql-action/analyze@v2
diff --git a/.github/workflows/macos.yml b/.github/workflows/macos.yml
index f653e2b..85b1b70 100644
--- a/.github/workflows/macos.yml
+++ b/.github/workflows/macos.yml
@@ -7,9 +7,14 @@
- master
- release/*
pull_request:
+ workflow_dispatch:
+
+concurrency:
+ group: ${{ github.workflow }}-${{ github.ref || github.run_id }}
+ cancel-in-progress: true
jobs:
- xcode:
+ xcode_1:
runs-on: macos-10.15
strategy:
matrix:
@@ -18,7 +23,24 @@
DEVELOPER_DIR: /Applications/Xcode_${{ matrix.xcode }}.app/Contents/Developer
steps:
- - uses: actions/checkout@v2
+ - 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_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
@@ -27,7 +49,7 @@
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]
@@ -35,9 +57,9 @@
DEVELOPER_DIR: /Applications/Xcode_12.4.app/Contents/Developer
steps:
- - uses: actions/checkout@v2
+ - uses: actions/checkout@v3
- name: cmake
- run: cmake -S . -B build -D CMAKE_BUILD_TYPE=Debug -DJSON_BuildTests=On -DCMAKE_CXX_STANDARD=${{ matrix.standard }} -DCMAKE_CXX_STANDARD_REQUIRED=ON
+ run: cmake -S . -B build -D CMAKE_BUILD_TYPE=Debug -DJSON_BuildTests=On -DJSON_TestStandards=${{ matrix.standard }}
- name: build
run: cmake --build build --parallel 10
- name: test
diff --git a/.github/workflows/ubuntu.yml b/.github/workflows/ubuntu.yml
index eb54400..1b477c9 100644
--- a/.github/workflows/ubuntu.yml
+++ b/.github/workflows/ubuntu.yml
@@ -7,13 +7,18 @@
- master
- release/*
pull_request:
+ workflow_dispatch:
+
+concurrency:
+ group: ${{ github.workflow }}-${{ github.ref || github.run_id }}
+ cancel-in-progress: true
jobs:
ci_test_clang:
runs-on: ubuntu-latest
- container: ghcr.io/nlohmann/json-ci:v2.2.0
+ container: ghcr.io/nlohmann/json-ci:v2.4.0
steps:
- - uses: actions/checkout@v2
+ - uses: actions/checkout@v3
- name: cmake
run: cmake -S . -B build -DJSON_CI=On
- name: build
@@ -21,9 +26,9 @@
ci_test_gcc:
runs-on: ubuntu-latest
- container: ghcr.io/nlohmann/json-ci:v2.2.0
+ container: ghcr.io/nlohmann/json-ci:v2.4.0
steps:
- - uses: actions/checkout@v2
+ - uses: actions/checkout@v3
- name: cmake
run: cmake -S . -B build -DJSON_CI=On
- name: build
@@ -31,25 +36,35 @@
ci_static_analysis:
runs-on: ubuntu-latest
- container: ghcr.io/nlohmann/json-ci:v2.2.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]
steps:
- - uses: actions/checkout@v2
+ - uses: actions/checkout@v3
- name: cmake
run: cmake -S . -B build -DJSON_CI=On
- 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.2.0
+ container: ghcr.io/nlohmann/json-ci:v2.4.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@v2
+ - uses: actions/checkout@v3
- name: cmake
run: cmake -S . -B build -DJSON_CI=On
- name: build
@@ -57,15 +72,15 @@
ci_test_coverage:
runs-on: ubuntu-latest
- container: ghcr.io/nlohmann/json-ci:v2.2.0
+ container: ghcr.io/nlohmann/json-ci:v2.4.0
steps:
- - uses: actions/checkout@v2
+ - uses: actions/checkout@v3
- name: cmake
run: cmake -S . -B build -DJSON_CI=On
- name: build
run: cmake --build build --target ci_test_coverage
- name: archive coverage report
- uses: actions/upload-artifact@v2
+ uses: actions/upload-artifact@v3
with:
name: code-coverage-report
path: /__w/json/json/build/html
@@ -77,12 +92,12 @@
ci_test_compilers:
runs-on: ubuntu-latest
- container: ghcr.io/nlohmann/json-ci:v2.2.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]
+ 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@v2
+ - uses: actions/checkout@v3
- name: cmake
run: cmake -S . -B build -DJSON_CI=On
- name: build
@@ -90,13 +105,13 @@
ci_test_standards:
runs-on: ubuntu-latest
- container: ghcr.io/nlohmann/json-ci:v2.2.0
+ container: ghcr.io/nlohmann/json-ci:v2.4.0
strategy:
matrix:
standard: [11, 14, 17, 20]
compiler: [gcc, clang]
steps:
- - uses: actions/checkout@v2
+ - uses: actions/checkout@v3
- name: cmake
run: cmake -S . -B build -DJSON_CI=On
- name: build
@@ -104,10 +119,40 @@
ci_cuda_example:
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_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: cmake --build build --target ci_cuda_example
+ run: |
+ . /opt/intel/oneapi/setvars.sh
+ cmake --build build --target ci_icpc
+ ci_reuse_compliance:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v3
+ - uses: actions/setup-python@v3
+ - name: install REUSE tool
+ run: python -m pip install reuse
+ - name: REUSE lint
+ run: reuse lint
+
+ ci_test_documentation:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v3
+ - name: cmake
+ run: cmake -S . -B build -DJSON_CI=On
+ - name: build
+ run: cmake --build build --target ci_test_documentation
diff --git a/.github/workflows/windows.yml b/.github/workflows/windows.yml
index 597da47..0fd723c 100644
--- a/.github/workflows/windows.yml
+++ b/.github/workflows/windows.yml
@@ -7,6 +7,11 @@
- master
- release/*
pull_request:
+ workflow_dispatch:
+
+concurrency:
+ group: ${{ github.workflow }}-${{ github.ref || github.run_id }}
+ cancel-in-progress: true
jobs:
mingw:
@@ -16,11 +21,32 @@
architecture: [x64, x86]
steps:
- - uses: actions/checkout@v2
- - name: Set up MinGW
- uses: egor-tensin/setup-mingw@v2
- with:
- platform: ${{ matrix.architecture }}
+ - uses: actions/checkout@v3
+ - name: Download MinGW 8.1.0
+ run: |
+ $headers = @{Authorization = 'Bearer ${{ secrets.GITHUB_TOKEN }}'}
+ $uri = 'https://nuget.pkg.github.com/falbrechtskirchinger/download/mingw/8.1.0/mingw.8.1.0.nupkg'
+ Invoke-WebRequest -Uri $uri -Headers $headers -OutFile mingw.8.1.0.nupkg
+ - name: Uninstall MinGW
+ continue-on-error: true
+ run: choco uninstall mingw
+ # Based on egor-tensin/setup-mingw
+ - name: Install MinGW 8.1.0
+ run: |
+ choco install mingw.8.1.0.nupkg ${{ matrix.architecture == 'x86' && '--x86' || '' }}
+ $prefix = "${{ matrix.architecture == 'x64' && 'x86_64-w64-mingw32' || 'i686-w64-mingw32' }}"
+ $mingw = "${{ matrix.architecture == 'x64' && 'mingw64' || 'mingw32' }}"
+ $mingw_install = Join-Path C: ProgramData chocolatey lib mingw tools install
+ $mingw_root = Join-Path $mingw_install $mingw
+ $mingw_bin = Join-Path $mingw_root bin
+ $mingw_lib = Join-Path $mingw_root $prefix lib
+ echo $mingw_bin >> $env:GITHUB_PATH
+ Remove-Item (Join-Path $mingw_lib 'libpthread.dll.a')
+ Remove-Item (Join-Path $mingw_lib 'libwinpthread.dll.a')
+ #- name: Set up MinGW
+ # uses: egor-tensin/setup-mingw@v2
+ # with:
+ # platform: ${{ matrix.architecture }}
- name: cmake
run: cmake -S . -B build -G "MinGW Makefiles" -DCMAKE_BUILD_TYPE=Debug -DJSON_BuildTests=On
- name: build
@@ -28,50 +54,15 @@
- name: test
run: cd build ; ctest -j 10 -C Debug --output-on-failure
- msvc2017:
- runs-on: windows-2016
- strategy:
- matrix:
- build_type: [Debug, Release]
- architecture: [Win32, x64]
-
- steps:
- - uses: actions/checkout@v2
- - name: cmake
- run: cmake -S . -B build -G "Visual Studio 15 2017" -A ${{ matrix.architecture }} -DJSON_BuildTests=On -DCMAKE_CXX_FLAGS="/W4 /WX"
- if: matrix.build_type == 'Release' && matrix.architecture == 'x64'
- - name: cmake
- run: cmake -S . -B build -G "Visual Studio 15 2017" -A ${{ matrix.architecture }} -DJSON_BuildTests=On -DCMAKE_CXX_FLAGS="/W4 /WX"
- if: matrix.build_type == 'Release' && matrix.architecture != 'x64'
- - name: cmake
- run: cmake -S . -B build -G "Visual Studio 15 2017" -A ${{ matrix.architecture }} -DJSON_BuildTests=On -DJSON_FastTests=ON -DCMAKE_CXX_FLAGS="/W4 /WX"
- if: matrix.build_type == 'Debug'
- - name: build
- run: cmake --build build --config ${{ matrix.build_type }} --parallel 10
- - name: test
- run: cd build ; ctest -j 10 -C ${{ matrix.build_type }} --output-on-failure
-
- msvc2017_latest:
- runs-on: windows-2016
-
- steps:
- - uses: actions/checkout@v2
- - name: cmake
- run: cmake -S . -B build -G "Visual Studio 15 2017" -DJSON_BuildTests=On -DCMAKE_CXX_FLAGS="/permissive- /std:c++latest /utf-8 /W4 /WX"
- - name: build
- run: cmake --build build --config Release --parallel 10
- - name: test
- run: cd build ; ctest -j 10 -C Release --output-on-failure
-
msvc2019:
- runs-on: windows-latest
+ runs-on: windows-2019
strategy:
matrix:
build_type: [Debug, Release]
architecture: [Win32, x64]
steps:
- - uses: actions/checkout@v2
+ - uses: actions/checkout@v3
- name: cmake
run: cmake -S . -B build -G "Visual Studio 16 2019" -A ${{ matrix.architecture }} -DJSON_BuildTests=On -DCMAKE_CXX_FLAGS="/W4 /WX"
if: matrix.build_type == 'Release'
@@ -84,10 +75,10 @@
run: cd build ; ctest -j 10 -C ${{ matrix.build_type }} --output-on-failure
msvc2019_latest:
- runs-on: windows-latest
+ runs-on: windows-2019
steps:
- - uses: actions/checkout@v2
+ - uses: actions/checkout@v3
- name: cmake
run: cmake -S . -B build -G "Visual Studio 16 2019" -DJSON_BuildTests=On -DCMAKE_CXX_FLAGS="/permissive- /std:c++latest /utf-8 /W4 /WX"
- name: build
@@ -95,14 +86,46 @@
- name: test
run: cd build ; ctest -j 10 -C Release --output-on-failure
+ msvc2022:
+ runs-on: windows-2022
+ strategy:
+ matrix:
+ build_type: [Debug, Release]
+ architecture: [Win32, x64]
+
+ steps:
+ - uses: actions/checkout@v3
+ - name: cmake
+ run: cmake -S . -B build -G "Visual Studio 17 2022" -A ${{ matrix.architecture }} -DJSON_BuildTests=On -DCMAKE_CXX_FLAGS="/W4 /WX"
+ if: matrix.build_type == 'Release'
+ - name: cmake
+ run: cmake -S . -B build -G "Visual Studio 17 2022" -A ${{ matrix.architecture }} -DJSON_BuildTests=On -DJSON_FastTests=ON -DCMAKE_CXX_FLAGS="/W4 /WX"
+ if: matrix.build_type == 'Debug'
+ - name: build
+ run: cmake --build build --config ${{ matrix.build_type }} --parallel 10
+ - name: test
+ run: cd build ; ctest -j 10 -C ${{ matrix.build_type }} --output-on-failure
+
+ msvc2022_latest:
+ runs-on: windows-2022
+
+ steps:
+ - uses: actions/checkout@v3
+ - name: cmake
+ run: cmake -S . -B build -G "Visual Studio 17 2022" -DJSON_BuildTests=On -DCMAKE_CXX_FLAGS="/permissive- /std:c++latest /utf-8 /W4 /WX"
+ - name: build
+ run: cmake --build build --config Release --parallel 10
+ - name: test
+ run: cd build ; ctest -j 10 -C Release --output-on-failure
+
clang:
- runs-on: windows-latest
+ runs-on: windows-2019
strategy:
matrix:
version: [11, 12]
steps:
- - uses: actions/checkout@v2
+ - uses: actions/checkout@v3
- name: install Clang
run: curl -fsSL -o LLVM${{ matrix.version }}.exe https://github.com/llvm/llvm-project/releases/download/llvmorg-${{ matrix.version }}.0.0/LLVM-${{ matrix.version }}.0.0-win64.exe ; 7z x LLVM${{ matrix.version }}.exe -y -o"C:/Program Files/LLVM"
- name: cmake
@@ -113,13 +136,13 @@
run: cd build ; ctest -j 10 -C Debug --exclude-regex "test-unicode" --output-on-failure
clang-cl-11:
- runs-on: windows-latest
+ runs-on: windows-2019
strategy:
matrix:
architecture: [Win32, x64]
steps:
- - uses: actions/checkout@v2
+ - uses: actions/checkout@v3
- name: cmake
run: cmake -S . -B build -G "Visual Studio 16 2019" -A ${{ matrix.architecture }} -T ClangCL -DJSON_BuildTests=On
- name: build
diff --git a/.gitignore b/.gitignore
index a13ad89..30b62bf 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,32 +1,41 @@
-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
+# Visual Studio / Visual Studio Code
+/.vs/
+/.vscode/
+/out/
-doc/html
-doc/mkdocs/venv/
-doc/mkdocs/docs/examples
-doc/mkdocs/site
-doc/mkdocs/docs/__pycache__/
-/doc/docset/JSON_for_Modern_C++.docset/
-/doc/docset/JSON_for_Modern_C++.tgz
+# clangd cache
+/.cache/
+
+# build directories (vscode-cmake-tools, user-defined, ...)
+/build*/
+
+# fuzzers
+/tests/corpus_*
+/tests/parse_*_fuzzer
+
+# documentation
+/docs/docset/docSet.dsidx
+/docs/docset/JSON_for_Modern_C++.docset/
+/docs/docset/JSON_for_Modern_C++.tgz
+/docs/mkdocs/docs/__pycache__/
+/docs/mkdocs/docs/examples/
+/docs/mkdocs/docs/images/json.gif
+/docs/mkdocs/site/
+/docs/mkdocs/venv/
+
+# serve_header
+/localhost.pem
+/localhost-key.pem
+/serve_header.yml
diff --git a/.reuse/README.md b/.reuse/README.md
new file mode 100644
index 0000000..29c2b67
--- /dev/null
+++ b/.reuse/README.md
@@ -0,0 +1,7 @@
+# REUSE Software
+
+This directory contains supporting files to make the project compliant with the REUSE specification.
+
+The root `Makefile` contains a target `reuse` that updates copyright headers and checks for compliance.
+
+See <http://reuse.software> for more information.
diff --git a/.reuse/dep5 b/.reuse/dep5
new file mode 100644
index 0000000..610b876
--- /dev/null
+++ b/.reuse/dep5
@@ -0,0 +1,36 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: json
+Upstream-Contact: Niels Lohmann <mail@nlohmann.me>
+Source: https://github.com/nlohmann/json
+
+Files: *
+Copyright: 2013-2022 Niels Lohmann <https://nlohmann.me>
+License: MIT
+
+Files: tests/thirdparty/doctest/*
+Copyright: 2016-2021 Viktor Kirilov
+License: MIT
+
+Files: tests/thirdparty/fifo_map/*
+Copyright: 2015-2017 Niels Lohmann
+License: MIT
+
+Files: tests/thirdparty/Fuzzer/*
+Copyright: 2003-2022, LLVM Project.
+License: Apache-2.0
+
+Files: tests/thirdparty/imapdl/*
+Copyright: 2017 Georg Sauthoff <mail@gms.tf>
+License: GPL-3.0-only
+
+Files: tools/amalgamate/*
+Copyright: 2012 Erik Edlund <erik.edlund@32767.se>
+License: BSD-3-Clause
+
+Files: tools/cpplint/*
+Copyright: 2009 Google Inc. All rights reserved.
+License: BSD-3-Clause
+
+Files: tools/gdb_pretty_printer
+Copyright: 2020 Hannes Domani <https://github.com/ssbssa>
+License: MIT
diff --git a/.reuse/templates/json.jinja2 b/.reuse/templates/json.jinja2
new file mode 100644
index 0000000..4e85ec2
--- /dev/null
+++ b/.reuse/templates/json.jinja2
@@ -0,0 +1,11 @@
+ __ _____ _____ _____
+ __| | __| | | | JSON for Modern C++
+| | |__ | | | | | | version 3.11.0
+|_____|_____|_____|_|___| https://github.com/nlohmann/json
+
+{% for copyright_line in copyright_lines %}
+{{ copyright_line }}
+{% endfor %}
+{% for expression in spdx_expressions %}
+SPDX-License-Identifier: {{ expression }}
+{% endfor %}
diff --git a/.reuse/templates/json_support.jinja2 b/.reuse/templates/json_support.jinja2
new file mode 100644
index 0000000..3df9435
--- /dev/null
+++ b/.reuse/templates/json_support.jinja2
@@ -0,0 +1,11 @@
+ __ _____ _____ _____
+ __| | __| | | | JSON for Modern C++ (supporting code)
+| | |__ | | | | | | version 3.11.0
+|_____|_____|_____|_|___| https://github.com/nlohmann/json
+
+{% for copyright_line in copyright_lines %}
+{{ copyright_line }}
+{% endfor %}
+{% for expression in spdx_expressions %}
+SPDX-License-Identifier: {{ expression }}
+{% endfor %}
diff --git a/CITATION.cff b/CITATION.cff
index 7c28d04..7f3cff5 100644
--- a/CITATION.cff
+++ b/CITATION.cff
@@ -1,14 +1,14 @@
-cff-version: 1.1.0
+cff-version: 1.2.0
message: "If you use this software, please cite it as below."
-authors:
+authors:
- family-names: Lohmann
given-names: Niels
orcid: https://orcid.org/0000-0001-9037-795X
email: mail@nlohmann.me
website: https://nlohmann.me
title: "JSON for Modern C++"
-version: 3.10.5
-date-released: 2022
+version: 3.11.0
+date-released: 2022-01-03
license: MIT
repository-code: "https://github.com/nlohmann"
url: https://json.nlohmann.me
diff --git a/CMakeLists.txt b/CMakeLists.txt
index b93c6e4..1945b2c 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -4,7 +4,7 @@
## PROJECT
## name and version
##
-project(nlohmann_json VERSION 3.10.5 LANGUAGES CXX)
+project(nlohmann_json VERSION 3.11.0 LANGUAGES CXX)
##
## MAIN_PROJECT CHECK
@@ -19,6 +19,7 @@
## INCLUDE
##
##
+set(CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake ${CMAKE_MODULE_PATH})
include(ExternalProject)
##
@@ -30,16 +31,25 @@
cmake_policy(SET CMP0077 NEW)
endif ()
-option(JSON_BuildTests "Build the unit tests when BUILD_TESTING is enabled." ${MAIN_PROJECT})
-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)
+# VERSION_GREATER_EQUAL is not available in CMake 3.1
+if(${MAIN_PROJECT} AND (${CMAKE_VERSION} VERSION_EQUAL 3.13 OR ${CMAKE_VERSION} VERSION_GREATER 3.13))
+ set(JSON_BuildTests_INIT ON)
+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_GlobalUDLs "Place use-defined string literals in the global namespace." ON)
+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)
+option(JSON_SystemInclude "Include as system headers (skip for clang-tidy)." OFF)
if (JSON_CI)
- include(cmake/ci.cmake)
+ include(ci)
endif ()
##
@@ -48,7 +58,7 @@
include(GNUInstallDirs)
set(NLOHMANN_JSON_TARGET_NAME ${PROJECT_NAME})
-set(NLOHMANN_JSON_CONFIG_INSTALL_DIR "${CMAKE_INSTALL_LIBDIR}/cmake/${PROJECT_NAME}" CACHE INTERNAL "")
+set(NLOHMANN_JSON_CONFIG_INSTALL_DIR "${CMAKE_INSTALL_DATADIR}/cmake/${PROJECT_NAME}" CACHE INTERNAL "")
set(NLOHMANN_JSON_INCLUDE_INSTALL_DIR "${CMAKE_INSTALL_INCLUDEDIR}")
set(NLOHMANN_JSON_TARGETS_EXPORT_NAME "${PROJECT_NAME}Targets")
set(NLOHMANN_JSON_CMAKE_CONFIG_TEMPLATE "cmake/config.cmake.in")
@@ -56,7 +66,7 @@
set(NLOHMANN_JSON_CMAKE_VERSION_CONFIG_FILE "${NLOHMANN_JSON_CMAKE_CONFIG_DIR}/${PROJECT_NAME}ConfigVersion.cmake")
set(NLOHMANN_JSON_CMAKE_PROJECT_CONFIG_FILE "${NLOHMANN_JSON_CMAKE_CONFIG_DIR}/${PROJECT_NAME}Config.cmake")
set(NLOHMANN_JSON_CMAKE_PROJECT_TARGETS_FILE "${NLOHMANN_JSON_CMAKE_CONFIG_DIR}/${PROJECT_NAME}Targets.cmake")
-set(NLOHMANN_JSON_PKGCONFIG_INSTALL_DIR "${CMAKE_INSTALL_LIBDIR}/pkgconfig")
+set(NLOHMANN_JSON_PKGCONFIG_INSTALL_DIR "${CMAKE_INSTALL_DATADIR}/pkgconfig")
if (JSON_MultipleHeaders)
set(NLOHMANN_JSON_INCLUDE_BUILD_DIR "${PROJECT_SOURCE_DIR}/include/")
@@ -70,6 +80,14 @@
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()
+
if (JSON_Diagnostics)
message(STATUS "Diagnostics enabled")
endif()
@@ -93,8 +111,11 @@
target_compile_definitions(
${NLOHMANN_JSON_TARGET_NAME}
INTERFACE
- JSON_USE_IMPLICIT_CONVERSIONS=$<BOOL:${JSON_ImplicitConversions}>
- JSON_DIAGNOSTICS=$<BOOL:${JSON_Diagnostics}>
+ $<$<NOT:$<BOOL:${JSON_GlobalUDLs}>>:JSON_USE_GLOBAL_UDLS=0>
+ $<$<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>
)
target_include_directories(
@@ -129,7 +150,7 @@
if (JSON_BuildTests)
include(CTest)
enable_testing()
- add_subdirectory(test)
+ add_subdirectory(tests)
endif()
##
diff --git a/ChangeLog.md b/ChangeLog.md
index 9a92b9f..1d7f8ca 100644
--- a/ChangeLog.md
+++ b/ChangeLog.md
@@ -1,9 +1,228 @@
# Changelog
All notable changes to this project will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org/).
-## [3.10.5](https://github.com/nlohmann/json/releases/tag/3.10.5) (2022-01-02)
+## [3.11.0](https://github.com/nlohmann/json/releases/tag/3.11.0) (2022-07-31)
-[Full Changelog](https://github.com/nlohmann/json/compare/v3.10.4...3.10.5)
+[Full Changelog](https://github.com/nlohmann/json/compare/v3.10.5...3.11.0)
+
+- ICPC: warning \#1098: the qualifier on this friend declaration is ignored [\#3632](https://github.com/nlohmann/json/issues/3632)
+- Starting with 3.10.4, just adding `\#include json.hpp` causes compile error: `overload resolution selected deleted operator '=' [\#3620](https://github.com/nlohmann/json/issues/3620)
+- xwidgets doesn't compile with version \>3.10.3 [\#3602](https://github.com/nlohmann/json/issues/3602)
+- json\_pointer\_\_pop\_back.cpp example does not compile [\#3600](https://github.com/nlohmann/json/issues/3600)
+- nlohmann::json::array 'push\_back' is ambiguous [\#3589](https://github.com/nlohmann/json/issues/3589)
+- Multiple versions causing conflict [\#3588](https://github.com/nlohmann/json/issues/3588)
+- ERROR: ThreadSanitizer: SEGV on unknown address [\#3584](https://github.com/nlohmann/json/issues/3584)
+- unicode4 test consistently fails on RISC-V hardware [\#3579](https://github.com/nlohmann/json/issues/3579)
+- sax\_parse\(iterator, json\_sax\_t \*\) string callback clobbers spaces [\#3574](https://github.com/nlohmann/json/issues/3574)
+- Nlohmann JSON Parse crash with raylib-cpp [\#3570](https://github.com/nlohmann/json/issues/3570)
+- ordered\_json doesn't accept keys of types other than string\_t \(e.g., string\_view\) [\#3558](https://github.com/nlohmann/json/issues/3558)
+- turning an object into an array [\#3547](https://github.com/nlohmann/json/issues/3547)
+- json:parse\_bjdata\_fuzzer: ASSERT: ref\_stack.back\(\)-\>is\_array\(\) [\#3541](https://github.com/nlohmann/json/issues/3541)
+- Warning about potential null dereference in GCC 12.1 \(Fedora 36\) [\#3525](https://github.com/nlohmann/json/issues/3525)
+- Enable 32bit unit test in CI [\#3524](https://github.com/nlohmann/json/issues/3524)
+- Error when roundtripping BJData [\#3519](https://github.com/nlohmann/json/issues/3519)
+- ASSERT error while parsing BJData [\#3513](https://github.com/nlohmann/json/issues/3513)
+- An exception occurred when sending a string with double quotes [\#3504](https://github.com/nlohmann/json/issues/3504)
+- Binary reader for BJData creates incorrect SAX events [\#3503](https://github.com/nlohmann/json/issues/3503)
+- It can't support "nan", "inf", "-inf" for float type [\#3494](https://github.com/nlohmann/json/issues/3494)
+- ASAN error while parsing BJData \(Heap-buffer-overflow READ 1\) [\#3492](https://github.com/nlohmann/json/issues/3492)
+- UBSAN error while parsing BJData \(Null-dereference\) [\#3491](https://github.com/nlohmann/json/issues/3491)
+- UBSAN error while parsing BJData \(Invalid-bool-value\) [\#3490](https://github.com/nlohmann/json/issues/3490)
+- json:parse\_bjdata\_fuzzer reaches assertion [\#3475](https://github.com/nlohmann/json/issues/3475)
+- Compilation with -fmodules-ts and use inside of a module [\#3472](https://github.com/nlohmann/json/issues/3472)
+- json.exception.parse\_error.101 only occurs outside of IDE [\#3467](https://github.com/nlohmann/json/issues/3467)
+- json:parse\_bjdata\_fuzzer reaches assertion [\#3461](https://github.com/nlohmann/json/issues/3461)
+- NLOHMANN\_DEFINE\_TYPE\_NON\_INTRUSIVE\_WITH\_DEFAULT can not parse { "key" : null} [\#3458](https://github.com/nlohmann/json/issues/3458)
+- Unable to compile when using Microsoft's \_CRTDBG [\#3457](https://github.com/nlohmann/json/issues/3457)
+- Compilation errors when including `<filesystem>` and using `--std=c++17` or above \(MinGW/Win10\) [\#3449](https://github.com/nlohmann/json/issues/3449)
+- Weird things on for statement [\#3447](https://github.com/nlohmann/json/issues/3447)
+- Parsing error when there is a json string within a Json [\#3445](https://github.com/nlohmann/json/issues/3445)
+- ordered\_json vs json types comparison [\#3443](https://github.com/nlohmann/json/issues/3443)
+- Error occurred when converting nlohmann::json to std::any [\#3428](https://github.com/nlohmann/json/issues/3428)
+- I was forced to report an assertion error when copying an array of strings [\#3419](https://github.com/nlohmann/json/issues/3419)
+- About Serialization Error invalid UTF-8 byte at index [\#3414](https://github.com/nlohmann/json/issues/3414)
+- Comparison of NaN differs between json and float [\#3409](https://github.com/nlohmann/json/issues/3409)
+- when i use it in C++ sserver,it it constantly show that fatal error: adl\_serializer.hpp: No such file or directory [\#3404](https://github.com/nlohmann/json/issues/3404)
+- parse error [\#3403](https://github.com/nlohmann/json/issues/3403)
+- CMake script MAIN\_PROJECT always OFF [\#3390](https://github.com/nlohmann/json/issues/3390)
+- Parser unable to handle large floating point numbers [\#3389](https://github.com/nlohmann/json/issues/3389)
+- Compilation error if json\_pointer is used with alternative string type [\#3388](https://github.com/nlohmann/json/issues/3388)
+- Unit tests conversions & items fail to build \(Clang \<4.0/C++14 only\) [\#3384](https://github.com/nlohmann/json/issues/3384)
+- Regression test for \#3070 is not being run and fails when enabled [\#3377](https://github.com/nlohmann/json/issues/3377)
+- Refactor unit tests to use more convenient doctest assertion macros [\#3365](https://github.com/nlohmann/json/issues/3365)
+- An json.h issue reported in a static code analyzer [\#3361](https://github.com/nlohmann/json/issues/3361)
+- Mixing different JSON\_DIAGNOSTICS settings in separately compiled units leads to core [\#3360](https://github.com/nlohmann/json/issues/3360)
+- json::out\_of\_range exception matches against lot of others while testing [\#3352](https://github.com/nlohmann/json/issues/3352)
+- use mipsel-openwrt-linux-g++ -std=c++11 to compile, it has some errors "error: 'snprintf' is not a member of 'std'" [\#3349](https://github.com/nlohmann/json/issues/3349)
+- Add proper issue templates [\#3348](https://github.com/nlohmann/json/issues/3348)
+- switch from json to ordered\_json [\#3343](https://github.com/nlohmann/json/issues/3343)
+- Json dump use to compilation errors [\#3339](https://github.com/nlohmann/json/issues/3339)
+- Ambiguous conversion from nlohmann::basic\_json\<\> to custom class. [\#3333](https://github.com/nlohmann/json/issues/3333)
+- Iterator doesn't satisfy std::incrementable because post-increment may change constness [\#3331](https://github.com/nlohmann/json/issues/3331)
+- Inconsistent handling of floating point numbers after parse\(\) [\#3329](https://github.com/nlohmann/json/issues/3329)
+- Documentation for `ordered_json` should show proper use of the `parse()` function. [\#3325](https://github.com/nlohmann/json/issues/3325)
+- "type must be boolean, but is object" error thrown on non-boolean object [\#3319](https://github.com/nlohmann/json/issues/3319)
+- Incomplete Type in request parms [\#3318](https://github.com/nlohmann/json/issues/3318)
+- å°įąŗ MIX4 MIUI13 bug [\#3316](https://github.com/nlohmann/json/issues/3316)
+- json.exception.parse\_error.101 when parsing data received over a socket [\#3313](https://github.com/nlohmann/json/issues/3313)
+- Parse to custom class from unordered\_json breaks on G++11.2.0 with C++20 [\#3312](https://github.com/nlohmann/json/issues/3312)
+- try to assign dumped string to a class member varible [\#3300](https://github.com/nlohmann/json/issues/3300)
+- includedir in pkgconfig is error if install\_headers\(\) has subdir argument. [\#3284](https://github.com/nlohmann/json/issues/3284)
+- SHA-256 sum of json-3.10.5.tar.xz changes over time \(but not the content itself\) [\#3281](https://github.com/nlohmann/json/issues/3281)
+- items\(\) method does not follow order of json message [\#3278](https://github.com/nlohmann/json/issues/3278)
+- Perplexing template deduction failure serialising a 3rd party type using base class [\#3267](https://github.com/nlohmann/json/issues/3267)
+- json.hpp 'isfinite' is not a member of 'std' also isinf; snprintf; stoull and to\_string members of std [\#3263](https://github.com/nlohmann/json/issues/3263)
+- JSON build fails for C++ cmake [\#3256](https://github.com/nlohmann/json/issues/3256)
+- Unexpected implicit conversion [\#3254](https://github.com/nlohmann/json/issues/3254)
+- Add a function that checks for valid json in a C++ string [\#3245](https://github.com/nlohmann/json/issues/3245)
+- Replace use of standard IO from error handling [\#3239](https://github.com/nlohmann/json/issues/3239)
+- Use Catch for unit tests [\#3232](https://github.com/nlohmann/json/issues/3232)
+- Exception thrown during initialization causes a memory leak [\#3215](https://github.com/nlohmann/json/issues/3215)
+- Tests failing when compiling with c++20 [\#3207](https://github.com/nlohmann/json/issues/3207)
+- ambiguous regression [\#3204](https://github.com/nlohmann/json/issues/3204)
+- Deserialization: if class is\_constructible from std::string wrong from\_json overload is being selected, compilation failed [\#3171](https://github.com/nlohmann/json/issues/3171)
+- 'clang++ ./json.hpp' with no usage: Compiler syntax problem in clang 3.7.0 \(tizen :/ \) [\#3153](https://github.com/nlohmann/json/issues/3153)
+- build failure on upcoming gcc-12: test/src/unit-regression1.cpp:392:22: error: ambiguous overload for 'operator=' [\#3138](https://github.com/nlohmann/json/issues/3138)
+- Applying JSON patch creates parent object [\#3134](https://github.com/nlohmann/json/issues/3134)
+- Iterators cannot be used with range-v3 [\#3130](https://github.com/nlohmann/json/issues/3130)
+- std::shared\_ptr\<T\> == nlohmann::json compiles, which seem undesirable [\#3026](https://github.com/nlohmann/json/issues/3026)
+- Error in test\download\_test\_data.vcxproj custom build step when compiling with Visual Studio 2019 16.7.7 msbuild on Windows 10 [\#2593](https://github.com/nlohmann/json/issues/2593)
+- Consider putting the user-defined literals in a namespace [\#1682](https://github.com/nlohmann/json/issues/1682)
+- Using versioned namespaces [\#1539](https://github.com/nlohmann/json/issues/1539)
+- How can I use std::string\_view as the json\_key to "operator \[\]" ? [\#1529](https://github.com/nlohmann/json/issues/1529)
+- serialize std::variant\<...\> [\#1261](https://github.com/nlohmann/json/issues/1261)
+
+- Prepare 3.11.0 release [\#3635](https://github.com/nlohmann/json/pull/3635) ([nlohmann](https://github.com/nlohmann))
+- Fix warning [\#3634](https://github.com/nlohmann/json/pull/3634) ([nlohmann](https://github.com/nlohmann))
+- Add license header to new files [\#3633](https://github.com/nlohmann/json/pull/3633) ([nlohmann](https://github.com/nlohmann))
+- Add a unit test including windows.h [\#3631](https://github.com/nlohmann/json/pull/3631) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Fixed latest build error in msvc platform [\#3630](https://github.com/nlohmann/json/pull/3630) ([KsaNL](https://github.com/KsaNL))
+- Add regression tests for \#3204 and \#3333 [\#3629](https://github.com/nlohmann/json/pull/3629) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Fix patch::add creating nonexistent parents [\#3628](https://github.com/nlohmann/json/pull/3628) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Adjust JSON Pointer examples [\#3622](https://github.com/nlohmann/json/pull/3622) ([nlohmann](https://github.com/nlohmann))
+- Disable exceptions on ICPC [\#3621](https://github.com/nlohmann/json/pull/3621) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- build: install .pc and .cmake files to share/ [\#3619](https://github.com/nlohmann/json/pull/3619) ([Tachi107](https://github.com/Tachi107))
+- Fix MinGW CI failures [\#3618](https://github.com/nlohmann/json/pull/3618) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Fix Unicode test timeout \(for real this time!\) [\#3614](https://github.com/nlohmann/json/pull/3614) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Use 'concurrency' in GitHub workflows [\#3610](https://github.com/nlohmann/json/pull/3610) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Use swap\(\) by ADL [\#3609](https://github.com/nlohmann/json/pull/3609) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Move UDLs out of the global namespace [\#3605](https://github.com/nlohmann/json/pull/3605) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Re-add value\_type detection to distinguish string types [\#3604](https://github.com/nlohmann/json/pull/3604) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Add operator\<\<\(json\_pointer\) [\#3601](https://github.com/nlohmann/json/pull/3601) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Add documentation for comparing json and ordered\_json [\#3599](https://github.com/nlohmann/json/pull/3599) ([nlohmann](https://github.com/nlohmann))
+- Clean up after \#3581 [\#3596](https://github.com/nlohmann/json/pull/3596) ([nlohmann](https://github.com/nlohmann))
+- Add assertion if nullptr is passed to parse function [\#3593](https://github.com/nlohmann/json/pull/3593) ([nlohmann](https://github.com/nlohmann))
+- Minor documentation fixes [\#3592](https://github.com/nlohmann/json/pull/3592) ([nlohmann](https://github.com/nlohmann))
+- Add versioned, ABI-tagged inline namespace and namespace macros [\#3590](https://github.com/nlohmann/json/pull/3590) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Add badge for https://repology.org/project/nlohmann-json/versions [\#3586](https://github.com/nlohmann/json/pull/3586) ([nlohmann](https://github.com/nlohmann))
+- Add error message if test suite cannot be found [\#3585](https://github.com/nlohmann/json/pull/3585) ([nlohmann](https://github.com/nlohmann))
+- add patch\_inplace function [\#3581](https://github.com/nlohmann/json/pull/3581) ([wolfv](https://github.com/wolfv))
+- Enable overriding test properties and set Unicode test timeouts [\#3580](https://github.com/nlohmann/json/pull/3580) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Ignore output directory [\#3572](https://github.com/nlohmann/json/pull/3572) ([NN---](https://github.com/NN---))
+- Optimize output vector adapter write [\#3569](https://github.com/nlohmann/json/pull/3569) ([romainreignier](https://github.com/romainreignier))
+- Add overloads for more key types to ordered\_map and fix ordered\_map::erase\(first, last\) with first == last [\#3564](https://github.com/nlohmann/json/pull/3564) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Make certain usage patterns more prominent in the README [\#3557](https://github.com/nlohmann/json/pull/3557) ([jez](https://github.com/jez))
+- CI: fix "JSON\_MultipleHeaders" option spelling [\#3555](https://github.com/nlohmann/json/pull/3555) ([karzhenkov](https://github.com/karzhenkov))
+- More documentation updates for 3.11.0 [\#3553](https://github.com/nlohmann/json/pull/3553) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Use DOCTEST\_\* compiler macros and suppress pragmas warning [\#3550](https://github.com/nlohmann/json/pull/3550) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Add unit test to make sure iterator\_input\_adapter advances iterators correctly [\#3548](https://github.com/nlohmann/json/pull/3548) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Use REUSE framework [\#3546](https://github.com/nlohmann/json/pull/3546) ([nlohmann](https://github.com/nlohmann))
+- Use `std::iterator_traits` to extract `iterator_category` [\#3544](https://github.com/nlohmann/json/pull/3544) ([Mike-Leo-Smith](https://github.com/Mike-Leo-Smith))
+- BJData dimension length can not be string\_t::npos, fix \#3541 [\#3543](https://github.com/nlohmann/json/pull/3543) ([fangq](https://github.com/fangq))
+- Allow disabling default enum conversions [\#3536](https://github.com/nlohmann/json/pull/3536) ([zxey](https://github.com/zxey))
+- Add to\_json\(\) for std::vector\<bool\>::reference [\#3534](https://github.com/nlohmann/json/pull/3534) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- CI: Enable 32bit unit test \(3\) [\#3532](https://github.com/nlohmann/json/pull/3532) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Use new CI image [\#3528](https://github.com/nlohmann/json/pull/3528) ([nlohmann](https://github.com/nlohmann))
+- Fix ndarray dimension signedness, fix ndarray length overflow \(2\); add 32bit unit test [\#3523](https://github.com/nlohmann/json/pull/3523) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Small documentation fixes [\#3520](https://github.com/nlohmann/json/pull/3520) ([nlohmann](https://github.com/nlohmann))
+- Add assertion to converting constructor [\#3517](https://github.com/nlohmann/json/pull/3517) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- CI: Remove -Wstrict-overflow [\#3516](https://github.com/nlohmann/json/pull/3516) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Fix nlohmann/json\#3513, explain is\_ndarray flag [\#3514](https://github.com/nlohmann/json/pull/3514) ([fangq](https://github.com/fangq))
+- Prevent ndarray size vector from recursive use, fix nlohmann/json\#3503 [\#3505](https://github.com/nlohmann/json/pull/3505) ([fangq](https://github.com/fangq))
+- prevent ndarray dimension vector from recusive array, nlohmann/json\#3500 [\#3502](https://github.com/nlohmann/json/pull/3502) ([fangq](https://github.com/fangq))
+- Discard optimized containers with negative counts in UBJSON/BJData \(\#3491,\#3492,\#3490\) [\#3500](https://github.com/nlohmann/json/pull/3500) ([fangq](https://github.com/fangq))
+- Update json.hpp [\#3499](https://github.com/nlohmann/json/pull/3499) ([ivanovmp](https://github.com/ivanovmp))
+- Add assertion for invariant in SAX-DOM parser [\#3498](https://github.com/nlohmann/json/pull/3498) ([nlohmann](https://github.com/nlohmann))
+- Add more macOS builders [\#3485](https://github.com/nlohmann/json/pull/3485) ([nlohmann](https://github.com/nlohmann))
+- change bjdata ndarray flag to detect negative size, as part of \#3475 [\#3479](https://github.com/nlohmann/json/pull/3479) ([fangq](https://github.com/fangq))
+- Document fuzzer usage [\#3478](https://github.com/nlohmann/json/pull/3478) ([nlohmann](https://github.com/nlohmann))
+- Add build step for ICPC \(with fixes\) [\#3465](https://github.com/nlohmann/json/pull/3465) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Complete documentation for 3.11.0 [\#3464](https://github.com/nlohmann/json/pull/3464) ([nlohmann](https://github.com/nlohmann))
+- Handle invalid BJData optimized type, fix \#3461 [\#3463](https://github.com/nlohmann/json/pull/3463) ([fangq](https://github.com/fangq))
+- Reorganize directories [\#3462](https://github.com/nlohmann/json/pull/3462) ([nlohmann](https://github.com/nlohmann))
+- Enable rapid testing and development on Compiler Explorer [\#3456](https://github.com/nlohmann/json/pull/3456) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- cpplint 1.6.0 [\#3454](https://github.com/nlohmann/json/pull/3454) ([nlohmann](https://github.com/nlohmann))
+- Disable regression test for \#3070 on GCC \<8.4 [\#3451](https://github.com/nlohmann/json/pull/3451) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Fix C++20/gcc-12 issues \(Part 2\) [\#3446](https://github.com/nlohmann/json/pull/3446) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Overwork documentation [\#3444](https://github.com/nlohmann/json/pull/3444) ([nlohmann](https://github.com/nlohmann))
+- Fix typo in basic\_json documentation [\#3439](https://github.com/nlohmann/json/pull/3439) ([jhnlee](https://github.com/jhnlee))
+- Exclude std::any from implicit conversion \(fixes \#3428\) [\#3437](https://github.com/nlohmann/json/pull/3437) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Document which version introduced the macros [\#3431](https://github.com/nlohmann/json/pull/3431) ([nlohmann](https://github.com/nlohmann))
+- Fix constraints on from\_json\(\) for strings \(fixes \#3171, \#3267, \#3312, \#3384\) [\#3427](https://github.com/nlohmann/json/pull/3427) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- at.md: fix typo [\#3426](https://github.com/nlohmann/json/pull/3426) ([heinemml](https://github.com/heinemml))
+- Implement support for string\_view \(attempt no. 3\) [\#3423](https://github.com/nlohmann/json/pull/3423) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- CI: speedup AppVeyor builds by ~30% [\#3422](https://github.com/nlohmann/json/pull/3422) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Restore disabled check for \#3070 \(except on MSVC\) [\#3421](https://github.com/nlohmann/json/pull/3421) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Update CI image [\#3420](https://github.com/nlohmann/json/pull/3420) ([nlohmann](https://github.com/nlohmann))
+- Add check if different version is also included [\#3418](https://github.com/nlohmann/json/pull/3418) ([nlohmann](https://github.com/nlohmann))
+- Report the right \_\_cplusplus value for MSVC in basic\_json meta\(\) [\#3417](https://github.com/nlohmann/json/pull/3417) ([flagarde](https://github.com/flagarde))
+- CI: windows-2016 has been deprecated; remove jobs [\#3416](https://github.com/nlohmann/json/pull/3416) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Re-template json\_pointer on string type [\#3415](https://github.com/nlohmann/json/pull/3415) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Refactor unit tests to use more convenient doctest assertion macros \(Part 2\) [\#3405](https://github.com/nlohmann/json/pull/3405) ([kkarbowiak](https://github.com/kkarbowiak))
+- Refactor unit tests to use more convenient doctest assertion macros [\#3393](https://github.com/nlohmann/json/pull/3393) ([kkarbowiak](https://github.com/kkarbowiak))
+- Improve unit testing \(Part 1\) [\#3380](https://github.com/nlohmann/json/pull/3380) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Fix C++20/gcc-12 issues \(Part 1\) [\#3379](https://github.com/nlohmann/json/pull/3379) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Add clarification to avoid misunderstanding that cause \#3360 [\#3378](https://github.com/nlohmann/json/pull/3378) ([puffetto](https://github.com/puffetto))
+- Fix ordered\_map ctor with initializer\_list \(fixes \#3343\) [\#3370](https://github.com/nlohmann/json/pull/3370) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Fix and update CI [\#3368](https://github.com/nlohmann/json/pull/3368) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- FetchContent\_MakeAvailable [\#3351](https://github.com/nlohmann/json/pull/3351) ([nlohmann](https://github.com/nlohmann))
+- Avoid clash with Arduino defines [\#3338](https://github.com/nlohmann/json/pull/3338) ([DarkZeros](https://github.com/DarkZeros))
+- Support UBJSON-derived Binary JData \(BJData\) format [\#3336](https://github.com/nlohmann/json/pull/3336) ([fangq](https://github.com/fangq))
+- Make iterator operator++/--\(int\) equality-preserving [\#3332](https://github.com/nlohmann/json/pull/3332) ([falbrechtskirchinger](https://github.com/falbrechtskirchinger))
+- Add note on parsing ordered\_json [\#3326](https://github.com/nlohmann/json/pull/3326) ([nlohmann](https://github.com/nlohmann))
+- Fix CITATION.cff and add automatic validation of your citation metadata [\#3320](https://github.com/nlohmann/json/pull/3320) ([fdiblen](https://github.com/fdiblen))
+- .github/workflows/windows.yml: Add support for Visual Studio 2022 [\#3295](https://github.com/nlohmann/json/pull/3295) ([t-b](https://github.com/t-b))
+- Add maintainer targets to create source archive [\#3289](https://github.com/nlohmann/json/pull/3289) ([nlohmann](https://github.com/nlohmann))
+- Fix a typo [\#3265](https://github.com/nlohmann/json/pull/3265) ([fhuberts](https://github.com/fhuberts))
+- Fix typo [\#3249](https://github.com/nlohmann/json/pull/3249) ([rex4539](https://github.com/rex4539))
+- Add documentation for JSON Lines [\#3247](https://github.com/nlohmann/json/pull/3247) ([nlohmann](https://github.com/nlohmann))
+- Improve documentation InputType and IteratorType [\#3246](https://github.com/nlohmann/json/pull/3246) ([nlohmann](https://github.com/nlohmann))
+- Remove stringstream [\#3244](https://github.com/nlohmann/json/pull/3244) ([nlohmann](https://github.com/nlohmann))
+- fix \_MSC\_VER version to check for std::filesystem [\#3240](https://github.com/nlohmann/json/pull/3240) ([gcerretani](https://github.com/gcerretani))
+- Fix compilation error with NVCC [\#3234](https://github.com/nlohmann/json/pull/3234) ([nlohmann](https://github.com/nlohmann))
+- Remove Travis CI [\#3233](https://github.com/nlohmann/json/pull/3233) ([nlohmann](https://github.com/nlohmann))
+- Add build step for NVCC and fix a warning [\#3227](https://github.com/nlohmann/json/pull/3227) ([nlohmann](https://github.com/nlohmann))
+- Update cpplint [\#3225](https://github.com/nlohmann/json/pull/3225) ([nlohmann](https://github.com/nlohmann))
+- Fix: Warning for shadowed variables \(\#3188\) [\#3193](https://github.com/nlohmann/json/pull/3193) ([kernie](https://github.com/kernie))
+- Fix FAQ hyperlink typo in readme [\#3148](https://github.com/nlohmann/json/pull/3148) ([Prince-Mendiratta](https://github.com/Prince-Mendiratta))
+- Docs: Update `skip_comments` to `ignore_comments` [\#3145](https://github.com/nlohmann/json/pull/3145) ([daniel-kun](https://github.com/daniel-kun))
+- Add macros NLOHMANN\_DEFINE\_TYPE\_INTRUSIVE\_WITH\_DEFAULT and ...\_NON\_INTRUSIVE\_WITH\_DEFAULT [\#3143](https://github.com/nlohmann/json/pull/3143) ([pketelsen](https://github.com/pketelsen))
+- fix typos in documentation [\#3140](https://github.com/nlohmann/json/pull/3140) ([striezel](https://github.com/striezel))
+- Fix spelling [\#3125](https://github.com/nlohmann/json/pull/3125) ([axic](https://github.com/axic))
+- Extend std specializations [\#3121](https://github.com/nlohmann/json/pull/3121) ([nlohmann](https://github.com/nlohmann))
+- Add missing erase\(first, last\) function to ordered\_map [\#3109](https://github.com/nlohmann/json/pull/3109) ([nlohmann](https://github.com/nlohmann))
+- Fix typos in operator\[\] documentation [\#3102](https://github.com/nlohmann/json/pull/3102) ([axnsan12](https://github.com/axnsan12))
+- Add C++17 copies of the test binaries [\#3101](https://github.com/nlohmann/json/pull/3101) ([nlohmann](https://github.com/nlohmann))
+- Add examples for parsing from iterator pair [\#3100](https://github.com/nlohmann/json/pull/3100) ([nlohmann](https://github.com/nlohmann))
+- Update CI [\#3088](https://github.com/nlohmann/json/pull/3088) ([nlohmann](https://github.com/nlohmann))
+- Revert invalid fix [\#3082](https://github.com/nlohmann/json/pull/3082) ([nlohmann](https://github.com/nlohmann))
+- Allow to use get with explicit constructor [\#3079](https://github.com/nlohmann/json/pull/3079) ([nlohmann](https://github.com/nlohmann))
+- fix std::filesystem::path regression [\#3073](https://github.com/nlohmann/json/pull/3073) ([theodelrieu](https://github.com/theodelrieu))
+- Consolidate documentation [\#3071](https://github.com/nlohmann/json/pull/3071) ([nlohmann](https://github.com/nlohmann))
+- Add recursive update function [\#3069](https://github.com/nlohmann/json/pull/3069) ([nlohmann](https://github.com/nlohmann))
+- Fix Clang version [\#3040](https://github.com/nlohmann/json/pull/3040) ([nlohmann](https://github.com/nlohmann))
+- Fix assertion failure for JSON\_DIAGNOSTICS [\#3037](https://github.com/nlohmann/json/pull/3037) ([carlsmedstad](https://github.com/carlsmedstad))
+- meta: fix is\_compatible/constructible traits [\#3020](https://github.com/nlohmann/json/pull/3020) ([theodelrieu](https://github.com/theodelrieu))
+- Set parent pointers for values inserted via update\(\) \(fixes \#3007\). [\#3008](https://github.com/nlohmann/json/pull/3008) ([AnthonyVH](https://github.com/AnthonyVH))
+- Allow allocators for output\_vector\_adapter [\#2989](https://github.com/nlohmann/json/pull/2989) ([nlohmann](https://github.com/nlohmann))
+- Re-add Clang 12 [\#2986](https://github.com/nlohmann/json/pull/2986) ([nlohmann](https://github.com/nlohmann))
+- Use new Docker image [\#2981](https://github.com/nlohmann/json/pull/2981) ([nlohmann](https://github.com/nlohmann))
+- Fix -Wunused warnings on JSON\_DIAGNOSTICS [\#2976](https://github.com/nlohmann/json/pull/2976) ([gcerretani](https://github.com/gcerretani))
+- Update docset generation script [\#2967](https://github.com/nlohmann/json/pull/2967) ([nlohmann](https://github.com/nlohmann))
+
+## [v3.10.5](https://github.com/nlohmann/json/releases/tag/v3.10.5) (2022-01-03)
+
+[Full Changelog](https://github.com/nlohmann/json/compare/v3.10.4...v3.10.5)
- \#include \<filesystem\> doesn't work with gcc-7 when `-std=c++17` is specified. [\#3203](https://github.com/nlohmann/json/issues/3203)
- Not able to use nlohmann json with c++ code built using emscripten to wasm [\#3200](https://github.com/nlohmann/json/issues/3200)
@@ -30,36 +249,6 @@
- some static analysis warning at line 11317 [\#1390](https://github.com/nlohmann/json/issues/1390)
- Compiling with icpc [\#755](https://github.com/nlohmann/json/issues/755)
-- Fix compilation error with NVCC [\#3234](https://github.com/nlohmann/json/pull/3234) ([nlohmann](https://github.com/nlohmann))
-- Remove Travis CI [\#3233](https://github.com/nlohmann/json/pull/3233) ([nlohmann](https://github.com/nlohmann))
-- Add build step for NVCC and fix a warning [\#3227](https://github.com/nlohmann/json/pull/3227) ([nlohmann](https://github.com/nlohmann))
-- Update cpplint [\#3225](https://github.com/nlohmann/json/pull/3225) ([nlohmann](https://github.com/nlohmann))
-- Fix: Warning for shadowed variables \(\#3188\) [\#3193](https://github.com/nlohmann/json/pull/3193) ([kernie](https://github.com/kernie))
-- Fix FAQ hyperlink typo in readme [\#3148](https://github.com/nlohmann/json/pull/3148) ([Prince-Mendiratta](https://github.com/Prince-Mendiratta))
-- Docs: Update `skip_comments` to `ignore_comments` [\#3145](https://github.com/nlohmann/json/pull/3145) ([daniel-kun](https://github.com/daniel-kun))
-- fix typos in documentation [\#3140](https://github.com/nlohmann/json/pull/3140) ([striezel](https://github.com/striezel))
-- Fix spelling [\#3125](https://github.com/nlohmann/json/pull/3125) ([axic](https://github.com/axic))
-- Extend std specializations [\#3121](https://github.com/nlohmann/json/pull/3121) ([nlohmann](https://github.com/nlohmann))
-- Add missing erase\(first, last\) function to ordered\_map [\#3109](https://github.com/nlohmann/json/pull/3109) ([nlohmann](https://github.com/nlohmann))
-- Fix typos in operator\[\] documentation [\#3102](https://github.com/nlohmann/json/pull/3102) ([axnsan12](https://github.com/axnsan12))
-- Add C++17 copies of the test binaries [\#3101](https://github.com/nlohmann/json/pull/3101) ([nlohmann](https://github.com/nlohmann))
-- Add examples for parsing from iterator pair [\#3100](https://github.com/nlohmann/json/pull/3100) ([nlohmann](https://github.com/nlohmann))
-- Update CI [\#3088](https://github.com/nlohmann/json/pull/3088) ([nlohmann](https://github.com/nlohmann))
-- Revert invalid fix [\#3082](https://github.com/nlohmann/json/pull/3082) ([nlohmann](https://github.com/nlohmann))
-- Allow to use get with explicit constructor [\#3079](https://github.com/nlohmann/json/pull/3079) ([nlohmann](https://github.com/nlohmann))
-- fix std::filesystem::path regression [\#3073](https://github.com/nlohmann/json/pull/3073) ([theodelrieu](https://github.com/theodelrieu))
-- Consolidate documentation [\#3071](https://github.com/nlohmann/json/pull/3071) ([nlohmann](https://github.com/nlohmann))
-- Add recursive update function [\#3069](https://github.com/nlohmann/json/pull/3069) ([nlohmann](https://github.com/nlohmann))
-- Fix Clang version [\#3040](https://github.com/nlohmann/json/pull/3040) ([nlohmann](https://github.com/nlohmann))
-- Fix assertion failure for JSON\_DIAGNOSTICS [\#3037](https://github.com/nlohmann/json/pull/3037) ([carlsmedstad](https://github.com/carlsmedstad))
-- meta: fix is\_compatible/constructible traits [\#3020](https://github.com/nlohmann/json/pull/3020) ([theodelrieu](https://github.com/theodelrieu))
-- Set parent pointers for values inserted via update\(\) \(fixes \#3007\). [\#3008](https://github.com/nlohmann/json/pull/3008) ([AnthonyVH](https://github.com/AnthonyVH))
-- Allow allocators for output\_vector\_adapter [\#2989](https://github.com/nlohmann/json/pull/2989) ([nlohmann](https://github.com/nlohmann))
-- Re-add Clang 12 [\#2986](https://github.com/nlohmann/json/pull/2986) ([nlohmann](https://github.com/nlohmann))
-- Use new Docker image [\#2981](https://github.com/nlohmann/json/pull/2981) ([nlohmann](https://github.com/nlohmann))
-- Fix -Wunused warnings on JSON\_DIAGNOSTICS [\#2976](https://github.com/nlohmann/json/pull/2976) ([gcerretani](https://github.com/gcerretani))
-- Update docset generation script [\#2967](https://github.com/nlohmann/json/pull/2967) ([nlohmann](https://github.com/nlohmann))
-
## [v3.10.4](https://github.com/nlohmann/json/releases/tag/v3.10.4) (2021-10-16)
[Full Changelog](https://github.com/nlohmann/json/compare/v3.10.3...v3.10.4)
@@ -118,7 +307,7 @@
- Linker error LNK2005 when compiling \(x64\) json-3.10.0.zip with Visual Studio 2019 16.11.1 [\#2941](https://github.com/nlohmann/json/issues/2941)
- Move Travis jobs to travis-ci.com [\#2938](https://github.com/nlohmann/json/issues/2938)
-- Fixed typo in docs/api/basic\_json/parse.md [\#2968](https://github.com/nlohmann/json/pull/2968) ([mb0202](https://github.com/mb0202))
+- Fixed typo in docs/api/basic\_json/parse.md [\#2968](https://github.com/nlohmann/json/pull/2968) ([mbadhan](https://github.com/mbadhan))
- Add link to Homebrew package [\#2966](https://github.com/nlohmann/json/pull/2966) ([nlohmann](https://github.com/nlohmann))
- Fix parent update for diagnostics with ordered\_json [\#2963](https://github.com/nlohmann/json/pull/2963) ([nlohmann](https://github.com/nlohmann))
- Set stack size for some unit tests when using MSVC [\#2961](https://github.com/nlohmann/json/pull/2961) ([nlohmann](https://github.com/nlohmann))
@@ -240,7 +429,6 @@
- from\_\*\(ptr, len\) deprecation [\#2426](https://github.com/nlohmann/json/issues/2426)
- Error ONLY in release mode [\#2425](https://github.com/nlohmann/json/issues/2425)
- "Custom data source" exemple make no sense [\#2423](https://github.com/nlohmann/json/issues/2423)
-- Compile errors [\#2421](https://github.com/nlohmann/json/issues/2421)
- Refuses to compile in project [\#2419](https://github.com/nlohmann/json/issues/2419)
- Compilation failure of tests with C++20 standard \(caused by change of u8 literals\) [\#2413](https://github.com/nlohmann/json/issues/2413)
- No matching function for call to 'input\_adapter' under Xcode of with nlohmann version 3.9.1 [\#2412](https://github.com/nlohmann/json/issues/2412)
@@ -860,7 +1048,7 @@
- Segmentation fault \(stack overflow\) due to unbounded recursion [\#1419](https://github.com/nlohmann/json/issues/1419)
- Stack-overflow \(OSS-Fuzz 4234\) [\#832](https://github.com/nlohmann/json/issues/832)
-- Configure WhiteSource Bolt for GitHub [\#1830](https://github.com/nlohmann/json/pull/1830) ([whitesource-bolt-for-github[bot]](https://github.com/apps/whitesource-bolt-for-github))
+- Configure WhiteSource Bolt for GitHub [\#1830](https://github.com/nlohmann/json/pull/1830) ([mend-bolt-for-github[bot]](https://github.com/apps/mend-bolt-for-github))
- Prevent stackoverflow caused by recursive deconstruction [\#1436](https://github.com/nlohmann/json/pull/1436) ([nickaein](https://github.com/nickaein))
## [v3.7.1](https://github.com/nlohmann/json/releases/tag/v3.7.1) (2019-11-06)
@@ -951,7 +1139,6 @@
- Information: My project uses this awesome library [\#1691](https://github.com/nlohmann/json/issues/1691)
- Consider listing files explicitly instead of using GLOB [\#1686](https://github.com/nlohmann/json/issues/1686)
- Failing tests on MSVC with VS2019 15.9.13 x64 [\#1685](https://github.com/nlohmann/json/issues/1685)
-- Consider putting the user-defined literals in a namespace [\#1682](https://github.com/nlohmann/json/issues/1682)
- Change from v2 to v3. Encoding with cp1252 [\#1680](https://github.com/nlohmann/json/issues/1680)
- How to add Fifo\_map into json using Cmake [\#1679](https://github.com/nlohmann/json/issues/1679)
- include.zip should contain meson.build [\#1672](https://github.com/nlohmann/json/issues/1672)
@@ -1103,7 +1290,6 @@
- \[Help Needed!\] Season of Docs [\#1542](https://github.com/nlohmann/json/issues/1542)
- program still abort\(\) or exit\(\) with try catch [\#1541](https://github.com/nlohmann/json/issues/1541)
- Have a json::type\_error exception because of JSON object [\#1540](https://github.com/nlohmann/json/issues/1540)
-- Using versioned namespaces [\#1539](https://github.com/nlohmann/json/issues/1539)
- Quoted numbers [\#1538](https://github.com/nlohmann/json/issues/1538)
- Reading a JSON file into an object [\#1537](https://github.com/nlohmann/json/issues/1537)
- Releases 3.6.0 and 3.6.1 don't build on conda / windows [\#1536](https://github.com/nlohmann/json/issues/1536)
@@ -1370,7 +1556,6 @@
- syntax error on right json string [\#1276](https://github.com/nlohmann/json/issues/1276)
- Parsing JSON Array where members have no key, using custom types [\#1267](https://github.com/nlohmann/json/issues/1267)
- I get a json exception periodically from json::parse for the same json [\#1263](https://github.com/nlohmann/json/issues/1263)
-- serialize std::variant\<...\> [\#1261](https://github.com/nlohmann/json/issues/1261)
- GCC 8.2.1. Compilation error: invalid conversion from... [\#1246](https://github.com/nlohmann/json/issues/1246)
- BSON support [\#1244](https://github.com/nlohmann/json/issues/1244)
- enum to json mapping [\#1208](https://github.com/nlohmann/json/issues/1208)
@@ -1856,7 +2041,7 @@
- Add Visual Studio 17 image to appveyor build matrix [\#536](https://github.com/nlohmann/json/pull/536) ([vpetrigo](https://github.com/vpetrigo))
- UTF8 encoding enhancement [\#534](https://github.com/nlohmann/json/pull/534) ([TedLyngmo](https://github.com/TedLyngmo))
- Fix typo [\#530](https://github.com/nlohmann/json/pull/530) ([berkus](https://github.com/berkus))
-- Make exception base class visible in basic\_json [\#526](https://github.com/nlohmann/json/pull/526) ([krzysztofwos](https://github.com/krzysztofwos))
+- Make exception base class visible in basic\_json [\#526](https://github.com/nlohmann/json/pull/526) ([ghost](https://github.com/ghost))
- :art: Namespace `uint8_t` from the C++ stdlib [\#510](https://github.com/nlohmann/json/pull/510) ([alexweej](https://github.com/alexweej))
- add to\_json method for C arrays [\#508](https://github.com/nlohmann/json/pull/508) ([theodelrieu](https://github.com/theodelrieu))
- Fix -Weffc++ warnings \(GNU 6.3.1\) [\#496](https://github.com/nlohmann/json/pull/496) ([TedLyngmo](https://github.com/TedLyngmo))
diff --git a/LICENSES/Apache-2.0.txt b/LICENSES/Apache-2.0.txt
new file mode 100644
index 0000000..137069b
--- /dev/null
+++ b/LICENSES/Apache-2.0.txt
@@ -0,0 +1,73 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
+
+ (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
diff --git a/LICENSES/BSD-3-Clause.txt b/LICENSES/BSD-3-Clause.txt
new file mode 100644
index 0000000..ea890af
--- /dev/null
+++ b/LICENSES/BSD-3-Clause.txt
@@ -0,0 +1,11 @@
+Copyright (c) <year> <owner>.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/LICENSES/GPL-3.0-only.txt b/LICENSES/GPL-3.0-only.txt
new file mode 100644
index 0000000..d41c0bd
--- /dev/null
+++ b/LICENSES/GPL-3.0-only.txt
@@ -0,0 +1,232 @@
+GNU GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright © 2007 Free Software Foundation, Inc. <http://fsf.org/>
+
+Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+
+Preamble
+
+The GNU General Public License is a free, copyleft license for software and other kinds of works.
+
+The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too.
+
+When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things.
+
+To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others.
+
+For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.
+
+Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it.
+
+For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions.
+
+Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users.
+
+Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free.
+
+The precise terms and conditions for copying, distribution and modification follow.
+
+TERMS AND CONDITIONS
+
+0. Definitions.
+
+“This License” refers to version 3 of the GNU General Public License.
+
+“Copyright” also means copyright-like laws that apply to other kinds of works, such as semiconductor masks.
+
+“The Program” refers to any copyrightable work licensed under this License. Each licensee is addressed as “you”. “Licensees” and “recipients” may be individuals or organizations.
+
+To “modify” a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a “modified version” of the earlier work or a work “based on” the earlier work.
+
+A “covered work” means either the unmodified Program or a work based on the Program.
+
+To “propagate” a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well.
+
+To “convey” a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying.
+
+An interactive user interface displays “Appropriate Legal Notices” to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion.
+
+1. Source Code.
+The “source code” for a work means the preferred form of the work for making modifications to it. “Object code” means any non-source form of a work.
+
+A “Standard Interface” means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language.
+
+The “System Libraries” of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A “Major Component”, in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it.
+
+The “Corresponding Source” for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work.
+
+The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source.
+
+The Corresponding Source for a work in source code form is that same work.
+
+2. Basic Permissions.
+All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law.
+
+You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you.
+
+Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary.
+
+3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures.
+
+When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures.
+
+4. Conveying Verbatim Copies.
+You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program.
+
+You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee.
+
+5. Conveying Modified Source Versions.
+You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions:
+
+ a) The work must carry prominent notices stating that you modified it, and giving a relevant date.
+
+ b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to “keep intact all notices”.
+
+ c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it.
+
+ d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so.
+
+A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an “aggregate” if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate.
+
+6. Conveying Non-Source Forms.
+You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways:
+
+ a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange.
+
+ b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge.
+
+ c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b.
+
+ d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements.
+
+ e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d.
+
+A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work.
+
+A “User Product” is either (1) a “consumer product”, which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, “normally used” refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product.
+
+“Installation Information” for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made.
+
+If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM).
+
+The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network.
+
+Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying.
+
+7. Additional Terms.
+“Additional permissions” are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions.
+
+When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission.
+
+Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms:
+
+ a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or
+
+ b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or
+
+ c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or
+
+ d) Limiting the use for publicity purposes of names of licensors or authors of the material; or
+
+ e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or
+
+ f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors.
+
+All other non-permissive additional terms are considered “further restrictions” within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying.
+
+If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms.
+
+Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way.
+
+8. Termination.
+You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11).
+
+However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation.
+
+Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice.
+
+Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10.
+
+9. Acceptance Not Required for Having Copies.
+You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so.
+
+10. Automatic Licensing of Downstream Recipients.
+Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License.
+
+An “entity transaction” is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts.
+
+You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it.
+
+11. Patents.
+A “contributor” is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's “contributor version”.
+
+A contributor's “essential patent claims” are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, “control” includes the right to grant patent sublicenses in a manner consistent with the requirements of this License.
+
+Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version.
+
+In the following three paragraphs, a “patent license” is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To “grant” such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party.
+
+If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. “Knowingly relying” means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid.
+
+If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it.
+
+A patent license is “discriminatory” if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007.
+
+Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law.
+
+12. No Surrender of Others' Freedom.
+If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program.
+
+13. Use with the GNU Affero General Public License.
+Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such.
+
+14. Revised Versions of this License.
+The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License “or any later version” applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation.
+
+If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program.
+
+Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version.
+
+15. Disclaimer of Warranty.
+THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+16. Limitation of Liability.
+IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+17. Interpretation of Sections 15 and 16.
+If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee.
+
+END OF TERMS AND CONDITIONS
+
+How to Apply These Terms to Your New Programs
+
+If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms.
+
+To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the “copyright” line and a pointer to where the full notice is found.
+
+ <one line to give the program's name and a brief idea of what it does.>
+ Copyright (C) <year> <name of author>
+
+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode:
+
+ <program> Copyright (C) <year> <name of author>
+ This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+ This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an “about box”.
+
+You should also get your employer (if you work as a programmer) or school, if any, to sign a “copyright disclaimer” for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see <http://www.gnu.org/licenses/>.
+
+The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read <http://www.gnu.org/philosophy/why-not-lgpl.html>.
diff --git a/LICENSES/MIT.txt b/LICENSES/MIT.txt
new file mode 100644
index 0000000..2071b23
--- /dev/null
+++ b/LICENSES/MIT.txt
@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) <year> <copyright holders>
+
+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.
diff --git a/Makefile b/Makefile
index 43db74d..1f220b2 100644
--- a/Makefile
+++ b/Makefile
@@ -4,9 +4,6 @@
# configuration
##########################################################################
-# directory to recent compiler binaries
-COMPILER_DIR=/usr/local/opt/llvm/bin
-
# find GNU sed to use `-i` parameter
SED:=$(shell command -v gsed || which sed)
@@ -18,6 +15,9 @@
# the list of sources in the include folder
SRCS=$(shell find include -type f | sort)
+# the list of sources in the tests folder
+TESTS_SRCS=$(shell find tests -type f \( -name '*.hpp' -o -name '*.cpp' -o -name '*.cu' \) -not -path 'tests/thirdparty/*' -not -path 'tests/abi/include/nlohmann/*' | sort)
+
# the single header (amalgamated from the source files)
AMALGAMATED_FILE=single_include/nlohmann/json.hpp
@@ -48,7 +48,7 @@
# compile example files and check output
doctest:
- $(MAKE) check_output -C doc
+ $(MAKE) check_output -C docs
##########################################################################
@@ -58,10 +58,11 @@
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
+
##########################################################################
# fuzzing
##########################################################################
@@ -70,41 +71,41 @@
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:
@@ -135,6 +136,7 @@
cd cmake-build-pvs-studio ; plog-converter -a'GA:1,2;64:1;CS' -t fullhtml PVS-Studio.log -o pvs
open cmake-build-pvs-studio/pvs/index.html
+
##########################################################################
# Code format and source amalgamation
##########################################################################
@@ -160,18 +162,18 @@
--preserve-date \
--suffix=none \
--formatted \
- $(SRCS) $(AMALGAMATED_FILE) test/src/*.cpp test/src/*.hpp benchmarks/src/benchmarks.cpp doc/examples/*.cpp
+ $(SRCS) $(TESTS_SRCS) $(AMALGAMATED_FILE) 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) $(TESTS_SRCS) $(AMALGAMATED_FILE) 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
@@ -203,20 +205,29 @@
# Release files
##########################################################################
-# Create the files for a release and add signatures and hashes. We use `-X` to make the resulting ZIP file
-# reproducible, see <https://content.pivotal.io/blog/barriers-to-deterministic-reproducible-zip-files>.
+# Create a tar.gz archive that contains sufficient files to be used as CMake project (e.g., using FetchContent). The
+# archive is created according to the advices of <https://reproducible-builds.org/docs/archives/>.
+json.tar.xz:
+ mkdir json
+ rsync -R $(shell find LICENSE.MIT nlohmann_json.natvis CMakeLists.txt cmake/*.in include single_include -type f) json
+ gtar --sort=name --mtime="@$(shell git log -1 --pretty=%ct)" --owner=0 --group=0 --numeric-owner --pax-option=exthdr.name=%d/PaxHeaders/%f,delete=atime,delete=ctime --create --file - json | xz --compress -9e --threads=2 - > json.tar.xz
+ rm -fr json
-release:
+# We use `-X` to make the resulting ZIP file reproducible, see
+# <https://content.pivotal.io/blog/barriers-to-deterministic-reproducible-zip-files>.
+include.zip:
+ zip -9 --recurse-paths -X include.zip $(SRCS) $(AMALGAMATED_FILE) meson.build LICENSE.MIT
+
+# Create the files for a release and add signatures and hashes.
+release: include.zip json.tar.xz
rm -fr release_files
mkdir release_files
- zip -9 --recurse-paths -X include.zip $(SRCS) $(AMALGAMATED_FILE) meson.build LICENSE.MIT
gpg --armor --detach-sig include.zip
- mv include.zip include.zip.asc release_files
gpg --armor --detach-sig $(AMALGAMATED_FILE)
+ gpg --armor --detach-sig json.tar.xz
cp $(AMALGAMATED_FILE) release_files
- mv $(AMALGAMATED_FILE).asc release_files
- cd release_files ; shasum -a 256 json.hpp > hashes.txt
- cd release_files ; shasum -a 256 include.zip >> hashes.txt
+ mv $(AMALGAMATED_FILE).asc json.tar.xz json.tar.xz.asc include.zip include.zip.asc release_files
+ cd release_files ; shasum -a 256 json.hpp include.zip json.tar.xz > hashes.txt
##########################################################################
@@ -225,11 +236,11 @@
# clean up
clean:
- rm -fr json_unit json_benchmarks fuzz fuzz-testing *.dSYM test/*.dSYM oclint_report.html
+ rm -fr fuzz fuzz-testing *.dSYM tests/*.dSYM
rm -fr benchmarks/files/numbers/*.json
- rm -fr cmake-3.1.0-Darwin64.tar.gz cmake-3.1.0-Darwin64
- rm -fr cmake-build-benchmarks cmake-build-pedantic fuzz-testing cmake-build-clang-analyze cmake-build-pvs-studio cmake-build-infer cmake_build
- $(MAKE) clean -Cdoc
+ rm -fr cmake-build-benchmarks fuzz-testing cmake-build-pvs-studio release_files
+ $(MAKE) clean -Cdocs
+
##########################################################################
# Thirdparty code
@@ -243,3 +254,19 @@
$(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)
+
+##########################################################################
+# REUSE
+##########################################################################
+
+reuse:
+ pipx run reuse addheader --recursive single_include include -tjson --license MIT --copyright "Niels Lohmann <https://nlohmann.me>" --year "2013-2022"
+ pipx run reuse addheader $(TESTS_SRCS) --style=c -tjson_support --license MIT --copyright "Niels Lohmann <https://nlohmann.me>" --year "2013-2022"
+ pipx run reuse lint
diff --git a/README.md b/README.md
index 3132963..de8b524 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-[](https://github.com/nlohmann/json/releases)
+[](https://github.com/nlohmann/json/releases)
[](https://ci.appveyor.com/project/nlohmann/json)
[](https://github.com/nlohmann/json/actions?query=workflow%3AUbuntu)
@@ -10,19 +10,23 @@
[](https://lgtm.com/projects/g/nlohmann/json/context:cpp)
[](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:json)
[](https://wandbox.org/permlink/1mp10JbaANo6FUc7)
-[](https://nlohmann.github.io/json/doxygen/index.html)
+[](https://json.nlohmann.me)
[](https://raw.githubusercontent.com/nlohmann/json/master/LICENSE.MIT)
[](https://github.com/nlohmann/json/releases)
+[](https://repology.org/project/nlohmann-json/versions)
[](https://github.com/nlohmann/json/releases)
[](https://github.com/nlohmann/json/issues)
[](https://isitmaintained.com/project/nlohmann/json "Average time to resolve an issue")
[](https://bestpractices.coreinfrastructure.org/projects/289)
[](https://github.com/sponsors/nlohmann)
+[](https://api.reuse.software/info/github.com/nlohmann/json)
- [Design goals](#design-goals)
- [Sponsors](#sponsors)
- [Support](#support) ([documentation](https://json.nlohmann.me), [FAQ](https://json.nlohmann.me/home/faq/), [discussions](https://github.com/nlohmann/json/discussions), [API](https://json.nlohmann.me/api/basic_json/), [bug issues](https://github.com/nlohmann/json/issues))
- [Examples](#examples)
+ - [Read JSON from a file](#read-json-from-a-file)
+ - [Creating `json` objects from JSON literals](#creating-json-objects-from-json-literals)
- [JSON as first-class data type](#json-as-first-class-data-type)
- [Serialization / Deserialization](#serialization--deserialization)
- [STL-like access](#stl-like-access)
@@ -32,7 +36,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)
@@ -54,7 +58,7 @@
- **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 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 +73,10 @@
You can sponsor this library at [GitHub Sponsors](https://github.com/sponsors/nlohmann).
+### :office: Corporate Sponsor
+
+[](https://github.com/codacy)
+
### :label: Named Sponsors
- [Michael Hartmann](https://github.com/reFX-Mike)
@@ -83,9 +91,9 @@
: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/) or the [**Doxygen documentation**](https://json.nlohmann.me/doxygen/index.html).
+:construction: If you want to understand the **API** better, check out the [**API Reference**](https://json.nlohmann.me/api/basic_json/).
:bug: If you found a **bug**, please check the [**FAQ**](https://json.nlohmann.me/home/faq/) if it is a known issue or the result of a design decision. Please also have a look at the [**issue list**](https://github.com/nlohmann/json/issues) before you [**create a new issue**](https://github.com/nlohmann/json/issues/new/choose). Please provide as much information as possible to help us understand and reproduce your issue.
@@ -93,7 +101,67 @@
## 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)).
+Here are some examples to give you an idea how to use the class.
+
+Beside the examples below, you may want to:
+
+→ Check the [documentation](https://json.nlohmann.me/)\
+→ Browse the [standalone example files](https://github.com/nlohmann/json/tree/develop/docs/examples)
+
+Every API function (documented in the [API Documentation](https://json.nlohmann.me/api/basic_json/)) has a corresponding standalone example file. For example, the [`emplace()`](https://json.nlohmann.me/api/basic_json/emplace/) function has a matching [emplace.cpp](https://github.com/nlohmann/json/blob/develop/docs/examples/emplace.cpp) example file.
+
+### Read JSON from a file
+
+The `json` class provides an API for manipulating a JSON value. To create a `json` object by reading a JSON file:
+
+```cpp
+#include <fstream>
+#include <nlohmann/json.hpp>
+using json = nlohmann::json;
+
+// ...
+
+std::ifstream f("example.json");
+json data = json::parse(f);
+```
+
+### Creating `json` objects from JSON literals
+
+Assume you want to create hard-code this literal JSON value in a file, as a `json` object:
+
+```json
+{
+ "pi": 3.141,
+ "happy": true
+}
+```
+
+There are various options:
+
+```cpp
+// Using (raw) string literals and json::parse
+json ex1 = json::parse(R"(
+ {
+ "pi": 3.141,
+ "happy": true
+ }
+)");
+
+// Using user-defined (raw) string literals
+using namespace nlohmann::literals;
+json ex2 = R"(
+ {
+ "pi": 3.141,
+ "happy": true
+ }
+)"_json;
+
+// Using initializer lists
+json ex3 = {
+ {"happy", true},
+ {"pi", 3.141},
+};
+```
### JSON as first-class data type
@@ -162,7 +230,7 @@
};
```
-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 []
@@ -195,9 +263,14 @@
)"_json;
```
-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.
+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 string literal should be brought into scope with with `using namespace nlohmann::literals;`
+(see [`json::parse()`](https://json.nlohmann.me/api/operator_literal_json/)).
+
+The above example can also be expressed explicitly using [`json::parse()`](https://json.nlohmann.me/api/basic_json/parse/):
```cpp
// parse explicitly
@@ -240,9 +313,9 @@
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 +803,7 @@
* 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
@@ -857,7 +930,7 @@
#### 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:
@@ -961,9 +1034,9 @@
- 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
@@ -1037,14 +1110,15 @@
Though it's 2022 already, the support for C++11 is still a bit sparse. Currently, the following compilers are known to work:
-- GCC 4.8 - 11.0 (and possibly later)
-- Clang 3.4 - 13.0 (and possibly later)
-- Apple Clang 9.1 - 13.0 (and possibly later)
+- GCC 4.8 - 12.0 (and possibly later)
+- Clang 3.4 - 15.0 (and possibly later)
+- Apple Clang 9.1 - 13.1 (and possibly later)
- Intel C++ Compiler 17.0.2 (and possibly later)
- Nvidia CUDA Compiler 11.0.221 (and possibly later)
- Microsoft Visual C++ 2015 / Build Tools 14.0.25123.0 (and possibly later)
- Microsoft Visual C++ 2017 / Build Tools 15.5.180.51428 (and possibly later)
- Microsoft Visual C++ 2019 / Build Tools 16.3.1+1def00d3d (and possibly later)
+- Microsoft Visual C++ 2022 / Build Tools 19.30.30709.0 (and possibly later)
I would be happy to learn about other compilers/versions.
@@ -1082,18 +1156,11 @@
| 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.0.1 20210321 (experimental) | Ubuntu 20.04.3 LTS | GitHub Actions |
-| GCC 11.1.0 | Ubuntu (aarch64) | Drone CI |
+| 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 |
@@ -1112,13 +1179,28 @@
| 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 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 |
+| 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 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 |
| Visual Studio 15 2017 MSVC 19.16.27035.0 (Build Engine version 15.9.21+g9802d43bc3 for .NET Framework) | Windows-10.0.14393 | AppVeyor |
-| Visual Studio 15 2017 MSVC 19.16.27045.0 (Build Engine version 15.9.21+g9802d43bc3 for .NET Framework) | Windows-10.0.14393 | GitHub Actions |
| Visual Studio 16 2019 MSVC 19.28.29912.0 (Build Engine version 16.9.0+57a23d249 for .NET Framework) | Windows-10.0.17763 | GitHub Actions |
| Visual Studio 16 2019 MSVC 19.28.29912.0 (Build Engine version 16.9.0+57a23d249 for .NET Framework) | Windows-10.0.17763 | AppVeyor |
+| Visual Studio 17 2022 MSVC 19.30.30709.0 (Build Engine version 17.0.31804.368 for .NET Framework) | Windows-10.0.20348 | GitHub Actions |
## Integration
@@ -1183,29 +1265,20 @@
Since CMake v3.11,
[FetchContent](https://cmake.org/cmake/help/v3.11/module/FetchContent.html) can
-be used to automatically download the repository as a dependency at configure time.
+be used to automatically download a release as a dependency at configure time.
Example:
```cmake
include(FetchContent)
-FetchContent_Declare(json
- GIT_REPOSITORY https://github.com/nlohmann/json.git
- GIT_TAG v3.7.3)
-
-FetchContent_GetProperties(json)
-if(NOT json_POPULATED)
- FetchContent_Populate(json)
- add_subdirectory(${json_SOURCE_DIR} ${json_BINARY_DIR} EXCLUDE_FROM_ALL)
-endif()
+FetchContent_Declare(json URL https://github.com/nlohmann/json/releases/download/v3.11.0/json.tar.xz)
+FetchContent_MakeAvailable(json)
target_link_libraries(foo PRIVATE nlohmann_json::nlohmann_json)
```
-**Note**: The repository https://github.com/nlohmann/json download size is huge.
-It contains all the dataset used for the benchmarks. You might want to depend on
-a smaller repository. For instance, you might want to replace the URL above by
-https://github.com/ArthurSonzogni/nlohmann_json_cmake_fetchcontent
+**Note**: It is recommended to use the URL approach described above which is supported as of version 3.10.0. See
+<https://json.nlohmann.me/integration/cmake/#fetchcontent> for more information.
#### Supporting Both
@@ -1336,7 +1409,7 @@
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.
@@ -1605,6 +1678,21 @@
- [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.
+- [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.
@@ -1619,18 +1707,19 @@
- [**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
- [**doctest**](https://github.com/onqtam/doctest) for the unit tests
-- [**Doxygen**](https://www.doxygen.nl/index.html) to generate [documentation](https://nlohmann.github.io/json/doxygen/index.html)
- [**git-update-ghpages**](https://github.com/rstacruz/git-update-ghpages) to upload the documentation to gh-pages
- [**GitHub Changelog Generator**](https://github.com/skywinder/github-changelog-generator) to generate the [ChangeLog](https://github.com/nlohmann/json/blob/develop/ChangeLog.md)
- [**Google Benchmark**](https://github.com/google/benchmark) to implement the benchmarks
- [**Hedley**](https://nemequ.github.io/hedley/) to avoid re-inventing several compiler-agnostic feature macros
- [**lcov**](http://ltp.sourceforge.net/coverage/lcov.php) to process coverage information and create an HTML view
- [**libFuzzer**](https://llvm.org/docs/LibFuzzer.html) to implement fuzz testing for OSS-Fuzz
+- [**Material for MkDocs**](https://squidfunk.github.io/mkdocs-material/) for the style of the documentation site
+- [**MkDocs**](https://www.mkdocs.org) for the documentation site
- [**OSS-Fuzz**](https://github.com/google/oss-fuzz) for continuous fuzz testing of the library ([project repository](https://github.com/google/oss-fuzz/tree/master/projects/json))
- [**Probot**](https://probot.github.io) for automating maintainer tasks such as closing stale issues, requesting missing information, or detecting toxic comments.
- [**Valgrind**](https://valgrind.org) to check for correct memory management
@@ -1638,7 +1727,7 @@
## 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
@@ -1653,7 +1742,7 @@
- [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
@@ -1688,7 +1777,7 @@
### 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).
@@ -1707,6 +1796,22 @@
Note that during the `ctest` stage, several JSON test files are downloaded from an [external repository](https://github.com/nlohmann/json_test_data). If policies forbid downloading artifacts during testing, you can download the files yourself and pass the directory with the test files via `-DJSON_TestDataDirectory=path` to CMake. Then, no Internet connectivity is required. See [issue #2189](https://github.com/nlohmann/json/issues/2189) for more information.
+If the test suite is not found, several test suites will fail like this:
+
+```
+===============================================================================
+json/tests/src/make_test_data_available.hpp:21:
+TEST CASE: check test suite is downloaded
+
+json/tests/src/make_test_data_available.hpp:23: FATAL ERROR: REQUIRE( utils::check_testsuite_downloaded() ) is NOT correct!
+ values: REQUIRE( false )
+ logged: Test data not found in 'json/cmake-build-debug/json_test_data'.
+ Please execute target 'download_test_data' before running this test suite.
+ See <https://github.com/nlohmann/json#execute-unit-tests> for more information.
+
+===============================================================================
+```
+
In case you have downloaded the library rather than checked out the code via Git, test `cmake_fetch_content_configure` will fail. Please execute `ctest -LE git_required` to skip these tests. See [issue #2189](https://github.com/nlohmann/json/issues/2189) for more information.
Some tests change the installed files and hence make the whole process not reproducible. Please execute `ctest -LE not_reproducible` to skip these tests. See [issue #2324](https://github.com/nlohmann/json/issues/2324) for more information.
diff --git a/cmake/ci.cmake b/cmake/ci.cmake
index d0b989c..5ccd4c4 100644
--- a/cmake/ci.cmake
+++ b/cmake/ci.cmake
@@ -13,12 +13,12 @@
string(REGEX MATCH "[0-9]+(\\.[0-9]+)+" ASTYLE_TOOL_VERSION "${ASTYLE_TOOL_VERSION}")
message(STATUS "đ Artistic Style ${ASTYLE_TOOL_VERSION} (${ASTYLE_TOOL})")
-find_program(CLANG_TOOL NAMES clang++-HEAD clang++-14 clang++-13 clang++-12 clang++-11 clang++)
+find_program(CLANG_TOOL NAMES clang++-HEAD clang++-15 clang++-14 clang++-13 clang++-12 clang++-11 clang++)
execute_process(COMMAND ${CLANG_TOOL} --version OUTPUT_VARIABLE CLANG_TOOL_VERSION ERROR_VARIABLE CLANG_TOOL_VERSION)
string(REGEX MATCH "[0-9]+(\\.[0-9]+)+" CLANG_TOOL_VERSION "${CLANG_TOOL_VERSION}")
message(STATUS "đ Clang ${CLANG_TOOL_VERSION} (${CLANG_TOOL})")
-find_program(CLANG_TIDY_TOOL NAMES clang-tidy-14 clang-tidy-13 clang-tidy-12 clang-tidy-11 clang-tidy)
+find_program(CLANG_TIDY_TOOL NAMES clang-tidy-15 clang-tidy-14 clang-tidy-13 clang-tidy-12 clang-tidy-11 clang-tidy)
execute_process(COMMAND ${CLANG_TIDY_TOOL} --version OUTPUT_VARIABLE CLANG_TIDY_TOOL_VERSION ERROR_VARIABLE CLANG_TIDY_TOOL_VERSION)
string(REGEX MATCH "[0-9]+(\\.[0-9]+)+" CLANG_TIDY_TOOL_VERSION "${CLANG_TIDY_TOOL_VERSION}")
message(STATUS "đ Clang-Tidy ${CLANG_TIDY_TOOL_VERSION} (${CLANG_TIDY_TOOL})")
@@ -30,7 +30,7 @@
string(REGEX MATCH "[0-9]+(\\.[0-9]+)+" CPPCHECK_TOOL_VERSION "${CPPCHECK_TOOL_VERSION}")
message(STATUS "đ Cppcheck ${CPPCHECK_TOOL_VERSION} (${CPPCHECK_TOOL})")
-find_program(GCC_TOOL NAMES g++-HEAD g++-11 g++-latest)
+find_program(GCC_TOOL NAMES g++-latest g++-HEAD g++-11 g++-10)
execute_process(COMMAND ${GCC_TOOL} --version OUTPUT_VARIABLE GCC_TOOL_VERSION ERROR_VARIABLE GCC_TOOL_VERSION)
string(REGEX MATCH "[0-9]+(\\.[0-9]+)+" GCC_TOOL_VERSION "${GCC_TOOL_VERSION}")
message(STATUS "đ GCC ${GCC_TOOL_VERSION} (${GCC_TOOL})")
@@ -79,7 +79,7 @@
find_program(GENHTML_TOOL NAMES genhtml)
find_program(PLOG_CONVERTER_TOOL NAMES plog-converter)
find_program(PVS_STUDIO_ANALYZER_TOOL NAMES pvs-studio-analyzer)
-find_program(SCAN_BUILD_TOOL NAMES scan-build-14 scan-build-13 scan-build-12 scan-build-11 scan-build)
+find_program(SCAN_BUILD_TOOL NAMES scan-build-15 scan-build-14 scan-build-13 scan-build-12 scan-build-11 scan-build)
# the individual source files
file(GLOB_RECURSE SRC_FILES ${PROJECT_SOURCE_DIR}/include/nlohmann/*.hpp)
@@ -98,19 +98,20 @@
# -Wno-weak-vtables The library is header-only.
# -Wreserved-identifier See https://github.com/onqtam/doctest/issues/536.
-set(CLANG_CXXFLAGS "-std=c++11 \
- -Werror \
- -Weverything \
- -Wno-c++98-compat \
- -Wno-c++98-compat-pedantic \
- -Wno-deprecated-declarations \
- -Wno-extra-semi-stmt \
- -Wno-padded \
- -Wno-covered-switch-default \
- -Wno-weak-vtables \
- -Wno-reserved-identifier \
-")
+set(CLANG_CXXFLAGS
+ -Werror
+ -Weverything
+ -Wno-c++98-compat
+ -Wno-c++98-compat-pedantic
+ -Wno-deprecated-declarations
+ -Wno-extra-semi-stmt
+ -Wno-padded
+ -Wno-covered-switch-default
+ -Wno-weak-vtables
+ -Wno-reserved-identifier
+)
+# 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.
@@ -120,285 +121,302 @@
# -Wno-system-headers We do not care about warnings in system headers.
# -Wno-templates The library uses templates.
-set(GCC_CXXFLAGS "-std=c++11 \
- -pedantic \
- -Werror \
- --all-warnings \
- --extra-warnings \
- -W \
- -WNSObject-attribute \
- -Wno-abi-tag \
- -Waddress \
- -Waddress-of-packed-member \
- -Wno-aggregate-return \
- -Waggressive-loop-optimizations \
- -Waligned-new=all \
- -Wall \
- -Walloc-zero \
- -Walloca \
- -Wanalyzer-double-fclose \
- -Wanalyzer-double-free \
- -Wanalyzer-exposure-through-output-file \
- -Wanalyzer-file-leak \
- -Wanalyzer-free-of-non-heap \
- -Wanalyzer-malloc-leak \
- -Wanalyzer-mismatching-deallocation \
- -Wanalyzer-null-argument \
- -Wanalyzer-null-dereference \
- -Wanalyzer-possible-null-argument \
- -Wanalyzer-possible-null-dereference \
- -Wanalyzer-shift-count-negative \
- -Wanalyzer-shift-count-overflow \
- -Wanalyzer-stale-setjmp-buffer \
- -Wanalyzer-tainted-array-index \
- -Wanalyzer-too-complex \
- -Wanalyzer-unsafe-call-within-signal-handler \
- -Wanalyzer-use-after-free \
- -Wanalyzer-use-of-pointer-in-stale-stack-frame \
- -Wanalyzer-write-to-const \
- -Wanalyzer-write-to-string-literal \
- -Warith-conversion \
- -Warray-bounds \
- -Warray-bounds=2 \
- -Warray-parameter=2 \
- -Wattribute-alias=2 \
- -Wattribute-warning \
- -Wattributes \
- -Wbool-compare \
- -Wbool-operation \
- -Wbuiltin-declaration-mismatch \
- -Wbuiltin-macro-redefined \
- -Wc++0x-compat \
- -Wc++11-compat \
- -Wc++14-compat \
- -Wc++17-compat \
- -Wc++1z-compat \
- -Wc++20-compat \
- -Wc++2a-compat \
- -Wcannot-profile \
- -Wcast-align \
- -Wcast-align=strict \
- -Wcast-function-type \
- -Wcast-qual \
- -Wcatch-value=3 \
- -Wchar-subscripts \
- -Wclass-conversion \
- -Wclass-memaccess \
- -Wclobbered \
- -Wcomma-subscript \
- -Wcomment \
- -Wcomments \
- -Wconditionally-supported \
- -Wconversion \
- -Wconversion-null \
- -Wcoverage-mismatch \
- -Wcpp \
- -Wctad-maybe-unsupported \
- -Wctor-dtor-privacy \
- -Wdangling-else \
- -Wdate-time \
- -Wdelete-incomplete \
- -Wdelete-non-virtual-dtor \
- -Wdeprecated \
- -Wdeprecated-copy \
- -Wdeprecated-copy-dtor \
- -Wdeprecated-declarations \
- -Wdeprecated-enum-enum-conversion \
- -Wdeprecated-enum-float-conversion \
- -Wdisabled-optimization \
- -Wdiv-by-zero \
- -Wdouble-promotion \
- -Wduplicated-branches \
- -Wduplicated-cond \
- -Weffc++ \
- -Wempty-body \
- -Wendif-labels \
- -Wenum-compare \
- -Wenum-conversion \
- -Wexpansion-to-defined \
- -Wextra \
- -Wextra-semi \
- -Wfloat-conversion \
- -Wfloat-equal \
- -Wformat-contains-nul \
- -Wformat-diag \
- -Wformat-extra-args \
- -Wformat-nonliteral \
- -Wformat-overflow=2 \
- -Wformat-security \
- -Wformat-signedness \
- -Wformat-truncation=2 \
- -Wformat-y2k \
- -Wformat-zero-length \
- -Wformat=2 \
- -Wframe-address \
- -Wfree-nonheap-object \
- -Whsa \
- -Wif-not-aligned \
- -Wignored-attributes \
- -Wignored-qualifiers \
- -Wimplicit-fallthrough=5 \
- -Winaccessible-base \
- -Winherited-variadic-ctor \
- -Winit-list-lifetime \
- -Winit-self \
- -Winline \
- -Wint-in-bool-context \
- -Wint-to-pointer-cast \
- -Winvalid-memory-model \
- -Winvalid-offsetof \
- -Winvalid-pch \
- -Wliteral-suffix \
- -Wlogical-not-parentheses \
- -Wlogical-op \
- -Wno-long-long \
- -Wlto-type-mismatch \
- -Wmain \
- -Wmaybe-uninitialized \
- -Wmemset-elt-size \
- -Wmemset-transposed-args \
- -Wmisleading-indentation \
- -Wmismatched-dealloc \
- -Wmismatched-new-delete \
- -Wmismatched-tags \
- -Wmissing-attributes \
- -Wmissing-braces \
- -Wmissing-declarations \
- -Wmissing-field-initializers \
- -Wmissing-include-dirs \
- -Wmissing-profile \
- -Wmultichar \
- -Wmultiple-inheritance \
- -Wmultistatement-macros \
- -Wno-namespaces \
- -Wnarrowing \
- -Wnoexcept \
- -Wnoexcept-type \
- -Wnon-template-friend \
- -Wnon-virtual-dtor \
- -Wnonnull \
- -Wnonnull-compare \
- -Wnormalized=nfkc \
- -Wnull-dereference \
- -Wodr \
- -Wold-style-cast \
- -Wopenmp-simd \
- -Woverflow \
- -Woverlength-strings \
- -Woverloaded-virtual \
- -Wpacked \
- -Wpacked-bitfield-compat \
- -Wpacked-not-aligned \
- -Wno-padded \
- -Wparentheses \
- -Wpedantic \
- -Wpessimizing-move \
- -Wplacement-new=2 \
- -Wpmf-conversions \
- -Wpointer-arith \
- -Wpointer-compare \
- -Wpragmas \
- -Wprio-ctor-dtor \
- -Wpsabi \
- -Wrange-loop-construct \
- -Wredundant-decls \
- -Wredundant-move \
- -Wredundant-tags \
- -Wregister \
- -Wreorder \
- -Wrestrict \
- -Wreturn-local-addr \
- -Wreturn-type \
- -Wscalar-storage-order \
- -Wsequence-point \
- -Wshadow=compatible-local \
- -Wshadow=global \
- -Wshadow=local \
- -Wshift-count-negative \
- -Wshift-count-overflow \
- -Wshift-negative-value \
- -Wshift-overflow=2 \
- -Wsign-compare \
- -Wsign-conversion \
- -Wsign-promo \
- -Wsized-deallocation \
- -Wsizeof-array-argument \
- -Wsizeof-array-div \
- -Wsizeof-pointer-div \
- -Wsizeof-pointer-memaccess \
- -Wstack-protector \
- -Wstrict-aliasing \
- -Wstrict-aliasing=3 \
- -Wstrict-null-sentinel \
- -Wstrict-overflow \
- -Wstrict-overflow=5 \
- -Wstring-compare \
- -Wstringop-overflow=4 \
- -Wstringop-overread \
- -Wstringop-truncation \
- -Wsubobject-linkage \
- -Wsuggest-attribute=cold \
- -Wsuggest-attribute=const \
- -Wsuggest-attribute=format \
- -Wsuggest-attribute=malloc \
- -Wsuggest-attribute=noreturn \
- -Wsuggest-attribute=pure \
- -Wsuggest-final-methods \
- -Wsuggest-final-types \
- -Wsuggest-override \
- -Wswitch \
- -Wswitch-bool \
- -Wswitch-default \
- -Wswitch-enum \
- -Wswitch-outside-range \
- -Wswitch-unreachable \
- -Wsync-nand \
- -Wsynth \
- -Wno-system-headers \
- -Wtautological-compare \
- -Wno-templates \
- -Wterminate \
- -Wtrampolines \
- -Wtrigraphs \
- -Wtsan \
- -Wtype-limits \
- -Wundef \
- -Wuninitialized \
- -Wunknown-pragmas \
- -Wunreachable-code \
- -Wunsafe-loop-optimizations \
- -Wunused \
- -Wunused-but-set-parameter \
- -Wunused-but-set-variable \
- -Wunused-const-variable=2 \
- -Wunused-function \
- -Wunused-label \
- -Wunused-local-typedefs \
- -Wunused-macros \
- -Wunused-parameter \
- -Wunused-result \
- -Wunused-value \
- -Wunused-variable \
- -Wuseless-cast \
- -Wvarargs \
- -Wvariadic-macros \
- -Wvector-operation-performance \
- -Wvexing-parse \
- -Wvirtual-inheritance \
- -Wvirtual-move-assign \
- -Wvla \
- -Wvla-parameter \
- -Wvolatile \
- -Wvolatile-register-var \
- -Wwrite-strings \
- -Wzero-as-null-pointer-constant \
- -Wzero-length-bounds \
-")
+set(GCC_CXXFLAGS
+ -pedantic
+ -Werror
+ --all-warnings
+ --extra-warnings
+ -W
+ -WNSObject-attribute
+ -Wno-abi-tag
+ -Waddress
+ -Waddress-of-packed-member
+ -Wno-aggregate-return
+ -Waggressive-loop-optimizations
+ -Waligned-new=all
+ -Wall
+ -Walloc-zero
+ -Walloca
+ -Wanalyzer-double-fclose
+ -Wanalyzer-double-free
+ -Wanalyzer-exposure-through-output-file
+ -Wanalyzer-file-leak
+ -Wanalyzer-free-of-non-heap
+ -Wanalyzer-malloc-leak
+ -Wanalyzer-mismatching-deallocation
+ -Wanalyzer-null-argument
+ -Wanalyzer-null-dereference
+ -Wanalyzer-possible-null-argument
+ -Wanalyzer-possible-null-dereference
+ -Wanalyzer-shift-count-negative
+ -Wanalyzer-shift-count-overflow
+ -Wanalyzer-stale-setjmp-buffer
+ -Wanalyzer-tainted-allocation-size
+ -Wanalyzer-tainted-array-index
+ -Wanalyzer-tainted-divisor
+ -Wanalyzer-tainted-offset
+ -Wanalyzer-tainted-size
+ -Wanalyzer-too-complex
+ -Wanalyzer-unsafe-call-within-signal-handler
+ -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=2
+ -Warray-compare
+ -Warray-parameter=2
+ -Wattribute-alias=2
+ -Wattribute-warning
+ -Wattributes
+ -Wbool-compare
+ -Wbool-operation
+ -Wbuiltin-declaration-mismatch
+ -Wbuiltin-macro-redefined
+ -Wc++0x-compat
+ -Wc++11-compat
+ -Wc++11-extensions
+ -Wc++14-compat
+ -Wc++14-extensions
+ -Wc++17-compat
+ -Wc++17-extensions
+ -Wc++1z-compat
+ -Wc++20-compat
+ -Wc++20-extensions
+ -Wc++23-extensions
+ -Wc++2a-compat
+ -Wcannot-profile
+ -Wcast-align
+ -Wcast-align=strict
+ -Wcast-function-type
+ -Wcast-qual
+ -Wcatch-value=3
+ -Wchar-subscripts
+ -Wclass-conversion
+ -Wclass-memaccess
+ -Wclobbered
+ -Wcomma-subscript
+ -Wcomment
+ -Wcomments
+ -Wconditionally-supported
+ -Wconversion
+ -Wconversion-null
+ -Wcoverage-invalid-line-number
+ -Wcoverage-mismatch
+ -Wcpp
+ -Wctad-maybe-unsupported
+ -Wctor-dtor-privacy
+ -Wdangling-else
+ -Wdangling-pointer=2
+ -Wdate-time
+ -Wdelete-incomplete
+ -Wdelete-non-virtual-dtor
+ -Wdeprecated
+ -Wdeprecated-copy
+ -Wdeprecated-copy-dtor
+ -Wdeprecated-declarations
+ -Wdeprecated-enum-enum-conversion
+ -Wdeprecated-enum-float-conversion
+ -Wdisabled-optimization
+ -Wdiv-by-zero
+ -Wdouble-promotion
+ -Wduplicated-branches
+ -Wduplicated-cond
+ -Weffc++
+ -Wempty-body
+ -Wendif-labels
+ -Wenum-compare
+ -Wenum-conversion
+ -Wexceptions
+ -Wexpansion-to-defined
+ -Wextra
+ -Wextra-semi
+ -Wfloat-conversion
+ -Wfloat-equal
+ -Wformat-diag
+ -Wformat-overflow=2
+ -Wformat-signedness
+ -Wformat-truncation=2
+ -Wformat=2
+ -Wframe-address
+ -Wfree-nonheap-object
+ -Whsa
+ -Wif-not-aligned
+ -Wignored-attributes
+ -Wignored-qualifiers
+ -Wimplicit-fallthrough=5
+ -Winaccessible-base
+ -Winfinite-recursion
+ -Winherited-variadic-ctor
+ -Winit-list-lifetime
+ -Winit-self
+ -Winline
+ -Wint-in-bool-context
+ -Wint-to-pointer-cast
+ -Winterference-size
+ -Winvalid-imported-macros
+ -Winvalid-memory-model
+ -Winvalid-offsetof
+ -Winvalid-pch
+ -Wliteral-suffix
+ -Wlogical-not-parentheses
+ -Wlogical-op
+ -Wno-long-long
+ -Wlto-type-mismatch
+ -Wmain
+ -Wmaybe-uninitialized
+ -Wmemset-elt-size
+ -Wmemset-transposed-args
+ -Wmisleading-indentation
+ -Wmismatched-dealloc
+ -Wmismatched-new-delete
+ -Wmismatched-tags
+ -Wmissing-attributes
+ -Wmissing-braces
+ -Wmissing-declarations
+ -Wmissing-field-initializers
+ -Wmissing-include-dirs
+ -Wmissing-profile
+ -Wmissing-requires
+ -Wmissing-template-keyword
+ -Wmultichar
+ -Wmultiple-inheritance
+ -Wmultistatement-macros
+ -Wno-namespaces
+ -Wnarrowing
+ -Wnoexcept
+ -Wnoexcept-type
+ -Wnon-template-friend
+ -Wnon-virtual-dtor
+ -Wnonnull
+ -Wnonnull-compare
+ -Wnormalized=nfkc
+ -Wnull-dereference
+ -Wodr
+ -Wold-style-cast
+ -Wopenacc-parallelism
+ -Wopenmp-simd
+ -Woverflow
+ -Woverlength-strings
+ -Woverloaded-virtual
+ -Wpacked
+ -Wpacked-bitfield-compat
+ -Wpacked-not-aligned
+ -Wno-padded
+ -Wparentheses
+ -Wpedantic
+ -Wpessimizing-move
+ -Wplacement-new=2
+ -Wpmf-conversions
+ -Wpointer-arith
+ -Wpointer-compare
+ -Wpragmas
+ -Wprio-ctor-dtor
+ -Wpsabi
+ -Wrange-loop-construct
+ -Wredundant-decls
+ -Wredundant-move
+ -Wredundant-tags
+ -Wregister
+ -Wreorder
+ -Wrestrict
+ -Wreturn-local-addr
+ -Wreturn-type
+ -Wscalar-storage-order
+ -Wsequence-point
+ -Wshadow=compatible-local
+ -Wshadow=global
+ -Wshadow=local
+ -Wshift-count-negative
+ -Wshift-count-overflow
+ -Wshift-negative-value
+ -Wshift-overflow=2
+ -Wsign-compare
+ -Wsign-conversion
+ -Wsign-promo
+ -Wsized-deallocation
+ -Wsizeof-array-argument
+ -Wsizeof-array-div
+ -Wsizeof-pointer-div
+ -Wsizeof-pointer-memaccess
+ -Wstack-protector
+ -Wstrict-aliasing=3
+ -Wstrict-null-sentinel
+ -Wno-strict-overflow
+ -Wstring-compare
+ -Wstringop-overflow=4
+ -Wstringop-overread
+ -Wstringop-truncation
+ -Wsubobject-linkage
+ -Wsuggest-attribute=cold
+ -Wsuggest-attribute=const
+ -Wsuggest-attribute=format
+ -Wsuggest-attribute=malloc
+ -Wsuggest-attribute=noreturn
+ -Wsuggest-attribute=pure
+ -Wsuggest-final-methods
+ -Wsuggest-final-types
+ -Wsuggest-override
+ -Wswitch
+ -Wswitch-bool
+ -Wswitch-default
+ -Wswitch-enum
+ -Wswitch-outside-range
+ -Wswitch-unreachable
+ -Wsync-nand
+ -Wsynth
+ -Wno-system-headers
+ -Wtautological-compare
+ -Wno-templates
+ -Wterminate
+ -Wtrampolines
+ -Wtrigraphs
+ -Wtrivial-auto-var-init
+ -Wtsan
+ -Wtype-limits
+ -Wundef
+ -Wuninitialized
+ -Wunknown-pragmas
+ -Wunreachable-code
+ -Wunsafe-loop-optimizations
+ -Wunused
+ -Wunused-but-set-parameter
+ -Wunused-but-set-variable
+ -Wunused-const-variable=2
+ -Wunused-function
+ -Wunused-label
+ -Wunused-local-typedefs
+ -Wunused-macros
+ -Wunused-parameter
+ -Wunused-result
+ -Wunused-value
+ -Wunused-variable
+ -Wuse-after-free=3
+ -Wuseless-cast
+ -Wvarargs
+ -Wvariadic-macros
+ -Wvector-operation-performance
+ -Wvexing-parse
+ -Wvirtual-inheritance
+ -Wvirtual-move-assign
+ -Wvla
+ -Wvla-parameter
+ -Wvolatile
+ -Wvolatile-register-var
+ -Wwrite-strings
+ -Wzero-as-null-pointer-constant
+ -Wzero-length-bounds
+)
add_custom_target(ci_test_gcc
- COMMAND CXX=${GCC_TOOL} CXXFLAGS=${GCC_CXXFLAGS} ${CMAKE_COMMAND}
+ 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
@@ -406,9 +424,9 @@
)
add_custom_target(ci_test_clang
- COMMAND CXX=${CLANG_TOOL} CXXFLAGS=${CLANG_CXXFLAGS} ${CMAKE_COMMAND}
+ 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
@@ -421,10 +439,10 @@
foreach(CXX_STANDARD 11 14 17 20)
add_custom_target(ci_test_gcc_cxx${CXX_STANDARD}
- COMMAND CXX=${GCC_TOOL} ${CMAKE_COMMAND}
+ COMMAND CXX=${GCC_TOOL} CXXFLAGS="${GCC_CXXFLAGS}" ${CMAKE_COMMAND}
-DCMAKE_BUILD_TYPE=Debug -GNinja
- -DCMAKE_CXX_STANDARD=${CXX_STANDARD} -DCMAKE_CXX_STANDARD_REQUIRED=ON
-DJSON_BuildTests=ON -DJSON_FastTests=ON
+ -DJSON_TestStandards=${CXX_STANDARD}
-S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_gcc_cxx${CXX_STANDARD}
COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_gcc_cxx${CXX_STANDARD}
COMMAND cd ${PROJECT_BINARY_DIR}/build_gcc_cxx${CXX_STANDARD} && ${CMAKE_CTEST_COMMAND} --parallel ${N} --output-on-failure
@@ -432,10 +450,10 @@
)
add_custom_target(ci_test_clang_cxx${CXX_STANDARD}
- COMMAND CXX=${CLANG_TOOL} ${CMAKE_COMMAND}
+ COMMAND CXX=${CLANG_TOOL} CXXFLAGS="${CLANG_CXXFLAGS}" ${CMAKE_COMMAND}
-DCMAKE_BUILD_TYPE=Debug -GNinja
- -DCMAKE_CXX_STANDARD=${CXX_STANDARD} -DCMAKE_CXX_STANDARD_REQUIRED=ON
- -DJSON_BuildTests=ON
+ -DJSON_BuildTests=ON -DJSON_FastTests=ON
+ -DJSON_TestStandards=${CXX_STANDARD}
-S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_clang_cxx${CXX_STANDARD}
COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_clang_cxx${CXX_STANDARD}
COMMAND cd ${PROJECT_BINARY_DIR}/build_clang_cxx${CXX_STANDARD} && ${CMAKE_CTEST_COMMAND} --parallel ${N} --output-on-failure
@@ -450,7 +468,7 @@
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
@@ -464,7 +482,7 @@
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
@@ -478,7 +496,7 @@
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
@@ -486,20 +504,55 @@
)
###############################################################################
+# 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_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"
+)
+
+###############################################################################
+# Disable global UDLs.
+###############################################################################
+
+add_custom_target(ci_test_noglobaludls
+ COMMAND CXX=${CLANG_TOOL} ${CMAKE_COMMAND}
+ -DCMAKE_BUILD_TYPE=Debug -GNinja
+ -DJSON_BuildTests=ON -DJSON_FastTests=ON -DJSON_UseGlobalUDLs=OFF
+ -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_noglobaludls
+ COMMAND ${CMAKE_COMMAND} --build ${PROJECT_BINARY_DIR}/build_noglobaludls
+ COMMAND cd ${PROJECT_BINARY_DIR}/build_noglobaludls && ${CMAKE_CTEST_COMMAND} --parallel ${N} --output-on-failure
+ COMMENT "Compile and test with global UDLs disabled"
+)
+
+###############################################################################
# Coverage.
###############################################################################
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}/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"
@@ -529,16 +582,16 @@
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
@@ -546,7 +599,21 @@
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"
+)
+
+###############################################################################
+# 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_MultipleHeaders=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"
)
###############################################################################
@@ -592,7 +659,7 @@
###############################################################################
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"
)
@@ -632,7 +699,7 @@
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"
@@ -659,7 +726,7 @@
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"
)
@@ -670,7 +737,7 @@
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
@@ -685,6 +752,7 @@
###############################################################################
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}
@@ -756,50 +824,68 @@
# CMake flags
###############################################################################
-if (APPLE)
- set(CMAKE_310_BINARY ${PROJECT_BINARY_DIR}/cmake-3.1.0-Darwin64/CMake.app/Contents/bin/cmake)
- add_custom_command(
- OUTPUT ${CMAKE_310_BINARY}
- COMMAND wget https://github.com/Kitware/CMake/releases/download/v3.1.0/cmake-3.1.0-Darwin64.tar.gz
- COMMAND tar xfz cmake-3.1.0-Darwin64.tar.gz
- COMMAND rm cmake-3.1.0-Darwin64.tar.gz
- WORKING_DIRECTORY ${PROJECT_BINARY_DIR}
- COMMENT "Download CMake 3.1.0"
- )
-else()
- set(CMAKE_310_BINARY ${PROJECT_BINARY_DIR}/cmake-3.1.0-Linux-x86_64/bin/cmake)
- add_custom_command(
- OUTPUT ${CMAKE_310_BINARY}
- COMMAND wget https://github.com/Kitware/CMake/releases/download/v3.1.0/cmake-3.1.0-Linux-x86_64.tar.gz
- COMMAND tar xfz cmake-3.1.0-Linux-x86_64.tar.gz
- COMMAND rm cmake-3.1.0-Linux-x86_64.tar.gz
- WORKING_DIRECTORY ${PROJECT_BINARY_DIR}
- COMMENT "Download CMake 3.1.0"
- )
-endif()
+function(ci_get_cmake version var)
+ if (APPLE)
+ set(${var} ${PROJECT_BINARY_DIR}/cmake-${version}-Darwin64/CMake.app/Contents/bin/cmake)
+ add_custom_command(
+ OUTPUT ${${var}}
+ COMMAND wget -nc https://github.com/Kitware/CMake/releases/download/v${version}/cmake-${version}-Darwin64.tar.gz
+ COMMAND tar xfz cmake-${version}-Darwin64.tar.gz
+ COMMAND rm cmake-${version}-Darwin64.tar.gz
+ WORKING_DIRECTORY ${PROJECT_BINARY_DIR}
+ COMMENT "Download CMake ${version}"
+ )
+ else()
+ set(${var} ${PROJECT_BINARY_DIR}/cmake-${version}-Linux-x86_64/bin/cmake)
+ add_custom_command(
+ OUTPUT ${${var}}
+ COMMAND wget -nc https://github.com/Kitware/CMake/releases/download/v${version}/cmake-${version}-Linux-x86_64.tar.gz
+ COMMAND tar xfz cmake-${version}-Linux-x86_64.tar.gz
+ COMMAND rm cmake-${version}-Linux-x86_64.tar.gz
+ WORKING_DIRECTORY ${PROJECT_BINARY_DIR}
+ COMMENT "Download CMake ${version}"
+ )
+ endif()
+ set(${var} ${${var}} PARENT_SCOPE)
+endfunction()
-set(JSON_CMAKE_FLAGS "JSON_BuildTests;JSON_Install;JSON_MultipleHeaders;JSON_ImplicitConversions;JSON_Valgrind;JSON_Diagnostics;JSON_SystemInclude")
+ci_get_cmake(3.1.0 CMAKE_3_1_0_BINARY)
+ci_get_cmake(3.13.0 CMAKE_3_13_0_BINARY)
-foreach(JSON_CMAKE_FLAG ${JSON_CMAKE_FLAGS})
- string(TOLOWER "ci_cmake_flag_${JSON_CMAKE_FLAG}" JSON_CMAKE_FLAG_TARGET)
- add_custom_target("${JSON_CMAKE_FLAG_TARGET}"
- COMMENT "Check CMake flag ${JSON_CMAKE_FLAG} (CMake ${CMAKE_VERSION})"
+set(JSON_CMAKE_FLAGS_3_1_0 JSON_Diagnostics JSON_GlobalUDLs 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)
+ string(TOLOWER "ci_cmake_flag_${flag}" flag_target)
+ string(REPLACE . _ min_version_var ${min_version})
+ set(cmake_binary ${CMAKE_${min_version_var}_BINARY})
+ add_custom_target(${flag_target}
+ COMMENT "Check CMake flag ${flag} (CMake ${CMAKE_VERSION})"
COMMAND ${CMAKE_COMMAND}
-Werror=dev
- -D${JSON_CMAKE_FLAG}=ON
- -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_${JSON_CMAKE_FLAG_TARGET}
+ -D${flag}=ON
+ -S${PROJECT_SOURCE_DIR} -B${PROJECT_BINARY_DIR}/build_${flag_target}
)
- add_custom_target("${JSON_CMAKE_FLAG_TARGET}_31"
- COMMENT "Check CMake flag ${JSON_CMAKE_FLAG} (CMake 3.1)"
- COMMAND mkdir ${PROJECT_BINARY_DIR}/build_${JSON_CMAKE_FLAG_TARGET}_31
- COMMAND cd ${PROJECT_BINARY_DIR}/build_${JSON_CMAKE_FLAG_TARGET}_31 && ${CMAKE_310_BINARY}
- -Werror=dev ${PROJECT_SOURCE_DIR}
- -D${JSON_CMAKE_FLAG}=ON
- -DCMAKE_CXX_COMPILE_FEATURES="cxx_range_for" -DCMAKE_CXX_FLAGS="-std=gnu++11"
- DEPENDS ${CMAKE_310_BINARY}
+ add_custom_target(${flag_target}_${min_version_var}
+ COMMENT "Check CMake flag ${JSON_CMAKE_FLAG} (CMake ${min_version})"
+ COMMAND mkdir -pv ${PROJECT_BINARY_DIR}/build_${flag_target}_${min_version_var}
+ COMMAND cd ${PROJECT_BINARY_DIR}/build_${flag_target}_${min_version_var}
+ && ${cmake_binary} -Werror=dev ${PROJECT_SOURCE_DIR} -D${flag}=ON
+ DEPENDS ${cmake_binary}
)
- list(APPEND JSON_CMAKE_FLAG_TARGETS ${JSON_CMAKE_FLAG_TARGET} ${JSON_CMAKE_FLAG_TARGET}_31)
- list(APPEND JSON_CMAKE_FLAG_BUILD_DIRS ${PROJECT_BINARY_DIR}/build_${JSON_CMAKE_FLAG_TARGET} ${PROJECT_BINARY_DIR}/build_${JSON_CMAKE_FLAG_TARGET}_31)
+ list(APPEND JSON_CMAKE_FLAG_TARGETS ${JSON_CMAKE_FLAG_TARGET} ${flag_target}_${min_version_var})
+ list(APPEND JSON_CMAKE_FLAG_BUILD_DIRS ${PROJECT_BINARY_DIR}/build_${flag_target} ${PROJECT_BINARY_DIR}/build_${flag_target}_${min_version_var})
+ set(JSON_CMAKE_FLAG_TARGETS ${JSON_CMAKE_FLAG_TARGETS} PARENT_SCOPE)
+ set(JSON_CMAKE_FLAG_BUILD_DIRS ${JSON_CMAKE_FLAG_BUILD_DIRS} PARENT_SCOPE)
+endfunction()
+
+foreach(JSON_CMAKE_FLAG ${JSON_CMAKE_FLAGS_3_1_0})
+ ci_add_cmake_flags_targets(${JSON_CMAKE_FLAG} 3.1.0)
+endforeach()
+
+foreach(JSON_CMAKE_FLAG ${JSON_CMAKE_FLAGS_3_13_0})
+ ci_add_cmake_flags_targets(${JSON_CMAKE_FLAG} 3.13.0)
endforeach()
add_custom_target(ci_cmake_flags
@@ -811,7 +897,7 @@
# 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)
+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")
@@ -843,11 +929,36 @@
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
)
###############################################################################
+# 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"
+)
+
+###############################################################################
+# test documentation
+###############################################################################
+
+add_custom_target(ci_test_documentation
+ COMMAND make CXX="${GCC_TOOL}" check_output_portable -j8
+ WORKING_DIRECTORY ${PROJECT_SOURCE_DIR}/docs
+ COMMENT "Check that all examples compile and create the desired output"
+)
+
+###############################################################################
# Clean up all generated files.
###############################################################################
diff --git a/cmake/download_test_data.cmake b/cmake/download_test_data.cmake
index f516a7c..1bb998d 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/cmake/test.cmake b/cmake/test.cmake
new file mode 100644
index 0000000..bb840c6
--- /dev/null
+++ b/cmake/test.cmake
@@ -0,0 +1,273 @@
+set(_json_test_cmake_list_file ${CMAKE_CURRENT_LIST_FILE})
+
+#############################################################################
+# download test data
+#############################################################################
+
+include(download_test_data)
+
+# test fixture to download test data
+add_test(NAME "download_test_data" COMMAND ${CMAKE_COMMAND} --build ${CMAKE_BINARY_DIR}
+ --target download_test_data
+)
+set_tests_properties(download_test_data PROPERTIES FIXTURES_SETUP TEST_DATA)
+
+if(JSON_Valgrind)
+ find_program(CMAKE_MEMORYCHECK_COMMAND valgrind)
+ message(STATUS "Executing test suite with Valgrind (${CMAKE_MEMORYCHECK_COMMAND})")
+ set(memcheck_command "${CMAKE_MEMORYCHECK_COMMAND} ${CMAKE_MEMORYCHECK_COMMAND_OPTIONS} --error-exitcode=1 --leak-check=full")
+ separate_arguments(memcheck_command)
+endif()
+
+#############################################################################
+# detect standard support
+#############################################################################
+
+# C++11 is the minimum required
+set(compiler_supports_cpp_11 TRUE)
+
+foreach(feature ${CMAKE_CXX_COMPILE_FEATURES})
+ if (${feature} STREQUAL cxx_std_14)
+ set(compiler_supports_cpp_14 TRUE)
+ elseif (${feature} STREQUAL cxx_std_17)
+ set(compiler_supports_cpp_17 TRUE)
+ elseif (${feature} STREQUAL cxx_std_20)
+ set(compiler_supports_cpp_20 TRUE)
+ elseif (${feature} STREQUAL cxx_std_23)
+ set(compiler_supports_cpp_23 TRUE)
+ endif()
+endforeach()
+
+#############################################################################
+# test functions
+#############################################################################
+
+#############################################################################
+# json_test_set_test_options(
+# all|<tests>
+# [CXX_STANDARDS all|<args>...]
+# [COMPILE_DEFINITIONS <args>...]
+# [COMPILE_FEATURES <args>...]
+# [COMPILE_OPTIONS <args>...]
+# [LINK_LIBRARIES <args>...]
+# [LINK_OPTIONS <args>...]
+# [TEST_PROPERTIES <args>...])
+#
+# Supply test- and standard-specific build settings and/or test properties.
+# Specify multiple tests using a list e.g., "test-foo;test-bar".
+#
+# Must be called BEFORE the test is created.
+#############################################################################
+
+function(json_test_set_test_options tests)
+ cmake_parse_arguments(args "" ""
+ "CXX_STANDARDS;COMPILE_DEFINITIONS;COMPILE_FEATURES;COMPILE_OPTIONS;LINK_LIBRARIES;LINK_OPTIONS;TEST_PROPERTIES"
+ ${ARGN})
+
+ if(NOT args_CXX_STANDARDS)
+ set(args_CXX_STANDARDS "all")
+ endif()
+
+ foreach(test ${tests})
+ if("${test}" STREQUAL "all")
+ set(test "")
+ endif()
+
+ foreach(cxx_standard ${args_CXX_STANDARDS})
+ if("${cxx_standard}" STREQUAL "all")
+ if("${test}" STREQUAL "")
+ message(FATAL_ERROR "Not supported. Change defaults in: ${_json_test_cmake_list_file}")
+ endif()
+ set(test_interface _json_test_interface_${test})
+ else()
+ set(test_interface _json_test_interface_${test}_cpp_${cxx_standard})
+ endif()
+
+ if(NOT TARGET ${test_interface})
+ add_library(${test_interface} INTERFACE)
+ endif()
+
+ target_compile_definitions(${test_interface} INTERFACE ${args_COMPILE_DEFINITIONS})
+ target_compile_features(${test_interface} INTERFACE ${args_COMPILE_FEATURES})
+ target_compile_options(${test_interface} INTERFACE ${args_COMPILE_OPTIONS})
+ target_link_libraries (${test_interface} INTERFACE ${args_LINK_LIBRARIES})
+ target_link_options(${test_interface} INTERFACE ${args_LINK_OPTIONS})
+ #set_target_properties(${test_interface} PROPERTIES JSON_TEST_PROPERTIES "${args_TEST_PROPERTIES}")
+ set_property(DIRECTORY PROPERTY
+ ${test_interface}_TEST_PROPERTIES "${args_TEST_PROPERTIES}"
+ )
+ endforeach()
+ endforeach()
+endfunction()
+
+# for internal use by _json_test_add_test()
+function(_json_test_apply_test_properties test_target properties_target)
+ #get_target_property(test_properties ${properties_target} JSON_TEST_PROPERTIES)
+ get_property(test_properties DIRECTORY PROPERTY ${properties_target}_TEST_PROPERTIES)
+ if(test_properties)
+ set_tests_properties(${test_target} PROPERTIES ${test_properties})
+ endif()
+endfunction()
+
+# for internal use by json_test_add_test_for()
+function(_json_test_add_test test_name file main cxx_standard)
+ set(test_target ${test_name}_cpp${cxx_standard})
+
+ if(TARGET ${test_target})
+ message(FATAL_ERROR "Target ${test_target} has already been added.")
+ endif()
+
+ add_executable(${test_target} ${file})
+ target_link_libraries(${test_target} PRIVATE ${main})
+
+ # set and require C++ standard
+ set_target_properties(${test_target} PROPERTIES
+ CXX_STANDARD ${cxx_standard}
+ CXX_STANDARD_REQUIRED ON
+ )
+
+ # apply standard-specific build settings
+ if(TARGET _json_test_interface__cpp_${cxx_standard})
+ target_link_libraries(${test_target} PRIVATE _json_test_interface__cpp_${cxx_standard})
+ endif()
+
+ # apply test-specific build settings
+ if(TARGET _json_test_interface_${test_name})
+ target_link_libraries(${test_target} PRIVATE _json_test_interface_${test_name})
+ endif()
+
+ # apply test- and standard-specific build settings
+ if(TARGET _json_test_interface_${test_name}_cpp_${cxx_standard})
+ target_link_libraries(${test_target} PRIVATE
+ _json_test_interface_${test_name}_cpp_${cxx_standard}
+ )
+ endif()
+
+ if (JSON_FastTests)
+ add_test(NAME ${test_target}
+ COMMAND ${test_target} ${DOCTEST_TEST_FILTER}
+ WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+ )
+ else()
+ add_test(NAME ${test_target}
+ COMMAND ${test_target} ${DOCTEST_TEST_FILTER} --no-skip
+ WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+ )
+ endif()
+ set_tests_properties(${test_target} PROPERTIES LABELS "all" FIXTURES_REQUIRED TEST_DATA)
+
+ # apply standard-specific test properties
+ if(TARGET _json_test_interface__cpp_${cxx_standard})
+ _json_test_apply_test_properties(${test_target} _json_test_interface__cpp_${cxx_standard})
+ endif()
+
+ # apply test-specific test properties
+ if(TARGET _json_test_interface_${test_name})
+ _json_test_apply_test_properties(${test_target} _json_test_interface_${test_name})
+ endif()
+
+ # apply test- and standard-specific test properties
+ if(TARGET _json_test_interface_${test_name}_cpp_${cxx_standard})
+ _json_test_apply_test_properties(${test_target}
+ _json_test_interface_${test_name}_cpp_${cxx_standard}
+ )
+ endif()
+
+ if(JSON_Valgrind)
+ add_test(NAME ${test_target}_valgrind
+ COMMAND ${memcheck_command} $<TARGET_FILE:${test_target}> ${DOCTEST_TEST_FILTER}
+ WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+ )
+ set_tests_properties(${test_target}_valgrind PROPERTIES
+ LABELS "valgrind" FIXTURES_REQUIRED TEST_DATA
+ )
+ endif()
+endfunction()
+
+#############################################################################
+# json_test_add_test_for(
+# <file>
+# [NAME <name>]
+# MAIN <main>
+# [CXX_STANDARDS <version_number>...] [FORCE])
+#
+# Given a <file> unit-foo.cpp, produces
+#
+# test-foo_cpp<version_number>
+#
+# 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>.
+# CXX_STANDARDS defaults to "11".
+#############################################################################
+
+function(json_test_add_test_for file)
+ 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()
+
+ file(READ ${file} file_content)
+ foreach(cxx_standard ${args_CXX_STANDARDS})
+ if(NOT compiler_supports_cpp_${cxx_standard})
+ continue()
+ endif()
+
+ # add unconditionally if C++11 (default) or forced
+ if(NOT ("${cxx_standard}" STREQUAL 11 OR args_FORCE))
+ string(FIND "${file_content}" JSON_HAS_CPP_${cxx_standard} has_cpp_found)
+ if(${has_cpp_found} EQUAL -1)
+ continue()
+ endif()
+ endif()
+
+ _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/doc/Makefile b/doc/Makefile
deleted file mode 100644
index 0de57e0..0000000
--- a/doc/Makefile
+++ /dev/null
@@ -1,34 +0,0 @@
-SRCDIR = ../single_include
-
-all: create_output
-
-##########################################################################
-# example files
-##########################################################################
-
-# where are the example cpp files
-EXAMPLES = $(wildcard examples/*.cpp)
-
-# create output from a stand-alone example file
-%.output: %.cpp
- make $(<:.cpp=) CPPFLAGS="-I $(SRCDIR)" CXXFLAGS="-std=c++11"
- ./$(<:.cpp=) > $@
- rm $(<:.cpp=)
-
-# compare created output with current output of the example files
-%.test: %.cpp
- make $(<:.cpp=) CPPFLAGS="-I $(SRCDIR)" CXXFLAGS="-std=c++11"
- ./$(<:.cpp=) > $@
- diff $@ $(<:.cpp=.output)
- rm $(<:.cpp=) $@
-
-# create output from all stand-alone example files
-create_output: $(EXAMPLES:.cpp=.output)
-
-# check output of all stand-alone example files
-check_output: $(EXAMPLES:.cpp=.test)
-
-clean:
- rm -fr $(EXAMPLES:.cpp=)
- $(MAKE) clean -C docset
- $(MAKE) clean -C mkdocs
diff --git a/doc/avatars.png b/doc/avatars.png
deleted file mode 100644
index 5124358..0000000
--- a/doc/avatars.png
+++ /dev/null
Binary files differ
diff --git a/doc/docset/Makefile b/doc/docset/Makefile
deleted file mode 100644
index e538661..0000000
--- a/doc/docset/Makefile
+++ /dev/null
@@ -1,25 +0,0 @@
-JSON_for_Modern_C++.docset: Info.plist docSet.sql
- $(MAKE) clean
- mkdir -p JSON_for_Modern_C++.docset/Contents/Resources/Documents/
- cp icon*.png JSON_for_Modern_C++.docset
- cp Info.plist JSON_for_Modern_C++.docset/Contents
- # build and copy documentation
- $(MAKE) build -C ../mkdocs
- cp -r ../mkdocs/site/* JSON_for_Modern_C++.docset/Contents/Resources/Documents
- # patch CSS to hide navigation items
- echo "\n\nheader, footer, navi, div.md-sidebar--primary, nav.md-tabs--active, a.md-content__button { display: none; }" >> "$$(ls JSON_for_Modern_C++.docset/Contents/Resources/Documents/assets/stylesheets/main.*.min.css)"
- # fix spacing
- echo "\n\ndiv.md-sidebar div.md-sidebar--secondary, div.md-main__inner { top: 0; margin-top: 0 }" >> "$$(ls JSON_for_Modern_C++.docset/Contents/Resources/Documents/assets/stylesheets/main.*.min.css)"
- # remove "JSON for Modern C++" from page titles
- find JSON_for_Modern_C++.docset/Contents/Resources/Documents -type f -exec gsed -i 's| - JSON for Modern C++</title>|</title>|' {} +
- # clean up
- rm JSON_for_Modern_C++.docset/Contents/Resources/Documents/hooks.py
- rm JSON_for_Modern_C++.docset/Contents/Resources/Documents/sitemap.*
- # generate index
- sqlite3 JSON_for_Modern_C++.docset/Contents/Resources/docSet.dsidx < docSet.sql
-
-JSON_for_Modern_C++.tgz: JSON_for_Modern_C++.docset
- tar --exclude='.DS_Store' -cvzf JSON_for_Modern_C++.tgz JSON_for_Modern_C++.docset
-
-clean:
- rm -fr JSON_for_Modern_C++.docset JSON_for_Modern_C++.tgz
diff --git a/doc/docset/docSet.sql b/doc/docset/docSet.sql
deleted file mode 100644
index 8bd4e06..0000000
--- a/doc/docset/docSet.sql
+++ /dev/null
@@ -1,155 +0,0 @@
-DROP TABLE IF EXISTS searchIndex;
-CREATE TABLE searchIndex(id INTEGER PRIMARY KEY, name TEXT, type TEXT, path TEXT);
-CREATE UNIQUE INDEX anchor ON searchIndex (name, type, path);
-
--- API
-INSERT INTO searchIndex(name, type, path) VALUES ('accept', 'Function', 'api/basic_json/accept/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('adl_serializer', 'Class', 'api/adl_serializer/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('array', 'Function', 'api/basic_json/array/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('array_t', 'Type', 'api/basic_json/array_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('at', 'Method', 'api/basic_json/at/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('back', 'Method', 'api/basic_json/back/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('basic_json', 'Class', 'api/basic_json/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('basic_json', 'Constructor', 'api/basic_json/basic_json/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('begin', 'Method', 'api/basic_json/begin/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('binary', 'Function', 'api/basic_json/binary/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('binary_t', 'Type', 'api/basic_json/binary_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('boolean_t', 'Type', 'api/basic_json/boolean_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('cbegin', 'Method', 'api/basic_json/cbegin/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('cbor_tag_handler_t', 'Enum', 'api/basic_json/cbor_tag_handler_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('cend', 'Method', 'api/basic_json/cend/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('clear', 'Method', 'api/basic_json/clear/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('contains', 'Method', 'api/basic_json/contains/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('count', 'Method', 'api/basic_json/count/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('crbegin', 'Method', 'api/basic_json/crbegin/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('crend', 'Method', 'api/basic_json/crend/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('diff', 'Function', 'api/basic_json/diff/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('dump', 'Method', 'api/basic_json/dump/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('emplace', 'Method', 'api/basic_json/emplace/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('emplace_back', 'Method', 'api/basic_json/emplace_back/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('empty', 'Method', 'api/basic_json/empty/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('end', 'Method', 'api/basic_json/end/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('erase', 'Method', 'api/basic_json/erase/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('error_handler_t', 'Enum', 'api/basic_json/error_handler_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('exception', 'Class', 'api/basic_json/exception/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('find', 'Method', 'api/basic_json/find/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('flatten', 'Method', 'api/basic_json/flatten/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('from_bson', 'Function', 'api/basic_json/from_bson/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('from_cbor', 'Function', 'api/basic_json/from_cbor/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('from_msgpack', 'Function', 'api/basic_json/from_msgpack/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('from_ubjson', 'Function', 'api/basic_json/from_ubjson/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('front', 'Method', 'api/basic_json/front/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('get', 'Method', 'api/basic_json/get/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('get_allocator', 'Function', 'api/basic_json/get_allocator/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('get_binary', 'Method', 'api/basic_json/get_binary/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('get_ptr', 'Method', 'api/basic_json/get_ptr/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('get_ref', 'Method', 'api/basic_json/get_ref/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('get_to', 'Method', 'api/basic_json/get_to/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('input_format_t', 'Enum', 'api/basic_json/input_format_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('insert', 'Method', 'api/basic_json/insert/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('invalid_iterator', 'Class', 'api/basic_json/invalid_iterator/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('is_array', 'Method', 'api/basic_json/is_array/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('is_binary', 'Method', 'api/basic_json/is_binary/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('is_boolean', 'Method', 'api/basic_json/is_boolean/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('is_discarded', 'Method', 'api/basic_json/is_discarded/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('is_null', 'Method', 'api/basic_json/is_null/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('is_number', 'Method', 'api/basic_json/is_number/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('is_number_float', 'Method', 'api/basic_json/is_number_float/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('is_number_integer', 'Method', 'api/basic_json/is_number_integer/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('is_number_unsigned', 'Method', 'api/basic_json/is_number_unsigned/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('is_object', 'Method', 'api/basic_json/is_object/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('is_primitive', 'Method', 'api/basic_json/is_primitive/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('is_string', 'Method', 'api/basic_json/is_string/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('is_structured', 'Method', 'api/basic_json/is_structured/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('items', 'Method', 'api/basic_json/items/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('json', 'Class', 'api/json/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('json_pointer', 'Class', 'api/json_pointer/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('json_serializer', 'Type', 'api/basic_json/json_serializer/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('max_size', 'Method', 'api/basic_json/max_size/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('merge_patch', 'Method', 'api/basic_json/merge_patch/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('meta', 'Function', 'api/basic_json/meta/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('number_float_t', 'Type', 'api/basic_json/number_float_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('number_integer_t', 'Type', 'api/basic_json/number_integer_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('number_unsigned_t', 'Type', 'api/basic_json/number_unsigned_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('object', 'Function', 'api/basic_json/object/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('object_comparator_t', 'Type', 'api/basic_json/object_comparator_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('object_t', 'Type', 'api/basic_json/object_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('operator!=', 'Operator', 'api/basic_json/operator_ne/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('operator+=', 'Operator', 'api/basic_json/operator+=/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('operator=', 'Operator', 'api/basic_json/operator=/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('operator==', 'Operator', 'api/basic_json/operator_eq/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('operator<', 'Operator', 'api/basic_json/operator_lt/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('operator<=', 'Operator', 'api/basic_json/operator_le/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('operator>', 'Operator', 'api/basic_json/operator_gt/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('operator>=', 'Operator', 'api/basic_json/operator_ge/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('operator[]', 'Operator', 'api/basic_json/operator[]/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('operator""_json', 'Literal', 'api/basic_json/operator_literal_json/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('operator""_json_pointer', 'Literal', 'api/basic_json/operator_literal_json_pointer/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('operator ValueType', 'Operator', 'api/basic_json/operator_ValueType/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('operator value_t', 'Operator', 'api/basic_json/operator_value_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('ordered_json', 'Class', 'api/ordered_json/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('ordered_map', 'Class', 'api/ordered_map/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('out_of_range', 'Class', 'api/basic_json/out_of_range/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('other_error', 'Class', 'api/basic_json/other_error/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('parse', 'Function', 'api/basic_json/parse/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('parse_error', 'Class', 'api/basic_json/parse_error/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('parse_event_t', 'Enum', 'api/basic_json/parse_event_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('parser_callback_t', 'Type', 'api/basic_json/parser_callback_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('patch', 'Method', 'api/basic_json/patch/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('push_back', 'Method', 'api/basic_json/push_back/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('rbegin', 'Method', 'api/basic_json/rbegin/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('rend', 'Method', 'api/basic_json/rend/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('sax_parse', 'Function', 'api/basic_json/sax_parse/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('size', 'Method', 'api/basic_json/size/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('string_t', 'Type', 'api/basic_json/string_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('type', 'Method', 'api/basic_json/type/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('type_error', 'Class', 'api/basic_json/type_error/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('type_name', 'Method', 'api/basic_json/type_name/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('unflatten', 'Method', 'api/basic_json/unflatten/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('update', 'Method', 'api/basic_json/update/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('to_bson', 'Function', 'api/basic_json/to_bson/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('to_cbor', 'Function', 'api/basic_json/to_cbor/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('to_msgpack', 'Function', 'api/basic_json/to_msgpack/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('to_ubjson', 'Function', 'api/basic_json/to_ubjson/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('value', 'Method', 'api/basic_json/value/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('value_t', 'Enum', 'api/basic_json/value_t/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('~basic_json', 'Method', 'api/basic_json/~basic_json/index.html');
-
--- Features
-INSERT INTO searchIndex(name, type, path) VALUES ('Binary Formats', 'Guide', 'features/binary_formats/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('BSON', 'Guide', 'features/binary_formats/bson/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('CBOR', 'Guide', 'features/binary_formats/cbor/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('MessagePack', 'Guide', 'features/binary_formats/messagepack/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('UBJSON', 'Guide', 'features/binary_formats/ubjson/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('Supported Macros', 'Guide', 'features/macros/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('Binary Values', 'Guide', 'features/binary_values/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('Comments', 'Guide', 'features/comments/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('Iterators', 'Guide', 'features/iterators/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('Types', 'Guide', 'features/types/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('Number Handling', 'Guide', 'features/types/number_handling/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('Element Access', 'Guide', 'features/element_access/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('JSON Pointer', 'Guide', 'features/json_pointer/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('JSON Patch and Diff', 'Guide', 'features/json_patch/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('JSON Merge Patch', 'Guide', 'features/merge_patch/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('Object Order', 'Guide', 'features/object_order/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('Parsing and Exceptions', 'Guide', 'features/parsing/parse_exceptions/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('Parser Callbacks', 'Guide', 'features/parsing/parser_callbacks/index.html');
-INSERT INTO searchIndex(name, type, path) VALUES ('SAX Interface', 'Guide', 'features/parsing/sax_interface/index.html');
-
--- Macros
-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_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');
-INSERT INTO searchIndex(name, type, path) VALUES ('JSON_HAS_CPP_20', '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_NOEXCEPTION', 'Macro', 'features/macros/index.html#json_noexception');
-INSERT INTO searchIndex(name, type, path) VALUES ('JSON_NO_IO', 'Macro', 'features/macros/index.html#json_no_io');
-INSERT INTO searchIndex(name, type, path) VALUES ('JSON_SKIP_UNSUPPORTED_COMPILER_CHECK', 'Macro', 'features/macros/index.html#json_skip_unsupported_compiler_check');
-INSERT INTO searchIndex(name, type, path) VALUES ('JSON_THROW_USER', 'Macro', 'features/macros/index.html#json_throw_userexception');
-INSERT INTO searchIndex(name, type, path) VALUES ('JSON_TRY_USER', 'Macro', 'features/macros/index.html#json_try_user');
-INSERT INTO searchIndex(name, type, path) VALUES ('JSON_USE_IMPLICIT_CONVERSIONS', 'Macro', 'features/macros/index.html#json_use_implicit_conversions');
-INSERT INTO searchIndex(name, type, path) VALUES ('NLOHMANN_DEFINE_TYPE_INTRUSIVE', 'Macro', 'features/macros/index.html#nlohmann_define_type_intrusivetype-member');
-INSERT INTO searchIndex(name, type, path) VALUES ('NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE', 'Macro', 'features/macros/index.html#nlohmann_define_type_non_intrusivetype-member');
-INSERT INTO searchIndex(name, type, path) VALUES ('NLOHMANN_JSON_SERIALIZE_ENUM', 'Macro', 'features/macros/index.html#nlohmann_json_serialize_enumtype');
diff --git a/doc/examples/iterator_wrapper.cpp b/doc/examples/iterator_wrapper.cpp
deleted file mode 100644
index 84d3725..0000000
--- a/doc/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/doc/examples/iterator_wrapper.output b/doc/examples/iterator_wrapper.output
deleted file mode 100644
index 89b09f5..0000000
--- a/doc/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/doc/examples/json_pointer__back.cpp b/doc/examples/json_pointer__back.cpp
deleted file mode 100644
index 3d57c58..0000000
--- a/doc/examples/json_pointer__back.cpp
+++ /dev/null
@@ -1,15 +0,0 @@
-#include <iostream>
-#include <nlohmann/json.hpp>
-
-using json = nlohmann::json;
-
-int main()
-{
- // different JSON Pointers
- json::json_pointer ptr1("/foo");
- json::json_pointer ptr2("/foo/0");
-
- // call empty()
- std::cout << "last reference token of " << ptr1 << " is " << ptr1.back() << '\n'
- << "last reference token of " << ptr2 << " is " << ptr2.back() << std::endl;
-}
diff --git a/doc/examples/json_pointer__back.output b/doc/examples/json_pointer__back.output
deleted file mode 100644
index da4d027..0000000
--- a/doc/examples/json_pointer__back.output
+++ /dev/null
@@ -1,2 +0,0 @@
-last reference token of "/foo" is foo
-last reference token of "/foo/0" is 0
diff --git a/doc/examples/json_pointer__empty.cpp b/doc/examples/json_pointer__empty.cpp
deleted file mode 100644
index 5daaadc..0000000
--- a/doc/examples/json_pointer__empty.cpp
+++ /dev/null
@@ -1,20 +0,0 @@
-#include <iostream>
-#include <nlohmann/json.hpp>
-
-using json = nlohmann::json;
-
-int main()
-{
- // different JSON Pointers
- json::json_pointer ptr0;
- json::json_pointer ptr1("");
- json::json_pointer ptr2("/foo");
- json::json_pointer ptr3("/foo/0");
-
- // call empty()
- std::cout << std::boolalpha
- << ptr0 << ": " << ptr0.empty() << '\n'
- << ptr1 << ": " << ptr1.empty() << '\n'
- << ptr2 << ": " << ptr2.empty() << '\n'
- << ptr3 << ": " << ptr3.empty() << std::endl;
-}
diff --git a/doc/examples/json_pointer__operator_add_binary.cpp b/doc/examples/json_pointer__operator_add_binary.cpp
deleted file mode 100644
index 89e0a6a..0000000
--- a/doc/examples/json_pointer__operator_add_binary.cpp
+++ /dev/null
@@ -1,19 +0,0 @@
-#include <iostream>
-#include <nlohmann/json.hpp>
-
-using json = nlohmann::json;
-
-int main()
-{
- // create a JSON pointer
- json::json_pointer ptr("/foo");
-
- // append a JSON Pointer
- std::cout << ptr / json::json_pointer("/bar/baz") << '\n';
-
- // append a string
- std::cout << ptr / "fob" << '\n';
-
- // append an array index
- std::cout << ptr / 42 << std::endl;
-}
diff --git a/doc/examples/json_pointer__parent_pointer.cpp b/doc/examples/json_pointer__parent_pointer.cpp
deleted file mode 100644
index 6021463..0000000
--- a/doc/examples/json_pointer__parent_pointer.cpp
+++ /dev/null
@@ -1,18 +0,0 @@
-#include <iostream>
-#include <nlohmann/json.hpp>
-
-using json = nlohmann::json;
-
-int main()
-{
- // different JSON Pointers
- json::json_pointer ptr1("");
- json::json_pointer ptr2("/foo");
- json::json_pointer ptr3("/foo/0");
-
- // call parent_pointer()
- std::cout << std::boolalpha
- << "parent of " << ptr1 << " is " << ptr1.parent_pointer() << '\n'
- << "parent of " << ptr2 << " is " << ptr2.parent_pointer() << '\n'
- << "parent of " << ptr3 << " is " << ptr3.parent_pointer() << std::endl;
-}
diff --git a/doc/examples/json_pointer__to_string.cpp b/doc/examples/json_pointer__to_string.cpp
deleted file mode 100644
index da397cd..0000000
--- a/doc/examples/json_pointer__to_string.cpp
+++ /dev/null
@@ -1,35 +0,0 @@
-#include <iostream>
-#include <nlohmann/json.hpp>
-
-using json = nlohmann::json;
-
-int main()
-{
- // different JSON Pointers
- json::json_pointer ptr1("");
- json::json_pointer ptr2("/foo");
- json::json_pointer ptr3("/foo/0");
- json::json_pointer ptr4("/");
- json::json_pointer ptr5("/a~1b");
- json::json_pointer ptr6("/c%d");
- json::json_pointer ptr7("/e^f");
- json::json_pointer ptr8("/g|h");
- json::json_pointer ptr9("/i\\j");
- json::json_pointer ptr10("/k\"l");
- json::json_pointer ptr11("/ ");
- json::json_pointer ptr12("/m~0n");
-
-
- std::cout << ptr1.to_string() << '\n'
- << ptr2.to_string() << '\n'
- << ptr3.to_string() << '\n'
- << ptr4.to_string() << '\n'
- << ptr5.to_string() << '\n'
- << ptr6.to_string() << '\n'
- << ptr7.to_string() << '\n'
- << ptr8.to_string() << '\n'
- << ptr9.to_string() << '\n'
- << ptr10.to_string() << '\n'
- << ptr11.to_string() << '\n'
- << ptr12.to_string() << std::endl;
-}
diff --git a/doc/examples/json_pointer__to_string.output b/doc/examples/json_pointer__to_string.output
deleted file mode 100644
index c4b5ea8..0000000
--- a/doc/examples/json_pointer__to_string.output
+++ /dev/null
@@ -1,12 +0,0 @@
-
-/foo
-/foo/0
-/
-/a~1b
-/c%d
-/e^f
-/g|h
-/i\j
-/k"l
-/
-/m~0n
diff --git a/doc/examples/max_size.output b/doc/examples/max_size.output
deleted file mode 100644
index 8c79995..0000000
--- a/doc/examples/max_size.output
+++ /dev/null
@@ -1,7 +0,0 @@
-0
-1
-1
-1
-256204778801521550
-1152921504606846975
-1
diff --git a/doc/examples/sax_parse.output b/doc/examples/sax_parse.output
deleted file mode 100644
index e16c2c4..0000000
--- a/doc/examples/sax_parse.output
+++ /dev/null
@@ -1,2 +0,0 @@
-(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
diff --git a/doc/index.md b/doc/index.md
deleted file mode 100644
index cb782e7..0000000
--- a/doc/index.md
+++ /dev/null
@@ -1,335 +0,0 @@
-# JSON for Modern C++
-
-These pages contain the API documentation of JSON for Modern C++, a C++11 header-only JSON class.
-
-# Contents
-
-- Classes
- - @link nlohmann::basic_json `basic_json`@endlink -- class template for JSON values
- - @link nlohmann::json `json`@endlink -- the default specialization of `basic_json`, defined as `basic_json<>`
-- [Functions](functions_func.html)
- - object inspection
- - @link nlohmann::basic_json::dump dump @endlink -- value serialization
- - @link nlohmann::basic_json::type type @endlink -- type of the value
- - @link nlohmann::basic_json::is_primitive is_primitive @endlink,
- @link nlohmann::basic_json::is_structured is_structured @endlink,
- @link nlohmann::basic_json::is_null is_null @endlink,
- @link nlohmann::basic_json::is_boolean is_boolean @endlink,
- @link nlohmann::basic_json::is_number is_number @endlink,
- @link nlohmann::basic_json::is_number_integer is_number_integer @endlink,
- @link nlohmann::basic_json::is_number_unsigned is_number_unsigned @endlink,
- @link nlohmann::basic_json::is_number_float is_number_float @endlink,
- @link nlohmann::basic_json::is_object is_object @endlink,
- @link nlohmann::basic_json::is_array is_array @endlink,
- @link nlohmann::basic_json::is_string is_string @endlink,
- @link nlohmann::basic_json::is_discarded is_discarded @endlink,
- @link nlohmann::basic_json::is_binary is_binary @endlink -- check for value type
- - @link nlohmann::basic_json::operator value_t() const operator value_t @endlink -- type of the value (implicit conversion)
- - value access
- - @link nlohmann::basic_json::get get @endlink -- get a value
- - @link nlohmann::basic_json::get_ptr get_ptr @endlink -- get a value pointer
- - @link nlohmann::basic_json::get_ref get_ref @endlink -- get a value reference
- - @link nlohmann::basic_json::get_binary get_binary @endlink -- get a binary value
- - @link nlohmann::basic_json::operator ValueType() const operator ValueType @endlink -- get a value (implicit conversion)
- - @link nlohmann::basic_json::value value @endlink -- get a value from an object and return default value if key is not present
- - exceptions
- - @link nlohmann::basic_json::parse_error parse_error @endlink for exceptions indicating a parse error
- - @link nlohmann::basic_json::invalid_iterator invalid_iterator @endlink for exceptions indicating errors with iterators
- - @link nlohmann::basic_json::type_error type_error @endlink for exceptions indicating executing a member function with a wrong type
- - @link nlohmann::basic_json::out_of_range out_of_range @endlink for exceptions indicating access out of the defined range
- - @link nlohmann::basic_json::other_error other_error @endlink for exceptions indicating other library errors
- - lexicographical comparison operators
- - @link nlohmann::basic_json::operator== operator== @endlink
- - @link nlohmann::basic_json::operator!= operator!= @endlink
- - @link nlohmann::basic_json::operator< operator<= @endlink
- - @link nlohmann::basic_json::operator<= operator< @endlink
- - @link nlohmann::basic_json::operator> operator> @endlink
- - @link nlohmann::basic_json::operator>= operator>= @endlink
- - serialization
- - @link nlohmann::basic_json::dump dump @endlink serialize to string
- - @link nlohmann::basic_json::operator<<(std::ostream&, const basic_json &) operator<< @endlink serialize to stream
- - deserialization / parsing
- - @link nlohmann::basic_json::parse parse @endlink parse from input (string, file, etc.) and return JSON value
- - @link nlohmann::basic_json::sax_parse sax_parse @endlink parse from input (string, file, etc.) and generate SAX events
- - @link nlohmann::basic_json::operator>>(std::istream&, basic_json&) operator>> @endlink parse from stream
- - @link nlohmann::basic_json::accept accept @endlink check for syntax errors without parsing
- - @link nlohmann::json_sax SAX interface @endlink define a user-defined SAX event consumer
- - @link nlohmann::basic_json::parser_callback_t callback interface @endlink register a callback to the parse function
- - [binary formats](binary_formats.md):
- - CBOR: @link nlohmann::basic_json::from_cbor from_cbor @endlink / @link nlohmann::basic_json::to_cbor to_cbor @endlink
- - MessagePack: @link nlohmann::basic_json::from_msgpack from_msgpack @endlink / @link nlohmann::basic_json::to_msgpack to_msgpack @endlink
- - UBJSON: @link nlohmann::basic_json::from_ubjson from_ubjson @endlink / @link nlohmann::basic_json::to_ubjson to_ubjson @endlink
- - BSON: @link nlohmann::basic_json::from_bson from_bson @endlink / @link nlohmann::basic_json::to_bson to_bson @endlink
-- Types
- - @link nlohmann::basic_json::array_t arrays @endlink
- - @link nlohmann::basic_json::object_t objects @endlink
- - @link nlohmann::basic_json::string_t strings @endlink
- - @link nlohmann::basic_json::boolean_t booleans @endlink
- - numbers
- - @link nlohmann::basic_json::number_integer_t signed integers @endlink
- - @link nlohmann::basic_json::number_unsigned_t unsigned integers @endlink
- - @link nlohmann::basic_json::number_float_t floating-point @endlink
- - @link nlohmann::basic_json::binary_t binary values @endlink
-- further JSON standards
- - @link nlohmann::json_pointer JSON Pointer @endlink (RFC 6901)
- - @link nlohmann::basic_json::patch JSON Patch @endlink (RFC 6902)
- - @link nlohmann::basic_json::merge_patch JSON Merge Patch @endlink (RFC 7396)
-
-# Container function overview
-
-The container functions known from STL have been extended to support the different value types from JSON. However, not all functions can be applied to all value types. Note that the signature of some functions differ between the types; for instance, `at` may be called with either a string to address a key in an object or with an integer to address a value in an array.
-
-Note that this table only lists those exceptions thrown due to the type. For instance, the @link nlohmann::basic_json::at(const typename object_t::key_type & key) `at` @endlink function will always throw a @link nlohmann::basic_json::type_error `json::type_error` @endlink exception when called for a string type. When called for an array, it *may* throw an @link nlohmann::basic_json::out_of_range `json::out_of_range` @endlink exception if the passed index is invalid.
-
-<table>
- <tr>
- <th rowspan="2">group</th>
- <th rowspan="2">function</th>
- <th colspan="6">JSON value type</th>
- </tr>
- <tr>
- <th>object</th>
- <th>array</th>
- <th>string</th>
- <th>number</th>
- <th>boolean</th>
- <th>null</th>
- </tr>
- <tr>
- <td rowspan="8">iterators</td>
- <td>`begin`</td>
- <td class="ok_green">@link nlohmann::basic_json::begin `begin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::begin `begin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::begin `begin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::begin `begin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::begin `begin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::begin `begin` @endlink (returns `end()`)</td>
- </tr>
- <tr>
- <td>`cbegin`</td>
- <td class="ok_green">@link nlohmann::basic_json::cbegin `cbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::cbegin `cbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::cbegin `cbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::cbegin `cbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::cbegin `cbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::cbegin `cbegin` @endlink (returns `cend()`)</td>
- </tr>
- <tr>
- <td>`end`</td>
- <td class="ok_green">@link nlohmann::basic_json::end `end` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::end `end` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::end `end` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::end `end` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::end `end` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::end `end` @endlink</td>
- </tr>
- <tr>
- <td>`cend`</td>
- <td class="ok_green">@link nlohmann::basic_json::cend `cend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::cend `cend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::cend `cend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::cend `cend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::cend `cend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::cend `cend` @endlink</td>
- </tr>
- <tr>
- <td>`rbegin`</td>
- <td class="ok_green">@link nlohmann::basic_json::rbegin `rbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::rbegin `rbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::rbegin `rbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::rbegin `rbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::rbegin `rbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::rbegin `rbegin` @endlink</td>
- </tr>
- <tr>
- <td>`crbegin`</td>
- <td class="ok_green">@link nlohmann::basic_json::crbegin `crbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::crbegin `crbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::crbegin `crbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::crbegin `crbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::crbegin `crbegin` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::crbegin `crbegin` @endlink</td>
- </tr>
- <tr>
- <td>`rend`</td>
- <td class="ok_green">@link nlohmann::basic_json::rend `rend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::rend `rend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::rend `rend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::rend `rend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::rend `rend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::rend `rend` @endlink</td>
- </tr>
- <tr>
- <td>`crend`</td>
- <td class="ok_green">@link nlohmann::basic_json::crend `crend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::crend `crend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::crend `crend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::crend `crend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::crend `crend` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::crend `crend` @endlink</td>
- </tr>
- <tr>
- <td rowspan="4">element<br>access</td>
- <td>`at`</td>
- <td class="ok_green">@link nlohmann::basic_json::at(const typename object_t::key_type & key) `at` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::at(size_type) `at` @endlink</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (304)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (304)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (304)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (304)</td>
- </tr>
- <tr>
- <td>`operator[]`</td>
- <td class="ok_green">@link nlohmann::basic_json::operator[](const typename object_t::key_type &key) `operator[]` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::operator[](size_type) `operator[]` @endlink</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (305)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (305)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (305)</td>
- <td class="ok_green">@link nlohmann::basic_json::operator[](const typename object_t::key_type & key) `operator[]` @endlink (creates object)<br>@link nlohmann::basic_json::operator[](size_type) `operator[]` @endlink (creates array)</td>
- </tr>
- <tr>
- <td>`front`</td>
- <td class="ok_green">@link nlohmann::basic_json::front `front` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::front `front` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::front `front` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::front `front` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::front `front` @endlink</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::invalid_iterator `json::invalid_iterator` @endlink (214)</td>
- </tr>
- <tr>
- <td>`back`</td>
- <td class="ok_green">@link nlohmann::basic_json::back `back` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::back `back` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::back `back` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::back `back` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::back `back` @endlink</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::invalid_iterator `json::invalid_iterator` @endlink (214)</td>
- </tr>
- <tr>
- <td rowspan="3">capacity</td>
- <td>`empty`</td>
- <td class="ok_green">@link nlohmann::basic_json::empty `empty` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::empty `empty` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::empty `empty` @endlink (returns `false`)</td>
- <td class="ok_green">@link nlohmann::basic_json::empty `empty` @endlink (returns `false`)</td>
- <td class="ok_green">@link nlohmann::basic_json::empty `empty` @endlink (returns `false`)</td>
- <td class="ok_green">@link nlohmann::basic_json::empty `empty` @endlink (returns `true`)</td>
- </tr>
- <tr>
- <td>`size`</td>
- <td class="ok_green">@link nlohmann::basic_json::size `size` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::size `size` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::size `size` @endlink (returns `1`)</td>
- <td class="ok_green">@link nlohmann::basic_json::size `size` @endlink (returns `1`)</td>
- <td class="ok_green">@link nlohmann::basic_json::size `size` @endlink (returns `1`)</td>
- <td class="ok_green">@link nlohmann::basic_json::size `size` @endlink (returns `0`)</td>
- </tr>
- <tr>
- <td>`max_size_`</td>
- <td class="ok_green">@link nlohmann::basic_json::max_size `max_size` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::max_size `max_size` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::max_size `max_size` @endlink (returns `1`)</td>
- <td class="ok_green">@link nlohmann::basic_json::max_size `max_size` @endlink (returns `1`)</td>
- <td class="ok_green">@link nlohmann::basic_json::max_size `max_size` @endlink (returns `1`)</td>
- <td class="ok_green">@link nlohmann::basic_json::max_size `max_size` @endlink (returns `0`)</td>
- </tr>
- <tr>
- <td rowspan="7">modifiers</td>
- <td>`clear`</td>
- <td class="ok_green">@link nlohmann::basic_json::clear `clear` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::clear `clear` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::clear `clear` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::clear `clear` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::clear `clear` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::clear `clear` @endlink</td>
- </tr>
- <tr>
- <td>`insert`</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (309)</td>
- <td class="ok_green">@link nlohmann::basic_json::insert `insert` @endlink</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (309)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (309)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (309)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (309)</td>
- </tr>
- <tr>
- <td>`erase`</td>
- <td class="ok_green">@link nlohmann::basic_json::erase `erase` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::erase `erase` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::erase `erase` @endlink (converts to null)</td>
- <td class="ok_green">@link nlohmann::basic_json::erase `erase` @endlink (converts to null)</td>
- <td class="ok_green">@link nlohmann::basic_json::erase `erase` @endlink (converts to null)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (307)</td>
- </tr>
- <tr>
- <td>`push_back`</td>
- <td class="ok_green">@link nlohmann::basic_json::push_back(const typename object_t::value_type & val) `push_back` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::push_back(const nlohmann::basic_json &) `push_back` @endlink</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (308)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (308)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (308)</td>
- <td class="ok_green">@link nlohmann::basic_json::push_back(const typename object_t::value_type & val) `push_back` @endlink (creates object)<br>@link nlohmann::basic_json::push_back(const nlohmann::basic_json &) `push_back` @endlink (creates array)</td>
- </tr>
- <tr>
- <td>`emplace` / `emplace_back`</td>
- <td class="ok_green">@link nlohmann::basic_json::emplace() `emplace` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::emplace_back() `emplace_back` @endlink</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (311)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (311)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (311)</td>
- <td class="ok_green">@link nlohmann::basic_json::emplace() `emplace` @endlink (creates object)<br>@link nlohmann::basic_json::emplace_back() `emplace_back` @endlink (creates array)</td>
- </tr>
- <tr>
- <td>`update`</td>
- <td class="ok_green">@link nlohmann::basic_json::update() `update` @endlink</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (312)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (312)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (312)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (312)</td>
- <td class="nok_throws">throws @link nlohmann::basic_json::type_error `json::type_error` @endlink (312)</td>
- </tr>
- <tr>
- <td>`swap`</td>
- <td class="ok_green">@link nlohmann::basic_json::swap `swap` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::swap `swap` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::swap `swap` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::swap `swap` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::swap `swap` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::swap `swap` @endlink</td>
- </tr>
- <tr>
- <td rowspan="3">lookup</td>
- <td>`find`</td>
- <td class="ok_green">@link nlohmann::basic_json::find `find` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::find `find` @endlink (returns `end()`)</td>
- <td class="ok_green">@link nlohmann::basic_json::find `find` @endlink (returns `end()`)</td>
- <td class="ok_green">@link nlohmann::basic_json::find `find` @endlink (returns `end()`)</td>
- <td class="ok_green">@link nlohmann::basic_json::find `find` @endlink (returns `end()`)</td>
- <td class="ok_green">@link nlohmann::basic_json::find `find` @endlink (returns `end()`)</td>
- </tr>
- <tr>
- <td>`count`</td>
- <td class="ok_green">@link nlohmann::basic_json::count `count` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::count `count` @endlink (returns `0`)</td>
- <td class="ok_green">@link nlohmann::basic_json::count `count` @endlink (returns `0`)</td>
- <td class="ok_green">@link nlohmann::basic_json::count `count` @endlink (returns `0`)</td>
- <td class="ok_green">@link nlohmann::basic_json::count `count` @endlink (returns `0`)</td>
- <td class="ok_green">@link nlohmann::basic_json::count `count` @endlink (returns `0`)</td>
- </tr>
- <tr>
- <td>`contains`</td>
- <td class="ok_green">@link nlohmann::basic_json::contains `contains` @endlink</td>
- <td class="ok_green">@link nlohmann::basic_json::contains `contains` @endlink (returns `false`)</td>
- <td class="ok_green">@link nlohmann::basic_json::contains `contains` @endlink (returns `false`)</td>
- <td class="ok_green">@link nlohmann::basic_json::contains `contains` @endlink (returns `false`)</td>
- <td class="ok_green">@link nlohmann::basic_json::contains `contains` @endlink (returns `false`)</td>
- <td class="ok_green">@link nlohmann::basic_json::contains `contains` @endlink (returns `false`)</td>
- </tr>
-</table>
-
-@copyright Copyright © 2013-2022 Niels Lohmann. The code is licensed under the [MIT License](http://opensource.org/licenses/MIT).
-
-@author [Niels Lohmann](http://nlohmann.me)
-@see https://github.com/nlohmann/json to download the source code
-
-@version 3.10.5
diff --git a/doc/mkdocs/Makefile b/doc/mkdocs/Makefile
deleted file mode 100644
index 3d3d5e7..0000000
--- a/doc/mkdocs/Makefile
+++ /dev/null
@@ -1,33 +0,0 @@
-# serve the site locally
-serve: prepare_files
- venv/bin/mkdocs serve
-
-build: prepare_files
- venv/bin/mkdocs build
-
-# create files that are not versioned inside the mkdocs folder
-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
-
-# clean subfolders
-clean:
- rm -fr docs/images/json.gif docs/examples
-
-# publish site to GitHub pages
-publish: prepare_files
- venv/bin/mkdocs gh-deploy --clean --force
-
-# install a Python virtual environment
-install_venv: requirements.txt
- python3 -mvenv venv
- venv/bin/pip install wheel
- venv/bin/pip install -r requirements.txt
-
-# uninstall the virtual environment
-uninstall_venv: clean
- rm -fr venv
diff --git a/doc/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md b/doc/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md
deleted file mode 100644
index 6622d8a..0000000
--- a/doc/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# <small>nlohmann::basic_json::</small>cbor_tag_handler_t
-
-```cpp
-enum class cbor_tag_handler_t
-{
- error,
- ignore,
- store
-};
-```
-
-This enumeration is used in the [`from_cbor`](from_cbor.md) function to choose how to treat tags:
-
-error
-: throw a `parse_error` exception in case of a tag
-
-ignore
-: ignore tags
-
-store
-: store tagged values as binary container with subtype (for bytes 0xd8..0xdb)
-
-## Version history
-
-- Added in version 3.9.0. Added value `store` in 3.10.0.
diff --git a/doc/mkdocs/docs/api/basic_json/contains.md b/doc/mkdocs/docs/api/basic_json/contains.md
deleted file mode 100644
index 8463f4e..0000000
--- a/doc/mkdocs/docs/api/basic_json/contains.md
+++ /dev/null
@@ -1,94 +0,0 @@
-# <small>nlohmann::basic_json::</small>contains
-
-```cpp
-// (1)
-template<typename KeyT>
-bool contains(KeyT && key) const;
-
-// (2)
-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
- 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.
-
-## Template parameters
-
-`KeyT`
-: A type for an object key other than `basic_json::json_pointer`.
-
-## Parameters
-
-`key` (in)
-: key value to check its existence.
-
-`ptr` (in)
-: JSON pointer to check its existence.
-
-## Return value
-
-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.
-
-## Exception safety
-
-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:
- - 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
- number.
-
-## Complexity
-
-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.
-
-!!! info "Postconditions"
-
- If `#!cpp j.contains(x)` returns `#!c true` for a key or JSON pointer `x`, then it is safe to call `j[x]`.
-
-## Examples
-
-??? example "Example (1) check with key"
-
- The example shows how `contains()` is used.
-
- ```cpp
- --8<-- "examples/contains.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/contains.output"
- ```
-
-??? example "Example (1) check with JSON pointer"
-
- The example shows how `contains()` is used.
-
- ```cpp
- --8<-- "examples/contains_json_pointer.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/contains_json_pointer.output"
- ```
-
-## Version history
-
-1. Added in version 3.6.0.
-2. 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
deleted file mode 100644
index fcfef86..0000000
--- a/doc/mkdocs/docs/api/basic_json/count.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# <small>nlohmann::basic_json::</small>count
-
-```cpp
-template<typename KeyT>
-size_type count(KeyT&& 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).
-
-## Template parameters
-
-`KeyT`
-: A type for an object key.
-
-## Parameters
-
-`key` (in)
-: key value of the element to count.
-
-## Return value
-
-Number of elements with key `key`. If the JSON value is not an object, the return value will be `0`.
-
-## Exception safety
-
-Strong exception safety: if an exception occurs, the original value stays intact.
-
-## Complexity
-
-Logarithmic in the size of the JSON object.
-
-## Notes
-
-This method always returns `0` when executed on a JSON type that is not an object.
-
-## Examples
-
-??? example
-
- The example shows how `count()` is used.
-
- ```cpp
- --8<-- "examples/count.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/count.output"
- ```
-
-## Version history
-
-- 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
deleted file mode 100644
index af4cb29..0000000
--- a/doc/mkdocs/docs/api/basic_json/find.md
+++ /dev/null
@@ -1,63 +0,0 @@
-# <small>nlohmann::basic_json::</small>find
-
-```cpp
-template<typename KeyT>
-iterator find(KeyT&& key);
-
-template<typename KeyT>
-const_iterator find(KeyT&& 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.
-
-## Template parameters
-
-`KeyT`
-: A type for an object key.
-
-## Parameters
-
-`key` (in)
-: key value of the element to search for.
-
-## 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.
-
-## Exception safety
-
-Strong exception safety: if an exception occurs, the original value stays intact.
-
-## Complexity
-
-Logarithmic in the size of the JSON object.
-
-## Notes
-
-This method always returns `end()` when executed on a JSON type that is not an object.
-
-## Examples
-
-??? example
-
- The example shows how `find()` is used.
-
- ```cpp
- --8<-- "examples/find__key_type.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/find__key_type.output"
- ```
-
-## See also
-
-- [contains](contains.md) checks whether a key exists
-
-## Version history
-
-- Added in version 1.0.0.
diff --git a/doc/mkdocs/docs/api/basic_json/get_allocator.md b/doc/mkdocs/docs/api/basic_json/get_allocator.md
deleted file mode 100644
index 1b7700c..0000000
--- a/doc/mkdocs/docs/api/basic_json/get_allocator.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# <small>nlohmann::basic_json::</small>get_allocator
-
-```cpp
-static allocator_type get_allocator();
-```
-
-Returns the allocator associated with the container.
-
-## Return value
-
-associated allocator
-
-## Version history
-
-- Unknown.
-
-!!! note
-
- This documentation page is a stub.
diff --git a/doc/mkdocs/docs/api/basic_json/input_format_t.md b/doc/mkdocs/docs/api/basic_json/input_format_t.md
deleted file mode 100644
index 4accf6d..0000000
--- a/doc/mkdocs/docs/api/basic_json/input_format_t.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# <small>nlohmann::basic_json::</small>input_format_t
-
-```cpp
-enum class input_format_t {
- json,
- cbor,
- msgpack,
- ubjson,
- bson
-};
-```
-
-This enumeration is used in the [`sax_parse`](sax_parse.md) function to choose the input format to parse:
-
-json
-: JSON (JavaScript Object Notation)
-
-cbor
-: CBOR (Concise Binary Object Representation)
-
-msgpack
-: MessagePack
-
-ubjson
-: UBJSON (Universal Binary JSON)
-
-bson
-: BSON (Binary JSON)
-
-## Version history
-
-- Added in version 3.2.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
deleted file mode 100644
index 44509a9..0000000
--- a/doc/mkdocs/docs/api/basic_json/object_comparator_t.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# <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
-```
-
-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
-count() calls, prevents unnecessary string construction.
-
-## Version history
-
-- Unknown.
diff --git "a/doc/mkdocs/docs/api/basic_json/operator\133\135.md" "b/doc/mkdocs/docs/api/basic_json/operator\133\135.md"
deleted file mode 100644
index 5b6512a..0000000
--- "a/doc/mkdocs/docs/api/basic_json/operator\133\135.md"
+++ /dev/null
@@ -1,196 +0,0 @@
-# <small>nlohmann::basic_json::</small>operator[]
-
-```cpp
-// (1)
-reference operator[](size_type idx);
-const_reference operator[](size_type idx) const;
-
-// (2)
-reference operator[](const 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)
-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`.
-
-## Template parameters
-
-`T`
-: string literal convertible to `object_t::key_type`
-
-## Parameters
-
-`idx` (in)
-: index of the element to access
-
-`key` (in)
-: object key of the element 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`
-
-## Exception safety
-
-Strong exception safety: if an exception occurs, the original value stays intact.
-
-## Exceptions
-
-1. The function can throw the following exceptions:
- - Throws [`type_error.305`](../../home/exceptions.md#jsonexceptiontype_error305) if the JSON value is not an array
- or null; in that case, using the `[]` operator with an index makes no sense.
-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:
- - 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
- JSON pointer `ptr` is not a number.
- - Throws [`out_of_range.402`](../../home/exceptions.md#jsonexceptionout_of_range402) if the array index '-' is used
- in the passed JSON pointer `ptr` for the const version.
- - Throws [`out_of_range.404`](../../home/exceptions.md#jsonexceptionout_of_range404) if the JSON pointer `ptr` can
- not be resolved.
-
-## Complexity
-
-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
-
-## Notes
-
-!!! danger
-
- 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**!
-
-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
- case the value was `#!json null` before, it is converted to an array.
-
-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.
-
- In particular:
-
- - If the JSON pointer points to an object key that does not exist, it is created and filled with a `#!json null`
- value before a reference to it is returned.
- - If the JSON pointer points to an array index that does not exist, it is created and filled with a `#!json null`
- value before a reference to it is returned. All indices between the current maximum and the given index are also
- filled with `#!json null`.
- - The special value `-` is treated as a synonym for the index past the end.
-
-## Examples
-
-??? example "Example (1): access specified array element"
-
- The example below shows how array elements can be read and written using `[]` operator. Note the addition of
- `#!json null` values.
-
- ```cpp
- --8<-- "examples/operatorarray__size_type.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operatorarray__size_type.output"
- ```
-
-??? example "Example (1): access specified array element"
-
- The example below shows how array elements can be read using the `[]` operator.
-
- ```cpp
- --8<-- "examples/operatorarray__size_type_const.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operatorarray__size_type_const.output"
- ```
-
-??? example "Example (2): access specified object element"
-
- The example below shows how object elements can be read and written using the `[]` operator.
-
- ```cpp
- --8<-- "examples/operatorarray__key_type.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operatorarray__key_type.output"
- ```
-
-??? example "Example (2): access specified object element"
-
- The example below shows how object elements can be read using the `[]` operator.
-
- ```cpp
- --8<-- "examples/operatorarray__key_type_const.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operatorarray__key_type_const.output"
- ```
-
-??? example "Example (3): access specified element via JSON Pointer"
-
- The example below shows how values can be read and written using JSON Pointers.
-
- ```cpp
- --8<-- "examples/operatorjson_pointer.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operatorjson_pointer.output"
- ```
-
-??? example "Example (3): access specified element via JSON Pointer"
-
- The example below shows how values can be read using JSON Pointers.
-
- ```cpp
- --8<-- "examples/operatorjson_pointer_const.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operatorjson_pointer_const.output"
- ```
-
-## See also
-
-- see [`at`](at.md) for access by reference with range checking
-- see [`value`](value.md) for access with default value
-
-## 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.
diff --git a/doc/mkdocs/docs/api/basic_json/operator_ValueType.md b/doc/mkdocs/docs/api/basic_json/operator_ValueType.md
deleted file mode 100644
index 1eec135..0000000
--- a/doc/mkdocs/docs/api/basic_json/operator_ValueType.md
+++ /dev/null
@@ -1,72 +0,0 @@
-# <small>nlohmann::basic_json::</small>operator ValueType
-
-```cpp
-template<typename ValueType>
-JSON_EXPLICIT operator ValueType() const;
-```
-
-Implicit type conversion between the JSON value and a compatible value. The call is realized by calling
-[`get()`](get.md). See [Notes](#notes) for the meaning of `JSON_EXPLICIT`.
-
-## Template parameters
-
-`ValueType`
-: the value type to return
-
-## Return value
-
-copy of the JSON value, converted to `ValueType`
-
-## Exceptions
-
-Depends on what `json_serializer<ValueType>` `from_json()` method throws
-
-## Complexity
-
-Linear in the size of the JSON value.
-
-## Notes
-
-By default `JSON_EXPLICIT` defined to the empty string, so the signature is:
-
-```cpp
-template<typename ValueType>
-operator ValueType() const;
-```
-
-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`](../../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>`.
-
- ```cpp
- --8<-- "examples/operator__ValueType.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operator__ValueType.output"
- ```
-
-## Version history
-
-- Since version 1.0.0.
-- Macros `JSON_EXPLICIT`/[`JSON_USE_IMPLICIT_CONVERSIONS`](../../features/macros.md#json_use_implicit_conversions) added
- in version 3.9.0.
diff --git a/doc/mkdocs/docs/api/basic_json/operator_eq.md b/doc/mkdocs/docs/api/basic_json/operator_eq.md
deleted file mode 100644
index 49f96b1..0000000
--- a/doc/mkdocs/docs/api/basic_json/operator_eq.md
+++ /dev/null
@@ -1,120 +0,0 @@
-# <small>nlohmann::basic_json::</small>operator==
-
-```cpp
-bool operator==(const_reference lhs, const_reference rhs) noexcept;
-
-template<typename ScalarType>
-bool operator==(const_reference lhs, const ScalarType rhs) noexcept;
-
-template<typename ScalarType>
-bool operator==(ScalarType lhs, const const_reference rhs) noexcept;
-```
-
-Compares two JSON values for equality according to the following rules:
-
-- 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.
-
-## Template parameters
-
-`ScalarType`
-: a scalar type according to `std::is_scalar<ScalarType>::value`
-
-## Parameters
-
-`lhs` (in)
-: first value to consider
-
-`rhs` (in)
-: second value to consider
-
-## Return value
-
-whether the values `lhs` and `rhs` are equal
-
-## Exception safety
-
-No-throw guarantee: this function never throws exceptions.
-
-## Complexity
-
-Linear.
-
-## Notes
-
-!!! note
-
- - 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
-
- 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
- [comparison function](https://github.com/mariokonrad/marnav/blob/master/include/marnav/math/floatingpoint.hpp#L34-#L39)
- could be used, for instance
-
- ```cpp
- template<typename T, typename = typename std::enable_if<std::is_floating_point<T>::value, T>::type>
- inline bool is_same(T a, T b, T epsilon = std::numeric_limits<T>::epsilon()) noexcept
- {
- return std::abs(a - b) <= epsilon;
- }
- ```
-
- Or you can self-defined operator equal function like this:
-
- ```cpp
- bool my_equal(const_reference lhs, const_reference rhs)
- {
- const auto lhs_type lhs.type();
- const auto rhs_type rhs.type();
- if (lhs_type == rhs_type)
- {
- switch(lhs_type)
- // self_defined case
- case value_t::number_float:
- return std::abs(lhs - rhs) <= std::numeric_limits<float>::epsilon();
- // other cases remain the same with the original
- ...
- }
- ...
- }
- ```
-
-## Examples
-
-??? example
-
- The example demonstrates comparing several JSON types.
-
- ```cpp
- --8<-- "examples/operator__equal.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operator__equal.output"
- ```
-
-??? example
-
- The example demonstrates comparing several JSON types against the null pointer (JSON `#!json null`).
-
- ```cpp
- --8<-- "examples/operator__equal__nullptr_t.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operator__equal__nullptr_t.output"
- ```
-
-## Version history
-
-- Added in version 1.0.0.
diff --git a/doc/mkdocs/docs/api/basic_json/operator_ge.md b/doc/mkdocs/docs/api/basic_json/operator_ge.md
deleted file mode 100644
index 68aac65..0000000
--- a/doc/mkdocs/docs/api/basic_json/operator_ge.md
+++ /dev/null
@@ -1,59 +0,0 @@
-# <small>nlohmann::basic_json::</small>operator>=
-
-```cpp
-bool operator>=(const_reference lhs, const_reference rhs) noexcept,
-
-template<typename ScalarType>
-bool operator>=(const_reference lhs, const ScalarType rhs) noexcept;
-
-template<typename ScalarType>
-bool operator>=(ScalarType lhs, const const_reference rhs) noexcept;
-```
-
-Compares whether one JSON value `lhs` is greater than or equal to another JSON value `rhs` by calculating
-`#!cpp !(lhs < rhs)`.
-
-## Template parameters
-
-`ScalarType`
-: a scalar type according to `std::is_scalar<ScalarType>::value`
-
-## Parameters
-
-`lhs` (in)
-: first value to consider
-
-`rhs` (in)
-: second value to consider
-
-## Return value
-
-whether `lhs` is less than or equal to `rhs`
-
-## Exception safety
-
-No-throw guarantee: this function never throws exceptions.
-
-## Complexity
-
-Linear.
-
-## Examples
-
-??? example
-
- The example demonstrates comparing several JSON types.
-
- ```cpp
- --8<-- "examples/operator__greaterequal.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operator__greaterequal.output"
- ```
-
-## Version history
-
-- Added in version 1.0.0.
diff --git a/doc/mkdocs/docs/api/basic_json/operator_gt.md b/doc/mkdocs/docs/api/basic_json/operator_gt.md
deleted file mode 100644
index 92ec305..0000000
--- a/doc/mkdocs/docs/api/basic_json/operator_gt.md
+++ /dev/null
@@ -1,58 +0,0 @@
-# <small>nlohmann::basic_json::</small>operator>
-
-```cpp
-bool operator>(const_reference lhs, const_reference rhs) noexcept,
-
-template<typename ScalarType>
-bool operator>(const_reference lhs, const ScalarType rhs) noexcept;
-
-template<typename ScalarType>
-bool operator>(ScalarType lhs, const const_reference rhs) noexcept;
-```
-
-Compares whether one JSON value `lhs` is greater than another JSON value `rhs` by calculating `#!cpp !(lhs <= rhs)`.
-
-## Template parameters
-
-`ScalarType`
-: a scalar type according to `std::is_scalar<ScalarType>::value`
-
-## Parameters
-
-`lhs` (in)
-: first value to consider
-
-`rhs` (in)
-: second value to consider
-
-## Return value
-
-whether `lhs` is greater than `rhs`
-
-## Exception safety
-
-No-throw guarantee: this function never throws exceptions.
-
-## Complexity
-
-Linear.
-
-## Examples
-
-??? example
-
- The example demonstrates comparing several JSON types.
-
- ```cpp
- --8<-- "examples/operator__greater.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operator__greater.output"
- ```
-
-## Version history
-
-- Added in version 1.0.0.
diff --git a/doc/mkdocs/docs/api/basic_json/operator_le.md b/doc/mkdocs/docs/api/basic_json/operator_le.md
deleted file mode 100644
index 54f9a28..0000000
--- a/doc/mkdocs/docs/api/basic_json/operator_le.md
+++ /dev/null
@@ -1,59 +0,0 @@
-# <small>nlohmann::basic_json::</small>operator<=
-
-```cpp
-bool operator<=(const_reference lhs, const_reference rhs) noexcept,
-
-template<typename ScalarType>
-bool operator<=(const_reference lhs, const ScalarType rhs) noexcept;
-
-template<typename ScalarType>
-bool operator<=(ScalarType lhs, const const_reference rhs) noexcept;
-```
-
-Compares whether one JSON value `lhs` is less than or equal to another JSON value `rhs` by calculating
-`#cpp !(rhs < lhs)`.
-
-## Template parameters
-
-`ScalarType`
-: a scalar type according to `std::is_scalar<ScalarType>::value`
-
-## Parameters
-
-`lhs` (in)
-: first value to consider
-
-`rhs` (in)
-: second value to consider
-
-## Return value
-
-whether `lhs` is less than or equal to `rhs`
-
-## Exception safety
-
-No-throw guarantee: this function never throws exceptions.
-
-## Complexity
-
-Linear.
-
-## Examples
-
-??? example
-
- The example demonstrates comparing several JSON types.
-
- ```cpp
- --8<-- "examples/operator__lessequal.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operator__lessequal.output"
- ```
-
-## Version history
-
-- Added in version 1.0.0.
diff --git a/doc/mkdocs/docs/api/basic_json/operator_literal_json.md b/doc/mkdocs/docs/api/basic_json/operator_literal_json.md
deleted file mode 100644
index 8e0c65d..0000000
--- a/doc/mkdocs/docs/api/basic_json/operator_literal_json.md
+++ /dev/null
@@ -1,48 +0,0 @@
-# <small>nlohmann::basic_json::</small>operator""_json
-
-```cpp
-json operator "" _json(const char* s, std::size_t n);
-```
-
-This operator implements a user-defined string literal for JSON objects. It can be used by adding `#!cpp _json` to a
-string literal and returns a [`json`](../json.md) object if no parse error occurred.
-
-## Parameters
-
-`s` (in)
-: a string representation of a JSON object
-
-`n` (in)
-: length of string `s`
-
-## Return value
-
-[`json`](../json.md) value parsed from `s`
-
-## Exceptions
-
-The function can throw anything that [`parse(s, s+n)`](parse.md) would throw.
-
-## Complexity
-
-Linear.
-
-## Examples
-
-??? example
-
- The following code shows how to create JSON values from string literals.
-
- ```cpp
- --8<-- "examples/operator_literal_json.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operator_literal_json.output"
- ```
-
-## Version history
-
-- Added in version 1.0.0.
diff --git a/doc/mkdocs/docs/api/basic_json/operator_literal_json_pointer.md b/doc/mkdocs/docs/api/basic_json/operator_literal_json_pointer.md
deleted file mode 100644
index 38c957e..0000000
--- a/doc/mkdocs/docs/api/basic_json/operator_literal_json_pointer.md
+++ /dev/null
@@ -1,48 +0,0 @@
-# <small>nlohmann::basic_json::</small>operator""_json_pointer
-
-```cpp
-json_pointer operator "" _json_pointer(const char* s, std::size_t n);
-```
-
-This operator implements a user-defined string literal for JSON Pointers. It can be used by adding `#!cpp _json_pointer`
-to a string literal and returns a [`json_pointer`](../json_pointer/index.md) object if no parse error occurred.
-
-## Parameters
-
-`s` (in)
-: a string representation of a JSON Pointer
-
-`n` (in)
-: length of string `s`
-
-## Return value
-
-[`json_pointer`](../json_pointer/index.md) value parsed from `s`
-
-## Exceptions
-
-The function can throw anything that [`json_pointer::json_pointer`](../json_pointer/index.md) would throw.
-
-## Complexity
-
-Linear.
-
-## Examples
-
-??? example
-
- The following code shows how to create JSON Pointers from string literals.
-
- ```cpp
- --8<-- "examples/operator_literal_json_pointer.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operator_literal_json_pointer.output"
- ```
-
-## Version history
-
-- Added in version 2.0.0.
diff --git a/doc/mkdocs/docs/api/basic_json/operator_lt.md b/doc/mkdocs/docs/api/basic_json/operator_lt.md
deleted file mode 100644
index d1a4999..0000000
--- a/doc/mkdocs/docs/api/basic_json/operator_lt.md
+++ /dev/null
@@ -1,73 +0,0 @@
-# <small>nlohmann::basic_json::</small>operator<
-
-```cpp
-bool operator<(const_reference lhs, const_reference rhs) noexcept;
-
-template<typename ScalarType>
-bool operator<(const_reference lhs, const ScalarType rhs) noexcept;
-
-template<typename ScalarType>
-bool operator<(ScalarType lhs, const const_reference rhs) noexcept;
-```
-
-Compares whether one JSON value `lhs` is less than another JSON value `rhs` according to the following rules:
-
-- 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.
-
-## Template parameters
-
-`ScalarType`
-: a scalar type according to `std::is_scalar<ScalarType>::value`
-
-## Parameters
-
-`lhs` (in)
-: first value to consider
-
-`rhs` (in)
-: second value to consider
-
-## Return value
-
-whether `lhs` is less than `rhs`
-
-## Exception safety
-
-No-throw guarantee: this function never throws exceptions.
-
-## Complexity
-
-Linear.
-
-## Examples
-
-??? example
-
- The example demonstrates comparing several JSON types.
-
- ```cpp
- --8<-- "examples/operator__less.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operator__less.output"
- ```
-
-## Version history
-
-- Added in version 1.0.0.
diff --git a/doc/mkdocs/docs/api/basic_json/operator_ltlt.md b/doc/mkdocs/docs/api/basic_json/operator_ltlt.md
deleted file mode 100644
index 0cba5ea..0000000
--- a/doc/mkdocs/docs/api/basic_json/operator_ltlt.md
+++ /dev/null
@@ -1,62 +0,0 @@
-# operator<<(basic_json)
-
-```cpp
-std::ostream& operator<<(std::ostream& o, const basic_json& j);
-```
-
-Serialize the given JSON value `j` to the output stream `o`. The JSON value will be serialized using the
-[`dump`](dump.md) member function.
-
-- The indentation of the output can be controlled with the member variable `width` of the output stream `o`. For
- instance, using the manipulator `std::setw(4)` on `o` sets the indentation level to `4` and the serialization result
- is the same as calling `dump(4)`.
-- The indentation character can be controlled with the member variable `fill` of the output stream `o`. For instance,
- the manipulator `std::setfill('\\t')` sets indentation to use a tab character rather than the default space character.
-
-## Parameters
-
-`o` (in, out)
-: stream to serialize to
-
-`j` (in)
-: JSON value to serialize
-
-## Return value
-
-the stream `o`
-
-## Exceptions
-
-Throws [`type_error.316`](../../home/exceptions.md#jsonexceptiontype_error316) if a string stored inside the JSON value
-is not UTF-8 encoded. Note that unlike the [`dump`](dump.md) member functions, no `error_handler` can be set.
-
-## Complexity
-
-Linear.
-
-## Examples
-
-??? example
-
- The example below shows the serialization with different parameters to `width` to adjust the indentation level.
-
- ```cpp
- --8<-- "examples/operator_serialize.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operator_serialize.output"
- ```
-
-## Version history
-
-- Added in version 1.0.0
-- Support for indentation character added in version 3.0.0.
-
-!!! warning "Deprecation"
-
- This function replaces function `#!cpp std::ostream& operator>>(const basic_json& j, std::ostream& o)` which has
- been deprecated in version 3.0.0. It will be removed in version 4.0.0. Please replace calls like `#!cpp j >> o;`
- with `#!cpp o << j;`.
diff --git a/doc/mkdocs/docs/api/basic_json/operator_ne.md b/doc/mkdocs/docs/api/basic_json/operator_ne.md
deleted file mode 100644
index e94da9b..0000000
--- a/doc/mkdocs/docs/api/basic_json/operator_ne.md
+++ /dev/null
@@ -1,72 +0,0 @@
-# <small>nlohmann::basic_json::</small>operator!=
-
-```cpp
-bool operator!=(const_reference lhs, const_reference rhs) noexcept;
-
-template<typename ScalarType>
-bool operator!=(const_reference lhs, const ScalarType rhs) noexcept;
-
-template<typename ScalarType>
-bool operator!=(ScalarType lhs, const const_reference rhs) noexcept;
-```
-
-Compares two JSON values for inequality by calculating `#!cpp !(lhs == rhs)`.
-
-## Template parameters
-
-`ScalarType`
-: a scalar type according to `std::is_scalar<ScalarType>::value`
-
-## Parameters
-
-`lhs` (in)
-: first value to consider
-
-`rhs` (in)
-: second value to consider
-
-## Return value
-
-whether the values `lhs` and `rhs` are not equal
-
-## Exception safety
-
-No-throw guarantee: this function never throws exceptions.
-
-## Complexity
-
-Linear.
-
-## Examples
-
-??? example
-
- The example demonstrates comparing several JSON types.
-
- ```cpp
- --8<-- "examples/operator__notequal.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operator__notequal.output"
- ```
-
-??? example
-
- The example demonstrates comparing several JSON types against the null pointer (JSON `#!json null`).
-
- ```cpp
- --8<-- "examples/operator__notequal__nullptr_t.cpp"
- ```
-
- Output:
-
- ```json
- --8<-- "examples/operator__notequal__nullptr_t.output"
- ```
-
-## Version history
-
-- Added in version 1.0.0.
diff --git a/doc/mkdocs/docs/api/basic_json/value_t.md b/doc/mkdocs/docs/api/basic_json/value_t.md
deleted file mode 100644
index 768b13c..0000000
--- a/doc/mkdocs/docs/api/basic_json/value_t.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# <small>nlohmann::basic_json::</small>value_t
-
-```cpp
-enum class value_t : std::uint8_t {
- null,
- object,
- array,
- string,
- boolean,
- number_integer,
- number_unsigned,
- number_float,
- binary,
- discarded
-};
-```
-
-This enumeration collects the different JSON types. It is internally used to distinguish the stored values, and the
-functions [`is_null`](is_null.md), [`is_object`](is_object.md), [`is_array`](is_array.md), [`is_string`](is_string.md),
-[`is_boolean`](is_boolean.md), [`is_number`](is_number.md) (with [`is_number_integer`](is_number_integer.md),
-[`is_number_unsigned`](is_number_unsigned.md), and [`is_number_float`](is_number_float.md)),
-[`is_discarded`](is_discarded.md), [`is_binary`](is_binary.md), [`is_primitive`](is_primitive.md), and
-[`is_structured`](is_structured.md) rely on it.
-
-## 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.
-
-## Version history
-
-- Added in version 1.0.0.
-- Added unsigned integer type in version 2.0.0.
-- Added binary type in version 3.8.0.
diff --git a/doc/mkdocs/docs/api/byte_container_with_subtype/clear_subtype.md b/doc/mkdocs/docs/api/byte_container_with_subtype/clear_subtype.md
deleted file mode 100644
index 56f8ee0..0000000
--- a/doc/mkdocs/docs/api/byte_container_with_subtype/clear_subtype.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# <small>nlohmann::byte_container_with_subtype::</small>clear_subtype
-
-```cpp
-void clear_subtype() noexcept;
-```
-
-Clears the binary subtype and flags the value as not having a subtype, which has implications for serialization; for
-instance MessagePack will prefer the bin family over the ext family.
-
-## Exception safety
-
-No-throw guarantee: this function never throws exceptions.
-
-## Complexity
-
-Constant.
-
-## Version history
-
-Since version 3.8.0.
diff --git a/doc/mkdocs/docs/api/byte_container_with_subtype/has_subtype.md b/doc/mkdocs/docs/api/byte_container_with_subtype/has_subtype.md
deleted file mode 100644
index 2fe4181..0000000
--- a/doc/mkdocs/docs/api/byte_container_with_subtype/has_subtype.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# <small>nlohmann::byte_container_with_subtype::</small>has_subtype
-
-```cpp
-constexpr bool has_subtype() const noexcept;
-```
-
-Returns whether the value has a subtype.
-
-## Return value
-
-whether the value has a subtype
-
-## Exception safety
-
-No-throw guarantee: this function never throws exceptions.
-
-## Complexity
-
-Constant.
-
-## Version history
-
-Since version 3.8.0.
diff --git a/doc/mkdocs/docs/api/json.md b/doc/mkdocs/docs/api/json.md
deleted file mode 100644
index 48d3441..0000000
--- a/doc/mkdocs/docs/api/json.md
+++ /dev/null
@@ -1,12 +0,0 @@
-# <small>nlohmann::</small>json
-
-```cpp
-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.
-
-## Version history
-
-Since version 1.0.0.
diff --git a/doc/mkdocs/docs/api/json_pointer/index.md b/doc/mkdocs/docs/api/json_pointer/index.md
deleted file mode 100644
index 6ef9435..0000000
--- a/doc/mkdocs/docs/api/json_pointer/index.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# <small>nlohmann::</small>json_pointer
-
-```cpp
-template<typename BasicJsonType>
-class json_pointer;
-```
-
-A JSON pointer defines a string syntax for identifying a specific value within a JSON document. It can be used with
-functions [`at`](../basic_json/at.md) and [`operator[]`](../basic_json/operator%5B%5D.md). Furthermore, JSON pointers
-are the base for JSON patches.
-
-## Template parameters
-
-`BasicJsonType`
-: a specialization of [`basic_json`](../basic_json/index.md)
-
-## Member functions
-
-- [(constructor)](json_pointer.md)
-- [**to_string**](to_string.md) - return a string representation of the JSON pointer
-- [**operator std::string**](operator_string.md) - return a string representation of the JSON pointer
-- [**operator/=**](operator_slasheq.md) - append to the end of the JSON pointer
-- [**operator/**](operator_slash.md) - create JSON Pointer by appending
-- [**parent_pointer**](parent_pointer.md) - returns the parent of this JSON pointer
-- [**pop_back**](pop_back.md) - remove last reference token
-- [**back**](back.md) - return last reference token
-- [**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
-
-## See also
-
-- [RFC 6901](https://datatracker.ietf.org/doc/html/rfc6901)
-
-## Version history
-
-Added in version 2.0.0.
diff --git a/doc/mkdocs/docs/api/json_pointer/operator_string.md b/doc/mkdocs/docs/api/json_pointer/operator_string.md
deleted file mode 100644
index 56d8eeb..0000000
--- a/doc/mkdocs/docs/api/json_pointer/operator_string.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# <small>nlohmann::json_pointer::</small>operator std::string
-
-```cpp
-operator std::string() const
-```
-
-Return a string representation of the JSON pointer.
-
-## Return value
-
-A string representation of the JSON pointer
-
-## Possible implementation
-
-```cpp
-operator std::string() const
-{
- return to_string();
-}
-```
-
-## Version history
-
-Since version 2.0.0.
diff --git a/doc/mkdocs/docs/api/json_sax/binary.md b/doc/mkdocs/docs/api/json_sax/binary.md
deleted file mode 100644
index e9a1d39..0000000
--- a/doc/mkdocs/docs/api/json_sax/binary.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# <small>nlohmann::json_sax::</small>binary
-
-```cpp
-virtual bool binary(binary_t& val) = 0;
-```
-
-A binary value was read.
-
-## Parameters
-
-`val` (in)
-: binary value
-
-## Return value
-
-Whether parsing should proceed.
-
-## Notes
-
-It is safe to move the passed binary value.
-
-## Version history
-
-- Added in version 3.8.0.
diff --git a/doc/mkdocs/docs/api/json_sax/boolean.md b/doc/mkdocs/docs/api/json_sax/boolean.md
deleted file mode 100644
index a5a8ddc..0000000
--- a/doc/mkdocs/docs/api/json_sax/boolean.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# <small>nlohmann::json_sax::</small>boolean
-
-```cpp
-virtual bool boolean(bool val) = 0;
-```
-
-A boolean value was read.
-
-## Parameters
-
-`val` (in)
-: boolean value
-
-## Return value
-
-Whether parsing should proceed.
-
-## Version history
-
-- Added in version 3.2.0.
diff --git a/doc/mkdocs/docs/api/json_sax/end_array.md b/doc/mkdocs/docs/api/json_sax/end_array.md
deleted file mode 100644
index 245cf97..0000000
--- a/doc/mkdocs/docs/api/json_sax/end_array.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# <small>nlohmann::json_sax::</small>end_array
-
-```cpp
-virtual bool end_array() = 0;
-```
-
-The end of an array was read.
-
-## Return value
-
-Whether parsing should proceed.
-
-## Version history
-
-- Added in version 3.2.0.
diff --git a/doc/mkdocs/docs/api/json_sax/end_object.md b/doc/mkdocs/docs/api/json_sax/end_object.md
deleted file mode 100644
index 5654e26..0000000
--- a/doc/mkdocs/docs/api/json_sax/end_object.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# <small>nlohmann::json_sax::</small>end_object
-
-```cpp
-virtual bool end_object() = 0;
-```
-
-The end of an object was read.
-
-## Return value
-
-Whether parsing should proceed.
-
-## Version history
-
-- Added in version 3.2.0.
diff --git a/doc/mkdocs/docs/api/json_sax/key.md b/doc/mkdocs/docs/api/json_sax/key.md
deleted file mode 100644
index 5e79272..0000000
--- a/doc/mkdocs/docs/api/json_sax/key.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# <small>nlohmann::json_sax::</small>key
-
-```cpp
-virtual bool key(string_t& val) = 0;
-```
-
-An object key was read.
-
-## Parameters
-
-`val` (in)
-: object key
-
-## Return value
-
-Whether parsing should proceed.
-
-## Notes
-
-It is safe to move the passed object key value.
-
-## Version history
-
-- Added in version 3.2.0.
diff --git a/doc/mkdocs/docs/api/json_sax/null.md b/doc/mkdocs/docs/api/json_sax/null.md
deleted file mode 100644
index bcbb4a3..0000000
--- a/doc/mkdocs/docs/api/json_sax/null.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# <small>nlohmann::json_sax::</small>null
-
-```cpp
-virtual bool null() = 0;
-```
-
-A null value was read.
-
-## Return value
-
-Whether parsing should proceed.
-
-## Version history
-
-- Added in version 3.2.0.
diff --git a/doc/mkdocs/docs/api/json_sax/number_integer.md b/doc/mkdocs/docs/api/json_sax/number_integer.md
deleted file mode 100644
index 00ff2ea..0000000
--- a/doc/mkdocs/docs/api/json_sax/number_integer.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# <small>nlohmann::json_sax::</small>number_integer
-
-```cpp
-virtual bool number_integer(number_integer_t val) = 0;
-```
-
-An integer number was read.
-
-## Parameters
-
-`val` (in)
-: integer value
-
-## Return value
-
-Whether parsing should proceed.
-
-## Version history
-
-- Added in version 3.2.0.
diff --git a/doc/mkdocs/docs/api/json_sax/number_unsigned.md b/doc/mkdocs/docs/api/json_sax/number_unsigned.md
deleted file mode 100644
index 66d0bda..0000000
--- a/doc/mkdocs/docs/api/json_sax/number_unsigned.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# <small>nlohmann::json_sax::</small>number_unsigned
-
-```cpp
-virtual bool number_unsigned(number_unsigned_t val) = 0;
-```
-
-An unsigned integer number was read.
-
-## Parameters
-
-`val` (in)
-: unsigned integer value
-
-## Return value
-
-Whether parsing should proceed.
-
-## Version history
-
-- Added in version 3.2.0.
diff --git a/doc/mkdocs/docs/api/json_sax/string.md b/doc/mkdocs/docs/api/json_sax/string.md
deleted file mode 100644
index 113fe13..0000000
--- a/doc/mkdocs/docs/api/json_sax/string.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# <small>nlohmann::json_sax::</small>string
-
-```cpp
-virtual bool string(string_t& val) = 0;
-```
-
-A string value was read.
-
-## Parameters
-
-`val` (in)
-: string value
-
-## Return value
-
-Whether parsing should proceed.
-
-## Notes
-
-It is safe to move the passed string value.
-
-## Version history
-
-- Added in version 3.2.0.
diff --git a/doc/mkdocs/docs/api/macros/index.md b/doc/mkdocs/docs/api/macros/index.md
deleted file mode 100644
index 9c390d5..0000000
--- a/doc/mkdocs/docs/api/macros/index.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# Macros
-
-Some aspects of the library can be configured by defining preprocessor macros before including the `json.hpp` header.
-
-- [`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`
diff --git a/doc/mkdocs/docs/api/macros/json_assert.md b/doc/mkdocs/docs/api/macros/json_assert.md
deleted file mode 100644
index 63d4ae0..0000000
--- a/doc/mkdocs/docs/api/macros/json_assert.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# JSON_ASSERT(x)
-
-```cpp
-JSON_ASSERT(x)
-```
-
-## Default implementation
-
-```cpp
-assert(x);
-```
diff --git a/doc/mkdocs/docs/api/ordered_json.md b/doc/mkdocs/docs/api/ordered_json.md
deleted file mode 100644
index 8b122f9..0000000
--- a/doc/mkdocs/docs/api/ordered_json.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# <small>nlohmann::</small>ordered_json
-
-```cpp
-using ordered_json = basic_json<ordered_map>;
-```
-
-This type preserves the insertion order of object keys.
-
-## See also
-
-- [ordered_map](ordered_map.md)
-
-## Version history
-
-Since version 3.9.0.
diff --git a/doc/mkdocs/docs/features/element_access/checked_access.md b/doc/mkdocs/docs/features/element_access/checked_access.md
deleted file mode 100644
index fd444be..0000000
--- a/doc/mkdocs/docs/features/element_access/checked_access.md
+++ /dev/null
@@ -1,77 +0,0 @@
-# Checked access: at
-
-## 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.
-
-??? example
-
- Consider the following JSON value:
-
- ```json
- {
- "name": "Mary Smith",
- "age": 42,
- "hobbies": ["hiking", "reading"]
- }
- ```
-
- 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"` |
-
-The return value is a reference, so it can be modified by the original value.
-
-??? example
-
- ```cpp
- j.at("name") = "John Smith";
- ```
-
- This code produces the following JSON value:
-
- ```json
- {
- "name": "John Smith",
- "age": 42,
- "hobbies": ["hiking", "reading"]
- }
- ```
-
-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
-
- ```cpp
- j.at("hobbies").at(3) = "cooking";
- ```
-
- This code produces the following exception:
-
- ```
- [json.exception.out_of_range.401] 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.
-
-## 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 | `basic_json::out_of_range` exception is thrown | `basic_json::out_of_range` exception is thrown |
-| access to invalid array index | `basic_json::out_of_range` exception is thrown | `basic_json::out_of_range` exception is thrown |
diff --git a/doc/mkdocs/docs/features/element_access/unchecked_access.md b/doc/mkdocs/docs/features/element_access/unchecked_access.md
deleted file mode 100644
index bb72287..0000000
--- a/doc/mkdocs/docs/features/element_access/unchecked_access.md
+++ /dev/null
@@ -1,102 +0,0 @@
-# Unchecked access: operator[]
-
-## 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.
-
-??? example
-
- Consider the following JSON value:
-
- ```json
- {
- "name": "Mary Smith",
- "age": 42,
- "hobbies": ["hiking", "reading"]
- }
- ```
-
- 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"` |
-
-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
-
- ```cpp
- j["name"] = "John Smith";
- j["maidenName"] = "Jones";
- ```
-
- This code produces the following JSON value:
-
- ```json
- {
- "name": "John Smith",
- "maidenName": "Jones",
- "age": 42,
- "hobbies": ["hiking", "reading"]
- }
- ```
-
-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
-
- ```cpp
- j["hobbies"][0] = "running";
- j["hobbies"][3] = "cooking";
- ```
-
- This code produces the following JSON value:
-
- ```json
- {
- "name": "John Smith",
- "maidenName": "Jones",
- "age": 42,
- "hobbies": ["running", "reading", null, "cooking"]
- }
- ```
-
-## Notes
-
-!!! info "Design rationale"
-
- The library behaves differently to `#!cpp std::vector` and `#!cpp std::map`:
-
- - `#!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.
-
-!!! 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.
-
-!!! 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).
-
-!!! failure "Exceptions"
-
- `operator[]` 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_error305) is thrown.
-
-## 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 |
diff --git a/doc/mkdocs/docs/features/json_pointer.md b/doc/mkdocs/docs/features/json_pointer.md
deleted file mode 100644
index 8f5d60e..0000000
--- a/doc/mkdocs/docs/features/json_pointer.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# JSON Pointer
-
-The library supports **JSON Pointer** ([RFC 6901](https://tools.ietf.org/html/rfc6901)) as alternative means to address structured values.
-
-```cpp
-// a JSON value
-json j_original = R"({
- "baz": ["one", "two", "three"],
- "foo": "bar"
-})"_json;
-
-// access members with a JSON pointer (RFC 6901)
-j_original["/baz/1"_json_pointer];
-// "two"
-```
-
-## See also
-
-- Class [`json_pointer`](../api/json_pointer/index.md)
diff --git a/doc/mkdocs/docs/features/macros.md b/doc/mkdocs/docs/features/macros.md
deleted file mode 100644
index d324a13..0000000
--- a/doc/mkdocs/docs/features/macros.md
+++ /dev/null
@@ -1,134 +0,0 @@
-# Supported Macros
-
-Some aspects of the library can be configured by defining preprocessor macros before including the `json.hpp` header.
-
-## `JSON_ASSERT(x)`
-
-The default value is `#!cpp assert(x)`.
-
-## `JSON_CATCH_USER(exception)`
-
-This macro overrides `#!cpp 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.
-
-## `JSON_DIAGNOSTICS`
-
-This macro enables extended diagnostics for exception messages. Possible values are `1` to enable or `0` to disable
-(default).
-
-When enabled, exception messages contain a [JSON Pointer](json_pointer.md) to the JSON value that triggered the
-exception, see [Extended diagnostic messages](../home/exceptions.md#extended-diagnostic-messages) for an example. 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.
-
-## `JSON_HAS_CPP_11`, `JSON_HAS_CPP_14`, `JSON_HAS_CPP_17`, `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.
-
-## `JSON_HAS_FILESYSTEM`, `JSON_HAS_EXPERIMENTAL_FILESYSTEM`
-
-When compiling with C++17, the library provides conversions from and to `std::filesystem::path`. As compiler support
-for filesystem is limited, the library tries to detect whether `<filesystem>`/`std::filesystem` (`JSON_HAS_FILESYSTEM`)
-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`.
-
-## `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`.
-
-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).
-
-## `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 environment where these I/O functions are disallowed for
-security reasons (e.g., Intel Software Guard Extensions (SGX)).
-
-## `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.
-
-## `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.
-
-See [Switch off exceptions](../home/exceptions.md#switch-off-exceptions) for an example.
-
-## `JSON_TRY_USER`
-
-This macro overrides `#!cpp try` calls inside the library. It has no arguments and is always followed by a scope.
-
-See [Switch off exceptions](../home/exceptions.md#switch-off-exceptions) for an example.
-
-## `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.
-
-## `NLOHMANN_DEFINE_TYPE_INTRUSIVE(type, member...)`
-
-This macro can be used to simplify the serialization/deserialization of types if (1) want to use a JSON object as
-serialization and (2) 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_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.
-
-## `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(type, member...)`
-
-This macro can be used to simplify the serialization/deserialization of types if (1) want to use a JSON object as
-serialization and (2) want to use the member variable names as object keys in that object.
-
-The macro is to be defined inside the namespace of the class/struct to create code for. Private members cannot be
-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.
-
-## `NLOHMANN_JSON_SERIALIZE_ENUM(type, ...)`
-
-This macro simplifies the serialization/deserialization of enum types. See
-[Specializing enum conversion](enum_conversion.md) for more information.
-
-## `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).
diff --git a/doc/mkdocs/docs/features/object_order.md b/doc/mkdocs/docs/features/object_order.md
deleted file mode 100644
index 86bb253..0000000
--- a/doc/mkdocs/docs/features/object_order.md
+++ /dev/null
@@ -1,67 +0,0 @@
-# Object Order
-
-The [JSON standard](https://tools.ietf.org/html/rfc8259.html) defines objects as "an unordered collection of zero or more name/value pairs". As such, an implementation does not need to preserve any specific order of object keys.
-
-The default type `nlohmann::json` uses a `std::map` to store JSON objects, and thus stores object keys **sorted alphabetically**.
-
-??? example
-
- ```cpp
- #include <iostream>
- #include "json.hpp"
-
- using json = nlohmann::json;
-
- int main()
- {
- json j;
- j["one"] = 1;
- j["two"] = 2;
- j["three"] = 3;
-
- std::cout << j.dump(2) << '\n';
- }
- ```
-
- Output:
-
- ```json
- {
- "one": 1,
- "three": 3,
- "two": 2
- }
- ```
-
-If you do want to preserve the **insertion order**, you can try the type [`nlohmann::ordered_json`](https://github.com/nlohmann/json/issues/2179).
-
-??? 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';
- }
- ```
-
- Output:
-
- ```json
- {
- "one": 1,
- "two": 2,
- "three": 3
- }
- ```
-
-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/doc/mkdocs/docs/integration/cmake.md b/doc/mkdocs/docs/integration/cmake.md
deleted file mode 100644
index 9f1ecc9..0000000
--- a/doc/mkdocs/docs/integration/cmake.md
+++ /dev/null
@@ -1,138 +0,0 @@
-# CMake
-
-## Integration
-
-You can also use the `nlohmann_json::nlohmann_json` interface target in CMake. This target populates the appropriate usage requirements for `INTERFACE_INCLUDE_DIRECTORIES` to point to the appropriate include directories and `INTERFACE_COMPILE_FEATURES` for the necessary C++11 flags.
-
-### External
-
-To use this library from a CMake project, you can locate it directly with `find_package()` and use the namespaced imported target from the generated package configuration:
-
-```cmake
-# CMakeLists.txt
-find_package(nlohmann_json 3.2.0 REQUIRED)
-...
-add_library(foo ...)
-...
-target_link_libraries(foo PRIVATE nlohmann_json::nlohmann_json)
-```
-
-The package configuration file, `nlohmann_jsonConfig.cmake`, can be used either from an install tree or directly out of the build tree.
-
-### Embedded
-
-To embed the library directly into an existing CMake project, place the entire source tree in a subdirectory and call `add_subdirectory()` in your `CMakeLists.txt` file:
-
-```cmake
-# If you only include this third party in PRIVATE source files, you do not
-# need to install it when your main project gets installed.
-# set(JSON_Install OFF CACHE INTERNAL "")
-
-# Don't use include(nlohmann_json/CMakeLists.txt) since that carries with it
-# unintended consequences that will break the build. It's generally
-# discouraged (although not necessarily well documented as such) to use
-# include(...) for pulling in other CMake projects anyways.
-add_subdirectory(nlohmann_json)
-...
-add_library(foo ...)
-...
-target_link_libraries(foo PRIVATE nlohmann_json::nlohmann_json)
-```
-
-### Embedded (FetchContent)
-
-Since CMake v3.11,
-[FetchContent](https://cmake.org/cmake/help/v3.11/module/FetchContent.html) can
-be used to automatically download the repository as a dependency at configure type.
-
-Example:
-```cmake
-include(FetchContent)
-
-FetchContent_Declare(json
- GIT_REPOSITORY https://github.com/nlohmann/json
- GIT_TAG v3.7.3)
-
-FetchContent_GetProperties(json)
-if(NOT json_POPULATED)
- FetchContent_Populate(json)
- add_subdirectory(${json_SOURCE_DIR} ${json_BINARY_DIR} EXCLUDE_FROM_ALL)
-endif()
-
-target_link_libraries(foo PRIVATE nlohmann_json::nlohmann_json)
-```
-
-!!! Note
- The repository <https://github.com/nlohmann/json> download size is quite large.
- You might want to depend on a smaller repository. For instance, you might want to replace the URL above by
- <https://github.com/ArthurSonzogni/nlohmann_json_cmake_fetchcontent>.
-
-### Supporting Both
-
-To allow your project to support either an externally supplied or an embedded JSON library, you can use a pattern akin to the following:
-
-``` cmake
-# Top level CMakeLists.txt
-project(FOO)
-...
-option(FOO_USE_EXTERNAL_JSON "Use an external JSON library" OFF)
-...
-add_subdirectory(thirdparty)
-...
-add_library(foo ...)
-...
-# Note that the namespaced target will always be available regardless of the
-# import method
-target_link_libraries(foo PRIVATE nlohmann_json::nlohmann_json)
-```
-```cmake
-# thirdparty/CMakeLists.txt
-...
-if(FOO_USE_EXTERNAL_JSON)
- find_package(nlohmann_json 3.2.0 REQUIRED)
-else()
- set(JSON_BuildTests OFF CACHE INTERNAL "")
- add_subdirectory(nlohmann_json)
-endif()
-...
-```
-
-`thirdparty/nlohmann_json` is then a complete copy of this source tree.
-
-## CMake Options
-
-### `JSON_BuildTests`
-
-Build the unit tests when [`BUILD_TESTING`](https://cmake.org/cmake/help/latest/command/enable_testing.html) is enabled. This option is `ON` by default if the library's CMake project is the top project. That is, when integrating the library as described above, the test suite is not built unless explicitly switched on with this option.
-
-### `JSON_CI`
-
-Enable CI build targets. The exact targets are used during the several CI steps and are subject to change without notice. This option is `OFF` by default.
-
-### `JSON_Diagnostics`
-
-Enable [extended diagnostic messages](../home/exceptions.md#extended-diagnostic-messages) by defining macro [`JSON_DIAGNOSTICS`](../features/macros.md#json_diagnostics). This option is `OFF` by default.
-
-### `JSON_FastTests`
-
-Skip expensive/slow test suites. This option is `OFF` by default. Depends on `JSON_BuildTests`.
-
-### `JSON_ImplicitConversions`
-
-Enable implicit conversions by defining macro [`JSON_USE_IMPLICIT_CONVERSIONS`](../features/macros.md#json_use_implicit_conversions). This option is `ON` by default.
-
-### `JSON_Install`
-
-Install CMake targets during install step. This option is `ON` by default if the library's CMake project is the top project.
-
-### `JSON_MultipleHeaders`
-
-Use non-amalgamated version of the library. This option is `OFF` by default.
-
-### `JSON_SystemInclude`
-
-Treat the library headers like system headers (i.e., adding `SYSTEM` to the [`target_include_directories`](https://cmake.org/cmake/help/latest/command/target_include_directories.html) call) to checks for this library by tools like Clang-Tidy. This option is `OFF` by default.
-
-### `JSON_Valgrind`
-
-Execute test suite with [Valgrind](https://valgrind.org). This option is `OFF` by default. Depends on `JSON_BuildTests`.
diff --git a/doc/mkdocs/docs/integration/example.cpp b/doc/mkdocs/docs/integration/example.cpp
deleted file mode 100644
index e5a31be..0000000
--- a/doc/mkdocs/docs/integration/example.cpp
+++ /dev/null
@@ -1,9 +0,0 @@
-#include <nlohmann/json.hpp>
-#include <iostream>
-
-using json = nlohmann::json;
-
-int main()
-{
- std::cout << json::meta() << std::endl;
-}
diff --git a/doc/mkdocs/docs/integration/index.md b/doc/mkdocs/docs/integration/index.md
deleted file mode 100644
index 5ee4ff7..0000000
--- a/doc/mkdocs/docs/integration/index.md
+++ /dev/null
@@ -1,14 +0,0 @@
-# Header only
-
-[`json.hpp`](https://github.com/nlohmann/json/blob/develop/single_include/nlohmann/json.hpp) is the single required file in `single_include/nlohmann` or [released here](https://github.com/nlohmann/json/releases). You need to add
-
-```cpp
-#include <nlohmann/json.hpp>
-
-// for convenience
-using json = nlohmann::json;
-```
-
-to the files you want to process JSON and set the necessary switches to enable C++11 (e.g., `-std=c++11` for GCC and Clang).
-
-You can further use file [`include/nlohmann/json_fwd.hpp`](https://github.com/nlohmann/json/blob/develop/include/nlohmann/json_fwd.hpp) for forward-declarations. The installation of `json_fwd.hpp` (as part of CMake's install step), can be achieved by setting `-DJSON_MultipleHeaders=ON`.
diff --git a/doc/mkdocs/requirements.txt b/doc/mkdocs/requirements.txt
deleted file mode 100644
index b64e9b8..0000000
--- a/doc/mkdocs/requirements.txt
+++ /dev/null
@@ -1,29 +0,0 @@
-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
diff --git a/doc/mkdocs/scripts/check_structure.py b/doc/mkdocs/scripts/check_structure.py
deleted file mode 100644
index cacc51c..0000000
--- a/doc/mkdocs/scripts/check_structure.py
+++ /dev/null
@@ -1,121 +0,0 @@
-#!/usr/bin/env python
-
-import glob
-import os.path
-
-
-def check_structure():
- expected_headers = [
- 'Template parameters',
- 'Specializations',
- 'Iterator invalidation',
- 'Requirements',
- 'Member types',
- 'Member functions',
- 'Member variables',
- 'Static functions',
- 'Non-member functions',
- 'Literals',
- 'Helper classes',
- 'Parameters',
- 'Return value',
- 'Exception safety',
- 'Exceptions',
- 'Complexity',
- 'Possible implementation',
- 'Notes',
- 'Examples',
- 'See also',
- 'Version history'
- ]
-
- required_headers = [
- 'Examples',
- 'Version history'
- ]
-
- files = sorted(glob.glob('api/**/*.md', recursive=True))
- for file in files:
- with open(file) as file_content:
- header_idx = -1
- existing_headers = []
- in_initial_code_example = False
- previous_line = None
- h1sections = 0
-
- for lineno, line in enumerate(file_content.readlines()):
- line = line.strip()
-
- if line.startswith('# '):
- h1sections += 1
-
- # there should only be one top-level title
- if h1sections > 1:
- print(f'{file}:{lineno+1}: Error: 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!')
-
- # 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)!')
-
- # check if headers are correct
- if line.startswith('## '):
- header = line.strip('## ')
- existing_headers.append(header)
-
- 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
- else:
- print(f'{file}:{lineno+1}: Error: header "{header}" is not part of the expected headers!')
-
- # code example
- if line == '```cpp' and header_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}')
-
- 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!')
-
- 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!')
-
-
-def check_examples():
- example_files = sorted(glob.glob('../../examples/*.cpp'))
- markdown_files = sorted(glob.glob('**/*.md', recursive=True))
-
- # check if every example file is used in at least one markdown file
- for example_file in example_files:
- example_file = os.path.join('examples', os.path.basename(example_file))
-
- found = False
- for markdown_file in markdown_files:
- content = ' '.join(open(markdown_file).readlines())
- if example_file in content:
- found = True
- break
-
- if not found:
- print(f'{example_file}: Error: example file is not used in any documentation file!')
-
-
-if __name__ == '__main__':
- check_structure()
- check_examples()
diff --git a/docs/Makefile b/docs/Makefile
new file mode 100644
index 0000000..35c30da
--- /dev/null
+++ b/docs/Makefile
@@ -0,0 +1,45 @@
+SRCDIR = ../single_include
+
+all: create_output
+
+##########################################################################
+# example files
+##########################################################################
+
+# where are the example cpp files
+EXAMPLES = $(wildcard examples/*.cpp)
+
+cxx_standard = $(lastword c++11 $(filter c++%, $(subst ., ,$1)))
+
+# create output from a stand-alone example file
+%.output: %.cpp
+ @echo "standard $(call cxx_standard $(<:.cpp=))"
+ $(MAKE) $(<:.cpp=) \
+ CPPFLAGS="-I $(SRCDIR) -DJSON_USE_GLOBAL_UDLS=0" \
+ CXXFLAGS="-std=$(call cxx_standard,$(<:.cpp=)) -Wno-deprecated-declarations"
+ ./$(<:.cpp=) > $@
+ rm $(<:.cpp=)
+
+# compare created output with current output of the example files
+%.test: %.cpp
+ $(MAKE) $(<:.cpp=) \
+ CPPFLAGS="-I $(SRCDIR) -DJSON_USE_GLOBAL_UDLS=0" \
+ CXXFLAGS="-std=$(call cxx_standard,$(<:.cpp=)) -Wno-deprecated-declarations"
+ ./$(<:.cpp=) > $@
+ diff $@ $(<:.cpp=.output)
+ rm $(<:.cpp=) $@
+
+# create output from all stand-alone example files
+create_output: $(EXAMPLES:.cpp=.output)
+
+# check output of all stand-alone example files
+check_output: $(EXAMPLES:.cpp=.test)
+
+# check output of all stand-alone example files (exclude files with platform-dependent output.)
+# This target is used in the CI (ci_test_documentation).
+check_output_portable: $(filter-out examples/meta.test examples/max_size.test examples/std_hash.test examples/basic_json__CompatibleType.test,$(EXAMPLES:.cpp=.test))
+
+clean:
+ rm -fr $(EXAMPLES:.cpp=)
+ $(MAKE) clean -C docset
+ $(MAKE) clean -C mkdocs
diff --git a/doc/README.md b/docs/README.md
similarity index 94%
rename from doc/README.md
rename to docs/README.md
index ec5c25d..b39d54e 100644
--- a/doc/README.md
+++ b/docs/README.md
@@ -13,7 +13,7 @@
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/docs/avatars.png b/docs/avatars.png
new file mode 100644
index 0000000..69e7da3
--- /dev/null
+++ b/docs/avatars.png
Binary files differ
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/docs/docset/Makefile b/docs/docset/Makefile
new file mode 100644
index 0000000..6cdca4a
--- /dev/null
+++ b/docs/docset/Makefile
@@ -0,0 +1,86 @@
+SED ?= $(shell which gsed 2>/dev/null || which sed)
+
+MKDOCS_PAGES=$(shell cd ../mkdocs/docs/ && find * -type f -name '*.md' | sort)
+
+.PHONY: all
+all: JSON_for_Modern_C++.tgz
+
+docSet.dsidx: docSet.sql
+ # generate index
+ sqlite3 docSet.dsidx <docSet.sql
+
+JSON_for_Modern_C++.docset: Info.plist docSet.dsidx
+ rm -fr JSON_for_Modern_C++.docset JSON_for_Modern_C++.tgz
+ mkdir -p JSON_for_Modern_C++.docset/Contents/Resources/Documents/
+ cp icon*.png JSON_for_Modern_C++.docset
+ cp Info.plist JSON_for_Modern_C++.docset/Contents
+ # build and copy documentation
+ $(MAKE) build -C ../mkdocs
+ cp -r ../mkdocs/site/* JSON_for_Modern_C++.docset/Contents/Resources/Documents
+ # patch CSS to hide navigation items
+ echo -e "\n\nheader, footer, nav.md-tabs, nav.md-tabs--active, div.md-sidebar--primary, a.md-content__button { display: none; }" >> "$$(ls JSON_for_Modern_C++.docset/Contents/Resources/Documents/assets/stylesheets/main.*.min.css)"
+ # fix spacing
+ echo -e "\n\ndiv.md-sidebar div.md-sidebar--secondary, div.md-main__inner { top: 0; margin-top: 0 }" >> "$$(ls JSON_for_Modern_C++.docset/Contents/Resources/Documents/assets/stylesheets/main.*.min.css)"
+ # remove "JSON for Modern C++" from page titles (fallback)
+ find JSON_for_Modern_C++.docset/Contents/Resources/Documents -type f -exec $(SED) -i 's| - JSON for Modern C++</title>|</title>|' {} +
+ # replace page titles with name from index, if available
+ for page in $(MKDOCS_PAGES); do \
+ case "$$page" in \
+ */index.md) path=$${page/\/index.md/} ;; \
+ *) path=$${page/.md/} ;; \
+ esac; \
+ title=$$(sqlite3 docSet.dsidx "SELECT name FROM searchIndex WHERE path='$$path/index.html'" | tr '\n' ',' | $(SED) -e 's/,/, /g' -e 's/, $$/\n/'); \
+ if [ "x$$title" != "x" ]; then \
+ $(SED) -i "s%<title>.*</title>%<title>$$title</title>%" "JSON_for_Modern_C++.docset/Contents/Resources/Documents/$$path/index.html"; \
+ fi \
+ done
+ # clean up
+ rm JSON_for_Modern_C++.docset/Contents/Resources/Documents/sitemap.*
+ # copy index
+ cp docSet.dsidx JSON_for_Modern_C++.docset/Contents/Resources/
+
+JSON_for_Modern_C++.tgz: JSON_for_Modern_C++.docset
+ tar --exclude='.DS_Store' -cvzf JSON_for_Modern_C++.tgz JSON_for_Modern_C++.docset
+
+# install docset for Zeal documentation browser (https://zealdocs.org/)
+.PHONY: install_docset_zeal
+install_docset_zeal: JSON_for_Modern_C++.docset
+ docset_root=$${XDG_DATA_HOME:-$$HOME/.local/share}/Zeal/Zeal/docsets; \
+ rm -rf $$docset_root/JSON_for_Modern_C++.docset; \
+ mkdir -p $$docset_root; \
+ cp -r JSON_for_Modern_C++.docset $$docset_root/
+
+# list mkdocs pages missing from the docset index
+.PHONY: list_missing_pages
+list_missing_pages: docSet.dsidx
+ @for page in $(MKDOCS_PAGES); do \
+ case "$$page" in \
+ */index.md) path=$${page/\/index.md/} ;; \
+ *) path=$${page/.md/} ;; \
+ esac; \
+ if [ "x$$page" != "xindex.md" -a "x$$(sqlite3 docSet.dsidx "SELECT COUNT(*) FROM searchIndex WHERE path='$$path/index.html'")" = "x0" ]; then \
+ echo $$page; \
+ fi \
+ done
+
+# list paths in the docset index without a corresponding mkdocs page
+.PHONY: list_removed_paths
+list_removed_paths: docSet.dsidx
+ @for path in $$(sqlite3 docSet.dsidx "SELECT path FROM searchIndex"); do \
+ page=$${path/\/index.html/.md}; \
+ page_index=$${path/index.html/index.md}; \
+ page_found=0; \
+ for p in $(MKDOCS_PAGES); do \
+ if [ "x$$p" = "x$$page" -o "x$$p" = "x$$page_index" ]; then \
+ page_found=1; \
+ fi \
+ done; \
+ if [ "x$$page_found" = "x0" ]; then \
+ echo $$path; \
+ fi \
+ done
+
+.PHONY: clean
+clean:
+ rm -f docSet.dsidx
+ rm -fr JSON_for_Modern_C++.docset JSON_for_Modern_C++.tgz
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/docs/docset/docSet.sql b/docs/docset/docSet.sql
new file mode 100644
index 0000000..e076ea5
--- /dev/null
+++ b/docs/docset/docSet.sql
@@ -0,0 +1,229 @@
+DROP TABLE IF EXISTS searchIndex;
+CREATE TABLE searchIndex(id INTEGER PRIMARY KEY, name TEXT, type TEXT, path TEXT);
+CREATE UNIQUE INDEX anchor ON searchIndex (name, type, path);
+
+-- API
+INSERT INTO searchIndex(name, type, path) VALUES ('adl_serializer', 'Class', 'api/adl_serializer/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('adl_serializer::from_json', 'Function', 'api/adl_serializer/from_json/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('adl_serializer::to_json', 'Function', 'api/adl_serializer/to_json/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('byte_container_with_subtype', 'Class', 'api/byte_container_with_subtype/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('byte_container_with_subtype::byte_container_with_subtype', 'Constructor', 'api/byte_container_with_subtype/byte_container_with_subtype/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('byte_container_with_subtype::clear_subtype', 'Method', 'api/byte_container_with_subtype/clear_subtype/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('byte_container_with_subtype::has_subtype', 'Method', 'api/byte_container_with_subtype/has_subtype/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('byte_container_with_subtype::set_subtype', 'Method', 'api/byte_container_with_subtype/set_subtype/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('byte_container_with_subtype::subtype', 'Method', 'api/byte_container_with_subtype/subtype/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json', 'Class', 'api/basic_json/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::accept', 'Function', 'api/basic_json/accept/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::array', 'Function', 'api/basic_json/array/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::array_t', 'Type', 'api/basic_json/array_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::at', 'Method', 'api/basic_json/at/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::back', 'Method', 'api/basic_json/back/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::basic_json', 'Constructor', 'api/basic_json/basic_json/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::begin', 'Method', 'api/basic_json/begin/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::binary', 'Function', 'api/basic_json/binary/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::binary_t', 'Type', 'api/basic_json/binary_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::boolean_t', 'Type', 'api/basic_json/boolean_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::cbegin', 'Method', 'api/basic_json/cbegin/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::cbor_tag_handler_t', 'Enum', 'api/basic_json/cbor_tag_handler_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::cend', 'Method', 'api/basic_json/cend/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::clear', 'Method', 'api/basic_json/clear/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::contains', 'Method', 'api/basic_json/contains/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::count', 'Method', 'api/basic_json/count/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::crbegin', 'Method', 'api/basic_json/crbegin/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::crend', 'Method', 'api/basic_json/crend/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::default_object_comparator_t', 'Type', 'api/basic_json/default_object_comparator_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::diff', 'Function', 'api/basic_json/diff/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::dump', 'Method', 'api/basic_json/dump/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::emplace', 'Method', 'api/basic_json/emplace/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::emplace_back', 'Method', 'api/basic_json/emplace_back/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::empty', 'Method', 'api/basic_json/empty/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::end', 'Method', 'api/basic_json/end/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::erase', 'Method', 'api/basic_json/erase/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::error_handler_t', 'Enum', 'api/basic_json/error_handler_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::exception', 'Class', 'api/basic_json/exception/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::find', 'Method', 'api/basic_json/find/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::flatten', 'Method', 'api/basic_json/flatten/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::from_bjdata', 'Function', 'api/basic_json/from_bjdata/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::from_bson', 'Function', 'api/basic_json/from_bson/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::from_cbor', 'Function', 'api/basic_json/from_cbor/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::from_msgpack', 'Function', 'api/basic_json/from_msgpack/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::from_ubjson', 'Function', 'api/basic_json/from_ubjson/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::front', 'Method', 'api/basic_json/front/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::get', 'Method', 'api/basic_json/get/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::get_allocator', 'Function', 'api/basic_json/get_allocator/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::get_binary', 'Method', 'api/basic_json/get_binary/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::get_ptr', 'Method', 'api/basic_json/get_ptr/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::get_ref', 'Method', 'api/basic_json/get_ref/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::get_to', 'Method', 'api/basic_json/get_to/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::input_format_t', 'Enum', 'api/basic_json/input_format_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::insert', 'Method', 'api/basic_json/insert/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::invalid_iterator', 'Class', 'api/basic_json/invalid_iterator/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::is_array', 'Method', 'api/basic_json/is_array/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::is_binary', 'Method', 'api/basic_json/is_binary/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::is_boolean', 'Method', 'api/basic_json/is_boolean/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::is_discarded', 'Method', 'api/basic_json/is_discarded/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::is_null', 'Method', 'api/basic_json/is_null/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::is_number', 'Method', 'api/basic_json/is_number/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::is_number_float', 'Method', 'api/basic_json/is_number_float/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::is_number_integer', 'Method', 'api/basic_json/is_number_integer/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::is_number_unsigned', 'Method', 'api/basic_json/is_number_unsigned/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::is_object', 'Method', 'api/basic_json/is_object/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::is_primitive', 'Method', 'api/basic_json/is_primitive/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::is_string', 'Method', 'api/basic_json/is_string/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::is_structured', 'Method', 'api/basic_json/is_structured/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::items', 'Method', 'api/basic_json/items/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::json_serializer', 'Class', 'api/basic_json/json_serializer/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::max_size', 'Method', 'api/basic_json/max_size/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::merge_patch', 'Method', 'api/basic_json/merge_patch/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::meta', 'Function', 'api/basic_json/meta/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::number_float_t', 'Type', 'api/basic_json/number_float_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::number_integer_t', 'Type', 'api/basic_json/number_integer_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::number_unsigned_t', 'Type', 'api/basic_json/number_unsigned_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::object', 'Function', 'api/basic_json/object/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::object_comparator_t', 'Type', 'api/basic_json/object_comparator_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::object_t', 'Type', 'api/basic_json/object_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::operator ValueType', 'Operator', 'api/basic_json/operator_ValueType/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::operator value_t', 'Operator', 'api/basic_json/operator_value_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::operator[]', 'Operator', 'api/basic_json/operator[]/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::operator=', 'Operator', 'api/basic_json/operator=/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::operator+=', 'Operator', 'api/basic_json/operator+=/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::operator==', 'Operator', 'api/basic_json/operator_eq/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::operator!=', 'Operator', 'api/basic_json/operator_ne/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::operator<', 'Operator', 'api/basic_json/operator_lt/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::operator<=', 'Operator', 'api/basic_json/operator_le/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::operator>', 'Operator', 'api/basic_json/operator_gt/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::operator>=', 'Operator', 'api/basic_json/operator_ge/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::operator<=>', 'Operator', 'api/basic_json/operator_spaceship/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::out_of_range', 'Class', 'api/basic_json/out_of_range/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::other_error', 'Class', 'api/basic_json/other_error/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::parse', 'Function', 'api/basic_json/parse/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::parse_error', 'Class', 'api/basic_json/parse_error/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::parse_event_t', 'Enum', 'api/basic_json/parse_event_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::parser_callback_t', 'Type', 'api/basic_json/parser_callback_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::patch', 'Method', 'api/basic_json/patch/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::patch_inplace', 'Method', 'api/basic_json/patch_inplace/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::push_back', 'Method', 'api/basic_json/push_back/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::rbegin', 'Method', 'api/basic_json/rbegin/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::rend', 'Method', 'api/basic_json/rend/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::sax_parse', 'Function', 'api/basic_json/sax_parse/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::size', 'Method', 'api/basic_json/size/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::string_t', 'Type', 'api/basic_json/string_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::swap', 'Method', 'api/basic_json/swap/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::type', 'Method', 'api/basic_json/type/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::type_error', 'Class', 'api/basic_json/type_error/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::type_name', 'Method', 'api/basic_json/type_name/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::unflatten', 'Method', 'api/basic_json/unflatten/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::update', 'Method', 'api/basic_json/update/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::to_bjdata', 'Function', 'api/basic_json/to_bjdata/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::to_bson', 'Function', 'api/basic_json/to_bson/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::to_cbor', 'Function', 'api/basic_json/to_cbor/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::to_msgpack', 'Function', 'api/basic_json/to_msgpack/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::to_string', 'Method', 'api/basic_json/to_string/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::to_ubjson', 'Function', 'api/basic_json/to_ubjson/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::value', 'Method', 'api/basic_json/value/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::value_t', 'Enum', 'api/basic_json/value_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('basic_json::~basic_json', 'Method', 'api/basic_json/~basic_json/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json', 'Class', 'api/json/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_pointer', 'Class', 'api/json_pointer/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_pointer::back', 'Method', 'api/json_pointer/back/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_pointer::empty', 'Method', 'api/json_pointer/empty/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_pointer::json_pointer', 'Constructor', 'api/json_pointer/json_pointer/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_pointer::operator/', 'Operator', 'api/json_pointer/operator_slash/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_pointer::operator/=', 'Operator', 'api/json_pointer/operator_slasheq/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_pointer::operator string_t', 'Operator', 'api/json_pointer/operator_string_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_pointer::parent_pointer', 'Method', 'api/json_pointer/parent_pointer/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_pointer::pop_back', 'Method', 'api/json_pointer/pop_back/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_pointer::push_back', 'Method', 'api/json_pointer/push_back/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_pointer::string_t', 'Type', 'api/json_pointer/string_t/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_pointer::to_string', 'Method', 'api/json_pointer/to_string/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_sax', 'Class', 'api/json_sax/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_sax::binary', 'Method', 'api/json_sax/binary/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_sax::boolean', 'Method', 'api/json_sax/boolean/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_sax::end_array', 'Method', 'api/json_sax/end_array/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_sax::end_object', 'Method', 'api/json_sax/end_object/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_sax::key', 'Method', 'api/json_sax/key/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_sax::null', 'Method', 'api/json_sax/null/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_sax::number_float', 'Method', 'api/json_sax/number_float/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_sax::number_integer', 'Method', 'api/json_sax/number_integer/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_sax::number_unsigned', 'Method', 'api/json_sax/number_unsigned/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_sax::parse_error', 'Method', 'api/json_sax/parse_error/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_sax::start_array', 'Method', 'api/json_sax/start_array/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_sax::start_object', 'Method', 'api/json_sax/start_object/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('json_sax::string', 'Method', 'api/json_sax/string/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('operator""_json', 'Literal', 'api/operator_literal_json/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('operator""_json_pointer', 'Literal', 'api/operator_literal_json_pointer/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('operator<<', 'Operator', 'api/operator_ltlt/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('operator>>', 'Operator', 'api/operator_gtgt/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('ordered_json', 'Class', 'api/ordered_json/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('ordered_map', 'Class', 'api/ordered_map/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('std::hash<basic_json>', 'Class', 'api/basic_json/std_hash/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('std::swap<basic_json>', 'Function', 'api/basic_json/std_swap/index.html');
+
+-- Features
+INSERT INTO searchIndex(name, type, path) VALUES ('Arbitrary Type Conversions', 'Guide', 'features/arbitrary_types/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Binary Formats', 'Guide', 'features/binary_formats/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Binary Formats: BJData', 'Guide', 'features/binary_formats/bjdata/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Binary Formats: BSON', 'Guide', 'features/binary_formats/bson/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Binary Formats: CBOR', 'Guide', 'features/binary_formats/cbor/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Binary Formats: MessagePack', 'Guide', 'features/binary_formats/messagepack/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Binary Formats: UBJSON', 'Guide', 'features/binary_formats/ubjson/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Binary Values', 'Guide', 'features/binary_values/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Comments', 'Guide', 'features/comments/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Element Access', 'Guide', 'features/element_access/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Element Access: Access with default value: value', 'Guide', 'features/element_access/default_value/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Element Access: Checked access: at', 'Guide', 'features/element_access/checked_access/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Element Access: Unchecked access: operator[]', 'Guide', 'features/element_access/unchecked_access/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Integration: CMake', 'Guide', 'integration/cmake/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Integration: Header only', 'Guide', 'integration/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Integration: Package Managers', 'Guide', 'integration/package_managers/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Integration: Pkg-config', 'Guide', 'integration/pkg-config/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Iterators', 'Guide', 'features/iterators/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON Merge Patch', 'Guide', 'features/merge_patch/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON Patch and Diff', 'Guide', 'features/json_patch/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON Pointer', 'Guide', 'features/json_pointer/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Types', 'Guide', 'features/types/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Types: Number Handling', 'Guide', 'features/types/number_handling/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Object Order', 'Guide', 'features/object_order/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Parsing', 'Guide', 'features/parsing/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Parsing: JSON Lines', 'Guide', 'features/parsing/json_lines/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Parsing: Parser Callbacks', 'Guide', 'features/parsing/parser_callbacks/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Parsing: Parsing and Exceptions', 'Guide', 'features/parsing/parse_exceptions/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Parsing: SAX Interface', 'Guide', 'features/parsing/sax_interface/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Runtime Assertions', 'Guide', 'features/assertions/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Specializing enum conversion', 'Guide', 'features/enum_conversion/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Supported Macros', 'Guide', 'features/macros/index.html');
+
+-- Macros
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_ASSERT', 'Macro', 'api/macros/json_assert/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_CATCH_USER', 'Macro', 'api/macros/json_throw_user/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_DIAGNOSTICS', 'Macro', 'api/macros/json_diagnostics/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_DISABLE_ENUM_SERIALIZATION', 'Macro', 'api/macros/json_disable_enum_serialization/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_HAS_CPP_11', 'Macro', 'api/macros/json_has_cpp_11/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_HAS_CPP_14', 'Macro', 'api/macros/json_has_cpp_11/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_HAS_CPP_17', 'Macro', 'api/macros/json_has_cpp_11/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_HAS_CPP_20', 'Macro', 'api/macros/json_has_cpp_11/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_HAS_EXPERIMENTAL_FILESYSTEM', 'Macro', 'api/macros/json_has_filesystem/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_HAS_FILESYSTEM', 'Macro', 'api/macros/json_has_filesystem/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_HAS_RANGES', 'Macro', 'api/macros/json_has_ranges/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_HAS_THREE_WAY_COMPARISON', 'Macro', 'api/macros/json_has_three_way_comparison/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_NOEXCEPTION', 'Macro', 'api/macros/json_noexception/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_NO_IO', 'Macro', 'api/macros/json_no_io/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_SKIP_LIBRARY_VERSION_CHECK', 'Macro', 'api/macros/json_skip_library_version_check/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_SKIP_UNSUPPORTED_COMPILER_CHECK', 'Macro', 'api/macros/json_skip_unsupported_compiler_check/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_THROW_USER', 'Macro', 'api/macros/json_throw_user/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_TRY_USER', 'Macro', 'api/macros/json_throw_user/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_USE_GLOBAL_UDLS', 'Macro', 'api/macros/json_use_global_udls/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_USE_IMPLICIT_CONVERSIONS', 'Macro', 'api/macros/json_use_implicit_conversions/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON', 'Macro', 'api/macros/json_use_legacy_discarded_value_comparison/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('Macros', 'Macro', 'api/macros/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('NLOHMANN_DEFINE_TYPE_INTRUSIVE', 'Macro', 'api/macros/nlohmann_define_type_intrusive/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT', 'Macro', 'api/macros/nlohmann_define_type_intrusive/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE', 'Macro', 'api/macros/nlohmann_define_type_non_intrusive/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT', 'Macro', 'api/macros/nlohmann_define_type_non_intrusive/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('NLOHMANN_JSON_NAMESPACE', 'Macro', 'api/macros/nlohmann_json_namespace/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('NLOHMANN_JSON_NAMESPACE_BEGIN', 'Macro', 'api/macros/nlohmann_json_namespace_begin/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('NLOHMANN_JSON_NAMESPACE_END', 'Macro', 'api/macros/nlohmann_json_namespace_begin/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('NLOHMANN_JSON_SERIALIZE_ENUM', 'Macro', 'api/macros/nlohmann_json_serialize_enum/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('NLOHMANN_JSON_VERSION_MAJOR', 'Macro', 'api/macros/nlohmann_json_version_major/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('NLOHMANN_JSON_VERSION_MINOR', 'Macro', 'api/macros/nlohmann_json_version_major/index.html');
+INSERT INTO searchIndex(name, type, path) VALUES ('NLOHMANN_JSON_VERSION_PATCH', 'Macro', 'api/macros/nlohmann_json_version_major/index.html');
diff --git a/doc/docset/docset.json b/docs/docset/docset.json
similarity index 89%
rename from doc/docset/docset.json
rename to docs/docset/docset.json
index f8d4783..c252636 100644
--- a/doc/docset/docset.json
+++ b/docs/docset/docset.json
@@ -1,6 +1,6 @@
{
"name": "JSON for Modern C++",
- "version": "3.10.0",
+ "version": "3.11.0",
"archive": "JSON_for_Modern_C++.tgz",
"author": {
"name": "Niels Lohmann",
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
Binary files differ
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
Binary files differ
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_json_pointer.cpp b/docs/examples/at__json_pointer.cpp
similarity index 98%
rename from doc/examples/at_json_pointer.cpp
rename to docs/examples/at__json_pointer.cpp
index f554d85..26dfd8e 100644
--- a/doc/examples/at_json_pointer.cpp
+++ b/docs/examples/at__json_pointer.cpp
@@ -2,6 +2,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
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 97%
rename from doc/examples/at_json_pointer_const.cpp
rename to docs/examples/at__json_pointer_const.cpp
index 3ac232b..f049bd8 100644
--- a/doc/examples/at_json_pointer_const.cpp
+++ b/docs/examples/at__json_pointer_const.cpp
@@ -2,6 +2,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
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/docs/examples/at__keytype.c++17.cpp b/docs/examples/at__keytype.c++17.cpp
new file mode 100644
index 0000000..3491cb9
--- /dev/null
+++ b/docs/examples/at__keytype.c++17.cpp
@@ -0,0 +1,50 @@
+#include <iostream>
+#include <string_view>
+#include <nlohmann/json.hpp>
+
+using namespace std::string_view_literals;
+using json = nlohmann::json;
+
+int main()
+{
+ // create JSON object
+ json object =
+ {
+ {"the good", "il buono"},
+ {"the bad", "il cattivo"},
+ {"the ugly", "il brutto"}
+ };
+
+ // output element with key "the ugly" using string_view
+ std::cout << object.at("the ugly"sv) << '\n';
+
+ // change element with key "the bad" using string_view
+ object.at("the bad"sv) = "il cattivo";
+
+ // output changed array
+ std::cout << object << '\n';
+
+
+ // exception type_error.304
+ try
+ {
+ // use at() with string_view on a non-object type
+ json str = "I am a string";
+ str.at("the good"sv) = "Another string";
+ }
+ catch (json::type_error& e)
+ {
+ std::cout << e.what() << '\n';
+ }
+
+ // exception out_of_range.401
+ try
+ {
+ // try to write at a nonexisting key using string_view
+ object.at("the fast"sv) = "il rapido";
+ }
+ catch (json::out_of_range& e)
+ {
+ std::cout << e.what() << '\n';
+ }
+}
diff --git a/doc/examples/at__object_t_key_type.output b/docs/examples/at__keytype.c++17.output
similarity index 100%
copy from doc/examples/at__object_t_key_type.output
copy to docs/examples/at__keytype.c++17.output
diff --git a/docs/examples/at__keytype_const.c++17.cpp b/docs/examples/at__keytype_const.c++17.cpp
new file mode 100644
index 0000000..ec93c70
--- /dev/null
+++ b/docs/examples/at__keytype_const.c++17.cpp
@@ -0,0 +1,44 @@
+#include <iostream>
+#include <string_view>
+#include <nlohmann/json.hpp>
+
+using namespace std::string_view_literals;
+using json = nlohmann::json;
+
+int main()
+{
+ // create JSON object
+ const json object =
+ {
+ {"the good", "il buono"},
+ {"the bad", "il cattivo"},
+ {"the ugly", "il brutto"}
+ };
+
+ // output element with key "the ugly" using string_view
+ std::cout << object.at("the ugly"sv) << '\n';
+
+
+ // exception type_error.304
+ try
+ {
+ // use at() with string_view on a non-object type
+ const json str = "I am a string";
+ std::cout << str.at("the good"sv) << '\n';
+ }
+ catch (json::type_error& e)
+ {
+ std::cout << e.what() << '\n';
+ }
+
+ // exception out_of_range.401
+ try
+ {
+ // try to read from a nonexisting key using string_view
+ std::cout << object.at("the fast"sv) << '\n';
+ }
+ catch (json::out_of_range)
+ {
+ std::cout << "out of range" << '\n';
+ }
+}
diff --git a/doc/examples/at__object_t_key_type_const.output b/docs/examples/at__keytype_const.c++17.output
similarity index 100%
copy from doc/examples/at__object_t_key_type_const.output
copy to docs/examples/at__keytype_const.c++17.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/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 94%
rename from doc/examples/basic_json__CompatibleType.output
rename to docs/examples/basic_json__CompatibleType.output
index 2337e81..10c4ed3 100644
--- a/doc/examples/basic_json__CompatibleType.output
+++ b/docs/examples/basic_json__CompatibleType.output
@@ -2,7 +2,7 @@
{"one":1,"three":3,"two":2}
{"one":1.2,"three":3.4,"two":2.3}
{"one":true,"three":false,"two":true}
-{"one":true,"three":false,"two":true}
+{"one":true,"three":true,"two":true}
["one","two",3,4.5,false]
[1,2,3,4]
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_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/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 0000000..1c10be5
--- /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 0000000..67ac1b2
--- /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 0000000..f9ce684
--- /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 0000000..9d82129
--- /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 0000000..61c21ea
--- /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 0000000..f4aade2
--- /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 0000000..b2694c5
--- /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 0000000..648b3ef
--- /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 0000000..cd230ad
--- /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 0000000..4795527
--- /dev/null
+++ b/docs/examples/byte_container_with_subtype__subtype.output
@@ -0,0 +1,2 @@
+c1.subtype() = 18446744073709551615
+c2.subtype() = 42
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/docs/examples/cbor_tag_handler_t.cpp b/docs/examples/cbor_tag_handler_t.cpp
new file mode 100644
index 0000000..79052c7
--- /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 0000000..18920b1
--- /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/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_json_pointer.cpp b/docs/examples/contains__json_pointer.cpp
similarity index 96%
rename from doc/examples/contains_json_pointer.cpp
rename to docs/examples/contains__json_pointer.cpp
index 54bcaa9..f9de546 100644
--- a/doc/examples/contains_json_pointer.cpp
+++ b/docs/examples/contains__json_pointer.cpp
@@ -2,6 +2,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
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/contains.cpp b/docs/examples/contains__keytype.c++17.cpp
similarity index 73%
copy from doc/examples/contains.cpp
copy to docs/examples/contains__keytype.c++17.cpp
index df8201c..43b62fa 100644
--- a/doc/examples/contains.cpp
+++ b/docs/examples/contains__keytype.c++17.cpp
@@ -1,7 +1,10 @@
#include <iostream>
+#include <string_view>
#include <nlohmann/json.hpp>
+using namespace std::string_view_literals;
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
@@ -11,7 +14,7 @@
// call contains
std::cout << std::boolalpha <<
- "j_object contains 'key': " << j_object.contains("key") << '\n' <<
- "j_object contains 'another': " << j_object.contains("another") << '\n' <<
- "j_array contains 'key': " << j_array.contains("key") << std::endl;
+ "j_object contains 'key': " << j_object.contains("key"sv) << '\n' <<
+ "j_object contains 'another': " << j_object.contains("another"sv) << '\n' <<
+ "j_array contains 'key': " << j_array.contains("key"sv) << std::endl;
}
diff --git a/doc/examples/contains.output b/docs/examples/contains__keytype.c++17.output
similarity index 100%
rename from doc/examples/contains.output
rename to docs/examples/contains__keytype.c++17.output
diff --git a/doc/examples/contains.cpp b/docs/examples/contains__object_t_key_type.cpp
similarity index 92%
rename from doc/examples/contains.cpp
rename to docs/examples/contains__object_t_key_type.cpp
index df8201c..a8bc814 100644
--- a/doc/examples/contains.cpp
+++ b/docs/examples/contains__object_t_key_type.cpp
@@ -2,6 +2,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
diff --git a/doc/examples/contains.output b/docs/examples/contains__object_t_key_type.output
similarity index 100%
copy from doc/examples/contains.output
copy to docs/examples/contains__object_t_key_type.output
diff --git a/docs/examples/count__keytype.c++17.cpp b/docs/examples/count__keytype.c++17.cpp
new file mode 100644
index 0000000..ec6de06
--- /dev/null
+++ b/docs/examples/count__keytype.c++17.cpp
@@ -0,0 +1,20 @@
+#include <iostream>
+#include <string_view>
+#include <nlohmann/json.hpp>
+
+using namespace std::string_view_literals;
+using json = nlohmann::json;
+
+int main()
+{
+ // create a JSON object
+ json j_object = {{"one", 1}, {"two", 2}};
+
+ // call count()
+ auto count_two = j_object.count("two"sv);
+ auto count_three = j_object.count("three"sv);
+
+ // print values
+ std::cout << "number of elements with key \"two\": " << count_two << '\n';
+ std::cout << "number of elements with key \"three\": " << count_three << '\n';
+}
diff --git a/doc/examples/count.output b/docs/examples/count__keytype.c++17.output
similarity index 100%
rename from doc/examples/count.output
rename to docs/examples/count__keytype.c++17.output
diff --git a/doc/examples/count.cpp b/docs/examples/count__object_t_key_type.cpp
similarity index 100%
rename from doc/examples/count.cpp
rename to docs/examples/count__object_t_key_type.cpp
diff --git a/doc/examples/count.output b/docs/examples/count__object_t_key_type.output
similarity index 100%
copy from doc/examples/count.output
copy to docs/examples/count__object_t_key_type.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/docs/examples/default_object_comparator_t.cpp b/docs/examples/default_object_comparator_t.cpp
new file mode 100644
index 0000000..9f200fe
--- /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 0000000..b1daf3b
--- /dev/null
+++ b/docs/examples/default_object_comparator_t.output
@@ -0,0 +1,2 @@
+one < two : true
+three < four : false
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 94%
rename from doc/examples/diff.cpp
rename to docs/examples/diff.cpp
index 71b19be..ef01332 100644
--- a/doc/examples/diff.cpp
+++ b/docs/examples/diff.cpp
@@ -3,6 +3,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
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/docs/examples/erase__keytype.c++17.cpp b/docs/examples/erase__keytype.c++17.cpp
new file mode 100644
index 0000000..c5e4bed
--- /dev/null
+++ b/docs/examples/erase__keytype.c++17.cpp
@@ -0,0 +1,20 @@
+#include <iostream>
+#include <string_view>
+#include <nlohmann/json.hpp>
+
+using namespace std::string_view_literals;
+using json = nlohmann::json;
+
+int main()
+{
+ // create a JSON object
+ json j_object = {{"one", 1}, {"two", 2}};
+
+ // call erase()
+ auto count_one = j_object.erase("one"sv);
+ auto count_three = j_object.erase("three"sv);
+
+ // print values
+ std::cout << j_object << '\n';
+ std::cout << count_one << " " << count_three << '\n';
+}
diff --git a/doc/examples/erase__key_type.output b/docs/examples/erase__keytype.c++17.output
similarity index 100%
copy from doc/examples/erase__key_type.output
copy to docs/examples/erase__keytype.c++17.output
diff --git a/doc/examples/erase__key_type.cpp b/docs/examples/erase__object_t_key_type.cpp
similarity index 100%
rename from doc/examples/erase__key_type.cpp
rename to docs/examples/erase__object_t_key_type.cpp
diff --git a/doc/examples/erase__key_type.output b/docs/examples/erase__object_t_key_type.output
similarity index 100%
rename from doc/examples/erase__key_type.output
rename to docs/examples/erase__object_t_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/docs/examples/error_handler_t.cpp b/docs/examples/error_handler_t.cpp
new file mode 100644
index 0000000..add3f3b
--- /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 0000000..718d62b
--- /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/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/docs/examples/find__keytype.c++17.cpp b/docs/examples/find__keytype.c++17.cpp
new file mode 100644
index 0000000..da94cf0
--- /dev/null
+++ b/docs/examples/find__keytype.c++17.cpp
@@ -0,0 +1,22 @@
+#include <iostream>
+#include <string_view>
+#include <nlohmann/json.hpp>
+
+using namespace std::string_view_literals;
+using json = nlohmann::json;
+
+int main()
+{
+ // create a JSON object
+ json j_object = {{"one", 1}, {"two", 2}};
+
+ // call find
+ auto it_two = j_object.find("two"sv);
+ auto it_three = j_object.find("three"sv);
+
+ // print values
+ std::cout << std::boolalpha;
+ std::cout << "\"two\" was found: " << (it_two != j_object.end()) << '\n';
+ std::cout << "value at key \"two\": " << *it_two << '\n';
+ std::cout << "\"three\" was found: " << (it_three != j_object.end()) << '\n';
+}
diff --git a/doc/examples/find__key_type.output b/docs/examples/find__keytype.c++17.output
similarity index 100%
copy from doc/examples/find__key_type.output
copy to docs/examples/find__keytype.c++17.output
diff --git a/doc/examples/find__key_type.cpp b/docs/examples/find__object_t_key_type.cpp
similarity index 100%
rename from doc/examples/find__key_type.cpp
rename to docs/examples/find__object_t_key_type.cpp
diff --git a/doc/examples/find__key_type.output b/docs/examples/find__object_t_key_type.output
similarity index 100%
rename from doc/examples/find__key_type.output
rename to docs/examples/find__object_t_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/docs/examples/from_bjdata.cpp b/docs/examples/from_bjdata.cpp
new file mode 100644
index 0000000..961164c
--- /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/doc/examples/from_bson.output b/docs/examples/from_bjdata.output
similarity index 100%
copy from doc/examples/from_bson.output
copy to docs/examples/from_bjdata.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/docs/examples/get_allocator.cpp b/docs/examples/get_allocator.cpp
new file mode 100644
index 0000000..35079a1
--- /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 0000000..8effb3e
--- /dev/null
+++ b/docs/examples/get_allocator.output
@@ -0,0 +1 @@
+"Hello, world!"
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/docs/examples/json_lines.cpp b/docs/examples/json_lines.cpp
new file mode 100644
index 0000000..233c81a
--- /dev/null
+++ b/docs/examples/json_lines.cpp
@@ -0,0 +1,22 @@
+#include <sstream>
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+ // JSON Lines (see https://jsonlines.org)
+ std::stringstream input;
+ input << R"({"name": "Gilbert", "wins": [["straight", "7♣"], ["one pair", "10♥"]]}
+{"name": "Alexa", "wins": [["two pair", "4♠"], ["two pair", "9♠"]]}
+{"name": "May", "wins": []}
+{"name": "Deloise", "wins": [["three of a kind", "5♣"]]}
+)";
+
+ std::string line;
+ while (std::getline(input, line))
+ {
+ std::cout << json::parse(line) << std::endl;
+ }
+}
diff --git a/docs/examples/json_lines.output b/docs/examples/json_lines.output
new file mode 100644
index 0000000..1b41224
--- /dev/null
+++ b/docs/examples/json_lines.output
@@ -0,0 +1,4 @@
+{"name":"Gilbert","wins":[["straight","7♣"],["one pair","10♥"]]}
+{"name":"Alexa","wins":[["two pair","4♠"],["two pair","9♠"]]}
+{"name":"May","wins":[]}
+{"name":"Deloise","wins":[["three of a kind","5♣"]]}
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/docs/examples/json_pointer__back.cpp b/docs/examples/json_pointer__back.cpp
new file mode 100644
index 0000000..dd3b210
--- /dev/null
+++ b/docs/examples/json_pointer__back.cpp
@@ -0,0 +1,15 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+ // different JSON Pointers
+ json::json_pointer ptr1("/foo");
+ json::json_pointer ptr2("/foo/0");
+
+ // call empty()
+ std::cout << "last reference token of \"" << ptr1 << "\" is \"" << ptr1.back() << "\"\n"
+ << "last reference token of \"" << ptr2 << "\" is \"" << ptr2.back() << "\"" << std::endl;
+}
diff --git a/docs/examples/json_pointer__back.output b/docs/examples/json_pointer__back.output
new file mode 100644
index 0000000..a89357b
--- /dev/null
+++ b/docs/examples/json_pointer__back.output
@@ -0,0 +1,2 @@
+last reference token of "/foo" is "foo"
+last reference token of "/foo/0" is "0"
diff --git a/docs/examples/json_pointer__empty.cpp b/docs/examples/json_pointer__empty.cpp
new file mode 100644
index 0000000..57257e8
--- /dev/null
+++ b/docs/examples/json_pointer__empty.cpp
@@ -0,0 +1,20 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+ // different JSON Pointers
+ json::json_pointer ptr0;
+ json::json_pointer ptr1("");
+ json::json_pointer ptr2("/foo");
+ json::json_pointer ptr3("/foo/0");
+
+ // call empty()
+ std::cout << std::boolalpha
+ << "\"" << ptr0 << "\": " << ptr0.empty() << '\n'
+ << "\"" << ptr1 << "\": " << ptr1.empty() << '\n'
+ << "\"" << ptr2 << "\": " << ptr2.empty() << '\n'
+ << "\"" << ptr3 << "\": " << ptr3.empty() << std::endl;
+}
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 65%
rename from doc/examples/json_pointer__operator_add.cpp
rename to docs/examples/json_pointer__operator_add.cpp
index a2bbf59..14bd745 100644
--- a/doc/examples/json_pointer__operator_add.cpp
+++ b/docs/examples/json_pointer__operator_add.cpp
@@ -7,17 +7,17 @@
{
// create a JSON pointer
json::json_pointer ptr("/foo");
- std::cout << ptr << '\n';
+ std::cout << "\"" << ptr << "\"\n";
// append a JSON Pointer
ptr /= json::json_pointer("/bar/baz");
- std::cout << ptr << '\n';
+ std::cout << "\"" << ptr << "\"\n";
// append a string
ptr /= "fob";
- std::cout << ptr << '\n';
+ std::cout << "\"" << ptr << "\"\n";
// append an array index
ptr /= 42;
- std::cout << ptr << std::endl;
+ std::cout << "\"" << ptr << "\"" << std::endl;
}
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/docs/examples/json_pointer__operator_add_binary.cpp b/docs/examples/json_pointer__operator_add_binary.cpp
new file mode 100644
index 0000000..d26a0d1
--- /dev/null
+++ b/docs/examples/json_pointer__operator_add_binary.cpp
@@ -0,0 +1,19 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+ // create a JSON pointer
+ json::json_pointer ptr("/foo");
+
+ // append a JSON Pointer
+ std::cout << "\"" << ptr / json::json_pointer("/bar/baz") << "\"\n";
+
+ // append a string
+ std::cout << "\"" << ptr / "fob" << "\"\n";
+
+ // append an array index
+ std::cout << "\"" << ptr / 42 << "\"" << std::endl;
+}
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/docs/examples/json_pointer__operator_string_t.cpp b/docs/examples/json_pointer__operator_string_t.cpp
new file mode 100644
index 0000000..56f2130
--- /dev/null
+++ b/docs/examples/json_pointer__operator_string_t.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_t.output b/docs/examples/json_pointer__operator_string_t.output
new file mode 100644
index 0000000..ec6aba2
--- /dev/null
+++ b/docs/examples/json_pointer__operator_string_t.output
@@ -0,0 +1,2 @@
+/foo/0
+/a~1b
diff --git a/docs/examples/json_pointer__parent_pointer.cpp b/docs/examples/json_pointer__parent_pointer.cpp
new file mode 100644
index 0000000..ef9df45
--- /dev/null
+++ b/docs/examples/json_pointer__parent_pointer.cpp
@@ -0,0 +1,18 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+ // different JSON Pointers
+ json::json_pointer ptr1("");
+ json::json_pointer ptr2("/foo");
+ json::json_pointer ptr3("/foo/0");
+
+ // call parent_pointer()
+ std::cout << std::boolalpha
+ << "parent of \"" << ptr1 << "\" is \"" << ptr1.parent_pointer() << "\"\n"
+ << "parent of \"" << ptr2 << "\" is \"" << ptr2.parent_pointer() << "\"\n"
+ << "parent of \"" << ptr3 << "\" is \"" << ptr3.parent_pointer() << "\"" << std::endl;
+}
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 61%
rename from doc/examples/json_pointer__pop_back.cpp
rename to docs/examples/json_pointer__pop_back.cpp
index ed3417e..fd077b7 100644
--- a/doc/examples/json_pointer__pop_back.cpp
+++ b/docs/examples/json_pointer__pop_back.cpp
@@ -7,15 +7,15 @@
{
// create empty JSON Pointer
json::json_pointer ptr("/foo/bar/baz");
- std::cout << ptr << '\n';
+ std::cout << "\"" << ptr << "\"\n";
// call pop_back()
ptr.pop_back();
- std::cout << ptr << '\n';
+ std::cout << "\"" << ptr << "\"\n";
ptr.pop_back();
- std::cout << ptr << '\n';
+ std::cout << "\"" << ptr << "\"\n";
ptr.pop_back();
- std::cout << ptr << '\n';
+ std::cout << "\"" << ptr << "\"\n";
}
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 61%
rename from doc/examples/json_pointer__push_back.cpp
rename to docs/examples/json_pointer__push_back.cpp
index d6536b3..e6b59a1 100644
--- a/doc/examples/json_pointer__push_back.cpp
+++ b/docs/examples/json_pointer__push_back.cpp
@@ -7,15 +7,15 @@
{
// create empty JSON Pointer
json::json_pointer ptr;
- std::cout << ptr << '\n';
+ std::cout << "\"" << ptr << "\"\n";
// call push_back()
ptr.push_back("foo");
- std::cout << ptr << '\n';
+ std::cout << "\"" << ptr << "\"\n";
ptr.push_back("0");
- std::cout << ptr << '\n';
+ std::cout << "\"" << ptr << "\"\n";
ptr.push_back("bar");
- std::cout << ptr << '\n';
+ std::cout << "\"" << ptr << "\"\n";
}
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/docs/examples/json_pointer__string_t.cpp b/docs/examples/json_pointer__string_t.cpp
new file mode 100644
index 0000000..fbe0f17
--- /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 0000000..d871137
--- /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
new file mode 100644
index 0000000..31d35a7
--- /dev/null
+++ b/docs/examples/json_pointer__to_string.cpp
@@ -0,0 +1,34 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+ // different JSON Pointers
+ json::json_pointer ptr1("");
+ json::json_pointer ptr2("/foo");
+ json::json_pointer ptr3("/foo/0");
+ json::json_pointer ptr4("/");
+ json::json_pointer ptr5("/a~1b");
+ json::json_pointer ptr6("/c%d");
+ json::json_pointer ptr7("/e^f");
+ json::json_pointer ptr8("/g|h");
+ json::json_pointer ptr9("/i\\j");
+ json::json_pointer ptr10("/k\"l");
+ json::json_pointer ptr11("/ ");
+ json::json_pointer ptr12("/m~0n");
+
+ std::cout << "\"" << ptr1.to_string() << "\"\n"
+ << "\"" << ptr2.to_string() << "\"\n"
+ << "\"" << ptr3.to_string() << "\"\n"
+ << "\"" << ptr4.to_string() << "\"\n"
+ << "\"" << ptr5.to_string() << "\"\n"
+ << "\"" << ptr6.to_string() << "\"\n"
+ << "\"" << ptr7.to_string() << "\"\n"
+ << "\"" << ptr8.to_string() << "\"\n"
+ << "\"" << ptr9.to_string() << "\"\n"
+ << "\"" << ptr10.to_string() << "\"\n"
+ << "\"" << ptr11.to_string() << "\"\n"
+ << "\"" << ptr12.to_string() << "\"" << std::endl;
+}
diff --git a/docs/examples/json_pointer__to_string.output b/docs/examples/json_pointer__to_string.output
new file mode 100644
index 0000000..3c44135
--- /dev/null
+++ b/docs/examples/json_pointer__to_string.output
@@ -0,0 +1,12 @@
+""
+"/foo"
+"/foo/0"
+"/"
+"/a~1b"
+"/c%d"
+"/e^f"
+"/g|h"
+"/i\j"
+"/k"l"
+"/ "
+"/m~0n"
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/docs/examples/max_size.output b/docs/examples/max_size.output
new file mode 100644
index 0000000..b8dcb4d
--- /dev/null
+++ b/docs/examples/max_size.output
@@ -0,0 +1,7 @@
+0
+1
+1
+1
+115292150460684697
+576460752303423487
+1
diff --git a/doc/examples/merge_patch.cpp b/docs/examples/merge_patch.cpp
similarity index 96%
rename from doc/examples/merge_patch.cpp
rename to docs/examples/merge_patch.cpp
index b8804d7..f3fee1e 100644
--- a/doc/examples/merge_patch.cpp
+++ b/docs/examples/merge_patch.cpp
@@ -3,6 +3,7 @@
#include <iomanip> // for std::setw
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
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 63%
rename from doc/examples/meta.output
rename to docs/examples/meta.output
index c35a320..53cf266 100644
--- a/doc/examples/meta.output
+++ b/docs/examples/meta.output
@@ -1,8 +1,8 @@
{
"compiler": {
"c++": "201103",
- "family": "clang",
- "version": "13.0.0 (clang-1300.0.29.30)"
+ "family": "gcc",
+ "version": "11.3.0"
},
"copyright": "(C) 2013-2022 Niels Lohmann",
"name": "JSON for Modern C++",
@@ -10,8 +10,8 @@
"url": "https://github.com/nlohmann/json",
"version": {
"major": 3,
- "minor": 10,
- "patch": 5,
- "string": "3.10.5"
+ "minor": 11,
+ "patch": 0,
+ "string": "3.11.0"
}
}
diff --git a/docs/examples/nlohmann_define_type_intrusive_explicit.cpp b/docs/examples/nlohmann_define_type_intrusive_explicit.cpp
new file mode 100644
index 0000000..7d2ba8a
--- /dev/null
+++ b/docs/examples/nlohmann_define_type_intrusive_explicit.cpp
@@ -0,0 +1,60 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+using namespace nlohmann::literals;
+
+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/docs/examples/nlohmann_define_type_intrusive_explicit.output b/docs/examples/nlohmann_define_type_intrusive_explicit.output
new file mode 100644
index 0000000..37f4eb4
--- /dev/null
+++ b/docs/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/docs/examples/nlohmann_define_type_intrusive_macro.cpp b/docs/examples/nlohmann_define_type_intrusive_macro.cpp
new file mode 100644
index 0000000..2977cd4
--- /dev/null
+++ b/docs/examples/nlohmann_define_type_intrusive_macro.cpp
@@ -0,0 +1,48 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+using namespace nlohmann::literals;
+
+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/docs/examples/nlohmann_define_type_intrusive_macro.output b/docs/examples/nlohmann_define_type_intrusive_macro.output
new file mode 100644
index 0000000..37f4eb4
--- /dev/null
+++ b/docs/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/docs/examples/nlohmann_define_type_intrusive_with_default_explicit.cpp b/docs/examples/nlohmann_define_type_intrusive_with_default_explicit.cpp
new file mode 100644
index 0000000..7400c47
--- /dev/null
+++ b/docs/examples/nlohmann_define_type_intrusive_with_default_explicit.cpp
@@ -0,0 +1,55 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+using namespace nlohmann::literals;
+
+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/docs/examples/nlohmann_define_type_intrusive_with_default_explicit.output b/docs/examples/nlohmann_define_type_intrusive_with_default_explicit.output
new file mode 100644
index 0000000..1a255f6
--- /dev/null
+++ b/docs/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/docs/examples/nlohmann_define_type_intrusive_with_default_macro.cpp b/docs/examples/nlohmann_define_type_intrusive_with_default_macro.cpp
new file mode 100644
index 0000000..851a358
--- /dev/null
+++ b/docs/examples/nlohmann_define_type_intrusive_with_default_macro.cpp
@@ -0,0 +1,42 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+using namespace nlohmann::literals;
+
+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/docs/examples/nlohmann_define_type_intrusive_with_default_macro.output b/docs/examples/nlohmann_define_type_intrusive_with_default_macro.output
new file mode 100644
index 0000000..1a255f6
--- /dev/null
+++ b/docs/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/docs/examples/nlohmann_define_type_non_intrusive_explicit.cpp b/docs/examples/nlohmann_define_type_non_intrusive_explicit.cpp
new file mode 100644
index 0000000..b71613d
--- /dev/null
+++ b/docs/examples/nlohmann_define_type_non_intrusive_explicit.cpp
@@ -0,0 +1,53 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+using namespace nlohmann::literals;
+
+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/docs/examples/nlohmann_define_type_non_intrusive_explicit.output b/docs/examples/nlohmann_define_type_non_intrusive_explicit.output
new file mode 100644
index 0000000..37f4eb4
--- /dev/null
+++ b/docs/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/docs/examples/nlohmann_define_type_non_intrusive_macro.cpp b/docs/examples/nlohmann_define_type_non_intrusive_macro.cpp
new file mode 100644
index 0000000..be11a45
--- /dev/null
+++ b/docs/examples/nlohmann_define_type_non_intrusive_macro.cpp
@@ -0,0 +1,41 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+using namespace nlohmann::literals;
+
+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/docs/examples/nlohmann_define_type_non_intrusive_macro.output b/docs/examples/nlohmann_define_type_non_intrusive_macro.output
new file mode 100644
index 0000000..37f4eb4
--- /dev/null
+++ b/docs/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/docs/examples/nlohmann_define_type_non_intrusive_with_default_explicit.cpp b/docs/examples/nlohmann_define_type_non_intrusive_with_default_explicit.cpp
new file mode 100644
index 0000000..6b538d1
--- /dev/null
+++ b/docs/examples/nlohmann_define_type_non_intrusive_with_default_explicit.cpp
@@ -0,0 +1,53 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+using namespace nlohmann::literals;
+
+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/docs/examples/nlohmann_define_type_non_intrusive_with_default_explicit.output b/docs/examples/nlohmann_define_type_non_intrusive_with_default_explicit.output
new file mode 100644
index 0000000..1a255f6
--- /dev/null
+++ b/docs/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/docs/examples/nlohmann_define_type_non_intrusive_with_default_macro.cpp b/docs/examples/nlohmann_define_type_non_intrusive_with_default_macro.cpp
new file mode 100644
index 0000000..aa9bc53
--- /dev/null
+++ b/docs/examples/nlohmann_define_type_non_intrusive_with_default_macro.cpp
@@ -0,0 +1,40 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+using namespace nlohmann::literals;
+
+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/docs/examples/nlohmann_define_type_non_intrusive_with_default_macro.output b/docs/examples/nlohmann_define_type_non_intrusive_with_default_macro.output
new file mode 100644
index 0000000..1a255f6
--- /dev/null
+++ b/docs/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/docs/examples/nlohmann_json_serialize_enum.cpp b/docs/examples/nlohmann_json_serialize_enum.cpp
new file mode 100644
index 0000000..f9e472c
--- /dev/null
+++ b/docs/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/docs/examples/nlohmann_json_serialize_enum.output b/docs/examples/nlohmann_json_serialize_enum.output
new file mode 100644
index 0000000..f512563
--- /dev/null
+++ b/docs/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/docs/examples/nlohmann_json_serialize_enum_2.cpp b/docs/examples/nlohmann_json_serialize_enum_2.cpp
new file mode 100644
index 0000000..fd27226
--- /dev/null
+++ b/docs/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/docs/examples/nlohmann_json_serialize_enum_2.output b/docs/examples/nlohmann_json_serialize_enum_2.output
new file mode 100644
index 0000000..5dec31b
--- /dev/null
+++ b/docs/examples/nlohmann_json_serialize_enum_2.output
@@ -0,0 +1,3 @@
+0 -> "red"
+"rot" -> 0
+"red" -> 0
diff --git a/docs/examples/nlohmann_json_version.cpp b/docs/examples/nlohmann_json_version.cpp
new file mode 100644
index 0000000..ca5f537
--- /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 0000000..2809e3c
--- /dev/null
+++ b/docs/examples/nlohmann_json_version.output
@@ -0,0 +1 @@
+JSON for Modern C++ version 3.11.0
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/docs/examples/object_comparator_t.cpp b/docs/examples/object_comparator_t.cpp
new file mode 100644
index 0000000..6b82c7c
--- /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 0000000..63620ed
--- /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/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/docs/examples/operator__equal__specializations.cpp b/docs/examples/operator__equal__specializations.cpp
new file mode 100644
index 0000000..97d5ece
--- /dev/null
+++ b/docs/examples/operator__equal__specializations.cpp
@@ -0,0 +1,16 @@
+#include <iostream>
+#include <iomanip>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+ nlohmann::json uj1 = {{"version", 1}, {"type", "integer"}};
+ nlohmann::json uj2 = {{"type", "integer"}, {"version", 1}};
+
+ nlohmann::ordered_json oj1 = {{"version", 1}, {"type", "integer"}};
+ nlohmann::ordered_json oj2 = {{"type", "integer"}, {"version", 1}};
+
+ std::cout << std::boolalpha << (uj1 == uj2) << '\n' << (oj1 == oj2) << std::endl;
+}
diff --git a/docs/examples/operator__equal__specializations.output b/docs/examples/operator__equal__specializations.output
new file mode 100644
index 0000000..da29283
--- /dev/null
+++ b/docs/examples/operator__equal__specializations.output
@@ -0,0 +1,2 @@
+true
+false
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/operatorjson_pointer.cpp b/docs/examples/operator_array__json_pointer.cpp
similarity index 96%
rename from doc/examples/operatorjson_pointer.cpp
rename to docs/examples/operator_array__json_pointer.cpp
index 7a0353a..0fa207f 100644
--- a/doc/examples/operatorjson_pointer.cpp
+++ b/docs/examples/operator_array__json_pointer.cpp
@@ -2,6 +2,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
diff --git a/doc/examples/operatorjson_pointer.output b/docs/examples/operator_array__json_pointer.output
similarity index 100%
rename from doc/examples/operatorjson_pointer.output
rename to docs/examples/operator_array__json_pointer.output
diff --git a/doc/examples/operatorjson_pointer_const.cpp b/docs/examples/operator_array__json_pointer_const.cpp
similarity index 94%
rename from doc/examples/operatorjson_pointer_const.cpp
rename to docs/examples/operator_array__json_pointer_const.cpp
index a5a437b..f40e249 100644
--- a/doc/examples/operatorjson_pointer_const.cpp
+++ b/docs/examples/operator_array__json_pointer_const.cpp
@@ -2,6 +2,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
diff --git a/doc/examples/operatorjson_pointer_const.output b/docs/examples/operator_array__json_pointer_const.output
similarity index 100%
rename from doc/examples/operatorjson_pointer_const.output
rename to docs/examples/operator_array__json_pointer_const.output
diff --git a/docs/examples/operator_array__keytype.c++17.cpp b/docs/examples/operator_array__keytype.c++17.cpp
new file mode 100644
index 0000000..7f2b41d
--- /dev/null
+++ b/docs/examples/operator_array__keytype.c++17.cpp
@@ -0,0 +1,34 @@
+#include <iostream>
+#include <iomanip>
+#include <string_view>
+#include <nlohmann/json.hpp>
+
+using namespace std::string_view_literals;
+using json = nlohmann::json;
+
+int main()
+{
+ // create a JSON object
+ json object =
+ {
+ {"one", 1}, {"two", 2}, {"three", 2.9}
+ };
+
+ // output element with key "two"
+ std::cout << object["two"sv] << "\n\n";
+
+ // change element with key "three"
+ object["three"sv] = 3;
+
+ // output changed array
+ std::cout << std::setw(4) << object << "\n\n";
+
+ // mention nonexisting key
+ object["four"sv];
+
+ // write to nonexisting key
+ object["five"sv]["really"sv]["nested"sv] = true;
+
+ // output changed object
+ std::cout << std::setw(4) << object << '\n';
+}
diff --git a/doc/examples/operatorarray__key_type.output b/docs/examples/operator_array__keytype.c++17.output
similarity index 100%
copy from doc/examples/operatorarray__key_type.output
copy to docs/examples/operator_array__keytype.c++17.output
diff --git a/docs/examples/operator_array__keytype_const.c++17.cpp b/docs/examples/operator_array__keytype_const.c++17.cpp
new file mode 100644
index 0000000..2cf94f4
--- /dev/null
+++ b/docs/examples/operator_array__keytype_const.c++17.cpp
@@ -0,0 +1,18 @@
+#include <iostream>
+#include <string_view>
+#include <nlohmann/json.hpp>
+
+using namespace std::string_view_literals;
+using json = nlohmann::json;
+
+int main()
+{
+ // create a JSON object
+ const json object =
+ {
+ {"one", 1}, {"two", 2}, {"three", 2.9}
+ };
+
+ // output element with key "two"
+ std::cout << object["two"sv] << '\n';
+}
diff --git a/doc/examples/operatorarray__key_type_const.output b/docs/examples/operator_array__keytype_const.c++17.output
similarity index 100%
copy from doc/examples/operatorarray__key_type_const.output
copy to docs/examples/operator_array__keytype_const.c++17.output
diff --git a/doc/examples/operatorarray__key_type.cpp b/docs/examples/operator_array__object_t_key_type.cpp
similarity index 100%
rename from doc/examples/operatorarray__key_type.cpp
rename to docs/examples/operator_array__object_t_key_type.cpp
diff --git a/doc/examples/operatorarray__key_type.output b/docs/examples/operator_array__object_t_key_type.output
similarity index 100%
rename from doc/examples/operatorarray__key_type.output
rename to docs/examples/operator_array__object_t_key_type.output
diff --git a/doc/examples/operatorarray__key_type_const.cpp b/docs/examples/operator_array__object_t_key_type_const.cpp
similarity index 100%
rename from doc/examples/operatorarray__key_type_const.cpp
rename to docs/examples/operator_array__object_t_key_type_const.cpp
diff --git a/doc/examples/operatorarray__key_type_const.output b/docs/examples/operator_array__object_t_key_type_const.output
similarity index 100%
rename from doc/examples/operatorarray__key_type_const.output
rename to docs/examples/operator_array__object_t_key_type_const.output
diff --git a/doc/examples/operatorarray__size_type.cpp b/docs/examples/operator_array__size_type.cpp
similarity index 100%
rename from doc/examples/operatorarray__size_type.cpp
rename to docs/examples/operator_array__size_type.cpp
diff --git a/doc/examples/operatorarray__size_type.output b/docs/examples/operator_array__size_type.output
similarity index 100%
rename from doc/examples/operatorarray__size_type.output
rename to docs/examples/operator_array__size_type.output
diff --git a/doc/examples/operatorarray__size_type_const.cpp b/docs/examples/operator_array__size_type_const.cpp
similarity index 100%
rename from doc/examples/operatorarray__size_type_const.cpp
rename to docs/examples/operator_array__size_type_const.cpp
diff --git a/doc/examples/operatorarray__size_type_const.output b/docs/examples/operator_array__size_type_const.output
similarity index 100%
rename from doc/examples/operatorarray__size_type_const.output
rename to docs/examples/operator_array__size_type_const.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 85%
rename from doc/examples/operator_literal_json.cpp
rename to docs/examples/operator_literal_json.cpp
index 2ec008e..84ca629 100644
--- a/doc/examples/operator_literal_json.cpp
+++ b/docs/examples/operator_literal_json.cpp
@@ -3,6 +3,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
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 87%
rename from doc/examples/operator_literal_json_pointer.cpp
rename to docs/examples/operator_literal_json_pointer.cpp
index bbdb974..aba93e8 100644
--- a/doc/examples/operator_literal_json_pointer.cpp
+++ b/docs/examples/operator_literal_json_pointer.cpp
@@ -3,6 +3,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
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_ltlt__basic_json.cpp
similarity index 100%
rename from doc/examples/operator_serialize.cpp
rename to docs/examples/operator_ltlt__basic_json.cpp
diff --git a/doc/examples/operator_serialize.output b/docs/examples/operator_ltlt__basic_json.output
similarity index 100%
rename from doc/examples/operator_serialize.output
rename to docs/examples/operator_ltlt__basic_json.output
diff --git a/docs/examples/operator_ltlt__json_pointer.cpp b/docs/examples/operator_ltlt__json_pointer.cpp
new file mode 100644
index 0000000..f4fac88
--- /dev/null
+++ b/docs/examples/operator_ltlt__json_pointer.cpp
@@ -0,0 +1,13 @@
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+int main()
+{
+ // create JSON poiner
+ json::json_pointer ptr("/foo/bar/baz");
+
+ // write string representation to stream
+ std::cout << ptr << std::endl;
+}
diff --git a/docs/examples/operator_ltlt__json_pointer.output b/docs/examples/operator_ltlt__json_pointer.output
new file mode 100644
index 0000000..ed35943
--- /dev/null
+++ b/docs/examples/operator_ltlt__json_pointer.output
@@ -0,0 +1 @@
+/foo/bar/baz
diff --git a/docs/examples/operator_spaceship__const_reference.c++20.cpp b/docs/examples/operator_spaceship__const_reference.c++20.cpp
new file mode 100644
index 0000000..3c6c8b8
--- /dev/null
+++ b/docs/examples/operator_spaceship__const_reference.c++20.cpp
@@ -0,0 +1,41 @@
+#include <compare>
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+const char* to_string(const std::partial_ordering& po)
+{
+ if (std::is_lt(po))
+ {
+ return "less";
+ }
+ else if (std::is_gt(po))
+ {
+ return "greater";
+ }
+ else if (std::is_eq(po))
+ {
+ return "equivalent";
+ }
+ return "unordered";
+}
+
+int main()
+{
+ // create several JSON values
+ json array_1 = {1, 2, 3};
+ json array_2 = {1, 2, 4};
+ json object_1 = {{"A", "a"}, {"B", "b"}};
+ json object_2 = {{"B", "b"}, {"A", "a"}};
+ json number = 17;
+ json string = "foo";
+ json discarded = json(json::value_t::discarded);
+
+
+ // output values and comparisons
+ std::cout << array_1 << " <=> " << array_2 << " := " << to_string(array_1 <=> array_2) << '\n'; // *NOPAD*
+ std::cout << object_1 << " <=> " << object_2 << " := " << to_string(object_1 <=> object_2) << '\n'; // *NOPAD*
+ std::cout << string << " <=> " << number << " := " << to_string(string <=> number) << '\n'; // *NOPAD*
+ std::cout << string << " <=> " << discarded << " := " << to_string(string <=> discarded) << '\n'; // *NOPAD*
+}
diff --git a/docs/examples/operator_spaceship__const_reference.c++20.output b/docs/examples/operator_spaceship__const_reference.c++20.output
new file mode 100644
index 0000000..2e8bf9f
--- /dev/null
+++ b/docs/examples/operator_spaceship__const_reference.c++20.output
@@ -0,0 +1,4 @@
+[1,2,3] <=> [1,2,4] := less
+{"A":"a","B":"b"} <=> {"A":"a","B":"b"} := equivalent
+"foo" <=> 17 := greater
+"foo" <=> <discarded> := unordered
diff --git a/docs/examples/operator_spaceship__scalartype.c++20.cpp b/docs/examples/operator_spaceship__scalartype.c++20.cpp
new file mode 100644
index 0000000..d9dc3ca
--- /dev/null
+++ b/docs/examples/operator_spaceship__scalartype.c++20.cpp
@@ -0,0 +1,41 @@
+#include <compare>
+#include <iostream>
+#include <nlohmann/json.hpp>
+
+using json = nlohmann::json;
+
+const char* to_string(const std::partial_ordering& po)
+{
+ if (std::is_lt(po))
+ {
+ return "less";
+ }
+ else if (std::is_gt(po))
+ {
+ return "greater";
+ }
+ else if (std::is_eq(po))
+ {
+ return "equivalent";
+ }
+ return "unordered";
+}
+
+int main()
+{
+ using float_limits = std::numeric_limits<json::number_float_t>;
+ constexpr auto nan = float_limits::quiet_NaN();
+
+ // create several JSON values
+ json boolean = false;
+ json number = 17;
+ json string = "17";
+
+
+ // output values and comparisons
+ std::cout << std::boolalpha << std::fixed;
+ std::cout << boolean << " <=> " << true << " := " << to_string(boolean <=> true) << '\n'; // *NOPAD*
+ std::cout << number << " <=> " << 17.0 << " := " << to_string(number <=> 17.0) << '\n'; // *NOPAD*
+ std::cout << number << " <=> " << nan << " := " << to_string(number <=> nan) << '\n'; // *NOPAD*
+ std::cout << string << " <=> " << 17 << " := " << to_string(string <=> 17) << '\n'; // *NOPAD*
+}
diff --git a/docs/examples/operator_spaceship__scalartype.c++20.output b/docs/examples/operator_spaceship__scalartype.c++20.output
new file mode 100644
index 0000000..b2939a5
--- /dev/null
+++ b/docs/examples/operator_spaceship__scalartype.c++20.output
@@ -0,0 +1,4 @@
+false <=> true := less
+17 <=> 17.000000 := equivalent
+17 <=> nan := unordered
+"17" <=> 17 := greater
diff --git a/docs/examples/ordered_json.cpp b/docs/examples/ordered_json.cpp
new file mode 100644
index 0000000..effad53
--- /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 0000000..120cbb2
--- /dev/null
+++ b/docs/examples/ordered_json.output
@@ -0,0 +1,5 @@
+{
+ "one": 1,
+ "two": 2,
+ "three": 3
+}
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 94%
rename from doc/examples/other_error.cpp
rename to docs/examples/other_error.cpp
index 2e7ccfb..99c4be7 100644
--- a/doc/examples/other_error.cpp
+++ b/docs/examples/other_error.cpp
@@ -2,6 +2,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
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 94%
rename from doc/examples/patch.cpp
rename to docs/examples/patch.cpp
index b0896c7..b7ecb8e 100644
--- a/doc/examples/patch.cpp
+++ b/docs/examples/patch.cpp
@@ -3,6 +3,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
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/patch.cpp b/docs/examples/patch_inplace.cpp
similarity index 65%
copy from doc/examples/patch.cpp
copy to docs/examples/patch_inplace.cpp
index b0896c7..061708a 100644
--- a/doc/examples/patch.cpp
+++ b/docs/examples/patch_inplace.cpp
@@ -3,6 +3,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
@@ -23,10 +24,12 @@
]
)"_json;
- // apply the patch
- json patched_doc = doc.patch(patch);
+ // output original document
+ std::cout << "Before\n" << std::setw(4) << doc << std::endl;
- // output original and patched document
- std::cout << std::setw(4) << doc << "\n\n"
- << std::setw(4) << patched_doc << std::endl;
+ // apply the patch
+ doc.patch_inplace(patch);
+
+ // output patched document
+ std::cout << "\nAfter\n" << std::setw(4) << doc << std::endl;
}
diff --git a/docs/examples/patch_inplace.output b/docs/examples/patch_inplace.output
new file mode 100644
index 0000000..9d31b8b
--- /dev/null
+++ b/docs/examples/patch_inplace.output
@@ -0,0 +1,13 @@
+Before
+{
+ "baz": "qux",
+ "foo": "bar"
+}
+
+After
+{
+ "baz": "boo",
+ "hello": [
+ "world"
+ ]
+}
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 65%
rename from doc/examples/sax_parse.cpp
rename to docs/examples/sax_parse.cpp
index 45273eb..8602687 100644
--- a/doc/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 @@
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 @@
"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
new file mode 100644
index 0000000..dd2fc2f
--- /dev/null
+++ b/docs/examples/sax_parse.output
@@ -0,0 +1,37 @@
+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 0000000..08bc85d
--- /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 0000000..f880896
--- /dev/null
+++ b/docs/examples/sax_parse__binary.output
@@ -0,0 +1,3 @@
+binary(val=[...])
+
+result: true
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 95%
rename from doc/examples/std_hash.cpp
rename to docs/examples/std_hash.cpp
index eee0fad..9721910 100644
--- a/doc/examples/std_hash.cpp
+++ b/docs/examples/std_hash.cpp
@@ -3,6 +3,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
diff --git a/doc/examples/std_hash.output b/docs/examples/std_hash.output
similarity index 63%
rename from doc/examples/std_hash.output
rename to docs/examples/std_hash.output
index d1b1b48..521d2b4 100644
--- a/doc/examples/std_hash.output
+++ b/docs/examples/std_hash.output
@@ -2,7 +2,7 @@
hash(false) = 2654436030
hash(0) = 2654436095
hash(0U) = 2654436156
-hash("") = 11160318156688833227
+hash("") = 6142509191626859748
hash({}) = 2654435832
hash([]) = 2654435899
-hash({"hello": "world"}) = 3701319991624763853
+hash({"hello": "world"}) = 4469488738203676328
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_ubjson.cpp b/docs/examples/to_bjdata.cpp
similarity index 62%
copy from doc/examples/to_ubjson.cpp
copy to docs/examples/to_bjdata.cpp
index 2329cdd..9b7abac 100644
--- a/doc/examples/to_ubjson.cpp
+++ b/docs/examples/to_bjdata.cpp
@@ -3,8 +3,9 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
-// function to print UBJSON's diagnostic format
+// function to print BJData's diagnostic format
void print_byte(uint8_t byte)
{
if (32 < byte and byte < 128)
@@ -22,8 +23,8 @@
// create a JSON value
json j = R"({"compact": true, "schema": false})"_json;
- // serialize it to UBJSON
- std::vector<std::uint8_t> v = json::to_ubjson(j);
+ // serialize it to BJData
+ std::vector<std::uint8_t> v = json::to_bjdata(j);
// print the vector content
for (auto& byte : v)
@@ -35,12 +36,12 @@
// create an array of numbers
json array = {1, 2, 3, 4, 5, 6, 7, 8};
- // serialize it to UBJSON using default representation
- std::vector<std::uint8_t> v_array = json::to_ubjson(array);
- // serialize it to UBJSON using size optimization
- std::vector<std::uint8_t> v_array_size = json::to_ubjson(array, true);
- // serialize it to UBJSON using type optimization
- std::vector<std::uint8_t> v_array_size_and_type = json::to_ubjson(array, true, true);
+ // 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)
diff --git a/doc/examples/to_ubjson.output b/docs/examples/to_bjdata.output
similarity index 100%
copy from doc/examples/to_ubjson.output
copy to docs/examples/to_bjdata.output
diff --git a/doc/examples/to_bson.cpp b/docs/examples/to_bson.cpp
similarity index 92%
rename from doc/examples/to_bson.cpp
rename to docs/examples/to_bson.cpp
index 2dd4487..3484b0b 100644
--- a/doc/examples/to_bson.cpp
+++ b/docs/examples/to_bson.cpp
@@ -3,6 +3,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
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 92%
rename from doc/examples/to_cbor.cpp
rename to docs/examples/to_cbor.cpp
index 3d85deb..3d5e041 100644
--- a/doc/examples/to_cbor.cpp
+++ b/docs/examples/to_cbor.cpp
@@ -3,6 +3,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
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 92%
rename from doc/examples/to_msgpack.cpp
rename to docs/examples/to_msgpack.cpp
index 76bb22f..b29ae8c 100644
--- a/doc/examples/to_msgpack.cpp
+++ b/docs/examples/to_msgpack.cpp
@@ -3,6 +3,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
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 97%
rename from doc/examples/to_ubjson.cpp
rename to docs/examples/to_ubjson.cpp
index 2329cdd..fd267a8 100644
--- a/doc/examples/to_ubjson.cpp
+++ b/docs/examples/to_ubjson.cpp
@@ -3,6 +3,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
// function to print UBJSON's diagnostic format
void print_byte(uint8_t byte)
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 94%
rename from doc/examples/update.cpp
rename to docs/examples/update.cpp
index 8f8b3bf..ff94b67 100644
--- a/doc/examples/update.cpp
+++ b/docs/examples/update.cpp
@@ -3,6 +3,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
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 94%
rename from doc/examples/update__range.cpp
rename to docs/examples/update__range.cpp
index 98a3904..5b43850 100644
--- a/doc/examples/update__range.cpp
+++ b/docs/examples/update__range.cpp
@@ -3,6 +3,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
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/examples/basic_json__value_ptr.cpp b/docs/examples/value__json_ptr.cpp
similarity index 95%
rename from doc/examples/basic_json__value_ptr.cpp
rename to docs/examples/value__json_ptr.cpp
index f25b773..d866ef0 100644
--- a/doc/examples/basic_json__value_ptr.cpp
+++ b/docs/examples/value__json_ptr.cpp
@@ -2,6 +2,7 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
+using namespace nlohmann::literals;
int main()
{
diff --git a/doc/examples/basic_json__value_ptr.output b/docs/examples/value__json_ptr.output
similarity index 100%
rename from doc/examples/basic_json__value_ptr.output
rename to docs/examples/value__json_ptr.output
diff --git a/doc/examples/basic_json__value_ptr.cpp b/docs/examples/value__keytype.c++17.cpp
similarity index 68%
copy from doc/examples/basic_json__value_ptr.cpp
copy to docs/examples/value__keytype.c++17.cpp
index f25b773..1f6ff5c 100644
--- a/doc/examples/basic_json__value_ptr.cpp
+++ b/docs/examples/value__keytype.c++17.cpp
@@ -1,6 +1,8 @@
#include <iostream>
+#include <string_view>
#include <nlohmann/json.hpp>
+using namespace std::string_view_literals;
using json = nlohmann::json;
int main()
@@ -17,12 +19,12 @@
};
// access existing values
- int v_integer = j.value("/integer"_json_pointer, 0);
- double v_floating = j.value("/floating"_json_pointer, 47.11);
+ int v_integer = j.value("integer"sv, 0);
+ double v_floating = j.value("floating"sv, 47.11);
// access nonexisting values and rely on default value
- std::string v_string = j.value("/nonexisting"_json_pointer, "oops");
- bool v_boolean = j.value("/nonexisting"_json_pointer, false);
+ std::string v_string = j.value("nonexisting"sv, "oops");
+ bool v_boolean = j.value("nonexisting"sv, false);
// output values
std::cout << std::boolalpha << v_integer << " " << v_floating
diff --git a/doc/examples/basic_json__value.output b/docs/examples/value__keytype.c++17.output
similarity index 100%
rename from doc/examples/basic_json__value.output
rename to docs/examples/value__keytype.c++17.output
diff --git a/doc/examples/basic_json__value.cpp b/docs/examples/value__object_t_key_type.cpp
similarity index 100%
rename from doc/examples/basic_json__value.cpp
rename to docs/examples/value__object_t_key_type.cpp
diff --git a/doc/examples/basic_json__value.output b/docs/examples/value__object_t_key_type.output
similarity index 100%
copy from doc/examples/basic_json__value.output
copy to docs/examples/value__object_t_key_type.output
diff --git a/doc/json.gif b/docs/json.gif
similarity index 93%
rename from doc/json.gif
rename to docs/json.gif
index 9f0d8a2..b34600b 100644
--- a/doc/json.gif
+++ b/docs/json.gif
Binary files differ
diff --git a/docs/mkdocs/Makefile b/docs/mkdocs/Makefile
new file mode 100644
index 0000000..3f894d0
--- /dev/null
+++ b/docs/mkdocs/Makefile
@@ -0,0 +1,36 @@
+# serve the site locally
+serve: prepare_files style_check
+ venv/bin/mkdocs serve
+
+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 (images, examples)
+prepare_files: clean
+ mkdir 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:
+ rm -fr docs/images/json.gif docs/examples
+
+# publish site to GitHub pages
+publish: prepare_files
+ venv/bin/mkdocs gh-deploy --clean --force
+
+# install a Python virtual environment
+install_venv: requirements.txt
+ python3 -mvenv venv
+ venv/bin/pip install wheel
+ venv/bin/pip install -r requirements.txt
+
+# uninstall the virtual environment
+uninstall_venv: clean
+ rm -fr venv
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 84%
rename from doc/mkdocs/docs/api/basic_json/accept.md
rename to docs/mkdocs/docs/api/basic_json/accept.md
index 8794c58..1c806e8 100644
--- a/doc/mkdocs/docs/api/basic_json/accept.md
+++ b/docs/mkdocs/docs/api/basic_json/accept.md
@@ -29,13 +29,17 @@
: A compatible input, for instance:
- an `std::istream` object
- - a `FILE` pointer
+ - a `FILE` pointer (must not be null)
- a C-style array of characters
- a pointer to a null-terminated string of single byte characters
+ - a `std::string`
- an object `obj` for which `begin(obj)` and `end(obj)` produces a valid pair of iterators.
`IteratorType`
-: a compatible iterator type
+: a compatible iterator type, for instance.
+
+ - a pair of `std::string::iterator` or `std::vector<std::uint8_t>::iterator`
+ - a pair of pointers such as `ptr` and `ptr + len`
## Parameters
@@ -68,6 +72,11 @@
(1) A UTF-8 byte order mark is silently ignored.
+!!! danger "Runtime assertion"
+
+ The precondition that a passed `#!cpp FILE` pointer must not be null is enforced with a
+ [runtime assertion](../../features/assertions.md).
+
## Examples
??? example
@@ -87,7 +96,7 @@
## See also
- [parse](parse.md) - deserialize from a compatible input
-- [operator>>](operator_gtgt.md) - deserialize from stream
+- [operator>>](../operator_gtgt.md) - deserialize from stream
## Version history
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 67%
rename from doc/mkdocs/docs/api/basic_json/at.md
rename to docs/mkdocs/docs/api/basic_json/at.md
index 1ad6613..5e95045 100644
--- a/doc/mkdocs/docs/api/basic_json/at.md
+++ b/docs/mkdocs/docs/api/basic_json/at.md
@@ -10,13 +10,28 @@
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
@@ -24,16 +39,17 @@
: index of the element to access
`key` (in)
-: object key of the elements to remove
-
+: 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 @@
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 @@
## 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
@@ -119,11 +137,11 @@
--8<-- "examples/at__object_t_key_type.output"
```
-??? example "Example (2) access specified object element with bounds checking"
+??? example "Example: (2) access specified object element with bounds checking"
The example below shows how object elements can be read using `at()`. It also demonstrates the different exceptions
that can be thrown.
-
+
```cpp
--8<-- "examples/at__object_t_key_type_const.cpp"
```
@@ -134,38 +152,69 @@
--8<-- "examples/at__object_t_key_type_const.output"
```
-??? example "Example (3) access specified element via JSON Pointer"
+??? example "Example: (3) access specified object element using string_view with bounds checking"
+
+ The example below shows how object elements can be read and written using `at()`. It also demonstrates the different
+ exceptions that can be thrown.
+
+ ```cpp
+ --8<-- "examples/at__keytype.c++17.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/at__keytype.c++17.output"
+ ```
+
+??? example "Example: (3) access specified object element using string_view with bounds checking"
+
+ The example below shows how object elements can be read using `at()`. It also demonstrates the different exceptions
+ that can be thrown.
+
+ ```cpp
+ --8<-- "examples/at__keytype_const.c++17.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/at__keytype_const.c++17.output"
+ ```
+
+??? 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.
```cpp
- --8<-- "examples/at_json_pointer.cpp"
+ --8<-- "examples/at__json_pointer.cpp"
```
Output:
```json
- --8<-- "examples/at_json_pointer.output"
+ --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.
```cpp
- --8<-- "examples/at_json_pointer_const.cpp"
+ --8<-- "examples/at__json_pointer_const.cpp"
```
Output:
```json
- --8<-- "examples/at_json_pointer_const.output"
+ --8<-- "examples/at__json_pointer_const.output"
```
## 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
@@ -173,4 +222,5 @@
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/back.md b/docs/mkdocs/docs/api/basic_json/back.md
similarity index 89%
rename from doc/mkdocs/docs/api/basic_json/back.md
rename to docs/mkdocs/docs/api/basic_json/back.md
index 96e1dec..1a71528 100644
--- a/doc/mkdocs/docs/api/basic_json/back.md
+++ b/docs/mkdocs/docs/api/basic_json/back.md
@@ -35,9 +35,9 @@
## 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/docs/mkdocs/docs/api/basic_json/basic_json.md
similarity index 96%
rename from doc/mkdocs/docs/api/basic_json/basic_json.md
rename to docs/mkdocs/docs/api/basic_json/basic_json.md
index ab3fea4..e2e7361 100644
--- a/doc/mkdocs/docs/api/basic_json/basic_json.md
+++ b/docs/mkdocs/docs/api/basic_json/basic_json.md
@@ -201,16 +201,16 @@
## 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 @@
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
@@ -241,7 +241,7 @@
- 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.
@@ -250,17 +250,15 @@
!!! 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:
@@ -319,6 +317,8 @@
--8<-- "examples/basic_json__CompatibleType.output"
```
+ Note the output is platform-dependent.
+
??? example "Example: (5) create a container (array or object) from an initializer list"
The example below shows how JSON values are created from initializer lists.
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/docs/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md b/docs/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md
new file mode 100644
index 0000000..e19c3ed
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/cbor_tag_handler_t.md
@@ -0,0 +1,42 @@
+# <small>nlohmann::basic_json::</small>cbor_tag_handler_t
+
+```cpp
+enum class cbor_tag_handler_t
+{
+ error,
+ ignore,
+ store
+};
+```
+
+This enumeration is used in the [`from_cbor`](from_cbor.md) function to choose how to treat tags:
+
+error
+: throw a `parse_error` exception in case of a tag
+
+ignore
+: ignore tags
+
+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/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/docs/mkdocs/docs/api/basic_json/contains.md b/docs/mkdocs/docs/api/basic_json/contains.md
new file mode 100644
index 0000000..ba2c3df
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/contains.md
@@ -0,0 +1,118 @@
+# <small>nlohmann::basic_json::</small>contains
+
+```cpp
+// (1)
+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 a key equivalent to `key`. If the element is not found or the
+ JSON value is not an object, `#!cpp false` 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.
+3. Check whether the given JSON pointer `ptr` can be resolved in the current JSON value.
+
+## 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
+
+`key` (in)
+: key value to check its existence.
+
+`ptr` (in)
+: JSON pointer to check its existence.
+
+## Return value
+
+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. See 1.
+3. `#!cpp true` if the JSON pointer can be resolved to a stored value, `#!cpp false` otherwise.
+
+## Exception safety
+
+Strong exception safety: if an exception occurs, the original value stays intact.
+
+## Exceptions
+
+1. The function does not throw 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
+ number.
+
+## Complexity
+
+Logarithmic in the size of the JSON object.
+
+## Notes
+
+- 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"
+
+ If `#!cpp j.contains(x)` returns `#!c true` for a key or JSON pointer `x`, then it is safe to call `j[x]`.
+
+## Examples
+
+??? example "Example: (1) check with key"
+
+ The example shows how `contains()` is used.
+
+ ```cpp
+ --8<-- "examples/contains__object_t_key_type.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/contains__object_t_key_type.output"
+ ```
+
+??? example "Example: (2) check with key using string_view"
+
+ The example shows how `contains()` is used.
+
+ ```cpp
+ --8<-- "examples/contains__keytype.c++17.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/contains__keytype.c++17.output"
+ ```
+
+??? example "Example: (3) check with JSON pointer"
+
+ The example shows how `contains()` is used.
+
+ ```cpp
+ --8<-- "examples/contains__json_pointer.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/contains__json_pointer.output"
+ ```
+
+## Version history
+
+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/docs/mkdocs/docs/api/basic_json/count.md b/docs/mkdocs/docs/api/basic_json/count.md
new file mode 100644
index 0000000..4f3a310
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/count.md
@@ -0,0 +1,78 @@
+# <small>nlohmann::basic_json::</small>count
+
+```cpp
+// (1)
+size_type count(const typename object_t::key_type& key) const;
+
+// (2)
+template<typename KeyType>
+size_type count(KeyType&& key) const;
+```
+
+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
+
+`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
+
+`key` (in)
+: key value of the element to count.
+
+## Return value
+
+Number of elements with key `key`. If the JSON value is not an object, the return value will be `0`.
+
+## Exception safety
+
+Strong exception safety: if an exception occurs, the original value stays intact.
+
+## Complexity
+
+Logarithmic in the size of the JSON object.
+
+## Notes
+
+This method always returns `0` when executed on a JSON type that is not an object.
+
+## Examples
+
+??? example "Example: (1) count number of elements"
+
+ The example shows how `count()` is used.
+
+ ```cpp
+ --8<-- "examples/count__object_t_key_type.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/count__object_t_key_type.output"
+ ```
+
+??? example "Example: (2) count number of elements using string_view"
+
+ The example shows how `count()` is used.
+
+ ```cpp
+ --8<-- "examples/count__keytype.c++17.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/count__keytype.c++17.output"
+ ```
+
+## Version history
+
+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/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/docs/mkdocs/docs/api/basic_json/default_object_comparator_t.md b/docs/mkdocs/docs/api/basic_json/default_object_comparator_t.md
new file mode 100644
index 0000000..8a237f6
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/default_object_comparator_t.md
@@ -0,0 +1,35 @@
+# <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).
+
+## 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/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 79%
rename from doc/mkdocs/docs/api/basic_json/erase.md
rename to docs/mkdocs/docs/api/basic_json/erase.md
index d94c25b..1187995 100644
--- a/doc/mkdocs/docs/api/basic_json/erase.md
+++ b/docs/mkdocs/docs/api/basic_json/erase.md
@@ -13,6 +13,10 @@
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 @@
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 @@
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 @@
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 @@
- 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
@@ -147,16 +165,30 @@
The example shows the effect of `erase()` for different JSON types using an object key.
```cpp
- --8<-- "examples/erase__key_type.cpp"
+ --8<-- "examples/erase__object_t_key_type.cpp"
```
Output:
```json
- --8<-- "examples/erase__key_type.output"
+ --8<-- "examples/erase__object_t_key_type.output"
```
-??? example "Example: (4) remove element from a JSON array given an index"
+??? example "Example: (4) remove element from a JSON object given a key using string_view"
+
+ The example shows the effect of `erase()` for different JSON types using an object key.
+
+ ```cpp
+ --8<-- "examples/erase__keytype.c++17.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/erase__keytype.c++17.output"
+ ```
+
+??? 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 +204,8 @@
## 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/error_handler_t.md b/docs/mkdocs/docs/api/basic_json/error_handler_t.md
similarity index 62%
rename from doc/mkdocs/docs/api/basic_json/error_handler_t.md
rename to docs/mkdocs/docs/api/basic_json/error_handler_t.md
index afd20f8..dc32ced 100644
--- a/doc/mkdocs/docs/api/basic_json/error_handler_t.md
+++ b/docs/mkdocs/docs/api/basic_json/error_handler_t.md
@@ -20,6 +20,23 @@
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/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/docs/mkdocs/docs/api/basic_json/find.md b/docs/mkdocs/docs/api/basic_json/find.md
new file mode 100644
index 0000000..c643507
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/find.md
@@ -0,0 +1,86 @@
+# <small>nlohmann::basic_json::</small>find
+
+```cpp
+// (1)
+iterator find(const typename object_t::key_type& key);
+const_iterator find(const typename object_t::key_type& key) const;
+
+// (2)
+template<typename KeyType>
+iterator find(KeyType&& key);
+template<typename KeyType>
+const_iterator find(KeyType&& key) const;
+```
+
+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
+
+`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
+
+`key` (in)
+: key value of the element to search for.
+
+## Return value
+
+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
+
+Strong exception safety: if an exception occurs, the original value stays intact.
+
+## Complexity
+
+Logarithmic in the size of the JSON object.
+
+## Notes
+
+This method always returns `end()` when executed on a JSON type that is not an object.
+
+## Examples
+
+??? example "Example: (1) find object element by key"
+
+ The example shows how `find()` is used.
+
+ ```cpp
+ --8<-- "examples/find__object_t_key_type.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/find__object_t_key_type.output"
+ ```
+
+??? example "Example: (2) find object element by key using string_view"
+
+ The example shows how `find()` is used.
+
+ ```cpp
+ --8<-- "examples/find__keytype.c++17.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/find__keytype.c++17.output"
+ ```
+
+## See also
+
+- [contains](contains.md) checks whether a key exists
+
+## Version history
+
+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/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/docs/mkdocs/docs/api/basic_json/from_bjdata.md b/docs/mkdocs/docs/api/basic_json/from_bjdata.md
new file mode 100644
index 0000000..3c5eeb3
--- /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/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 89%
rename from doc/mkdocs/docs/api/basic_json/front.md
rename to docs/mkdocs/docs/api/basic_json/front.md
index 909f0b5..e258c36 100644
--- a/doc/mkdocs/docs/api/basic_json/front.md
+++ b/docs/mkdocs/docs/api/basic_json/front.md
@@ -28,9 +28,9 @@
## 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/docs/mkdocs/docs/api/basic_json/get.md
similarity index 99%
rename from doc/mkdocs/docs/api/basic_json/get.md
rename to docs/mkdocs/docs/api/basic_json/get.md
index 0a0bc3b..96fc221 100644
--- a/doc/mkdocs/docs/api/basic_json/get.md
+++ b/docs/mkdocs/docs/api/basic_json/get.md
@@ -90,7 +90,7 @@
## Notes
-!!! warning
+!!! danger "Undefined behavior"
Writing data to the pointee (overload 3) of the result yields an undefined state.
diff --git a/docs/mkdocs/docs/api/basic_json/get_allocator.md b/docs/mkdocs/docs/api/basic_json/get_allocator.md
new file mode 100644
index 0000000..07a4d84
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/get_allocator.md
@@ -0,0 +1,31 @@
+# <small>nlohmann::basic_json::</small>get_allocator
+
+```cpp
+static allocator_type get_allocator();
+```
+
+Returns the allocator associated with the container.
+
+## Return value
+
+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
+
+- Added in version 1.0.0.
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 97%
rename from doc/mkdocs/docs/api/basic_json/get_ptr.md
rename to docs/mkdocs/docs/api/basic_json/get_ptr.md
index 72517cd..2441e11 100644
--- a/doc/mkdocs/docs/api/basic_json/get_ptr.md
+++ b/docs/mkdocs/docs/api/basic_json/get_ptr.md
@@ -33,7 +33,7 @@
## 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/docs/mkdocs/docs/api/basic_json/get_ref.md
similarity index 95%
rename from doc/mkdocs/docs/api/basic_json/get_ref.md
rename to docs/mkdocs/docs/api/basic_json/get_ref.md
index 1140836..b121974 100644
--- a/doc/mkdocs/docs/api/basic_json/get_ref.md
+++ b/docs/mkdocs/docs/api/basic_json/get_ref.md
@@ -16,7 +16,7 @@
: 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 @@
## 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/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 95%
rename from doc/mkdocs/docs/api/basic_json/index.md
rename to docs/mkdocs/docs/api/basic_json/index.md
index eb90ac6..e474b66 100644
--- a/doc/mkdocs/docs/api/basic_json/index.md
+++ b/docs/mkdocs/docs/api/basic_json/index.md
@@ -54,7 +54,7 @@
from an rvalue argument.
- [CopyConstructible](https://en.cppreference.com/w/cpp/named_req/CopyConstructible): A JSON value can be
copy-constructed from an lvalue expression.
-- [MoveAssignable](https://en.cppreference.com/w/cpp/named_req/MoveAssignable): A JSON value van be assigned from an
+- [MoveAssignable](https://en.cppreference.com/w/cpp/named_req/MoveAssignable): A JSON value can be assigned from an
rvalue argument.
- [CopyAssignable](https://en.cppreference.com/w/cpp/named_req/CopyAssignable): A JSON value can be copy-assigned from
an lvalue expression.
@@ -128,6 +128,7 @@
- [**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)
@@ -232,9 +233,10 @@
- [**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
@@ -254,6 +256,7 @@
### JSON Patch functions
- [**patch**](patch.md) - applies a JSON patch
+- [**patch_inplace**](patch_inplace.md) - applies a JSON patch in place
- [**diff**](diff.md) (_static_) - creates a diff as a JSON patch
### JSON Merge Patch functions
@@ -267,10 +270,12 @@
### 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
@@ -278,21 +283,20 @@
## Non-member functions
-- [**operator<<(std::ostream&)**](operator_ltlt.md) - serialize to stream
-- [**operator>>(std::istream&)**](operator_gtgt.md) - deserialize from stream
+- [**operator<<(std::ostream&)**](../operator_ltlt.md) - serialize to stream
+- [**operator>>(std::istream&)**](../operator_gtgt.md) - deserialize from stream
- [**to_string**](to_string.md) - user-defined `to_string` function for JSON values
## Literals
-- [**operator""_json**](operator_literal_json.md) - user-defined string literal for JSON values
-- [**operator""_json_pointer**](operator_literal_json_pointer.md) - user-defined string literal for JSON pointers
+- [**operator""_json**](../operator_literal_json.md) - user-defined string literal for JSON values
## Helper classes
- [**std::hash<basic_json>**](std_hash.md) - return a hash value for a JSON object
- [**std::swap<basic_json>**](std_swap.md) - exchanges the values of two JSON objects
-## Example
+## Examples
??? example
diff --git a/docs/mkdocs/docs/api/basic_json/input_format_t.md b/docs/mkdocs/docs/api/basic_json/input_format_t.md
new file mode 100644
index 0000000..a3baaba
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/input_format_t.md
@@ -0,0 +1,52 @@
+# <small>nlohmann::basic_json::</small>input_format_t
+
+```cpp
+enum class input_format_t {
+ json,
+ cbor,
+ msgpack,
+ ubjson,
+ bson,
+ bjdata
+};
+```
+
+This enumeration is used in the [`sax_parse`](sax_parse.md) function to choose the input format to parse:
+
+json
+: JSON (JavaScript Object Notation)
+
+cbor
+: CBOR (Concise Binary Object Representation)
+
+msgpack
+: MessagePack
+
+ubjson
+: UBJSON (Universal Binary JSON)
+
+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/doc/mkdocs/docs/api/basic_json/insert.md b/docs/mkdocs/docs/api/basic_json/insert.md
similarity index 99%
rename from doc/mkdocs/docs/api/basic_json/insert.md
rename to docs/mkdocs/docs/api/basic_json/insert.md
index fdd8fe6..2e6b293 100644
--- a/doc/mkdocs/docs/api/basic_json/insert.md
+++ b/docs/mkdocs/docs/api/basic_json/insert.md
@@ -50,7 +50,7 @@
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/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 92%
rename from doc/mkdocs/docs/api/basic_json/is_discarded.md
rename to docs/mkdocs/docs/api/basic_json/is_discarded.md
index 405ae6c..663cbf8 100644
--- a/doc/mkdocs/docs/api/basic_json/is_discarded.md
+++ b/docs/mkdocs/docs/api/basic_json/is_discarded.md
@@ -24,7 +24,7 @@
## 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,10 +41,10 @@
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 discared,
+ then it is removed when it is part of a structured value. For instance, if the second value of an array is discarded,
instead of `#!json [null, discarded, false]`, the array `#!json [null, false]` is returned. Only if the top-level
value is discarded, the return value of the `parse` call is discarded.
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 98%
rename from doc/mkdocs/docs/api/basic_json/items.md
rename to docs/mkdocs/docs/api/basic_json/items.md
index b388824..0b34ddc 100644
--- a/doc/mkdocs/docs/api/basic_json/items.md
+++ b/docs/mkdocs/docs/api/basic_json/items.md
@@ -63,7 +63,7 @@
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/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 96%
rename from doc/mkdocs/docs/api/basic_json/max_size.md
rename to docs/mkdocs/docs/api/basic_json/max_size.md
index 31339db..4c0c575 100644
--- a/doc/mkdocs/docs/api/basic_json/max_size.md
+++ b/docs/mkdocs/docs/api/basic_json/max_size.md
@@ -40,7 +40,7 @@
??? example
- The following code calls `max_size()` on the different value types. Note the output is implementation specific.
+ The following code calls `max_size()` on the different value types.
```cpp
--8<-- "examples/max_size.cpp"
@@ -52,6 +52,8 @@
--8<-- "examples/max_size.output"
```
+ Note the output is platform-dependent.
+
## Version history
- Added in version 1.0.0.
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 90%
rename from doc/mkdocs/docs/api/basic_json/meta.md
rename to docs/mkdocs/docs/api/basic_json/meta.md
index e2b312e..c584f9b 100644
--- a/doc/mkdocs/docs/api/basic_json/meta.md
+++ b/docs/mkdocs/docs/api/basic_json/meta.md
@@ -32,8 +32,7 @@
??? example
- The following code shows an example output of the `meta()`
- function.
+ The following code shows an example output of the `meta()` function.
```cpp
--8<-- "examples/meta.cpp"
@@ -45,6 +44,13 @@
--8<-- "examples/meta.output"
```
+ Note the output is platform-dependent.
+
+## 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/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/docs/mkdocs/docs/api/basic_json/object_comparator_t.md b/docs/mkdocs/docs/api/basic_json/object_comparator_t.md
new file mode 100644
index 0000000..496a562
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/object_comparator_t.md
@@ -0,0 +1,31 @@
+# <small>nlohmann::basic_json::</small>object_comparator_t
+
+```cpp
+using object_comparator_t = typename object_t::key_compare;
+// or
+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.
+- 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/docs/mkdocs/docs/api/basic_json/object_t.md
similarity index 96%
rename from doc/mkdocs/docs/api/basic_json/object_t.md
rename to docs/mkdocs/docs/api/basic_json/object_t.md
index d4bea15..67b3bb7 100644
--- a/doc/mkdocs/docs/api/basic_json/object_t.md
+++ b/docs/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 @@
>
```
-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/docs/mkdocs/docs/api/basic_json/operator+=.md
similarity index 85%
rename from doc/mkdocs/docs/api/basic_json/operator+=.md
rename to docs/mkdocs/docs/api/basic_json/operator+=.md
index 074b300..dc5f2ec 100644
--- a/doc/mkdocs/docs/api/basic_json/operator+=.md
+++ b/docs/mkdocs/docs/api/basic_json/operator+=.md
@@ -41,12 +41,9 @@
## 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/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/docs/mkdocs/docs/api/basic_json/operator\133\135.md" "b/docs/mkdocs/docs/api/basic_json/operator\133\135.md"
new file mode 100644
index 0000000..ebc737e
--- /dev/null
+++ "b/docs/mkdocs/docs/api/basic_json/operator\133\135.md"
@@ -0,0 +1,239 @@
+# <small>nlohmann::basic_json::</small>operator[]
+
+```cpp
+// (1)
+reference operator[](size_type idx);
+const_reference operator[](size_type idx) const;
+
+// (2)
+reference operator[](typename object_t::key_type key);
+const_reference operator[](const typename object_t::key_type& 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 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
+
+`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
+
+`idx` (in)
+: index of the element to access
+
+`key` (in)
+: object key of the element to access
+
+`ptr` (in)
+: JSON pointer to the desired element
+
+## Return value
+
+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
+
+Strong exception safety: if an exception occurs, the original value stays intact.
+
+## Exceptions
+
+1. The function can throw the following exceptions:
+ - Throws [`type_error.305`](../../home/exceptions.md#jsonexceptiontype_error305) if the JSON value is not an array
+ or null; in that case, using the `[]` operator with an index makes no sense.
+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. 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
+ JSON pointer `ptr` is not a number.
+ - Throws [`out_of_range.402`](../../home/exceptions.md#jsonexceptionout_of_range402) if the array index '-' is used
+ in the passed JSON pointer `ptr` for the const version.
+ - Throws [`out_of_range.404`](../../home/exceptions.md#jsonexceptionout_of_range404) if the JSON pointer `ptr` can
+ not be resolved.
+
+## Complexity
+
+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. Logarithmic in the size of the container.
+4. Logarithmic in the size of the container.
+
+## Notes
+
+!!! 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 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
+ case the value was `#!json null` before, it is converted to an array.
+
+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. See 2.
+
+4. `null` values are created in arrays and objects if necessary.
+
+ In particular:
+
+ - If the JSON pointer points to an object key that does not exist, it is created and filled with a `#!json null`
+ value before a reference to it is returned.
+ - If the JSON pointer points to an array index that does not exist, it is created and filled with a `#!json null`
+ value before a reference to it is returned. All indices between the current maximum and the given index are also
+ filled with `#!json null`.
+ - The special value `-` is treated as a synonym for the index past the end.
+
+## Examples
+
+??? example "Example: (1) access specified array element"
+
+ The example below shows how array elements can be read and written using `[]` operator. Note the addition of
+ `#!json null` values.
+
+ ```cpp
+ --8<-- "examples/operator_array__size_type.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator_array__size_type.output"
+ ```
+
+??? example "Example: (1) access specified array element (const)"
+
+ The example below shows how array elements can be read using the `[]` operator.
+
+ ```cpp
+ --8<-- "examples/operator_array__size_type_const.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator_array__size_type_const.output"
+ ```
+
+??? example "Example: (2) access specified object element"
+
+ The example below shows how object elements can be read and written using the `[]` operator.
+
+ ```cpp
+ --8<-- "examples/operator_array__object_t_key_type.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator_array__object_t_key_type.output"
+ ```
+
+??? example "Example: (2) access specified object element (const)"
+
+ The example below shows how object elements can be read using the `[]` operator.
+
+ ```cpp
+ --8<-- "examples/operator_array__object_t_key_type_const.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator_array__object_t_key_type_const.output"
+ ```
+
+??? example "Example: (3) access specified object element using string_view"
+
+ The example below shows how object elements can be read using the `[]` operator.
+
+ ```cpp
+ --8<-- "examples/operator_array__keytype.c++17.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator_array__keytype.c++17.output"
+ ```
+
+??? example "Example: (3) access specified object element using string_view (const)"
+
+ The example below shows how object elements can be read using the `[]` operator.
+
+ ```cpp
+ --8<-- "examples/operator_array__keytype_const.c++17.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator_array__keytype_const.c++17.output"
+ ```
+
+??? example "Example: (4) access specified element via JSON Pointer"
+
+ The example below shows how values can be read and written using JSON Pointers.
+
+ ```cpp
+ --8<-- "examples/operator_array__json_pointer.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator_array__json_pointer.output"
+ ```
+
+??? example "Example: (4) access specified element via JSON Pointer (const)"
+
+ The example below shows how values can be read using JSON Pointers.
+
+ ```cpp
+ --8<-- "examples/operator_array__json_pointer_const.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator_array__json_pointer_const.output"
+ ```
+
+## 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
+
+## Version history
+
+1. Added in version 1.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/docs/mkdocs/docs/api/basic_json/operator_ValueType.md b/docs/mkdocs/docs/api/basic_json/operator_ValueType.md
new file mode 100644
index 0000000..bf38a3d
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/operator_ValueType.md
@@ -0,0 +1,82 @@
+# <small>nlohmann::basic_json::</small>operator ValueType
+
+```cpp
+template<typename ValueType>
+JSON_EXPLICIT operator ValueType() const;
+```
+
+Implicit type conversion between the JSON value and a compatible value. The call is realized by calling
+[`get()`](get.md). See [Notes](#notes) for the meaning of `JSON_EXPLICIT`.
+
+## Template parameters
+
+`ValueType`
+: the value type to return
+
+## Return value
+
+copy of the JSON value, converted to `ValueType`
+
+## Exceptions
+
+Depends on what `json_serializer<ValueType>` `from_json()` method throws
+
+## Complexity
+
+Linear in the size of the JSON value.
+
+## Notes
+
+!!! note "Definition of `JSON_EXPLICIT`"
+
+ 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`:
+
+ ```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`.
+
+!!! 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).
+
+## Examples
+
+??? example
+
+ 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"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator__ValueType.output"
+ ```
+
+## Version history
+
+- Since version 1.0.0.
+- Macros `JSON_EXPLICIT`/[`JSON_USE_IMPLICIT_CONVERSIONS`](../macros/json_use_implicit_conversions.md) added
+ in version 3.9.0.
diff --git a/docs/mkdocs/docs/api/basic_json/operator_eq.md b/docs/mkdocs/docs/api/basic_json/operator_eq.md
new file mode 100644
index 0000000..b4d61b6
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/operator_eq.md
@@ -0,0 +1,168 @@
+# <small>nlohmann::basic_json::</small>operator==
+
+```cpp
+// 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; // (2)
+
+template<typename ScalarType>
+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)
+};
+```
+
+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.
+
+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
+
+`ScalarType`
+: a scalar type according to `std::is_scalar<ScalarType>::value`
+
+## Parameters
+
+`lhs` (in)
+: first value to consider
+
+`rhs` (in)
+: second value to consider
+
+## Return value
+
+whether the values `lhs`/`*this` and `rhs` are equal
+
+## Exception safety
+
+No-throw guarantee: this function never throws exceptions.
+
+## Complexity
+
+Linear.
+
+## Notes
+
+!!! note "Comparing special 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.
+
+!!! 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
+ [comparison function](https://github.com/mariokonrad/marnav/blob/master/include/marnav/math/floatingpoint.hpp#L34-#L39)
+ could be used, for instance
+
+ ```cpp
+ template<typename T, typename = typename std::enable_if<std::is_floating_point<T>::value, T>::type>
+ inline bool is_same(T a, T b, T epsilon = std::numeric_limits<T>::epsilon()) noexcept
+ {
+ return std::abs(a - b) <= epsilon;
+ }
+ ```
+
+ Or you can self-defined operator equal function like this:
+
+ ```cpp
+ bool my_equal(const_reference lhs, const_reference rhs)
+ {
+ const auto lhs_type lhs.type();
+ const auto rhs_type rhs.type();
+ if (lhs_type == rhs_type)
+ {
+ switch(lhs_type)
+ // self_defined case
+ case value_t::number_float:
+ return std::abs(lhs - rhs) <= std::numeric_limits<float>::epsilon();
+ // other cases remain the same with the original
+ ...
+ }
+ ...
+ }
+ ```
+
+!!! note "Comparing different `basic_json` specializations"
+
+ Comparing different `basic_json` specializations can have surprising effects. For instance, the result of comparing
+ the JSON objects
+
+ ```json
+ {
+ "version": 1,
+ "type": "integer"
+ }
+ ```
+
+ and
+
+ ```json
+ {
+ "type": "integer",
+ "version": 1
+ }
+ ```
+
+ depends on whether [`nlohmann::json`](../json.md) or [`nlohmann::ordered_json`](../ordered_json.md) is used:
+
+ ```cpp
+ --8<-- "examples/operator__equal__specializations.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator__equal__specializations.output"
+ ```
+
+## Examples
+
+??? example
+
+ The example demonstrates comparing several JSON types.
+
+ ```cpp
+ --8<-- "examples/operator__equal.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator__equal.output"
+ ```
+
+??? example
+
+ The example demonstrates comparing several JSON types against the null pointer (JSON `#!json null`).
+
+ ```cpp
+ --8<-- "examples/operator__equal__nullptr_t.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator__equal__nullptr_t.output"
+ ```
+
+## Version history
+
+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
new file mode 100644
index 0000000..847f6ca
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/operator_ge.md
@@ -0,0 +1,87 @@
+# <small>nlohmann::basic_json::</small>operator>=
+
+```cpp
+// 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; // (2)
+
+template<typename ScalarType>
+bool operator>=(ScalarType lhs, const const_reference rhs) noexcept; // (2)
+```
+
+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)` (see [**operator<**](operator_lt.md)).
+
+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
+
+`ScalarType`
+: a scalar type according to `std::is_scalar<ScalarType>::value`
+
+## Parameters
+
+`lhs` (in)
+: first value to consider
+
+`rhs` (in)
+: second value to consider
+
+## Return value
+
+whether `lhs` is less than or equal to `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 `#!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
+
+ The example demonstrates comparing several JSON types.
+
+ ```cpp
+ --8<-- "examples/operator__greaterequal.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator__greaterequal.output"
+ ```
+
+## See also
+
+- [**operator<=>**](operator_spaceship.md) comparison: 3-way
+
+## Version history
+
+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
new file mode 100644
index 0000000..9516656
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/operator_gt.md
@@ -0,0 +1,86 @@
+# <small>nlohmann::basic_json::</small>operator>
+
+```cpp
+// 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; // (2)
+
+template<typename ScalarType>
+bool operator>(ScalarType lhs, const const_reference rhs) noexcept; // (2)
+```
+
+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)` (see [**operator<=**](operator_le.md)).
+
+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
+
+`ScalarType`
+: a scalar type according to `std::is_scalar<ScalarType>::value`
+
+## Parameters
+
+`lhs` (in)
+: first value to consider
+
+`rhs` (in)
+: second value to consider
+
+## Return value
+
+whether `lhs` is greater than `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 `#!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
+
+ The example demonstrates comparing several JSON types.
+
+ ```cpp
+ --8<-- "examples/operator__greater.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator__greater.output"
+ ```
+
+## See also
+
+- [**operator<=>**](operator_spaceship.md) comparison: 3-way
+
+## Version history
+
+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
new file mode 100644
index 0000000..7b648e0
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/operator_le.md
@@ -0,0 +1,87 @@
+# <small>nlohmann::basic_json::</small>operator<=
+
+```cpp
+// 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; // (2)
+
+template<typename ScalarType>
+bool operator<=(ScalarType lhs, const const_reference rhs) noexcept; // (2)
+```
+
+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)` (see [**operator<**](operator_lt.md)).
+
+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
+
+`ScalarType`
+: a scalar type according to `std::is_scalar<ScalarType>::value`
+
+## Parameters
+
+`lhs` (in)
+: first value to consider
+
+`rhs` (in)
+: second value to consider
+
+## Return value
+
+whether `lhs` is less than or equal to `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 `#!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
+
+ The example demonstrates comparing several JSON types.
+
+ ```cpp
+ --8<-- "examples/operator__lessequal.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator__lessequal.output"
+ ```
+
+## See also
+
+- [**operator<=>**](operator_spaceship.md) comparison: 3-way
+
+## Version history
+
+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
new file mode 100644
index 0000000..b5d191e
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/operator_lt.md
@@ -0,0 +1,96 @@
+# <small>nlohmann::basic_json::</small>operator<
+
+```cpp
+// 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; // (2)
+
+template<typename ScalarType>
+bool operator<(ScalarType lhs, const const_reference rhs) noexcept; // (2)
+```
+
+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.
+
+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
+
+`ScalarType`
+: a scalar type according to `std::is_scalar<ScalarType>::value`
+
+## Parameters
+
+`lhs` (in)
+: first value to consider
+
+`rhs` (in)
+: second value to consider
+
+## Return value
+
+whether `lhs` is less than `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 `#!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
+
+ The example demonstrates comparing several JSON types.
+
+ ```cpp
+ --8<-- "examples/operator__less.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator__less.output"
+ ```
+
+## See also
+
+- [**operator<=>**](operator_spaceship.md) comparison: 3-way
+
+## Version history
+
+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
new file mode 100644
index 0000000..f5d989b
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/operator_ne.md
@@ -0,0 +1,99 @@
+# <small>nlohmann::basic_json::</small>operator!=
+
+```cpp
+// 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; // (2)
+
+template<typename ScalarType>
+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)
+};
+```
+
+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
+
+`ScalarType`
+: a scalar type according to `std::is_scalar<ScalarType>::value`
+
+## Parameters
+
+`lhs` (in)
+: first value to consider
+
+`rhs` (in)
+: second value to consider
+
+## Return value
+
+whether the values `lhs`/`*this` and `rhs` are not equal
+
+## 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 `#!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
+
+ The example demonstrates comparing several JSON types.
+
+ ```cpp
+ --8<-- "examples/operator__notequal.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator__notequal.output"
+ ```
+
+??? example
+
+ The example demonstrates comparing several JSON types against the null pointer (JSON `#!json null`).
+
+ ```cpp
+ --8<-- "examples/operator__notequal__nullptr_t.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator__notequal__nullptr_t.output"
+ ```
+
+## Version history
+
+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 0000000..f5bf1cf
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/operator_spaceship.md
@@ -0,0 +1,100 @@
+# <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.
+
+## Examples
+
+??? example "Example: (1) comparing JSON values"
+
+ The example demonstrates comparing several JSON values.
+
+ ```cpp
+ --8<-- "examples/operator_spaceship__const_reference.c++20.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator_spaceship__const_reference.c++20.output"
+ ```
+
+??? example "Example: (2) comparing JSON values and scalars"
+
+ The example demonstrates comparing several JSON values and scalars.
+
+ ```cpp
+ --8<-- "examples/operator_spaceship__scalartype.c++20.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator_spaceship__scalartype.c++20.output"
+ ```
+
+## 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/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 89%
rename from doc/mkdocs/docs/api/basic_json/parse.md
rename to docs/mkdocs/docs/api/basic_json/parse.md
index 95d876b..49838ad 100644
--- a/doc/mkdocs/docs/api/basic_json/parse.md
+++ b/docs/mkdocs/docs/api/basic_json/parse.md
@@ -28,9 +28,10 @@
: A compatible input, for instance:
- an `std::istream` object
- - a `FILE` pointer
+ - a `FILE` pointer (must not be null)
- a C-style array of characters
- a pointer to a null-terminated string of single byte characters
+ - a `std::string`
- an object `obj` for which `begin(obj)` and `end(obj)` produces a valid pair of iterators.
`IteratorType`
@@ -70,6 +71,13 @@
Strong guarantee: if an exception is thrown, there are no changes in the JSON value.
+## Exceptions
+
+- Throws [`parse_error.101`](../../home/exceptions.md#jsonexceptionparse_error101) in case of an unexpected token.
+- Throws [`parse_error.102`](../../home/exceptions.md#jsonexceptionparse_error102) if to_unicode fails or surrogate
+ error.
+- Throws [`parse_error.103`](../../home/exceptions.md#jsonexceptionparse_error103) if to_unicode fails.
+
## Complexity
Linear in the length of the input. The parser is a predictive LL(1) parser. The complexity can be higher if the parser
@@ -80,6 +88,11 @@
(1) A UTF-8 byte order mark is silently ignored.
+!!! danger "Runtime assertion"
+
+ The precondition that a passed `#!cpp FILE` pointer must not be null is enforced with a
+ [runtime assertion](../../features/assertions.md).
+
## Examples
??? example "Parsing from a character array"
@@ -183,7 +196,7 @@
## See also
- [accept](accept.md) - check if the input is valid JSON
-- [operator>>](operator_gtgt.md) - deserialize from stream
+- [operator>>](../operator_gtgt.md) - deserialize from stream
## Version history
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 95%
rename from doc/mkdocs/docs/api/basic_json/patch.md
rename to docs/mkdocs/docs/api/basic_json/patch.md
index b3ef963..deec474 100644
--- a/doc/mkdocs/docs/api/basic_json/patch.md
+++ b/docs/mkdocs/docs/api/basic_json/patch.md
@@ -65,6 +65,7 @@
- [RFC 6902 (JSON Patch)](https://tools.ietf.org/html/rfc6902)
- [RFC 6901 (JSON Pointer)](https://tools.ietf.org/html/rfc6901)
+- [patch_inplace](patch_inplace.md) applies a JSON Patch without creating a copy of the document
- [merge_patch](merge_patch.md) applies a JSON Merge Patch
## Version history
diff --git a/doc/mkdocs/docs/api/basic_json/patch.md b/docs/mkdocs/docs/api/basic_json/patch_inplace.md
similarity index 73%
copy from doc/mkdocs/docs/api/basic_json/patch.md
copy to docs/mkdocs/docs/api/basic_json/patch_inplace.md
index b3ef963..e8fd176 100644
--- a/doc/mkdocs/docs/api/basic_json/patch.md
+++ b/docs/mkdocs/docs/api/basic_json/patch_inplace.md
@@ -1,25 +1,21 @@
-# <small>nlohmann::basic_json::</small>patch
+# <small>nlohmann::basic_json::</small>patch_inplace
```cpp
-basic_json patch(const basic_json& json_patch) const;
+void patch_inplace(const basic_json& json_patch) const;
```
[JSON Patch](http://jsonpatch.com) defines a JSON document structure for expressing a sequence of operations to apply to
a JSON document. With this function, a JSON Patch is applied to the current JSON value by executing all operations from
-the patch.
+the patch. This function applies a JSON patch in place and returns void.
## Parameters
`json_patch` (in)
: JSON patch document
-## Return value
-
-patched document
-
## Exception safety
-Strong guarantee: if an exception is thrown, there are no changes in the JSON value.
+No guarantees, value may be corrupted by an unsuccessful patch operation.
## Exceptions
@@ -42,8 +38,9 @@
## Notes
-The application of a patch is atomic: Either all operations succeed and the patched document is returned or an exception
-is thrown. In any case, the original value is not changed: the patch is applied to a copy of the value.
+Unlike [`patch`](patch.md), `patch_inplace` applies the operation "in place" and no copy of the JSON value is created.
+That makes it faster for large documents by avoiding the copy. However, the JSON value might be corrupted if the
+function throws an exception.
## Examples
@@ -52,21 +49,22 @@
The following code shows how a JSON patch is applied to a value.
```cpp
- --8<-- "examples/patch.cpp"
+ --8<-- "examples/patch_inplace.cpp"
```
Output:
```json
- --8<-- "examples/patch.output"
+ --8<-- "examples/patch_inplace.output"
```
## See also
- [RFC 6902 (JSON Patch)](https://tools.ietf.org/html/rfc6902)
- [RFC 6901 (JSON Pointer)](https://tools.ietf.org/html/rfc6901)
+- [patch](patch.md) applies a JSON Merge Patch
- [merge_patch](merge_patch.md) applies a JSON Merge Patch
## Version history
-- Added in version 2.0.0.
+- Added in version 3.11.0.
diff --git a/doc/mkdocs/docs/api/basic_json/push_back.md b/docs/mkdocs/docs/api/basic_json/push_back.md
similarity index 84%
rename from doc/mkdocs/docs/api/basic_json/push_back.md
rename to docs/mkdocs/docs/api/basic_json/push_back.md
index 60bfed3..5c7d20d 100644
--- a/doc/mkdocs/docs/api/basic_json/push_back.md
+++ b/docs/mkdocs/docs/api/basic_json/push_back.md
@@ -37,12 +37,9 @@
## 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/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 94%
rename from doc/mkdocs/docs/api/basic_json/std_hash.md
rename to docs/mkdocs/docs/api/basic_json/std_hash.md
index b66515d..b9de74f 100644
--- a/doc/mkdocs/docs/api/basic_json/std_hash.md
+++ b/docs/mkdocs/docs/api/basic_json/std_hash.md
@@ -26,6 +26,8 @@
--8<-- "examples/std_hash.output"
```
+ Note the output is platform-dependent.
+
## Version history
- Added in version 1.0.0.
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_ubjson.md b/docs/mkdocs/docs/api/basic_json/to_bjdata.md
similarity index 62%
copy from doc/mkdocs/docs/api/basic_json/to_ubjson.md
copy to docs/mkdocs/docs/api/basic_json/to_bjdata.md
index 0a3d87e..1ea8505 100644
--- a/doc/mkdocs/docs/api/basic_json/to_ubjson.md
+++ b/docs/mkdocs/docs/api/basic_json/to_bjdata.md
@@ -1,25 +1,25 @@
-# <small>nlohmann::basic_json::</small>to_ubjson
+# <small>nlohmann::basic_json::</small>to_bjdata
```cpp
// (1)
-static std::vector<std::uint8_t> to_ubjson(const basic_json& j,
+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_ubjson(const basic_json& j, detail::output_adapter<std::uint8_t> o,
+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_ubjson(const basic_json& j, detail::output_adapter<char> o,
+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 UBJSON (Universal Binary JSON) serialization format. UBJSON
+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 UBJSON serialization.
-2. Writes the UBJSON serialization to an output adapter.
+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/ubjson.md).
+The exact mapping and its limitations is described on a [dedicated page](../../features/binary_formats/bjdata.md).
## Parameters
@@ -34,12 +34,12 @@
`use_type` (in)
: whether to add type annotations to container types (must be combined with `#!cpp use_size = true`); optional,
- `#!cpp false` by default.
+`#!cpp false` by default.
## Return value
-1. UBJSON serialization as byte vector
-2. /
+1. BJData serialization as byte vector
+2. (none)
## Exception safety
@@ -53,18 +53,18 @@
??? example
- The example shows the serialization of a JSON value to a byte vector in UBJSON format.
+ The example shows the serialization of a JSON value to a byte vector in BJData format.
```cpp
- --8<-- "examples/to_ubjson.cpp"
+ --8<-- "examples/to_bjdata.cpp"
```
Output:
```json
- --8<-- "examples/to_ubjson.output"
+ --8<-- "examples/to_bjdata.output"
```
## Version history
-- Added in version 3.1.0.
+- Added in version 3.11.0.
diff --git a/doc/mkdocs/docs/api/basic_json/to_bson.md b/docs/mkdocs/docs/api/basic_json/to_bson.md
similarity index 98%
rename from doc/mkdocs/docs/api/basic_json/to_bson.md
rename to docs/mkdocs/docs/api/basic_json/to_bson.md
index 664dd0e..5c4324a 100644
--- a/doc/mkdocs/docs/api/basic_json/to_bson.md
+++ b/docs/mkdocs/docs/api/basic_json/to_bson.md
@@ -28,7 +28,7 @@
## 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/docs/mkdocs/docs/api/basic_json/to_cbor.md
similarity index 99%
rename from doc/mkdocs/docs/api/basic_json/to_cbor.md
rename to docs/mkdocs/docs/api/basic_json/to_cbor.md
index 05d85ed..0f944c4 100644
--- a/doc/mkdocs/docs/api/basic_json/to_cbor.md
+++ b/docs/mkdocs/docs/api/basic_json/to_cbor.md
@@ -29,7 +29,7 @@
## 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/docs/mkdocs/docs/api/basic_json/to_msgpack.md
similarity index 99%
rename from doc/mkdocs/docs/api/basic_json/to_msgpack.md
rename to docs/mkdocs/docs/api/basic_json/to_msgpack.md
index fb4b40b..7d40981 100644
--- a/doc/mkdocs/docs/api/basic_json/to_msgpack.md
+++ b/docs/mkdocs/docs/api/basic_json/to_msgpack.md
@@ -28,7 +28,7 @@
## Return value
1. MessagePack serialization as byte vector
-2. /
+2. (none)
## Exception safety
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 99%
rename from doc/mkdocs/docs/api/basic_json/to_ubjson.md
rename to docs/mkdocs/docs/api/basic_json/to_ubjson.md
index 0a3d87e..e3cd5d6 100644
--- a/doc/mkdocs/docs/api/basic_json/to_ubjson.md
+++ b/docs/mkdocs/docs/api/basic_json/to_ubjson.md
@@ -39,7 +39,7 @@
## Return value
1. UBJSON serialization as byte vector
-2. /
+2. (none)
## Exception safety
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 63%
rename from doc/mkdocs/docs/api/basic_json/value.md
rename to docs/mkdocs/docs/api/basic_json/value.md
index 0b4f1cc..b5fd14d 100644
--- a/doc/mkdocs/docs/api/basic_json/value.md
+++ b/docs/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 @@
}
```
-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
@@ -36,7 +44,7 @@
}
```
-!!! 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
@@ -44,6 +52,10 @@
## 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 @@
: 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 @@
## 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 @@
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,35 +101,50 @@
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
-??? example "Example (1): access specified object element with default value"
+??? example "Example: (1) access specified object element with default value"
The example below shows how object elements can be queried with a default value.
```cpp
- --8<-- "examples/basic_json__value.cpp"
+ --8<-- "examples/value__object_t_key_type.cpp"
```
Output:
```json
- --8<-- "examples/basic_json__value.output"
+ --8<-- "examples/value__object_t_key_type.output"
```
-??? example "Example (2): access specified object element via JSON Pointer with default value"
+??? example "Example: (2) access specified object element using string_view with default value"
The example below shows how object elements can be queried with a default value.
```cpp
- --8<-- "examples/basic_json__value_ptr.cpp"
+ --8<-- "examples/value__keytype.c++17.cpp"
```
Output:
```json
- --8<-- "examples/basic_json__value_ptr.output"
+ --8<-- "examples/value__keytype.c++17.output"
+ ```
+
+??? 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.
+
+ ```cpp
+ --8<-- "examples/value__json_ptr.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/value__json_ptr.output"
```
## See also
@@ -125,5 +154,6 @@
## 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/docs/mkdocs/docs/api/basic_json/value_t.md b/docs/mkdocs/docs/api/basic_json/value_t.md
new file mode 100644
index 0000000..f835740
--- /dev/null
+++ b/docs/mkdocs/docs/api/basic_json/value_t.md
@@ -0,0 +1,83 @@
+# <small>nlohmann::basic_json::</small>value_t
+
+```cpp
+enum class value_t : std::uint8_t {
+ null,
+ object,
+ array,
+ string,
+ boolean,
+ number_integer,
+ number_unsigned,
+ number_float,
+ binary,
+ discarded
+};
+```
+
+This enumeration collects the different JSON types. It is internally used to distinguish the stored values, and the
+functions [`is_null`](is_null.md), [`is_object`](is_object.md), [`is_array`](is_array.md), [`is_string`](is_string.md),
+[`is_boolean`](is_boolean.md), [`is_number`](is_number.md) (with [`is_number_integer`](is_number_integer.md),
+[`is_number_unsigned`](is_number_unsigned.md), and [`is_number_float`](is_number_float.md)),
+[`is_discarded`](is_discarded.md), [`is_binary`](is_binary.md), [`is_primitive`](is_primitive.md), and
+[`is_structured`](is_structured.md) rely on it.
+
+## Notes
+
+!!! 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
+
+??? 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.
+- Added unsigned integer type in version 2.0.0.
+- Added binary type in version 3.8.0.
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 67%
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
index caa273d..9913a9b 100644
--- 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
@@ -25,6 +25,22 @@
`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
new file mode 100644
index 0000000..c62dead
--- /dev/null
+++ b/docs/mkdocs/docs/api/byte_container_with_subtype/clear_subtype.md
@@ -0,0 +1,36 @@
+# <small>nlohmann::byte_container_with_subtype::</small>clear_subtype
+
+```cpp
+void clear_subtype() noexcept;
+```
+
+Clears the binary subtype and flags the value as not having a subtype, which has implications for serialization; for
+instance MessagePack will prefer the bin family over the ext family.
+
+## Exception safety
+
+No-throw guarantee: this function never throws exceptions.
+
+## Complexity
+
+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
new file mode 100644
index 0000000..e06286e
--- /dev/null
+++ b/docs/mkdocs/docs/api/byte_container_with_subtype/has_subtype.md
@@ -0,0 +1,39 @@
+# <small>nlohmann::byte_container_with_subtype::</small>has_subtype
+
+```cpp
+constexpr bool has_subtype() const noexcept;
+```
+
+Returns whether the value has a subtype.
+
+## Return value
+
+whether the value has a subtype
+
+## Exception safety
+
+No-throw guarantee: this function never throws exceptions.
+
+## Complexity
+
+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/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 60%
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
index 40cc272..cf21732 100644
--- a/doc/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 @@
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/doc/mkdocs/docs/api/byte_container_with_subtype/subtype.md b/docs/mkdocs/docs/api/byte_container_with_subtype/subtype.md
similarity index 63%
rename from doc/mkdocs/docs/api/byte_container_with_subtype/subtype.md
rename to docs/mkdocs/docs/api/byte_container_with_subtype/subtype.md
index e78654b..389241a 100644
--- a/doc/mkdocs/docs/api/byte_container_with_subtype/subtype.md
+++ b/docs/mkdocs/docs/api/byte_container_with_subtype/subtype.md
@@ -19,6 +19,23 @@
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
new file mode 100644
index 0000000..36edcc2
--- /dev/null
+++ b/docs/mkdocs/docs/api/json.md
@@ -0,0 +1,28 @@
+# <small>nlohmann::</small>json
+
+```cpp
+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/doc/mkdocs/docs/api/json_pointer/back.md b/docs/mkdocs/docs/api/json_pointer/back.md
similarity index 82%
rename from doc/mkdocs/docs/api/json_pointer/back.md
rename to docs/mkdocs/docs/api/json_pointer/back.md
index 2b267bc..240bc6e 100644
--- a/doc/mkdocs/docs/api/json_pointer/back.md
+++ b/docs/mkdocs/docs/api/json_pointer/back.md
@@ -1,7 +1,7 @@
# <small>nlohmann::json_pointer::</small>back
```cpp
-const std::string& back() const;
+const string_t& back() const;
```
Return last reference token.
@@ -36,4 +36,5 @@
## Version history
-Added in version 3.6.0.
+- Added in version 3.6.0.
+- Changed return type to `string_t` in version 3.11.0.
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/docs/mkdocs/docs/api/json_pointer/index.md b/docs/mkdocs/docs/api/json_pointer/index.md
new file mode 100644
index 0000000..75b536c
--- /dev/null
+++ b/docs/mkdocs/docs/api/json_pointer/index.md
@@ -0,0 +1,50 @@
+# <small>nlohmann::</small>json_pointer
+
+```cpp
+template<typename RefStringType>
+class json_pointer;
+```
+
+A JSON pointer defines a string syntax for identifying a specific value within a JSON document. It can be used with
+functions [`at`](../basic_json/at.md) and [`operator[]`](../basic_json/operator%5B%5D.md). Furthermore, JSON pointers
+are the base for JSON patches.
+
+## Template parameters
+
+`RefStringType`
+: the string type used for the reference tokens making up the JSON pointer
+
+!!! 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.
+
+## Member types
+
+- [**string_t**](string_t.md) - the string type used for the reference tokens
+
+## Member functions
+
+- [(constructor)](json_pointer.md)
+- [**to_string**](to_string.md) - return a string representation of the JSON pointer
+- [**operator string_t**](operator_string_t.md) - return a string representation of the JSON pointer
+- [**operator/=**](operator_slasheq.md) - append to the end of the JSON pointer
+- [**operator/**](operator_slash.md) - create JSON Pointer by appending
+- [**parent_pointer**](parent_pointer.md) - returns the parent of this JSON pointer
+- [**pop_back**](pop_back.md) - remove last reference token
+- [**back**](back.md) - return last reference token
+- [**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
+
+## Literals
+
+- [**operator""_json_pointer**](../operator_literal_json_pointer.md) - user-defined string literal for JSON pointers
+## See also
+
+- [RFC 6901](https://datatracker.ietf.org/doc/html/rfc6901)
+
+## Version history
+
+- Added in version 2.0.0.
+- Changed template parameter from `basic_json` to string type in version 3.11.0.
diff --git a/doc/mkdocs/docs/api/json_pointer/json_pointer.md b/docs/mkdocs/docs/api/json_pointer/json_pointer.md
similarity index 89%
rename from doc/mkdocs/docs/api/json_pointer/json_pointer.md
rename to docs/mkdocs/docs/api/json_pointer/json_pointer.md
index 1e68a28..5e7057f 100644
--- a/doc/mkdocs/docs/api/json_pointer/json_pointer.md
+++ b/docs/mkdocs/docs/api/json_pointer/json_pointer.md
@@ -1,7 +1,7 @@
# <small>nlohmann::json_pointer::</small>json_pointer
```cpp
-explicit json_pointer(const std::string& s = "");
+explicit json_pointer(const string_t& s = "");
```
Create a JSON pointer according to the syntax described in
@@ -37,4 +37,5 @@
## Version history
-Added in version 2.0.0.
+- Added in version 2.0.0.
+- Changed type of `s` to `string_t` in version 3.11.0.
diff --git a/doc/mkdocs/docs/api/json_pointer/operator_slash.md b/docs/mkdocs/docs/api/json_pointer/operator_slash.md
similarity index 89%
rename from doc/mkdocs/docs/api/json_pointer/operator_slash.md
rename to docs/mkdocs/docs/api/json_pointer/operator_slash.md
index c928754..ed77b50 100644
--- a/doc/mkdocs/docs/api/json_pointer/operator_slash.md
+++ b/docs/mkdocs/docs/api/json_pointer/operator_slash.md
@@ -5,7 +5,7 @@
json_pointer operator/(const json_pointer& lhs, const json_pointer& rhs);
// (2)
-json_pointer operator/(const json_pointer& lhs, std::string token);
+json_pointer operator/(const json_pointer& lhs, string_t token);
// (3)
json_pointer operator/(const json_pointer& lhs, std::size_t array_idx);
@@ -60,5 +60,5 @@
## Version history
1. Added in version 3.6.0.
-2. Added in version 3.6.0.
+2. Added in version 3.6.0. Changed type of `token` to `string_t` in version 3.11.0.
3. Added in version 3.6.0.
diff --git a/doc/mkdocs/docs/api/json_pointer/operator_slasheq.md b/docs/mkdocs/docs/api/json_pointer/operator_slasheq.md
similarity index 89%
rename from doc/mkdocs/docs/api/json_pointer/operator_slasheq.md
rename to docs/mkdocs/docs/api/json_pointer/operator_slasheq.md
index eb6c308..3518557 100644
--- a/doc/mkdocs/docs/api/json_pointer/operator_slasheq.md
+++ b/docs/mkdocs/docs/api/json_pointer/operator_slasheq.md
@@ -5,7 +5,7 @@
json_pointer& operator/=(const json_pointer& ptr);
// (2)
-json_pointer& operator/=(std::string token);
+json_pointer& operator/=(string_t token);
// (3)
json_pointer& operator/=(std::size_t array_idx)
@@ -57,5 +57,5 @@
## Version history
1. Added in version 3.6.0.
-2. Added in version 3.6.0.
+2. Added in version 3.6.0. Changed type of `token` to `string_t` in version 3.11.0.
3. Added in version 3.6.0.
diff --git a/docs/mkdocs/docs/api/json_pointer/operator_string_t.md b/docs/mkdocs/docs/api/json_pointer/operator_string_t.md
new file mode 100644
index 0000000..74105a4
--- /dev/null
+++ b/docs/mkdocs/docs/api/json_pointer/operator_string_t.md
@@ -0,0 +1,48 @@
+# <small>nlohmann::json_pointer::</small>operator string_t
+
+```cpp
+operator string_t() const
+```
+
+Return a string representation of the JSON pointer.
+
+## Return value
+
+A string representation of the JSON pointer
+
+## Possible implementation
+
+```cpp
+operator string_t() const
+{
+ return to_string();
+}
+```
+
+## Notes
+
+!!! warning "Deprecation"
+
+ This function is deprecated in favor of [`to_string`](to_string.md) and will be removed in a future major version
+ release.
+
+## Examples
+
+??? example
+
+ The example shows how JSON Pointers can be implicitly converted to strings.
+
+ ```cpp
+ --8<-- "examples/json_pointer__operator_string_t.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/json_pointer__operator_string_t.output"
+ ```
+
+## Version history
+
+- Since version 2.0.0.
+- Changed type to `string_t` and deprecated in version 3.11.0.
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 76%
rename from doc/mkdocs/docs/api/json_pointer/push_back.md
rename to docs/mkdocs/docs/api/json_pointer/push_back.md
index 3ebcdbc..c1c19cb 100644
--- a/doc/mkdocs/docs/api/json_pointer/push_back.md
+++ b/docs/mkdocs/docs/api/json_pointer/push_back.md
@@ -1,9 +1,9 @@
# <small>nlohmann::json_pointer::</small>push_back
```cpp
-void push_back(const std::string& token);
+void push_back(const string_t& token);
-void push_back(std::string&& token);
+void push_back(string_t&& token);
```
Append an unescaped token at the end of the reference pointer.
@@ -35,4 +35,5 @@
## Version history
-Added in version 3.6.0.
+- Added in version 3.6.0.
+- Changed type of `token` to `string_t` in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/json_pointer/string_t.md b/docs/mkdocs/docs/api/json_pointer/string_t.md
new file mode 100644
index 0000000..c8527bc
--- /dev/null
+++ b/docs/mkdocs/docs/api/json_pointer/string_t.md
@@ -0,0 +1,28 @@
+# <small>nlohmann::json_pointer::</small>string_t
+```cpp
+using string_t = RefStringType;
+```
+
+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/doc/mkdocs/docs/api/json_pointer/to_string.md b/docs/mkdocs/docs/api/json_pointer/to_string.md
similarity index 83%
rename from doc/mkdocs/docs/api/json_pointer/to_string.md
rename to docs/mkdocs/docs/api/json_pointer/to_string.md
index 9287436..fae3abe 100644
--- a/doc/mkdocs/docs/api/json_pointer/to_string.md
+++ b/docs/mkdocs/docs/api/json_pointer/to_string.md
@@ -1,7 +1,7 @@
# <small>nlohmann::json_pointer::</small>to_string
```cpp
-std::string to_string() const;
+string_t to_string() const;
```
Return a string representation of the JSON pointer.
@@ -36,4 +36,5 @@
## Version history
-Since version 2.0.0.
+- Since version 2.0.0.
+- Changed return type to `string_t` 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
new file mode 100644
index 0000000..753e99c
--- /dev/null
+++ b/docs/mkdocs/docs/api/json_sax/binary.md
@@ -0,0 +1,40 @@
+# <small>nlohmann::json_sax::</small>binary
+
+```cpp
+virtual bool binary(binary_t& val) = 0;
+```
+
+A binary value was read.
+
+## Parameters
+
+`val` (in)
+: binary value
+
+## Return value
+
+Whether parsing should proceed.
+
+## Notes
+
+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
new file mode 100644
index 0000000..78163b3
--- /dev/null
+++ b/docs/mkdocs/docs/api/json_sax/boolean.md
@@ -0,0 +1,36 @@
+# <small>nlohmann::json_sax::</small>boolean
+
+```cpp
+virtual bool boolean(bool val) = 0;
+```
+
+A boolean value was read.
+
+## Parameters
+
+`val` (in)
+: boolean value
+
+## Return value
+
+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
new file mode 100644
index 0000000..46b4c7a
--- /dev/null
+++ b/docs/mkdocs/docs/api/json_sax/end_array.md
@@ -0,0 +1,31 @@
+# <small>nlohmann::json_sax::</small>end_array
+
+```cpp
+virtual bool end_array() = 0;
+```
+
+The end of an array was read.
+
+## Return value
+
+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
new file mode 100644
index 0000000..8df0ab4
--- /dev/null
+++ b/docs/mkdocs/docs/api/json_sax/end_object.md
@@ -0,0 +1,31 @@
+# <small>nlohmann::json_sax::</small>end_object
+
+```cpp
+virtual bool end_object() = 0;
+```
+
+The end of an object was read.
+
+## Return value
+
+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/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/docs/mkdocs/docs/api/json_sax/key.md b/docs/mkdocs/docs/api/json_sax/key.md
new file mode 100644
index 0000000..ebd3ae2
--- /dev/null
+++ b/docs/mkdocs/docs/api/json_sax/key.md
@@ -0,0 +1,40 @@
+# <small>nlohmann::json_sax::</small>key
+
+```cpp
+virtual bool key(string_t& val) = 0;
+```
+
+An object key was read.
+
+## Parameters
+
+`val` (in)
+: object key
+
+## Return value
+
+Whether parsing should proceed.
+
+## Notes
+
+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
new file mode 100644
index 0000000..71b2a45
--- /dev/null
+++ b/docs/mkdocs/docs/api/json_sax/null.md
@@ -0,0 +1,31 @@
+# <small>nlohmann::json_sax::</small>null
+
+```cpp
+virtual bool null() = 0;
+```
+
+A null value was read.
+
+## Return value
+
+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/doc/mkdocs/docs/api/json_sax/number_float.md b/docs/mkdocs/docs/api/json_sax/number_float.md
similarity index 62%
rename from doc/mkdocs/docs/api/json_sax/number_float.md
rename to docs/mkdocs/docs/api/json_sax/number_float.md
index 9419328..e1b3fb6 100644
--- a/doc/mkdocs/docs/api/json_sax/number_float.md
+++ b/docs/mkdocs/docs/api/json_sax/number_float.md
@@ -18,6 +18,22 @@
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
new file mode 100644
index 0000000..8628a65
--- /dev/null
+++ b/docs/mkdocs/docs/api/json_sax/number_integer.md
@@ -0,0 +1,36 @@
+# <small>nlohmann::json_sax::</small>number_integer
+
+```cpp
+virtual bool number_integer(number_integer_t val) = 0;
+```
+
+An integer number was read.
+
+## Parameters
+
+`val` (in)
+: integer value
+
+## Return value
+
+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
new file mode 100644
index 0000000..7b59748
--- /dev/null
+++ b/docs/mkdocs/docs/api/json_sax/number_unsigned.md
@@ -0,0 +1,36 @@
+# <small>nlohmann::json_sax::</small>number_unsigned
+
+```cpp
+virtual bool number_unsigned(number_unsigned_t val) = 0;
+```
+
+An unsigned integer number was read.
+
+## Parameters
+
+`val` (in)
+: unsigned integer value
+
+## Return value
+
+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/doc/mkdocs/docs/api/json_sax/parse_error.md b/docs/mkdocs/docs/api/json_sax/parse_error.md
similarity index 71%
rename from doc/mkdocs/docs/api/json_sax/parse_error.md
rename to docs/mkdocs/docs/api/json_sax/parse_error.md
index 00f1aa9..d4405d0 100644
--- a/doc/mkdocs/docs/api/json_sax/parse_error.md
+++ b/docs/mkdocs/docs/api/json_sax/parse_error.md
@@ -23,6 +23,22 @@
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/doc/mkdocs/docs/api/json_sax/start_array.md b/docs/mkdocs/docs/api/json_sax/start_array.md
similarity index 63%
rename from doc/mkdocs/docs/api/json_sax/start_array.md
rename to docs/mkdocs/docs/api/json_sax/start_array.md
index d10a6e5..8ef10a4 100644
--- a/doc/mkdocs/docs/api/json_sax/start_array.md
+++ b/docs/mkdocs/docs/api/json_sax/start_array.md
@@ -19,6 +19,22 @@
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/doc/mkdocs/docs/api/json_sax/start_object.md b/docs/mkdocs/docs/api/json_sax/start_object.md
similarity index 64%
rename from doc/mkdocs/docs/api/json_sax/start_object.md
rename to docs/mkdocs/docs/api/json_sax/start_object.md
index fd90f19..24fedff 100644
--- a/doc/mkdocs/docs/api/json_sax/start_object.md
+++ b/docs/mkdocs/docs/api/json_sax/start_object.md
@@ -19,6 +19,22 @@
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
new file mode 100644
index 0000000..1cb6014
--- /dev/null
+++ b/docs/mkdocs/docs/api/json_sax/string.md
@@ -0,0 +1,40 @@
+# <small>nlohmann::json_sax::</small>string
+
+```cpp
+virtual bool string(string_t& val) = 0;
+```
+
+A string value was read.
+
+## Parameters
+
+`val` (in)
+: string value
+
+## Return value
+
+Whether parsing should proceed.
+
+## Notes
+
+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/index.md b/docs/mkdocs/docs/api/macros/index.md
new file mode 100644
index 0000000..8e118b0
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/index.md
@@ -0,0 +1,57 @@
+# Macros
+
+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).
+
+## Runtime assertions
+
+- [**JSON_ASSERT(x)**](json_assert.md) - control behavior of runtime assertions
+
+## 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_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
+- [**JSON_USE_GLOBAL_UDLS**](json_use_global_udls.md) - place user-defined string literals (UDLs) into the global namespace
+
+## 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
+
+## Library namespace
+
+- [**NLOHMANN_JSON_NAMESPACE**](nlohmann_json_namespace.md) - full name of the `nlohmann` namespace
+- [**NLOHMANN_JSON_NAMESPACE_BEGIN**<br>**NLOHMANN_JSON_NAMESPACE_END**](nlohmann_json_namespace_begin.md) - open and close the library namespace
+
+## 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-->
+## 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...)**][DefInt]
+ \- 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...)**][DefNonInt]
+ \- serialization/deserialization of types _without_ access to private variables
+- [**NLOHMANN_JSON_SERIALIZE_ENUM(type, ...)**](nlohmann_json_serialize_enum.md) - serialization/deserialization of enum types
+
+[DefInt]: nlohmann_define_type_intrusive.md
+[DefNonInt]: nlohmann_define_type_non_intrusive.md
diff --git a/docs/mkdocs/docs/api/macros/json_assert.md b/docs/mkdocs/docs/api/macros/json_assert.md
new file mode 100644
index 0000000..a093341
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_assert.md
@@ -0,0 +1,84 @@
+# JSON_ASSERT
+
+```cpp
+#define JSON_ASSERT(x) /* value */
+```
+
+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
+#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/docs/mkdocs/docs/api/macros/json_diagnostics.md b/docs/mkdocs/docs/api/macros/json_diagnostics.md
new file mode 100644
index 0000000..4fc0fc3
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_diagnostics.md
@@ -0,0 +1,76 @@
+# 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.
+
+## 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
+
+!!! note "ABI compatibility"
+
+ As of version 3.11.0, this macro is no longer required to be defined consistently throughout a codebase to avoid
+ One Definition Rule (ODR) violations, as the value of this macro is encoded in the namespace, resulting in distinct
+ symbol names.
+
+ This allows different parts of a codebase to use different versions or configurations of this library without
+ causing improper behavior.
+
+ Where possible, it is still recommended that all code define this the same way for maximum interoperability.
+
+!!! hint "CMake option"
+
+ Diagnostic messages can also be controlled with the CMake option
+ [`JSON_Diagnostics`](../../integration/cmake.md#json_diagnostics) (`OFF` by default)
+ which defines `JSON_DIAGNOSTICS` accordingly.
+
+## 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.
+- As of version 3.11.0 the definition is allowed to vary between translation units.
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 0000000..6df3dd5
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_disable_enum_serialization.md
@@ -0,0 +1,152 @@
+# JSON_DISABLE_ENUM_SERIALIZATION
+
+```cpp
+#define JSON_DISABLE_ENUM_SERIALIZATION /* value */
+```
+
+When defined to `1`, 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
+
+The default value is `0`.
+
+```cpp
+#define JSON_DISABLE_ENUM_SERIALIZATION 0
+```
+
+## Notes
+
+!!! hint "CMake option"
+
+ Enum serialization can also be controlled with the CMake option
+ [`JSON_DisableEnumSerialization`](../../integration/cmake.md#json_disableenumserialization)
+ (`OFF` by default) which defines `JSON_DISABLE_ENUM_SERIALIZATION` accordingly.
+
+## 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)
+
+## Version history
+
+- Added in version 3.11.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
new file mode 100644
index 0000000..f3eaa58
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_has_cpp_11.md
@@ -0,0 +1,41 @@
+# 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.
+
+## 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
new file mode 100644
index 0000000..308aea2
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_has_filesystem.md
@@ -0,0 +1,43 @@
+# 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.
+
+## 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_has_ranges.md b/docs/mkdocs/docs/api/macros/json_has_ranges.md
new file mode 100644
index 0000000..96d5105
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_has_ranges.md
@@ -0,0 +1,31 @@
+# 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.
+
+## Examples
+
+??? example
+
+ The code below forces the library to enable support for ranges:
+
+ ```cpp
+ #define JSON_HAS_RANGES 1
+ #include <nlohmann/json.hpp>
+
+ ...
+ ```
+
+## 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 0000000..f52070e
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_has_three_way_comparison.md
@@ -0,0 +1,32 @@
+# 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.
+
+## Examples
+
+??? example
+
+ The code below forces the library to use 3-way comparison:
+
+ ```cpp
+ #define JSON_HAS_THREE_WAY_COMPARISON 1
+ #include <nlohmann/json.hpp>
+
+ ...
+ ```
+
+## Version history
+
+- Added in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/macros/json_no_io.md b/docs/mkdocs/docs/api/macros/json_no_io.md
new file mode 100644
index 0000000..ef37384
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_no_io.md
@@ -0,0 +1,35 @@
+# 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
+```
+
+## 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
new file mode 100644
index 0000000..c801b85
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_noexception.md
@@ -0,0 +1,45 @@
+# 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).
+
+## 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
+
+## Version history
+
+Added in version 2.1.0.
diff --git a/docs/mkdocs/docs/api/macros/json_skip_library_version_check.md b/docs/mkdocs/docs/api/macros/json_skip_library_version_check.md
new file mode 100644
index 0000000..c9a743c
--- /dev/null
+++ b/docs/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/docs/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md b/docs/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md
new file mode 100644
index 0000000..374fa4c
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_skip_unsupported_compiler_check.md
@@ -0,0 +1,33 @@
+# 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
+```
+
+## 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/json_throw_user.md b/docs/mkdocs/docs/api/macros/json_throw_user.md
new file mode 100644
index 0000000..e10db90
--- /dev/null
+++ b/docs/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/docs/mkdocs/docs/api/macros/json_use_global_udls.md b/docs/mkdocs/docs/api/macros/json_use_global_udls.md
new file mode 100644
index 0000000..dc9b55f
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_use_global_udls.md
@@ -0,0 +1,99 @@
+# JSON_USE_GLOBAL_UDLS
+
+```cpp
+#define JSON_USE_GLOBAL_UDLS /* value */
+```
+
+When defined to `1`, the user-defined string literals (UDLs) are placed into the global namespace instead of
+`nlohmann::literals::json_literals`.
+
+## Default definition
+
+The default value is `1`.
+
+```cpp
+#define JSON_USE_GLOBAL_UDLS 1
+```
+
+When the macro is not defined, the library will define it to its default value.
+
+## Notes
+
+!!! info "Future behavior change"
+
+ The user-defined string literals will be removed from the global namespace in the next major release of the
+ library.
+
+ To prepare existing code, define `JSON_USE_GLOBAL_UDLS` to `0` and bring the string literals into scope where
+ needed. Refer to any of the [string literals](#see-also) for details.
+
+!!! hint "CMake option"
+
+ The placement of user-defined string literals can also be controlled with the CMake option
+ [`JSON_GlobalUDLs`](../../integration/cmake.md#json_globaludls) (`OFF` by default)
+ which defines `JSON_USE_GLOBAL_UDLS` accordingly.
+
+## Examples
+
+??? example "Example 1: Default behavior"
+
+ The code below shows the default behavior using the `_json` UDL.
+
+ ```cpp
+ #include <nlohmann/json.hpp>
+
+ #include <iostream>
+
+ int main()
+ {
+ auto j = "42"_json;
+
+ std::cout << j << std::endl;
+ }
+ ```
+
+ Output:
+
+ ```json
+ 42
+ ```
+
+??? example "Example 2: Namespaced UDLs"
+
+ The code below shows how UDLs need to be brought into scope before using `_json` when `JSON_USE_GLOBAL_UDLS` is
+ defined to `0`.
+
+ ```cpp
+ #define JSON_USE_GLOBAL_UDLS 0
+ #include <nlohmann/json.hpp>
+
+ #include <iostream>
+
+ int main()
+ {
+ // auto j = "42"_json; // This line would fail to compile,
+ // because the UDLs are not in the global namespace
+
+ // Bring the UDLs into scope
+ using namespace nlohmann::json_literals;
+
+ auto j = "42"_json;
+
+ std::cout << j << std::endl;
+ }
+ ```
+
+ Output:
+
+ ```json
+ 42
+ ```
+
+## See also
+
+- [`operator""_json`](../operator_literal_json.md)
+- [`operator""_json_pointer`](../operator_literal_json_pointer.md)
+
+## Version history
+
+- Added in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/macros/json_use_implicit_conversions.md b/docs/mkdocs/docs/api/macros/json_use_implicit_conversions.md
new file mode 100644
index 0000000..adadffa
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_use_implicit_conversions.md
@@ -0,0 +1,59 @@
+# 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).
+
+## 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).
+
+!!! hint "CMake option"
+
+ Implicit conversions can also be controlled with the CMake option
+ [`JSON_ImplicitConversions`](../../integration/cmake.md#json_legacydiscardedvaluecomparison)
+ (`ON` by default) which defines `JSON_USE_IMPLICIT_CONVERSIONS` accordingly.
+
+## 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/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 0000000..bdb0a46
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/json_use_legacy_discarded_value_comparison.md
@@ -0,0 +1,80 @@
+# 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.
+
+!!! hint "CMake option"
+
+ Legacy comparison can also be controlled with the CMake option
+ [`JSON_LegacyDiscardedValueComparison`](../../integration/cmake.md#json_legacydiscardedvaluecomparison)
+ (`OFF` by default) which defines `JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON` accordingly.
+
+## Examples
+
+??? example
+
+ The code below switches on the legacy discarded value comparison behavior in the library.
+
+ ```cpp
+ #define JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON 1
+ #include <nlohmann/json.hpp>
+
+ ...
+ ```
+
+## Version history
+
+- Added in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/macros/nlohmann_define_type_intrusive.md b/docs/mkdocs/docs/api/macros/nlohmann_define_type_intrusive.md
new file mode 100644
index 0000000..9a14ad7
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/nlohmann_define_type_intrusive.md
@@ -0,0 +1,126 @@
+# 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?][GetNonDefNonCopy]
+ for how to overcome this limitation.
+ 2. The macro must be used inside the type (class/struct).
+
+[GetNonDefNonCopy]: ../../features/arbitrary_types.md#how-can-i-use-get-for-non-default-constructiblenon-copyable-types
+
+!!! 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 Type 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/docs/mkdocs/docs/api/macros/nlohmann_define_type_non_intrusive.md b/docs/mkdocs/docs/api/macros/nlohmann_define_type_non_intrusive.md
new file mode 100644
index 0000000..28b3589
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/nlohmann_define_type_non_intrusive.md
@@ -0,0 +1,126 @@
+# 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?][GetNonDefNonCopy]
+ for how to overcome this limitation.
+ 2. The macro must be used outside the type (class/struct).
+ 3. The passed members must be public.
+
+[GetNonDefNonCopy]: ../../features/arbitrary_types.md#how-can-i-use-get-for-non-default-constructiblenon-copyable-types
+
+!!! 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 Type 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/docs/mkdocs/docs/api/macros/nlohmann_json_namespace.md b/docs/mkdocs/docs/api/macros/nlohmann_json_namespace.md
new file mode 100644
index 0000000..d76bffb
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/nlohmann_json_namespace.md
@@ -0,0 +1,26 @@
+# NLOHMANN_JSON_NAMESPACE
+
+```cpp
+#define NLOHMANN_JSON_NAMESPACE
+```
+
+This macro evaluates to the full name of the `nlohmann` namespace, including
+the name of a versioned and ABI-tagged inline namespace. Use this macro to
+unambiguously refer to the `nlohmann` namespace.
+
+## Default definition
+
+The default value consists of a prefix, a version string, and optional ABI tags
+depending on whether ABI-affecting macros are defined (e.g.,
+[`JSON_DIAGNOSTICS`](json_diagnostics.md), and
+[`JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON`](json_use_legacy_discarded_value_comparison.md)).
+
+When the macro is not defined, the library will define it to its default value.
+
+## See also
+
+- [`NLOHMANN_JSON_NAMESPACE_BEGIN, NLOHMANN_JSON_NAMESPACE_END`](nlohmann_json_namespace_begin.md)
+
+## Version history
+
+- Added in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/macros/nlohmann_json_namespace_begin.md b/docs/mkdocs/docs/api/macros/nlohmann_json_namespace_begin.md
new file mode 100644
index 0000000..83844b5
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/nlohmann_json_namespace_begin.md
@@ -0,0 +1,40 @@
+# NLOHMANN_JSON_NAMESPACE_BEGIN, NLOHMANN_JSON_NAMESPACE_END
+
+```cpp
+#define NLOHMANN_JSON_NAMESPACE_BEGIN // (1)
+#define NLOHMANN_JSON_NAMESPACE_END // (2)
+```
+
+These macros can be used to open and close the `nlohmann` namespace. They
+include an inline namespace used to differentiate symbols when linking multiple
+versions (including different ABI-affecting macros) of this library.
+
+1. Opens the namespace.
+ ```cpp
+ namespace nlohmann
+ {
+ inline namespace json_v3_11_0
+ {
+ ```
+
+2. Closes the namespace.
+ ```cpp
+ } // namespace nlohmann
+ } // json_v3_11_0
+ ```
+
+## Default definition
+
+The default definitions open and close the `nlohmann` as well as an inline
+namespace.
+
+When these macros are not defined, the library will define them to their
+default definitions.
+
+## See also
+
+- [NLOHMANN_JSON_NAMESPACE](nlohmann_json_namespace.md)
+
+## Version history
+
+- Added in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md b/docs/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md
new file mode 100644
index 0000000..b7204a8
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/nlohmann_json_serialize_enum.md
@@ -0,0 +1,85 @@
+# 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)
+- [`JSON_DISABLE_ENUM_SERIALIZATION`](json_disable_enum_serialization.md)
+
+## Version history
+
+Added in version 3.4.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
new file mode 100644
index 0000000..d7a3142
--- /dev/null
+++ b/docs/mkdocs/docs/api/macros/nlohmann_json_version_major.md
@@ -0,0 +1,40 @@
+# 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.
+
+## 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
+- [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/api/basic_json/operator_gtgt.md b/docs/mkdocs/docs/api/operator_gtgt.md
similarity index 65%
rename from doc/mkdocs/docs/api/basic_json/operator_gtgt.md
rename to docs/mkdocs/docs/api/operator_gtgt.md
index 97c2f0b..98d575a 100644
--- a/doc/mkdocs/docs/api/basic_json/operator_gtgt.md
+++ b/docs/mkdocs/docs/api/operator_gtgt.md
@@ -1,4 +1,4 @@
-# operator>>(basic_json)
+# <small>nlohmann::</small>operator>>(basic_json)
```cpp
std::istream& operator>>(std::istream& i, basic_json& j);
@@ -20,10 +20,10 @@
## Exceptions
-- Throws [`parse_error.101`](../../home/exceptions.md#jsonexceptionparse_error101) in case of an unexpected token.
-- Throws [`parse_error.102`](../../home/exceptions.md#jsonexceptionparse_error102) if to_unicode fails or surrogate
+- Throws [`parse_error.101`](../home/exceptions.md#jsonexceptionparse_error101) in case of an unexpected token.
+- Throws [`parse_error.102`](../home/exceptions.md#jsonexceptionparse_error102) if to_unicode fails or surrogate
error.
-- Throws [`parse_error.103`](../../home/exceptions.md#jsonexceptionparse_error103) if to_unicode fails.
+- Throws [`parse_error.103`](../home/exceptions.md#jsonexceptionparse_error103) if to_unicode fails.
## Complexity
@@ -33,6 +33,12 @@
A UTF-8 byte order mark is silently ignored.
+!!! warning "Deprecation"
+
+ This function replaces function `#!cpp std::istream& operator<<(basic_json& j, std::istream& i)` which has
+ been deprecated in version 3.0.0. It will be removed in version 4.0.0. Please replace calls like `#!cpp j << i;`
+ with `#!cpp i >> j;`.
+
## Examples
??? example
@@ -51,15 +57,9 @@
## See also
-- [accept](accept.md) - check if the input is valid JSON
-- [parse](parse.md) - deserialize from a compatible input
+- [accept](basic_json/accept.md) - check if the input is valid JSON
+- [parse](basic_json/parse.md) - deserialize from a compatible input
## Version history
-- Added in version 1.0.0
-
-!!! warning "Deprecation"
-
- This function replaces function `#!cpp std::istream& operator<<(basic_json& j, std::istream& i)` which has
- been deprecated in version 3.0.0. It will be removed in version 4.0.0. Please replace calls like `#!cpp j << i;`
- with `#!cpp i >> j;`.
+- Added in version 1.0.0. Deprecated in version 3.0.0.
diff --git a/docs/mkdocs/docs/api/operator_literal_json.md b/docs/mkdocs/docs/api/operator_literal_json.md
new file mode 100644
index 0000000..330729d
--- /dev/null
+++ b/docs/mkdocs/docs/api/operator_literal_json.md
@@ -0,0 +1,59 @@
+# <small>nlohmann::</small>operator""_json
+
+```cpp
+json operator "" _json(const char* s, std::size_t n);
+```
+
+This operator implements a user-defined string literal for JSON objects. It can be used by adding `#!cpp _json` to a
+string literal and returns a [`json`](json.md) object if no parse error occurred.
+
+Use any of the following lines to bring the operator into scope:
+```cpp
+using namespace nlohmann::literals;
+using namespace nlohmann::json_literals;
+using namespace nlohmann::literals::json_literals;
+using namespace nlohmann;
+```
+
+Alternatively, define [`JSON_USE_GLOBAL_UDLS`](macros/json_use_global_udls.md) to make them available in the global
+namespace.
+## Parameters
+
+`s` (in)
+: a string representation of a JSON object
+
+`n` (in)
+: length of string `s`
+
+## Return value
+
+[`json`](json.md) value parsed from `s`
+
+## Exceptions
+
+The function can throw anything that [`parse(s, s+n)`](basic_json/parse.md) would throw.
+
+## Complexity
+
+Linear.
+
+## Examples
+
+??? example
+
+ The following code shows how to create JSON values from string literals.
+
+ ```cpp
+ --8<-- "examples/operator_literal_json.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator_literal_json.output"
+ ```
+
+## Version history
+
+- Added in version 1.0.0.
+- Moved to namespace `nlohmann::literals::json_literals` in 3.11.0.
diff --git a/docs/mkdocs/docs/api/operator_literal_json_pointer.md b/docs/mkdocs/docs/api/operator_literal_json_pointer.md
new file mode 100644
index 0000000..7c788db
--- /dev/null
+++ b/docs/mkdocs/docs/api/operator_literal_json_pointer.md
@@ -0,0 +1,63 @@
+# <small>nlohmann::</small>operator""_json_pointer
+
+```cpp
+json_pointer operator "" _json_pointer(const char* s, std::size_t n);
+```
+
+This operator implements a user-defined string literal for JSON Pointers. It can be used by adding `#!cpp _json_pointer`
+to a string literal and returns a [`json_pointer`](json_pointer/index.md) object if no parse error occurred.
+
+Use any of the following lines to bring the operator into scope:
+```cpp
+using namespace nlohmann::literals;
+using namespace nlohmann::json_literals;
+using namespace nlohmann::literals::json_literals;
+using namespace nlohmann;
+```
+
+Alternatively, define [`JSON_USE_GLOBAL_UDLS`](macros/json_use_global_udls.md) to make them available in the global
+namespace.
+## Parameters
+
+`s` (in)
+: a string representation of a JSON Pointer
+
+`n` (in)
+: length of string `s`
+
+## Return value
+
+[`json_pointer`](json_pointer/index.md) value parsed from `s`
+
+## Exceptions
+
+The function can throw anything that [`json_pointer::json_pointer`](json_pointer/index.md) would throw.
+
+## Complexity
+
+Linear.
+
+## Examples
+
+??? example
+
+ The following code shows how to create JSON Pointers from string literals.
+
+ ```cpp
+ --8<-- "examples/operator_literal_json_pointer.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator_literal_json_pointer.output"
+ ```
+
+## See also
+
+- [json_pointer](json_pointer/index.md) - type to represent JSON Pointers
+
+## Version history
+
+- Added in version 2.0.0.
+- Moved to namespace `nlohmann::literals::json_literals` in 3.11.0.
diff --git a/docs/mkdocs/docs/api/operator_ltlt.md b/docs/mkdocs/docs/api/operator_ltlt.md
new file mode 100644
index 0000000..ea85771
--- /dev/null
+++ b/docs/mkdocs/docs/api/operator_ltlt.md
@@ -0,0 +1,86 @@
+# <small>nlohmann::</small>operator<<(basic_json), <small>nlohmann::</small>operator<<(json_pointer)
+
+```cpp
+std::ostream& operator<<(std::ostream& o, const basic_json& j); // (1)
+
+std::ostream& operator<<(std::ostream& o, const json_pointer& ptr); // (2)
+```
+
+1. Serialize the given JSON value `j` to the output stream `o`. The JSON value will be serialized using the
+ [`dump`](basic_json/dump.md) member function.
+ - The indentation of the output can be controlled with the member variable `width` of the output stream `o`. For
+ instance, using the manipulator `std::setw(4)` on `o` sets the indentation level to `4` and the serialization
+ result is the same as calling `dump(4)`.
+ - The indentation character can be controlled with the member variable `fill` of the output stream `o`.
+ For instance, the manipulator `std::setfill('\\t')` sets indentation to use a tab character rather than the
+ default space character.
+2. Write a string representation of the given JSON pointer `ptr` to the output stream `o`. The string representation is
+ obtained using the [`to_string`](json_pointer/to_string.md) member function.
+
+## Parameters
+
+`o` (in, out)
+: stream to write to
+
+`j` (in)
+: JSON value to serialize
+
+`ptr` (in)
+: JSON pointer to write
+
+## Return value
+
+the stream `o`
+
+## Exceptions
+
+1. Throws [`type_error.316`](../home/exceptions.md#jsonexceptiontype_error316) if a string stored inside the JSON
+ value is not UTF-8 encoded. Note that unlike the [`dump`](basic_json/dump.md) member functions, no `error_handler` can be set.
+2. None.
+
+## Complexity
+
+Linear.
+
+## Notes
+
+!!! warning "Deprecation"
+
+ Function `#!cpp std::ostream& operator<<(std::ostream& o, const basic_json& j)` replaces function
+ `#!cpp std::ostream& operator>>(const basic_json& j, std::ostream& o)` which has been deprecated in version 3.0.0.
+ It will be removed in version 4.0.0. Please replace calls like `#!cpp j >> o;` with `#!cpp o << j;`.
+
+## Examples
+
+??? example "Example: (1) serialize JSON value to stream"
+
+ The example below shows the serialization with different parameters to `width` to adjust the indentation level.
+
+ ```cpp
+ --8<-- "examples/operator_ltlt__basic_json.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator_ltlt__basic_json.output"
+ ```
+
+??? example "Example: (2) write JSON pointer to stream"
+
+ The example below shows how to write a JSON pointer to a stream.
+
+ ```cpp
+ --8<-- "examples/operator_ltlt__json_pointer.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/operator_ltlt__json_pointer.output"
+ ```
+## Version history
+
+1. Added in version 1.0.0. Added support for indentation character and deprecated
+ `#!cpp std::ostream& operator>>(const basic_json& j, std::ostream& o)` in version 3.0.0.
+3. Added in version 3.11.0.
diff --git a/docs/mkdocs/docs/api/ordered_json.md b/docs/mkdocs/docs/api/ordered_json.md
new file mode 100644
index 0000000..7cfd9f4
--- /dev/null
+++ b/docs/mkdocs/docs/api/ordered_json.md
@@ -0,0 +1,32 @@
+# <small>nlohmann::</small>ordered_json
+
+```cpp
+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
+
+Since version 3.9.0.
diff --git a/doc/mkdocs/docs/api/ordered_map.md b/docs/mkdocs/docs/api/ordered_map.md
similarity index 88%
rename from doc/mkdocs/docs/api/ordered_map.md
rename to docs/mkdocs/docs/api/ordered_map.md
index 74b248f..160b85c 100644
--- a/doc/mkdocs/docs/api/ordered_map.md
+++ b/docs/mkdocs/docs/api/ordered_map.md
@@ -32,6 +32,12 @@
- **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 @@
## 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/docs/mkdocs/docs/css/custom.css b/docs/mkdocs/docs/css/custom.css
new file mode 100644
index 0000000..7a1008b
--- /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/doc/mkdocs/docs/features/arbitrary_types.md b/docs/mkdocs/docs/features/arbitrary_types.md
similarity index 68%
rename from doc/mkdocs/docs/features/arbitrary_types.md
rename to docs/mkdocs/docs/features/arbitrary_types.md
index fe80dc7..2d2e6f2 100644
--- a/doc/mkdocs/docs/features/arbitrary_types.md
+++ b/docs/mkdocs/docs/features/arbitrary_types.md
@@ -1,4 +1,4 @@
-# Arbitrary Types Conversions
+# Arbitrary Type Conversions
Every type can be serialized in JSON, not just STL containers and scalar types. Usually, you would do something along those lines:
@@ -77,7 +77,7 @@
* 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.
@@ -85,29 +85,34 @@
If you just want to serialize/deserialize some structs, the `to_json`/`from_json` functions can be a lot of boilerplate.
-There are two 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:
+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.
-- `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.
+- [`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 both macros, the first parameter is the name of the class/struct, and all remaining parameters name the members.
+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 `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE` or `NLOHMANN_DEFINE_TYPE_INTRUSIVE`.
+ - 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
The `to_json`/`from_json` functions for the `person` struct above can be created with:
-
+
```cpp
namespace ns {
NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(person, name, address, age)
}
```
-
+
Here is an example with private members, where `NLOHMANN_DEFINE_TYPE_INTRUSIVE` is needed:
-
+
```cpp
namespace ns {
class address {
@@ -115,7 +120,7 @@
std::string street;
int housenumber;
int postcode;
-
+
public:
NLOHMANN_DEFINE_TYPE_INTRUSIVE(address, street, housenumber, postcode)
};
@@ -150,30 +155,35 @@
```cpp
// partial specialization (full specialization works too)
-namespace nlohmann {
- template <typename T>
- struct adl_serializer<boost::optional<T>> {
- static void to_json(json& j, const boost::optional<T>& opt) {
- if (opt == boost::none) {
- j = nullptr;
- } else {
- j = *opt; // this will call adl_serializer<T>::to_json which will
- // find the free function to_json in T's namespace!
- }
+NLOHMANN_JSON_NAMESPACE_BEGIN
+template <typename T>
+struct adl_serializer<boost::optional<T>> {
+ static void to_json(json& j, const boost::optional<T>& opt) {
+ if (opt == boost::none) {
+ j = nullptr;
+ } else {
+ j = *opt; // this will call adl_serializer<T>::to_json which will
+ // find the free function to_json in T's namespace!
}
+ }
- static void from_json(const json& j, boost::optional<T>& opt) {
- if (j.is_null()) {
- opt = boost::none;
- } else {
- opt = j.get<T>(); // same as above, but with
- // adl_serializer<T>::from_json
- }
+ static void from_json(const json& j, boost::optional<T>& opt) {
+ if (j.is_null()) {
+ opt = boost::none;
+ } else {
+ opt = j.get<T>(); // same as above, but with
+ // adl_serializer<T>::from_json
}
- };
-}
+ }
+};
+NLOHMANN_JSON_NAMESPACE_END
```
+!!! note "ABI compatibility"
+
+ Use [`NLOHMANN_JSON_NAMESPACE_BEGIN`](../api/macros/nlohmann_json_namespace_begin.md) and `NLOHMANN_JSON_NAMESPACE_END`
+ instead of `#!cpp namespace nlohmann { }` in code which may be linked with different versions of this library.
+
## How can I use `get()` for non-default constructible/non-copyable types?
There is a way, if your type is [MoveConstructible](https://en.cppreference.com/w/cpp/named_req/MoveConstructible). You will need to specialize the `adl_serializer` as well, but with a special `from_json` overload:
@@ -209,7 +219,7 @@
## 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:
diff --git a/docs/mkdocs/docs/features/assertions.md b/docs/mkdocs/docs/features/assertions.md
new file mode 100644
index 0000000..2bad62e
--- /dev/null
+++ b/docs/mkdocs/docs/features/assertions.md
@@ -0,0 +1,131 @@
+# 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.
+ ```
+
+### Reading from a null `FILE` pointer
+
+Reading from a null `#!cpp FILE` pointer is undefined behavior and yields a runtime assertion. This can happen when
+calling `#!cpp std::fopen` on a nonexistent file.
+
+??? example "Example 4: Uninitialized iterator"
+
+ The following code will trigger an assertion at runtime:
+
+ ```cpp
+ #include <nlohmann/json.hpp>
+
+ using json = nlohmann::json;
+
+ int main()
+ {
+ std::FILE* f = std::fopen("nonexistent_file.json", "r");
+ json j = json::parse(f);
+ }
+ ```
+
+ Output:
+
+ ```
+ Assertion failed: (m_file != nullptr), function file_input_adapter, file input_adapters.hpp, line 55.
+ ```
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 0000000..74b4499
--- /dev/null
+++ b/docs/mkdocs/docs/features/binary_formats/bjdata.md
@@ -0,0 +1,212 @@
+# 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, i.e., $2^{64}-1$ 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. Adopting 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"
+
+ Optimized formats for containers are supported via two parameters of
+ [`to_bjdata`](../../api/basic_json/to_bjdata.md):
+
+ - 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 of the number of elements in the container.
+
+!!! info "ND-array optimized format"
+
+ BJData extends UBJSON's optimized array **size** marker to support ND-arrays of
+ uniform numerical data types (referred to as *packed arrays*).
+ For example, the 2-D `uint8` integer array `[[1,2],[3,4],[5,6]]`, 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 to `[$U#[$i#i2 2 3 1 2 3 4 5 6`
+ or `[$U#[i2 i3] 1 2 3 4 5 6`.
+
+ To maintina type and size information, ND-arrays are converted to JSON objects following the
+ **annotated array format** (defined in the [JData specification (Draft 3)][JDataAAFmt]),
+ when parsed using [`from_bjdata`](../../api/basic_json/from_bjdata.md).
+ 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]
+ }
+ ```
+
+ Likewise, when a JSON object in the above form is serialzed using
+ [`to_bjdata`](../../api/basic_json/to_bjdata.md), it is automatically converted
+ into a compact BJData ND-array. The only exception is, that when the 1-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 does not yet support automatic detection of and
+ conversion from a nested JSON array input to a BJData ND-array.
+
+ [JDataAAFmt]: https://github.com/NeuroJSON/jdata/blob/master/JData_specification.md#annotated-storage-of-n-d-arrays)
+
+!!! 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 the serialization and the deserialization of 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/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 60%
rename from doc/mkdocs/docs/features/binary_formats/index.md
rename to docs/mkdocs/docs/features/binary_formats/index.md
index 3a969a5..e74290b 100644
--- a/doc/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 @@
| 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 @@
| Format | Binary values | Binary subtypes |
|-------------|---------------|-----------------|
+| BJData | not supported | not supported |
| BSON | supported | supported |
| CBOR | supported | supported |
| MessagePack | supported | supported |
@@ -35,11 +39,14 @@
| 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/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 65%
rename from doc/mkdocs/docs/features/binary_values.md
rename to docs/mkdocs/docs/features/binary_values.md
index c58834c..5ad6433 100644
--- a/doc/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 @@
"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 @@
### 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 @@
!!! 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 @@
### 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 @@
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 @@
### 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 @@
### 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 @@
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 @@
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/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/docs/mkdocs/docs/features/element_access/checked_access.md b/docs/mkdocs/docs/features/element_access/checked_access.md
new file mode 100644
index 0000000..c4023cc
--- /dev/null
+++ b/docs/mkdocs/docs/features/element_access/checked_access.md
@@ -0,0 +1,91 @@
+# Checked access: at
+
+## Overview
+
+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 "Read access"
+
+ Consider the following JSON value:
+
+ ```json
+ {
+ "name": "Mary Smith",
+ "age": 42,
+ "hobbies": ["hiking", "reading"]
+ }
+ ```
+
+ 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"` |
+
+The return value is a reference, so it can be modified by the original value.
+
+??? example "Write access"
+
+ ```cpp
+ j.at("name") = "John Smith";
+ ```
+
+ This code produces the following JSON value:
+
+ ```json
+ {
+ "name": "John Smith",
+ "age": 42,
+ "hobbies": ["hiking", "reading"]
+ }
+ ```
+
+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 "Accessing via invalid index or missing key"
+
+ ```cpp
+ j.at("hobbies").at(3) = "cooking";
+ ```
+
+ This code produces the following exception:
+
+ ```
+ [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`](../../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
+
+| 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 | `basic_json::out_of_range` exception is thrown | `basic_json::out_of_range` exception is thrown |
+| access to invalid array index | `basic_json::out_of_range` exception is thrown | `basic_json::out_of_range` exception is thrown |
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/docs/mkdocs/docs/features/element_access/unchecked_access.md b/docs/mkdocs/docs/features/element_access/unchecked_access.md
new file mode 100644
index 0000000..1bdea94
--- /dev/null
+++ b/docs/mkdocs/docs/features/element_access/unchecked_access.md
@@ -0,0 +1,111 @@
+# Unchecked access: operator[]
+
+## Overview
+
+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 "Read access"
+
+ Consider the following JSON value:
+
+ ```json
+ {
+ "name": "Mary Smith",
+ "age": 42,
+ "hobbies": ["hiking", "reading"]
+ }
+ ```
+
+ 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"` |
+
+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 "Write access"
+
+ ```cpp
+ j["name"] = "John Smith";
+ j["maidenName"] = "Jones";
+ ```
+
+ This code produces the following JSON value:
+
+ ```json
+ {
+ "name": "John Smith",
+ "maidenName": "Jones",
+ "age": 42,
+ "hobbies": ["hiking", "reading"]
+ }
+ ```
+
+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 "Filling up arrays with `#!json null` values"
+
+ ```cpp
+ j["hobbies"][0] = "running";
+ j["hobbies"][3] = "cooking";
+ ```
+
+ This code produces the following JSON value:
+
+ ```json
+ {
+ "name": "John Smith",
+ "maidenName": "Jones",
+ "age": 42,
+ "hobbies": ["running", "reading", null, "cooking"]
+ }
+ ```
+
+## Notes
+
+!!! info "Design rationale"
+
+ The library behaves differently to `#!cpp std::vector` and `#!cpp std::map`:
+
+ - `#!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[]`](../../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.
+
+!!! 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). See the documentation
+ on [runtime assertions](../assertions.md) for more information.
+
+!!! failure "Exceptions"
+
+ `operator[]` 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_error305) is thrown.
+
+## 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**; [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/docs/mkdocs/docs/features/enum_conversion.md
similarity index 67%
rename from doc/mkdocs/docs/features/enum_conversion.md
rename to docs/mkdocs/docs/features/enum_conversion.md
index 8f474a7..59ffbd5 100644
--- a/doc/mkdocs/docs/features/enum_conversion.md
+++ b/docs/mkdocs/docs/features/enum_conversion.md
@@ -24,8 +24,8 @@
})
```
-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 @@
## 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:
@@ -57,3 +58,4 @@
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/doc/mkdocs/docs/features/iterators.md b/docs/mkdocs/docs/features/iterators.md
similarity index 98%
rename from doc/mkdocs/docs/features/iterators.md
rename to docs/mkdocs/docs/features/iterators.md
index 46f28f1..ce627e0 100644
--- a/doc/mkdocs/docs/features/iterators.md
+++ b/docs/mkdocs/docs/features/iterators.md
@@ -113,7 +113,7 @@
```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/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/docs/mkdocs/docs/features/json_pointer.md b/docs/mkdocs/docs/features/json_pointer.md
new file mode 100644
index 0000000..a3980b4
--- /dev/null
+++ b/docs/mkdocs/docs/features/json_pointer.md
@@ -0,0 +1,126 @@
+# JSON Pointer
+
+## Introduction
+
+The library supports **JSON Pointer** ([RFC 6901](https://tools.ietf.org/html/rfc6901)) as alternative means to address
+structured values. A JSON Pointer is a string that identifies a specific value withing a JSON document.
+
+Consider the following JSON document
+
+```json
+{
+ "array": ["A", "B", "C"],
+ "nested": {
+ "one": 1,
+ "two": 2,
+ "three": [true, false]
+ }
+}
+```
+
+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]}}` |
+| `/array` | `#!json ["A","B","C"]` |
+| `/array/0` | `#!json A` |
+| `/array/1` | `#!json B` |
+| `/array/2` | `#!json C` |
+| `/nested` | `#!json {"one":1,"two":2,"three":[true,false]}` |
+| `/nested/one` | `#!json 1` |
+| `/nested/two` | `#!json 2` |
+| `/nested/three` | `#!json [true,false]` |
+| `/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:
+
+```cpp
+json::json_pointer p = "/nested/one";
+```
+
+Furthermore, a user-defined string literal can be used to achieve the same result:
+
+```cpp
+auto p = "/nested/one"_json_pointer;
+```
+
+The escaping rules of [RFC 6901](https://tools.ietf.org/html/rfc6901) are implemented. See the
+[constructor documentation](../api/json_pointer/json_pointer.md) for more information.
+
+## Value access
+
+JSON Pointers can be used in the [`at`](../api/basic_json/at.md), [`operator[]`](../api/basic_json/operator%5B%5D.md),
+and [`value`](../api/basic_json/value.md) functions just like object keys or array indices.
+
+```cpp
+// the JSON value from above
+auto j = json::parse(R"({
+ "array": ["A", "B", "C"],
+ "nested": {
+ "one": 1,
+ "two": 2,
+ "three": [true, false]
+ }
+})");
+
+// access values
+auto val = j["/"_json_pointer]; // {"array":["A","B","C"],...}
+auto val1 = j["/nested/one"_json_pointer]; // 1
+auto val2 = j.at[json::json_pointer("/nested/three/1")]; // false
+auto val3 = j.value[json::json_pointer("/nested/four", 0)]; // 0
+```
+
+## Flatten / unflatten
+
+The library implements a function [`flatten`](../api/basic_json/flatten.md) to convert any JSON document into a JSON
+object where each key is a JSON Pointer and each value is a primitive JSON value (i.e., a string, boolean, number, or
+null).
+
+```cpp
+// the JSON value from above
+auto j = json::parse(R"({
+ "array": ["A", "B", "C"],
+ "nested": {
+ "one": 1,
+ "two": 2,
+ "three": [true, false]
+ }
+})");
+
+// create flattened value
+auto j_flat = j.flatten();
+```
+
+The resulting value `j_flat` is:
+
+```json
+{
+ "/array/0": "A",
+ "/array/1": "B",
+ "/array/2": "C",
+ "/nested/one": 1,
+ "/nested/two": 2,
+ "/nested/three/0": true,
+ "/nested/three/1": false
+}
+```
+
+The reverse function, [`unflatten`](../api/basic_json/unflatten.md) recreates the original value.
+
+```cpp
+auto j_original = j_flat.unflatten();
+```
+
+## See also
+
+- Class [`json_pointer`](../api/json_pointer/index.md)
+- Function [`flatten`](../api/basic_json/flatten.md)
+- Function [`unflatten`](../api/basic_json/unflatten.md)
+- [JSON Patch](json_patch.md)
diff --git a/docs/mkdocs/docs/features/macros.md b/docs/mkdocs/docs/features/macros.md
new file mode 100644
index 0000000..1be95d3
--- /dev/null
+++ b/docs/mkdocs/docs/features/macros.md
@@ -0,0 +1,153 @@
+# 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](assertions.md) of the library.
+
+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.
+
+See [full documentation of `JSON_CATCH_USER(exception)`](../api/macros/json_throw_user.md).
+
+## `JSON_DIAGNOSTICS`
+
+This macro enables extended diagnostics for exception messages. Possible values are `1` to enable or `0` to disable
+(default).
+
+When enabled, exception messages contain a [JSON Pointer](json_pointer.md) to the JSON value that triggered the
+exception, see [Extended diagnostic messages](../home/exceptions.md#extended-diagnostic-messages) for an example. 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.
+
+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`
+
+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.
+
+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`
+
+When compiling with C++17, the library provides conversions from and to `std::filesystem::path`. As compiler support
+for filesystem is limited, the library tries to detect whether `<filesystem>`/`std::filesystem` (`JSON_HAS_FILESYSTEM`)
+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`.
+
+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`.
+
+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
+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)).
+
+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.
+
+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.
+
+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.
+
+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.
+
+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.
+
+See [full documentation of `JSON_USE_IMPLICIT_CONVERSIONS`](../api/macros/json_use_implicit_conversions.md).
+
+## `NLOHMANN_DEFINE_TYPE_INTRUSIVE(type, member...)`
+
+This macro can be used to simplify the serialization/deserialization of types if (1) want to use a JSON object as
+serialization and (2) 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_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 [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. 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.
+
+See [full documentation of `NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT`](../api/macros/nlohmann_define_type_intrusive.md).
+
+## `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(type, member...)`
+
+This macro can be used to simplify the serialization/deserialization of types if (1) want to use a JSON object as
+serialization and (2) want to use the member variable names as object keys in that object.
+
+The macro is to be defined inside the namespace of the class/struct to create code for. Private members cannot be
+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 [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. 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.
+
+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.
+
+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/spec/v2.0.0.html).
+
+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/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/docs/mkdocs/docs/features/object_order.md b/docs/mkdocs/docs/features/object_order.md
new file mode 100644
index 0000000..3ee16a9
--- /dev/null
+++ b/docs/mkdocs/docs/features/object_order.md
@@ -0,0 +1,109 @@
+# Object Order
+
+The [JSON standard](https://tools.ietf.org/html/rfc8259.html) defines objects as "an unordered collection of zero or more name/value pairs". As such, an implementation does not need to preserve any specific order of object keys.
+
+## Default behavior: sort keys
+
+The default type `nlohmann::json` uses a `std::map` to store JSON objects, and thus stores object keys **sorted alphabetically**.
+
+??? example
+
+ ```cpp
+ #include <iostream>
+ #include "json.hpp"
+
+ using json = nlohmann::json;
+
+ int main()
+ {
+ json j;
+ j["one"] = 1;
+ j["two"] = 2;
+ j["three"] = 3;
+
+ std::cout << j.dump(2) << '\n';
+ }
+ ```
+
+ Output:
+
+ ```json
+ {
+ "one": 1,
+ "three": 3,
+ "two": 2
+ }
+ ```
+
+## Alternative behavior: preserve insertion order
+
+If you do want to preserve the **insertion order**, you can try the type [`nlohmann::ordered_json`](https://github.com/nlohmann/json/issues/2179).
+
+??? example
+
+ ```cpp
+ --8<-- "examples/ordered_json.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --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)).
+
+### Notes on parsing
+
+Note that you also need to call the right [`parse`](../api/basic_json/parse.md) function when reading from a file.
+Assume file `input.json` contains the JSON object above:
+
+```json
+{
+ "one": 1,
+ "two": 2,
+ "three": 3
+}
+```
+
+!!! success "Right way"
+
+ The following code correctly calls the `parse` function from `nlohmann::ordered_json`:
+
+ ```cpp
+ std::ifstream i("input.json");
+ auto j = nlohmann::ordered_json::parse(i);
+ std::cout << j.dump(2) << std::endl;
+ ```
+
+ The output will be:
+
+ ```json
+ {
+ "one": 1,
+ "two": 2,
+ "three": 3
+ }
+ ```
+
+??? failure "Wrong way"
+
+ The following code incorrectly calls the `parse` function from `nlohmann::json` which does not preserve the
+ insertion order, but sorts object keys. Assigning the result to `nlohmann::ordered_json` compiles, but does not
+ restore the order from the input file.
+
+ ```cpp
+ std::ifstream i("input.json");
+ nlohmann::ordered_json j = nlohmann::json::parse(i);
+ std::cout << j.dump(2) << std::endl;
+ ```
+
+ The output will be:
+
+ ```json
+ {
+ "one": 1,
+ "three": 3
+ "two": 2,
+ }
+ ```
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/docs/mkdocs/docs/features/parsing/json_lines.md b/docs/mkdocs/docs/features/parsing/json_lines.md
new file mode 100644
index 0000000..659d317
--- /dev/null
+++ b/docs/mkdocs/docs/features/parsing/json_lines.md
@@ -0,0 +1,49 @@
+# JSON Lines
+
+The [JSON Lines](https://jsonlines.org) format is a text format of newline-delimited JSON. In particular:
+
+1. The input must be UTF-8 encoded.
+2. Every line must be a valid JSON value.
+3. The line separator must be `\n`. As `\r` is silently ignored, `\r\n` is also supported.
+4. The final character may be `\n`, but is not required to be one.
+
+!!! example "JSON Text example"
+
+ ```json
+ {"name": "Gilbert", "wins": [["straight", "7♣"], ["one pair", "10♥"]]}
+ {"name": "Alexa", "wins": [["two pair", "4♠"], ["two pair", "9♠"]]}
+ {"name": "May", "wins": []}
+ {"name": "Deloise", "wins": [["three of a kind", "5♣"]]}
+ ```
+
+JSON Lines input with more than one value is treated as invalid JSON by the [`parse`](../../api/basic_json/parse.md) or
+[`accept`](../../api/basic_json/accept.md) functions. To process it line by line, functions like
+[`std::getline`](https://en.cppreference.com/w/cpp/string/basic_string/getline) can be used:
+
+!!! example "Example: Parse JSON Text input line by line"
+
+ The example below demonstrates how JSON Lines can be processed.
+
+ ```cpp
+ --8<-- "examples/json_lines.cpp"
+ ```
+
+ Output:
+
+ ```json
+ --8<-- "examples/json_lines.output"
+ ```
+
+!!! warning "Note"
+
+ Using [`operator>>`](../../api/operator_gtgt.md) like
+
+ ```cpp
+ json j;
+ while (input >> j)
+ {
+ std::cout << j << std::endl;
+ }
+ ```
+
+ with a JSON Lines input does not work, because the parser will try to parse one value after the last one.
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 99%
rename from doc/mkdocs/docs/features/types/number_handling.md
rename to docs/mkdocs/docs/features/types/number_handling.md
index dd65073..03d8c9c 100644
--- a/doc/mkdocs/docs/features/types/number_handling.md
+++ b/docs/mkdocs/docs/features/types/number_handling.md
@@ -275,7 +275,7 @@
### 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/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 92%
rename from doc/mkdocs/docs/home/exceptions.md
rename to docs/mkdocs/docs/home/exceptions.md
index 1241926..0ecf855 100644
--- a/doc/mkdocs/docs/home/exceptions.md
+++ b/docs/mkdocs/docs/home/exceptions.md
@@ -28,9 +28,9 @@
### 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 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.
@@ -72,7 +74,7 @@
To create better diagnostics messages, each JSON value needs a pointer to its parent value such that a global context (i.e., a path from the root value to the value that lead to the exception) can be created. That global context is provided as [JSON Pointer](../features/json_pointer.md).
-As this global context comes at the price of storing one additional pointer per JSON value and runtime overhead to maintain the parent relation, extended diagnostics are disabled by default. They can, however, be enabled by defining the preprocessor symbol [`JSON_DIAGNOSTICS`](../features/macros.md#json_diagnostics) to `1` before including `json.hpp`.
+As this global context comes at the price of storing one additional pointer per JSON value and runtime overhead to maintain the parent relation, extended diagnostics are disabled by default. They can, however, be enabled by defining the preprocessor symbol [`JSON_DIAGNOSTICS`](../api/macros/json_diagnostics.md) to `1` before including `json.hpp`.
??? example
@@ -88,6 +90,7 @@
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
@@ -268,7 +271,7 @@
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
@@ -292,19 +295,34 @@
### 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
@@ -371,7 +389,7 @@
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
@@ -535,7 +553,7 @@
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
@@ -548,7 +566,7 @@
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
@@ -561,7 +579,7 @@
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
@@ -574,7 +592,7 @@
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
@@ -617,7 +635,7 @@
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
@@ -640,7 +658,7 @@
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
@@ -715,7 +733,7 @@
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/doc/mkdocs/docs/home/faq.md b/docs/mkdocs/docs/home/faq.md
similarity index 97%
rename from doc/mkdocs/docs/home/faq.md
rename to docs/mkdocs/docs/home/faq.md
index c6a283b..878b8a6 100644
--- a/doc/mkdocs/docs/home/faq.md
+++ b/docs/mkdocs/docs/home/faq.md
@@ -126,7 +126,7 @@
Can I get the key of the object item that caused an exception?
-Yes, you can. Please define the symbol [`JSON_DIAGNOSTICS`](../features/macros.md#json_diagnostics) to get [extended diagnostics messages](exceptions.md#extended-diagnostic-messages).
+Yes, you can. Please define the symbol [`JSON_DIAGNOSTICS`](../api/macros/json_diagnostics.md) to get [extended diagnostics messages](exceptions.md#extended-diagnostic-messages).
## Serialization issues
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
Binary files differ
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
Binary files differ
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/docs/mkdocs/docs/integration/cmake.md b/docs/mkdocs/docs/integration/cmake.md
new file mode 100644
index 0000000..fc7d8d2
--- /dev/null
+++ b/docs/mkdocs/docs/integration/cmake.md
@@ -0,0 +1,172 @@
+# CMake
+
+## Integration
+
+You can use the `nlohmann_json::nlohmann_json` interface target in CMake. This target populates the appropriate usage
+requirements for [`INTERFACE_INCLUDE_DIRECTORIES`](https://cmake.org/cmake/help/latest/prop_tgt/INTERFACE_INCLUDE_DIRECTORIES.html)
+to point to the appropriate include directories and [`INTERFACE_COMPILE_FEATURES`](https://cmake.org/cmake/help/latest/prop_tgt/INTERFACE_COMPILE_FEATURES.html)
+for the necessary C++11 flags.
+
+### External
+
+To use this library from a CMake project, you can locate it directly with [`find_package()`](https://cmake.org/cmake/help/latest/command/find_package.html)
+and use the namespaced imported target from the generated package configuration:
+
+!!! example
+
+ ```cmake title="CMakeLists.txt"
+ cmake_minimum_required(VERSION 3.1)
+ project(ExampleProject LANGUAGES CXX)
+
+ find_package(nlohmann_json 3.11.0 REQUIRED)
+
+ add_executable(example example.cpp)
+ target_link_libraries(example PRIVATE nlohmann_json::nlohmann_json)
+ ```
+
+The package configuration file, `nlohmann_jsonConfig.cmake`, can be used either from an install tree or directly out of
+the build tree.
+
+### Embedded
+
+To embed the library directly into an existing CMake project, place the entire source tree in a subdirectory and call
+`add_subdirectory()` in your `CMakeLists.txt` file.
+
+!!! example
+
+ ```cmake title="CMakeLists.txt"
+ cmake_minimum_required(VERSION 3.1)
+ project(ExampleProject LANGUAGES CXX)
+
+ # If you only include this third party in PRIVATE source files, you do not need to install it
+ # when your main project gets installed.
+ set(JSON_Install OFF CACHE INTERNAL "")
+
+ add_subdirectory(nlohmann_json)
+
+ add_executable(example example.cpp)
+ target_link_libraries(example PRIVATE nlohmann_json::nlohmann_json)
+ ```
+
+!!! note
+
+ Do not use `#!cmake include(nlohmann_json/CMakeLists.txt)`, since that carries with it unintended consequences that
+ will break the build. It is generally discouraged (although not necessarily well documented as such) to use
+ `#!cmake include(...)` for pulling in other CMake projects anyways.
+
+
+### Supporting Both
+
+To allow your project to support either an externally supplied or an embedded JSON library, you can use a pattern akin
+to the following.
+
+!!! example
+
+ ```cmake title="CMakeLists.txt"
+ project(ExampleProject LANGUAGES CXX)
+
+ option(EXAMPLE_USE_EXTERNAL_JSON "Use an external JSON library" OFF)
+
+ add_subdirectory(thirdparty)
+
+ add_executable(example example.cpp)
+
+ # Note that the namespaced target will always be available regardless of the import method
+ target_link_libraries(example PRIVATE nlohmann_json::nlohmann_json)
+ ```
+
+ ```cmake title="thirdparty/CMakeLists.txt"
+ if(EXAMPLE_USE_EXTERNAL_JSON)
+ find_package(nlohmann_json 3.11.0 REQUIRED)
+ else()
+ set(JSON_BuildTests OFF CACHE INTERNAL "")
+ add_subdirectory(nlohmann_json)
+ endif()
+ ```
+
+ `thirdparty/nlohmann_json` is then a complete copy of this source tree.
+
+
+### FetchContent
+
+Since CMake v3.11, [FetchContent](https://cmake.org/cmake/help/v3.11/module/FetchContent.html) can be used to
+automatically download a release as a dependency at configure type.
+
+!!! example
+
+ ```cmake title="CMakeLists.txt"
+ cmake_minimum_required(VERSION 3.11)
+ project(ExampleProject LANGUAGES CXX)
+
+ include(FetchContent)
+
+ FetchContent_Declare(json URL https://github.com/nlohmann/json/releases/download/v3.11.0/json.tar.xz)
+ FetchContent_MakeAvailable(json)
+
+ add_executable(example example.cpp)
+ target_link_libraries(example PRIVATE nlohmann_json::nlohmann_json)
+ ```
+
+!!! Note
+
+ It is recommended to use the URL approach described above which is supported as of version 3.10.0. It is also
+ possible to pass the Git repository like
+
+ ```cmake
+ FetchContent_Declare(json
+ GIT_REPOSITORY https://github.com/nlohmann/json
+ GIT_TAG v3.11.0
+ )
+ ```
+
+ However, the repository <https://github.com/nlohmann/json> download size is quite large. You might want to depend on
+ a smaller repository. For instance, you might want to replace the URL in the example by
+ <https://github.com/ArthurSonzogni/nlohmann_json_cmake_fetchcontent>.
+
+## CMake Options
+
+### `JSON_BuildTests`
+
+Build the unit tests when [`BUILD_TESTING`](https://cmake.org/cmake/help/latest/command/enable_testing.html) is enabled. This option is `ON` by default if the library's CMake project is the top project. That is, when integrating the library as described above, the test suite is not built unless explicitly switched on with this option.
+
+### `JSON_CI`
+
+Enable CI build targets. The exact targets are used during the several CI steps and are subject to change without notice. This option is `OFF` by default.
+
+### `JSON_Diagnostics`
+
+Enable [extended diagnostic messages](../home/exceptions.md#extended-diagnostic-messages) by defining macro [`JSON_DIAGNOSTICS`](../api/macros/json_diagnostics.md). This option is `OFF` by default.
+
+### `JSON_DisableEnumSerialization`
+
+Disable default `enum` serialization by defining the macro
+[`JSON_DISABLE_ENUM_SERIALIZATION`](../api/macros/json_disable_enum_serialization.md). This option is `OFF` by default.
+
+### `JSON_FastTests`
+
+Skip expensive/slow test suites. This option is `OFF` by default. Depends on `JSON_BuildTests`.
+
+### `JSON_GlobalUDLs`
+
+Place user-defined string literals in the global namespace by defining the macro
+[`JSON_USE_GLOBAL_UDLS`](../api/macros/json_use_global_udls.md). This option is `OFF` by default.
+
+### `JSON_ImplicitConversions`
+
+Enable implicit conversions by defining macro [`JSON_USE_IMPLICIT_CONVERSIONS`](../api/macros/json_use_implicit_conversions.md). This option is `ON` by default.
+
+### `JSON_Install`
+
+Install CMake targets during install step. This option is `ON` by default if the library's CMake project is the top project.
+
+### `JSON_MultipleHeaders`
+
+Use non-amalgamated version of the library. This option is `OFF` by default.
+
+### `JSON_SystemInclude`
+
+Treat the library headers like system headers (i.e., adding `SYSTEM` to the [`target_include_directories`](https://cmake.org/cmake/help/latest/command/target_include_directories.html) call) to checks for this library by tools like Clang-Tidy. This option is `OFF` by default.
+
+### `JSON_Valgrind`
+
+Execute test suite with [Valgrind](https://valgrind.org). This option is `OFF` by default. Depends on `JSON_BuildTests`.
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/docs/mkdocs/docs/integration/example.cpp b/docs/mkdocs/docs/integration/example.cpp
new file mode 100644
index 0000000..1a7ac4d
--- /dev/null
+++ b/docs/mkdocs/docs/integration/example.cpp
@@ -0,0 +1,10 @@
+#include <nlohmann/json.hpp>
+#include <iostream>
+#include <iomanip>
+
+using json = nlohmann::json;
+
+int main()
+{
+ std::cout << std::setw(4) << json::meta() << std::endl;
+}
diff --git a/docs/mkdocs/docs/integration/index.md b/docs/mkdocs/docs/integration/index.md
new file mode 100644
index 0000000..bfa94ae
--- /dev/null
+++ b/docs/mkdocs/docs/integration/index.md
@@ -0,0 +1,18 @@
+# Header only
+
+[`json.hpp`](https://github.com/nlohmann/json/blob/develop/single_include/nlohmann/json.hpp) is the single required
+file in `single_include/nlohmann` or [released here](https://github.com/nlohmann/json/releases). You need to add
+
+```cpp
+#include <nlohmann/json.hpp>
+
+// for convenience
+using json = nlohmann::json;
+```
+
+to the files you want to process JSON and set the necessary switches to enable C++11 (e.g., `-std=c++11` for GCC and
+Clang).
+
+You can further use file [`include/nlohmann/json_fwd.hpp`](https://github.com/nlohmann/json/blob/develop/include/nlohmann/json_fwd.hpp)
+for forward-declarations. The installation of `json_fwd.hpp` (as part of CMake's install step), can be achieved by
+setting `-DJSON_MultipleHeaders=ON`.
diff --git a/doc/mkdocs/docs/integration/package_managers.md b/docs/mkdocs/docs/integration/package_managers.md
similarity index 78%
rename from doc/mkdocs/docs/integration/package_managers.md
rename to docs/mkdocs/docs/integration/package_managers.md
index d98005d..c2fb1a7 100644
--- a/doc/mkdocs/docs/integration/package_managers.md
+++ b/docs/mkdocs/docs/integration/package_managers.md
@@ -6,6 +6,12 @@
--8<-- "integration/example.cpp"
```
+When executed, this program should create output similar to
+
+```json
+--8<-- "../../examples/meta.output"
+```
+
## Homebrew
If you are using OS X and [Homebrew](http://brew.sh), just type
@@ -26,11 +32,9 @@
1. Create the following file:
- === "example.cpp"
-
- ```cpp
- --8<-- "integration/example.cpp"
- ```
+ ```cpp title="example.cpp"
+ --8<-- "integration/example.cpp"
+ ```
2. Install the package
@@ -50,6 +54,8 @@
clang++ example.cpp -I/usr/local/Cellar/nlohmann-json/3.7.3/include -std=c++11 -o example
```
+:material-update: The [formula](https://formulae.brew.sh/formula/nlohmann-json) is updated automatically.
+
## Meson
If you are using the [Meson Build System](http://mesonbuild.com), add this source tree as a [meson subproject](https://mesonbuild.com/Subprojects.html#using-a-subproject). You may also use the `include.zip` published in this project's [Releases](https://github.com/nlohmann/json/releases) to reduce the size of the vendored source tree. Alternatively, you can get a wrap file by downloading it from [Meson WrapDB](https://wrapdb.mesonbuild.com/nlohmann_json), or simply use `meson wrap install nlohmann_json`. Please see the meson project for any issues regarding the packaging.
@@ -64,24 +70,17 @@
1. Create the following files:
- === "Conanfile.txt"
-
- ```ini
- --8<-- "integration/conan/Conanfile.txt"
- ```
+ ```ini title="Conanfile.txt"
+ --8<-- "integration/conan/Conanfile.txt"
+ ```
- === "CMakeLists.txt"
+ ```cmake title="CMakeLists.txt"
+ --8<-- "integration/conan/CMakeLists.txt"
+ ```
- ```cmake
- --8<-- "integration/conan/CMakeLists.txt"
- ```
-
- === "example.cpp"
-
- ```cpp
- --8<-- "integration/conan/example.cpp"
- ```
-
+ ```cpp title="example.cpp"
+ --8<-- "integration/conan/example.cpp"
+ ```
2. Build:
@@ -93,6 +92,8 @@
cmake --build .
```
+:material-update: The [package](https://conan.io/center/nlohmann_json) is updated automatically.
+
## Spack
If you are using [Spack](https://www.spack.io/) to manage your dependencies, you can use the [`nlohmann-json` package](https://spack.readthedocs.io/en/latest/package_list.html#nlohmann-json). Please see the [spack project](https://github.com/spack/spack) for any issues regarding the packaging.
@@ -113,17 +114,13 @@
1. Create the following files:
- === "CMakeLists.txt"
-
- ```cmake
- --8<-- "integration/vcpkg/CMakeLists.txt"
- ```
-
- === "example.cpp"
-
- ```cpp
- --8<-- "integration/vcpkg/example.cpp"
- ```
+ ```cmake title="CMakeLists.txt"
+ --8<-- "integration/vcpkg/CMakeLists.txt"
+ ```
+
+ ```cpp title="example.cpp"
+ --8<-- "integration/vcpkg/example.cpp"
+ ```
2. Install package:
@@ -146,6 +143,8 @@
If you are using [cget](http://cget.readthedocs.io/en/latest/), you can install the latest development version with `cget install nlohmann/json`. A specific version can be installed with `cget install nlohmann/json@v3.1.0`. Also, the multiple header version can be installed by adding the `-DJSON_MultipleHeaders=ON` flag (i.e., `cget install nlohmann/json -DJSON_MultipleHeaders=ON`).
+:material-update: cget reads directly from the [GitHub repository](https://github.com/nlohmann/json) and is always up-to-date.
+
## CocoaPods
If you are using [CocoaPods](https://cocoapods.org), you can use the library by adding pod `"nlohmann_json", '~>3.1.2'` to your podfile (see [an example](https://bitbucket.org/benman/nlohmann_json-cocoapod/src/master/)). Please file issues [here](https://bitbucket.org/benman/nlohmann_json-cocoapod/issues?status=new&status=open).
@@ -162,19 +161,27 @@
If you are using [MSYS2](http://www.msys2.org/), you can use the [mingw-w64-nlohmann-json](https://packages.msys2.org/base/mingw-w64-nlohmann-json) package, just type `pacman -S mingw-w64-i686-nlohmann-json` or `pacman -S mingw-w64-x86_64-nlohmann-json` for installation. Please file issues [here](https://github.com/msys2/MINGW-packages/issues/new?title=%5Bnlohmann-json%5D) if you experience problems with the packages.
+:material-update: The [package](https://packages.msys2.org/base/mingw-w64-nlohmann-json) is updated automatically.
+
## MacPorts
If you are using [MacPorts](https://ports.macports.org), execute `sudo port install nlohmann-json` to install the [nlohmann-json](https://ports.macports.org/port/nlohmann-json/) package.
+:material-update: The [package](https://ports.macports.org/port/nlohmann-json/) is updated automatically.
+
## build2
-If you are using [`build2`](https://build2.org), you can use the [`nlohmann-json`](https://cppget.org/nlohmann-json) package from the public repository http://cppget.org or directly from the [package's sources repository](https://github.com/build2-packaging/nlohmann-json). In your project's `manifest` file, just add `depends: nlohmann-json` (probably with some [version constraints](https://build2.org/build2-toolchain/doc/build2-toolchain-intro.xhtml#guide-add-remove-deps)). If you are not familiar with using dependencies in `build2`, [please read this introduction](https://build2.org/build2-toolchain/doc/build2-toolchain-intro.xhtml).
+If you are using [`build2`](https://build2.org), you can use the [`nlohmann-json`](https://cppget.org/nlohmann-json) package from the public repository <http://cppget.org> or directly from the [package's sources repository](https://github.com/build2-packaging/nlohmann-json). In your project's `manifest` file, just add `depends: nlohmann-json` (probably with some [version constraints](https://build2.org/build2-toolchain/doc/build2-toolchain-intro.xhtml#guide-add-remove-deps)). If you are not familiar with using dependencies in `build2`, [please read this introduction](https://build2.org/build2-toolchain/doc/build2-toolchain-intro.xhtml).
Please file issues [here](https://github.com/build2-packaging/nlohmann-json) if you experience problems with the packages.
+:material-update: The [package](https://cppget.org/nlohmann-json) is updated automatically.
+
## wsjcpp
If you are using [`wsjcpp`](http://wsjcpp.org), you can use the command `wsjcpp install "https://github.com/nlohmann/json:develop"` to get the latest version. Note you can change the branch ":develop" to an existing tag or another branch.
+:material-update: wsjcpp reads directly from the [GitHub repository](https://github.com/nlohmann/json) and is always up-to-date.
+
## CPM.cmake
If you are using [`CPM.cmake`](https://github.com/TheLartians/CPM.cmake), you can check this [`example`](https://github.com/TheLartians/CPM.cmake/tree/master/examples/json). After [adding CPM script](https://github.com/TheLartians/CPM.cmake#adding-cpm) to your project, implement the following snippet to your CMake:
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 74%
rename from doc/mkdocs/mkdocs.yml
rename to docs/mkdocs/mkdocs.yml
index 542d4f1..65182ad 100644
--- a/doc/mkdocs/mkdocs.yml
+++ b/docs/mkdocs/mkdocs.yml
@@ -6,7 +6,7 @@
# 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 © 2013 - 2022 Niels Lohmann
@@ -42,6 +42,7 @@
- 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
@@ -60,9 +61,11 @@
- features/object_order.md
- Parsing:
- features/parsing/index.md
+ - features/parsing/json_lines.md
- 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:
@@ -95,6 +98,7 @@
- '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
@@ -106,6 +110,7 @@
- '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
@@ -149,17 +154,14 @@
- '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""_json': api/basic_json/operator_literal_json.md
- - 'operator""_json_pointer': api/basic_json/operator_literal_json_pointer.md
+ - 'operator<=>': api/basic_json/operator_spaceship.md
- 'out_of_range': api/basic_json/out_of_range.md
- 'other_error': api/basic_json/other_error.md
- 'parse': api/basic_json/parse.md
@@ -167,6 +169,7 @@
- 'parse_event_t': api/basic_json/parse_event_t.md
- 'parser_callback_t': api/basic_json/parser_callback_t.md
- 'patch': api/basic_json/patch.md
+ - 'patch_inplace': api/basic_json/patch_inplace.md
- 'push_back': api/basic_json/push_back.md
- 'rbegin': api/basic_json/rbegin.md
- 'rend': api/basic_json/rend.md
@@ -175,6 +178,7 @@
- 'string_t': api/basic_json/string_t.md
- 'swap': api/basic_json/swap.md
- 'std::swap<basic_json>': 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
@@ -204,12 +208,13 @@
- '(Constructor)': api/json_pointer/json_pointer.md
- 'back': api/json_pointer/back.md
- 'empty': api/json_pointer/empty.md
- - 'operator std::string': api/json_pointer/operator_string.md
+ - 'operator string_t': api/json_pointer/operator_string_t.md
- 'operator/': api/json_pointer/operator_slash.md
- 'operator/=': api/json_pointer/operator_slasheq.md
- 'parent_pointer': api/json_pointer/parent_pointer.md
- 'pop_back': api/json_pointer/pop_back.md
- 'push_back': api/json_pointer/push_back.md
+ - 'string_t': api/json_pointer/string_t.md
- 'to_string': api/json_pointer/to_string.md
- json_sax:
- 'Overview': api/json_sax/index.md
@@ -226,11 +231,47 @@
- 'start_array': api/json_sax/start_array.md
- 'start_object': api/json_sax/start_object.md
- 'string': api/json_sax/string.md
+ - 'operator<<(basic_json)': api/operator_ltlt.md
+ - 'operator<<(json_pointer)': api/operator_ltlt.md
+ - 'operator>>(basic_json)': api/operator_gtgt.md
+ - 'operator""_json': api/operator_literal_json.md
+ - 'operator""_json_pointer': api/operator_literal_json_pointer.md
- 'ordered_json': api/ordered_json.md
- '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_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
+ - '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
+ - '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_GLOBAL_UDLS': api/macros/json_use_global_udls.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
+ - 'NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT': api/macros/nlohmann_define_type_non_intrusive.md
+ - 'NLOHMANN_JSON_NAMESPACE': api/macros/nlohmann_json_namespace.md
+ - 'NLOHMANN_JSON_NAMESPACE_BEGIN': api/macros/nlohmann_json_namespace_begin.md
+ - 'NLOHMANN_JSON_NAMESPACE_END': api/macros/nlohmann_json_namespace_begin.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:
@@ -287,6 +328,17 @@
lang: en
- minify:
minify_html: true
+ - git-revision-date-localized
+ - redirects:
+ redirect_maps:
+ 'api/basic_json/operator_gtgt.md': api/operator_gtgt.md
+ 'api/basic_json/operator_ltlt.md': api/operator_ltlt.md
+ 'api/basic_json/operator_literal_json.md': api/operator_literal_json.md
+ 'api/basic_json/operator_literal_json_pointer.md': api/operator_literal_json_pointer.md
+ 'api/json_pointer/operator_string.md': api/json_pointer/operator_string_t.md
+
+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/docs/mkdocs/requirements.txt b/docs/mkdocs/requirements.txt
new file mode 100644
index 0000000..51fceb5
--- /dev/null
+++ b/docs/mkdocs/requirements.txt
@@ -0,0 +1,49 @@
+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-redirects==1.0.4
+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/docs/mkdocs/scripts/check_structure.py b/docs/mkdocs/scripts/check_structure.py
new file mode 100755
index 0000000..37c4ce3
--- /dev/null
+++ b/docs/mkdocs/scripts/check_structure.py
@@ -0,0 +1,169 @@
+#!/usr/bin/env python
+
+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_sections = [
+ 'Template parameters',
+ 'Specializations',
+ 'Iterator invalidation',
+ 'Requirements',
+ 'Member types',
+ 'Member functions',
+ 'Member variables',
+ 'Static functions',
+ 'Non-member functions',
+ 'Literals',
+ 'Helper classes',
+ 'Parameters',
+ 'Return value',
+ 'Exception safety',
+ 'Exceptions',
+ 'Complexity',
+ 'Possible implementation',
+ 'Default definition',
+ 'Notes',
+ 'Examples',
+ 'See also',
+ 'Version history'
+ ]
+
+ required_sections = [
+ 'Examples',
+ 'Version history'
+ ]
+
+ files = sorted(glob.glob('api/**/*.md', recursive=True))
+ for file in files:
+ with open(file) as file_content:
+ 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, original_line in enumerate(file_content.readlines()):
+ line = original_line.strip()
+
+ if line.startswith('# '):
+ h1sections += 1
+
+ # there should only be one top-level title
+ if h1sections > 1:
+ 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':
+ 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:
+ 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)
+
+ 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:
+ 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('//') and line not in ['// since C++20', '// until C++20']:
+ # 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}', f'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 == '':
+ 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} ({current_section})', f'"{untitled_admonition.group(2)}" admonitions should have a title')
+
+ previous_line = line
+
+ 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():
+ example_files = sorted(glob.glob('../../examples/*.cpp'))
+ markdown_files = sorted(glob.glob('**/*.md', recursive=True))
+
+ # check if every example file is used in at least one markdown file
+ for example_file in example_files:
+ example_file = os.path.join('examples', os.path.basename(example_file))
+
+ found = False
+ for markdown_file in markdown_files:
+ content = ' '.join(open(markdown_file).readlines())
+ if example_file in content:
+ found = True
+ break
+
+ if not found:
+ 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 * '-')
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
Binary files differ
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
Binary files differ
diff --git a/include/nlohmann/adl_serializer.hpp b/include/nlohmann/adl_serializer.hpp
index 030063e..bc222b4 100644
--- a/include/nlohmann/adl_serializer.hpp
+++ b/include/nlohmann/adl_serializer.hpp
@@ -1,15 +1,21 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
-#include <type_traits>
#include <utility>
+#include <nlohmann/detail/abi_macros.hpp>
#include <nlohmann/detail/conversions/from_json.hpp>
#include <nlohmann/detail/conversions/to_json.hpp>
#include <nlohmann/detail/meta/identity_tag.hpp>
-#include <nlohmann/detail/meta/type_traits.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
/// @sa https://json.nlohmann.me/api/adl_serializer/
template<typename ValueType, typename>
@@ -45,4 +51,5 @@
::nlohmann::to_json(j, std::forward<TargetType>(val));
}
};
-} // namespace nlohmann
+
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/byte_container_with_subtype.hpp b/include/nlohmann/byte_container_with_subtype.hpp
index 6e9e38d..4432d31 100644
--- a/include/nlohmann/byte_container_with_subtype.hpp
+++ b/include/nlohmann/byte_container_with_subtype.hpp
@@ -1,11 +1,20 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <cstdint> // uint8_t, uint64_t
#include <tuple> // tie
#include <utility> // move
-namespace nlohmann
-{
+#include <nlohmann/detail/abi_macros.hpp>
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
/// @brief an internal type for a backed binary type
/// @sa https://json.nlohmann.me/api/byte_container_with_subtype/
@@ -91,4 +100,4 @@
bool m_has_subtype = false;
};
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/abi_macros.hpp b/include/nlohmann/detail/abi_macros.hpp
new file mode 100644
index 0000000..19c5d51
--- /dev/null
+++ b/include/nlohmann/detail/abi_macros.hpp
@@ -0,0 +1,79 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+// This file contains all macro definitions affecting or depending on the ABI
+
+#ifndef JSON_SKIP_LIBRARY_VERSION_CHECK
+ #if defined(NLOHMANN_JSON_VERSION_MAJOR) && defined(NLOHMANN_JSON_VERSION_MINOR) && defined(NLOHMANN_JSON_VERSION_PATCH)
+ #if NLOHMANN_JSON_VERSION_MAJOR != 3 || NLOHMANN_JSON_VERSION_MINOR != 11 || NLOHMANN_JSON_VERSION_PATCH != 0
+ #warning "Already included a different version of the library!"
+ #endif
+ #endif
+#endif
+
+#define NLOHMANN_JSON_VERSION_MAJOR 3 // NOLINT(modernize-macro-to-enum)
+#define NLOHMANN_JSON_VERSION_MINOR 11 // NOLINT(modernize-macro-to-enum)
+#define NLOHMANN_JSON_VERSION_PATCH 0 // NOLINT(modernize-macro-to-enum)
+
+#ifndef JSON_DIAGNOSTICS
+ #define JSON_DIAGNOSTICS 0
+#endif
+
+#ifndef JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
+ #define JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON 0
+#endif
+
+#if JSON_DIAGNOSTICS
+ #define NLOHMANN_JSON_ABI_TAG_DIAGNOSTICS _diag
+#else
+ #define NLOHMANN_JSON_ABI_TAG_DIAGNOSTICS
+#endif
+
+#if JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
+ #define NLOHMANN_JSON_ABI_TAG_LEGACY_DISCARDED_VALUE_COMPARISON _ldvcmp
+#else
+ #define NLOHMANN_JSON_ABI_TAG_LEGACY_DISCARDED_VALUE_COMPARISON
+#endif
+
+#define NLOHMANN_JSON_ABI_PREFIX_EX(major, minor, patch) \
+ json_v ## major ## _ ## minor ## _ ## patch
+#define NLOHMANN_JSON_ABI_PREFIX(major, minor, patch) \
+ NLOHMANN_JSON_ABI_PREFIX_EX(major, minor, patch)
+
+#define NLOHMANN_JSON_ABI_CONCAT_EX(a, b, c) a ## b ## c
+#define NLOHMANN_JSON_ABI_CONCAT(a, b, c) \
+ NLOHMANN_JSON_ABI_CONCAT_EX(a, b, c)
+
+#define NLOHMANN_JSON_ABI_STRING \
+ NLOHMANN_JSON_ABI_CONCAT( \
+ NLOHMANN_JSON_ABI_PREFIX( \
+ NLOHMANN_JSON_VERSION_MAJOR, \
+ NLOHMANN_JSON_VERSION_MINOR, \
+ NLOHMANN_JSON_VERSION_PATCH), \
+ NLOHMANN_JSON_ABI_TAG_DIAGNOSTICS, \
+ NLOHMANN_JSON_ABI_TAG_LEGACY_DISCARDED_VALUE_COMPARISON)
+
+#ifndef NLOHMANN_JSON_NAMESPACE
+ #define NLOHMANN_JSON_NAMESPACE nlohmann::NLOHMANN_JSON_ABI_STRING
+#endif
+
+#ifndef NLOHMANN_JSON_NAMESPACE_BEGIN
+#define NLOHMANN_JSON_NAMESPACE_BEGIN \
+ namespace nlohmann \
+ { \
+ inline namespace NLOHMANN_JSON_ABI_STRING \
+ {
+#endif
+
+#ifndef NLOHMANN_JSON_NAMESPACE_END
+#define NLOHMANN_JSON_NAMESPACE_END \
+ } /* namespace (abi_string) */ \
+ } /* namespace nlohmann */
+#endif
diff --git a/include/nlohmann/detail/conversions/from_json.hpp b/include/nlohmann/detail/conversions/from_json.hpp
index 207d3e3..a0d37e9 100644
--- a/include/nlohmann/detail/conversions/from_json.hpp
+++ b/include/nlohmann/detail/conversions/from_json.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <algorithm> // transform
@@ -16,33 +24,21 @@
#include <nlohmann/detail/macro_scope.hpp>
#include <nlohmann/detail/meta/cpp_future.hpp>
#include <nlohmann/detail/meta/identity_tag.hpp>
+#include <nlohmann/detail/meta/std_fs.hpp>
#include <nlohmann/detail/meta/type_traits.hpp>
+#include <nlohmann/detail/string_concat.hpp>
#include <nlohmann/detail/value_t.hpp>
-#if JSON_HAS_EXPERIMENTAL_FILESYSTEM
-#include <experimental/filesystem>
-namespace nlohmann::detail
-{
-namespace std_fs = std::experimental::filesystem;
-} // namespace nlohmann::detail
-#elif JSON_HAS_FILESYSTEM
-#include <filesystem>
-namespace nlohmann::detail
-{
-namespace std_fs = std::filesystem;
-} // namespace nlohmann::detail
-#endif
-
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
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()))
{
- JSON_THROW(type_error::create(302, "type must be null, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be null, but is ", j.type_name()), &j));
}
n = nullptr;
}
@@ -80,82 +76,84 @@
case value_t::binary:
case value_t::discarded:
default:
- JSON_THROW(type_error::create(302, "type must be number, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be number, but is ", j.type_name()), &j));
}
}
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()))
{
- JSON_THROW(type_error::create(302, "type must be boolean, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be boolean, but is ", j.type_name()), &j));
}
b = *j.template get_ptr<const typename BasicJsonType::boolean_t*>();
}
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()))
{
- JSON_THROW(type_error::create(302, "type must be string, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be string, but is ", j.type_name()), &j));
}
s = *j.template get_ptr<const typename BasicJsonType::string_t*>();
}
template <
- typename BasicJsonType, typename ConstructibleStringType,
+ typename BasicJsonType, typename StringType,
enable_if_t <
- is_constructible_string_type<BasicJsonType, ConstructibleStringType>::value&&
- !std::is_same<typename BasicJsonType::string_t,
- ConstructibleStringType>::value,
- int > = 0 >
-void from_json(const BasicJsonType& j, ConstructibleStringType& s)
+ std::is_assignable<StringType&, const typename BasicJsonType::string_t>::value
+ && is_detected_exact<typename BasicJsonType::string_t::value_type, value_type_t, StringType>::value
+ && !std::is_same<typename BasicJsonType::string_t, StringType>::value
+ && !is_json_ref<StringType>::value, int > = 0 >
+inline void from_json(const BasicJsonType& j, StringType& s)
{
if (JSON_HEDLEY_UNLIKELY(!j.is_string()))
{
- JSON_THROW(type_error::create(302, "type must be string, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be string, but is ", j.type_name()), &j));
}
s = *j.template get_ptr<const typename BasicJsonType::string_t*>();
}
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);
}
+#if !JSON_DISABLE_ENUM_SERIALIZATION
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);
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,
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()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", j.type_name()), &j));
}
l.clear();
std::transform(j.rbegin(), j.rend(),
@@ -168,11 +166,11 @@
// 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()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", j.type_name()), &j));
}
l.resize(j.size());
std::transform(j.begin(), j.end(), std::begin(l),
@@ -193,7 +191,7 @@
}
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 +235,8 @@
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;
@@ -269,7 +267,7 @@
{
if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", j.type_name()), &j));
}
from_json_array_impl(j, arr, priority_tag<3> {});
@@ -288,18 +286,18 @@
{
if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", j.type_name()), &j));
}
return from_json_inplace_array_impl(std::forward<BasicJsonType>(j), tag, make_index_sequence<N> {});
}
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()))
{
- JSON_THROW(type_error::create(302, "type must be binary, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be binary, but is ", j.type_name()), &j));
}
bin = *j.template get_ptr<const typename BasicJsonType::binary_t*>();
@@ -307,11 +305,11 @@
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()))
{
- JSON_THROW(type_error::create(302, "type must be object, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be object, but is ", j.type_name()), &j));
}
ConstructibleObjectType ret;
@@ -339,7 +337,7 @@
!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))
{
@@ -371,7 +369,7 @@
case value_t::binary:
case value_t::discarded:
default:
- JSON_THROW(type_error::create(302, "type must be number, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be number, but is ", j.type_name()), &j));
}
}
@@ -389,7 +387,7 @@
}
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 +399,7 @@
}
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...> {});
}
@@ -412,7 +410,7 @@
{
if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", j.type_name()), &j));
}
return from_json_tuple_impl(std::forward<BasicJsonType>(j), std::forward<TupleRelated>(t), priority_tag<3> {});
@@ -421,18 +419,18 @@
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()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", j.type_name()), &j));
}
m.clear();
for (const auto& p : j)
{
if (JSON_HEDLEY_UNLIKELY(!p.is_array()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(p.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", p.type_name()), &j));
}
m.emplace(p.at(0).template get<Key>(), p.at(1).template get<Value>());
}
@@ -441,18 +439,18 @@
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()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", j.type_name()), &j));
}
m.clear();
for (const auto& p : j)
{
if (JSON_HEDLEY_UNLIKELY(!p.is_array()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(p.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", p.type_name()), &j));
}
m.emplace(p.at(0).template get<Key>(), p.at(1).template get<Value>());
}
@@ -460,11 +458,11 @@
#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()))
{
- JSON_THROW(type_error::create(302, "type must be string, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be string, but is ", j.type_name()), &j));
}
p = *j.template get_ptr<const typename BasicJsonType::string_t*>();
}
@@ -480,13 +478,20 @@
return from_json(j, std::forward<T>(val));
}
};
+
} // 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)
-} // namespace
-} // namespace nlohmann
+#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
+
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/conversions/to_chars.hpp b/include/nlohmann/detail/conversions/to_chars.hpp
index f6c729b..608b457 100644
--- a/include/nlohmann/detail/conversions/to_chars.hpp
+++ b/include/nlohmann/detail/conversions/to_chars.hpp
@@ -1,3 +1,12 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2009 Florian Loitsch <https://florian.loitsch.com/>
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <array> // array
@@ -9,8 +18,7 @@
#include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
@@ -1039,7 +1047,7 @@
return append_exponent(buf, n - 1);
}
-} // namespace dtoa_impl
+} // namespace dtoa_impl
/*!
@brief generates a decimal representation of the floating-point number value in [first, last).
@@ -1106,5 +1114,5 @@
return dtoa_impl::format_buffer(first, len, decimal_exponent, kMinExp, kMaxExp);
}
-} // namespace detail
-} // namespace nlohmann
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/conversions/to_json.hpp b/include/nlohmann/detail/conversions/to_json.hpp
index 7628ae0..e25e010 100644
--- a/include/nlohmann/detail/conversions/to_json.hpp
+++ b/include/nlohmann/detail/conversions/to_json.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <algorithm> // copy
@@ -9,30 +17,17 @@
#include <valarray> // valarray
#include <vector> // vector
-#include <nlohmann/detail/macro_scope.hpp>
#include <nlohmann/detail/iterators/iteration_proxy.hpp>
+#include <nlohmann/detail/macro_scope.hpp>
#include <nlohmann/detail/meta/cpp_future.hpp>
+#include <nlohmann/detail/meta/std_fs.hpp>
#include <nlohmann/detail/meta/type_traits.hpp>
#include <nlohmann/detail/value_t.hpp>
-#if JSON_HAS_EXPERIMENTAL_FILESYSTEM
-#include <experimental/filesystem>
-namespace nlohmann::detail
-{
-namespace std_fs = std::experimental::filesystem;
-} // namespace nlohmann::detail
-#elif JSON_HAS_FILESYSTEM
-#include <filesystem>
-namespace nlohmann::detail
-{
-namespace std_fs = std::filesystem;
-} // namespace nlohmann::detail
-#endif
-
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
//////////////////
// constructors //
//////////////////
@@ -267,55 +262,64 @@
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,
+ 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>
-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));
}
+#if !JSON_DISABLE_ENUM_SERIALIZATION
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));
}
+#endif // JSON_DISABLE_ENUM_SERIALIZATION
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 +332,39 @@
!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 +374,13 @@
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 +388,26 @@
// 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 +424,17 @@
};
} // 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)
-} // namespace
-} // namespace nlohmann
+#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
+
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/exceptions.hpp b/include/nlohmann/detail/exceptions.hpp
index b4b1804..b84094c 100644
--- a/include/nlohmann/detail/exceptions.hpp
+++ b/include/nlohmann/detail/exceptions.hpp
@@ -1,5 +1,14 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
+#include <cstddef> // nullptr_t
#include <exception> // exception
#include <stdexcept> // runtime_error
#include <string> // to_string
@@ -9,11 +18,15 @@
#include <nlohmann/detail/string_escape.hpp>
#include <nlohmann/detail/input/position_t.hpp>
#include <nlohmann/detail/macro_scope.hpp>
+#include <nlohmann/detail/meta/cpp_future.hpp>
+#include <nlohmann/detail/meta/type_traits.hpp>
+#include <nlohmann/detail/string_concat.hpp>
-namespace nlohmann
-{
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
////////////////
// exceptions //
////////////////
@@ -38,15 +51,20 @@
static std::string name(const std::string& ename, int id_)
{
- return "[json.exception." + ename + "." + std::to_string(id_) + "] ";
+ return concat("[json.exception.", ename, '.', std::to_string(id_), "] ");
+ }
+
+ static std::string diagnostics(std::nullptr_t /*leaf_element*/)
+ {
+ return "";
}
template<typename BasicJsonType>
- static std::string diagnostics(const BasicJsonType& leaf_element)
+ static std::string diagnostics(const BasicJsonType* leaf_element)
{
#if JSON_DIAGNOSTICS
std::vector<std::string> tokens;
- for (const auto* current = &leaf_element; current->m_parent != nullptr; current = current->m_parent)
+ for (const auto* current = leaf_element; current != nullptr && current->m_parent != nullptr; current = current->m_parent)
{
switch (current->m_parent->type())
{
@@ -94,11 +112,12 @@
return "";
}
- return "(" + std::accumulate(tokens.rbegin(), tokens.rend(), std::string{},
- [](const std::string & a, const std::string & b)
+ auto str = std::accumulate(tokens.rbegin(), tokens.rend(), std::string{},
+ [](const std::string & a, const std::string & b)
{
- return a + "/" + detail::escape(b);
- }) + ") ";
+ return concat(a, '/', detail::escape(b));
+ });
+ return concat('(', str, ") ");
#else
static_cast<void>(leaf_element);
return "";
@@ -124,20 +143,20 @@
@param[in] what_arg the explanatory string
@return parse_error object
*/
- template<typename BasicJsonType>
- static parse_error create(int id_, const position_t& pos, const std::string& what_arg, const BasicJsonType& context)
+ template<typename BasicJsonContext, enable_if_t<is_basic_json_context<BasicJsonContext>::value, int> = 0>
+ static parse_error create(int id_, const position_t& pos, const std::string& what_arg, BasicJsonContext context)
{
- std::string w = exception::name("parse_error", id_) + "parse error" +
- position_string(pos) + ": " + exception::diagnostics(context) + what_arg;
+ std::string w = concat(exception::name("parse_error", id_), "parse error",
+ position_string(pos), ": ", exception::diagnostics(context), what_arg);
return {id_, pos.chars_read_total, w.c_str()};
}
- template<typename BasicJsonType>
- static parse_error create(int id_, std::size_t byte_, const std::string& what_arg, const BasicJsonType& context)
+ template<typename BasicJsonContext, enable_if_t<is_basic_json_context<BasicJsonContext>::value, int> = 0>
+ static parse_error create(int id_, std::size_t byte_, const std::string& what_arg, BasicJsonContext context)
{
- std::string w = exception::name("parse_error", id_) + "parse error" +
- (byte_ != 0 ? (" at byte " + std::to_string(byte_)) : "") +
- ": " + exception::diagnostics(context) + what_arg;
+ std::string w = concat(exception::name("parse_error", id_), "parse error",
+ (byte_ != 0 ? (concat(" at byte ", std::to_string(byte_))) : ""),
+ ": ", exception::diagnostics(context), what_arg);
return {id_, byte_, w.c_str()};
}
@@ -158,8 +177,8 @@
static std::string position_string(const position_t& pos)
{
- return " at line " + std::to_string(pos.lines_read + 1) +
- ", column " + std::to_string(pos.chars_read_current_line);
+ return concat(" at line ", std::to_string(pos.lines_read + 1),
+ ", column ", std::to_string(pos.chars_read_current_line));
}
};
@@ -168,10 +187,10 @@
class invalid_iterator : public exception
{
public:
- template<typename BasicJsonType>
- static invalid_iterator create(int id_, const std::string& what_arg, const BasicJsonType& context)
+ template<typename BasicJsonContext, enable_if_t<is_basic_json_context<BasicJsonContext>::value, int> = 0>
+ static invalid_iterator create(int id_, const std::string& what_arg, BasicJsonContext context)
{
- std::string w = exception::name("invalid_iterator", id_) + exception::diagnostics(context) + what_arg;
+ std::string w = concat(exception::name("invalid_iterator", id_), exception::diagnostics(context), what_arg);
return {id_, w.c_str()};
}
@@ -186,10 +205,10 @@
class type_error : public exception
{
public:
- template<typename BasicJsonType>
- static type_error create(int id_, const std::string& what_arg, const BasicJsonType& context)
+ template<typename BasicJsonContext, enable_if_t<is_basic_json_context<BasicJsonContext>::value, int> = 0>
+ static type_error create(int id_, const std::string& what_arg, BasicJsonContext context)
{
- std::string w = exception::name("type_error", id_) + exception::diagnostics(context) + what_arg;
+ std::string w = concat(exception::name("type_error", id_), exception::diagnostics(context), what_arg);
return {id_, w.c_str()};
}
@@ -203,10 +222,10 @@
class out_of_range : public exception
{
public:
- template<typename BasicJsonType>
- static out_of_range create(int id_, const std::string& what_arg, const BasicJsonType& context)
+ template<typename BasicJsonContext, enable_if_t<is_basic_json_context<BasicJsonContext>::value, int> = 0>
+ static out_of_range create(int id_, const std::string& what_arg, BasicJsonContext context)
{
- std::string w = exception::name("out_of_range", id_) + exception::diagnostics(context) + what_arg;
+ std::string w = concat(exception::name("out_of_range", id_), exception::diagnostics(context), what_arg);
return {id_, w.c_str()};
}
@@ -220,10 +239,10 @@
class other_error : public exception
{
public:
- template<typename BasicJsonType>
- static other_error create(int id_, const std::string& what_arg, const BasicJsonType& context)
+ template<typename BasicJsonContext, enable_if_t<is_basic_json_context<BasicJsonContext>::value, int> = 0>
+ static other_error create(int id_, const std::string& what_arg, BasicJsonContext context)
{
- std::string w = exception::name("other_error", id_) + exception::diagnostics(context) + what_arg;
+ std::string w = concat(exception::name("other_error", id_), exception::diagnostics(context), what_arg);
return {id_, w.c_str()};
}
@@ -233,4 +252,4 @@
};
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/hash.hpp b/include/nlohmann/detail/hash.hpp
index 776b9ca..032afe0 100644
--- a/include/nlohmann/detail/hash.hpp
+++ b/include/nlohmann/detail/hash.hpp
@@ -1,14 +1,21 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <cstdint> // uint8_t
#include <cstddef> // size_t
#include <functional> // hash
-#include <nlohmann/detail/macro_scope.hpp>
+#include <nlohmann/detail/abi_macros.hpp>
#include <nlohmann/detail/value_t.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
@@ -119,4 +126,4 @@
}
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/input/binary_reader.hpp b/include/nlohmann/detail/input/binary_reader.hpp
index 65e0047..8ba66ac 100644
--- a/include/nlohmann/detail/input/binary_reader.hpp
+++ b/include/nlohmann/detail/input/binary_reader.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <algorithm> // generate_n
@@ -12,6 +20,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>
@@ -20,10 +29,10 @@
#include <nlohmann/detail/macro_scope.hpp>
#include <nlohmann/detail/meta/is_sax.hpp>
#include <nlohmann/detail/meta/type_traits.hpp>
+#include <nlohmann/detail/string_concat.hpp>
#include <nlohmann/detail/value_t.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
@@ -73,7 +82,7 @@
@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> {};
}
@@ -117,6 +126,7 @@
break;
case input_format_t::ubjson:
+ case input_format_t::bjdata:
result = parse_ubjson_internal();
break;
@@ -128,7 +138,7 @@
// 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();
}
@@ -139,8 +149,8 @@
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, "expected end of input; last byte: 0x" + get_token_string(), "value"), BasicJsonType()));
+ return sax->parse_error(chars_read, get_token_string(), parse_error::create(110, chars_read,
+ exception_message(input_format, concat("expected end of input; last byte: 0x", get_token_string()), "value"), nullptr));
}
}
@@ -216,7 +226,8 @@
if (JSON_HEDLEY_UNLIKELY(len < 1))
{
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::bson, "string length must be at least 1, is " + std::to_string(len), "string"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+ exception_message(input_format_t::bson, concat("string length must be at least 1, is ", std::to_string(len)), "string"), nullptr));
}
return get_string(input_format_t::bson, len - static_cast<NumberType>(1), result) && get() != std::char_traits<char_type>::eof();
@@ -237,7 +248,8 @@
if (JSON_HEDLEY_UNLIKELY(len < 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_t::bson, "byte array length cannot be negative, is " + std::to_string(len), "binary"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+ exception_message(input_format_t::bson, concat("byte array length cannot be negative, is ", std::to_string(len)), "binary"), nullptr));
}
// All BSON binary values have a subtype
@@ -319,7 +331,9 @@
{
std::array<char, 3> cr{{}};
static_cast<void>((std::snprintf)(cr.data(), cr.size(), "%.2hhX", static_cast<unsigned char>(element_type))); // NOLINT(cppcoreguidelines-pro-type-vararg,hicpp-vararg)
- return sax->parse_error(element_type_parse_position, std::string(cr.data()), parse_error::create(114, element_type_parse_position, "Unsupported BSON record type 0x" + std::string(cr.data()), BasicJsonType()));
+ std::string cr_str{cr.data()};
+ return sax->parse_error(element_type_parse_position, cr_str,
+ parse_error::create(114, element_type_parse_position, concat("Unsupported BSON record type 0x", cr_str), nullptr));
}
}
}
@@ -611,7 +625,8 @@
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)
{
@@ -628,13 +643,13 @@
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)
@@ -665,7 +680,7 @@
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)
{
@@ -682,13 +697,13 @@
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)
@@ -719,7 +734,8 @@
case cbor_tag_handler_t::error:
{
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::cbor, "invalid byte: 0x" + last_token, "value"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+ exception_message(input_format_t::cbor, concat("invalid byte: 0x", last_token), "value"), nullptr));
}
case cbor_tag_handler_t::ignore:
@@ -876,7 +892,8 @@
default: // anything else (0xFF is handled inside the other types)
{
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::cbor, "invalid byte: 0x" + last_token, "value"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+ exception_message(input_format_t::cbor, concat("invalid byte: 0x", last_token), "value"), nullptr));
}
}
}
@@ -971,7 +988,8 @@
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::cbor, "expected length specification (0x60-0x7B) or indefinite string type (0x7F); last byte: 0x" + last_token, "string"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read,
+ exception_message(input_format_t::cbor, concat("expected length specification (0x60-0x7B) or indefinite string type (0x7F); last byte: 0x", last_token), "string"), nullptr));
}
}
}
@@ -1070,7 +1088,8 @@
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::cbor, "expected length specification (0x40-0x5B) or indefinite binary array type (0x5F); last byte: 0x" + last_token, "binary"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read,
+ exception_message(input_format_t::cbor, concat("expected length specification (0x40-0x5B) or indefinite binary array type (0x5F); last byte: 0x", last_token), "binary"), nullptr));
}
}
}
@@ -1331,7 +1350,7 @@
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:
@@ -1350,7 +1369,7 @@
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:
@@ -1487,7 +1506,7 @@
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
@@ -1499,7 +1518,7 @@
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
@@ -1540,7 +1559,8 @@
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::msgpack, "invalid byte: 0x" + last_token, "value"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+ exception_message(input_format_t::msgpack, concat("invalid byte: 0x", last_token), "value"), nullptr));
}
}
}
@@ -1622,7 +1642,8 @@
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::msgpack, "expected length specification (0xA0-0xBF, 0xD9-0xDB); last byte: 0x" + last_token, "string"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read,
+ exception_message(input_format_t::msgpack, concat("expected length specification (0xA0-0xBF, 0xD9-0xDB); last byte: 0x", last_token), "string"), nullptr));
}
}
}
@@ -1833,7 +1854,7 @@
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;
}
@@ -1843,51 +1864,162 @@
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, "expected length type specification (U, i, I, l, L); last byte: 0x" + last_token, "string"), BasicJsonType()));
+ 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;
+ bool no_ndarray = true;
+
+ if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type, no_ndarray)))
+ {
+ 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, no_ndarray, 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, no_ndarray)))
+ {
+ return false;
+ }
+ dim.push_back(dimlen);
+ }
+ }
+ }
+ else
+ {
+ while (current != ']')
+ {
+ if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, no_ndarray, current)))
+ {
+ return false;
+ }
+ dim.push_back(dimlen);
+ get_ignore_noop();
+ }
+ }
+ return true;
}
/*!
@param[out] result determined size
+ @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 get_ubjson_size_value(std::size_t& result, bool& is_ndarray, 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;
}
@@ -1898,10 +2030,15 @@
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;
}
+ 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;
}
@@ -1909,10 +2046,15 @@
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;
}
+ 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;
}
@@ -1920,10 +2062,15 @@
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;
}
+ 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;
}
@@ -1931,7 +2078,32 @@
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;
+ }
+ 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));
+ }
+ if (!value_in_range_of<std::size_t>(number))
+ {
+ 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;
+ }
+
+ case 'u':
+ {
+ if (input_format != input_format_t::bjdata)
+ {
+ break;
+ }
+ std::uint16_t number{};
+ if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
{
return false;
}
@@ -1939,12 +2111,112 @@
return true;
}
- default:
+ case 'm':
{
- 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, "expected length type specification (U, i, I, l, L) after '#'; last byte: 0x" + last_token, "size"), BasicJsonType()));
+ if (input_format != input_format_t::bjdata)
+ {
+ break;
+ }
+ std::uint32_t number{};
+ if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
+ {
+ return false;
+ }
+ result = conditional_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;
+ }
+ if (!value_in_range_of<std::size_t>(number))
+ {
+ 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;
+ }
+
+ case '[':
+ {
+ if (input_format != input_format_t::bjdata)
+ {
+ 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 dimentional vector is not allowed", "size"), nullptr));
+ }
+ 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
+ {
+ 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())))
+ {
+ return false;
+ }
+ result = 1;
+ for (auto i : dim)
+ {
+ result *= i;
+ 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));
+ }
+ if (JSON_HEDLEY_UNLIKELY(!sax->number_unsigned(static_cast<number_unsigned_t>(i))))
+ {
+ return false;
+ }
+ }
+ is_ndarray = true;
+ 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));
}
/*!
@@ -1954,20 +2226,31 @@
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)
{
result.first = string_t::npos; // size
result.second = 0; // type
+ bool is_ndarray = false;
get_ignore_noop();
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( 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")))
{
return false;
}
@@ -1975,20 +2258,37 @@
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, "expected '#' after type information; last byte: 0x" + last_token, "size"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+ 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)
+ {
+ 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;
}
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)
+ {
+ 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;
}
return true;
@@ -2003,7 +2303,7 @@
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);
@@ -2016,43 +2316,125 @@
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':
@@ -2063,14 +2445,15 @@
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;
}
if (JSON_HEDLEY_UNLIKELY(current > 127))
{
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, "byte after 'C' must be in range 0x00..0x7F; last byte: 0x" + last_token, "char"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read,
+ 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);
@@ -2089,11 +2472,10 @@
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, "invalid byte: 0x" + last_token, "value"), BasicJsonType()));
- }
+ 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));
}
/*!
@@ -2107,6 +2489,52 @@
return false;
}
+ // 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.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))
+ {
+ 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;
+ }
+
+ if (size_and_type.second == 'C')
+ {
+ size_and_type.second = 'U';
+ }
+
+ 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)))
@@ -2169,6 +2597,14 @@
return false;
}
+ // 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)
+ {
+ 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;
if (size_and_type.first != string_t::npos)
{
@@ -2240,7 +2676,8 @@
{
// get size of following number string
std::size_t size{};
- auto res = get_ubjson_size_value(size);
+ bool no_ndarray = true;
+ auto res = get_ubjson_size_value(size, no_ndarray);
if (JSON_HEDLEY_UNLIKELY(!res))
{
return res;
@@ -2251,7 +2688,7 @@
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;
}
@@ -2269,7 +2706,8 @@
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, "invalid number text: " + number_lexer.get_token_string(), "high-precision number"), BasicJsonType()));
+ return sax->parse_error(chars_read, number_string, parse_error::create(115, chars_read,
+ exception_message(input_format, concat("invalid number text: ", number_lexer.get_token_string()), "high-precision number"), nullptr));
}
switch (result_number)
@@ -2295,7 +2733,8 @@
case token_type::end_of_input:
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, "invalid number text: " + number_lexer.get_token_string(), "high-precision number"), BasicJsonType()));
+ return sax->parse_error(chars_read, number_string, parse_error::create(115, chars_read,
+ exception_message(input_format, concat("invalid number text: ", number_lexer.get_token_string()), "high-precision number"), nullptr));
}
}
@@ -2344,6 +2783,8 @@
@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)
@@ -2359,7 +2800,7 @@
}
// 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);
}
@@ -2451,7 +2892,7 @@
if (JSON_HEDLEY_UNLIKELY(current == std::char_traits<char_type>::eof()))
{
return sax->parse_error(chars_read, "<end of file>",
- parse_error::create(110, chars_read, exception_message(format, "unexpected end of input", context), BasicJsonType()));
+ parse_error::create(110, chars_read, exception_message(format, "unexpected end of input", context), nullptr));
}
return true;
}
@@ -2496,12 +2937,16 @@
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
}
- return error_msg + " " + context + ": " + detail;
+ return concat(error_msg, ' ', context, ": ", detail);
}
private:
@@ -2517,8 +2962,12 @@
/// 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;
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/input/input_adapters.hpp b/include/nlohmann/detail/input/input_adapters.hpp
index d196aec..1ae08ea 100644
--- a/include/nlohmann/detail/input/input_adapters.hpp
+++ b/include/nlohmann/detail/input/input_adapters.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <array> // array
@@ -18,12 +26,12 @@
#include <nlohmann/detail/iterators/iterator_traits.hpp>
#include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
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 //
@@ -42,7 +50,9 @@
JSON_HEDLEY_NON_NULL(2)
explicit file_input_adapter(std::FILE* f) noexcept
: m_file(f)
- {}
+ {
+ JSON_ASSERT(m_file != nullptr);
+ }
// make class move-only
file_input_adapter(const file_input_adapter&) = delete;
@@ -400,7 +410,7 @@
}
};
-} // namespace container_input_adapter_factory_impl
+} // namespace container_input_adapter_factory_impl
template<typename ContainerType>
typename container_input_adapter_factory_impl::container_input_adapter_factory<ContainerType>::adapter_type input_adapter(const ContainerType& container)
@@ -479,5 +489,6 @@
private:
contiguous_bytes_input_adapter ia;
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/input/json_sax.hpp b/include/nlohmann/detail/input/json_sax.hpp
index fd9dab8..416d153 100644
--- a/include/nlohmann/detail/input/json_sax.hpp
+++ b/include/nlohmann/detail/input/json_sax.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <cstddef>
@@ -7,9 +15,9 @@
#include <nlohmann/detail/exceptions.hpp>
#include <nlohmann/detail/macro_scope.hpp>
+#include <nlohmann/detail/string_concat.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
/*!
@brief SAX interface
@@ -224,7 +232,7 @@
if (JSON_HEDLEY_UNLIKELY(len != static_cast<std::size_t>(-1) && len > ref_stack.back()->max_size()))
{
- JSON_THROW(out_of_range::create(408, "excessive object size: " + std::to_string(len), *ref_stack.back()));
+ JSON_THROW(out_of_range::create(408, concat("excessive object size: ", std::to_string(len)), ref_stack.back()));
}
return true;
@@ -232,6 +240,9 @@
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;
@@ -239,6 +250,9 @@
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;
@@ -250,7 +264,7 @@
if (JSON_HEDLEY_UNLIKELY(len != static_cast<std::size_t>(-1) && len > ref_stack.back()->max_size()))
{
- JSON_THROW(out_of_range::create(408, "excessive array size: " + std::to_string(len), *ref_stack.back()));
+ JSON_THROW(out_of_range::create(408, concat("excessive array size: ", std::to_string(len)), ref_stack.back()));
}
return true;
@@ -258,6 +272,9 @@
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;
@@ -405,7 +422,7 @@
// check object limit
if (ref_stack.back() && JSON_HEDLEY_UNLIKELY(len != static_cast<std::size_t>(-1) && len > ref_stack.back()->max_size()))
{
- JSON_THROW(out_of_range::create(408, "excessive object size: " + std::to_string(len), *ref_stack.back()));
+ JSON_THROW(out_of_range::create(408, concat("excessive object size: ", std::to_string(len)), ref_stack.back()));
}
return true;
@@ -475,7 +492,7 @@
// check array limit
if (ref_stack.back() && JSON_HEDLEY_UNLIKELY(len != static_cast<std::size_t>(-1) && len > ref_stack.back()->max_size()))
{
- JSON_THROW(out_of_range::create(408, "excessive array size: " + std::to_string(len), *ref_stack.back()));
+ JSON_THROW(out_of_range::create(408, concat("excessive array size: ", std::to_string(len)), ref_stack.back()));
}
return true;
@@ -706,6 +723,6 @@
return false;
}
};
-} // namespace detail
-} // namespace nlohmann
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/input/lexer.hpp b/include/nlohmann/detail/input/lexer.hpp
index d0c063a..371b19d 100644
--- a/include/nlohmann/detail/input/lexer.hpp
+++ b/include/nlohmann/detail/input/lexer.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <array> // array
@@ -14,10 +22,10 @@
#include <nlohmann/detail/input/position_t.hpp>
#include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
///////////
// lexer //
///////////
@@ -1619,5 +1627,6 @@
/// the decimal point
const char_int_type decimal_point_char = '.';
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/input/parser.hpp b/include/nlohmann/detail/input/parser.hpp
index 024dd04..106c66f 100644
--- a/include/nlohmann/detail/input/parser.hpp
+++ b/include/nlohmann/detail/input/parser.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <cmath> // isfinite
@@ -13,10 +21,10 @@
#include <nlohmann/detail/input/lexer.hpp>
#include <nlohmann/detail/macro_scope.hpp>
#include <nlohmann/detail/meta/is_sax.hpp>
+#include <nlohmann/detail/string_concat.hpp>
#include <nlohmann/detail/value_t.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
////////////
@@ -95,7 +103,7 @@
sdp.parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
parse_error::create(101, m_lexer.get_position(),
- exception_message(token_type::end_of_input, "value"), BasicJsonType()));
+ exception_message(token_type::end_of_input, "value"), nullptr));
}
// in case of an error, return discarded value
@@ -122,7 +130,7 @@
{
sdp.parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_of_input, "value"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_of_input, "value"), nullptr));
}
// in case of an error, return discarded value
@@ -160,7 +168,7 @@
{
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_of_input, "value"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_of_input, "value"), nullptr));
}
return result;
@@ -206,7 +214,7 @@
{
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::value_string, "object key"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::value_string, "object key"), nullptr));
}
if (JSON_HEDLEY_UNLIKELY(!sax->key(m_lexer.get_string())))
{
@@ -218,7 +226,7 @@
{
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::name_separator, "object separator"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::name_separator, "object separator"), nullptr));
}
// remember we are now inside an object
@@ -261,7 +269,7 @@
{
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- out_of_range::create(406, "number overflow parsing '" + m_lexer.get_token_string() + "'", BasicJsonType()));
+ out_of_range::create(406, concat("number overflow parsing '", m_lexer.get_token_string(), '\''), nullptr));
}
if (JSON_HEDLEY_UNLIKELY(!sax->number_float(res, m_lexer.get_string())))
@@ -331,7 +339,7 @@
// using "uninitialized" to avoid "expected" message
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::uninitialized, "value"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::uninitialized, "value"), nullptr));
}
case token_type::uninitialized:
@@ -345,7 +353,7 @@
{
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::literal_or_value, "value"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::literal_or_value, "value"), nullptr));
}
}
}
@@ -391,7 +399,7 @@
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_array, "array"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_array, "array"), nullptr));
}
// states.back() is false -> object
@@ -404,7 +412,7 @@
{
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::value_string, "object key"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::value_string, "object key"), nullptr));
}
if (JSON_HEDLEY_UNLIKELY(!sax->key(m_lexer.get_string())))
@@ -417,7 +425,7 @@
{
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::name_separator, "object separator"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::name_separator, "object separator"), nullptr));
}
// parse values
@@ -445,7 +453,7 @@
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_object, "object"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_object, "object"), nullptr));
}
}
@@ -461,24 +469,24 @@
if (!context.empty())
{
- error_msg += "while parsing " + context + " ";
+ error_msg += concat("while parsing ", context, ' ');
}
error_msg += "- ";
if (last_token == token_type::parse_error)
{
- error_msg += std::string(m_lexer.get_error_message()) + "; last read: '" +
- m_lexer.get_token_string() + "'";
+ error_msg += concat(m_lexer.get_error_message(), "; last read: '",
+ m_lexer.get_token_string(), '\'');
}
else
{
- error_msg += "unexpected " + std::string(lexer_t::token_type_name(last_token));
+ error_msg += concat("unexpected ", lexer_t::token_type_name(last_token));
}
if (expected != token_type::uninitialized)
{
- error_msg += "; expected " + std::string(lexer_t::token_type_name(expected));
+ error_msg += concat("; expected ", lexer_t::token_type_name(expected));
}
return error_msg;
@@ -496,4 +504,4 @@
};
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/input/position_t.hpp b/include/nlohmann/detail/input/position_t.hpp
index 14e9649..949d06d 100644
--- a/include/nlohmann/detail/input/position_t.hpp
+++ b/include/nlohmann/detail/input/position_t.hpp
@@ -1,11 +1,21 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <cstddef> // size_t
-namespace nlohmann
-{
+#include <nlohmann/detail/abi_macros.hpp>
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
/// struct to capture the start position of the current token
struct position_t
{
@@ -23,5 +33,5 @@
}
};
-} // namespace detail
-} // namespace nlohmann
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/iterators/internal_iterator.hpp b/include/nlohmann/detail/iterators/internal_iterator.hpp
index 2c81f72..24a559e 100644
--- a/include/nlohmann/detail/iterators/internal_iterator.hpp
+++ b/include/nlohmann/detail/iterators/internal_iterator.hpp
@@ -1,11 +1,20 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
+#include <nlohmann/detail/abi_macros.hpp>
#include <nlohmann/detail/iterators/primitive_iterator.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
/*!
@brief an iterator value
@@ -21,5 +30,6 @@
/// generic iterator for all other types
primitive_iterator_t primitive_iterator {};
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/iterators/iter_impl.hpp b/include/nlohmann/detail/iterators/iter_impl.hpp
index 434a62d..6152c94 100644
--- a/include/nlohmann/detail/iterators/iter_impl.hpp
+++ b/include/nlohmann/detail/iterators/iter_impl.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <iterator> // iterator, random_access_iterator_tag, bidirectional_iterator_tag, advance, next
@@ -11,10 +19,10 @@
#include <nlohmann/detail/meta/type_traits.hpp>
#include <nlohmann/detail/value_t.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
// forward declare, to be able to friend it later on
template<typename IteratorType> class iteration_proxy;
template<typename IteratorType> class iteration_proxy_value;
@@ -51,9 +59,12 @@
// 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 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:
-
/// 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
@@ -285,7 +296,7 @@
}
case value_t::null:
- JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", m_object));
case value_t::string:
case value_t::boolean:
@@ -301,7 +312,7 @@
return *m_object;
}
- JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", m_object));
}
}
}
@@ -343,7 +354,7 @@
return m_object;
}
- JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", m_object));
}
}
}
@@ -352,7 +363,7 @@
@brief post-increment (it++)
@pre The iterator is initialized; i.e. `m_object != nullptr`.
*/
- iter_impl const operator++(int) // NOLINT(readability-const-return-type)
+ iter_impl operator++(int)& // NOLINT(cert-dcl21-cpp)
{
auto result = *this;
++(*this);
@@ -403,7 +414,7 @@
@brief post-decrement (it--)
@pre The iterator is initialized; i.e. `m_object != nullptr`.
*/
- iter_impl const operator--(int) // NOLINT(readability-const-return-type)
+ iter_impl operator--(int)& // NOLINT(cert-dcl21-cpp)
{
auto result = *this;
--(*this);
@@ -460,7 +471,7 @@
// if objects are not the same, the comparison is undefined
if (JSON_HEDLEY_UNLIKELY(m_object != other.m_object))
{
- JSON_THROW(invalid_iterator::create(212, "cannot compare iterators of different containers", *m_object));
+ JSON_THROW(invalid_iterator::create(212, "cannot compare iterators of different containers", m_object));
}
JSON_ASSERT(m_object != nullptr);
@@ -505,7 +516,7 @@
// if objects are not the same, the comparison is undefined
if (JSON_HEDLEY_UNLIKELY(m_object != other.m_object))
{
- JSON_THROW(invalid_iterator::create(212, "cannot compare iterators of different containers", *m_object));
+ JSON_THROW(invalid_iterator::create(212, "cannot compare iterators of different containers", m_object));
}
JSON_ASSERT(m_object != nullptr);
@@ -513,7 +524,7 @@
switch (m_object->m_type)
{
case value_t::object:
- JSON_THROW(invalid_iterator::create(213, "cannot compare order of object iterators", *m_object));
+ JSON_THROW(invalid_iterator::create(213, "cannot compare order of object iterators", m_object));
case value_t::array:
return (m_it.array_iterator < other.m_it.array_iterator);
@@ -569,7 +580,7 @@
switch (m_object->m_type)
{
case value_t::object:
- JSON_THROW(invalid_iterator::create(209, "cannot use offsets with object iterators", *m_object));
+ JSON_THROW(invalid_iterator::create(209, "cannot use offsets with object iterators", m_object));
case value_t::array:
{
@@ -648,7 +659,7 @@
switch (m_object->m_type)
{
case value_t::object:
- JSON_THROW(invalid_iterator::create(209, "cannot use offsets with object iterators", *m_object));
+ JSON_THROW(invalid_iterator::create(209, "cannot use offsets with object iterators", m_object));
case value_t::array:
return m_it.array_iterator - other.m_it.array_iterator;
@@ -677,13 +688,13 @@
switch (m_object->m_type)
{
case value_t::object:
- JSON_THROW(invalid_iterator::create(208, "cannot use operator[] for object iterators", *m_object));
+ JSON_THROW(invalid_iterator::create(208, "cannot use operator[] for object iterators", m_object));
case value_t::array:
return *std::next(m_it.array_iterator, n);
case value_t::null:
- JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", m_object));
case value_t::string:
case value_t::boolean:
@@ -699,7 +710,7 @@
return *m_object;
}
- JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", m_object));
}
}
}
@@ -717,7 +728,7 @@
return m_it.object_iterator->first;
}
- JSON_THROW(invalid_iterator::create(207, "cannot use key() for non-object iterators", *m_object));
+ JSON_THROW(invalid_iterator::create(207, "cannot use key() for non-object iterators", m_object));
}
/*!
@@ -735,5 +746,6 @@
/// the actual iterator of the associated instance
internal_iterator<typename std::remove_const<BasicJsonType>::type> m_it {};
};
-} // namespace detail
-} // namespace nlohmann
+
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/iterators/iteration_proxy.hpp b/include/nlohmann/detail/iterators/iteration_proxy.hpp
index 9994b36..19bd3e6 100644
--- a/include/nlohmann/detail/iterators/iteration_proxy.hpp
+++ b/include/nlohmann/detail/iterators/iteration_proxy.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <cstddef> // size_t
@@ -6,13 +14,18 @@
#include <tuple> // tuple_size, get, tuple_element
#include <utility> // move
+#if JSON_HAS_RANGES
+ #include <ranges> // enable_borrowed_range
+#endif
+
+#include <nlohmann/detail/abi_macros.hpp>
#include <nlohmann/detail/meta/type_traits.hpp>
#include <nlohmann/detail/value_t.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
template<typename string_type>
void int_to_string( string_type& target, std::size_t value )
{
@@ -25,14 +38,14 @@
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 +53,30 @@
/// 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 +90,14 @@
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 +158,34 @@
{
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
@@ -157,8 +202,9 @@
{
return i.value();
}
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// The Addition to the STD Namespace is required to add
// Structured Bindings Support to the iteration_proxy_value class
@@ -166,6 +212,7 @@
// And see https://github.com/nlohmann/json/pull/1391
namespace std
{
+
#if defined(__clang__)
// Fix: https://github.com/nlohmann/json/issues/1401
#pragma clang diagnostic push
@@ -186,4 +233,10 @@
#if defined(__clang__)
#pragma clang diagnostic pop
#endif
-} // namespace std
+
+} // 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/iterators/iterator_traits.hpp b/include/nlohmann/detail/iterators/iterator_traits.hpp
index da56361..b04914d 100644
--- a/include/nlohmann/detail/iterators/iterator_traits.hpp
+++ b/include/nlohmann/detail/iterators/iterator_traits.hpp
@@ -1,14 +1,23 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <iterator> // random_access_iterator_tag
+#include <nlohmann/detail/abi_macros.hpp>
#include <nlohmann/detail/meta/void_t.hpp>
#include <nlohmann/detail/meta/cpp_future.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
template<typename It, typename = void>
struct iterator_types {};
@@ -47,5 +56,6 @@
using pointer = T*;
using reference = T&;
};
-} // namespace detail
-} // namespace nlohmann
+
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/iterators/json_reverse_iterator.hpp b/include/nlohmann/detail/iterators/json_reverse_iterator.hpp
index e787fdb..f7e8503 100644
--- a/include/nlohmann/detail/iterators/json_reverse_iterator.hpp
+++ b/include/nlohmann/detail/iterators/json_reverse_iterator.hpp
@@ -1,13 +1,23 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <cstddef> // ptrdiff_t
#include <iterator> // reverse_iterator
#include <utility> // declval
-namespace nlohmann
-{
+#include <nlohmann/detail/abi_macros.hpp>
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
//////////////////////
// reverse_iterator //
//////////////////////
@@ -48,7 +58,7 @@
explicit json_reverse_iterator(const base_iterator& it) noexcept : base_iterator(it) {}
/// post-increment (it++)
- json_reverse_iterator const operator++(int) // NOLINT(readability-const-return-type)
+ json_reverse_iterator operator++(int)& // NOLINT(cert-dcl21-cpp)
{
return static_cast<json_reverse_iterator>(base_iterator::operator++(1));
}
@@ -60,7 +70,7 @@
}
/// post-decrement (it--)
- json_reverse_iterator const operator--(int) // NOLINT(readability-const-return-type)
+ json_reverse_iterator operator--(int)& // NOLINT(cert-dcl21-cpp)
{
return static_cast<json_reverse_iterator>(base_iterator::operator--(1));
}
@@ -115,5 +125,6 @@
return it.operator * ();
}
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/iterators/primitive_iterator.hpp b/include/nlohmann/detail/iterators/primitive_iterator.hpp
index 15aa2f0..5d0594a 100644
--- a/include/nlohmann/detail/iterators/primitive_iterator.hpp
+++ b/include/nlohmann/detail/iterators/primitive_iterator.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <cstddef> // ptrdiff_t
@@ -5,10 +13,10 @@
#include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
/*
@brief an iterator for primitive JSON types
@@ -87,7 +95,7 @@
return *this;
}
- primitive_iterator_t const operator++(int) noexcept // NOLINT(readability-const-return-type)
+ primitive_iterator_t operator++(int)& noexcept // NOLINT(cert-dcl21-cpp)
{
auto result = *this;
++m_it;
@@ -100,7 +108,7 @@
return *this;
}
- primitive_iterator_t const operator--(int) noexcept // NOLINT(readability-const-return-type)
+ primitive_iterator_t operator--(int)& noexcept // NOLINT(cert-dcl21-cpp)
{
auto result = *this;
--m_it;
@@ -119,5 +127,6 @@
return *this;
}
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/json_pointer.hpp b/include/nlohmann/detail/json_pointer.hpp
index caed67c..867d9cb 100644
--- a/include/nlohmann/detail/json_pointer.hpp
+++ b/include/nlohmann/detail/json_pointer.hpp
@@ -1,7 +1,20 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <algorithm> // all_of
#include <cctype> // isdigit
+#include <cerrno> // errno, ERANGE
+#include <cstdlib> // strtoull
+#ifndef JSON_NO_IO
+ #include <iosfwd> // ostream
+#endif // JSON_NO_IO
#include <limits> // max
#include <numeric> // accumulate
#include <string> // string
@@ -10,47 +23,76 @@
#include <nlohmann/detail/exceptions.hpp>
#include <nlohmann/detail/macro_scope.hpp>
+#include <nlohmann/detail/string_concat.hpp>
#include <nlohmann/detail/string_escape.hpp>
#include <nlohmann/detail/value_t.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
/// @brief JSON Pointer defines a string syntax for identifying a specific value within a JSON document
/// @sa https://json.nlohmann.me/api/json_pointer/
-template<typename BasicJsonType>
+template<typename RefStringType>
class json_pointer
{
// allow basic_json to access private members
NLOHMANN_BASIC_JSON_TPL_DECLARATION
friend class basic_json;
+ template<typename>
+ friend class json_pointer;
+
+ template<typename T>
+ struct string_t_helper
+ {
+ using type = T;
+ };
+
+ NLOHMANN_BASIC_JSON_TPL_DECLARATION
+ struct string_t_helper<NLOHMANN_BASIC_JSON_TPL>
+ {
+ using type = StringType;
+ };
+
public:
+ // for backwards compatibility accept BasicJsonType
+ using string_t = typename string_t_helper<RefStringType>::type;
+
/// @brief create JSON pointer
/// @sa https://json.nlohmann.me/api/json_pointer/json_pointer/
- explicit json_pointer(const std::string& s = "")
+ explicit json_pointer(const string_t& s = "")
: reference_tokens(split(s))
{}
/// @brief return a string representation of the JSON pointer
/// @sa https://json.nlohmann.me/api/json_pointer/to_string/
- std::string to_string() const
+ string_t to_string() const
{
return std::accumulate(reference_tokens.begin(), reference_tokens.end(),
- std::string{},
- [](const std::string & a, const std::string & b)
+ string_t{},
+ [](const string_t& a, const string_t& b)
{
- return a + "/" + detail::escape(b);
+ return detail::concat(a, '/', detail::escape(b));
});
}
/// @brief return a string representation of the JSON pointer
/// @sa https://json.nlohmann.me/api/json_pointer/operator_string/
- operator std::string() const
+ JSON_HEDLEY_DEPRECATED_FOR(3.11.0, to_string())
+ operator string_t() const
{
return to_string();
}
+#ifndef JSON_NO_IO
+ /// @brief write string representation of the JSON pointer to stream
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_ltlt/
+ friend std::ostream& operator<<(std::ostream& o, const json_pointer& ptr)
+ {
+ o << ptr.to_string();
+ return o;
+ }
+#endif
+
/// @brief append another JSON pointer at the end of this JSON pointer
/// @sa https://json.nlohmann.me/api/json_pointer/operator_slasheq/
json_pointer& operator/=(const json_pointer& ptr)
@@ -63,7 +105,7 @@
/// @brief append an unescaped reference token at the end of this JSON pointer
/// @sa https://json.nlohmann.me/api/json_pointer/operator_slasheq/
- json_pointer& operator/=(std::string token)
+ json_pointer& operator/=(string_t token)
{
push_back(std::move(token));
return *this;
@@ -86,7 +128,7 @@
/// @brief create a new JSON pointer by appending the unescaped token at the end of the JSON pointer
/// @sa https://json.nlohmann.me/api/json_pointer/operator_slash/
- friend json_pointer operator/(const json_pointer& lhs, std::string token) // NOLINT(performance-unnecessary-value-param)
+ friend json_pointer operator/(const json_pointer& lhs, string_t token) // NOLINT(performance-unnecessary-value-param)
{
return json_pointer(lhs) /= std::move(token);
}
@@ -118,7 +160,7 @@
{
if (JSON_HEDLEY_UNLIKELY(empty()))
{
- JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", BasicJsonType()));
+ JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", nullptr));
}
reference_tokens.pop_back();
@@ -126,11 +168,11 @@
/// @brief return last reference token
/// @sa https://json.nlohmann.me/api/json_pointer/back/
- const std::string& back() const
+ const string_t& back() const
{
if (JSON_HEDLEY_UNLIKELY(empty()))
{
- JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", BasicJsonType()));
+ JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", nullptr));
}
return reference_tokens.back();
@@ -138,14 +180,14 @@
/// @brief append an unescaped token at the end of the reference pointer
/// @sa https://json.nlohmann.me/api/json_pointer/push_back/
- void push_back(const std::string& token)
+ void push_back(const string_t& token)
{
reference_tokens.push_back(token);
}
/// @brief append an unescaped token at the end of the reference pointer
/// @sa https://json.nlohmann.me/api/json_pointer/push_back/
- void push_back(std::string&& token)
+ void push_back(string_t&& token)
{
reference_tokens.push_back(std::move(token));
}
@@ -168,44 +210,39 @@
@throw out_of_range.404 if string @a s could not be converted to an integer
@throw out_of_range.410 if an array index exceeds size_type
*/
- static typename BasicJsonType::size_type array_index(const std::string& s)
+ template<typename BasicJsonType>
+ static typename BasicJsonType::size_type array_index(const string_t& s)
{
using size_type = typename BasicJsonType::size_type;
// error condition (cf. RFC 6901, Sect. 4)
if (JSON_HEDLEY_UNLIKELY(s.size() > 1 && s[0] == '0'))
{
- JSON_THROW(detail::parse_error::create(106, 0, "array index '" + s + "' must not begin with '0'", BasicJsonType()));
+ JSON_THROW(detail::parse_error::create(106, 0, detail::concat("array index '", s, "' must not begin with '0'"), nullptr));
}
// error condition (cf. RFC 6901, Sect. 4)
if (JSON_HEDLEY_UNLIKELY(s.size() > 1 && !(s[0] >= '1' && s[0] <= '9')))
{
- JSON_THROW(detail::parse_error::create(109, 0, "array index '" + s + "' is not a number", BasicJsonType()));
+ JSON_THROW(detail::parse_error::create(109, 0, detail::concat("array index '", s, "' is not a number"), nullptr));
}
- std::size_t processed_chars = 0;
- unsigned long long res = 0; // NOLINT(runtime/int)
- JSON_TRY
+ const char* p = s.c_str();
+ char* p_end = nullptr;
+ errno = 0; // strtoull doesn't reset errno
+ unsigned long long res = std::strtoull(p, &p_end, 10); // NOLINT(runtime/int)
+ if (p == p_end // invalid input or empty string
+ || errno == ERANGE // out of range
+ || JSON_HEDLEY_UNLIKELY(static_cast<std::size_t>(p_end - p) != s.size())) // incomplete read
{
- res = std::stoull(s, &processed_chars);
- }
- JSON_CATCH(std::out_of_range&)
- {
- JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + s + "'", BasicJsonType()));
- }
-
- // check if the string was completely read
- if (JSON_HEDLEY_UNLIKELY(processed_chars != s.size()))
- {
- JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + s + "'", BasicJsonType()));
+ JSON_THROW(detail::out_of_range::create(404, detail::concat("unresolved reference token '", s, "'"), nullptr));
}
// only triggered on special platforms (like 32bit), see also
// https://github.com/nlohmann/json/pull/2203
if (res >= static_cast<unsigned long long>((std::numeric_limits<size_type>::max)())) // NOLINT(runtime/int)
{
- JSON_THROW(detail::out_of_range::create(410, "array index " + s + " exceeds size_type", BasicJsonType())); // LCOV_EXCL_LINE
+ JSON_THROW(detail::out_of_range::create(410, detail::concat("array index ", s, " exceeds size_type"), nullptr)); // LCOV_EXCL_LINE
}
return static_cast<size_type>(res);
@@ -216,7 +253,7 @@
{
if (JSON_HEDLEY_UNLIKELY(empty()))
{
- JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", BasicJsonType()));
+ JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", nullptr));
}
json_pointer result = *this;
@@ -233,6 +270,7 @@
@throw parse_error.109 if array index is not a number
@throw type_error.313 if value cannot be unflattened
*/
+ template<typename BasicJsonType>
BasicJsonType& get_and_create(BasicJsonType& j) const
{
auto* result = &j;
@@ -268,7 +306,7 @@
case detail::value_t::array:
{
// create an entry in the array
- result = &result->operator[](array_index(reference_token));
+ result = &result->operator[](array_index<BasicJsonType>(reference_token));
break;
}
@@ -286,7 +324,7 @@
case detail::value_t::binary:
case detail::value_t::discarded:
default:
- JSON_THROW(detail::type_error::create(313, "invalid value to unflatten", j));
+ JSON_THROW(detail::type_error::create(313, "invalid value to unflatten", &j));
}
}
@@ -312,6 +350,7 @@
@throw parse_error.109 if an array index was not a number
@throw out_of_range.404 if the JSON pointer can not be resolved
*/
+ template<typename BasicJsonType>
BasicJsonType& get_unchecked(BasicJsonType* ptr) const
{
for (const auto& reference_token : reference_tokens)
@@ -352,7 +391,7 @@
else
{
// convert array index to number; unchecked access
- ptr = &ptr->operator[](array_index(reference_token));
+ ptr = &ptr->operator[](array_index<BasicJsonType>(reference_token));
}
break;
}
@@ -366,7 +405,7 @@
case detail::value_t::binary:
case detail::value_t::discarded:
default:
- JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + reference_token + "'", *ptr));
+ JSON_THROW(detail::out_of_range::create(404, detail::concat("unresolved reference token '", reference_token, "'"), ptr));
}
}
@@ -379,6 +418,7 @@
@throw out_of_range.402 if the array index '-' is used
@throw out_of_range.404 if the JSON pointer can not be resolved
*/
+ template<typename BasicJsonType>
BasicJsonType& get_checked(BasicJsonType* ptr) const
{
for (const auto& reference_token : reference_tokens)
@@ -397,13 +437,13 @@
if (JSON_HEDLEY_UNLIKELY(reference_token == "-"))
{
// "-" always fails the range check
- JSON_THROW(detail::out_of_range::create(402,
- "array index '-' (" + std::to_string(ptr->m_value.array->size()) +
- ") is out of range", *ptr));
+ JSON_THROW(detail::out_of_range::create(402, detail::concat(
+ "array index '-' (", std::to_string(ptr->m_value.array->size()),
+ ") is out of range"), ptr));
}
// note: at performs range check
- ptr = &ptr->at(array_index(reference_token));
+ ptr = &ptr->at(array_index<BasicJsonType>(reference_token));
break;
}
@@ -416,7 +456,7 @@
case detail::value_t::binary:
case detail::value_t::discarded:
default:
- JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + reference_token + "'", *ptr));
+ JSON_THROW(detail::out_of_range::create(404, detail::concat("unresolved reference token '", reference_token, "'"), ptr));
}
}
@@ -436,6 +476,7 @@
@throw out_of_range.402 if the array index '-' is used
@throw out_of_range.404 if the JSON pointer can not be resolved
*/
+ template<typename BasicJsonType>
const BasicJsonType& get_unchecked(const BasicJsonType* ptr) const
{
for (const auto& reference_token : reference_tokens)
@@ -454,11 +495,11 @@
if (JSON_HEDLEY_UNLIKELY(reference_token == "-"))
{
// "-" cannot be used for const access
- JSON_THROW(detail::out_of_range::create(402, "array index '-' (" + std::to_string(ptr->m_value.array->size()) + ") is out of range", *ptr));
+ JSON_THROW(detail::out_of_range::create(402, detail::concat("array index '-' (", std::to_string(ptr->m_value.array->size()), ") is out of range"), ptr));
}
// use unchecked array access
- ptr = &ptr->operator[](array_index(reference_token));
+ ptr = &ptr->operator[](array_index<BasicJsonType>(reference_token));
break;
}
@@ -471,7 +512,7 @@
case detail::value_t::binary:
case detail::value_t::discarded:
default:
- JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + reference_token + "'", *ptr));
+ JSON_THROW(detail::out_of_range::create(404, detail::concat("unresolved reference token '", reference_token, "'"), ptr));
}
}
@@ -484,6 +525,7 @@
@throw out_of_range.402 if the array index '-' is used
@throw out_of_range.404 if the JSON pointer can not be resolved
*/
+ template<typename BasicJsonType>
const BasicJsonType& get_checked(const BasicJsonType* ptr) const
{
for (const auto& reference_token : reference_tokens)
@@ -502,13 +544,13 @@
if (JSON_HEDLEY_UNLIKELY(reference_token == "-"))
{
// "-" always fails the range check
- JSON_THROW(detail::out_of_range::create(402,
- "array index '-' (" + std::to_string(ptr->m_value.array->size()) +
- ") is out of range", *ptr));
+ JSON_THROW(detail::out_of_range::create(402, detail::concat(
+ "array index '-' (", std::to_string(ptr->m_value.array->size()),
+ ") is out of range"), ptr));
}
// note: at performs range check
- ptr = &ptr->at(array_index(reference_token));
+ ptr = &ptr->at(array_index<BasicJsonType>(reference_token));
break;
}
@@ -521,7 +563,7 @@
case detail::value_t::binary:
case detail::value_t::discarded:
default:
- JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + reference_token + "'", *ptr));
+ JSON_THROW(detail::out_of_range::create(404, detail::concat("unresolved reference token '", reference_token, "'"), ptr));
}
}
@@ -532,6 +574,7 @@
@throw parse_error.106 if an array index begins with '0'
@throw parse_error.109 if an array index was not a number
*/
+ template<typename BasicJsonType>
bool contains(const BasicJsonType* ptr) const
{
for (const auto& reference_token : reference_tokens)
@@ -579,7 +622,7 @@
}
}
- const auto idx = array_index(reference_token);
+ const auto idx = array_index<BasicJsonType>(reference_token);
if (idx >= ptr->size())
{
// index out of range
@@ -620,9 +663,9 @@
@throw parse_error.107 if the pointer is not empty or begins with '/'
@throw parse_error.108 if character '~' is not followed by '0' or '1'
*/
- static std::vector<std::string> split(const std::string& reference_string)
+ static std::vector<string_t> split(const string_t& reference_string)
{
- std::vector<std::string> result;
+ std::vector<string_t> result;
// special case: empty reference string -> no reference tokens
if (reference_string.empty())
@@ -633,7 +676,7 @@
// check if nonempty reference string begins with slash
if (JSON_HEDLEY_UNLIKELY(reference_string[0] != '/'))
{
- JSON_THROW(detail::parse_error::create(107, 1, "JSON pointer must be empty or begin with '/' - was: '" + reference_string + "'", BasicJsonType()));
+ JSON_THROW(detail::parse_error::create(107, 1, detail::concat("JSON pointer must be empty or begin with '/' - was: '", reference_string, "'"), nullptr));
}
// extract the reference tokens:
@@ -644,11 +687,11 @@
std::size_t slash = reference_string.find_first_of('/', 1),
// set the beginning of the first reference token
start = 1;
- // we can stop if start == 0 (if slash == std::string::npos)
+ // we can stop if start == 0 (if slash == string_t::npos)
start != 0;
// set the beginning of the next reference token
- // (will eventually be 0 if slash == std::string::npos)
- start = (slash == std::string::npos) ? 0 : slash + 1,
+ // (will eventually be 0 if slash == string_t::npos)
+ start = (slash == string_t::npos) ? 0 : slash + 1,
// find next slash
slash = reference_string.find_first_of('/', start))
{
@@ -658,7 +701,7 @@
// check reference tokens are properly escaped
for (std::size_t pos = reference_token.find_first_of('~');
- pos != std::string::npos;
+ pos != string_t::npos;
pos = reference_token.find_first_of('~', pos + 1))
{
JSON_ASSERT(reference_token[pos] == '~');
@@ -668,7 +711,7 @@
(reference_token[pos + 1] != '0' &&
reference_token[pos + 1] != '1')))
{
- JSON_THROW(detail::parse_error::create(108, 0, "escape character '~' must be followed with '0' or '1'", BasicJsonType()));
+ JSON_THROW(detail::parse_error::create(108, 0, "escape character '~' must be followed with '0' or '1'", nullptr));
}
}
@@ -688,7 +731,8 @@
@note Empty objects or arrays are flattened to `null`.
*/
- static void flatten(const std::string& reference_string,
+ template<typename BasicJsonType>
+ static void flatten(const string_t& reference_string,
const BasicJsonType& value,
BasicJsonType& result)
{
@@ -706,7 +750,7 @@
// iterate array and use index as reference string
for (std::size_t i = 0; i < value.m_value.array->size(); ++i)
{
- flatten(reference_string + "/" + std::to_string(i),
+ flatten(detail::concat(reference_string, '/', std::to_string(i)),
value.m_value.array->operator[](i), result);
}
}
@@ -725,7 +769,7 @@
// iterate object and use keys as reference string
for (const auto& element : *value.m_value.object)
{
- flatten(reference_string + "/" + detail::escape(element.first), element.second, result);
+ flatten(detail::concat(reference_string, '/', detail::escape(element.first)), element.second, result);
}
}
break;
@@ -758,12 +802,13 @@
@throw type_error.315 if object values are not primitive
@throw type_error.313 if value cannot be unflattened
*/
+ template<typename BasicJsonType>
static BasicJsonType
unflatten(const BasicJsonType& value)
{
if (JSON_HEDLEY_UNLIKELY(!value.is_object()))
{
- JSON_THROW(detail::type_error::create(314, "only objects can be unflattened", value));
+ JSON_THROW(detail::type_error::create(314, "only objects can be unflattened", &value));
}
BasicJsonType result;
@@ -773,7 +818,7 @@
{
if (JSON_HEDLEY_UNLIKELY(!element.second.is_primitive()))
{
- JSON_THROW(detail::type_error::create(315, "values in object must be primitive", element.second));
+ JSON_THROW(detail::type_error::create(315, "values in object must be primitive", &element.second));
}
// assign value to reference pointed to by JSON pointer; Note that if
@@ -786,6 +831,21 @@
return result;
}
+ // can't use conversion operator because of ambiguity
+ json_pointer<string_t> convert() const&
+ {
+ json_pointer<string_t> result;
+ result.reference_tokens = reference_tokens;
+ return result;
+ }
+
+ json_pointer<string_t> convert()&&
+ {
+ json_pointer<string_t> result;
+ result.reference_tokens = std::move(reference_tokens);
+ return result;
+ }
+
/*!
@brief compares two JSON pointers for equality
@@ -797,11 +857,10 @@
@exceptionsafety No-throw guarantee: this function never throws exceptions.
*/
- friend bool operator==(json_pointer const& lhs,
- json_pointer const& rhs) noexcept
- {
- return lhs.reference_tokens == rhs.reference_tokens;
- }
+ template<typename RefStringTypeLhs, typename RefStringTypeRhs>
+ // NOLINTNEXTLINE(readability-redundant-declaration)
+ friend bool operator==(json_pointer<RefStringTypeLhs> const& lhs,
+ json_pointer<RefStringTypeRhs> const& rhs) noexcept;
/*!
@brief compares two JSON pointers for inequality
@@ -814,13 +873,28 @@
@exceptionsafety No-throw guarantee: this function never throws exceptions.
*/
- friend bool operator!=(json_pointer const& lhs,
- json_pointer const& rhs) noexcept
- {
- return !(lhs == rhs);
- }
+ template<typename RefStringTypeLhs, typename RefStringTypeRhs>
+ // NOLINTNEXTLINE(readability-redundant-declaration)
+ friend bool operator!=(json_pointer<RefStringTypeLhs> const& lhs,
+ json_pointer<RefStringTypeRhs> const& rhs) noexcept;
/// the reference tokens
- std::vector<std::string> reference_tokens;
+ std::vector<string_t> reference_tokens;
};
-} // namespace nlohmann
+
+// functions cannot be defined inside class due to ODR violations
+template<typename RefStringTypeLhs, typename RefStringTypeRhs>
+inline bool operator==(json_pointer<RefStringTypeLhs> const& lhs,
+ json_pointer<RefStringTypeRhs> const& rhs) noexcept
+{
+ return lhs.reference_tokens == rhs.reference_tokens;
+}
+
+template<typename RefStringTypeLhs, typename RefStringTypeRhs>
+inline bool operator!=(json_pointer<RefStringTypeLhs> const& lhs,
+ json_pointer<RefStringTypeRhs> const& rhs) noexcept
+{
+ return !(lhs == rhs);
+}
+
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/json_ref.hpp b/include/nlohmann/detail/json_ref.hpp
index b4e5dab..b672e19 100644
--- a/include/nlohmann/detail/json_ref.hpp
+++ b/include/nlohmann/detail/json_ref.hpp
@@ -1,14 +1,23 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <initializer_list>
#include <utility>
+#include <nlohmann/detail/abi_macros.hpp>
#include <nlohmann/detail/meta/type_traits.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
template<typename BasicJsonType>
class json_ref
{
@@ -64,5 +73,6 @@
mutable value_type owned_value = nullptr;
value_type const* value_ref = nullptr;
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/macro_scope.hpp b/include/nlohmann/detail/macro_scope.hpp
index b2843f0..cd01039 100644
--- a/include/nlohmann/detail/macro_scope.hpp
+++ b/include/nlohmann/detail/macro_scope.hpp
@@ -1,12 +1,22 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <utility> // declval, pair
-#include <nlohmann/thirdparty/hedley/hedley.hpp>
#include <nlohmann/detail/meta/detected.hpp>
+#include <nlohmann/thirdparty/hedley/hedley.hpp>
-// This file contains all internal macro definitions
+// This file contains all internal macro definitions (except those affecting ABI)
// You MUST include macro_unscope.hpp at the end of json.hpp to undef all of them
+#include <nlohmann/detail/abi_macros.hpp>
+
// exclude unsupported compilers
#if !defined(JSON_SKIP_UNSUPPORTED_COMPILER_CHECK)
#if defined(__clang__)
@@ -37,6 +47,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)
@@ -70,7 +86,7 @@
#endif
// no filesystem support before MSVC 19.14: https://en.cppreference.com/w/cpp/compiler_support
- #if defined(_MSC_VER) && _MSC_VER < 1940
+ #if defined(_MSC_VER) && _MSC_VER < 1914
#undef JSON_HAS_FILESYSTEM
#undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
#endif
@@ -97,6 +113,38 @@
#define JSON_HAS_FILESYSTEM 0
#endif
+#ifndef JSON_HAS_THREE_WAY_COMPARISON
+ #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
+ #define JSON_NO_UNIQUE_ADDRESS
+#endif
+
// disable documentation warnings on clang
#if defined(__clang__)
#pragma clang diagnostic push
@@ -334,6 +382,7 @@
#define NLOHMANN_JSON_TO(v1) nlohmann_json_j[#v1] = nlohmann_json_t.v1;
#define NLOHMANN_JSON_FROM(v1) nlohmann_json_j.at(#v1).get_to(nlohmann_json_t.v1);
+#define NLOHMANN_JSON_FROM_WITH_DEFAULT(v1) nlohmann_json_t.v1 = nlohmann_json_j.value(#v1, nlohmann_json_default_obj.v1);
/*!
@brief macro
@@ -344,6 +393,10 @@
friend void to_json(nlohmann::json& nlohmann_json_j, const Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_TO, __VA_ARGS__)) } \
friend void from_json(const nlohmann::json& nlohmann_json_j, Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_FROM, __VA_ARGS__)) }
+#define NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT(Type, ...) \
+ friend void to_json(nlohmann::json& nlohmann_json_j, const Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_TO, __VA_ARGS__)) } \
+ friend void from_json(const nlohmann::json& nlohmann_json_j, Type& nlohmann_json_t) { Type nlohmann_json_default_obj; NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_FROM_WITH_DEFAULT, __VA_ARGS__)) }
+
/*!
@brief macro
@def NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE
@@ -353,6 +406,10 @@
inline void to_json(nlohmann::json& nlohmann_json_j, const Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_TO, __VA_ARGS__)) } \
inline void from_json(const nlohmann::json& nlohmann_json_j, Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_FROM, __VA_ARGS__)) }
+#define NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT(Type, ...) \
+ inline void to_json(nlohmann::json& nlohmann_json_j, const Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_TO, __VA_ARGS__)) } \
+ inline void from_json(const nlohmann::json& nlohmann_json_j, Type& nlohmann_json_t) { Type nlohmann_json_default_obj; NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_FROM_WITH_DEFAULT, __VA_ARGS__)) }
+
// inspired from https://stackoverflow.com/a/26745591
// allows to call any std function as if (e.g. with begin):
@@ -402,6 +459,10 @@
#define JSON_EXPLICIT explicit
#endif
-#ifndef JSON_DIAGNOSTICS
- #define JSON_DIAGNOSTICS 0
+#ifndef JSON_DISABLE_ENUM_SERIALIZATION
+ #define JSON_DISABLE_ENUM_SERIALIZATION 0
+#endif
+
+#ifndef JSON_USE_GLOBAL_UDLS
+ #define JSON_USE_GLOBAL_UDLS 0
#endif
diff --git a/include/nlohmann/detail/macro_unscope.hpp b/include/nlohmann/detail/macro_unscope.hpp
index 1a29fb5..9416e18 100644
--- a/include/nlohmann/detail/macro_unscope.hpp
+++ b/include/nlohmann/detail/macro_unscope.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
// restore clang diagnostic settings
@@ -8,19 +16,29 @@
// clean up
#undef JSON_ASSERT
#undef JSON_INTERNAL_CATCH
-#undef JSON_CATCH
#undef JSON_THROW
-#undef JSON_TRY
#undef JSON_PRIVATE_UNLESS_TESTED
-#undef JSON_HAS_CPP_11
-#undef JSON_HAS_CPP_14
-#undef JSON_HAS_CPP_17
-#undef JSON_HAS_CPP_20
-#undef JSON_HAS_FILESYSTEM
-#undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
#undef NLOHMANN_BASIC_JSON_TPL_DECLARATION
#undef NLOHMANN_BASIC_JSON_TPL
#undef JSON_EXPLICIT
#undef NLOHMANN_CAN_CALL_STD_FUNC_IMPL
+#undef JSON_INLINE_VARIABLE
+#undef JSON_NO_UNIQUE_ADDRESS
+#undef JSON_DISABLE_ENUM_SERIALIZATION
+#undef JSON_USE_GLOBAL_UDLS
+
+#ifndef JSON_TEST_KEEP_MACROS
+ #undef JSON_CATCH
+ #undef JSON_TRY
+ #undef JSON_HAS_CPP_11
+ #undef JSON_HAS_CPP_14
+ #undef JSON_HAS_CPP_17
+ #undef JSON_HAS_CPP_20
+ #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/meta/call_std/begin.hpp b/include/nlohmann/detail/meta/call_std/begin.hpp
index da93714..610f4cd 100644
--- a/include/nlohmann/detail/meta/call_std/begin.hpp
+++ b/include/nlohmann/detail/meta/call_std/begin.hpp
@@ -1,8 +1,17 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
+
NLOHMANN_CAN_CALL_STD_FUNC_IMPL(begin);
-} // namespace nlohmann
+
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/meta/call_std/end.hpp b/include/nlohmann/detail/meta/call_std/end.hpp
index 1909007..1515e75 100644
--- a/include/nlohmann/detail/meta/call_std/end.hpp
+++ b/include/nlohmann/detail/meta/call_std/end.hpp
@@ -1,8 +1,17 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
+
NLOHMANN_CAN_CALL_STD_FUNC_IMPL(end);
-} // namespace nlohmann
+
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/meta/cpp_future.hpp b/include/nlohmann/detail/meta/cpp_future.hpp
index 147f2fa..fe6784d 100644
--- a/include/nlohmann/detail/meta/cpp_future.hpp
+++ b/include/nlohmann/detail/meta/cpp_future.hpp
@@ -1,3 +1,12 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-FileCopyrightText: 2018 The Abseil Authors
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <cstddef> // size_t
@@ -6,8 +15,7 @@
#include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
@@ -147,8 +155,12 @@
static constexpr T value{};
};
-template<typename T>
-constexpr T static_const<T>::value; // NOLINT(readability-redundant-declaration)
+#ifndef JSON_HAS_CPP_17
+
+ template<typename T>
+ constexpr T static_const<T>::value; // NOLINT(readability-redundant-declaration)
+
+#endif
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/meta/detected.hpp b/include/nlohmann/detail/meta/detected.hpp
index 8480e1c..9746dae 100644
--- a/include/nlohmann/detail/meta/detected.hpp
+++ b/include/nlohmann/detail/meta/detected.hpp
@@ -1,14 +1,22 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <type_traits>
#include <nlohmann/detail/meta/void_t.hpp>
-// https://en.cppreference.com/w/cpp/experimental/is_detected
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
+// https://en.cppreference.com/w/cpp/experimental/is_detected
struct nonesuch
{
nonesuch() = delete;
@@ -57,5 +65,6 @@
template<class To, template<class...> class Op, class... Args>
using is_detected_convertible =
std::is_convertible<detected_t<Op, Args...>, To>;
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/meta/identity_tag.hpp b/include/nlohmann/detail/meta/identity_tag.hpp
index 73a3e91..002d605 100644
--- a/include/nlohmann/detail/meta/identity_tag.hpp
+++ b/include/nlohmann/detail/meta/identity_tag.hpp
@@ -1,10 +1,21 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
-namespace nlohmann
-{
+#include <nlohmann/detail/abi_macros.hpp>
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
// dispatching helper struct
template <class T> struct identity_tag {};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/meta/is_sax.hpp b/include/nlohmann/detail/meta/is_sax.hpp
index e1e48a0..8be4d34 100644
--- a/include/nlohmann/detail/meta/is_sax.hpp
+++ b/include/nlohmann/detail/meta/is_sax.hpp
@@ -1,16 +1,25 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <cstdint> // size_t
#include <utility> // declval
#include <string> // string
+#include <nlohmann/detail/abi_macros.hpp>
#include <nlohmann/detail/meta/detected.hpp>
#include <nlohmann/detail/meta/type_traits.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
template<typename T>
using null_function_t = decltype(std::declval<T&>().null());
@@ -145,5 +154,6 @@
"Missing/invalid function: bool parse_error(std::size_t, const "
"std::string&, const exception&)");
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/meta/std_fs.hpp b/include/nlohmann/detail/meta/std_fs.hpp
new file mode 100644
index 0000000..f457682
--- /dev/null
+++ b/include/nlohmann/detail/meta/std_fs.hpp
@@ -0,0 +1,29 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include <nlohmann/detail/macro_scope.hpp>
+
+#if JSON_HAS_EXPERIMENTAL_FILESYSTEM
+#include <experimental/filesystem>
+NLOHMANN_JSON_NAMESPACE_BEGIN
+namespace detail
+{
+namespace std_fs = std::experimental::filesystem;
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
+#elif JSON_HAS_FILESYSTEM
+#include <filesystem>
+NLOHMANN_JSON_NAMESPACE_BEGIN
+namespace detail
+{
+namespace std_fs = std::filesystem;
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
+#endif
diff --git a/include/nlohmann/detail/meta/type_traits.hpp b/include/nlohmann/detail/meta/type_traits.hpp
index 984ca19..920e8ab 100644
--- a/include/nlohmann/detail/meta/type_traits.hpp
+++ b/include/nlohmann/detail/meta/type_traits.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <limits> // numeric_limits
@@ -5,17 +13,15 @@
#include <utility> // declval
#include <tuple> // tuple
-#include <nlohmann/detail/macro_scope.hpp>
-
#include <nlohmann/detail/iterators/iterator_traits.hpp>
+#include <nlohmann/detail/macro_scope.hpp>
#include <nlohmann/detail/meta/call_std/begin.hpp>
#include <nlohmann/detail/meta/call_std/end.hpp>
#include <nlohmann/detail/meta/cpp_future.hpp>
#include <nlohmann/detail/meta/detected.hpp>
#include <nlohmann/json_fwd.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
/*!
@brief detail namespace with internal helper functions
@@ -26,6 +32,7 @@
*/
namespace detail
{
+
/////////////
// helpers //
/////////////
@@ -44,6 +51,16 @@
NLOHMANN_BASIC_JSON_TPL_DECLARATION
struct is_basic_json<NLOHMANN_BASIC_JSON_TPL> : std::true_type {};
+// used by exceptions create() member functions
+// true_type for pointer to possibly cv-qualified basic_json or std::nullptr_t
+// false_type otherwise
+template<typename BasicJsonContext>
+struct is_basic_json_context :
+ std::integral_constant < bool,
+ is_basic_json<typename std::remove_cv<typename std::remove_pointer<BasicJsonContext>::type>::type>::value
+ || std::is_same<BasicJsonContext, std::nullptr_t>::value >
+{};
+
//////////////////////
// json_ref helpers //
//////////////////////
@@ -145,6 +162,24 @@
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 //
@@ -152,10 +187,10 @@
// https://en.cppreference.com/w/cpp/types/conjunction
template<class...> struct conjunction : std::true_type { };
-template<class B1> struct conjunction<B1> : B1 { };
-template<class B1, class... Bn>
-struct conjunction<B1, Bn...>
-: std::conditional<bool(B1::value), conjunction<Bn...>, B1>::type {};
+template<class B> struct conjunction<B> : B { };
+template<class B, class... Bn>
+struct conjunction<B, Bn...>
+: 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 > { };
@@ -319,9 +354,18 @@
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,
- typename BasicJsonType::string_t>::value;
+ conjunction <
+ is_constructible<laundered_type, typename BasicJsonType::string_t>,
+ is_detected_exact<typename BasicJsonType::string_t::value_type,
+ value_type_t, laundered_type >>::value;
};
template<typename BasicJsonType, typename CompatibleArrayType, typename = void>
@@ -439,6 +483,81 @@
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 {};
+
+template<typename T>
+using detect_is_transparent = typename T::is_transparent;
+
+// type trait to check if KeyType can be used as object key (without a BasicJsonType)
+// see is_usable_as_basic_json_key_type below
+template<typename Comparator, typename ObjectKeyType, typename KeyTypeCVRef, bool RequireTransparentComparator = true,
+ bool ExcludeObjectKeyType = RequireTransparentComparator, typename KeyType = uncvref_t<KeyTypeCVRef>>
+using is_usable_as_key_type = typename std::conditional <
+ is_comparable<Comparator, ObjectKeyType, KeyTypeCVRef>::value
+ && !(ExcludeObjectKeyType && std::is_same<KeyType,
+ ObjectKeyType>::value)
+ && (!RequireTransparentComparator
+ || is_detected <detect_is_transparent, Comparator>::value)
+ && !is_json_pointer<KeyType>::value,
+ std::true_type,
+ std::false_type >::type;
+
+// 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_basic_json_key_type = typename std::conditional <
+ is_usable_as_key_type<typename BasicJsonType::object_comparator_t,
+ typename BasicJsonType::object_t::key_type, KeyTypeCVRef,
+ RequireTransparentComparator, ExcludeObjectKeyType>::value
+ && !is_json_iterator_of<BasicJsonType, 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>
@@ -470,5 +589,100 @@
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
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/meta/void_t.hpp b/include/nlohmann/detail/meta/void_t.hpp
index 4ee2c86..379ea4d 100644
--- a/include/nlohmann/detail/meta/void_t.hpp
+++ b/include/nlohmann/detail/meta/void_t.hpp
@@ -1,13 +1,24 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
-namespace nlohmann
-{
+#include <nlohmann/detail/abi_macros.hpp>
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
template<typename ...Ts> struct make_void
{
using type = void;
};
template<typename ...Ts> using void_t = typename make_void<Ts...>::type;
-} // namespace detail
-} // namespace nlohmann
+
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/output/binary_writer.hpp b/include/nlohmann/detail/output/binary_writer.hpp
index 5985871..7cf23d1 100644
--- a/include/nlohmann/detail/output/binary_writer.hpp
+++ b/include/nlohmann/detail/output/binary_writer.hpp
@@ -1,22 +1,33 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#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>
#include <nlohmann/detail/output/output_adapters.hpp>
+#include <nlohmann/detail/string_concat.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
///////////////////
// binary writer //
///////////////////
@@ -67,7 +78,7 @@
case value_t::discarded:
default:
{
- JSON_THROW(type_error::create(317, "to serialize to BSON, top-level type must be object, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(317, concat("to serialize to BSON, top-level type must be object, but is ", j.type_name()), &j));
}
}
}
@@ -723,9 +734,11 @@
@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())
{
@@ -751,19 +764,19 @@
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;
}
@@ -773,7 +786,7 @@
{
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());
@@ -791,14 +804,16 @@
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('$'));
@@ -809,12 +824,12 @@
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)
@@ -842,7 +857,7 @@
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)
@@ -870,6 +885,14 @@
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('{'));
@@ -879,14 +902,16 @@
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('$'));
@@ -897,16 +922,16 @@
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)
@@ -937,7 +962,7 @@
const auto it = name.find(static_cast<typename string_t::value_type>(0));
if (JSON_HEDLEY_UNLIKELY(it != BasicJsonType::string_t::npos))
{
- JSON_THROW(out_of_range::create(409, "BSON key cannot contain code point U+0000 (at byte " + std::to_string(it) + ")", j));
+ JSON_THROW(out_of_range::create(409, concat("BSON key cannot contain code point U+0000 (at byte ", std::to_string(it), ")"), &j));
static_cast<void>(j);
}
@@ -973,7 +998,7 @@
const double value)
{
write_bson_entry_header(name, 0x01);
- write_number<double, true>(value);
+ write_number<double>(value, true);
}
/*!
@@ -992,7 +1017,7 @@
{
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);
@@ -1025,12 +1050,12 @@
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);
}
}
@@ -1053,16 +1078,16 @@
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
{
- JSON_THROW(out_of_range::create(407, "integer number " + std::to_string(j.m_value.number_unsigned) + " cannot be represented by BSON as it does not fit int64", j));
+ JSON_THROW(out_of_range::create(407, concat("integer number ", std::to_string(j.m_value.number_unsigned), " cannot be represented by BSON as it does not fit int64"), &j));
}
}
@@ -1106,7 +1131,7 @@
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;
@@ -1126,7 +1151,7 @@
{
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());
@@ -1248,7 +1273,7 @@
*/
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)
{
@@ -1294,20 +1319,22 @@
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)()))
{
@@ -1315,7 +1342,7 @@
{
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)())
{
@@ -1323,7 +1350,7 @@
{
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)()))
{
@@ -1331,7 +1358,15 @@
{
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)()))
{
@@ -1339,7 +1374,15 @@
{
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)()))
{
@@ -1347,7 +1390,15 @@
{
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
{
@@ -1357,7 +1408,7 @@
}
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])));
@@ -1370,7 +1421,8 @@
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)())
{
@@ -1378,7 +1430,7 @@
{
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)()))
{
@@ -1386,7 +1438,7 @@
{
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)())
{
@@ -1394,7 +1446,15 @@
{
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)())
{
@@ -1402,7 +1462,15 @@
{
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)())
{
@@ -1410,7 +1478,7 @@
{
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
@@ -1421,7 +1489,7 @@
}
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])));
@@ -1433,7 +1501,7 @@
/*!
@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())
{
@@ -1457,10 +1525,18 @@
{
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';
@@ -1483,14 +1559,26 @@
{
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
}
@@ -1524,6 +1612,118 @@
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 //
///////////////////////
@@ -1531,16 +1731,18 @@
/*
@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{};
@@ -1631,5 +1833,6 @@
/// the output
output_adapter_t<CharType> oa = nullptr;
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/output/output_adapters.hpp b/include/nlohmann/detail/output/output_adapters.hpp
index 1cad57b..c1079b8 100644
--- a/include/nlohmann/detail/output/output_adapters.hpp
+++ b/include/nlohmann/detail/output/output_adapters.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <algorithm> // copy
@@ -14,10 +22,10 @@
#include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
/// abstract output adapter interface
template<typename CharType> struct output_adapter_protocol
{
@@ -53,7 +61,7 @@
JSON_HEDLEY_NON_NULL(2)
void write_characters(const CharType* s, std::size_t length) override
{
- std::copy(s, s + length, std::back_inserter(v));
+ v.insert(v.end(), s, s + length);
}
private:
@@ -134,5 +142,6 @@
private:
output_adapter_t<CharType> oa = nullptr;
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/output/serializer.hpp b/include/nlohmann/detail/output/serializer.hpp
index 7cce7d5..cc3b97e 100644
--- a/include/nlohmann/detail/output/serializer.hpp
+++ b/include/nlohmann/detail/output/serializer.hpp
@@ -1,3 +1,12 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2008-2009 Björn Hoehrmann <bjoern@hoehrmann.de>
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <algorithm> // reverse, remove, fill, find, none_of
@@ -10,7 +19,6 @@
#include <limits> // numeric_limits
#include <string> // string, char_traits
#include <iomanip> // setfill, setw
-#include <sstream> // stringstream
#include <type_traits> // is_same
#include <utility> // move
@@ -20,12 +28,13 @@
#include <nlohmann/detail/meta/cpp_future.hpp>
#include <nlohmann/detail/output/binary_writer.hpp>
#include <nlohmann/detail/output/output_adapters.hpp>
+#include <nlohmann/detail/string_concat.hpp>
#include <nlohmann/detail/value_t.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
///////////////////
// serialization //
///////////////////
@@ -501,9 +510,7 @@
{
case error_handler_t::strict:
{
- std::stringstream ss;
- ss << std::uppercase << std::setfill('0') << std::setw(2) << std::hex << (byte | 0);
- JSON_THROW(type_error::create(316, "invalid UTF-8 byte at index " + std::to_string(i) + ": 0x" + ss.str(), BasicJsonType()));
+ JSON_THROW(type_error::create(316, concat("invalid UTF-8 byte at index ", std::to_string(i), ": 0x", hex_bytes(byte | 0)), nullptr));
}
case error_handler_t::ignore:
@@ -595,9 +602,7 @@
{
case error_handler_t::strict:
{
- std::stringstream ss;
- ss << std::uppercase << std::setfill('0') << std::setw(2) << std::hex << (static_cast<std::uint8_t>(s.back()) | 0);
- JSON_THROW(type_error::create(316, "incomplete UTF-8 string; last byte: 0x" + ss.str(), BasicJsonType()));
+ JSON_THROW(type_error::create(316, concat("incomplete UTF-8 string; last byte: 0x", hex_bytes(static_cast<std::uint8_t>(s.back() | 0))), nullptr));
}
case error_handler_t::ignore:
@@ -664,6 +669,20 @@
}
}
+ /*!
+ * @brief convert a byte to a uppercase hex representation
+ * @param[in] byte byte to represent
+ * @return representation ("00".."FF")
+ */
+ static std::string hex_bytes(std::uint8_t byte)
+ {
+ std::string result = "FF";
+ constexpr const char* nibble_to_hex = "0123456789ABCDEF";
+ result[0] = nibble_to_hex[byte / 16];
+ result[1] = nibble_to_hex[byte % 16];
+ return result;
+ }
+
// templates to avoid warnings about useless casts
template <typename NumberType, enable_if_t<std::is_signed<NumberType>::value, int> = 0>
bool is_negative_number(NumberType x)
@@ -964,5 +983,6 @@
/// error_handler how to react on decoding errors
const error_handler_t error_handler;
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/string_concat.hpp b/include/nlohmann/detail/string_concat.hpp
new file mode 100644
index 0000000..1adb12d
--- /dev/null
+++ b/include/nlohmann/detail/string_concat.hpp
@@ -0,0 +1,146 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include <cstring> // strlen
+#include <string> // string
+#include <utility> // forward
+
+#include <nlohmann/detail/meta/cpp_future.hpp>
+#include <nlohmann/detail/meta/detected.hpp>
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
+namespace detail
+{
+
+inline std::size_t concat_length()
+{
+ return 0;
+}
+
+template<typename... Args>
+inline std::size_t concat_length(const char* cstr, Args&& ... rest);
+
+template<typename StringType, typename... Args>
+inline std::size_t concat_length(const StringType& str, Args&& ... rest);
+
+template<typename... Args>
+inline std::size_t concat_length(const char /*c*/, Args&& ... rest)
+{
+ return 1 + concat_length(std::forward<Args>(rest)...);
+}
+
+template<typename... Args>
+inline std::size_t concat_length(const char* cstr, Args&& ... rest)
+{
+ // cppcheck-suppress ignoredReturnValue
+ return ::strlen(cstr) + concat_length(std::forward<Args>(rest)...);
+}
+
+template<typename StringType, typename... Args>
+inline std::size_t concat_length(const StringType& str, Args&& ... rest)
+{
+ return str.size() + concat_length(std::forward<Args>(rest)...);
+}
+
+template<typename OutStringType>
+inline void concat_into(OutStringType& /*out*/)
+{}
+
+template<typename StringType, typename Arg>
+using string_can_append = decltype(std::declval<StringType&>().append(std::declval < Arg && > ()));
+
+template<typename StringType, typename Arg>
+using detect_string_can_append = is_detected<string_can_append, StringType, Arg>;
+
+template<typename StringType, typename Arg>
+using string_can_append_op = decltype(std::declval<StringType&>() += std::declval < Arg && > ());
+
+template<typename StringType, typename Arg>
+using detect_string_can_append_op = is_detected<string_can_append_op, StringType, Arg>;
+
+template<typename StringType, typename Arg>
+using string_can_append_iter = decltype(std::declval<StringType&>().append(std::declval<const Arg&>().begin(), std::declval<const Arg&>().end()));
+
+template<typename StringType, typename Arg>
+using detect_string_can_append_iter = is_detected<string_can_append_iter, StringType, Arg>;
+
+template<typename StringType, typename Arg>
+using string_can_append_data = decltype(std::declval<StringType&>().append(std::declval<const Arg&>().data(), std::declval<const Arg&>().size()));
+
+template<typename StringType, typename Arg>
+using detect_string_can_append_data = is_detected<string_can_append_data, StringType, Arg>;
+
+template < typename OutStringType, typename Arg, typename... Args,
+ enable_if_t < !detect_string_can_append<OutStringType, Arg>::value
+ && detect_string_can_append_op<OutStringType, Arg>::value, int > = 0 >
+inline void concat_into(OutStringType& out, Arg && arg, Args && ... rest);
+
+template < typename OutStringType, typename Arg, typename... Args,
+ enable_if_t < !detect_string_can_append<OutStringType, Arg>::value
+ && !detect_string_can_append_op<OutStringType, Arg>::value
+ && detect_string_can_append_iter<OutStringType, Arg>::value, int > = 0 >
+inline void concat_into(OutStringType& out, const Arg& arg, Args && ... rest);
+
+template < typename OutStringType, typename Arg, typename... Args,
+ enable_if_t < !detect_string_can_append<OutStringType, Arg>::value
+ && !detect_string_can_append_op<OutStringType, Arg>::value
+ && !detect_string_can_append_iter<OutStringType, Arg>::value
+ && detect_string_can_append_data<OutStringType, Arg>::value, int > = 0 >
+inline void concat_into(OutStringType& out, const Arg& arg, Args && ... rest);
+
+template<typename OutStringType, typename Arg, typename... Args,
+ enable_if_t<detect_string_can_append<OutStringType, Arg>::value, int> = 0>
+inline void concat_into(OutStringType& out, Arg && arg, Args && ... rest)
+{
+ out.append(std::forward<Arg>(arg));
+ concat_into(out, std::forward<Args>(rest)...);
+}
+
+template < typename OutStringType, typename Arg, typename... Args,
+ enable_if_t < !detect_string_can_append<OutStringType, Arg>::value
+ && detect_string_can_append_op<OutStringType, Arg>::value, int > >
+inline void concat_into(OutStringType& out, Arg&& arg, Args&& ... rest)
+{
+ out += std::forward<Arg>(arg);
+ concat_into(out, std::forward<Args>(rest)...);
+}
+
+template < typename OutStringType, typename Arg, typename... Args,
+ enable_if_t < !detect_string_can_append<OutStringType, Arg>::value
+ && !detect_string_can_append_op<OutStringType, Arg>::value
+ && detect_string_can_append_iter<OutStringType, Arg>::value, int > >
+inline void concat_into(OutStringType& out, const Arg& arg, Args&& ... rest)
+{
+ out.append(arg.begin(), arg.end());
+ concat_into(out, std::forward<Args>(rest)...);
+}
+
+template < typename OutStringType, typename Arg, typename... Args,
+ enable_if_t < !detect_string_can_append<OutStringType, Arg>::value
+ && !detect_string_can_append_op<OutStringType, Arg>::value
+ && !detect_string_can_append_iter<OutStringType, Arg>::value
+ && detect_string_can_append_data<OutStringType, Arg>::value, int > >
+inline void concat_into(OutStringType& out, const Arg& arg, Args&& ... rest)
+{
+ out.append(arg.data(), arg.size());
+ concat_into(out, std::forward<Args>(rest)...);
+}
+
+template<typename OutStringType = std::string, typename... Args>
+inline OutStringType concat(Args && ... args)
+{
+ OutStringType str;
+ str.reserve(concat_length(std::forward<Args>(args)...));
+ concat_into(str, std::forward<Args>(args)...);
+ return str;
+}
+
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/string_escape.hpp b/include/nlohmann/detail/string_escape.hpp
index 84f7da5..fa0212a 100644
--- a/include/nlohmann/detail/string_escape.hpp
+++ b/include/nlohmann/detail/string_escape.hpp
@@ -1,10 +1,16 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
-#include <string>
-#include <nlohmann/detail/macro_scope.hpp>
+#include <nlohmann/detail/abi_macros.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
@@ -21,12 +27,13 @@
@since version 2.0.0
*/
-inline void replace_substring(std::string& s, const std::string& f,
- const std::string& t)
+template<typename StringType>
+inline void replace_substring(StringType& s, const StringType& f,
+ const StringType& t)
{
JSON_ASSERT(!f.empty());
for (auto pos = s.find(f); // find first occurrence of f
- pos != std::string::npos; // make sure f was found
+ pos != StringType::npos; // make sure f was found
s.replace(pos, f.size(), t), // replace with t, and
pos = s.find(f, pos + t.size())) // find next occurrence of f
{}
@@ -39,10 +46,11 @@
*
* Note the order of escaping "~" to "~0" and "/" to "~1" is important.
*/
-inline std::string escape(std::string s)
+template<typename StringType>
+inline StringType escape(StringType s)
{
- replace_substring(s, "~", "~0");
- replace_substring(s, "/", "~1");
+ replace_substring(s, StringType{"~"}, StringType{"~0"});
+ replace_substring(s, StringType{"/"}, StringType{"~1"});
return s;
}
@@ -53,11 +61,12 @@
*
* Note the order of escaping "~1" to "/" and "~0" to "~" is important.
*/
-static void unescape(std::string& s)
+template<typename StringType>
+static void unescape(StringType& s)
{
- replace_substring(s, "~1", "/");
- replace_substring(s, "~0", "~");
+ replace_substring(s, StringType{"~1"}, StringType{"/"});
+ replace_substring(s, StringType{"~0"}, StringType{"~"});
}
-} // namespace detail
-} // namespace nlohmann
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/detail/value_t.hpp b/include/nlohmann/detail/value_t.hpp
index a98c435..4a3b6c9 100644
--- a/include/nlohmann/detail/value_t.hpp
+++ b/include/nlohmann/detail/value_t.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <array> // array
@@ -5,10 +13,15 @@
#include <cstdint> // uint8_t
#include <string> // string
-namespace nlohmann
-{
+#include <nlohmann/detail/macro_scope.hpp>
+#if JSON_HAS_THREE_WAY_COMPARISON
+ #include <compare> // partial_ordering
+#endif
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
///////////////////////////
// JSON type enumeration //
///////////////////////////
@@ -64,7 +77,11 @@
@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 +92,27 @@
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
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/json.hpp b/include/nlohmann/json.hpp
index a79be2d..742b283 100644
--- a/include/nlohmann/json.hpp
+++ b/include/nlohmann/json.hpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | JSON for Modern C++
-| | |__ | | | | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
/****************************************************************************\
* Note on documentation: The source files contain links to the online *
@@ -33,16 +12,12 @@
* 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_
#define INCLUDE_NLOHMANN_JSON_HPP_
-#define NLOHMANN_JSON_VERSION_MAJOR 3
-#define NLOHMANN_JSON_VERSION_MINOR 10
-#define NLOHMANN_JSON_VERSION_PATCH 5
-
#include <algorithm> // all_of, find, for_each
#include <cstddef> // nullptr_t, ptrdiff_t, size_t
#include <functional> // hash, less
@@ -75,6 +50,7 @@
#include <nlohmann/detail/json_pointer.hpp>
#include <nlohmann/detail/json_ref.hpp>
#include <nlohmann/detail/macro_scope.hpp>
+#include <nlohmann/detail/string_concat.hpp>
#include <nlohmann/detail/string_escape.hpp>
#include <nlohmann/detail/meta/cpp_future.hpp>
#include <nlohmann/detail/meta/type_traits.hpp>
@@ -86,6 +62,7 @@
#include <nlohmann/ordered_map.hpp>
#if defined(JSON_HAS_CPP_17)
+ #include <any>
#include <string_view>
#endif
@@ -94,8 +71,7 @@
@see https://github.com/nlohmann
@since version 1.0.0
*/
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
/*!
@brief a class to store JSON values
@@ -120,7 +96,11 @@
{
private:
template<detail::value_t> friend struct detail::external_constructor;
- friend ::nlohmann::json_pointer<basic_json>;
+
+ template<typename>
+ friend class ::nlohmann::json_pointer;
+ // can be restored when json_pointer backwards compatibility is removed
+ // friend ::nlohmann::json_pointer<StringType>;
template<typename BasicJsonType, typename InputType>
friend class ::nlohmann::detail::parser;
@@ -179,7 +159,7 @@
public:
using value_t = detail::value_t;
/// JSON Pointer, see @ref nlohmann::json_pointer
- using json_pointer = ::nlohmann::json_pointer<basic_json>;
+ using json_pointer = ::nlohmann::json_pointer<StringType>;
template<typename T, typename SFINAE>
using json_serializer = JSONSerializer<T, SFINAE>;
/// how to treat decoding errors
@@ -271,9 +251,9 @@
result["name"] = "JSON for Modern C++";
result["url"] = "https://github.com/nlohmann/json";
result["version"]["string"] =
- std::to_string(NLOHMANN_JSON_VERSION_MAJOR) + "." +
- std::to_string(NLOHMANN_JSON_VERSION_MINOR) + "." +
- std::to_string(NLOHMANN_JSON_VERSION_PATCH);
+ detail::concat(std::to_string(NLOHMANN_JSON_VERSION_MAJOR), '.',
+ std::to_string(NLOHMANN_JSON_VERSION_MINOR), '.',
+ std::to_string(NLOHMANN_JSON_VERSION_PATCH));
result["version"]["major"] = NLOHMANN_JSON_VERSION_MAJOR;
result["version"]["minor"] = NLOHMANN_JSON_VERSION_MINOR;
result["version"]["patch"] = NLOHMANN_JSON_VERSION_PATCH;
@@ -295,7 +275,12 @@
#elif defined(__clang__)
result["compiler"] = {{"family", "clang"}, {"version", __clang_version__}};
#elif defined(__GNUC__) || defined(__GNUG__)
- result["compiler"] = {{"family", "gcc"}, {"version", std::to_string(__GNUC__) + "." + std::to_string(__GNUC_MINOR__) + "." + std::to_string(__GNUC_PATCHLEVEL__)}};
+ result["compiler"] = {{"family", "gcc"}, {"version", detail::concat(
+ std::to_string(__GNUC__), '.',
+ std::to_string(__GNUC_MINOR__), '.',
+ std::to_string(__GNUC_PATCHLEVEL__))
+ }
+ };
#elif defined(__HP_cc) || defined(__HP_aCC)
result["compiler"] = "hp"
#elif defined(__IBMCPP__)
@@ -310,7 +295,10 @@
result["compiler"] = {{"family", "unknown"}, {"version", "unknown"}};
#endif
-#ifdef __cplusplus
+
+#if defined(_MSVC_LANG)
+ result["compiler"]["c++"] = std::to_string(_MSVC_LANG);
+#elif defined(__cplusplus)
result["compiler"]["c++"] = std::to_string(__cplusplus);
#else
result["compiler"]["c++"] = "unknown";
@@ -328,21 +316,23 @@
/// 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>>>;
@@ -374,6 +364,10 @@
/// @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:
@@ -520,7 +514,7 @@
object = nullptr; // silence warning, see #821
if (JSON_HEDLEY_UNLIKELY(t == value_t::null))
{
- JSON_THROW(other_error::create(500, "961c151d2e87f2686a955a9be24d316f1362bf21 3.10.5", basic_json())); // LCOV_EXCL_LINE
+ JSON_THROW(other_error::create(500, "961c151d2e87f2686a955a9be24d316f1362bf21 3.11.0", nullptr)); // LCOV_EXCL_LINE
}
break;
}
@@ -816,7 +810,7 @@
/// @brief create a null object
/// @sa https://json.nlohmann.me/api/basic_json/basic_json/
- basic_json(std::nullptr_t = nullptr) noexcept
+ basic_json(std::nullptr_t = nullptr) noexcept // NOLINT(bugprone-exception-escape)
: basic_json(value_t::null)
{
assert_invariant();
@@ -888,6 +882,7 @@
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();
}
@@ -918,7 +913,7 @@
// if object is wanted but impossible, throw an exception
if (JSON_HEDLEY_UNLIKELY(manual_type == value_t::object && !is_an_object))
{
- JSON_THROW(type_error::create(301, "cannot create object from initializer list", basic_json()));
+ JSON_THROW(type_error::create(301, "cannot create object from initializer list", nullptr));
}
}
@@ -1030,7 +1025,7 @@
// make sure iterator fits the current value
if (JSON_HEDLEY_UNLIKELY(first.m_object != last.m_object))
{
- JSON_THROW(invalid_iterator::create(201, "iterators are not compatible", basic_json()));
+ JSON_THROW(invalid_iterator::create(201, "iterators are not compatible", nullptr));
}
// copy type from first iterator
@@ -1048,7 +1043,7 @@
if (JSON_HEDLEY_UNLIKELY(!first.m_it.primitive_iterator.is_begin()
|| !last.m_it.primitive_iterator.is_end()))
{
- JSON_THROW(invalid_iterator::create(204, "iterators out of range", *first.m_object));
+ JSON_THROW(invalid_iterator::create(204, "iterators out of range", first.m_object));
}
break;
}
@@ -1117,7 +1112,7 @@
case value_t::null:
case value_t::discarded:
default:
- JSON_THROW(invalid_iterator::create(206, "cannot construct with iterators from " + std::string(first.m_object->type_name()), *first.m_object));
+ JSON_THROW(invalid_iterator::create(206, detail::concat("cannot construct with iterators from ", first.m_object->type_name()), first.m_object));
}
set_parents();
@@ -1401,7 +1396,7 @@
return m_value.boolean;
}
- JSON_THROW(type_error::create(302, "type must be boolean, but is " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(302, detail::concat("type must be boolean, but is ", type_name()), this));
}
/// get a pointer to the value (object)
@@ -1522,7 +1517,7 @@
return *ptr;
}
- JSON_THROW(type_error::create(303, "incompatible ReferenceType for get_ref, actual type is " + std::string(obj.type_name()), obj));
+ JSON_THROW(type_error::create(303, detail::concat("incompatible ReferenceType for get_ref, actual type is ", obj.type_name()), &obj));
}
public:
@@ -1872,14 +1867,17 @@
template < typename ValueType, typename std::enable_if <
detail::conjunction <
detail::negation<std::is_pointer<ValueType>>,
+ detail::negation<std::is_same<ValueType, std::nullptr_t>>,
detail::negation<std::is_same<ValueType, detail::json_ref<basic_json>>>,
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
+#if defined(JSON_HAS_CPP_17)
+ detail::negation<std::is_same<ValueType, std::any>>,
+#endif
detail::is_detected_lazy<detail::get_template_function, const basic_json_t&, ValueType>
>::value, int >::type = 0 >
JSON_EXPLICIT operator ValueType() const
@@ -1894,7 +1892,7 @@
{
if (!is_binary())
{
- JSON_THROW(type_error::create(302, "type must be binary, but is " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(302, detail::concat("type must be binary, but is ", type_name()), this));
}
return *get_ptr<binary_t*>();
@@ -1906,7 +1904,7 @@
{
if (!is_binary())
{
- JSON_THROW(type_error::create(302, "type must be binary, but is " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(302, detail::concat("type must be binary, but is ", type_name()), this));
}
return *get_ptr<const binary_t*>();
@@ -1937,12 +1935,12 @@
JSON_CATCH (std::out_of_range&)
{
// create better exception explanation
- JSON_THROW(out_of_range::create(401, "array index " + std::to_string(idx) + " is out of range", *this));
+ JSON_THROW(out_of_range::create(401, detail::concat("array index ", std::to_string(idx), " is out of range"), this));
}
}
else
{
- JSON_THROW(type_error::create(304, "cannot use at() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
}
}
@@ -1960,12 +1958,12 @@
JSON_CATCH (std::out_of_range&)
{
// create better exception explanation
- JSON_THROW(out_of_range::create(401, "array index " + std::to_string(idx) + " is out of range", *this));
+ JSON_THROW(out_of_range::create(401, detail::concat("array index ", std::to_string(idx), " is out of range"), this));
}
}
else
{
- JSON_THROW(type_error::create(304, "cannot use at() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
}
}
@@ -1974,22 +1972,37 @@
reference at(const typename object_t::key_type& key)
{
// at only works for objects
- if (JSON_HEDLEY_LIKELY(is_object()))
+ if (JSON_HEDLEY_UNLIKELY(!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, "key '" + key + "' not found", *this));
- }
+ JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
}
- else
+
+ auto it = m_value.object->find(key);
+ if (it == m_value.object->end())
{
- JSON_THROW(type_error::create(304, "cannot use at() with " + std::string(type_name()), *this));
+ 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_basic_json_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
@@ -1997,22 +2010,37 @@
const_reference at(const typename object_t::key_type& key) const
{
// at only works for objects
- if (JSON_HEDLEY_LIKELY(is_object()))
+ if (JSON_HEDLEY_UNLIKELY(!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, "key '" + key + "' not found", *this));
- }
+ JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
}
- else
+
+ auto it = m_value.object->find(key);
+ if (it == m_value.object->end())
{
- JSON_THROW(type_error::create(304, "cannot use at() with " + std::string(type_name()), *this));
+ 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_basic_json_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
@@ -2058,7 +2086,7 @@
return m_value.array->operator[](idx);
}
- JSON_THROW(type_error::create(305, "cannot use operator[] with a numeric argument with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a numeric argument with ", type_name()), this));
}
/// @brief access specified array element
@@ -2071,12 +2099,12 @@
return m_value.array->operator[](idx);
}
- JSON_THROW(type_error::create(305, "cannot use operator[] with a numeric argument with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a numeric argument with ", type_name()), this));
}
/// @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())
@@ -2089,10 +2117,11 @@
// 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, "cannot use operator[] with a string argument with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a string argument with ", type_name()), this));
}
/// @brief access specified object element
@@ -2102,74 +2131,92 @@
// 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, "cannot use operator[] with a string argument with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a string argument with ", type_name()), this));
+ }
+
+ // these two functions resolve a (const) char * ambiguity affecting Clang and MSVC
+ // (they seemingly cannot be constrained to resolve the ambiguity)
+ template<typename T>
+ reference operator[](T* key)
+ {
+ 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<typename T>
- JSON_HEDLEY_NON_NULL(2)
- reference operator[](T* key)
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_basic_json_key_type<basic_json_t, KeyType>::value, int > = 0 >
+ reference operator[](KeyType && key)
{
- // implicitly convert null to object
+ // 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, "cannot use operator[] with a string argument with " + std::string(type_name()), *this));
+ 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/
- 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_basic_json_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, "cannot use operator[] with a string argument with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a string argument with ", type_name()), this));
}
/// @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, "cannot use value() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(306, detail::concat("cannot use value() with ", type_name()), this));
}
/// @brief access specified object element with default value
@@ -2180,13 +2227,64 @@
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_basic_json_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
@@ -2200,7 +2298,15 @@
}
}
- JSON_THROW(type_error::create(306, "cannot use value() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(306, detail::concat("cannot use value() with ", type_name()), this));
+ }
+
+ 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
+ {
+ return value(ptr.convert(), default_value);
}
/// @brief access specified object element via JSON Pointer with default value
@@ -2212,6 +2318,14 @@
return value(ptr, string_t(default_value));
}
+ template<typename BasicJsonType>
+ JSON_HEDLEY_DEPRECATED_FOR(3.11.0, basic_json::json_pointer or nlohmann::json_pointer<basic_json::string_t>) // NOLINT(readability/alt_tokens)
+ JSON_HEDLEY_NON_NULL(3)
+ string_t value(const typename ::nlohmann::json_pointer<BasicJsonType>& ptr, const char* default_value) const
+ {
+ return value(ptr.convert(), default_value);
+ }
+
/// @brief access the first element
/// @sa https://json.nlohmann.me/api/basic_json/front/
reference front()
@@ -2246,16 +2360,15 @@
/// @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
if (JSON_HEDLEY_UNLIKELY(this != pos.m_object))
{
- JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", this));
}
IteratorType result = end();
@@ -2271,7 +2384,7 @@
{
if (JSON_HEDLEY_UNLIKELY(!pos.m_it.primitive_iterator.is_begin()))
{
- JSON_THROW(invalid_iterator::create(205, "iterator out of range", *this));
+ JSON_THROW(invalid_iterator::create(205, "iterator out of range", this));
}
if (is_string())
@@ -2309,7 +2422,7 @@
case value_t::null:
case value_t::discarded:
default:
- JSON_THROW(type_error::create(307, "cannot use erase() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(307, detail::concat("cannot use erase() with ", type_name()), this));
}
return result;
@@ -2317,16 +2430,15 @@
/// @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
if (JSON_HEDLEY_UNLIKELY(this != first.m_object || this != last.m_object))
{
- JSON_THROW(invalid_iterator::create(203, "iterators do not fit current value", *this));
+ JSON_THROW(invalid_iterator::create(203, "iterators do not fit current value", this));
}
IteratorType result = end();
@@ -2343,7 +2455,7 @@
if (JSON_HEDLEY_LIKELY(!first.m_it.primitive_iterator.is_begin()
|| !last.m_it.primitive_iterator.is_end()))
{
- JSON_THROW(invalid_iterator::create(204, "iterators out of range", *this));
+ JSON_THROW(invalid_iterator::create(204, "iterators out of range", this));
}
if (is_string())
@@ -2383,23 +2495,63 @@
case value_t::null:
case value_t::discarded:
default:
- JSON_THROW(type_error::create(307, "cannot use erase() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(307, detail::concat("cannot use erase() with ", type_name()), this));
}
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, "cannot use erase() with " + std::string(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_basic_json_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
@@ -2411,14 +2563,14 @@
{
if (JSON_HEDLEY_UNLIKELY(idx >= size()))
{
- JSON_THROW(out_of_range::create(401, "array index " + std::to_string(idx) + " is out of range", *this));
+ JSON_THROW(out_of_range::create(401, detail::concat("array index ", std::to_string(idx), " is out of range"), this));
}
m_value.array->erase(m_value.array->begin() + static_cast<difference_type>(idx));
}
else
{
- JSON_THROW(type_error::create(307, "cannot use erase() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(307, detail::concat("cannot use erase() with ", type_name()), this));
}
}
@@ -2434,14 +2586,13 @@
/// @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;
@@ -2449,14 +2600,45 @@
/// @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_basic_json_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_basic_json_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;
@@ -2464,20 +2646,36 @@
/// @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_basic_json_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 <
- !std::is_same<typename std::decay<KeyT>::type, json_pointer>::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_basic_json_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
@@ -2487,6 +2685,13 @@
return ptr.contains(this);
}
+ template<typename BasicJsonType>
+ JSON_HEDLEY_DEPRECATED_FOR(3.11.0, basic_json::json_pointer or nlohmann::json_pointer<basic_json::string_t>) // NOLINT(readability/alt_tokens)
+ bool contains(const typename ::nlohmann::json_pointer<BasicJsonType> ptr) const
+ {
+ return ptr.contains(this);
+ }
+
/// @}
@@ -2826,7 +3031,7 @@
// push_back only works for null objects or arrays
if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_array())))
{
- JSON_THROW(type_error::create(308, "cannot use push_back() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(308, detail::concat("cannot use push_back() with ", type_name()), this));
}
// transform null object into an array
@@ -2859,7 +3064,7 @@
// push_back only works for null objects or arrays
if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_array())))
{
- JSON_THROW(type_error::create(308, "cannot use push_back() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(308, detail::concat("cannot use push_back() with ", type_name()), this));
}
// transform null object into an array
@@ -2891,7 +3096,7 @@
// push_back only works for null objects or objects
if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_object())))
{
- JSON_THROW(type_error::create(308, "cannot use push_back() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(308, detail::concat("cannot use push_back() with ", type_name()), this));
}
// transform null object into an object
@@ -2947,7 +3152,7 @@
// emplace_back only works for null objects or arrays
if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_array())))
{
- JSON_THROW(type_error::create(311, "cannot use emplace_back() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(311, detail::concat("cannot use emplace_back() with ", type_name()), this));
}
// transform null object into an array
@@ -2972,7 +3177,7 @@
// emplace only works for null objects or arrays
if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_object())))
{
- JSON_THROW(type_error::create(311, "cannot use emplace() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(311, detail::concat("cannot use emplace() with ", type_name()), this));
}
// transform null object into an object
@@ -3026,14 +3231,14 @@
// check if iterator pos fits to this JSON value
if (JSON_HEDLEY_UNLIKELY(pos.m_object != this))
{
- JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", this));
}
// insert to array and return iterator
return insert_iterator(pos, val);
}
- JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(309, detail::concat("cannot use insert() with ", type_name()), this));
}
/// @brief inserts element into array
@@ -3053,14 +3258,14 @@
// check if iterator pos fits to this JSON value
if (JSON_HEDLEY_UNLIKELY(pos.m_object != this))
{
- JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", this));
}
// insert to array and return iterator
return insert_iterator(pos, cnt, val);
}
- JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(309, detail::concat("cannot use insert() with ", type_name()), this));
}
/// @brief inserts range of elements into array
@@ -3070,24 +3275,24 @@
// insert only works for arrays
if (JSON_HEDLEY_UNLIKELY(!is_array()))
{
- JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(309, detail::concat("cannot use insert() with ", type_name()), this));
}
// check if iterator pos fits to this JSON value
if (JSON_HEDLEY_UNLIKELY(pos.m_object != this))
{
- JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", this));
}
// check if range iterators belong to the same JSON object
if (JSON_HEDLEY_UNLIKELY(first.m_object != last.m_object))
{
- JSON_THROW(invalid_iterator::create(210, "iterators do not fit", *this));
+ JSON_THROW(invalid_iterator::create(210, "iterators do not fit", this));
}
if (JSON_HEDLEY_UNLIKELY(first.m_object == this))
{
- JSON_THROW(invalid_iterator::create(211, "passed iterators may not belong to container", *this));
+ JSON_THROW(invalid_iterator::create(211, "passed iterators may not belong to container", this));
}
// insert to array and return iterator
@@ -3101,13 +3306,13 @@
// insert only works for arrays
if (JSON_HEDLEY_UNLIKELY(!is_array()))
{
- JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(309, detail::concat("cannot use insert() with ", type_name()), this));
}
// check if iterator pos fits to this JSON value
if (JSON_HEDLEY_UNLIKELY(pos.m_object != this))
{
- JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", this));
}
// insert to array and return iterator
@@ -3121,19 +3326,19 @@
// insert only works for objects
if (JSON_HEDLEY_UNLIKELY(!is_object()))
{
- JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(309, detail::concat("cannot use insert() with ", type_name()), this));
}
// check if range iterators belong to the same JSON object
if (JSON_HEDLEY_UNLIKELY(first.m_object != last.m_object))
{
- JSON_THROW(invalid_iterator::create(210, "iterators do not fit", *this));
+ JSON_THROW(invalid_iterator::create(210, "iterators do not fit", this));
}
// passed iterators must belong to objects
if (JSON_HEDLEY_UNLIKELY(!first.m_object->is_object()))
{
- JSON_THROW(invalid_iterator::create(202, "iterators first and last must point to objects", *this));
+ JSON_THROW(invalid_iterator::create(202, "iterators first and last must point to objects", this));
}
m_value.object->insert(first.m_it.object_iterator, last.m_it.object_iterator);
@@ -3160,19 +3365,19 @@
if (JSON_HEDLEY_UNLIKELY(!is_object()))
{
- JSON_THROW(type_error::create(312, "cannot use update() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(312, detail::concat("cannot use update() with ", type_name()), this));
}
// check if range iterators belong to the same JSON object
if (JSON_HEDLEY_UNLIKELY(first.m_object != last.m_object))
{
- JSON_THROW(invalid_iterator::create(210, "iterators do not fit", *this));
+ JSON_THROW(invalid_iterator::create(210, "iterators do not fit", this));
}
// passed iterators must belong to objects
if (JSON_HEDLEY_UNLIKELY(!first.m_object->is_object()))
{
- JSON_THROW(type_error::create(312, "cannot use update() with " + std::string(first.m_object->type_name()), *first.m_object));
+ JSON_THROW(type_error::create(312, detail::concat("cannot use update() with ", first.m_object->type_name()), first.m_object));
}
for (auto it = first; it != last; ++it)
@@ -3229,11 +3434,12 @@
// swap only works for arrays
if (JSON_HEDLEY_LIKELY(is_array()))
{
- std::swap(*(m_value.array), other);
+ using std::swap;
+ swap(*(m_value.array), other);
}
else
{
- JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(310, detail::concat("cannot use swap(array_t&) with ", type_name()), this));
}
}
@@ -3244,11 +3450,12 @@
// swap only works for objects
if (JSON_HEDLEY_LIKELY(is_object()))
{
- std::swap(*(m_value.object), other);
+ using std::swap;
+ swap(*(m_value.object), other);
}
else
{
- JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(310, detail::concat("cannot use swap(object_t&) with ", type_name()), this));
}
}
@@ -3259,11 +3466,12 @@
// swap only works for strings
if (JSON_HEDLEY_LIKELY(is_string()))
{
- std::swap(*(m_value.string), other);
+ using std::swap;
+ swap(*(m_value.string), other);
}
else
{
- JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(310, detail::concat("cannot use swap(string_t&) with ", type_name()), this));
}
}
@@ -3274,11 +3482,12 @@
// swap only works for strings
if (JSON_HEDLEY_LIKELY(is_binary()))
{
- std::swap(*(m_value.binary), other);
+ using std::swap;
+ swap(*(m_value.binary), other);
}
else
{
- JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(310, detail::concat("cannot use swap(binary_t&) with ", type_name()), this));
}
}
@@ -3289,17 +3498,17 @@
// swap only works for strings
if (JSON_HEDLEY_LIKELY(is_binary()))
{
- std::swap(*(m_value.binary), other);
+ using std::swap;
+ swap(*(m_value.binary), other);
}
else
{
- JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(310, detail::concat("cannot use swap(binary_t::container_type&) with ", type_name()), this));
}
}
/// @}
- public:
//////////////////////////////////////////
// lexicographical comparison operators //
//////////////////////////////////////////
@@ -3307,6 +3516,212 @@
/// @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
@@ -3315,71 +3730,7 @@
#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
@@ -3407,6 +3758,10 @@
/// @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);
}
@@ -3432,76 +3787,10 @@
/// @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
@@ -3526,6 +3815,10 @@
/// @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);
}
@@ -3551,6 +3844,11 @@
/// @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);
}
@@ -3576,6 +3874,10 @@
/// @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);
}
@@ -3596,6 +3898,9 @@
{
return basic_json(lhs) >= rhs;
}
+#endif
+
+#undef JSON_IMPLEMENT_OPERATOR
/// @}
@@ -3724,7 +4029,7 @@
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
@@ -3739,7 +4044,7 @@
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
@@ -3760,7 +4065,7 @@
// 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
@@ -3916,6 +4221,33 @@
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)
@@ -3951,7 +4283,7 @@
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);
}
@@ -3967,7 +4299,7 @@
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);
}
@@ -3994,7 +4326,7 @@
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);
}
@@ -4009,7 +4341,7 @@
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);
}
@@ -4024,7 +4356,7 @@
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);
}
@@ -4048,7 +4380,7 @@
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);
}
@@ -4063,7 +4395,7 @@
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);
}
@@ -4078,7 +4410,7 @@
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);
}
@@ -4102,7 +4434,38 @@
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);
}
@@ -4117,7 +4480,7 @@
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);
}
@@ -4132,7 +4495,7 @@
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);
}
@@ -4156,7 +4519,7 @@
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);
}
/// @}
@@ -4175,6 +4538,13 @@
return ptr.get_unchecked(this);
}
+ 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)
+ {
+ return ptr.get_unchecked(this);
+ }
+
/// @brief access specified element via JSON Pointer
/// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
const_reference operator[](const json_pointer& ptr) const
@@ -4182,6 +4552,13 @@
return ptr.get_unchecked(this);
}
+ 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
+ {
+ return ptr.get_unchecked(this);
+ }
+
/// @brief access specified element via JSON Pointer
/// @sa https://json.nlohmann.me/api/basic_json/at/
reference at(const json_pointer& ptr)
@@ -4189,6 +4566,13 @@
return ptr.get_checked(this);
}
+ template<typename BasicJsonType>
+ JSON_HEDLEY_DEPRECATED_FOR(3.11.0, basic_json::json_pointer or nlohmann::json_pointer<basic_json::string_t>) // NOLINT(readability/alt_tokens)
+ reference at(const ::nlohmann::json_pointer<BasicJsonType>& ptr)
+ {
+ return ptr.get_checked(this);
+ }
+
/// @brief access specified element via JSON Pointer
/// @sa https://json.nlohmann.me/api/basic_json/at/
const_reference at(const json_pointer& ptr) const
@@ -4196,6 +4580,13 @@
return ptr.get_checked(this);
}
+ template<typename BasicJsonType>
+ 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 at(const ::nlohmann::json_pointer<BasicJsonType>& ptr) const
+ {
+ return ptr.get_checked(this);
+ }
+
/// @brief return flattened JSON value
/// @sa https://json.nlohmann.me/api/basic_json/flatten/
basic_json flatten() const
@@ -4221,13 +4612,11 @@
/// @name JSON Patch functions
/// @{
- /// @brief applies a JSON patch
+ /// @brief applies a JSON patch in-place without copying the object
/// @sa https://json.nlohmann.me/api/basic_json/patch/
- basic_json patch(const basic_json& json_patch) const
+ void patch_inplace(const basic_json& json_patch)
{
- // make a working copy to apply the patch to
- basic_json result = *this;
-
+ basic_json& result = *this;
// the valid JSON Patch operations
enum class patch_operations {add, remove, replace, move, copy, test, invalid};
@@ -4281,7 +4670,8 @@
// get reference to parent of JSON pointer ptr
const auto last_path = ptr.back();
ptr.pop_back();
- basic_json& parent = result[ptr];
+ // parent must exist when performing patch add per RFC6902 specs
+ basic_json& parent = result.at(ptr);
switch (parent.m_type)
{
@@ -4302,11 +4692,11 @@
}
else
{
- const auto idx = json_pointer::array_index(last_path);
+ const auto idx = json_pointer::template array_index<basic_json_t>(last_path);
if (JSON_HEDLEY_UNLIKELY(idx > parent.size()))
{
// avoid undefined behavior
- JSON_THROW(out_of_range::create(401, "array index " + std::to_string(idx) + " is out of range", parent));
+ JSON_THROW(out_of_range::create(401, detail::concat("array index ", std::to_string(idx), " is out of range"), &parent));
}
// default case: insert add offset
@@ -4347,20 +4737,20 @@
}
else
{
- JSON_THROW(out_of_range::create(403, "key '" + last_path + "' not found", *this));
+ JSON_THROW(out_of_range::create(403, detail::concat("key '", last_path, "' not found"), this));
}
}
else if (parent.is_array())
{
// note erase performs range check
- parent.erase(json_pointer::array_index(last_path));
+ parent.erase(json_pointer::template array_index<basic_json_t>(last_path));
}
};
// type check: top level value must be an array
if (JSON_HEDLEY_UNLIKELY(!json_patch.is_array()))
{
- JSON_THROW(parse_error::create(104, 0, "JSON patch must be an array of objects", json_patch));
+ JSON_THROW(parse_error::create(104, 0, "JSON patch must be an array of objects", &json_patch));
}
// iterate and apply the operations
@@ -4375,20 +4765,20 @@
auto it = val.m_value.object->find(member);
// context-sensitive error message
- const auto error_msg = (op == "op") ? "operation" : "operation '" + op + "'";
+ const auto error_msg = (op == "op") ? "operation" : detail::concat("operation '", op, '\'');
// check if desired value is present
if (JSON_HEDLEY_UNLIKELY(it == val.m_value.object->end()))
{
// NOLINTNEXTLINE(performance-inefficient-string-concatenation)
- JSON_THROW(parse_error::create(105, 0, error_msg + " must have member '" + member + "'", val));
+ JSON_THROW(parse_error::create(105, 0, detail::concat(error_msg, " must have member '", member, "'"), &val));
}
// check if result is of type string
if (JSON_HEDLEY_UNLIKELY(string_type && !it->second.is_string()))
{
// NOLINTNEXTLINE(performance-inefficient-string-concatenation)
- JSON_THROW(parse_error::create(105, 0, error_msg + " must have string member '" + member + "'", val));
+ JSON_THROW(parse_error::create(105, 0, detail::concat(error_msg, " must have string member '", member, "'"), &val));
}
// no error: return value
@@ -4398,7 +4788,7 @@
// type check: every element of the array must be an object
if (JSON_HEDLEY_UNLIKELY(!val.is_object()))
{
- JSON_THROW(parse_error::create(104, 0, "JSON patch must be an array of objects", val));
+ JSON_THROW(parse_error::create(104, 0, "JSON patch must be an array of objects", &val));
}
// collect mandatory members
@@ -4476,7 +4866,7 @@
// throw an exception if test fails
if (JSON_HEDLEY_UNLIKELY(!success))
{
- JSON_THROW(other_error::create(501, "unsuccessful: " + val.dump(), val));
+ JSON_THROW(other_error::create(501, detail::concat("unsuccessful: ", val.dump()), &val));
}
break;
@@ -4487,11 +4877,18 @@
{
// op must be "add", "remove", "replace", "move", "copy", or
// "test"
- JSON_THROW(parse_error::create(105, 0, "operation value '" + op + "' is invalid", val));
+ JSON_THROW(parse_error::create(105, 0, detail::concat("operation value '", op, "' is invalid"), &val));
}
}
}
+ }
+ /// @brief applies a JSON patch to a copy of the current object
+ /// @sa https://json.nlohmann.me/api/basic_json/patch/
+ basic_json patch(const basic_json& json_patch) const
+ {
+ basic_json result = *this;
+ result.patch_inplace(json_patch);
return result;
}
@@ -4529,7 +4926,7 @@
while (i < source.size() && i < target.size())
{
// recursive call to compare array values at index i
- auto temp_diff = diff(source[i], target[i], path + "/" + std::to_string(i));
+ auto temp_diff = diff(source[i], target[i], detail::concat(path, '/', std::to_string(i)));
result.insert(result.end(), temp_diff.begin(), temp_diff.end());
++i;
}
@@ -4546,7 +4943,7 @@
result.insert(result.begin() + end_index, object(
{
{"op", "remove"},
- {"path", path + "/" + std::to_string(i)}
+ {"path", detail::concat(path, '/', std::to_string(i))}
}));
++i;
}
@@ -4557,7 +4954,7 @@
result.push_back(
{
{"op", "add"},
- {"path", path + "/-"},
+ {"path", detail::concat(path, "/-")},
{"value", target[i]}
});
++i;
@@ -4572,7 +4969,7 @@
for (auto it = source.cbegin(); it != source.cend(); ++it)
{
// escape the key name to be used in a JSON patch
- const auto path_key = path + "/" + detail::escape(it.key());
+ const auto path_key = detail::concat(path, '/', detail::escape(it.key()));
if (target.find(it.key()) != target.end())
{
@@ -4596,7 +4993,7 @@
if (source.find(it.key()) == source.end())
{
// found a key that is not in this -> add it
- const auto path_key = path + "/" + detail::escape(it.key());
+ const auto path_key = detail::concat(path, '/', detail::escape(it.key()));
result.push_back(
{
{"op", "add"}, {"path", path_key},
@@ -4629,7 +5026,6 @@
return result;
}
-
/// @}
////////////////////////////////
@@ -4678,7 +5074,30 @@
return j.dump();
}
-} // namespace nlohmann
+inline namespace literals
+{
+inline namespace json_literals
+{
+
+/// @brief user-defined string literal for JSON values
+/// @sa https://json.nlohmann.me/api/basic_json/operator_literal_json/
+JSON_HEDLEY_NON_NULL(1)
+inline nlohmann::json operator "" _json(const char* s, std::size_t n)
+{
+ return nlohmann::json::parse(s, s + n);
+}
+
+/// @brief user-defined string literal for JSON pointer
+/// @sa https://json.nlohmann.me/api/basic_json/operator_literal_json_pointer/
+JSON_HEDLEY_NON_NULL(1)
+inline nlohmann::json::json_pointer operator "" _json_pointer(const char* s, std::size_t n)
+{
+ return nlohmann::json::json_pointer(std::string(s, n));
+}
+
+} // namespace json_literals
+} // namespace literals
+NLOHMANN_JSON_NAMESPACE_END
///////////////////////
// nonmember support //
@@ -4706,10 +5125,14 @@
@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
}
};
@@ -4728,23 +5151,11 @@
#endif
-} // namespace std
+} // namespace std
-/// @brief user-defined string literal for JSON values
-/// @sa https://json.nlohmann.me/api/basic_json/operator_literal_json/
-JSON_HEDLEY_NON_NULL(1)
-inline nlohmann::json operator "" _json(const char* s, std::size_t n)
-{
- return nlohmann::json::parse(s, s + n);
-}
-
-/// @brief user-defined string literal for JSON pointer
-/// @sa https://json.nlohmann.me/api/basic_json/operator_literal_json_pointer/
-JSON_HEDLEY_NON_NULL(1)
-inline nlohmann::json::json_pointer operator "" _json_pointer(const char* s, std::size_t n)
-{
- return nlohmann::json::json_pointer(std::string(s, n));
-}
+#if JSON_USE_GLOBAL_UDLS
+ using namespace nlohmann::literals::json_literals; // NOLINT(build/namespaces_literals)
+#endif
#include <nlohmann/detail/macro_unscope.hpp>
diff --git a/include/nlohmann/json_fwd.hpp b/include/nlohmann/json_fwd.hpp
index 2d5ba38..c6f2871 100644
--- a/include/nlohmann/json_fwd.hpp
+++ b/include/nlohmann/json_fwd.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#ifndef INCLUDE_NLOHMANN_JSON_FWD_HPP_
#define INCLUDE_NLOHMANN_JSON_FWD_HPP_
@@ -7,13 +15,15 @@
#include <string> // string
#include <vector> // vector
+#include <nlohmann/detail/abi_macros.hpp>
+
/*!
@brief namespace for Niels Lohmann
@see https://github.com/nlohmann
@since version 1.0.0
*/
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
+
/*!
@brief default JSONSerializer template argument
@@ -59,6 +69,6 @@
/// @sa https://json.nlohmann.me/api/ordered_json/
using ordered_json = basic_json<nlohmann::ordered_map>;
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
#endif // INCLUDE_NLOHMANN_JSON_FWD_HPP_
diff --git a/include/nlohmann/ordered_map.hpp b/include/nlohmann/ordered_map.hpp
index bfcf89a..c9bd608 100644
--- a/include/nlohmann/ordered_map.hpp
+++ b/include/nlohmann/ordered_map.hpp
@@ -1,6 +1,14 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#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
@@ -10,9 +18,9 @@
#include <vector> // vector
#include <nlohmann/detail/macro_scope.hpp>
+#include <nlohmann/detail/meta/type_traits.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
/// ordered_map: a minimal map-like container that preserves insertion order
/// for use within nlohmann::basic_json<ordered_map>
@@ -27,44 +35,79 @@
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)
- ordered_map(const Allocator& alloc = Allocator()) : Container{alloc} {}
+ ordered_map() noexcept(noexcept(Container())) : Container{} {}
+ explicit ordered_map(const Allocator& alloc) noexcept(noexcept(Container(alloc))) : Container{alloc} {}
template <class It>
ordered_map(It first, It last, const Allocator& alloc = Allocator())
: Container{first, last, alloc} {}
- ordered_map(std::initializer_list<T> init, const Allocator& alloc = Allocator() )
+ ordered_map(std::initializer_list<value_type> init, const Allocator& alloc = Allocator() )
: Container{init, alloc} {}
std::pair<iterator, bool> emplace(const key_type& key, T&& t)
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == key)
+ if (m_compare(it->first, key))
{
return {it, false};
}
}
- Container::emplace_back(key, t);
- return {--this->end(), true};
+ Container::emplace_back(key, std::forward<T>(t));
+ return {std::prev(this->end()), true};
}
- T& operator[](const Key& key)
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ std::pair<iterator, bool> emplace(KeyType && key, T && t)
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (m_compare(it->first, key))
+ {
+ return {it, false};
+ }
+ }
+ Container::emplace_back(std::forward<KeyType>(key), std::forward<T>(t));
+ return {std::prev(this->end()), true};
+ }
+
+ T& operator[](const key_type& key)
{
return emplace(key, T{}).first->second;
}
- const T& operator[](const Key& key) const
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ T & operator[](KeyType && key)
+ {
+ return emplace(std::forward<KeyType>(key), T{}).first->second;
+ }
+
+ const T& operator[](const key_type& key) const
{
return at(key);
}
- T& at(const Key& key)
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ const T & operator[](KeyType && key) const
+ {
+ return at(std::forward<KeyType>(key));
+ }
+
+ T& at(const key_type& key)
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == key)
+ if (m_compare(it->first, key))
{
return it->second;
}
@@ -73,11 +116,13 @@
JSON_THROW(std::out_of_range("key not found"));
}
- const T& at(const Key& key) const
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ T & at(KeyType && key)
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == key)
+ if (m_compare(it->first, key))
{
return it->second;
}
@@ -86,11 +131,60 @@
JSON_THROW(std::out_of_range("key not found"));
}
- size_type erase(const Key& key)
+ const T& at(const key_type& key) const
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == key)
+ if (m_compare(it->first, key))
+ {
+ return it->second;
+ }
+ }
+
+ JSON_THROW(std::out_of_range("key not found"));
+ }
+
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ const T & at(KeyType && key) const
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (m_compare(it->first, key))
+ {
+ return it->second;
+ }
+ }
+
+ JSON_THROW(std::out_of_range("key not found"));
+ }
+
+ size_type erase(const key_type& key)
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ 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)
+ {
+ it->~value_type(); // Destroy but keep allocation
+ new (&*it) value_type{std::move(*next)};
+ }
+ Container::pop_back();
+ return 1;
+ }
+ }
+ return 0;
+ }
+
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ size_type erase(KeyType && key)
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ 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)
@@ -112,6 +206,11 @@
iterator erase(iterator first, iterator last)
{
+ if (first == last)
+ {
+ return first;
+ }
+
const auto elements_affected = std::distance(first, last);
const auto offset = std::distance(Container::begin(), first);
@@ -158,11 +257,11 @@
return Container::begin() + offset;
}
- size_type count(const Key& key) const
+ size_type count(const key_type& key) const
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == key)
+ if (m_compare(it->first, key))
{
return 1;
}
@@ -170,11 +269,25 @@
return 0;
}
- iterator find(const Key& key)
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ size_type count(KeyType && key) const
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == key)
+ if (m_compare(it->first, key))
+ {
+ return 1;
+ }
+ }
+ return 0;
+ }
+
+ iterator find(const key_type& key)
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (m_compare(it->first, key))
{
return it;
}
@@ -182,11 +295,25 @@
return Container::end();
}
- const_iterator find(const Key& key) const
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ iterator find(KeyType && key)
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == key)
+ if (m_compare(it->first, key))
+ {
+ return it;
+ }
+ }
+ return Container::end();
+ }
+
+ const_iterator find(const key_type& key) const
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (m_compare(it->first, key))
{
return it;
}
@@ -203,7 +330,7 @@
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == value.first)
+ if (m_compare(it->first, value.first))
{
return {it, false};
}
@@ -224,6 +351,9 @@
insert(*it);
}
}
+
+private:
+ JSON_NO_UNIQUE_ADDRESS key_compare m_compare = key_compare();
};
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
diff --git a/include/nlohmann/thirdparty/hedley/hedley.hpp b/include/nlohmann/thirdparty/hedley/hedley.hpp
index b309e98..714be31 100644
--- a/include/nlohmann/thirdparty/hedley/hedley.hpp
+++ b/include/nlohmann/thirdparty/hedley/hedley.hpp
@@ -1,15 +1,16 @@
#pragma once
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-FileCopyrightText: 2016-2021 Evan Nemerson <evan@nemerson.com>
+// SPDX-License-Identifier: MIT
+
/* Hedley - https://nemequ.github.io/hedley
* Created by Evan Nemerson <evan@nemerson.com>
- *
- * To the extent possible under law, the author(s) have dedicated all
- * copyright and related and neighboring rights to this software to
- * the public domain worldwide. This software is distributed without
- * any warranty.
- *
- * For details, see <http://creativecommons.org/publicdomain/zero/1.0/>.
- * SPDX-License-Identifier: CC0-1.0
*/
#if !defined(JSON_HEDLEY_VERSION) || (JSON_HEDLEY_VERSION < 15)
diff --git a/include/nlohmann/thirdparty/hedley/hedley_undef.hpp b/include/nlohmann/thirdparty/hedley/hedley_undef.hpp
index d2b37a1..09e7fbf 100644
--- a/include/nlohmann/thirdparty/hedley/hedley_undef.hpp
+++ b/include/nlohmann/thirdparty/hedley/hedley_undef.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#undef JSON_HEDLEY_ALWAYS_INLINE
diff --git a/meson.build b/meson.build
index d61dc25..3cd7dc8 100644
--- a/meson.build
+++ b/meson.build
@@ -1,6 +1,6 @@
project('nlohmann_json',
'cpp',
- version : '3.10.5',
+ version : '3.11.0',
license : 'MIT',
)
diff --git a/single_include/nlohmann/json.hpp b/single_include/nlohmann/json.hpp
index cb27e05..8a8a0a0 100644
--- a/single_include/nlohmann/json.hpp
+++ b/single_include/nlohmann/json.hpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | JSON for Modern C++
-| | |__ | | | | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
/****************************************************************************\
* Note on documentation: The source files contain links to the online *
@@ -33,16 +12,12 @@
* 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_
#define INCLUDE_NLOHMANN_JSON_HPP_
-#define NLOHMANN_JSON_VERSION_MAJOR 3
-#define NLOHMANN_JSON_VERSION_MINOR 10
-#define NLOHMANN_JSON_VERSION_PATCH 5
-
#include <algorithm> // all_of, find, for_each
#include <cstddef> // nullptr_t, ptrdiff_t, size_t
#include <functional> // hash, less
@@ -58,12 +33,108 @@
#include <vector> // vector
// #include <nlohmann/adl_serializer.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
-#include <type_traits>
+
#include <utility>
+// #include <nlohmann/detail/abi_macros.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+
+
+// This file contains all macro definitions affecting or depending on the ABI
+
+#ifndef JSON_SKIP_LIBRARY_VERSION_CHECK
+ #if defined(NLOHMANN_JSON_VERSION_MAJOR) && defined(NLOHMANN_JSON_VERSION_MINOR) && defined(NLOHMANN_JSON_VERSION_PATCH)
+ #if NLOHMANN_JSON_VERSION_MAJOR != 3 || NLOHMANN_JSON_VERSION_MINOR != 11 || NLOHMANN_JSON_VERSION_PATCH != 0
+ #warning "Already included a different version of the library!"
+ #endif
+ #endif
+#endif
+
+#define NLOHMANN_JSON_VERSION_MAJOR 3 // NOLINT(modernize-macro-to-enum)
+#define NLOHMANN_JSON_VERSION_MINOR 11 // NOLINT(modernize-macro-to-enum)
+#define NLOHMANN_JSON_VERSION_PATCH 0 // NOLINT(modernize-macro-to-enum)
+
+#ifndef JSON_DIAGNOSTICS
+ #define JSON_DIAGNOSTICS 0
+#endif
+
+#ifndef JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
+ #define JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON 0
+#endif
+
+#if JSON_DIAGNOSTICS
+ #define NLOHMANN_JSON_ABI_TAG_DIAGNOSTICS _diag
+#else
+ #define NLOHMANN_JSON_ABI_TAG_DIAGNOSTICS
+#endif
+
+#if JSON_USE_LEGACY_DISCARDED_VALUE_COMPARISON
+ #define NLOHMANN_JSON_ABI_TAG_LEGACY_DISCARDED_VALUE_COMPARISON _ldvcmp
+#else
+ #define NLOHMANN_JSON_ABI_TAG_LEGACY_DISCARDED_VALUE_COMPARISON
+#endif
+
+#define NLOHMANN_JSON_ABI_PREFIX_EX(major, minor, patch) \
+ json_v ## major ## _ ## minor ## _ ## patch
+#define NLOHMANN_JSON_ABI_PREFIX(major, minor, patch) \
+ NLOHMANN_JSON_ABI_PREFIX_EX(major, minor, patch)
+
+#define NLOHMANN_JSON_ABI_CONCAT_EX(a, b, c) a ## b ## c
+#define NLOHMANN_JSON_ABI_CONCAT(a, b, c) \
+ NLOHMANN_JSON_ABI_CONCAT_EX(a, b, c)
+
+#define NLOHMANN_JSON_ABI_STRING \
+ NLOHMANN_JSON_ABI_CONCAT( \
+ NLOHMANN_JSON_ABI_PREFIX( \
+ NLOHMANN_JSON_VERSION_MAJOR, \
+ NLOHMANN_JSON_VERSION_MINOR, \
+ NLOHMANN_JSON_VERSION_PATCH), \
+ NLOHMANN_JSON_ABI_TAG_DIAGNOSTICS, \
+ NLOHMANN_JSON_ABI_TAG_LEGACY_DISCARDED_VALUE_COMPARISON)
+
+#ifndef NLOHMANN_JSON_NAMESPACE
+ #define NLOHMANN_JSON_NAMESPACE nlohmann::NLOHMANN_JSON_ABI_STRING
+#endif
+
+#ifndef NLOHMANN_JSON_NAMESPACE_BEGIN
+#define NLOHMANN_JSON_NAMESPACE_BEGIN \
+ namespace nlohmann \
+ { \
+ inline namespace NLOHMANN_JSON_ABI_STRING \
+ {
+#endif
+
+#ifndef NLOHMANN_JSON_NAMESPACE_END
+#define NLOHMANN_JSON_NAMESPACE_END \
+ } /* namespace (abi_string) */ \
+ } /* namespace nlohmann */
+#endif
+
// #include <nlohmann/detail/conversions/from_json.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <algorithm> // transform
@@ -79,14 +150,31 @@
#include <valarray> // valarray
// #include <nlohmann/detail/exceptions.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include <cstddef> // nullptr_t
#include <exception> // exception
#include <stdexcept> // runtime_error
#include <string> // to_string
#include <vector> // vector
// #include <nlohmann/detail/value_t.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <array> // array
@@ -94,102 +182,130 @@
#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 <string>
// #include <nlohmann/detail/macro_scope.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <utility> // declval, pair
+// #include <nlohmann/detail/meta/detected.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+
+
+#include <type_traits>
+
+// #include <nlohmann/detail/meta/void_t.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+
+
+// #include <nlohmann/detail/abi_macros.hpp>
+
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
+namespace detail
+{
+
+template<typename ...Ts> struct make_void
+{
+ using type = void;
+};
+template<typename ...Ts> using void_t = typename make_void<Ts...>::type;
+
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
+
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
+namespace detail
+{
+
+// https://en.cppreference.com/w/cpp/experimental/is_detected
+struct nonesuch
+{
+ nonesuch() = delete;
+ ~nonesuch() = delete;
+ nonesuch(nonesuch const&) = delete;
+ nonesuch(nonesuch const&&) = delete;
+ void operator=(nonesuch const&) = delete;
+ void operator=(nonesuch&&) = delete;
+};
+
+template<class Default,
+ class AlwaysVoid,
+ template<class...> class Op,
+ class... Args>
+struct detector
+{
+ using value_t = std::false_type;
+ using type = Default;
+};
+
+template<class Default, template<class...> class Op, class... Args>
+struct detector<Default, void_t<Op<Args...>>, Op, Args...>
+{
+ using value_t = std::true_type;
+ using type = Op<Args...>;
+};
+
+template<template<class...> class Op, class... Args>
+using is_detected = typename detector<nonesuch, void, Op, Args...>::value_t;
+
+template<template<class...> class Op, class... Args>
+struct is_detected_lazy : is_detected<Op, Args...> { };
+
+template<template<class...> class Op, class... Args>
+using detected_t = typename detector<nonesuch, void, Op, Args...>::type;
+
+template<class Default, template<class...> class Op, class... Args>
+using detected_or = detector<Default, void, Op, Args...>;
+
+template<class Default, template<class...> class Op, class... Args>
+using detected_or_t = typename detected_or<Default, Op, Args...>::type;
+
+template<class Expected, template<class...> class Op, class... Args>
+using is_detected_exact = std::is_same<Expected, detected_t<Op, Args...>>;
+
+template<class To, template<class...> class Op, class... Args>
+using is_detected_convertible =
+ std::is_convertible<detected_t<Op, Args...>, To>;
+
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
+
// #include <nlohmann/thirdparty/hedley/hedley.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-FileCopyrightText: 2016-2021 Evan Nemerson <evan@nemerson.com>
+// SPDX-License-Identifier: MIT
+
/* Hedley - https://nemequ.github.io/hedley
* Created by Evan Nemerson <evan@nemerson.com>
- *
- * To the extent possible under law, the author(s) have dedicated all
- * copyright and related and neighboring rights to this software to
- * the public domain worldwide. This software is distributed without
- * any warranty.
- *
- * For details, see <http://creativecommons.org/publicdomain/zero/1.0/>.
- * SPDX-License-Identifier: CC0-1.0
*/
#if !defined(JSON_HEDLEY_VERSION) || (JSON_HEDLEY_VERSION < 15)
@@ -2223,87 +2339,13 @@
#endif /* !defined(JSON_HEDLEY_VERSION) || (JSON_HEDLEY_VERSION < X) */
-// #include <nlohmann/detail/meta/detected.hpp>
-
-#include <type_traits>
-
-// #include <nlohmann/detail/meta/void_t.hpp>
-
-
-namespace nlohmann
-{
-namespace detail
-{
-template<typename ...Ts> struct make_void
-{
- using type = void;
-};
-template<typename ...Ts> using void_t = typename make_void<Ts...>::type;
-} // namespace detail
-} // namespace nlohmann
-
-
-// https://en.cppreference.com/w/cpp/experimental/is_detected
-namespace nlohmann
-{
-namespace detail
-{
-struct nonesuch
-{
- nonesuch() = delete;
- ~nonesuch() = delete;
- nonesuch(nonesuch const&) = delete;
- nonesuch(nonesuch const&&) = delete;
- void operator=(nonesuch const&) = delete;
- void operator=(nonesuch&&) = delete;
-};
-
-template<class Default,
- class AlwaysVoid,
- template<class...> class Op,
- class... Args>
-struct detector
-{
- using value_t = std::false_type;
- using type = Default;
-};
-
-template<class Default, template<class...> class Op, class... Args>
-struct detector<Default, void_t<Op<Args...>>, Op, Args...>
-{
- using value_t = std::true_type;
- using type = Op<Args...>;
-};
-
-template<template<class...> class Op, class... Args>
-using is_detected = typename detector<nonesuch, void, Op, Args...>::value_t;
-
-template<template<class...> class Op, class... Args>
-struct is_detected_lazy : is_detected<Op, Args...> { };
-
-template<template<class...> class Op, class... Args>
-using detected_t = typename detector<nonesuch, void, Op, Args...>::type;
-
-template<class Default, template<class...> class Op, class... Args>
-using detected_or = detector<Default, void, Op, Args...>;
-
-template<class Default, template<class...> class Op, class... Args>
-using detected_or_t = typename detected_or<Default, Op, Args...>::type;
-
-template<class Expected, template<class...> class Op, class... Args>
-using is_detected_exact = std::is_same<Expected, detected_t<Op, Args...>>;
-
-template<class To, template<class...> class Op, class... Args>
-using is_detected_convertible =
- std::is_convertible<detected_t<Op, Args...>, To>;
-} // namespace detail
-} // namespace nlohmann
-
-
-// This file contains all internal macro definitions
+// This file contains all internal macro definitions (except those affecting ABI)
// You MUST include macro_unscope.hpp at the end of json.hpp to undef all of them
+// #include <nlohmann/detail/abi_macros.hpp>
+
+
// exclude unsupported compilers
#if !defined(JSON_SKIP_UNSUPPORTED_COMPILER_CHECK)
#if defined(__clang__)
@@ -2334,6 +2376,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)
@@ -2367,7 +2415,7 @@
#endif
// no filesystem support before MSVC 19.14: https://en.cppreference.com/w/cpp/compiler_support
- #if defined(_MSC_VER) && _MSC_VER < 1940
+ #if defined(_MSC_VER) && _MSC_VER < 1914
#undef JSON_HAS_FILESYSTEM
#undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
#endif
@@ -2394,6 +2442,38 @@
#define JSON_HAS_FILESYSTEM 0
#endif
+#ifndef JSON_HAS_THREE_WAY_COMPARISON
+ #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
+ #define JSON_NO_UNIQUE_ADDRESS
+#endif
+
// disable documentation warnings on clang
#if defined(__clang__)
#pragma clang diagnostic push
@@ -2631,6 +2711,7 @@
#define NLOHMANN_JSON_TO(v1) nlohmann_json_j[#v1] = nlohmann_json_t.v1;
#define NLOHMANN_JSON_FROM(v1) nlohmann_json_j.at(#v1).get_to(nlohmann_json_t.v1);
+#define NLOHMANN_JSON_FROM_WITH_DEFAULT(v1) nlohmann_json_t.v1 = nlohmann_json_j.value(#v1, nlohmann_json_default_obj.v1);
/*!
@brief macro
@@ -2641,6 +2722,10 @@
friend void to_json(nlohmann::json& nlohmann_json_j, const Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_TO, __VA_ARGS__)) } \
friend void from_json(const nlohmann::json& nlohmann_json_j, Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_FROM, __VA_ARGS__)) }
+#define NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT(Type, ...) \
+ friend void to_json(nlohmann::json& nlohmann_json_j, const Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_TO, __VA_ARGS__)) } \
+ friend void from_json(const nlohmann::json& nlohmann_json_j, Type& nlohmann_json_t) { Type nlohmann_json_default_obj; NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_FROM_WITH_DEFAULT, __VA_ARGS__)) }
+
/*!
@brief macro
@def NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE
@@ -2650,6 +2735,10 @@
inline void to_json(nlohmann::json& nlohmann_json_j, const Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_TO, __VA_ARGS__)) } \
inline void from_json(const nlohmann::json& nlohmann_json_j, Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_FROM, __VA_ARGS__)) }
+#define NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT(Type, ...) \
+ inline void to_json(nlohmann::json& nlohmann_json_j, const Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_TO, __VA_ARGS__)) } \
+ inline void from_json(const nlohmann::json& nlohmann_json_j, Type& nlohmann_json_t) { Type nlohmann_json_default_obj; NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_FROM_WITH_DEFAULT, __VA_ARGS__)) }
+
// inspired from https://stackoverflow.com/a/26745591
// allows to call any std function as if (e.g. with begin):
@@ -2699,13 +2788,132 @@
#define JSON_EXPLICIT explicit
#endif
-#ifndef JSON_DIAGNOSTICS
- #define JSON_DIAGNOSTICS 0
+#ifndef JSON_DISABLE_ENUM_SERIALIZATION
+ #define JSON_DISABLE_ENUM_SERIALIZATION 0
#endif
+#ifndef JSON_USE_GLOBAL_UDLS
+ #define JSON_USE_GLOBAL_UDLS 0
+#endif
-namespace nlohmann
+#if JSON_HAS_THREE_WAY_COMPARISON
+ #include <compare> // partial_ordering
+#endif
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
+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
+NLOHMANN_JSON_NAMESPACE_END
+
+// #include <nlohmann/detail/string_escape.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+
+
+// #include <nlohmann/detail/abi_macros.hpp>
+
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
@@ -2722,12 +2930,13 @@
@since version 2.0.0
*/
-inline void replace_substring(std::string& s, const std::string& f,
- const std::string& t)
+template<typename StringType>
+inline void replace_substring(StringType& s, const StringType& f,
+ const StringType& t)
{
JSON_ASSERT(!f.empty());
for (auto pos = s.find(f); // find first occurrence of f
- pos != std::string::npos; // make sure f was found
+ pos != StringType::npos; // make sure f was found
s.replace(pos, f.size(), t), // replace with t, and
pos = s.find(f, pos + t.size())) // find next occurrence of f
{}
@@ -2740,10 +2949,11 @@
*
* Note the order of escaping "~" to "~0" and "/" to "~1" is important.
*/
-inline std::string escape(std::string s)
+template<typename StringType>
+inline StringType escape(StringType s)
{
- replace_substring(s, "~", "~0");
- replace_substring(s, "/", "~1");
+ replace_substring(s, StringType{"~"}, StringType{"~0"});
+ replace_substring(s, StringType{"/"}, StringType{"~1"});
return s;
}
@@ -2754,24 +2964,36 @@
*
* Note the order of escaping "~1" to "/" and "~0" to "~" is important.
*/
-static void unescape(std::string& s)
+template<typename StringType>
+static void unescape(StringType& s)
{
- replace_substring(s, "~1", "/");
- replace_substring(s, "~0", "~");
+ replace_substring(s, StringType{"~1"}, StringType{"/"});
+ replace_substring(s, StringType{"~0"}, StringType{"~"});
}
-} // namespace detail
-} // namespace nlohmann
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/input/position_t.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <cstddef> // size_t
-namespace nlohmann
-{
+// #include <nlohmann/detail/abi_macros.hpp>
+
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
/// struct to capture the start position of the current token
struct position_t
{
@@ -2789,240 +3011,21 @@
}
};
-} // namespace detail
-} // namespace nlohmann
-
-// #include <nlohmann/detail/macro_scope.hpp>
-
-
-namespace nlohmann
-{
-namespace detail
-{
-////////////////
-// exceptions //
-////////////////
-
-/// @brief general exception of the @ref basic_json class
-/// @sa https://json.nlohmann.me/api/basic_json/exception/
-class exception : public std::exception
-{
- public:
- /// returns the explanatory string
- const char* what() const noexcept override
- {
- return m.what();
- }
-
- /// the id of the exception
- const int id; // NOLINT(cppcoreguidelines-non-private-member-variables-in-classes)
-
- protected:
- JSON_HEDLEY_NON_NULL(3)
- exception(int id_, const char* what_arg) : id(id_), m(what_arg) {} // NOLINT(bugprone-throw-keyword-missing)
-
- static std::string name(const std::string& ename, int id_)
- {
- return "[json.exception." + ename + "." + std::to_string(id_) + "] ";
- }
-
- template<typename BasicJsonType>
- static std::string diagnostics(const BasicJsonType& leaf_element)
- {
-#if JSON_DIAGNOSTICS
- std::vector<std::string> tokens;
- for (const auto* current = &leaf_element; current->m_parent != nullptr; current = current->m_parent)
- {
- switch (current->m_parent->type())
- {
- case value_t::array:
- {
- for (std::size_t i = 0; i < current->m_parent->m_value.array->size(); ++i)
- {
- if (¤t->m_parent->m_value.array->operator[](i) == current)
- {
- tokens.emplace_back(std::to_string(i));
- break;
- }
- }
- break;
- }
-
- case value_t::object:
- {
- for (const auto& element : *current->m_parent->m_value.object)
- {
- if (&element.second == current)
- {
- tokens.emplace_back(element.first.c_str());
- break;
- }
- }
- break;
- }
-
- case value_t::null: // LCOV_EXCL_LINE
- case value_t::string: // LCOV_EXCL_LINE
- case value_t::boolean: // LCOV_EXCL_LINE
- case value_t::number_integer: // LCOV_EXCL_LINE
- case value_t::number_unsigned: // LCOV_EXCL_LINE
- case value_t::number_float: // LCOV_EXCL_LINE
- case value_t::binary: // LCOV_EXCL_LINE
- case value_t::discarded: // LCOV_EXCL_LINE
- default: // LCOV_EXCL_LINE
- break; // LCOV_EXCL_LINE
- }
- }
-
- if (tokens.empty())
- {
- return "";
- }
-
- return "(" + std::accumulate(tokens.rbegin(), tokens.rend(), std::string{},
- [](const std::string & a, const std::string & b)
- {
- return a + "/" + detail::escape(b);
- }) + ") ";
-#else
- static_cast<void>(leaf_element);
- return "";
-#endif
- }
-
- private:
- /// an exception object as storage for error messages
- std::runtime_error m;
-};
-
-/// @brief exception indicating a parse error
-/// @sa https://json.nlohmann.me/api/basic_json/parse_error/
-class parse_error : public exception
-{
- public:
- /*!
- @brief create a parse error exception
- @param[in] id_ the id of the exception
- @param[in] pos the position where the error occurred (or with
- chars_read_total=0 if the position cannot be
- determined)
- @param[in] what_arg the explanatory string
- @return parse_error object
- */
- template<typename BasicJsonType>
- static parse_error create(int id_, const position_t& pos, const std::string& what_arg, const BasicJsonType& context)
- {
- std::string w = exception::name("parse_error", id_) + "parse error" +
- position_string(pos) + ": " + exception::diagnostics(context) + what_arg;
- return {id_, pos.chars_read_total, w.c_str()};
- }
-
- template<typename BasicJsonType>
- static parse_error create(int id_, std::size_t byte_, const std::string& what_arg, const BasicJsonType& context)
- {
- std::string w = exception::name("parse_error", id_) + "parse error" +
- (byte_ != 0 ? (" at byte " + std::to_string(byte_)) : "") +
- ": " + exception::diagnostics(context) + what_arg;
- return {id_, byte_, w.c_str()};
- }
-
- /*!
- @brief byte index of the parse error
-
- The byte index of the last read character in the input file.
-
- @note For an input with n bytes, 1 is the index of the first character and
- n+1 is the index of the terminating null byte or the end of file.
- This also holds true when reading a byte vector (CBOR or MessagePack).
- */
- const std::size_t byte;
-
- private:
- parse_error(int id_, std::size_t byte_, const char* what_arg)
- : exception(id_, what_arg), byte(byte_) {}
-
- static std::string position_string(const position_t& pos)
- {
- return " at line " + std::to_string(pos.lines_read + 1) +
- ", column " + std::to_string(pos.chars_read_current_line);
- }
-};
-
-/// @brief exception indicating errors with iterators
-/// @sa https://json.nlohmann.me/api/basic_json/invalid_iterator/
-class invalid_iterator : public exception
-{
- public:
- template<typename BasicJsonType>
- static invalid_iterator create(int id_, const std::string& what_arg, const BasicJsonType& context)
- {
- std::string w = exception::name("invalid_iterator", id_) + exception::diagnostics(context) + what_arg;
- return {id_, w.c_str()};
- }
-
- private:
- JSON_HEDLEY_NON_NULL(3)
- invalid_iterator(int id_, const char* what_arg)
- : exception(id_, what_arg) {}
-};
-
-/// @brief exception indicating executing a member function with a wrong type
-/// @sa https://json.nlohmann.me/api/basic_json/type_error/
-class type_error : public exception
-{
- public:
- template<typename BasicJsonType>
- static type_error create(int id_, const std::string& what_arg, const BasicJsonType& context)
- {
- std::string w = exception::name("type_error", id_) + exception::diagnostics(context) + what_arg;
- return {id_, w.c_str()};
- }
-
- private:
- JSON_HEDLEY_NON_NULL(3)
- type_error(int id_, const char* what_arg) : exception(id_, what_arg) {}
-};
-
-/// @brief exception indicating access out of the defined range
-/// @sa https://json.nlohmann.me/api/basic_json/out_of_range/
-class out_of_range : public exception
-{
- public:
- template<typename BasicJsonType>
- static out_of_range create(int id_, const std::string& what_arg, const BasicJsonType& context)
- {
- std::string w = exception::name("out_of_range", id_) + exception::diagnostics(context) + what_arg;
- return {id_, w.c_str()};
- }
-
- private:
- JSON_HEDLEY_NON_NULL(3)
- out_of_range(int id_, const char* what_arg) : exception(id_, what_arg) {}
-};
-
-/// @brief exception indicating other library errors
-/// @sa https://json.nlohmann.me/api/basic_json/other_error/
-class other_error : public exception
-{
- public:
- template<typename BasicJsonType>
- static other_error create(int id_, const std::string& what_arg, const BasicJsonType& context)
- {
- std::string w = exception::name("other_error", id_) + exception::diagnostics(context) + what_arg;
- return {id_, w.c_str()};
- }
-
- private:
- JSON_HEDLEY_NON_NULL(3)
- other_error(int id_, const char* what_arg) : exception(id_, what_arg) {}
-};
-
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/macro_scope.hpp>
// #include <nlohmann/detail/meta/cpp_future.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-FileCopyrightText: 2018 The Abseil Authors
+// SPDX-License-Identifier: MIT
+
#include <cstddef> // size_t
@@ -3032,8 +3035,7 @@
// #include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
@@ -3173,25 +3175,25 @@
static constexpr T value{};
};
-template<typename T>
-constexpr T static_const<T>::value; // NOLINT(readability-redundant-declaration)
+#ifndef JSON_HAS_CPP_17
+
+ template<typename T>
+ constexpr T static_const<T>::value; // NOLINT(readability-redundant-declaration)
+
+#endif
} // namespace detail
-} // namespace nlohmann
-
-// #include <nlohmann/detail/meta/identity_tag.hpp>
-
-
-namespace nlohmann
-{
-namespace detail
-{
-// dispatching helper struct
-template <class T> struct identity_tag {};
-} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/meta/type_traits.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <limits> // numeric_limits
@@ -3199,23 +3201,30 @@
#include <utility> // declval
#include <tuple> // tuple
-// #include <nlohmann/detail/macro_scope.hpp>
-
-
// #include <nlohmann/detail/iterators/iterator_traits.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <iterator> // random_access_iterator_tag
+// #include <nlohmann/detail/abi_macros.hpp>
+
// #include <nlohmann/detail/meta/void_t.hpp>
// #include <nlohmann/detail/meta/cpp_future.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
template<typename It, typename = void>
struct iterator_types {};
@@ -3254,104 +3263,135 @@
using pointer = T*;
using reference = T&;
};
-} // namespace detail
-} // namespace nlohmann
+
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
+
+// #include <nlohmann/detail/macro_scope.hpp>
// #include <nlohmann/detail/meta/call_std/begin.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
// #include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
+
NLOHMANN_CAN_CALL_STD_FUNC_IMPL(begin);
-} // namespace nlohmann
+
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/meta/call_std/end.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
// #include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
+
NLOHMANN_CAN_CALL_STD_FUNC_IMPL(end);
-} // namespace nlohmann
+
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/meta/cpp_future.hpp>
// #include <nlohmann/detail/meta/detected.hpp>
// #include <nlohmann/json_fwd.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#ifndef INCLUDE_NLOHMANN_JSON_FWD_HPP_
-#define INCLUDE_NLOHMANN_JSON_FWD_HPP_
+ #define INCLUDE_NLOHMANN_JSON_FWD_HPP_
-#include <cstdint> // int64_t, uint64_t
-#include <map> // map
-#include <memory> // allocator
-#include <string> // string
-#include <vector> // vector
+ #include <cstdint> // int64_t, uint64_t
+ #include <map> // map
+ #include <memory> // allocator
+ #include <string> // string
+ #include <vector> // vector
-/*!
-@brief namespace for Niels Lohmann
-@see https://github.com/nlohmann
-@since version 1.0.0
-*/
-namespace nlohmann
-{
-/*!
-@brief default JSONSerializer template argument
+ // #include <nlohmann/detail/abi_macros.hpp>
-This serializer ignores the template arguments and uses ADL
-([argument-dependent lookup](https://en.cppreference.com/w/cpp/language/adl))
-for serialization.
-*/
-template<typename T = void, typename SFINAE = void>
-struct adl_serializer;
-/// a class to store JSON values
-/// @sa https://json.nlohmann.me/api/basic_json/
-template<template<typename U, typename V, typename... Args> class ObjectType =
- std::map,
- template<typename U, typename... Args> class ArrayType = std::vector,
- class StringType = std::string, class BooleanType = bool,
- class NumberIntegerType = std::int64_t,
- class NumberUnsignedType = std::uint64_t,
- class NumberFloatType = double,
- template<typename U> class AllocatorType = std::allocator,
- template<typename T, typename SFINAE = void> class JSONSerializer =
- adl_serializer,
- class BinaryType = std::vector<std::uint8_t>>
-class basic_json;
+ /*!
+ @brief namespace for Niels Lohmann
+ @see https://github.com/nlohmann
+ @since version 1.0.0
+ */
+ NLOHMANN_JSON_NAMESPACE_BEGIN
-/// @brief JSON Pointer defines a string syntax for identifying a specific value within a JSON document
-/// @sa https://json.nlohmann.me/api/json_pointer/
-template<typename BasicJsonType>
-class json_pointer;
+ /*!
+ @brief default JSONSerializer template argument
-/*!
-@brief default specialization
-@sa https://json.nlohmann.me/api/json/
-*/
-using json = basic_json<>;
+ This serializer ignores the template arguments and uses ADL
+ ([argument-dependent lookup](https://en.cppreference.com/w/cpp/language/adl))
+ for serialization.
+ */
+ template<typename T = void, typename SFINAE = void>
+ struct adl_serializer;
-/// @brief a minimal map-like container that preserves insertion order
-/// @sa https://json.nlohmann.me/api/ordered_map/
-template<class Key, class T, class IgnoredLess, class Allocator>
-struct ordered_map;
+ /// a class to store JSON values
+ /// @sa https://json.nlohmann.me/api/basic_json/
+ template<template<typename U, typename V, typename... Args> class ObjectType =
+ std::map,
+ template<typename U, typename... Args> class ArrayType = std::vector,
+ class StringType = std::string, class BooleanType = bool,
+ class NumberIntegerType = std::int64_t,
+ class NumberUnsignedType = std::uint64_t,
+ class NumberFloatType = double,
+ template<typename U> class AllocatorType = std::allocator,
+ template<typename T, typename SFINAE = void> class JSONSerializer =
+ adl_serializer,
+ class BinaryType = std::vector<std::uint8_t>>
+ class basic_json;
-/// @brief specialization that maintains the insertion order of object keys
-/// @sa https://json.nlohmann.me/api/ordered_json/
-using ordered_json = basic_json<nlohmann::ordered_map>;
+ /// @brief JSON Pointer defines a string syntax for identifying a specific value within a JSON document
+ /// @sa https://json.nlohmann.me/api/json_pointer/
+ template<typename BasicJsonType>
+ class json_pointer;
-} // namespace nlohmann
+ /*!
+ @brief default specialization
+ @sa https://json.nlohmann.me/api/json/
+ */
+ using json = basic_json<>;
+
+ /// @brief a minimal map-like container that preserves insertion order
+ /// @sa https://json.nlohmann.me/api/ordered_map/
+ template<class Key, class T, class IgnoredLess, class Allocator>
+ struct ordered_map;
+
+ /// @brief specialization that maintains the insertion order of object keys
+ /// @sa https://json.nlohmann.me/api/ordered_json/
+ using ordered_json = basic_json<nlohmann::ordered_map>;
+
+ NLOHMANN_JSON_NAMESPACE_END
#endif // INCLUDE_NLOHMANN_JSON_FWD_HPP_
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
/*!
@brief detail namespace with internal helper functions
@@ -3362,6 +3402,7 @@
*/
namespace detail
{
+
/////////////
// helpers //
/////////////
@@ -3380,6 +3421,16 @@
NLOHMANN_BASIC_JSON_TPL_DECLARATION
struct is_basic_json<NLOHMANN_BASIC_JSON_TPL> : std::true_type {};
+// used by exceptions create() member functions
+// true_type for pointer to possibly cv-qualified basic_json or std::nullptr_t
+// false_type otherwise
+template<typename BasicJsonContext>
+struct is_basic_json_context :
+ std::integral_constant < bool,
+ is_basic_json<typename std::remove_cv<typename std::remove_pointer<BasicJsonContext>::type>::type>::value
+ || std::is_same<BasicJsonContext, std::nullptr_t>::value >
+{};
+
//////////////////////
// json_ref helpers //
//////////////////////
@@ -3481,6 +3532,24 @@
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 //
@@ -3488,10 +3557,10 @@
// https://en.cppreference.com/w/cpp/types/conjunction
template<class...> struct conjunction : std::true_type { };
-template<class B1> struct conjunction<B1> : B1 { };
-template<class B1, class... Bn>
-struct conjunction<B1, Bn...>
-: std::conditional<bool(B1::value), conjunction<Bn...>, B1>::type {};
+template<class B> struct conjunction<B> : B { };
+template<class B, class... Bn>
+struct conjunction<B, Bn...>
+: 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 > { };
@@ -3655,9 +3724,18 @@
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,
- typename BasicJsonType::string_t>::value;
+ conjunction <
+ is_constructible<laundered_type, typename BasicJsonType::string_t>,
+ is_detected_exact<typename BasicJsonType::string_t::value_type,
+ value_type_t, laundered_type >>::value;
};
template<typename BasicJsonType, typename CompatibleArrayType, typename = void>
@@ -3775,6 +3853,81 @@
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 {};
+
+template<typename T>
+using detect_is_transparent = typename T::is_transparent;
+
+// type trait to check if KeyType can be used as object key (without a BasicJsonType)
+// see is_usable_as_basic_json_key_type below
+template<typename Comparator, typename ObjectKeyType, typename KeyTypeCVRef, bool RequireTransparentComparator = true,
+ bool ExcludeObjectKeyType = RequireTransparentComparator, typename KeyType = uncvref_t<KeyTypeCVRef>>
+using is_usable_as_key_type = typename std::conditional <
+ is_comparable<Comparator, ObjectKeyType, KeyTypeCVRef>::value
+ && !(ExcludeObjectKeyType && std::is_same<KeyType,
+ ObjectKeyType>::value)
+ && (!RequireTransparentComparator
+ || is_detected <detect_is_transparent, Comparator>::value)
+ && !is_json_pointer<KeyType>::value,
+ std::true_type,
+ std::false_type >::type;
+
+// 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_basic_json_key_type = typename std::conditional <
+ is_usable_as_key_type<typename BasicJsonType::object_comparator_t,
+ typename BasicJsonType::object_t::key_type, KeyTypeCVRef,
+ RequireTransparentComparator, ExcludeObjectKeyType>::value
+ && !is_json_iterator_of<BasicJsonType, 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>
@@ -3806,36 +3959,564 @@
return value;
}
-} // namespace detail
-} // namespace nlohmann
+template<typename... Types>
+using all_integral = conjunction<std::is_integral<Types>...>;
-// #include <nlohmann/detail/value_t.hpp>
+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
+NLOHMANN_JSON_NAMESPACE_END
+
+// #include <nlohmann/detail/string_concat.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+
+
+#include <cstring> // strlen
+#include <string> // string
+#include <utility> // forward
+
+// #include <nlohmann/detail/meta/cpp_future.hpp>
+
+// #include <nlohmann/detail/meta/detected.hpp>
+
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
+namespace detail
+{
+
+inline std::size_t concat_length()
+{
+ return 0;
+}
+
+template<typename... Args>
+inline std::size_t concat_length(const char* cstr, Args&& ... rest);
+
+template<typename StringType, typename... Args>
+inline std::size_t concat_length(const StringType& str, Args&& ... rest);
+
+template<typename... Args>
+inline std::size_t concat_length(const char /*c*/, Args&& ... rest)
+{
+ return 1 + concat_length(std::forward<Args>(rest)...);
+}
+
+template<typename... Args>
+inline std::size_t concat_length(const char* cstr, Args&& ... rest)
+{
+ // cppcheck-suppress ignoredReturnValue
+ return ::strlen(cstr) + concat_length(std::forward<Args>(rest)...);
+}
+
+template<typename StringType, typename... Args>
+inline std::size_t concat_length(const StringType& str, Args&& ... rest)
+{
+ return str.size() + concat_length(std::forward<Args>(rest)...);
+}
+
+template<typename OutStringType>
+inline void concat_into(OutStringType& /*out*/)
+{}
+
+template<typename StringType, typename Arg>
+using string_can_append = decltype(std::declval<StringType&>().append(std::declval < Arg && > ()));
+
+template<typename StringType, typename Arg>
+using detect_string_can_append = is_detected<string_can_append, StringType, Arg>;
+
+template<typename StringType, typename Arg>
+using string_can_append_op = decltype(std::declval<StringType&>() += std::declval < Arg && > ());
+
+template<typename StringType, typename Arg>
+using detect_string_can_append_op = is_detected<string_can_append_op, StringType, Arg>;
+
+template<typename StringType, typename Arg>
+using string_can_append_iter = decltype(std::declval<StringType&>().append(std::declval<const Arg&>().begin(), std::declval<const Arg&>().end()));
+
+template<typename StringType, typename Arg>
+using detect_string_can_append_iter = is_detected<string_can_append_iter, StringType, Arg>;
+
+template<typename StringType, typename Arg>
+using string_can_append_data = decltype(std::declval<StringType&>().append(std::declval<const Arg&>().data(), std::declval<const Arg&>().size()));
+
+template<typename StringType, typename Arg>
+using detect_string_can_append_data = is_detected<string_can_append_data, StringType, Arg>;
+
+template < typename OutStringType, typename Arg, typename... Args,
+ enable_if_t < !detect_string_can_append<OutStringType, Arg>::value
+ && detect_string_can_append_op<OutStringType, Arg>::value, int > = 0 >
+inline void concat_into(OutStringType& out, Arg && arg, Args && ... rest);
+
+template < typename OutStringType, typename Arg, typename... Args,
+ enable_if_t < !detect_string_can_append<OutStringType, Arg>::value
+ && !detect_string_can_append_op<OutStringType, Arg>::value
+ && detect_string_can_append_iter<OutStringType, Arg>::value, int > = 0 >
+inline void concat_into(OutStringType& out, const Arg& arg, Args && ... rest);
+
+template < typename OutStringType, typename Arg, typename... Args,
+ enable_if_t < !detect_string_can_append<OutStringType, Arg>::value
+ && !detect_string_can_append_op<OutStringType, Arg>::value
+ && !detect_string_can_append_iter<OutStringType, Arg>::value
+ && detect_string_can_append_data<OutStringType, Arg>::value, int > = 0 >
+inline void concat_into(OutStringType& out, const Arg& arg, Args && ... rest);
+
+template<typename OutStringType, typename Arg, typename... Args,
+ enable_if_t<detect_string_can_append<OutStringType, Arg>::value, int> = 0>
+inline void concat_into(OutStringType& out, Arg && arg, Args && ... rest)
+{
+ out.append(std::forward<Arg>(arg));
+ concat_into(out, std::forward<Args>(rest)...);
+}
+
+template < typename OutStringType, typename Arg, typename... Args,
+ enable_if_t < !detect_string_can_append<OutStringType, Arg>::value
+ && detect_string_can_append_op<OutStringType, Arg>::value, int > >
+inline void concat_into(OutStringType& out, Arg&& arg, Args&& ... rest)
+{
+ out += std::forward<Arg>(arg);
+ concat_into(out, std::forward<Args>(rest)...);
+}
+
+template < typename OutStringType, typename Arg, typename... Args,
+ enable_if_t < !detect_string_can_append<OutStringType, Arg>::value
+ && !detect_string_can_append_op<OutStringType, Arg>::value
+ && detect_string_can_append_iter<OutStringType, Arg>::value, int > >
+inline void concat_into(OutStringType& out, const Arg& arg, Args&& ... rest)
+{
+ out.append(arg.begin(), arg.end());
+ concat_into(out, std::forward<Args>(rest)...);
+}
+
+template < typename OutStringType, typename Arg, typename... Args,
+ enable_if_t < !detect_string_can_append<OutStringType, Arg>::value
+ && !detect_string_can_append_op<OutStringType, Arg>::value
+ && !detect_string_can_append_iter<OutStringType, Arg>::value
+ && detect_string_can_append_data<OutStringType, Arg>::value, int > >
+inline void concat_into(OutStringType& out, const Arg& arg, Args&& ... rest)
+{
+ out.append(arg.data(), arg.size());
+ concat_into(out, std::forward<Args>(rest)...);
+}
+
+template<typename OutStringType = std::string, typename... Args>
+inline OutStringType concat(Args && ... args)
+{
+ OutStringType str;
+ str.reserve(concat_length(std::forward<Args>(args)...));
+ concat_into(str, std::forward<Args>(args)...);
+ return str;
+}
+
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
+
+
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
+namespace detail
+{
+
+////////////////
+// exceptions //
+////////////////
+
+/// @brief general exception of the @ref basic_json class
+/// @sa https://json.nlohmann.me/api/basic_json/exception/
+class exception : public std::exception
+{
+ public:
+ /// returns the explanatory string
+ const char* what() const noexcept override
+ {
+ return m.what();
+ }
+
+ /// the id of the exception
+ const int id; // NOLINT(cppcoreguidelines-non-private-member-variables-in-classes)
+
+ protected:
+ JSON_HEDLEY_NON_NULL(3)
+ exception(int id_, const char* what_arg) : id(id_), m(what_arg) {} // NOLINT(bugprone-throw-keyword-missing)
+
+ static std::string name(const std::string& ename, int id_)
+ {
+ return concat("[json.exception.", ename, '.', std::to_string(id_), "] ");
+ }
+
+ static std::string diagnostics(std::nullptr_t /*leaf_element*/)
+ {
+ return "";
+ }
+
+ template<typename BasicJsonType>
+ static std::string diagnostics(const BasicJsonType* leaf_element)
+ {
+#if JSON_DIAGNOSTICS
+ std::vector<std::string> tokens;
+ for (const auto* current = leaf_element; current != nullptr && current->m_parent != nullptr; current = current->m_parent)
+ {
+ switch (current->m_parent->type())
+ {
+ case value_t::array:
+ {
+ for (std::size_t i = 0; i < current->m_parent->m_value.array->size(); ++i)
+ {
+ if (¤t->m_parent->m_value.array->operator[](i) == current)
+ {
+ tokens.emplace_back(std::to_string(i));
+ break;
+ }
+ }
+ break;
+ }
+
+ case value_t::object:
+ {
+ for (const auto& element : *current->m_parent->m_value.object)
+ {
+ if (&element.second == current)
+ {
+ tokens.emplace_back(element.first.c_str());
+ break;
+ }
+ }
+ break;
+ }
+
+ case value_t::null: // LCOV_EXCL_LINE
+ case value_t::string: // LCOV_EXCL_LINE
+ case value_t::boolean: // LCOV_EXCL_LINE
+ case value_t::number_integer: // LCOV_EXCL_LINE
+ case value_t::number_unsigned: // LCOV_EXCL_LINE
+ case value_t::number_float: // LCOV_EXCL_LINE
+ case value_t::binary: // LCOV_EXCL_LINE
+ case value_t::discarded: // LCOV_EXCL_LINE
+ default: // LCOV_EXCL_LINE
+ break; // LCOV_EXCL_LINE
+ }
+ }
+
+ if (tokens.empty())
+ {
+ return "";
+ }
+
+ auto str = std::accumulate(tokens.rbegin(), tokens.rend(), std::string{},
+ [](const std::string & a, const std::string & b)
+ {
+ return concat(a, '/', detail::escape(b));
+ });
+ return concat('(', str, ") ");
+#else
+ static_cast<void>(leaf_element);
+ return "";
+#endif
+ }
+
+ private:
+ /// an exception object as storage for error messages
+ std::runtime_error m;
+};
+
+/// @brief exception indicating a parse error
+/// @sa https://json.nlohmann.me/api/basic_json/parse_error/
+class parse_error : public exception
+{
+ public:
+ /*!
+ @brief create a parse error exception
+ @param[in] id_ the id of the exception
+ @param[in] pos the position where the error occurred (or with
+ chars_read_total=0 if the position cannot be
+ determined)
+ @param[in] what_arg the explanatory string
+ @return parse_error object
+ */
+ template<typename BasicJsonContext, enable_if_t<is_basic_json_context<BasicJsonContext>::value, int> = 0>
+ static parse_error create(int id_, const position_t& pos, const std::string& what_arg, BasicJsonContext context)
+ {
+ std::string w = concat(exception::name("parse_error", id_), "parse error",
+ position_string(pos), ": ", exception::diagnostics(context), what_arg);
+ return {id_, pos.chars_read_total, w.c_str()};
+ }
+
+ template<typename BasicJsonContext, enable_if_t<is_basic_json_context<BasicJsonContext>::value, int> = 0>
+ static parse_error create(int id_, std::size_t byte_, const std::string& what_arg, BasicJsonContext context)
+ {
+ std::string w = concat(exception::name("parse_error", id_), "parse error",
+ (byte_ != 0 ? (concat(" at byte ", std::to_string(byte_))) : ""),
+ ": ", exception::diagnostics(context), what_arg);
+ return {id_, byte_, w.c_str()};
+ }
+
+ /*!
+ @brief byte index of the parse error
+
+ The byte index of the last read character in the input file.
+
+ @note For an input with n bytes, 1 is the index of the first character and
+ n+1 is the index of the terminating null byte or the end of file.
+ This also holds true when reading a byte vector (CBOR or MessagePack).
+ */
+ const std::size_t byte;
+
+ private:
+ parse_error(int id_, std::size_t byte_, const char* what_arg)
+ : exception(id_, what_arg), byte(byte_) {}
+
+ static std::string position_string(const position_t& pos)
+ {
+ return concat(" at line ", std::to_string(pos.lines_read + 1),
+ ", column ", std::to_string(pos.chars_read_current_line));
+ }
+};
+
+/// @brief exception indicating errors with iterators
+/// @sa https://json.nlohmann.me/api/basic_json/invalid_iterator/
+class invalid_iterator : public exception
+{
+ public:
+ template<typename BasicJsonContext, enable_if_t<is_basic_json_context<BasicJsonContext>::value, int> = 0>
+ static invalid_iterator create(int id_, const std::string& what_arg, BasicJsonContext context)
+ {
+ std::string w = concat(exception::name("invalid_iterator", id_), exception::diagnostics(context), what_arg);
+ return {id_, w.c_str()};
+ }
+
+ private:
+ JSON_HEDLEY_NON_NULL(3)
+ invalid_iterator(int id_, const char* what_arg)
+ : exception(id_, what_arg) {}
+};
+
+/// @brief exception indicating executing a member function with a wrong type
+/// @sa https://json.nlohmann.me/api/basic_json/type_error/
+class type_error : public exception
+{
+ public:
+ template<typename BasicJsonContext, enable_if_t<is_basic_json_context<BasicJsonContext>::value, int> = 0>
+ static type_error create(int id_, const std::string& what_arg, BasicJsonContext context)
+ {
+ std::string w = concat(exception::name("type_error", id_), exception::diagnostics(context), what_arg);
+ return {id_, w.c_str()};
+ }
+
+ private:
+ JSON_HEDLEY_NON_NULL(3)
+ type_error(int id_, const char* what_arg) : exception(id_, what_arg) {}
+};
+
+/// @brief exception indicating access out of the defined range
+/// @sa https://json.nlohmann.me/api/basic_json/out_of_range/
+class out_of_range : public exception
+{
+ public:
+ template<typename BasicJsonContext, enable_if_t<is_basic_json_context<BasicJsonContext>::value, int> = 0>
+ static out_of_range create(int id_, const std::string& what_arg, BasicJsonContext context)
+ {
+ std::string w = concat(exception::name("out_of_range", id_), exception::diagnostics(context), what_arg);
+ return {id_, w.c_str()};
+ }
+
+ private:
+ JSON_HEDLEY_NON_NULL(3)
+ out_of_range(int id_, const char* what_arg) : exception(id_, what_arg) {}
+};
+
+/// @brief exception indicating other library errors
+/// @sa https://json.nlohmann.me/api/basic_json/other_error/
+class other_error : public exception
+{
+ public:
+ template<typename BasicJsonContext, enable_if_t<is_basic_json_context<BasicJsonContext>::value, int> = 0>
+ static other_error create(int id_, const std::string& what_arg, BasicJsonContext context)
+ {
+ std::string w = concat(exception::name("other_error", id_), exception::diagnostics(context), what_arg);
+ return {id_, w.c_str()};
+ }
+
+ private:
+ JSON_HEDLEY_NON_NULL(3)
+ other_error(int id_, const char* what_arg) : exception(id_, what_arg) {}
+};
+
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+// #include <nlohmann/detail/meta/cpp_future.hpp>
+
+// #include <nlohmann/detail/meta/identity_tag.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+
+
+// #include <nlohmann/detail/abi_macros.hpp>
+
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
+namespace detail
+{
+
+// dispatching helper struct
+template <class T> struct identity_tag {};
+
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
+
+// #include <nlohmann/detail/meta/std_fs.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+
+
+// #include <nlohmann/detail/macro_scope.hpp>
#if JSON_HAS_EXPERIMENTAL_FILESYSTEM
#include <experimental/filesystem>
-namespace nlohmann::detail
-{
-namespace std_fs = std::experimental::filesystem;
-} // namespace nlohmann::detail
-#elif JSON_HAS_FILESYSTEM
-#include <filesystem>
-namespace nlohmann::detail
-{
-namespace std_fs = std::filesystem;
-} // namespace nlohmann::detail
-#endif
-
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+namespace std_fs = std::experimental::filesystem;
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
+#elif JSON_HAS_FILESYSTEM
+#include <filesystem>
+NLOHMANN_JSON_NAMESPACE_BEGIN
+namespace detail
+{
+namespace std_fs = std::filesystem;
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
+#endif
+
+// #include <nlohmann/detail/meta/type_traits.hpp>
+
+// #include <nlohmann/detail/string_concat.hpp>
+
+// #include <nlohmann/detail/value_t.hpp>
+
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
+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()))
{
- JSON_THROW(type_error::create(302, "type must be null, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be null, but is ", j.type_name()), &j));
}
n = nullptr;
}
@@ -3873,82 +4554,84 @@
case value_t::binary:
case value_t::discarded:
default:
- JSON_THROW(type_error::create(302, "type must be number, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be number, but is ", j.type_name()), &j));
}
}
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()))
{
- JSON_THROW(type_error::create(302, "type must be boolean, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be boolean, but is ", j.type_name()), &j));
}
b = *j.template get_ptr<const typename BasicJsonType::boolean_t*>();
}
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()))
{
- JSON_THROW(type_error::create(302, "type must be string, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be string, but is ", j.type_name()), &j));
}
s = *j.template get_ptr<const typename BasicJsonType::string_t*>();
}
template <
- typename BasicJsonType, typename ConstructibleStringType,
+ typename BasicJsonType, typename StringType,
enable_if_t <
- is_constructible_string_type<BasicJsonType, ConstructibleStringType>::value&&
- !std::is_same<typename BasicJsonType::string_t,
- ConstructibleStringType>::value,
- int > = 0 >
-void from_json(const BasicJsonType& j, ConstructibleStringType& s)
+ std::is_assignable<StringType&, const typename BasicJsonType::string_t>::value
+ && is_detected_exact<typename BasicJsonType::string_t::value_type, value_type_t, StringType>::value
+ && !std::is_same<typename BasicJsonType::string_t, StringType>::value
+ && !is_json_ref<StringType>::value, int > = 0 >
+inline void from_json(const BasicJsonType& j, StringType& s)
{
if (JSON_HEDLEY_UNLIKELY(!j.is_string()))
{
- JSON_THROW(type_error::create(302, "type must be string, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be string, but is ", j.type_name()), &j));
}
s = *j.template get_ptr<const typename BasicJsonType::string_t*>();
}
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);
}
+#if !JSON_DISABLE_ENUM_SERIALIZATION
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);
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,
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()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", j.type_name()), &j));
}
l.clear();
std::transform(j.rbegin(), j.rend(),
@@ -3961,11 +4644,11 @@
// 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()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", j.type_name()), &j));
}
l.resize(j.size());
std::transform(j.begin(), j.end(), std::begin(l),
@@ -3986,7 +4669,7 @@
}
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*>();
}
@@ -4030,8 +4713,8 @@
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;
@@ -4062,7 +4745,7 @@
{
if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", j.type_name()), &j));
}
from_json_array_impl(j, arr, priority_tag<3> {});
@@ -4081,18 +4764,18 @@
{
if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", j.type_name()), &j));
}
return from_json_inplace_array_impl(std::forward<BasicJsonType>(j), tag, make_index_sequence<N> {});
}
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()))
{
- JSON_THROW(type_error::create(302, "type must be binary, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be binary, but is ", j.type_name()), &j));
}
bin = *j.template get_ptr<const typename BasicJsonType::binary_t*>();
@@ -4100,11 +4783,11 @@
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()))
{
- JSON_THROW(type_error::create(302, "type must be object, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be object, but is ", j.type_name()), &j));
}
ConstructibleObjectType ret;
@@ -4132,7 +4815,7 @@
!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))
{
@@ -4164,7 +4847,7 @@
case value_t::binary:
case value_t::discarded:
default:
- JSON_THROW(type_error::create(302, "type must be number, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be number, but is ", j.type_name()), &j));
}
}
@@ -4182,7 +4865,7 @@
}
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> {});
}
@@ -4194,7 +4877,7 @@
}
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...> {});
}
@@ -4205,7 +4888,7 @@
{
if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", j.type_name()), &j));
}
return from_json_tuple_impl(std::forward<BasicJsonType>(j), std::forward<TupleRelated>(t), priority_tag<3> {});
@@ -4214,18 +4897,18 @@
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()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", j.type_name()), &j));
}
m.clear();
for (const auto& p : j)
{
if (JSON_HEDLEY_UNLIKELY(!p.is_array()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(p.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", p.type_name()), &j));
}
m.emplace(p.at(0).template get<Key>(), p.at(1).template get<Value>());
}
@@ -4234,18 +4917,18 @@
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()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", j.type_name()), &j));
}
m.clear();
for (const auto& p : j)
{
if (JSON_HEDLEY_UNLIKELY(!p.is_array()))
{
- JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(p.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be array, but is ", p.type_name()), &j));
}
m.emplace(p.at(0).template get<Key>(), p.at(1).template get<Value>());
}
@@ -4253,11 +4936,11 @@
#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()))
{
- JSON_THROW(type_error::create(302, "type must be string, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(302, concat("type must be string, but is ", j.type_name()), &j));
}
p = *j.template get_ptr<const typename BasicJsonType::string_t*>();
}
@@ -4273,18 +4956,33 @@
return from_json(j, std::forward<T>(val));
}
};
+
} // 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)
-} // namespace
-} // namespace nlohmann
+#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
+
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/conversions/to_json.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <algorithm> // copy
@@ -4296,9 +4994,15 @@
#include <valarray> // valarray
#include <vector> // vector
-// #include <nlohmann/detail/macro_scope.hpp>
-
// #include <nlohmann/detail/iterators/iteration_proxy.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <cstddef> // size_t
@@ -4307,15 +5011,21 @@
#include <tuple> // tuple_size, get, tuple_element
#include <utility> // move
+#if JSON_HAS_RANGES
+ #include <ranges> // enable_borrowed_range
+#endif
+
+// #include <nlohmann/detail/abi_macros.hpp>
+
// #include <nlohmann/detail/meta/type_traits.hpp>
// #include <nlohmann/detail/value_t.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
template<typename string_type>
void int_to_string( string_type& target, std::size_t value )
{
@@ -4328,14 +5038,14 @@
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
@@ -4343,15 +5053,30 @@
/// 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;
}
@@ -4365,6 +5090,14 @@
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
{
@@ -4425,25 +5158,34 @@
{
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
@@ -4460,8 +5202,9 @@
{
return i.value();
}
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// The Addition to the STD Namespace is required to add
// Structured Bindings Support to the iteration_proxy_value class
@@ -4469,6 +5212,7 @@
// And see https://github.com/nlohmann/json/pull/1391
namespace std
{
+
#if defined(__clang__)
// Fix: https://github.com/nlohmann/json/issues/1401
#pragma clang diagnostic push
@@ -4489,33 +5233,29 @@
#if defined(__clang__)
#pragma clang diagnostic pop
#endif
-} // namespace std
+
+} // 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/macro_scope.hpp>
// #include <nlohmann/detail/meta/cpp_future.hpp>
+// #include <nlohmann/detail/meta/std_fs.hpp>
+
// #include <nlohmann/detail/meta/type_traits.hpp>
// #include <nlohmann/detail/value_t.hpp>
-#if JSON_HAS_EXPERIMENTAL_FILESYSTEM
-#include <experimental/filesystem>
-namespace nlohmann::detail
-{
-namespace std_fs = std::experimental::filesystem;
-} // namespace nlohmann::detail
-#elif JSON_HAS_FILESYSTEM
-#include <filesystem>
-namespace nlohmann::detail
-{
-namespace std_fs = std::filesystem;
-} // namespace nlohmann::detail
-#endif
-
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
//////////////////
// constructors //
//////////////////
@@ -4750,55 +5490,64 @@
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,
+ 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>
-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));
}
+#if !JSON_DISABLE_ENUM_SERIALIZATION
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));
}
+#endif // JSON_DISABLE_ENUM_SERIALIZATION
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);
}
@@ -4811,39 +5560,39 @@
!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));
}
@@ -4853,13 +5602,13 @@
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 };
}
@@ -4867,26 +5616,26 @@
// 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();
}
@@ -4903,22 +5652,25 @@
};
} // 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)
-} // namespace
-} // namespace nlohmann
+#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
+
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/meta/identity_tag.hpp>
-// #include <nlohmann/detail/meta/type_traits.hpp>
-
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
/// @sa https://json.nlohmann.me/api/adl_serializer/
template<typename ValueType, typename>
@@ -4954,17 +5706,28 @@
::nlohmann::to_json(j, std::forward<TargetType>(val));
}
};
-} // namespace nlohmann
+
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/byte_container_with_subtype.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <cstdint> // uint8_t, uint64_t
#include <tuple> // tie
#include <utility> // move
-namespace nlohmann
-{
+// #include <nlohmann/detail/abi_macros.hpp>
+
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
/// @brief an internal type for a backed binary type
/// @sa https://json.nlohmann.me/api/byte_container_with_subtype/
@@ -5050,7 +5813,7 @@
bool m_has_subtype = false;
};
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/conversions/from_json.hpp>
@@ -5059,19 +5822,26 @@
// #include <nlohmann/detail/exceptions.hpp>
// #include <nlohmann/detail/hash.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <cstdint> // uint8_t
#include <cstddef> // size_t
#include <functional> // hash
-// #include <nlohmann/detail/macro_scope.hpp>
+// #include <nlohmann/detail/abi_macros.hpp>
// #include <nlohmann/detail/value_t.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
@@ -5182,9 +5952,17 @@
}
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/input/binary_reader.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <algorithm> // generate_n
@@ -5199,10 +5977,19 @@
#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>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <array> // array
@@ -5225,12 +6012,12 @@
// #include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
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 //
@@ -5249,7 +6036,9 @@
JSON_HEDLEY_NON_NULL(2)
explicit file_input_adapter(std::FILE* f) noexcept
: m_file(f)
- {}
+ {
+ JSON_ASSERT(m_file != nullptr);
+ }
// make class move-only
file_input_adapter(const file_input_adapter&) = delete;
@@ -5607,7 +6396,7 @@
}
};
-} // namespace container_input_adapter_factory_impl
+} // namespace container_input_adapter_factory_impl
template<typename ContainerType>
typename container_input_adapter_factory_impl::container_input_adapter_factory<ContainerType>::adapter_type input_adapter(const ContainerType& container)
@@ -5686,10 +6475,19 @@
private:
contiguous_bytes_input_adapter ia;
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/input/json_sax.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <cstddef>
@@ -5701,9 +6499,10 @@
// #include <nlohmann/detail/macro_scope.hpp>
+// #include <nlohmann/detail/string_concat.hpp>
-namespace nlohmann
-{
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
/*!
@brief SAX interface
@@ -5918,7 +6717,7 @@
if (JSON_HEDLEY_UNLIKELY(len != static_cast<std::size_t>(-1) && len > ref_stack.back()->max_size()))
{
- JSON_THROW(out_of_range::create(408, "excessive object size: " + std::to_string(len), *ref_stack.back()));
+ JSON_THROW(out_of_range::create(408, concat("excessive object size: ", std::to_string(len)), ref_stack.back()));
}
return true;
@@ -5926,6 +6725,9 @@
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;
@@ -5933,6 +6735,9 @@
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;
@@ -5944,7 +6749,7 @@
if (JSON_HEDLEY_UNLIKELY(len != static_cast<std::size_t>(-1) && len > ref_stack.back()->max_size()))
{
- JSON_THROW(out_of_range::create(408, "excessive array size: " + std::to_string(len), *ref_stack.back()));
+ JSON_THROW(out_of_range::create(408, concat("excessive array size: ", std::to_string(len)), ref_stack.back()));
}
return true;
@@ -5952,6 +6757,9 @@
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;
@@ -6099,7 +6907,7 @@
// check object limit
if (ref_stack.back() && JSON_HEDLEY_UNLIKELY(len != static_cast<std::size_t>(-1) && len > ref_stack.back()->max_size()))
{
- JSON_THROW(out_of_range::create(408, "excessive object size: " + std::to_string(len), *ref_stack.back()));
+ JSON_THROW(out_of_range::create(408, concat("excessive object size: ", std::to_string(len)), ref_stack.back()));
}
return true;
@@ -6169,7 +6977,7 @@
// check array limit
if (ref_stack.back() && JSON_HEDLEY_UNLIKELY(len != static_cast<std::size_t>(-1) && len > ref_stack.back()->max_size()))
{
- JSON_THROW(out_of_range::create(408, "excessive array size: " + std::to_string(len), *ref_stack.back()));
+ JSON_THROW(out_of_range::create(408, concat("excessive array size: ", std::to_string(len)), ref_stack.back()));
}
return true;
@@ -6400,11 +7208,19 @@
return false;
}
};
-} // namespace detail
-} // namespace nlohmann
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/input/lexer.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <array> // array
@@ -6424,10 +7240,10 @@
// #include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
///////////
// lexer //
///////////
@@ -8029,27 +8845,38 @@
/// the decimal point
const char_int_type decimal_point_char = '.';
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/macro_scope.hpp>
// #include <nlohmann/detail/meta/is_sax.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <cstdint> // size_t
#include <utility> // declval
#include <string> // string
+// #include <nlohmann/detail/abi_macros.hpp>
+
// #include <nlohmann/detail/meta/detected.hpp>
// #include <nlohmann/detail/meta/type_traits.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
template<typename T>
using null_function_t = decltype(std::declval<T&>().null());
@@ -8184,16 +9011,18 @@
"Missing/invalid function: bool parse_error(std::size_t, const "
"std::string&, const exception&)");
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/meta/type_traits.hpp>
+// #include <nlohmann/detail/string_concat.hpp>
+
// #include <nlohmann/detail/value_t.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
@@ -8243,7 +9072,7 @@
@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> {};
}
@@ -8287,6 +9116,7 @@
break;
case input_format_t::ubjson:
+ case input_format_t::bjdata:
result = parse_ubjson_internal();
break;
@@ -8298,7 +9128,7 @@
// 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();
}
@@ -8309,8 +9139,8 @@
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, "expected end of input; last byte: 0x" + get_token_string(), "value"), BasicJsonType()));
+ return sax->parse_error(chars_read, get_token_string(), parse_error::create(110, chars_read,
+ exception_message(input_format, concat("expected end of input; last byte: 0x", get_token_string()), "value"), nullptr));
}
}
@@ -8386,7 +9216,8 @@
if (JSON_HEDLEY_UNLIKELY(len < 1))
{
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::bson, "string length must be at least 1, is " + std::to_string(len), "string"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+ exception_message(input_format_t::bson, concat("string length must be at least 1, is ", std::to_string(len)), "string"), nullptr));
}
return get_string(input_format_t::bson, len - static_cast<NumberType>(1), result) && get() != std::char_traits<char_type>::eof();
@@ -8407,7 +9238,8 @@
if (JSON_HEDLEY_UNLIKELY(len < 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_t::bson, "byte array length cannot be negative, is " + std::to_string(len), "binary"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+ exception_message(input_format_t::bson, concat("byte array length cannot be negative, is ", std::to_string(len)), "binary"), nullptr));
}
// All BSON binary values have a subtype
@@ -8489,7 +9321,9 @@
{
std::array<char, 3> cr{{}};
static_cast<void>((std::snprintf)(cr.data(), cr.size(), "%.2hhX", static_cast<unsigned char>(element_type))); // NOLINT(cppcoreguidelines-pro-type-vararg,hicpp-vararg)
- return sax->parse_error(element_type_parse_position, std::string(cr.data()), parse_error::create(114, element_type_parse_position, "Unsupported BSON record type 0x" + std::string(cr.data()), BasicJsonType()));
+ std::string cr_str{cr.data()};
+ return sax->parse_error(element_type_parse_position, cr_str,
+ parse_error::create(114, element_type_parse_position, concat("Unsupported BSON record type 0x", cr_str), nullptr));
}
}
}
@@ -8781,7 +9615,8 @@
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)
{
@@ -8798,13 +9633,13 @@
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)
@@ -8835,7 +9670,7 @@
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)
{
@@ -8852,13 +9687,13 @@
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)
@@ -8889,7 +9724,8 @@
case cbor_tag_handler_t::error:
{
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::cbor, "invalid byte: 0x" + last_token, "value"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+ exception_message(input_format_t::cbor, concat("invalid byte: 0x", last_token), "value"), nullptr));
}
case cbor_tag_handler_t::ignore:
@@ -9046,7 +9882,8 @@
default: // anything else (0xFF is handled inside the other types)
{
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::cbor, "invalid byte: 0x" + last_token, "value"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+ exception_message(input_format_t::cbor, concat("invalid byte: 0x", last_token), "value"), nullptr));
}
}
}
@@ -9141,7 +9978,8 @@
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::cbor, "expected length specification (0x60-0x7B) or indefinite string type (0x7F); last byte: 0x" + last_token, "string"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read,
+ exception_message(input_format_t::cbor, concat("expected length specification (0x60-0x7B) or indefinite string type (0x7F); last byte: 0x", last_token), "string"), nullptr));
}
}
}
@@ -9240,7 +10078,8 @@
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::cbor, "expected length specification (0x40-0x5B) or indefinite binary array type (0x5F); last byte: 0x" + last_token, "binary"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read,
+ exception_message(input_format_t::cbor, concat("expected length specification (0x40-0x5B) or indefinite binary array type (0x5F); last byte: 0x", last_token), "binary"), nullptr));
}
}
}
@@ -9501,7 +10340,7 @@
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:
@@ -9520,7 +10359,7 @@
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:
@@ -9657,7 +10496,7 @@
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
@@ -9669,7 +10508,7 @@
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
@@ -9710,7 +10549,8 @@
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::msgpack, "invalid byte: 0x" + last_token, "value"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+ exception_message(input_format_t::msgpack, concat("invalid byte: 0x", last_token), "value"), nullptr));
}
}
}
@@ -9792,7 +10632,8 @@
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::msgpack, "expected length specification (0xA0-0xBF, 0xD9-0xDB); last byte: 0x" + last_token, "string"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read,
+ exception_message(input_format_t::msgpack, concat("expected length specification (0xA0-0xBF, 0xD9-0xDB); last byte: 0x", last_token), "string"), nullptr));
}
}
}
@@ -10003,7 +10844,7 @@
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;
}
@@ -10013,51 +10854,162 @@
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, "expected length type specification (U, i, I, l, L); last byte: 0x" + last_token, "string"), BasicJsonType()));
+ 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;
+ bool no_ndarray = true;
+
+ if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type, no_ndarray)))
+ {
+ 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, no_ndarray, 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, no_ndarray)))
+ {
+ return false;
+ }
+ dim.push_back(dimlen);
+ }
+ }
+ }
+ else
+ {
+ while (current != ']')
+ {
+ if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_value(dimlen, no_ndarray, current)))
+ {
+ return false;
+ }
+ dim.push_back(dimlen);
+ get_ignore_noop();
+ }
+ }
+ return true;
}
/*!
@param[out] result determined size
+ @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 get_ubjson_size_value(std::size_t& result, bool& is_ndarray, 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;
}
@@ -10068,10 +11020,15 @@
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;
}
+ 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;
}
@@ -10079,10 +11036,15 @@
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;
}
+ 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;
}
@@ -10090,10 +11052,15 @@
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;
}
+ 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;
}
@@ -10101,7 +11068,32 @@
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;
+ }
+ 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));
+ }
+ if (!value_in_range_of<std::size_t>(number))
+ {
+ 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;
+ }
+
+ case 'u':
+ {
+ if (input_format != input_format_t::bjdata)
+ {
+ break;
+ }
+ std::uint16_t number{};
+ if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
{
return false;
}
@@ -10109,12 +11101,112 @@
return true;
}
- default:
+ case 'm':
{
- 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, "expected length type specification (U, i, I, l, L) after '#'; last byte: 0x" + last_token, "size"), BasicJsonType()));
+ if (input_format != input_format_t::bjdata)
+ {
+ break;
+ }
+ std::uint32_t number{};
+ if (JSON_HEDLEY_UNLIKELY(!get_number(input_format, number)))
+ {
+ return false;
+ }
+ result = conditional_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;
+ }
+ if (!value_in_range_of<std::size_t>(number))
+ {
+ 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;
+ }
+
+ case '[':
+ {
+ if (input_format != input_format_t::bjdata)
+ {
+ 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 dimentional vector is not allowed", "size"), nullptr));
+ }
+ 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
+ {
+ 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())))
+ {
+ return false;
+ }
+ result = 1;
+ for (auto i : dim)
+ {
+ result *= i;
+ 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));
+ }
+ if (JSON_HEDLEY_UNLIKELY(!sax->number_unsigned(static_cast<number_unsigned_t>(i))))
+ {
+ return false;
+ }
+ }
+ is_ndarray = true;
+ 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));
}
/*!
@@ -10124,20 +11216,31 @@
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)
{
result.first = string_t::npos; // size
result.second = 0; // type
+ bool is_ndarray = false;
get_ignore_noop();
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( 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")))
{
return false;
}
@@ -10145,20 +11248,37 @@
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, "expected '#' after type information; last byte: 0x" + last_token, "size"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(112, chars_read,
+ 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)
+ {
+ 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;
}
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)
+ {
+ 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;
}
return true;
@@ -10173,7 +11293,7 @@
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);
@@ -10186,43 +11306,125 @@
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':
@@ -10233,14 +11435,15 @@
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;
}
if (JSON_HEDLEY_UNLIKELY(current > 127))
{
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, "byte after 'C' must be in range 0x00..0x7F; last byte: 0x" + last_token, "char"), BasicJsonType()));
+ return sax->parse_error(chars_read, last_token, parse_error::create(113, chars_read,
+ 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);
@@ -10259,11 +11462,10 @@
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, "invalid byte: 0x" + last_token, "value"), BasicJsonType()));
- }
+ 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));
}
/*!
@@ -10277,6 +11479,52 @@
return false;
}
+ // 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.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))
+ {
+ 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;
+ }
+
+ if (size_and_type.second == 'C')
+ {
+ size_and_type.second = 'U';
+ }
+
+ 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)))
@@ -10339,6 +11587,14 @@
return false;
}
+ // 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)
+ {
+ 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;
if (size_and_type.first != string_t::npos)
{
@@ -10410,7 +11666,8 @@
{
// get size of following number string
std::size_t size{};
- auto res = get_ubjson_size_value(size);
+ bool no_ndarray = true;
+ auto res = get_ubjson_size_value(size, no_ndarray);
if (JSON_HEDLEY_UNLIKELY(!res))
{
return res;
@@ -10421,7 +11678,7 @@
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;
}
@@ -10439,7 +11696,8 @@
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, "invalid number text: " + number_lexer.get_token_string(), "high-precision number"), BasicJsonType()));
+ return sax->parse_error(chars_read, number_string, parse_error::create(115, chars_read,
+ exception_message(input_format, concat("invalid number text: ", number_lexer.get_token_string()), "high-precision number"), nullptr));
}
switch (result_number)
@@ -10465,7 +11723,8 @@
case token_type::end_of_input:
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, "invalid number text: " + number_lexer.get_token_string(), "high-precision number"), BasicJsonType()));
+ return sax->parse_error(chars_read, number_string, parse_error::create(115, chars_read,
+ exception_message(input_format, concat("invalid number text: ", number_lexer.get_token_string()), "high-precision number"), nullptr));
}
}
@@ -10514,6 +11773,8 @@
@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)
@@ -10529,7 +11790,7 @@
}
// 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);
}
@@ -10621,7 +11882,7 @@
if (JSON_HEDLEY_UNLIKELY(current == std::char_traits<char_type>::eof()))
{
return sax->parse_error(chars_read, "<end of file>",
- parse_error::create(110, chars_read, exception_message(format, "unexpected end of input", context), BasicJsonType()));
+ parse_error::create(110, chars_read, exception_message(format, "unexpected end of input", context), nullptr));
}
return true;
}
@@ -10666,12 +11927,16 @@
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
}
- return error_msg + " " + context + ": " + detail;
+ return concat(error_msg, ' ', context, ": ", detail);
}
private:
@@ -10687,17 +11952,29 @@
/// 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;
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/input/input_adapters.hpp>
// #include <nlohmann/detail/input/lexer.hpp>
// #include <nlohmann/detail/input/parser.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <cmath> // isfinite
@@ -10719,11 +11996,12 @@
// #include <nlohmann/detail/meta/is_sax.hpp>
+// #include <nlohmann/detail/string_concat.hpp>
+
// #include <nlohmann/detail/value_t.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
////////////
@@ -10802,7 +12080,7 @@
sdp.parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
parse_error::create(101, m_lexer.get_position(),
- exception_message(token_type::end_of_input, "value"), BasicJsonType()));
+ exception_message(token_type::end_of_input, "value"), nullptr));
}
// in case of an error, return discarded value
@@ -10829,7 +12107,7 @@
{
sdp.parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_of_input, "value"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_of_input, "value"), nullptr));
}
// in case of an error, return discarded value
@@ -10867,7 +12145,7 @@
{
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_of_input, "value"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_of_input, "value"), nullptr));
}
return result;
@@ -10913,7 +12191,7 @@
{
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::value_string, "object key"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::value_string, "object key"), nullptr));
}
if (JSON_HEDLEY_UNLIKELY(!sax->key(m_lexer.get_string())))
{
@@ -10925,7 +12203,7 @@
{
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::name_separator, "object separator"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::name_separator, "object separator"), nullptr));
}
// remember we are now inside an object
@@ -10968,7 +12246,7 @@
{
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- out_of_range::create(406, "number overflow parsing '" + m_lexer.get_token_string() + "'", BasicJsonType()));
+ out_of_range::create(406, concat("number overflow parsing '", m_lexer.get_token_string(), '\''), nullptr));
}
if (JSON_HEDLEY_UNLIKELY(!sax->number_float(res, m_lexer.get_string())))
@@ -11038,7 +12316,7 @@
// using "uninitialized" to avoid "expected" message
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::uninitialized, "value"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::uninitialized, "value"), nullptr));
}
case token_type::uninitialized:
@@ -11052,7 +12330,7 @@
{
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::literal_or_value, "value"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::literal_or_value, "value"), nullptr));
}
}
}
@@ -11098,7 +12376,7 @@
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_array, "array"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_array, "array"), nullptr));
}
// states.back() is false -> object
@@ -11111,7 +12389,7 @@
{
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::value_string, "object key"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::value_string, "object key"), nullptr));
}
if (JSON_HEDLEY_UNLIKELY(!sax->key(m_lexer.get_string())))
@@ -11124,7 +12402,7 @@
{
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::name_separator, "object separator"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::name_separator, "object separator"), nullptr));
}
// parse values
@@ -11152,7 +12430,7 @@
return sax->parse_error(m_lexer.get_position(),
m_lexer.get_token_string(),
- parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_object, "object"), BasicJsonType()));
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_object, "object"), nullptr));
}
}
@@ -11168,24 +12446,24 @@
if (!context.empty())
{
- error_msg += "while parsing " + context + " ";
+ error_msg += concat("while parsing ", context, ' ');
}
error_msg += "- ";
if (last_token == token_type::parse_error)
{
- error_msg += std::string(m_lexer.get_error_message()) + "; last read: '" +
- m_lexer.get_token_string() + "'";
+ error_msg += concat(m_lexer.get_error_message(), "; last read: '",
+ m_lexer.get_token_string(), '\'');
}
else
{
- error_msg += "unexpected " + std::string(lexer_t::token_type_name(last_token));
+ error_msg += concat("unexpected ", lexer_t::token_type_name(last_token));
}
if (expected != token_type::uninitialized)
{
- error_msg += "; expected " + std::string(lexer_t::token_type_name(expected));
+ error_msg += concat("; expected ", lexer_t::token_type_name(expected));
}
return error_msg;
@@ -11203,12 +12481,30 @@
};
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/iterators/internal_iterator.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+// #include <nlohmann/detail/abi_macros.hpp>
+
// #include <nlohmann/detail/iterators/primitive_iterator.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <cstddef> // ptrdiff_t
@@ -11217,10 +12513,10 @@
// #include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
/*
@brief an iterator for primitive JSON types
@@ -11299,7 +12595,7 @@
return *this;
}
- primitive_iterator_t const operator++(int) noexcept // NOLINT(readability-const-return-type)
+ primitive_iterator_t operator++(int)& noexcept // NOLINT(cert-dcl21-cpp)
{
auto result = *this;
++m_it;
@@ -11312,7 +12608,7 @@
return *this;
}
- primitive_iterator_t const operator--(int) noexcept // NOLINT(readability-const-return-type)
+ primitive_iterator_t operator--(int)& noexcept // NOLINT(cert-dcl21-cpp)
{
auto result = *this;
--m_it;
@@ -11331,14 +12627,15 @@
return *this;
}
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
/*!
@brief an iterator value
@@ -11354,10 +12651,19 @@
/// generic iterator for all other types
primitive_iterator_t primitive_iterator {};
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/iterators/iter_impl.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <iterator> // iterator, random_access_iterator_tag, bidirectional_iterator_tag, advance, next
@@ -11378,10 +12684,10 @@
// #include <nlohmann/detail/value_t.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
// forward declare, to be able to friend it later on
template<typename IteratorType> class iteration_proxy;
template<typename IteratorType> class iteration_proxy_value;
@@ -11418,9 +12724,12 @@
// 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 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:
-
/// 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
@@ -11652,7 +12961,7 @@
}
case value_t::null:
- JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", m_object));
case value_t::string:
case value_t::boolean:
@@ -11668,7 +12977,7 @@
return *m_object;
}
- JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", m_object));
}
}
}
@@ -11710,7 +13019,7 @@
return m_object;
}
- JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", m_object));
}
}
}
@@ -11719,7 +13028,7 @@
@brief post-increment (it++)
@pre The iterator is initialized; i.e. `m_object != nullptr`.
*/
- iter_impl const operator++(int) // NOLINT(readability-const-return-type)
+ iter_impl operator++(int)& // NOLINT(cert-dcl21-cpp)
{
auto result = *this;
++(*this);
@@ -11770,7 +13079,7 @@
@brief post-decrement (it--)
@pre The iterator is initialized; i.e. `m_object != nullptr`.
*/
- iter_impl const operator--(int) // NOLINT(readability-const-return-type)
+ iter_impl operator--(int)& // NOLINT(cert-dcl21-cpp)
{
auto result = *this;
--(*this);
@@ -11827,7 +13136,7 @@
// if objects are not the same, the comparison is undefined
if (JSON_HEDLEY_UNLIKELY(m_object != other.m_object))
{
- JSON_THROW(invalid_iterator::create(212, "cannot compare iterators of different containers", *m_object));
+ JSON_THROW(invalid_iterator::create(212, "cannot compare iterators of different containers", m_object));
}
JSON_ASSERT(m_object != nullptr);
@@ -11872,7 +13181,7 @@
// if objects are not the same, the comparison is undefined
if (JSON_HEDLEY_UNLIKELY(m_object != other.m_object))
{
- JSON_THROW(invalid_iterator::create(212, "cannot compare iterators of different containers", *m_object));
+ JSON_THROW(invalid_iterator::create(212, "cannot compare iterators of different containers", m_object));
}
JSON_ASSERT(m_object != nullptr);
@@ -11880,7 +13189,7 @@
switch (m_object->m_type)
{
case value_t::object:
- JSON_THROW(invalid_iterator::create(213, "cannot compare order of object iterators", *m_object));
+ JSON_THROW(invalid_iterator::create(213, "cannot compare order of object iterators", m_object));
case value_t::array:
return (m_it.array_iterator < other.m_it.array_iterator);
@@ -11936,7 +13245,7 @@
switch (m_object->m_type)
{
case value_t::object:
- JSON_THROW(invalid_iterator::create(209, "cannot use offsets with object iterators", *m_object));
+ JSON_THROW(invalid_iterator::create(209, "cannot use offsets with object iterators", m_object));
case value_t::array:
{
@@ -12015,7 +13324,7 @@
switch (m_object->m_type)
{
case value_t::object:
- JSON_THROW(invalid_iterator::create(209, "cannot use offsets with object iterators", *m_object));
+ JSON_THROW(invalid_iterator::create(209, "cannot use offsets with object iterators", m_object));
case value_t::array:
return m_it.array_iterator - other.m_it.array_iterator;
@@ -12044,13 +13353,13 @@
switch (m_object->m_type)
{
case value_t::object:
- JSON_THROW(invalid_iterator::create(208, "cannot use operator[] for object iterators", *m_object));
+ JSON_THROW(invalid_iterator::create(208, "cannot use operator[] for object iterators", m_object));
case value_t::array:
return *std::next(m_it.array_iterator, n);
case value_t::null:
- JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", m_object));
case value_t::string:
case value_t::boolean:
@@ -12066,7 +13375,7 @@
return *m_object;
}
- JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", m_object));
}
}
}
@@ -12084,7 +13393,7 @@
return m_it.object_iterator->first;
}
- JSON_THROW(invalid_iterator::create(207, "cannot use key() for non-object iterators", *m_object));
+ JSON_THROW(invalid_iterator::create(207, "cannot use key() for non-object iterators", m_object));
}
/*!
@@ -12102,22 +13411,34 @@
/// the actual iterator of the associated instance
internal_iterator<typename std::remove_const<BasicJsonType>::type> m_it {};
};
-} // namespace detail
-} // namespace nlohmann
+
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/iterators/iteration_proxy.hpp>
// #include <nlohmann/detail/iterators/json_reverse_iterator.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <cstddef> // ptrdiff_t
#include <iterator> // reverse_iterator
#include <utility> // declval
-namespace nlohmann
-{
+// #include <nlohmann/detail/abi_macros.hpp>
+
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
//////////////////////
// reverse_iterator //
//////////////////////
@@ -12158,7 +13479,7 @@
explicit json_reverse_iterator(const base_iterator& it) noexcept : base_iterator(it) {}
/// post-increment (it++)
- json_reverse_iterator const operator++(int) // NOLINT(readability-const-return-type)
+ json_reverse_iterator operator++(int)& // NOLINT(cert-dcl21-cpp)
{
return static_cast<json_reverse_iterator>(base_iterator::operator++(1));
}
@@ -12170,7 +13491,7 @@
}
/// post-decrement (it--)
- json_reverse_iterator const operator--(int) // NOLINT(readability-const-return-type)
+ json_reverse_iterator operator--(int)& // NOLINT(cert-dcl21-cpp)
{
return static_cast<json_reverse_iterator>(base_iterator::operator--(1));
}
@@ -12225,16 +13546,30 @@
return it.operator * ();
}
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/iterators/primitive_iterator.hpp>
// #include <nlohmann/detail/json_pointer.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <algorithm> // all_of
#include <cctype> // isdigit
+#include <cerrno> // errno, ERANGE
+#include <cstdlib> // strtoull
+#ifndef JSON_NO_IO
+ #include <iosfwd> // ostream
+#endif // JSON_NO_IO
#include <limits> // max
#include <numeric> // accumulate
#include <string> // string
@@ -12245,49 +13580,79 @@
// #include <nlohmann/detail/macro_scope.hpp>
+// #include <nlohmann/detail/string_concat.hpp>
+
// #include <nlohmann/detail/string_escape.hpp>
// #include <nlohmann/detail/value_t.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
/// @brief JSON Pointer defines a string syntax for identifying a specific value within a JSON document
/// @sa https://json.nlohmann.me/api/json_pointer/
-template<typename BasicJsonType>
+template<typename RefStringType>
class json_pointer
{
// allow basic_json to access private members
NLOHMANN_BASIC_JSON_TPL_DECLARATION
friend class basic_json;
+ template<typename>
+ friend class json_pointer;
+
+ template<typename T>
+ struct string_t_helper
+ {
+ using type = T;
+ };
+
+ NLOHMANN_BASIC_JSON_TPL_DECLARATION
+ struct string_t_helper<NLOHMANN_BASIC_JSON_TPL>
+ {
+ using type = StringType;
+ };
+
public:
+ // for backwards compatibility accept BasicJsonType
+ using string_t = typename string_t_helper<RefStringType>::type;
+
/// @brief create JSON pointer
/// @sa https://json.nlohmann.me/api/json_pointer/json_pointer/
- explicit json_pointer(const std::string& s = "")
+ explicit json_pointer(const string_t& s = "")
: reference_tokens(split(s))
{}
/// @brief return a string representation of the JSON pointer
/// @sa https://json.nlohmann.me/api/json_pointer/to_string/
- std::string to_string() const
+ string_t to_string() const
{
return std::accumulate(reference_tokens.begin(), reference_tokens.end(),
- std::string{},
- [](const std::string & a, const std::string & b)
+ string_t{},
+ [](const string_t& a, const string_t& b)
{
- return a + "/" + detail::escape(b);
+ return detail::concat(a, '/', detail::escape(b));
});
}
/// @brief return a string representation of the JSON pointer
/// @sa https://json.nlohmann.me/api/json_pointer/operator_string/
- operator std::string() const
+ JSON_HEDLEY_DEPRECATED_FOR(3.11.0, to_string())
+ operator string_t() const
{
return to_string();
}
+#ifndef JSON_NO_IO
+ /// @brief write string representation of the JSON pointer to stream
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_ltlt/
+ friend std::ostream& operator<<(std::ostream& o, const json_pointer& ptr)
+ {
+ o << ptr.to_string();
+ return o;
+ }
+#endif
+
/// @brief append another JSON pointer at the end of this JSON pointer
/// @sa https://json.nlohmann.me/api/json_pointer/operator_slasheq/
json_pointer& operator/=(const json_pointer& ptr)
@@ -12300,7 +13665,7 @@
/// @brief append an unescaped reference token at the end of this JSON pointer
/// @sa https://json.nlohmann.me/api/json_pointer/operator_slasheq/
- json_pointer& operator/=(std::string token)
+ json_pointer& operator/=(string_t token)
{
push_back(std::move(token));
return *this;
@@ -12323,7 +13688,7 @@
/// @brief create a new JSON pointer by appending the unescaped token at the end of the JSON pointer
/// @sa https://json.nlohmann.me/api/json_pointer/operator_slash/
- friend json_pointer operator/(const json_pointer& lhs, std::string token) // NOLINT(performance-unnecessary-value-param)
+ friend json_pointer operator/(const json_pointer& lhs, string_t token) // NOLINT(performance-unnecessary-value-param)
{
return json_pointer(lhs) /= std::move(token);
}
@@ -12355,7 +13720,7 @@
{
if (JSON_HEDLEY_UNLIKELY(empty()))
{
- JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", BasicJsonType()));
+ JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", nullptr));
}
reference_tokens.pop_back();
@@ -12363,11 +13728,11 @@
/// @brief return last reference token
/// @sa https://json.nlohmann.me/api/json_pointer/back/
- const std::string& back() const
+ const string_t& back() const
{
if (JSON_HEDLEY_UNLIKELY(empty()))
{
- JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", BasicJsonType()));
+ JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", nullptr));
}
return reference_tokens.back();
@@ -12375,14 +13740,14 @@
/// @brief append an unescaped token at the end of the reference pointer
/// @sa https://json.nlohmann.me/api/json_pointer/push_back/
- void push_back(const std::string& token)
+ void push_back(const string_t& token)
{
reference_tokens.push_back(token);
}
/// @brief append an unescaped token at the end of the reference pointer
/// @sa https://json.nlohmann.me/api/json_pointer/push_back/
- void push_back(std::string&& token)
+ void push_back(string_t&& token)
{
reference_tokens.push_back(std::move(token));
}
@@ -12405,44 +13770,39 @@
@throw out_of_range.404 if string @a s could not be converted to an integer
@throw out_of_range.410 if an array index exceeds size_type
*/
- static typename BasicJsonType::size_type array_index(const std::string& s)
+ template<typename BasicJsonType>
+ static typename BasicJsonType::size_type array_index(const string_t& s)
{
using size_type = typename BasicJsonType::size_type;
// error condition (cf. RFC 6901, Sect. 4)
if (JSON_HEDLEY_UNLIKELY(s.size() > 1 && s[0] == '0'))
{
- JSON_THROW(detail::parse_error::create(106, 0, "array index '" + s + "' must not begin with '0'", BasicJsonType()));
+ JSON_THROW(detail::parse_error::create(106, 0, detail::concat("array index '", s, "' must not begin with '0'"), nullptr));
}
// error condition (cf. RFC 6901, Sect. 4)
if (JSON_HEDLEY_UNLIKELY(s.size() > 1 && !(s[0] >= '1' && s[0] <= '9')))
{
- JSON_THROW(detail::parse_error::create(109, 0, "array index '" + s + "' is not a number", BasicJsonType()));
+ JSON_THROW(detail::parse_error::create(109, 0, detail::concat("array index '", s, "' is not a number"), nullptr));
}
- std::size_t processed_chars = 0;
- unsigned long long res = 0; // NOLINT(runtime/int)
- JSON_TRY
+ const char* p = s.c_str();
+ char* p_end = nullptr;
+ errno = 0; // strtoull doesn't reset errno
+ unsigned long long res = std::strtoull(p, &p_end, 10); // NOLINT(runtime/int)
+ if (p == p_end // invalid input or empty string
+ || errno == ERANGE // out of range
+ || JSON_HEDLEY_UNLIKELY(static_cast<std::size_t>(p_end - p) != s.size())) // incomplete read
{
- res = std::stoull(s, &processed_chars);
- }
- JSON_CATCH(std::out_of_range&)
- {
- JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + s + "'", BasicJsonType()));
- }
-
- // check if the string was completely read
- if (JSON_HEDLEY_UNLIKELY(processed_chars != s.size()))
- {
- JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + s + "'", BasicJsonType()));
+ JSON_THROW(detail::out_of_range::create(404, detail::concat("unresolved reference token '", s, "'"), nullptr));
}
// only triggered on special platforms (like 32bit), see also
// https://github.com/nlohmann/json/pull/2203
if (res >= static_cast<unsigned long long>((std::numeric_limits<size_type>::max)())) // NOLINT(runtime/int)
{
- JSON_THROW(detail::out_of_range::create(410, "array index " + s + " exceeds size_type", BasicJsonType())); // LCOV_EXCL_LINE
+ JSON_THROW(detail::out_of_range::create(410, detail::concat("array index ", s, " exceeds size_type"), nullptr)); // LCOV_EXCL_LINE
}
return static_cast<size_type>(res);
@@ -12453,7 +13813,7 @@
{
if (JSON_HEDLEY_UNLIKELY(empty()))
{
- JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", BasicJsonType()));
+ JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", nullptr));
}
json_pointer result = *this;
@@ -12470,6 +13830,7 @@
@throw parse_error.109 if array index is not a number
@throw type_error.313 if value cannot be unflattened
*/
+ template<typename BasicJsonType>
BasicJsonType& get_and_create(BasicJsonType& j) const
{
auto* result = &j;
@@ -12505,7 +13866,7 @@
case detail::value_t::array:
{
// create an entry in the array
- result = &result->operator[](array_index(reference_token));
+ result = &result->operator[](array_index<BasicJsonType>(reference_token));
break;
}
@@ -12523,7 +13884,7 @@
case detail::value_t::binary:
case detail::value_t::discarded:
default:
- JSON_THROW(detail::type_error::create(313, "invalid value to unflatten", j));
+ JSON_THROW(detail::type_error::create(313, "invalid value to unflatten", &j));
}
}
@@ -12549,6 +13910,7 @@
@throw parse_error.109 if an array index was not a number
@throw out_of_range.404 if the JSON pointer can not be resolved
*/
+ template<typename BasicJsonType>
BasicJsonType& get_unchecked(BasicJsonType* ptr) const
{
for (const auto& reference_token : reference_tokens)
@@ -12589,7 +13951,7 @@
else
{
// convert array index to number; unchecked access
- ptr = &ptr->operator[](array_index(reference_token));
+ ptr = &ptr->operator[](array_index<BasicJsonType>(reference_token));
}
break;
}
@@ -12603,7 +13965,7 @@
case detail::value_t::binary:
case detail::value_t::discarded:
default:
- JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + reference_token + "'", *ptr));
+ JSON_THROW(detail::out_of_range::create(404, detail::concat("unresolved reference token '", reference_token, "'"), ptr));
}
}
@@ -12616,6 +13978,7 @@
@throw out_of_range.402 if the array index '-' is used
@throw out_of_range.404 if the JSON pointer can not be resolved
*/
+ template<typename BasicJsonType>
BasicJsonType& get_checked(BasicJsonType* ptr) const
{
for (const auto& reference_token : reference_tokens)
@@ -12634,13 +13997,13 @@
if (JSON_HEDLEY_UNLIKELY(reference_token == "-"))
{
// "-" always fails the range check
- JSON_THROW(detail::out_of_range::create(402,
- "array index '-' (" + std::to_string(ptr->m_value.array->size()) +
- ") is out of range", *ptr));
+ JSON_THROW(detail::out_of_range::create(402, detail::concat(
+ "array index '-' (", std::to_string(ptr->m_value.array->size()),
+ ") is out of range"), ptr));
}
// note: at performs range check
- ptr = &ptr->at(array_index(reference_token));
+ ptr = &ptr->at(array_index<BasicJsonType>(reference_token));
break;
}
@@ -12653,7 +14016,7 @@
case detail::value_t::binary:
case detail::value_t::discarded:
default:
- JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + reference_token + "'", *ptr));
+ JSON_THROW(detail::out_of_range::create(404, detail::concat("unresolved reference token '", reference_token, "'"), ptr));
}
}
@@ -12673,6 +14036,7 @@
@throw out_of_range.402 if the array index '-' is used
@throw out_of_range.404 if the JSON pointer can not be resolved
*/
+ template<typename BasicJsonType>
const BasicJsonType& get_unchecked(const BasicJsonType* ptr) const
{
for (const auto& reference_token : reference_tokens)
@@ -12691,11 +14055,11 @@
if (JSON_HEDLEY_UNLIKELY(reference_token == "-"))
{
// "-" cannot be used for const access
- JSON_THROW(detail::out_of_range::create(402, "array index '-' (" + std::to_string(ptr->m_value.array->size()) + ") is out of range", *ptr));
+ JSON_THROW(detail::out_of_range::create(402, detail::concat("array index '-' (", std::to_string(ptr->m_value.array->size()), ") is out of range"), ptr));
}
// use unchecked array access
- ptr = &ptr->operator[](array_index(reference_token));
+ ptr = &ptr->operator[](array_index<BasicJsonType>(reference_token));
break;
}
@@ -12708,7 +14072,7 @@
case detail::value_t::binary:
case detail::value_t::discarded:
default:
- JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + reference_token + "'", *ptr));
+ JSON_THROW(detail::out_of_range::create(404, detail::concat("unresolved reference token '", reference_token, "'"), ptr));
}
}
@@ -12721,6 +14085,7 @@
@throw out_of_range.402 if the array index '-' is used
@throw out_of_range.404 if the JSON pointer can not be resolved
*/
+ template<typename BasicJsonType>
const BasicJsonType& get_checked(const BasicJsonType* ptr) const
{
for (const auto& reference_token : reference_tokens)
@@ -12739,13 +14104,13 @@
if (JSON_HEDLEY_UNLIKELY(reference_token == "-"))
{
// "-" always fails the range check
- JSON_THROW(detail::out_of_range::create(402,
- "array index '-' (" + std::to_string(ptr->m_value.array->size()) +
- ") is out of range", *ptr));
+ JSON_THROW(detail::out_of_range::create(402, detail::concat(
+ "array index '-' (", std::to_string(ptr->m_value.array->size()),
+ ") is out of range"), ptr));
}
// note: at performs range check
- ptr = &ptr->at(array_index(reference_token));
+ ptr = &ptr->at(array_index<BasicJsonType>(reference_token));
break;
}
@@ -12758,7 +14123,7 @@
case detail::value_t::binary:
case detail::value_t::discarded:
default:
- JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + reference_token + "'", *ptr));
+ JSON_THROW(detail::out_of_range::create(404, detail::concat("unresolved reference token '", reference_token, "'"), ptr));
}
}
@@ -12769,6 +14134,7 @@
@throw parse_error.106 if an array index begins with '0'
@throw parse_error.109 if an array index was not a number
*/
+ template<typename BasicJsonType>
bool contains(const BasicJsonType* ptr) const
{
for (const auto& reference_token : reference_tokens)
@@ -12816,7 +14182,7 @@
}
}
- const auto idx = array_index(reference_token);
+ const auto idx = array_index<BasicJsonType>(reference_token);
if (idx >= ptr->size())
{
// index out of range
@@ -12857,9 +14223,9 @@
@throw parse_error.107 if the pointer is not empty or begins with '/'
@throw parse_error.108 if character '~' is not followed by '0' or '1'
*/
- static std::vector<std::string> split(const std::string& reference_string)
+ static std::vector<string_t> split(const string_t& reference_string)
{
- std::vector<std::string> result;
+ std::vector<string_t> result;
// special case: empty reference string -> no reference tokens
if (reference_string.empty())
@@ -12870,7 +14236,7 @@
// check if nonempty reference string begins with slash
if (JSON_HEDLEY_UNLIKELY(reference_string[0] != '/'))
{
- JSON_THROW(detail::parse_error::create(107, 1, "JSON pointer must be empty or begin with '/' - was: '" + reference_string + "'", BasicJsonType()));
+ JSON_THROW(detail::parse_error::create(107, 1, detail::concat("JSON pointer must be empty or begin with '/' - was: '", reference_string, "'"), nullptr));
}
// extract the reference tokens:
@@ -12881,11 +14247,11 @@
std::size_t slash = reference_string.find_first_of('/', 1),
// set the beginning of the first reference token
start = 1;
- // we can stop if start == 0 (if slash == std::string::npos)
+ // we can stop if start == 0 (if slash == string_t::npos)
start != 0;
// set the beginning of the next reference token
- // (will eventually be 0 if slash == std::string::npos)
- start = (slash == std::string::npos) ? 0 : slash + 1,
+ // (will eventually be 0 if slash == string_t::npos)
+ start = (slash == string_t::npos) ? 0 : slash + 1,
// find next slash
slash = reference_string.find_first_of('/', start))
{
@@ -12895,7 +14261,7 @@
// check reference tokens are properly escaped
for (std::size_t pos = reference_token.find_first_of('~');
- pos != std::string::npos;
+ pos != string_t::npos;
pos = reference_token.find_first_of('~', pos + 1))
{
JSON_ASSERT(reference_token[pos] == '~');
@@ -12905,7 +14271,7 @@
(reference_token[pos + 1] != '0' &&
reference_token[pos + 1] != '1')))
{
- JSON_THROW(detail::parse_error::create(108, 0, "escape character '~' must be followed with '0' or '1'", BasicJsonType()));
+ JSON_THROW(detail::parse_error::create(108, 0, "escape character '~' must be followed with '0' or '1'", nullptr));
}
}
@@ -12925,7 +14291,8 @@
@note Empty objects or arrays are flattened to `null`.
*/
- static void flatten(const std::string& reference_string,
+ template<typename BasicJsonType>
+ static void flatten(const string_t& reference_string,
const BasicJsonType& value,
BasicJsonType& result)
{
@@ -12943,7 +14310,7 @@
// iterate array and use index as reference string
for (std::size_t i = 0; i < value.m_value.array->size(); ++i)
{
- flatten(reference_string + "/" + std::to_string(i),
+ flatten(detail::concat(reference_string, '/', std::to_string(i)),
value.m_value.array->operator[](i), result);
}
}
@@ -12962,7 +14329,7 @@
// iterate object and use keys as reference string
for (const auto& element : *value.m_value.object)
{
- flatten(reference_string + "/" + detail::escape(element.first), element.second, result);
+ flatten(detail::concat(reference_string, '/', detail::escape(element.first)), element.second, result);
}
}
break;
@@ -12995,12 +14362,13 @@
@throw type_error.315 if object values are not primitive
@throw type_error.313 if value cannot be unflattened
*/
+ template<typename BasicJsonType>
static BasicJsonType
unflatten(const BasicJsonType& value)
{
if (JSON_HEDLEY_UNLIKELY(!value.is_object()))
{
- JSON_THROW(detail::type_error::create(314, "only objects can be unflattened", value));
+ JSON_THROW(detail::type_error::create(314, "only objects can be unflattened", &value));
}
BasicJsonType result;
@@ -13010,7 +14378,7 @@
{
if (JSON_HEDLEY_UNLIKELY(!element.second.is_primitive()))
{
- JSON_THROW(detail::type_error::create(315, "values in object must be primitive", element.second));
+ JSON_THROW(detail::type_error::create(315, "values in object must be primitive", &element.second));
}
// assign value to reference pointed to by JSON pointer; Note that if
@@ -13023,6 +14391,21 @@
return result;
}
+ // can't use conversion operator because of ambiguity
+ json_pointer<string_t> convert() const&
+ {
+ json_pointer<string_t> result;
+ result.reference_tokens = reference_tokens;
+ return result;
+ }
+
+ json_pointer<string_t> convert()&&
+ {
+ json_pointer<string_t> result;
+ result.reference_tokens = std::move(reference_tokens);
+ return result;
+ }
+
/*!
@brief compares two JSON pointers for equality
@@ -13034,11 +14417,10 @@
@exceptionsafety No-throw guarantee: this function never throws exceptions.
*/
- friend bool operator==(json_pointer const& lhs,
- json_pointer const& rhs) noexcept
- {
- return lhs.reference_tokens == rhs.reference_tokens;
- }
+ template<typename RefStringTypeLhs, typename RefStringTypeRhs>
+ // NOLINTNEXTLINE(readability-redundant-declaration)
+ friend bool operator==(json_pointer<RefStringTypeLhs> const& lhs,
+ json_pointer<RefStringTypeRhs> const& rhs) noexcept;
/*!
@brief compares two JSON pointers for inequality
@@ -13051,30 +14433,55 @@
@exceptionsafety No-throw guarantee: this function never throws exceptions.
*/
- friend bool operator!=(json_pointer const& lhs,
- json_pointer const& rhs) noexcept
- {
- return !(lhs == rhs);
- }
+ template<typename RefStringTypeLhs, typename RefStringTypeRhs>
+ // NOLINTNEXTLINE(readability-redundant-declaration)
+ friend bool operator!=(json_pointer<RefStringTypeLhs> const& lhs,
+ json_pointer<RefStringTypeRhs> const& rhs) noexcept;
/// the reference tokens
- std::vector<std::string> reference_tokens;
+ std::vector<string_t> reference_tokens;
};
-} // namespace nlohmann
+
+// functions cannot be defined inside class due to ODR violations
+template<typename RefStringTypeLhs, typename RefStringTypeRhs>
+inline bool operator==(json_pointer<RefStringTypeLhs> const& lhs,
+ json_pointer<RefStringTypeRhs> const& rhs) noexcept
+{
+ return lhs.reference_tokens == rhs.reference_tokens;
+}
+
+template<typename RefStringTypeLhs, typename RefStringTypeRhs>
+inline bool operator!=(json_pointer<RefStringTypeLhs> const& lhs,
+ json_pointer<RefStringTypeRhs> const& rhs) noexcept
+{
+ return !(lhs == rhs);
+}
+
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/json_ref.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <initializer_list>
#include <utility>
+// #include <nlohmann/detail/abi_macros.hpp>
+
// #include <nlohmann/detail/meta/type_traits.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
template<typename BasicJsonType>
class json_ref
{
@@ -13130,11 +14537,14 @@
mutable value_type owned_value = nullptr;
value_type const* value_ref = nullptr;
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/macro_scope.hpp>
+// #include <nlohmann/detail/string_concat.hpp>
+
// #include <nlohmann/detail/string_escape.hpp>
// #include <nlohmann/detail/meta/cpp_future.hpp>
@@ -13142,22 +14552,40 @@
// #include <nlohmann/detail/meta/type_traits.hpp>
// #include <nlohmann/detail/output/binary_writer.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#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>
// #include <nlohmann/detail/output/output_adapters.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <algorithm> // copy
@@ -13175,10 +14603,10 @@
// #include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
/// abstract output adapter interface
template<typename CharType> struct output_adapter_protocol
{
@@ -13214,7 +14642,7 @@
JSON_HEDLEY_NON_NULL(2)
void write_characters(const CharType* s, std::size_t length) override
{
- std::copy(s, s + length, std::back_inserter(v));
+ v.insert(v.end(), s, s + length);
}
private:
@@ -13295,14 +14723,17 @@
private:
output_adapter_t<CharType> oa = nullptr;
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
+
+// #include <nlohmann/detail/string_concat.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
///////////////////
// binary writer //
///////////////////
@@ -13353,7 +14784,7 @@
case value_t::discarded:
default:
{
- JSON_THROW(type_error::create(317, "to serialize to BSON, top-level type must be object, but is " + std::string(j.type_name()), j));
+ JSON_THROW(type_error::create(317, concat("to serialize to BSON, top-level type must be object, but is ", j.type_name()), &j));
}
}
}
@@ -14009,9 +15440,11 @@
@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())
{
@@ -14037,19 +15470,19 @@
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;
}
@@ -14059,7 +15492,7 @@
{
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());
@@ -14077,14 +15510,16 @@
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('$'));
@@ -14095,12 +15530,12 @@
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)
@@ -14128,7 +15563,7 @@
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)
@@ -14156,6 +15591,14 @@
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('{'));
@@ -14165,14 +15608,16 @@
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('$'));
@@ -14183,16 +15628,16 @@
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)
@@ -14223,7 +15668,7 @@
const auto it = name.find(static_cast<typename string_t::value_type>(0));
if (JSON_HEDLEY_UNLIKELY(it != BasicJsonType::string_t::npos))
{
- JSON_THROW(out_of_range::create(409, "BSON key cannot contain code point U+0000 (at byte " + std::to_string(it) + ")", j));
+ JSON_THROW(out_of_range::create(409, concat("BSON key cannot contain code point U+0000 (at byte ", std::to_string(it), ")"), &j));
static_cast<void>(j);
}
@@ -14259,7 +15704,7 @@
const double value)
{
write_bson_entry_header(name, 0x01);
- write_number<double, true>(value);
+ write_number<double>(value, true);
}
/*!
@@ -14278,7 +15723,7 @@
{
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);
@@ -14311,12 +15756,12 @@
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);
}
}
@@ -14339,16 +15784,16 @@
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
{
- JSON_THROW(out_of_range::create(407, "integer number " + std::to_string(j.m_value.number_unsigned) + " cannot be represented by BSON as it does not fit int64", j));
+ JSON_THROW(out_of_range::create(407, concat("integer number ", std::to_string(j.m_value.number_unsigned), " cannot be represented by BSON as it does not fit int64"), &j));
}
}
@@ -14392,7 +15837,7 @@
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;
@@ -14412,7 +15857,7 @@
{
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());
@@ -14534,7 +15979,7 @@
*/
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)
{
@@ -14580,20 +16025,22 @@
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)()))
{
@@ -14601,7 +16048,7 @@
{
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)())
{
@@ -14609,7 +16056,7 @@
{
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)()))
{
@@ -14617,7 +16064,15 @@
{
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)()))
{
@@ -14625,7 +16080,15 @@
{
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)()))
{
@@ -14633,7 +16096,15 @@
{
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
{
@@ -14643,7 +16114,7 @@
}
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])));
@@ -14656,7 +16127,8 @@
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)())
{
@@ -14664,7 +16136,7 @@
{
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)()))
{
@@ -14672,7 +16144,7 @@
{
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)())
{
@@ -14680,7 +16152,15 @@
{
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)())
{
@@ -14688,7 +16168,15 @@
{
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)())
{
@@ -14696,7 +16184,7 @@
{
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
@@ -14707,7 +16195,7 @@
}
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])));
@@ -14719,7 +16207,7 @@
/*!
@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())
{
@@ -14743,10 +16231,18 @@
{
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';
@@ -14769,14 +16265,26 @@
{
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
}
@@ -14810,6 +16318,118 @@
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 //
///////////////////////
@@ -14817,16 +16437,18 @@
/*
@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{};
@@ -14917,12 +16539,22 @@
/// the output
output_adapter_t<CharType> oa = nullptr;
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/output/output_adapters.hpp>
// #include <nlohmann/detail/output/serializer.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2008-2009 Björn Hoehrmann <bjoern@hoehrmann.de>
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <algorithm> // reverse, remove, fill, find, none_of
@@ -14935,11 +16567,19 @@
#include <limits> // numeric_limits
#include <string> // string, char_traits
#include <iomanip> // setfill, setw
-#include <sstream> // stringstream
#include <type_traits> // is_same
#include <utility> // move
// #include <nlohmann/detail/conversions/to_chars.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2009 Florian Loitsch <https://florian.loitsch.com/>
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#include <array> // array
@@ -14952,8 +16592,7 @@
// #include <nlohmann/detail/macro_scope.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
@@ -15982,7 +17621,7 @@
return append_exponent(buf, n - 1);
}
-} // namespace dtoa_impl
+} // namespace dtoa_impl
/*!
@brief generates a decimal representation of the floating-point number value in [first, last).
@@ -16049,8 +17688,8 @@
return dtoa_impl::format_buffer(first, len, decimal_exponent, kMinExp, kMaxExp);
}
-} // namespace detail
-} // namespace nlohmann
+} // namespace detail
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/exceptions.hpp>
@@ -16062,13 +17701,15 @@
// #include <nlohmann/detail/output/output_adapters.hpp>
+// #include <nlohmann/detail/string_concat.hpp>
+
// #include <nlohmann/detail/value_t.hpp>
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
namespace detail
{
+
///////////////////
// serialization //
///////////////////
@@ -16544,9 +18185,7 @@
{
case error_handler_t::strict:
{
- std::stringstream ss;
- ss << std::uppercase << std::setfill('0') << std::setw(2) << std::hex << (byte | 0);
- JSON_THROW(type_error::create(316, "invalid UTF-8 byte at index " + std::to_string(i) + ": 0x" + ss.str(), BasicJsonType()));
+ JSON_THROW(type_error::create(316, concat("invalid UTF-8 byte at index ", std::to_string(i), ": 0x", hex_bytes(byte | 0)), nullptr));
}
case error_handler_t::ignore:
@@ -16638,9 +18277,7 @@
{
case error_handler_t::strict:
{
- std::stringstream ss;
- ss << std::uppercase << std::setfill('0') << std::setw(2) << std::hex << (static_cast<std::uint8_t>(s.back()) | 0);
- JSON_THROW(type_error::create(316, "incomplete UTF-8 string; last byte: 0x" + ss.str(), BasicJsonType()));
+ JSON_THROW(type_error::create(316, concat("incomplete UTF-8 string; last byte: 0x", hex_bytes(static_cast<std::uint8_t>(s.back() | 0))), nullptr));
}
case error_handler_t::ignore:
@@ -16707,6 +18344,20 @@
}
}
+ /*!
+ * @brief convert a byte to a uppercase hex representation
+ * @param[in] byte byte to represent
+ * @return representation ("00".."FF")
+ */
+ static std::string hex_bytes(std::uint8_t byte)
+ {
+ std::string result = "FF";
+ constexpr const char* nibble_to_hex = "0123456789ABCDEF";
+ result[0] = nibble_to_hex[byte / 16];
+ result[1] = nibble_to_hex[byte % 16];
+ return result;
+ }
+
// templates to avoid warnings about useless casts
template <typename NumberType, enable_if_t<std::is_signed<NumberType>::value, int> = 0>
bool is_negative_number(NumberType x)
@@ -17007,17 +18658,26 @@
/// error_handler how to react on decoding errors
const error_handler_t error_handler;
};
+
} // namespace detail
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
// #include <nlohmann/detail/value_t.hpp>
// #include <nlohmann/json_fwd.hpp>
// #include <nlohmann/ordered_map.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
-#include <functional> // less
+
+#include <functional> // equal_to, less
#include <initializer_list> // initializer_list
#include <iterator> // input_iterator_tag, iterator_traits
#include <memory> // allocator
@@ -17028,9 +18688,10 @@
// #include <nlohmann/detail/macro_scope.hpp>
+// #include <nlohmann/detail/meta/type_traits.hpp>
-namespace nlohmann
-{
+
+NLOHMANN_JSON_NAMESPACE_BEGIN
/// ordered_map: a minimal map-like container that preserves insertion order
/// for use within nlohmann::basic_json<ordered_map>
@@ -17045,44 +18706,79 @@
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)
- ordered_map(const Allocator& alloc = Allocator()) : Container{alloc} {}
+ ordered_map() noexcept(noexcept(Container())) : Container{} {}
+ explicit ordered_map(const Allocator& alloc) noexcept(noexcept(Container(alloc))) : Container{alloc} {}
template <class It>
ordered_map(It first, It last, const Allocator& alloc = Allocator())
: Container{first, last, alloc} {}
- ordered_map(std::initializer_list<T> init, const Allocator& alloc = Allocator() )
+ ordered_map(std::initializer_list<value_type> init, const Allocator& alloc = Allocator() )
: Container{init, alloc} {}
std::pair<iterator, bool> emplace(const key_type& key, T&& t)
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == key)
+ if (m_compare(it->first, key))
{
return {it, false};
}
}
- Container::emplace_back(key, t);
- return {--this->end(), true};
+ Container::emplace_back(key, std::forward<T>(t));
+ return {std::prev(this->end()), true};
}
- T& operator[](const Key& key)
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ std::pair<iterator, bool> emplace(KeyType && key, T && t)
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (m_compare(it->first, key))
+ {
+ return {it, false};
+ }
+ }
+ Container::emplace_back(std::forward<KeyType>(key), std::forward<T>(t));
+ return {std::prev(this->end()), true};
+ }
+
+ T& operator[](const key_type& key)
{
return emplace(key, T{}).first->second;
}
- const T& operator[](const Key& key) const
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ T & operator[](KeyType && key)
+ {
+ return emplace(std::forward<KeyType>(key), T{}).first->second;
+ }
+
+ const T& operator[](const key_type& key) const
{
return at(key);
}
- T& at(const Key& key)
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ const T & operator[](KeyType && key) const
+ {
+ return at(std::forward<KeyType>(key));
+ }
+
+ T& at(const key_type& key)
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == key)
+ if (m_compare(it->first, key))
{
return it->second;
}
@@ -17091,11 +18787,13 @@
JSON_THROW(std::out_of_range("key not found"));
}
- const T& at(const Key& key) const
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ T & at(KeyType && key)
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == key)
+ if (m_compare(it->first, key))
{
return it->second;
}
@@ -17104,11 +18802,60 @@
JSON_THROW(std::out_of_range("key not found"));
}
- size_type erase(const Key& key)
+ const T& at(const key_type& key) const
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == key)
+ if (m_compare(it->first, key))
+ {
+ return it->second;
+ }
+ }
+
+ JSON_THROW(std::out_of_range("key not found"));
+ }
+
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ const T & at(KeyType && key) const
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (m_compare(it->first, key))
+ {
+ return it->second;
+ }
+ }
+
+ JSON_THROW(std::out_of_range("key not found"));
+ }
+
+ size_type erase(const key_type& key)
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ 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)
+ {
+ it->~value_type(); // Destroy but keep allocation
+ new (&*it) value_type{std::move(*next)};
+ }
+ Container::pop_back();
+ return 1;
+ }
+ }
+ return 0;
+ }
+
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ size_type erase(KeyType && key)
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ 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)
@@ -17130,6 +18877,11 @@
iterator erase(iterator first, iterator last)
{
+ if (first == last)
+ {
+ return first;
+ }
+
const auto elements_affected = std::distance(first, last);
const auto offset = std::distance(Container::begin(), first);
@@ -17176,11 +18928,11 @@
return Container::begin() + offset;
}
- size_type count(const Key& key) const
+ size_type count(const key_type& key) const
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == key)
+ if (m_compare(it->first, key))
{
return 1;
}
@@ -17188,11 +18940,25 @@
return 0;
}
- iterator find(const Key& key)
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ size_type count(KeyType && key) const
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == key)
+ if (m_compare(it->first, key))
+ {
+ return 1;
+ }
+ }
+ return 0;
+ }
+
+ iterator find(const key_type& key)
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (m_compare(it->first, key))
{
return it;
}
@@ -17200,11 +18966,25 @@
return Container::end();
}
- const_iterator find(const Key& key) const
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_key_type<key_compare, key_type, KeyType>::value, int> = 0>
+ iterator find(KeyType && key)
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == key)
+ if (m_compare(it->first, key))
+ {
+ return it;
+ }
+ }
+ return Container::end();
+ }
+
+ const_iterator find(const key_type& key) const
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (m_compare(it->first, key))
{
return it;
}
@@ -17221,7 +19001,7 @@
{
for (auto it = this->begin(); it != this->end(); ++it)
{
- if (it->first == value.first)
+ if (m_compare(it->first, value.first))
{
return {it, false};
}
@@ -17242,12 +19022,16 @@
insert(*it);
}
}
+
+private:
+ JSON_NO_UNIQUE_ADDRESS key_compare m_compare = key_compare();
};
-} // namespace nlohmann
+NLOHMANN_JSON_NAMESPACE_END
#if defined(JSON_HAS_CPP_17)
+ #include <any>
#include <string_view>
#endif
@@ -17256,8 +19040,7 @@
@see https://github.com/nlohmann
@since version 1.0.0
*/
-namespace nlohmann
-{
+NLOHMANN_JSON_NAMESPACE_BEGIN
/*!
@brief a class to store JSON values
@@ -17282,7 +19065,11 @@
{
private:
template<detail::value_t> friend struct detail::external_constructor;
- friend ::nlohmann::json_pointer<basic_json>;
+
+ template<typename>
+ friend class ::nlohmann::json_pointer;
+ // can be restored when json_pointer backwards compatibility is removed
+ // friend ::nlohmann::json_pointer<StringType>;
template<typename BasicJsonType, typename InputType>
friend class ::nlohmann::detail::parser;
@@ -17341,7 +19128,7 @@
public:
using value_t = detail::value_t;
/// JSON Pointer, see @ref nlohmann::json_pointer
- using json_pointer = ::nlohmann::json_pointer<basic_json>;
+ using json_pointer = ::nlohmann::json_pointer<StringType>;
template<typename T, typename SFINAE>
using json_serializer = JSONSerializer<T, SFINAE>;
/// how to treat decoding errors
@@ -17433,9 +19220,9 @@
result["name"] = "JSON for Modern C++";
result["url"] = "https://github.com/nlohmann/json";
result["version"]["string"] =
- std::to_string(NLOHMANN_JSON_VERSION_MAJOR) + "." +
- std::to_string(NLOHMANN_JSON_VERSION_MINOR) + "." +
- std::to_string(NLOHMANN_JSON_VERSION_PATCH);
+ detail::concat(std::to_string(NLOHMANN_JSON_VERSION_MAJOR), '.',
+ std::to_string(NLOHMANN_JSON_VERSION_MINOR), '.',
+ std::to_string(NLOHMANN_JSON_VERSION_PATCH));
result["version"]["major"] = NLOHMANN_JSON_VERSION_MAJOR;
result["version"]["minor"] = NLOHMANN_JSON_VERSION_MINOR;
result["version"]["patch"] = NLOHMANN_JSON_VERSION_PATCH;
@@ -17457,7 +19244,12 @@
#elif defined(__clang__)
result["compiler"] = {{"family", "clang"}, {"version", __clang_version__}};
#elif defined(__GNUC__) || defined(__GNUG__)
- result["compiler"] = {{"family", "gcc"}, {"version", std::to_string(__GNUC__) + "." + std::to_string(__GNUC_MINOR__) + "." + std::to_string(__GNUC_PATCHLEVEL__)}};
+ result["compiler"] = {{"family", "gcc"}, {"version", detail::concat(
+ std::to_string(__GNUC__), '.',
+ std::to_string(__GNUC_MINOR__), '.',
+ std::to_string(__GNUC_PATCHLEVEL__))
+ }
+ };
#elif defined(__HP_cc) || defined(__HP_aCC)
result["compiler"] = "hp"
#elif defined(__IBMCPP__)
@@ -17472,7 +19264,10 @@
result["compiler"] = {{"family", "unknown"}, {"version", "unknown"}};
#endif
-#ifdef __cplusplus
+
+#if defined(_MSVC_LANG)
+ result["compiler"]["c++"] = std::to_string(_MSVC_LANG);
+#elif defined(__cplusplus)
result["compiler"]["c++"] = std::to_string(__cplusplus);
#else
result["compiler"]["c++"] = "unknown";
@@ -17490,21 +19285,23 @@
/// 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>>>;
@@ -17536,6 +19333,10 @@
/// @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:
@@ -17682,7 +19483,7 @@
object = nullptr; // silence warning, see #821
if (JSON_HEDLEY_UNLIKELY(t == value_t::null))
{
- JSON_THROW(other_error::create(500, "961c151d2e87f2686a955a9be24d316f1362bf21 3.10.5", basic_json())); // LCOV_EXCL_LINE
+ JSON_THROW(other_error::create(500, "961c151d2e87f2686a955a9be24d316f1362bf21 3.11.0", nullptr)); // LCOV_EXCL_LINE
}
break;
}
@@ -17978,7 +19779,7 @@
/// @brief create a null object
/// @sa https://json.nlohmann.me/api/basic_json/basic_json/
- basic_json(std::nullptr_t = nullptr) noexcept
+ basic_json(std::nullptr_t = nullptr) noexcept // NOLINT(bugprone-exception-escape)
: basic_json(value_t::null)
{
assert_invariant();
@@ -18050,6 +19851,7 @@
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();
}
@@ -18080,7 +19882,7 @@
// if object is wanted but impossible, throw an exception
if (JSON_HEDLEY_UNLIKELY(manual_type == value_t::object && !is_an_object))
{
- JSON_THROW(type_error::create(301, "cannot create object from initializer list", basic_json()));
+ JSON_THROW(type_error::create(301, "cannot create object from initializer list", nullptr));
}
}
@@ -18192,7 +19994,7 @@
// make sure iterator fits the current value
if (JSON_HEDLEY_UNLIKELY(first.m_object != last.m_object))
{
- JSON_THROW(invalid_iterator::create(201, "iterators are not compatible", basic_json()));
+ JSON_THROW(invalid_iterator::create(201, "iterators are not compatible", nullptr));
}
// copy type from first iterator
@@ -18210,7 +20012,7 @@
if (JSON_HEDLEY_UNLIKELY(!first.m_it.primitive_iterator.is_begin()
|| !last.m_it.primitive_iterator.is_end()))
{
- JSON_THROW(invalid_iterator::create(204, "iterators out of range", *first.m_object));
+ JSON_THROW(invalid_iterator::create(204, "iterators out of range", first.m_object));
}
break;
}
@@ -18279,7 +20081,7 @@
case value_t::null:
case value_t::discarded:
default:
- JSON_THROW(invalid_iterator::create(206, "cannot construct with iterators from " + std::string(first.m_object->type_name()), *first.m_object));
+ JSON_THROW(invalid_iterator::create(206, detail::concat("cannot construct with iterators from ", first.m_object->type_name()), first.m_object));
}
set_parents();
@@ -18563,7 +20365,7 @@
return m_value.boolean;
}
- JSON_THROW(type_error::create(302, "type must be boolean, but is " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(302, detail::concat("type must be boolean, but is ", type_name()), this));
}
/// get a pointer to the value (object)
@@ -18684,7 +20486,7 @@
return *ptr;
}
- JSON_THROW(type_error::create(303, "incompatible ReferenceType for get_ref, actual type is " + std::string(obj.type_name()), obj));
+ JSON_THROW(type_error::create(303, detail::concat("incompatible ReferenceType for get_ref, actual type is ", obj.type_name()), &obj));
}
public:
@@ -19034,14 +20836,17 @@
template < typename ValueType, typename std::enable_if <
detail::conjunction <
detail::negation<std::is_pointer<ValueType>>,
+ detail::negation<std::is_same<ValueType, std::nullptr_t>>,
detail::negation<std::is_same<ValueType, detail::json_ref<basic_json>>>,
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
+#if defined(JSON_HAS_CPP_17)
+ detail::negation<std::is_same<ValueType, std::any>>,
+#endif
detail::is_detected_lazy<detail::get_template_function, const basic_json_t&, ValueType>
>::value, int >::type = 0 >
JSON_EXPLICIT operator ValueType() const
@@ -19056,7 +20861,7 @@
{
if (!is_binary())
{
- JSON_THROW(type_error::create(302, "type must be binary, but is " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(302, detail::concat("type must be binary, but is ", type_name()), this));
}
return *get_ptr<binary_t*>();
@@ -19068,7 +20873,7 @@
{
if (!is_binary())
{
- JSON_THROW(type_error::create(302, "type must be binary, but is " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(302, detail::concat("type must be binary, but is ", type_name()), this));
}
return *get_ptr<const binary_t*>();
@@ -19099,12 +20904,12 @@
JSON_CATCH (std::out_of_range&)
{
// create better exception explanation
- JSON_THROW(out_of_range::create(401, "array index " + std::to_string(idx) + " is out of range", *this));
+ JSON_THROW(out_of_range::create(401, detail::concat("array index ", std::to_string(idx), " is out of range"), this));
}
}
else
{
- JSON_THROW(type_error::create(304, "cannot use at() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
}
}
@@ -19122,12 +20927,12 @@
JSON_CATCH (std::out_of_range&)
{
// create better exception explanation
- JSON_THROW(out_of_range::create(401, "array index " + std::to_string(idx) + " is out of range", *this));
+ JSON_THROW(out_of_range::create(401, detail::concat("array index ", std::to_string(idx), " is out of range"), this));
}
}
else
{
- JSON_THROW(type_error::create(304, "cannot use at() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
}
}
@@ -19136,22 +20941,37 @@
reference at(const typename object_t::key_type& key)
{
// at only works for objects
- if (JSON_HEDLEY_LIKELY(is_object()))
+ if (JSON_HEDLEY_UNLIKELY(!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, "key '" + key + "' not found", *this));
- }
+ JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
}
- else
+
+ auto it = m_value.object->find(key);
+ if (it == m_value.object->end())
{
- JSON_THROW(type_error::create(304, "cannot use at() with " + std::string(type_name()), *this));
+ 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_basic_json_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
@@ -19159,22 +20979,37 @@
const_reference at(const typename object_t::key_type& key) const
{
// at only works for objects
- if (JSON_HEDLEY_LIKELY(is_object()))
+ if (JSON_HEDLEY_UNLIKELY(!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, "key '" + key + "' not found", *this));
- }
+ JSON_THROW(type_error::create(304, detail::concat("cannot use at() with ", type_name()), this));
}
- else
+
+ auto it = m_value.object->find(key);
+ if (it == m_value.object->end())
{
- JSON_THROW(type_error::create(304, "cannot use at() with " + std::string(type_name()), *this));
+ 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_basic_json_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
@@ -19220,7 +21055,7 @@
return m_value.array->operator[](idx);
}
- JSON_THROW(type_error::create(305, "cannot use operator[] with a numeric argument with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a numeric argument with ", type_name()), this));
}
/// @brief access specified array element
@@ -19233,12 +21068,12 @@
return m_value.array->operator[](idx);
}
- JSON_THROW(type_error::create(305, "cannot use operator[] with a numeric argument with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a numeric argument with ", type_name()), this));
}
/// @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())
@@ -19251,10 +21086,11 @@
// 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, "cannot use operator[] with a string argument with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a string argument with ", type_name()), this));
}
/// @brief access specified object element
@@ -19264,74 +21100,92 @@
// 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, "cannot use operator[] with a string argument with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a string argument with ", type_name()), this));
+ }
+
+ // these two functions resolve a (const) char * ambiguity affecting Clang and MSVC
+ // (they seemingly cannot be constrained to resolve the ambiguity)
+ template<typename T>
+ reference operator[](T* key)
+ {
+ 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<typename T>
- JSON_HEDLEY_NON_NULL(2)
- reference operator[](T* key)
+ template<class KeyType, detail::enable_if_t<
+ detail::is_usable_as_basic_json_key_type<basic_json_t, KeyType>::value, int > = 0 >
+ reference operator[](KeyType && key)
{
- // implicitly convert null to object
+ // 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, "cannot use operator[] with a string argument with " + std::string(type_name()), *this));
+ 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/
- 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_basic_json_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, "cannot use operator[] with a string argument with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(305, detail::concat("cannot use operator[] with a string argument with ", type_name()), this));
}
/// @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, "cannot use value() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(306, detail::concat("cannot use value() with ", type_name()), this));
}
/// @brief access specified object element with default value
@@ -19342,13 +21196,64 @@
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_basic_json_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
@@ -19362,7 +21267,15 @@
}
}
- JSON_THROW(type_error::create(306, "cannot use value() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(306, detail::concat("cannot use value() with ", type_name()), this));
+ }
+
+ 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
+ {
+ return value(ptr.convert(), default_value);
}
/// @brief access specified object element via JSON Pointer with default value
@@ -19374,6 +21287,14 @@
return value(ptr, string_t(default_value));
}
+ template<typename BasicJsonType>
+ JSON_HEDLEY_DEPRECATED_FOR(3.11.0, basic_json::json_pointer or nlohmann::json_pointer<basic_json::string_t>) // NOLINT(readability/alt_tokens)
+ JSON_HEDLEY_NON_NULL(3)
+ string_t value(const typename ::nlohmann::json_pointer<BasicJsonType>& ptr, const char* default_value) const
+ {
+ return value(ptr.convert(), default_value);
+ }
+
/// @brief access the first element
/// @sa https://json.nlohmann.me/api/basic_json/front/
reference front()
@@ -19408,16 +21329,15 @@
/// @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
if (JSON_HEDLEY_UNLIKELY(this != pos.m_object))
{
- JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", this));
}
IteratorType result = end();
@@ -19433,7 +21353,7 @@
{
if (JSON_HEDLEY_UNLIKELY(!pos.m_it.primitive_iterator.is_begin()))
{
- JSON_THROW(invalid_iterator::create(205, "iterator out of range", *this));
+ JSON_THROW(invalid_iterator::create(205, "iterator out of range", this));
}
if (is_string())
@@ -19471,7 +21391,7 @@
case value_t::null:
case value_t::discarded:
default:
- JSON_THROW(type_error::create(307, "cannot use erase() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(307, detail::concat("cannot use erase() with ", type_name()), this));
}
return result;
@@ -19479,16 +21399,15 @@
/// @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
if (JSON_HEDLEY_UNLIKELY(this != first.m_object || this != last.m_object))
{
- JSON_THROW(invalid_iterator::create(203, "iterators do not fit current value", *this));
+ JSON_THROW(invalid_iterator::create(203, "iterators do not fit current value", this));
}
IteratorType result = end();
@@ -19505,7 +21424,7 @@
if (JSON_HEDLEY_LIKELY(!first.m_it.primitive_iterator.is_begin()
|| !last.m_it.primitive_iterator.is_end()))
{
- JSON_THROW(invalid_iterator::create(204, "iterators out of range", *this));
+ JSON_THROW(invalid_iterator::create(204, "iterators out of range", this));
}
if (is_string())
@@ -19545,23 +21464,63 @@
case value_t::null:
case value_t::discarded:
default:
- JSON_THROW(type_error::create(307, "cannot use erase() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(307, detail::concat("cannot use erase() with ", type_name()), this));
}
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, "cannot use erase() with " + std::string(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_basic_json_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
@@ -19573,14 +21532,14 @@
{
if (JSON_HEDLEY_UNLIKELY(idx >= size()))
{
- JSON_THROW(out_of_range::create(401, "array index " + std::to_string(idx) + " is out of range", *this));
+ JSON_THROW(out_of_range::create(401, detail::concat("array index ", std::to_string(idx), " is out of range"), this));
}
m_value.array->erase(m_value.array->begin() + static_cast<difference_type>(idx));
}
else
{
- JSON_THROW(type_error::create(307, "cannot use erase() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(307, detail::concat("cannot use erase() with ", type_name()), this));
}
}
@@ -19596,14 +21555,13 @@
/// @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;
@@ -19611,14 +21569,45 @@
/// @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_basic_json_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_basic_json_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;
@@ -19626,20 +21615,36 @@
/// @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_basic_json_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 <
- !std::is_same<typename std::decay<KeyT>::type, json_pointer>::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_basic_json_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
@@ -19649,6 +21654,13 @@
return ptr.contains(this);
}
+ template<typename BasicJsonType>
+ JSON_HEDLEY_DEPRECATED_FOR(3.11.0, basic_json::json_pointer or nlohmann::json_pointer<basic_json::string_t>) // NOLINT(readability/alt_tokens)
+ bool contains(const typename ::nlohmann::json_pointer<BasicJsonType> ptr) const
+ {
+ return ptr.contains(this);
+ }
+
/// @}
@@ -19988,7 +22000,7 @@
// push_back only works for null objects or arrays
if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_array())))
{
- JSON_THROW(type_error::create(308, "cannot use push_back() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(308, detail::concat("cannot use push_back() with ", type_name()), this));
}
// transform null object into an array
@@ -20021,7 +22033,7 @@
// push_back only works for null objects or arrays
if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_array())))
{
- JSON_THROW(type_error::create(308, "cannot use push_back() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(308, detail::concat("cannot use push_back() with ", type_name()), this));
}
// transform null object into an array
@@ -20053,7 +22065,7 @@
// push_back only works for null objects or objects
if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_object())))
{
- JSON_THROW(type_error::create(308, "cannot use push_back() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(308, detail::concat("cannot use push_back() with ", type_name()), this));
}
// transform null object into an object
@@ -20109,7 +22121,7 @@
// emplace_back only works for null objects or arrays
if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_array())))
{
- JSON_THROW(type_error::create(311, "cannot use emplace_back() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(311, detail::concat("cannot use emplace_back() with ", type_name()), this));
}
// transform null object into an array
@@ -20134,7 +22146,7 @@
// emplace only works for null objects or arrays
if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_object())))
{
- JSON_THROW(type_error::create(311, "cannot use emplace() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(311, detail::concat("cannot use emplace() with ", type_name()), this));
}
// transform null object into an object
@@ -20188,14 +22200,14 @@
// check if iterator pos fits to this JSON value
if (JSON_HEDLEY_UNLIKELY(pos.m_object != this))
{
- JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", this));
}
// insert to array and return iterator
return insert_iterator(pos, val);
}
- JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(309, detail::concat("cannot use insert() with ", type_name()), this));
}
/// @brief inserts element into array
@@ -20215,14 +22227,14 @@
// check if iterator pos fits to this JSON value
if (JSON_HEDLEY_UNLIKELY(pos.m_object != this))
{
- JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", this));
}
// insert to array and return iterator
return insert_iterator(pos, cnt, val);
}
- JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(309, detail::concat("cannot use insert() with ", type_name()), this));
}
/// @brief inserts range of elements into array
@@ -20232,24 +22244,24 @@
// insert only works for arrays
if (JSON_HEDLEY_UNLIKELY(!is_array()))
{
- JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(309, detail::concat("cannot use insert() with ", type_name()), this));
}
// check if iterator pos fits to this JSON value
if (JSON_HEDLEY_UNLIKELY(pos.m_object != this))
{
- JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", this));
}
// check if range iterators belong to the same JSON object
if (JSON_HEDLEY_UNLIKELY(first.m_object != last.m_object))
{
- JSON_THROW(invalid_iterator::create(210, "iterators do not fit", *this));
+ JSON_THROW(invalid_iterator::create(210, "iterators do not fit", this));
}
if (JSON_HEDLEY_UNLIKELY(first.m_object == this))
{
- JSON_THROW(invalid_iterator::create(211, "passed iterators may not belong to container", *this));
+ JSON_THROW(invalid_iterator::create(211, "passed iterators may not belong to container", this));
}
// insert to array and return iterator
@@ -20263,13 +22275,13 @@
// insert only works for arrays
if (JSON_HEDLEY_UNLIKELY(!is_array()))
{
- JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(309, detail::concat("cannot use insert() with ", type_name()), this));
}
// check if iterator pos fits to this JSON value
if (JSON_HEDLEY_UNLIKELY(pos.m_object != this))
{
- JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", this));
}
// insert to array and return iterator
@@ -20283,19 +22295,19 @@
// insert only works for objects
if (JSON_HEDLEY_UNLIKELY(!is_object()))
{
- JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(309, detail::concat("cannot use insert() with ", type_name()), this));
}
// check if range iterators belong to the same JSON object
if (JSON_HEDLEY_UNLIKELY(first.m_object != last.m_object))
{
- JSON_THROW(invalid_iterator::create(210, "iterators do not fit", *this));
+ JSON_THROW(invalid_iterator::create(210, "iterators do not fit", this));
}
// passed iterators must belong to objects
if (JSON_HEDLEY_UNLIKELY(!first.m_object->is_object()))
{
- JSON_THROW(invalid_iterator::create(202, "iterators first and last must point to objects", *this));
+ JSON_THROW(invalid_iterator::create(202, "iterators first and last must point to objects", this));
}
m_value.object->insert(first.m_it.object_iterator, last.m_it.object_iterator);
@@ -20322,19 +22334,19 @@
if (JSON_HEDLEY_UNLIKELY(!is_object()))
{
- JSON_THROW(type_error::create(312, "cannot use update() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(312, detail::concat("cannot use update() with ", type_name()), this));
}
// check if range iterators belong to the same JSON object
if (JSON_HEDLEY_UNLIKELY(first.m_object != last.m_object))
{
- JSON_THROW(invalid_iterator::create(210, "iterators do not fit", *this));
+ JSON_THROW(invalid_iterator::create(210, "iterators do not fit", this));
}
// passed iterators must belong to objects
if (JSON_HEDLEY_UNLIKELY(!first.m_object->is_object()))
{
- JSON_THROW(type_error::create(312, "cannot use update() with " + std::string(first.m_object->type_name()), *first.m_object));
+ JSON_THROW(type_error::create(312, detail::concat("cannot use update() with ", first.m_object->type_name()), first.m_object));
}
for (auto it = first; it != last; ++it)
@@ -20391,11 +22403,12 @@
// swap only works for arrays
if (JSON_HEDLEY_LIKELY(is_array()))
{
- std::swap(*(m_value.array), other);
+ using std::swap;
+ swap(*(m_value.array), other);
}
else
{
- JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(310, detail::concat("cannot use swap(array_t&) with ", type_name()), this));
}
}
@@ -20406,11 +22419,12 @@
// swap only works for objects
if (JSON_HEDLEY_LIKELY(is_object()))
{
- std::swap(*(m_value.object), other);
+ using std::swap;
+ swap(*(m_value.object), other);
}
else
{
- JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(310, detail::concat("cannot use swap(object_t&) with ", type_name()), this));
}
}
@@ -20421,11 +22435,12 @@
// swap only works for strings
if (JSON_HEDLEY_LIKELY(is_string()))
{
- std::swap(*(m_value.string), other);
+ using std::swap;
+ swap(*(m_value.string), other);
}
else
{
- JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(310, detail::concat("cannot use swap(string_t&) with ", type_name()), this));
}
}
@@ -20436,11 +22451,12 @@
// swap only works for strings
if (JSON_HEDLEY_LIKELY(is_binary()))
{
- std::swap(*(m_value.binary), other);
+ using std::swap;
+ swap(*(m_value.binary), other);
}
else
{
- JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(310, detail::concat("cannot use swap(binary_t&) with ", type_name()), this));
}
}
@@ -20451,17 +22467,17 @@
// swap only works for strings
if (JSON_HEDLEY_LIKELY(is_binary()))
{
- std::swap(*(m_value.binary), other);
+ using std::swap;
+ swap(*(m_value.binary), other);
}
else
{
- JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ JSON_THROW(type_error::create(310, detail::concat("cannot use swap(binary_t::container_type&) with ", type_name()), this));
}
}
/// @}
- public:
//////////////////////////////////////////
// lexicographical comparison operators //
//////////////////////////////////////////
@@ -20469,6 +22485,212 @@
/// @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
@@ -20477,71 +22699,7 @@
#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
@@ -20569,6 +22727,10 @@
/// @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);
}
@@ -20594,76 +22756,10 @@
/// @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
@@ -20688,6 +22784,10 @@
/// @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);
}
@@ -20713,6 +22813,11 @@
/// @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);
}
@@ -20738,6 +22843,10 @@
/// @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);
}
@@ -20758,6 +22867,9 @@
{
return basic_json(lhs) >= rhs;
}
+#endif
+
+#undef JSON_IMPLEMENT_OPERATOR
/// @}
@@ -20886,7 +22998,7 @@
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
@@ -20901,7 +23013,7 @@
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
@@ -20922,7 +23034,7 @@
// 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
@@ -21078,6 +23190,33 @@
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)
@@ -21113,7 +23252,7 @@
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);
}
@@ -21129,7 +23268,7 @@
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);
}
@@ -21156,7 +23295,7 @@
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);
}
@@ -21171,7 +23310,7 @@
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);
}
@@ -21186,7 +23325,7 @@
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);
}
@@ -21210,7 +23349,7 @@
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);
}
@@ -21225,7 +23364,7 @@
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);
}
@@ -21240,7 +23379,7 @@
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);
}
@@ -21264,7 +23403,38 @@
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);
}
@@ -21279,7 +23449,7 @@
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);
}
@@ -21294,7 +23464,7 @@
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);
}
@@ -21318,7 +23488,7 @@
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);
}
/// @}
@@ -21337,6 +23507,13 @@
return ptr.get_unchecked(this);
}
+ 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)
+ {
+ return ptr.get_unchecked(this);
+ }
+
/// @brief access specified element via JSON Pointer
/// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
const_reference operator[](const json_pointer& ptr) const
@@ -21344,6 +23521,13 @@
return ptr.get_unchecked(this);
}
+ 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
+ {
+ return ptr.get_unchecked(this);
+ }
+
/// @brief access specified element via JSON Pointer
/// @sa https://json.nlohmann.me/api/basic_json/at/
reference at(const json_pointer& ptr)
@@ -21351,6 +23535,13 @@
return ptr.get_checked(this);
}
+ template<typename BasicJsonType>
+ JSON_HEDLEY_DEPRECATED_FOR(3.11.0, basic_json::json_pointer or nlohmann::json_pointer<basic_json::string_t>) // NOLINT(readability/alt_tokens)
+ reference at(const ::nlohmann::json_pointer<BasicJsonType>& ptr)
+ {
+ return ptr.get_checked(this);
+ }
+
/// @brief access specified element via JSON Pointer
/// @sa https://json.nlohmann.me/api/basic_json/at/
const_reference at(const json_pointer& ptr) const
@@ -21358,6 +23549,13 @@
return ptr.get_checked(this);
}
+ template<typename BasicJsonType>
+ 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 at(const ::nlohmann::json_pointer<BasicJsonType>& ptr) const
+ {
+ return ptr.get_checked(this);
+ }
+
/// @brief return flattened JSON value
/// @sa https://json.nlohmann.me/api/basic_json/flatten/
basic_json flatten() const
@@ -21383,13 +23581,11 @@
/// @name JSON Patch functions
/// @{
- /// @brief applies a JSON patch
+ /// @brief applies a JSON patch in-place without copying the object
/// @sa https://json.nlohmann.me/api/basic_json/patch/
- basic_json patch(const basic_json& json_patch) const
+ void patch_inplace(const basic_json& json_patch)
{
- // make a working copy to apply the patch to
- basic_json result = *this;
-
+ basic_json& result = *this;
// the valid JSON Patch operations
enum class patch_operations {add, remove, replace, move, copy, test, invalid};
@@ -21443,7 +23639,8 @@
// get reference to parent of JSON pointer ptr
const auto last_path = ptr.back();
ptr.pop_back();
- basic_json& parent = result[ptr];
+ // parent must exist when performing patch add per RFC6902 specs
+ basic_json& parent = result.at(ptr);
switch (parent.m_type)
{
@@ -21464,11 +23661,11 @@
}
else
{
- const auto idx = json_pointer::array_index(last_path);
+ const auto idx = json_pointer::template array_index<basic_json_t>(last_path);
if (JSON_HEDLEY_UNLIKELY(idx > parent.size()))
{
// avoid undefined behavior
- JSON_THROW(out_of_range::create(401, "array index " + std::to_string(idx) + " is out of range", parent));
+ JSON_THROW(out_of_range::create(401, detail::concat("array index ", std::to_string(idx), " is out of range"), &parent));
}
// default case: insert add offset
@@ -21509,20 +23706,20 @@
}
else
{
- JSON_THROW(out_of_range::create(403, "key '" + last_path + "' not found", *this));
+ JSON_THROW(out_of_range::create(403, detail::concat("key '", last_path, "' not found"), this));
}
}
else if (parent.is_array())
{
// note erase performs range check
- parent.erase(json_pointer::array_index(last_path));
+ parent.erase(json_pointer::template array_index<basic_json_t>(last_path));
}
};
// type check: top level value must be an array
if (JSON_HEDLEY_UNLIKELY(!json_patch.is_array()))
{
- JSON_THROW(parse_error::create(104, 0, "JSON patch must be an array of objects", json_patch));
+ JSON_THROW(parse_error::create(104, 0, "JSON patch must be an array of objects", &json_patch));
}
// iterate and apply the operations
@@ -21537,20 +23734,20 @@
auto it = val.m_value.object->find(member);
// context-sensitive error message
- const auto error_msg = (op == "op") ? "operation" : "operation '" + op + "'";
+ const auto error_msg = (op == "op") ? "operation" : detail::concat("operation '", op, '\'');
// check if desired value is present
if (JSON_HEDLEY_UNLIKELY(it == val.m_value.object->end()))
{
// NOLINTNEXTLINE(performance-inefficient-string-concatenation)
- JSON_THROW(parse_error::create(105, 0, error_msg + " must have member '" + member + "'", val));
+ JSON_THROW(parse_error::create(105, 0, detail::concat(error_msg, " must have member '", member, "'"), &val));
}
// check if result is of type string
if (JSON_HEDLEY_UNLIKELY(string_type && !it->second.is_string()))
{
// NOLINTNEXTLINE(performance-inefficient-string-concatenation)
- JSON_THROW(parse_error::create(105, 0, error_msg + " must have string member '" + member + "'", val));
+ JSON_THROW(parse_error::create(105, 0, detail::concat(error_msg, " must have string member '", member, "'"), &val));
}
// no error: return value
@@ -21560,7 +23757,7 @@
// type check: every element of the array must be an object
if (JSON_HEDLEY_UNLIKELY(!val.is_object()))
{
- JSON_THROW(parse_error::create(104, 0, "JSON patch must be an array of objects", val));
+ JSON_THROW(parse_error::create(104, 0, "JSON patch must be an array of objects", &val));
}
// collect mandatory members
@@ -21638,7 +23835,7 @@
// throw an exception if test fails
if (JSON_HEDLEY_UNLIKELY(!success))
{
- JSON_THROW(other_error::create(501, "unsuccessful: " + val.dump(), val));
+ JSON_THROW(other_error::create(501, detail::concat("unsuccessful: ", val.dump()), &val));
}
break;
@@ -21649,11 +23846,18 @@
{
// op must be "add", "remove", "replace", "move", "copy", or
// "test"
- JSON_THROW(parse_error::create(105, 0, "operation value '" + op + "' is invalid", val));
+ JSON_THROW(parse_error::create(105, 0, detail::concat("operation value '", op, "' is invalid"), &val));
}
}
}
+ }
+ /// @brief applies a JSON patch to a copy of the current object
+ /// @sa https://json.nlohmann.me/api/basic_json/patch/
+ basic_json patch(const basic_json& json_patch) const
+ {
+ basic_json result = *this;
+ result.patch_inplace(json_patch);
return result;
}
@@ -21691,7 +23895,7 @@
while (i < source.size() && i < target.size())
{
// recursive call to compare array values at index i
- auto temp_diff = diff(source[i], target[i], path + "/" + std::to_string(i));
+ auto temp_diff = diff(source[i], target[i], detail::concat(path, '/', std::to_string(i)));
result.insert(result.end(), temp_diff.begin(), temp_diff.end());
++i;
}
@@ -21708,7 +23912,7 @@
result.insert(result.begin() + end_index, object(
{
{"op", "remove"},
- {"path", path + "/" + std::to_string(i)}
+ {"path", detail::concat(path, '/', std::to_string(i))}
}));
++i;
}
@@ -21719,7 +23923,7 @@
result.push_back(
{
{"op", "add"},
- {"path", path + "/-"},
+ {"path", detail::concat(path, "/-")},
{"value", target[i]}
});
++i;
@@ -21734,7 +23938,7 @@
for (auto it = source.cbegin(); it != source.cend(); ++it)
{
// escape the key name to be used in a JSON patch
- const auto path_key = path + "/" + detail::escape(it.key());
+ const auto path_key = detail::concat(path, '/', detail::escape(it.key()));
if (target.find(it.key()) != target.end())
{
@@ -21758,7 +23962,7 @@
if (source.find(it.key()) == source.end())
{
// found a key that is not in this -> add it
- const auto path_key = path + "/" + detail::escape(it.key());
+ const auto path_key = detail::concat(path, '/', detail::escape(it.key()));
result.push_back(
{
{"op", "add"}, {"path", path_key},
@@ -21791,7 +23995,6 @@
return result;
}
-
/// @}
////////////////////////////////
@@ -21840,7 +24043,30 @@
return j.dump();
}
-} // namespace nlohmann
+inline namespace literals
+{
+inline namespace json_literals
+{
+
+/// @brief user-defined string literal for JSON values
+/// @sa https://json.nlohmann.me/api/basic_json/operator_literal_json/
+JSON_HEDLEY_NON_NULL(1)
+inline nlohmann::json operator "" _json(const char* s, std::size_t n)
+{
+ return nlohmann::json::parse(s, s + n);
+}
+
+/// @brief user-defined string literal for JSON pointer
+/// @sa https://json.nlohmann.me/api/basic_json/operator_literal_json_pointer/
+JSON_HEDLEY_NON_NULL(1)
+inline nlohmann::json::json_pointer operator "" _json_pointer(const char* s, std::size_t n)
+{
+ return nlohmann::json::json_pointer(std::string(s, n));
+}
+
+} // namespace json_literals
+} // namespace literals
+NLOHMANN_JSON_NAMESPACE_END
///////////////////////
// nonmember support //
@@ -21868,10 +24094,14 @@
@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
}
};
@@ -21890,25 +24120,21 @@
#endif
-} // namespace std
+} // namespace std
-/// @brief user-defined string literal for JSON values
-/// @sa https://json.nlohmann.me/api/basic_json/operator_literal_json/
-JSON_HEDLEY_NON_NULL(1)
-inline nlohmann::json operator "" _json(const char* s, std::size_t n)
-{
- return nlohmann::json::parse(s, s + n);
-}
-
-/// @brief user-defined string literal for JSON pointer
-/// @sa https://json.nlohmann.me/api/basic_json/operator_literal_json_pointer/
-JSON_HEDLEY_NON_NULL(1)
-inline nlohmann::json::json_pointer operator "" _json_pointer(const char* s, std::size_t n)
-{
- return nlohmann::json::json_pointer(std::string(s, n));
-}
+#if JSON_USE_GLOBAL_UDLS
+ using namespace nlohmann::literals::json_literals; // NOLINT(build/namespaces_literals)
+#endif
// #include <nlohmann/detail/macro_unscope.hpp>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
// restore clang diagnostic settings
@@ -21919,22 +24145,40 @@
// clean up
#undef JSON_ASSERT
#undef JSON_INTERNAL_CATCH
-#undef JSON_CATCH
#undef JSON_THROW
-#undef JSON_TRY
#undef JSON_PRIVATE_UNLESS_TESTED
-#undef JSON_HAS_CPP_11
-#undef JSON_HAS_CPP_14
-#undef JSON_HAS_CPP_17
-#undef JSON_HAS_CPP_20
-#undef JSON_HAS_FILESYSTEM
-#undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
#undef NLOHMANN_BASIC_JSON_TPL_DECLARATION
#undef NLOHMANN_BASIC_JSON_TPL
#undef JSON_EXPLICIT
#undef NLOHMANN_CAN_CALL_STD_FUNC_IMPL
+#undef JSON_INLINE_VARIABLE
+#undef JSON_NO_UNIQUE_ADDRESS
+#undef JSON_DISABLE_ENUM_SERIALIZATION
+#undef JSON_USE_GLOBAL_UDLS
+
+#ifndef JSON_TEST_KEEP_MACROS
+ #undef JSON_CATCH
+ #undef JSON_TRY
+ #undef JSON_HAS_CPP_11
+ #undef JSON_HAS_CPP_14
+ #undef JSON_HAS_CPP_17
+ #undef JSON_HAS_CPP_20
+ #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>
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#undef JSON_HEDLEY_ALWAYS_INLINE
diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt
deleted file mode 100644
index 4c741f2..0000000
--- a/test/CMakeLists.txt
+++ /dev/null
@@ -1,173 +0,0 @@
-option(JSON_Valgrind "Execute test suite with Valgrind." OFF)
-option(JSON_FastTests "Skip expensive/slow tests." OFF)
-
-# download test data
-include(${CMAKE_CURRENT_SOURCE_DIR}/../cmake/download_test_data.cmake)
-
-# test fixture to download test data
-add_test(NAME "download_test_data" COMMAND ${CMAKE_COMMAND} --build ${CMAKE_BINARY_DIR} --target download_test_data)
-set_tests_properties(download_test_data PROPERTIES FIXTURES_SETUP TEST_DATA)
-
-if(JSON_Valgrind)
- find_program(CMAKE_MEMORYCHECK_COMMAND valgrind)
- message(STATUS "Executing test suite with Valgrind (${CMAKE_MEMORYCHECK_COMMAND})")
- set(memcheck_command "${CMAKE_MEMORYCHECK_COMMAND} ${CMAKE_MEMORYCHECK_COMMAND_OPTIONS} --error-exitcode=1 --leak-check=full")
- separate_arguments(memcheck_command)
-endif()
-
-#############################################################################
-# doctest library with the main function to speed up build
-#############################################################################
-
-add_library(doctest_main OBJECT src/unit.cpp)
-set_target_properties(doctest_main PROPERTIES
- COMPILE_DEFINITIONS "$<$<CXX_COMPILER_ID:MSVC>:_SCL_SECURE_NO_WARNINGS>"
- COMPILE_OPTIONS "$<$<CXX_COMPILER_ID:MSVC>:/EHsc;$<$<CONFIG:Release>:/Od>>"
-)
-if (${CMAKE_VERSION} VERSION_LESS "3.8.0")
- target_compile_features(doctest_main PUBLIC cxx_range_for)
-else()
- target_compile_features(doctest_main PUBLIC cxx_std_11)
-endif()
-target_include_directories(doctest_main PRIVATE "thirdparty/doctest")
-
-# https://stackoverflow.com/questions/2368811/how-to-set-warning-level-in-cmake
-if(MSVC)
- # Force to always compile with W4
- if(CMAKE_CXX_FLAGS MATCHES "/W[0-4]")
- string(REGEX REPLACE "/W[0-4]" "/W4" CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}")
- else()
- set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /W4")
- endif()
-
- # 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<std::map,std::vector,std::string,bool,int64_t,uint64_t,double,std::allocator,nlohmann::adl_serializer>::operator <<': was declared deprecated
- set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /wd4566 /wd4996")
-
- # https://github.com/nlohmann/json/issues/1114
- set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /bigobj")
-endif()
-
-#############################################################################
-# one executable for each unit test file
-#############################################################################
-
-# check if compiler supports C++17
-foreach(feature ${CMAKE_CXX_COMPILE_FEATURES})
- if (${feature} STREQUAL cxx_std_17)
- set(compiler_supports_cpp_17 TRUE)
- endif()
-endforeach()
-# Clang only supports C++17 starting from Clang 5.0
-if ("${CMAKE_CXX_COMPILER_ID}" MATCHES "Clang" AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 5.0)
- unset(compiler_supports_cpp_17)
-endif()
-# MSVC 2015 (14.0) does not support C++17
-if ("${CMAKE_CXX_COMPILER_ID}" MATCHES "MSVC" AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 19.1)
- unset(compiler_supports_cpp_17)
-endif()
-
-file(GLOB files src/unit-*.cpp)
-
-foreach(file ${files})
- get_filename_component(file_basename ${file} NAME_WE)
- string(REGEX REPLACE "unit-([^$]+)" "test-\\1" testcase ${file_basename})
-
- add_executable(${testcase} $<TARGET_OBJECTS:doctest_main> ${file})
- target_compile_definitions(${testcase} PRIVATE DOCTEST_CONFIG_SUPER_FAST_ASSERTS)
- target_compile_options(${testcase} PRIVATE
- $<$<CXX_COMPILER_ID:MSVC>:/EHsc;$<$<CONFIG:Release>:/Od>>
- $<$<NOT:$<CXX_COMPILER_ID:MSVC>>:-Wno-deprecated;-Wno-float-equal>
- $<$<CXX_COMPILER_ID:GNU>:-Wno-deprecated-declarations>
- )
- target_include_directories(${testcase} PRIVATE ${CMAKE_BINARY_DIR}/include thirdparty/doctest thirdparty/fifo_map)
- target_link_libraries(${testcase} PRIVATE ${NLOHMANN_JSON_TARGET_NAME})
-
- # add a copy with C++17 compilation
- if (compiler_supports_cpp_17)
- file(READ ${file} FILE_CONTENT)
- string(FIND "${FILE_CONTENT}" "JSON_HAS_CPP_17" CPP_17_FOUND)
- if(NOT ${CPP_17_FOUND} EQUAL -1)
- add_executable(${testcase}_cpp17 $<TARGET_OBJECTS:doctest_main> ${file})
- target_compile_definitions(${testcase}_cpp17 PRIVATE DOCTEST_CONFIG_SUPER_FAST_ASSERTS)
- target_compile_options(${testcase}_cpp17 PRIVATE
- $<$<CXX_COMPILER_ID:MSVC>:/EHsc;$<$<CONFIG:Release>:/Od>>
- $<$<NOT:$<CXX_COMPILER_ID:MSVC>>:-Wno-deprecated;-Wno-float-equal>
- $<$<CXX_COMPILER_ID:GNU>:-Wno-deprecated-declarations>
- )
- target_include_directories(${testcase}_cpp17 PRIVATE ${CMAKE_BINARY_DIR}/include thirdparty/doctest thirdparty/fifo_map)
- target_link_libraries(${testcase}_cpp17 PRIVATE ${NLOHMANN_JSON_TARGET_NAME})
- target_compile_features(${testcase}_cpp17 PRIVATE cxx_std_17)
-
- if (CMAKE_CXX_COMPILER_ID STREQUAL "GNU" AND CMAKE_CXX_COMPILER_VERSION VERSION_GREATER_EQUAL 8.0 AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 9.0 AND NOT MINGW)
- # fix for https://gcc.gnu.org/bugzilla/show_bug.cgi?id=90050
- target_link_libraries(${testcase}_cpp17 PRIVATE stdc++fs)
- endif()
-
- if (JSON_FastTests)
- add_test(NAME "${testcase}_cpp17"
- COMMAND ${testcase}_cpp17 ${DOCTEST_TEST_FILTER}
- WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
- )
- else()
- add_test(NAME "${testcase}_cpp17"
- COMMAND ${testcase}_cpp17 ${DOCTEST_TEST_FILTER} --no-skip
- WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
- )
- endif()
- set_tests_properties("${testcase}_cpp17" PROPERTIES LABELS "all" FIXTURES_REQUIRED TEST_DATA)
- endif()
- endif()
-
- if (JSON_FastTests)
- add_test(NAME "${testcase}"
- COMMAND ${testcase} ${DOCTEST_TEST_FILTER}
- WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
- )
- else()
- add_test(NAME "${testcase}"
- COMMAND ${testcase} ${DOCTEST_TEST_FILTER} --no-skip
- WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
- )
- endif()
- set_tests_properties("${testcase}" PROPERTIES LABELS "all" FIXTURES_REQUIRED TEST_DATA)
-
- if(JSON_Valgrind)
- add_test(NAME "${testcase}_valgrind"
- COMMAND ${memcheck_command} ${CMAKE_CURRENT_BINARY_DIR}/${testcase} ${DOCTEST_TEST_FILTER}
- WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
- )
- set_tests_properties("${testcase}_valgrind" PROPERTIES LABELS "valgrind" FIXTURES_REQUIRED TEST_DATA)
- endif()
-endforeach()
-
-# disable exceptions for test-disabled_exceptions
-target_compile_definitions(test-disabled_exceptions PUBLIC JSON_NOEXCEPTION)
-if (CMAKE_CXX_COMPILER_ID STREQUAL "Clang" OR CMAKE_CXX_COMPILER_ID STREQUAL "AppleClang" OR CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
- target_compile_options(test-disabled_exceptions PUBLIC -fno-exceptions)
-elseif (CMAKE_CXX_COMPILER_ID STREQUAL "MSVC")
- # disabled due to https://github.com/nlohmann/json/discussions/2824
- #target_compile_options(test-disabled_exceptions PUBLIC /EH)
- #target_compile_definitions(test-disabled_exceptions PUBLIC _HAS_EXCEPTIONS=0)
-endif()
-
-# avoid stack overflow, see https://github.com/nlohmann/json/issues/2955
-if (CMAKE_CXX_COMPILER_ID STREQUAL "MSVC")
- set_property(TARGET test-cbor APPEND_STRING PROPERTY LINK_FLAGS " /STACK:4000000")
- set_property(TARGET test-msgpack APPEND_STRING PROPERTY LINK_FLAGS " /STACK:4000000")
- set_property(TARGET test-ubjson APPEND_STRING PROPERTY LINK_FLAGS " /STACK:4000000")
-endif()
-
-#############################################################################
-# Test the generated build configs
-#############################################################################
-
-# these tests depend on the generated file nlohmann_jsonConfig.cmake
-if (JSON_Install)
- add_subdirectory(cmake_import)
- add_subdirectory(cmake_import_minver)
-endif()
-
-add_subdirectory(cmake_add_subdirectory)
-add_subdirectory(cmake_fetch_content)
-add_subdirectory(cmake_target_include_directories)
diff --git a/test/cmake_add_subdirectory/project/main.cpp b/test/cmake_add_subdirectory/project/main.cpp
deleted file mode 100644
index d2d118b..0000000
--- a/test/cmake_add_subdirectory/project/main.cpp
+++ /dev/null
@@ -1,8 +0,0 @@
-#include <nlohmann/json.hpp>
-
-int main(int argc, char **argv)
-{
- nlohmann::json j;
-
- return 0;
-}
diff --git a/test/cmake_fetch_content/project/main.cpp b/test/cmake_fetch_content/project/main.cpp
deleted file mode 100644
index d2d118b..0000000
--- a/test/cmake_fetch_content/project/main.cpp
+++ /dev/null
@@ -1,8 +0,0 @@
-#include <nlohmann/json.hpp>
-
-int main(int argc, char **argv)
-{
- nlohmann::json j;
-
- return 0;
-}
diff --git a/test/cmake_import/project/main.cpp b/test/cmake_import/project/main.cpp
deleted file mode 100644
index d2d118b..0000000
--- a/test/cmake_import/project/main.cpp
+++ /dev/null
@@ -1,8 +0,0 @@
-#include <nlohmann/json.hpp>
-
-int main(int argc, char **argv)
-{
- nlohmann::json j;
-
- return 0;
-}
diff --git a/test/cmake_import_minver/project/main.cpp b/test/cmake_import_minver/project/main.cpp
deleted file mode 100644
index d2d118b..0000000
--- a/test/cmake_import_minver/project/main.cpp
+++ /dev/null
@@ -1,8 +0,0 @@
-#include <nlohmann/json.hpp>
-
-int main(int argc, char **argv)
-{
- nlohmann::json j;
-
- return 0;
-}
diff --git a/test/cmake_target_include_directories/project/Bar.cpp b/test/cmake_target_include_directories/project/Bar.cpp
deleted file mode 100644
index ed39e28..0000000
--- a/test/cmake_target_include_directories/project/Bar.cpp
+++ /dev/null
@@ -1,3 +0,0 @@
-#include "Bar.hpp"
-
-class Bar;
diff --git a/test/cmake_target_include_directories/project/Bar.hpp b/test/cmake_target_include_directories/project/Bar.hpp
deleted file mode 100644
index bdb1d9b..0000000
--- a/test/cmake_target_include_directories/project/Bar.hpp
+++ /dev/null
@@ -1,4 +0,0 @@
-#include <nlohmann/json.hpp>
-#include "Foo.hpp"
-
-class Bar : public Foo{};
diff --git a/test/cmake_target_include_directories/project/Foo.cpp b/test/cmake_target_include_directories/project/Foo.cpp
deleted file mode 100644
index 6a2ff91..0000000
--- a/test/cmake_target_include_directories/project/Foo.cpp
+++ /dev/null
@@ -1,3 +0,0 @@
-#include "Foo.hpp"
-
-class Foo;
diff --git a/test/cmake_target_include_directories/project/Foo.hpp b/test/cmake_target_include_directories/project/Foo.hpp
deleted file mode 100644
index fd6b1ff..0000000
--- a/test/cmake_target_include_directories/project/Foo.hpp
+++ /dev/null
@@ -1,4 +0,0 @@
-#pragma once
-#include <nlohmann/json.hpp>
-
-class Foo{};
diff --git a/test/cmake_target_include_directories/project/main.cpp b/test/cmake_target_include_directories/project/main.cpp
deleted file mode 100644
index d2d118b..0000000
--- a/test/cmake_target_include_directories/project/main.cpp
+++ /dev/null
@@ -1,8 +0,0 @@
-#include <nlohmann/json.hpp>
-
-int main(int argc, char **argv)
-{
- nlohmann::json j;
-
- return 0;
-}
diff --git a/test/cuda_example/json_cuda.cu b/test/cuda_example/json_cuda.cu
deleted file mode 100644
index d686cd0..0000000
--- a/test/cuda_example/json_cuda.cu
+++ /dev/null
@@ -1,11 +0,0 @@
-#include <nlohmann/json.hpp>
-
-int main()
-{
- nlohmann::ordered_json json = {"Test"};
- json.dump();
-
- // regression for #3013 (ordered_json::reset() compile error with nvcc)
- nlohmann::ordered_json metadata;
- metadata.erase("key");
-}
diff --git a/test/src/unit-assert_macro.cpp b/test/src/unit-assert_macro.cpp
deleted file mode 100644
index 02dd54b..0000000
--- a/test/src/unit-assert_macro.cpp
+++ /dev/null
@@ -1,69 +0,0 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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"
-
-// avoid warning when assert does not abort
-DOCTEST_GCC_SUPPRESS_WARNING_PUSH
-DOCTEST_GCC_SUPPRESS_WARNING("-Wstrict-overflow")
-DOCTEST_CLANG_SUPPRESS_WARNING_PUSH
-DOCTEST_CLANG_SUPPRESS_WARNING("-Wstrict-overflow")
-
-/// global variable to record side effect of assert calls
-static int assert_counter;
-
-/// set failure variable to true instead of calling assert(x)
-#define JSON_ASSERT(x) {if (!(x)) ++assert_counter; }
-
-#include <nlohmann/json.hpp>
-using nlohmann::json;
-
-// the test assumes exceptions to work
-#if !defined(JSON_NOEXCEPTION)
-TEST_CASE("JSON_ASSERT(x)")
-{
- SECTION("basic_json(first, second)")
- {
- assert_counter = 0;
- CHECK(assert_counter == 0);
-
- json::iterator it;
- json j;
-
- // in case assertions do not abort execution, an exception is thrown
- CHECK_THROWS_WITH_AS(json(it, j.end()), "[json.exception.invalid_iterator.201] iterators are not compatible", json::invalid_iterator);
-
- // check that assertion actually happened
- CHECK(assert_counter == 1);
- }
-}
-#endif
-
-DOCTEST_GCC_SUPPRESS_WARNING_POP
-DOCTEST_CLANG_SUPPRESS_WARNING_POP
diff --git a/test/src/unit-class_parser.cpp b/test/src/unit-class_parser.cpp
deleted file mode 100644
index 78fc7dd..0000000
--- a/test/src/unit-class_parser.cpp
+++ /dev/null
@@ -1,1833 +0,0 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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"
-
-#define JSON_TESTS_PRIVATE
-#include <nlohmann/json.hpp>
-using nlohmann::json;
-
-#include <valarray>
-
-namespace
-{
-class SaxEventLogger
-{
- public:
- bool null()
- {
- events.emplace_back("null()");
- return true;
- }
-
- bool boolean(bool val)
- {
- events.emplace_back(val ? "boolean(true)" : "boolean(false)");
- return true;
- }
-
- bool number_integer(json::number_integer_t val)
- {
- events.push_back("number_integer(" + std::to_string(val) + ")");
- return true;
- }
-
- bool number_unsigned(json::number_unsigned_t val)
- {
- events.push_back("number_unsigned(" + std::to_string(val) + ")");
- return true;
- }
-
- bool number_float(json::number_float_t /*unused*/, const std::string& s)
- {
- events.push_back("number_float(" + s + ")");
- return true;
- }
-
- bool string(std::string& val)
- {
- events.push_back("string(" + val + ")");
- return true;
- }
-
- bool binary(json::binary_t& val)
- {
- std::string binary_contents = "binary(";
- std::string comma_space;
- for (auto b : val)
- {
- binary_contents.append(comma_space);
- binary_contents.append(std::to_string(static_cast<int>(b)));
- comma_space = ", ";
- }
- binary_contents.append(")");
- events.push_back(binary_contents);
- return true;
- }
-
- bool start_object(std::size_t elements)
- {
- if (elements == static_cast<std::size_t>(-1))
- {
- events.emplace_back("start_object()");
- }
- else
- {
- events.push_back("start_object(" + std::to_string(elements) + ")");
- }
- return true;
- }
-
- bool key(std::string& val)
- {
- events.push_back("key(" + val + ")");
- return true;
- }
-
- bool end_object()
- {
- events.emplace_back("end_object()");
- return true;
- }
-
- bool start_array(std::size_t elements)
- {
- if (elements == static_cast<std::size_t>(-1))
- {
- events.emplace_back("start_array()");
- }
- else
- {
- events.push_back("start_array(" + std::to_string(elements) + ")");
- }
- return true;
- }
-
- bool end_array()
- {
- events.emplace_back("end_array()");
- return true;
- }
-
- bool parse_error(std::size_t position, const std::string& /*unused*/, const json::exception& /*unused*/)
- {
- errored = true;
- events.push_back("parse_error(" + std::to_string(position) + ")");
- return false;
- }
-
- std::vector<std::string> events {};
- bool errored = false;
-};
-
-class SaxCountdown : public nlohmann::json::json_sax_t
-{
- public:
- explicit SaxCountdown(const int count) : events_left(count)
- {}
-
- bool null() override
- {
- return events_left-- > 0;
- }
-
- bool boolean(bool /*val*/) override
- {
- return events_left-- > 0;
- }
-
- bool number_integer(json::number_integer_t /*val*/) override
- {
- return events_left-- > 0;
- }
-
- bool number_unsigned(json::number_unsigned_t /*val*/) override
- {
- return events_left-- > 0;
- }
-
- bool number_float(json::number_float_t /*val*/, const std::string& /*s*/) override
- {
- return events_left-- > 0;
- }
-
- bool string(std::string& /*val*/) override
- {
- return events_left-- > 0;
- }
-
- bool binary(json::binary_t& /*val*/) override
- {
- return events_left-- > 0;
- }
-
- bool start_object(std::size_t /*elements*/) override
- {
- return events_left-- > 0;
- }
-
- bool key(std::string& /*val*/) override
- {
- return events_left-- > 0;
- }
-
- bool end_object() override
- {
- return events_left-- > 0;
- }
-
- bool start_array(std::size_t /*elements*/) override
- {
- return events_left-- > 0;
- }
-
- bool end_array() override
- {
- return events_left-- > 0;
- }
-
- bool parse_error(std::size_t /*position*/, const std::string& /*last_token*/, const json::exception& /*ex*/) override
- {
- return false;
- }
-
- private:
- int events_left = 0;
-};
-
-json parser_helper(const std::string& s);
-bool accept_helper(const std::string& s);
-void comments_helper(const std::string& s);
-
-json parser_helper(const std::string& s)
-{
- json j;
- json::parser(nlohmann::detail::input_adapter(s)).parse(true, j);
-
- // if this line was reached, no exception occurred
- // -> check if result is the same without exceptions
- json j_nothrow;
- CHECK_NOTHROW(json::parser(nlohmann::detail::input_adapter(s), nullptr, false).parse(true, j_nothrow));
- CHECK(j_nothrow == j);
-
- json j_sax;
- nlohmann::detail::json_sax_dom_parser<json> sdp(j_sax);
- json::sax_parse(s, &sdp);
- CHECK(j_sax == j);
-
- comments_helper(s);
-
- return j;
-}
-
-bool accept_helper(const std::string& s)
-{
- CAPTURE(s)
-
- // 1. parse s without exceptions
- json j;
- CHECK_NOTHROW(json::parser(nlohmann::detail::input_adapter(s), nullptr, false).parse(true, j));
- const bool ok_noexcept = !j.is_discarded();
-
- // 2. accept s
- const bool ok_accept = json::parser(nlohmann::detail::input_adapter(s)).accept(true);
-
- // 3. check if both approaches come to the same result
- CHECK(ok_noexcept == ok_accept);
-
- // 4. parse with SAX (compare with relaxed accept result)
- SaxEventLogger el;
- CHECK_NOTHROW(json::sax_parse(s, &el, json::input_format_t::json, false));
- CHECK(json::parser(nlohmann::detail::input_adapter(s)).accept(false) == !el.errored);
-
- // 5. parse with simple callback
- json::parser_callback_t cb = [](int /*unused*/, json::parse_event_t /*unused*/, json& /*unused*/)
- {
- return true;
- };
- json j_cb = json::parse(s, cb, false);
- const bool ok_noexcept_cb = !j_cb.is_discarded();
-
- // 6. check if this approach came to the same result
- CHECK(ok_noexcept == ok_noexcept_cb);
-
- // 7. check if comments are properly ignored
- if (ok_accept)
- {
- comments_helper(s);
- }
-
- // 8. return result
- return ok_accept;
-}
-
-void comments_helper(const std::string& s)
-{
- json _;
-
- // parse/accept with default parser
- CHECK_NOTHROW(_ = json::parse(s));
- CHECK(json::accept(s));
-
- // parse/accept while skipping comments
- CHECK_NOTHROW(_ = json::parse(s, nullptr, false, true));
- CHECK(json::accept(s, true));
-
- std::vector<std::string> json_with_comments;
-
- // start with a comment
- json_with_comments.push_back(std::string("// this is a comment\n") + s);
- json_with_comments.push_back(std::string("/* this is a comment */") + s);
- // end with a comment
- json_with_comments.push_back(s + "// this is a comment");
- json_with_comments.push_back(s + "/* this is a comment */");
-
- // check all strings
- for (const auto& json_with_comment : json_with_comments)
- {
- CAPTURE(json_with_comment)
- CHECK_THROWS_AS(_ = json::parse(json_with_comment), json::parse_error);
- CHECK(!json::accept(json_with_comment));
-
- CHECK_NOTHROW(_ = json::parse(json_with_comment, nullptr, true, true));
- CHECK(json::accept(json_with_comment, true));
- }
-}
-
-} // namespace
-
-TEST_CASE("parser class")
-{
- SECTION("parse")
- {
- SECTION("null")
- {
- CHECK(parser_helper("null") == json(nullptr));
- }
-
- SECTION("true")
- {
- CHECK(parser_helper("true") == json(true));
- }
-
- SECTION("false")
- {
- CHECK(parser_helper("false") == json(false));
- }
-
- SECTION("array")
- {
- SECTION("empty array")
- {
- CHECK(parser_helper("[]") == json(json::value_t::array));
- CHECK(parser_helper("[ ]") == json(json::value_t::array));
- }
-
- SECTION("nonempty array")
- {
- CHECK(parser_helper("[true, false, null]") == json({true, false, nullptr}));
- }
- }
-
- SECTION("object")
- {
- SECTION("empty object")
- {
- CHECK(parser_helper("{}") == json(json::value_t::object));
- CHECK(parser_helper("{ }") == json(json::value_t::object));
- }
-
- SECTION("nonempty object")
- {
- CHECK(parser_helper("{\"\": true, \"one\": 1, \"two\": null}") == json({{"", true}, {"one", 1}, {"two", nullptr}}));
- }
- }
-
- SECTION("string")
- {
- // empty string
- CHECK(parser_helper("\"\"") == json(json::value_t::string));
-
- SECTION("errors")
- {
- // error: tab in string
- CHECK_THROWS_AS(parser_helper("\"\t\""), json::parse_error&);
- CHECK_THROWS_WITH(parser_helper("\"\t\""),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0009 (HT) must be escaped to \\u0009 or \\t; last read: '\"<U+0009>'");
- // error: newline in string
- CHECK_THROWS_AS(parser_helper("\"\n\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\r\""), json::parse_error&);
- CHECK_THROWS_WITH(parser_helper("\"\n\""),
- "[json.exception.parse_error.101] parse error at line 2, column 0: syntax error while parsing value - invalid string: control character U+000A (LF) must be escaped to \\u000A or \\n; last read: '\"<U+000A>'");
- CHECK_THROWS_WITH(parser_helper("\"\r\""),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+000D (CR) must be escaped to \\u000D or \\r; last read: '\"<U+000D>'");
- // error: backspace in string
- CHECK_THROWS_AS(parser_helper("\"\b\""), json::parse_error&);
- CHECK_THROWS_WITH(parser_helper("\"\b\""),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0008 (BS) must be escaped to \\u0008 or \\b; last read: '\"<U+0008>'");
- // improve code coverage
- CHECK_THROWS_AS(parser_helper("\uFF01"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("[-4:1,]"), json::parse_error&);
- // unescaped control characters
- CHECK_THROWS_AS(parser_helper("\"\x00\""), json::parse_error&); // NOLINT(bugprone-string-literal-with-embedded-nul)
- CHECK_THROWS_AS(parser_helper("\"\x01\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x02\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x03\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x04\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x05\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x06\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x07\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x08\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x09\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x0a\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x0b\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x0c\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x0d\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x0e\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x0f\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x10\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x11\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x12\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x13\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x14\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x15\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x16\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x17\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x18\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x19\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x1a\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x1b\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x1c\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x1d\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x1e\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\x1f\""), json::parse_error&);
- CHECK_THROWS_WITH(parser_helper("\"\x00\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: missing closing quote; last read: '\"'"); // NOLINT(bugprone-string-literal-with-embedded-nul)
- CHECK_THROWS_WITH(parser_helper("\"\x01\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0001 (SOH) must be escaped to \\u0001; last read: '\"<U+0001>'");
- CHECK_THROWS_WITH(parser_helper("\"\x02\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0002 (STX) must be escaped to \\u0002; last read: '\"<U+0002>'");
- CHECK_THROWS_WITH(parser_helper("\"\x03\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0003 (ETX) must be escaped to \\u0003; last read: '\"<U+0003>'");
- CHECK_THROWS_WITH(parser_helper("\"\x04\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0004 (EOT) must be escaped to \\u0004; last read: '\"<U+0004>'");
- CHECK_THROWS_WITH(parser_helper("\"\x05\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0005 (ENQ) must be escaped to \\u0005; last read: '\"<U+0005>'");
- CHECK_THROWS_WITH(parser_helper("\"\x06\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0006 (ACK) must be escaped to \\u0006; last read: '\"<U+0006>'");
- CHECK_THROWS_WITH(parser_helper("\"\x07\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0007 (BEL) must be escaped to \\u0007; last read: '\"<U+0007>'");
- CHECK_THROWS_WITH(parser_helper("\"\x08\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0008 (BS) must be escaped to \\u0008 or \\b; last read: '\"<U+0008>'");
- CHECK_THROWS_WITH(parser_helper("\"\x09\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0009 (HT) must be escaped to \\u0009 or \\t; last read: '\"<U+0009>'");
- CHECK_THROWS_WITH(parser_helper("\"\x0a\""), "[json.exception.parse_error.101] parse error at line 2, column 0: syntax error while parsing value - invalid string: control character U+000A (LF) must be escaped to \\u000A or \\n; last read: '\"<U+000A>'");
- CHECK_THROWS_WITH(parser_helper("\"\x0b\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+000B (VT) must be escaped to \\u000B; last read: '\"<U+000B>'");
- CHECK_THROWS_WITH(parser_helper("\"\x0c\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+000C (FF) must be escaped to \\u000C or \\f; last read: '\"<U+000C>'");
- CHECK_THROWS_WITH(parser_helper("\"\x0d\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+000D (CR) must be escaped to \\u000D or \\r; last read: '\"<U+000D>'");
- CHECK_THROWS_WITH(parser_helper("\"\x0e\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+000E (SO) must be escaped to \\u000E; last read: '\"<U+000E>'");
- CHECK_THROWS_WITH(parser_helper("\"\x0f\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+000F (SI) must be escaped to \\u000F; last read: '\"<U+000F>'");
- CHECK_THROWS_WITH(parser_helper("\"\x10\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0010 (DLE) must be escaped to \\u0010; last read: '\"<U+0010>'");
- CHECK_THROWS_WITH(parser_helper("\"\x11\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0011 (DC1) must be escaped to \\u0011; last read: '\"<U+0011>'");
- CHECK_THROWS_WITH(parser_helper("\"\x12\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0012 (DC2) must be escaped to \\u0012; last read: '\"<U+0012>'");
- CHECK_THROWS_WITH(parser_helper("\"\x13\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0013 (DC3) must be escaped to \\u0013; last read: '\"<U+0013>'");
- CHECK_THROWS_WITH(parser_helper("\"\x14\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0014 (DC4) must be escaped to \\u0014; last read: '\"<U+0014>'");
- CHECK_THROWS_WITH(parser_helper("\"\x15\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0015 (NAK) must be escaped to \\u0015; last read: '\"<U+0015>'");
- CHECK_THROWS_WITH(parser_helper("\"\x16\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0016 (SYN) must be escaped to \\u0016; last read: '\"<U+0016>'");
- CHECK_THROWS_WITH(parser_helper("\"\x17\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0017 (ETB) must be escaped to \\u0017; last read: '\"<U+0017>'");
- CHECK_THROWS_WITH(parser_helper("\"\x18\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0018 (CAN) must be escaped to \\u0018; last read: '\"<U+0018>'");
- CHECK_THROWS_WITH(parser_helper("\"\x19\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0019 (EM) must be escaped to \\u0019; last read: '\"<U+0019>'");
- CHECK_THROWS_WITH(parser_helper("\"\x1a\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+001A (SUB) must be escaped to \\u001A; last read: '\"<U+001A>'");
- CHECK_THROWS_WITH(parser_helper("\"\x1b\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+001B (ESC) must be escaped to \\u001B; last read: '\"<U+001B>'");
- CHECK_THROWS_WITH(parser_helper("\"\x1c\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+001C (FS) must be escaped to \\u001C; last read: '\"<U+001C>'");
- CHECK_THROWS_WITH(parser_helper("\"\x1d\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+001D (GS) must be escaped to \\u001D; last read: '\"<U+001D>'");
- CHECK_THROWS_WITH(parser_helper("\"\x1e\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+001E (RS) must be escaped to \\u001E; last read: '\"<U+001E>'");
- CHECK_THROWS_WITH(parser_helper("\"\x1f\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+001F (US) must be escaped to \\u001F; last read: '\"<U+001F>'");
-
- SECTION("additional test for null byte")
- {
- // The test above for the null byte is wrong, because passing
- // a string to the parser only reads int until it encounters
- // a null byte. This test inserts the null byte later on and
- // uses an iterator range.
- std::string s = "\"1\"";
- s[1] = '\0';
- json _;
- CHECK_THROWS_AS(_ = json::parse(s.begin(), s.end()), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse(s.begin(), s.end()), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0000 (NUL) must be escaped to \\u0000; last read: '\"<U+0000>'");
- }
- }
-
- SECTION("escaped")
- {
- // quotation mark "\""
- auto r1 = R"("\"")"_json;
- CHECK(parser_helper("\"\\\"\"") == r1);
- // reverse solidus "\\"
- auto r2 = R"("\\")"_json;
- CHECK(parser_helper("\"\\\\\"") == r2);
- // solidus
- CHECK(parser_helper("\"\\/\"") == R"("/")"_json);
- // backspace
- CHECK(parser_helper("\"\\b\"") == json("\b"));
- // formfeed
- CHECK(parser_helper("\"\\f\"") == json("\f"));
- // newline
- CHECK(parser_helper("\"\\n\"") == json("\n"));
- // carriage return
- CHECK(parser_helper("\"\\r\"") == json("\r"));
- // horizontal tab
- CHECK(parser_helper("\"\\t\"") == json("\t"));
-
- CHECK(parser_helper("\"\\u0001\"").get<json::string_t>() == "\x01");
- CHECK(parser_helper("\"\\u000a\"").get<json::string_t>() == "\n");
- CHECK(parser_helper("\"\\u00b0\"").get<json::string_t>() == "°");
- CHECK(parser_helper("\"\\u0c00\"").get<json::string_t>() == "ā°");
- CHECK(parser_helper("\"\\ud000\"").get<json::string_t>() == "í");
- CHECK(parser_helper("\"\\u000E\"").get<json::string_t>() == "\x0E");
- CHECK(parser_helper("\"\\u00F0\"").get<json::string_t>() == "ð");
- CHECK(parser_helper("\"\\u0100\"").get<json::string_t>() == "Ä");
- CHECK(parser_helper("\"\\u2000\"").get<json::string_t>() == "â");
- CHECK(parser_helper("\"\\uFFFF\"").get<json::string_t>() == "īŋŋ");
- CHECK(parser_helper("\"\\u20AC\"").get<json::string_t>() == "€");
- CHECK(parser_helper("\"€\"").get<json::string_t>() == "€");
- CHECK(parser_helper("\"đ\"").get<json::string_t>() == "đ");
-
- CHECK(parser_helper("\"\\ud80c\\udc60\"").get<json::string_t>() == "\xf0\x93\x81\xa0");
- CHECK(parser_helper("\"\\ud83c\\udf1e\"").get<json::string_t>() == "đ");
- }
- }
-
- SECTION("number")
- {
- SECTION("integers")
- {
- SECTION("without exponent")
- {
- CHECK(parser_helper("-128") == json(-128));
- CHECK(parser_helper("-0") == json(-0));
- CHECK(parser_helper("0") == json(0));
- CHECK(parser_helper("128") == json(128));
- }
-
- SECTION("with exponent")
- {
- CHECK(parser_helper("0e1") == json(0e1));
- CHECK(parser_helper("0E1") == json(0e1));
-
- CHECK(parser_helper("10000E-4") == json(10000e-4));
- CHECK(parser_helper("10000E-3") == json(10000e-3));
- CHECK(parser_helper("10000E-2") == json(10000e-2));
- CHECK(parser_helper("10000E-1") == json(10000e-1));
- CHECK(parser_helper("10000E0") == json(10000e0));
- CHECK(parser_helper("10000E1") == json(10000e1));
- CHECK(parser_helper("10000E2") == json(10000e2));
- CHECK(parser_helper("10000E3") == json(10000e3));
- CHECK(parser_helper("10000E4") == json(10000e4));
-
- CHECK(parser_helper("10000e-4") == json(10000e-4));
- CHECK(parser_helper("10000e-3") == json(10000e-3));
- CHECK(parser_helper("10000e-2") == json(10000e-2));
- CHECK(parser_helper("10000e-1") == json(10000e-1));
- CHECK(parser_helper("10000e0") == json(10000e0));
- CHECK(parser_helper("10000e1") == json(10000e1));
- CHECK(parser_helper("10000e2") == json(10000e2));
- CHECK(parser_helper("10000e3") == json(10000e3));
- CHECK(parser_helper("10000e4") == json(10000e4));
-
- CHECK(parser_helper("-0e1") == json(-0e1));
- CHECK(parser_helper("-0E1") == json(-0e1));
- CHECK(parser_helper("-0E123") == json(-0e123));
-
- // numbers after exponent
- CHECK(parser_helper("10E0") == json(10e0));
- CHECK(parser_helper("10E1") == json(10e1));
- CHECK(parser_helper("10E2") == json(10e2));
- CHECK(parser_helper("10E3") == json(10e3));
- CHECK(parser_helper("10E4") == json(10e4));
- CHECK(parser_helper("10E5") == json(10e5));
- CHECK(parser_helper("10E6") == json(10e6));
- CHECK(parser_helper("10E7") == json(10e7));
- CHECK(parser_helper("10E8") == json(10e8));
- CHECK(parser_helper("10E9") == json(10e9));
- CHECK(parser_helper("10E+0") == json(10e0));
- CHECK(parser_helper("10E+1") == json(10e1));
- CHECK(parser_helper("10E+2") == json(10e2));
- CHECK(parser_helper("10E+3") == json(10e3));
- CHECK(parser_helper("10E+4") == json(10e4));
- CHECK(parser_helper("10E+5") == json(10e5));
- CHECK(parser_helper("10E+6") == json(10e6));
- CHECK(parser_helper("10E+7") == json(10e7));
- CHECK(parser_helper("10E+8") == json(10e8));
- CHECK(parser_helper("10E+9") == json(10e9));
- CHECK(parser_helper("10E-1") == json(10e-1));
- CHECK(parser_helper("10E-2") == json(10e-2));
- CHECK(parser_helper("10E-3") == json(10e-3));
- CHECK(parser_helper("10E-4") == json(10e-4));
- CHECK(parser_helper("10E-5") == json(10e-5));
- CHECK(parser_helper("10E-6") == json(10e-6));
- CHECK(parser_helper("10E-7") == json(10e-7));
- CHECK(parser_helper("10E-8") == json(10e-8));
- CHECK(parser_helper("10E-9") == json(10e-9));
- }
-
- SECTION("edge cases")
- {
- // From RFC8259, Section 6:
- // Note that when such software is used, numbers that are
- // integers and are in the range [-(2**53)+1, (2**53)-1]
- // are interoperable in the sense that implementations will
- // agree exactly on their numeric values.
-
- // -(2**53)+1
- CHECK(parser_helper("-9007199254740991").get<int64_t>() == -9007199254740991);
- // (2**53)-1
- CHECK(parser_helper("9007199254740991").get<int64_t>() == 9007199254740991);
- }
-
- SECTION("over the edge cases") // issue #178 - Integer conversion to unsigned (incorrect handling of 64 bit integers)
- {
- // While RFC8259, Section 6 specifies a preference for support
- // for ranges in range of IEEE 754-2008 binary64 (double precision)
- // this does not accommodate 64 bit integers without loss of accuracy.
- // As 64 bit integers are now widely used in software, it is desirable
- // to expand support to to the full 64 bit (signed and unsigned) range
- // i.e. -(2**63) -> (2**64)-1.
-
- // -(2**63) ** Note: compilers see negative literals as negated positive numbers (hence the -1))
- CHECK(parser_helper("-9223372036854775808").get<int64_t>() == -9223372036854775807 - 1);
- // (2**63)-1
- CHECK(parser_helper("9223372036854775807").get<int64_t>() == 9223372036854775807);
- // (2**64)-1
- CHECK(parser_helper("18446744073709551615").get<uint64_t>() == 18446744073709551615u);
- }
- }
-
- SECTION("floating-point")
- {
- SECTION("without exponent")
- {
- CHECK(parser_helper("-128.5") == json(-128.5));
- CHECK(parser_helper("0.999") == json(0.999));
- CHECK(parser_helper("128.5") == json(128.5));
- CHECK(parser_helper("-0.0") == json(-0.0));
- }
-
- SECTION("with exponent")
- {
- CHECK(parser_helper("-128.5E3") == json(-128.5E3));
- CHECK(parser_helper("-128.5E-3") == json(-128.5E-3));
- CHECK(parser_helper("-0.0e1") == json(-0.0e1));
- CHECK(parser_helper("-0.0E1") == json(-0.0e1));
- }
- }
-
- SECTION("overflow")
- {
- // overflows during parsing yield an exception
- CHECK_THROWS_AS(parser_helper("1.18973e+4932").empty(), json::out_of_range&);
- CHECK_THROWS_WITH(parser_helper("1.18973e+4932").empty(),
- "[json.exception.out_of_range.406] number overflow parsing '1.18973e+4932'");
- }
-
- SECTION("invalid numbers")
- {
- CHECK_THROWS_AS(parser_helper("01"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("--1"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("1."), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("1E"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("1E-"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("1.E1"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("-1E"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("-0E#"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("-0E-#"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("-0#"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("-0.0:"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("-0.0Z"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("-0E123:"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("-0e0-:"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("-0e-:"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("-0f"), json::parse_error&);
-
- // numbers must not begin with "+"
- CHECK_THROWS_AS(parser_helper("+1"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("+0"), json::parse_error&);
-
- CHECK_THROWS_WITH(parser_helper("01"),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - unexpected number literal; expected end of input");
- CHECK_THROWS_WITH(parser_helper("-01"),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - unexpected number literal; expected end of input");
- CHECK_THROWS_WITH(parser_helper("--1"),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid number; expected digit after '-'; last read: '--'");
- CHECK_THROWS_WITH(parser_helper("1."),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected digit after '.'; last read: '1.'");
- CHECK_THROWS_WITH(parser_helper("1E"),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '1E'");
- CHECK_THROWS_WITH(parser_helper("1E-"),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid number; expected digit after exponent sign; last read: '1E-'");
- CHECK_THROWS_WITH(parser_helper("1.E1"),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected digit after '.'; last read: '1.E'");
- CHECK_THROWS_WITH(parser_helper("-1E"),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '-1E'");
- CHECK_THROWS_WITH(parser_helper("-0E#"),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '-0E#'");
- CHECK_THROWS_WITH(parser_helper("-0E-#"),
- "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid number; expected digit after exponent sign; last read: '-0E-#'");
- CHECK_THROWS_WITH(parser_helper("-0#"),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid literal; last read: '-0#'; expected end of input");
- CHECK_THROWS_WITH(parser_helper("-0.0:"),
- "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - unexpected ':'; expected end of input");
- CHECK_THROWS_WITH(parser_helper("-0.0Z"),
- "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid literal; last read: '-0.0Z'; expected end of input");
- CHECK_THROWS_WITH(parser_helper("-0E123:"),
- "[json.exception.parse_error.101] parse error at line 1, column 7: syntax error while parsing value - unexpected ':'; expected end of input");
- CHECK_THROWS_WITH(parser_helper("-0e0-:"),
- "[json.exception.parse_error.101] parse error at line 1, column 6: syntax error while parsing value - invalid number; expected digit after '-'; last read: '-:'; expected end of input");
- CHECK_THROWS_WITH(parser_helper("-0e-:"),
- "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid number; expected digit after exponent sign; last read: '-0e-:'");
- CHECK_THROWS_WITH(parser_helper("-0f"),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: '-0f'; expected end of input");
- }
- }
- }
-
- SECTION("accept")
- {
- SECTION("null")
- {
- CHECK(accept_helper("null"));
- }
-
- SECTION("true")
- {
- CHECK(accept_helper("true"));
- }
-
- SECTION("false")
- {
- CHECK(accept_helper("false"));
- }
-
- SECTION("array")
- {
- SECTION("empty array")
- {
- CHECK(accept_helper("[]"));
- CHECK(accept_helper("[ ]"));
- }
-
- SECTION("nonempty array")
- {
- CHECK(accept_helper("[true, false, null]"));
- }
- }
-
- SECTION("object")
- {
- SECTION("empty object")
- {
- CHECK(accept_helper("{}"));
- CHECK(accept_helper("{ }"));
- }
-
- SECTION("nonempty object")
- {
- CHECK(accept_helper("{\"\": true, \"one\": 1, \"two\": null}"));
- }
- }
-
- SECTION("string")
- {
- // empty string
- CHECK(accept_helper("\"\""));
-
- SECTION("errors")
- {
- // error: tab in string
- CHECK(accept_helper("\"\t\"") == false);
- // error: newline in string
- CHECK(accept_helper("\"\n\"") == false);
- CHECK(accept_helper("\"\r\"") == false);
- // error: backspace in string
- CHECK(accept_helper("\"\b\"") == false);
- // improve code coverage
- CHECK(accept_helper("\uFF01") == false);
- CHECK(accept_helper("[-4:1,]") == false);
- // unescaped control characters
- CHECK(accept_helper("\"\x00\"") == false); // NOLINT(bugprone-string-literal-with-embedded-nul)
- CHECK(accept_helper("\"\x01\"") == false);
- CHECK(accept_helper("\"\x02\"") == false);
- CHECK(accept_helper("\"\x03\"") == false);
- CHECK(accept_helper("\"\x04\"") == false);
- CHECK(accept_helper("\"\x05\"") == false);
- CHECK(accept_helper("\"\x06\"") == false);
- CHECK(accept_helper("\"\x07\"") == false);
- CHECK(accept_helper("\"\x08\"") == false);
- CHECK(accept_helper("\"\x09\"") == false);
- CHECK(accept_helper("\"\x0a\"") == false);
- CHECK(accept_helper("\"\x0b\"") == false);
- CHECK(accept_helper("\"\x0c\"") == false);
- CHECK(accept_helper("\"\x0d\"") == false);
- CHECK(accept_helper("\"\x0e\"") == false);
- CHECK(accept_helper("\"\x0f\"") == false);
- CHECK(accept_helper("\"\x10\"") == false);
- CHECK(accept_helper("\"\x11\"") == false);
- CHECK(accept_helper("\"\x12\"") == false);
- CHECK(accept_helper("\"\x13\"") == false);
- CHECK(accept_helper("\"\x14\"") == false);
- CHECK(accept_helper("\"\x15\"") == false);
- CHECK(accept_helper("\"\x16\"") == false);
- CHECK(accept_helper("\"\x17\"") == false);
- CHECK(accept_helper("\"\x18\"") == false);
- CHECK(accept_helper("\"\x19\"") == false);
- CHECK(accept_helper("\"\x1a\"") == false);
- CHECK(accept_helper("\"\x1b\"") == false);
- CHECK(accept_helper("\"\x1c\"") == false);
- CHECK(accept_helper("\"\x1d\"") == false);
- CHECK(accept_helper("\"\x1e\"") == false);
- CHECK(accept_helper("\"\x1f\"") == false);
- }
-
- SECTION("escaped")
- {
- // quotation mark "\""
- auto r1 = R"("\"")"_json;
- CHECK(accept_helper("\"\\\"\""));
- // reverse solidus "\\"
- auto r2 = R"("\\")"_json;
- CHECK(accept_helper("\"\\\\\""));
- // solidus
- CHECK(accept_helper("\"\\/\""));
- // backspace
- CHECK(accept_helper("\"\\b\""));
- // formfeed
- CHECK(accept_helper("\"\\f\""));
- // newline
- CHECK(accept_helper("\"\\n\""));
- // carriage return
- CHECK(accept_helper("\"\\r\""));
- // horizontal tab
- CHECK(accept_helper("\"\\t\""));
-
- CHECK(accept_helper("\"\\u0001\""));
- CHECK(accept_helper("\"\\u000a\""));
- CHECK(accept_helper("\"\\u00b0\""));
- CHECK(accept_helper("\"\\u0c00\""));
- CHECK(accept_helper("\"\\ud000\""));
- CHECK(accept_helper("\"\\u000E\""));
- CHECK(accept_helper("\"\\u00F0\""));
- CHECK(accept_helper("\"\\u0100\""));
- CHECK(accept_helper("\"\\u2000\""));
- CHECK(accept_helper("\"\\uFFFF\""));
- CHECK(accept_helper("\"\\u20AC\""));
- CHECK(accept_helper("\"€\""));
- CHECK(accept_helper("\"đ\""));
-
- CHECK(accept_helper("\"\\ud80c\\udc60\""));
- CHECK(accept_helper("\"\\ud83c\\udf1e\""));
- }
- }
-
- SECTION("number")
- {
- SECTION("integers")
- {
- SECTION("without exponent")
- {
- CHECK(accept_helper("-128"));
- CHECK(accept_helper("-0"));
- CHECK(accept_helper("0"));
- CHECK(accept_helper("128"));
- }
-
- SECTION("with exponent")
- {
- CHECK(accept_helper("0e1"));
- CHECK(accept_helper("0E1"));
-
- CHECK(accept_helper("10000E-4"));
- CHECK(accept_helper("10000E-3"));
- CHECK(accept_helper("10000E-2"));
- CHECK(accept_helper("10000E-1"));
- CHECK(accept_helper("10000E0"));
- CHECK(accept_helper("10000E1"));
- CHECK(accept_helper("10000E2"));
- CHECK(accept_helper("10000E3"));
- CHECK(accept_helper("10000E4"));
-
- CHECK(accept_helper("10000e-4"));
- CHECK(accept_helper("10000e-3"));
- CHECK(accept_helper("10000e-2"));
- CHECK(accept_helper("10000e-1"));
- CHECK(accept_helper("10000e0"));
- CHECK(accept_helper("10000e1"));
- CHECK(accept_helper("10000e2"));
- CHECK(accept_helper("10000e3"));
- CHECK(accept_helper("10000e4"));
-
- CHECK(accept_helper("-0e1"));
- CHECK(accept_helper("-0E1"));
- CHECK(accept_helper("-0E123"));
- }
-
- SECTION("edge cases")
- {
- // From RFC8259, Section 6:
- // Note that when such software is used, numbers that are
- // integers and are in the range [-(2**53)+1, (2**53)-1]
- // are interoperable in the sense that implementations will
- // agree exactly on their numeric values.
-
- // -(2**53)+1
- CHECK(accept_helper("-9007199254740991"));
- // (2**53)-1
- CHECK(accept_helper("9007199254740991"));
- }
-
- SECTION("over the edge cases") // issue #178 - Integer conversion to unsigned (incorrect handling of 64 bit integers)
- {
- // While RFC8259, Section 6 specifies a preference for support
- // for ranges in range of IEEE 754-2008 binary64 (double precision)
- // this does not accommodate 64 bit integers without loss of accuracy.
- // As 64 bit integers are now widely used in software, it is desirable
- // to expand support to to the full 64 bit (signed and unsigned) range
- // i.e. -(2**63) -> (2**64)-1.
-
- // -(2**63) ** Note: compilers see negative literals as negated positive numbers (hence the -1))
- CHECK(accept_helper("-9223372036854775808"));
- // (2**63)-1
- CHECK(accept_helper("9223372036854775807"));
- // (2**64)-1
- CHECK(accept_helper("18446744073709551615"));
- }
- }
-
- SECTION("floating-point")
- {
- SECTION("without exponent")
- {
- CHECK(accept_helper("-128.5"));
- CHECK(accept_helper("0.999"));
- CHECK(accept_helper("128.5"));
- CHECK(accept_helper("-0.0"));
- }
-
- SECTION("with exponent")
- {
- CHECK(accept_helper("-128.5E3"));
- CHECK(accept_helper("-128.5E-3"));
- CHECK(accept_helper("-0.0e1"));
- CHECK(accept_helper("-0.0E1"));
- }
- }
-
- SECTION("overflow")
- {
- // overflows during parsing
- CHECK(!accept_helper("1.18973e+4932"));
- }
-
- SECTION("invalid numbers")
- {
- CHECK(accept_helper("01") == false);
- CHECK(accept_helper("--1") == false);
- CHECK(accept_helper("1.") == false);
- CHECK(accept_helper("1E") == false);
- CHECK(accept_helper("1E-") == false);
- CHECK(accept_helper("1.E1") == false);
- CHECK(accept_helper("-1E") == false);
- CHECK(accept_helper("-0E#") == false);
- CHECK(accept_helper("-0E-#") == false);
- CHECK(accept_helper("-0#") == false);
- CHECK(accept_helper("-0.0:") == false);
- CHECK(accept_helper("-0.0Z") == false);
- CHECK(accept_helper("-0E123:") == false);
- CHECK(accept_helper("-0e0-:") == false);
- CHECK(accept_helper("-0e-:") == false);
- CHECK(accept_helper("-0f") == false);
-
- // numbers must not begin with "+"
- CHECK(accept_helper("+1") == false);
- CHECK(accept_helper("+0") == false);
- }
- }
- }
-
- SECTION("parse errors")
- {
- // unexpected end of number
- CHECK_THROWS_AS(parser_helper("0."), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("-"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("--"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("-0."), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("-."), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("-:"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("0.:"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("e."), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("1e."), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("1e/"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("1e:"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("1E."), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("1E/"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("1E:"), json::parse_error&);
- CHECK_THROWS_WITH(parser_helper("0."),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected digit after '.'; last read: '0.'");
- CHECK_THROWS_WITH(parser_helper("-"),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid number; expected digit after '-'; last read: '-'");
- CHECK_THROWS_WITH(parser_helper("--"),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid number; expected digit after '-'; last read: '--'");
- CHECK_THROWS_WITH(parser_helper("-0."),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid number; expected digit after '.'; last read: '-0.'");
- CHECK_THROWS_WITH(parser_helper("-."),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid number; expected digit after '-'; last read: '-.'");
- CHECK_THROWS_WITH(parser_helper("-:"),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid number; expected digit after '-'; last read: '-:'");
- CHECK_THROWS_WITH(parser_helper("0.:"),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected digit after '.'; last read: '0.:'");
- CHECK_THROWS_WITH(parser_helper("e."),
- "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - invalid literal; last read: 'e'");
- CHECK_THROWS_WITH(parser_helper("1e."),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '1e.'");
- CHECK_THROWS_WITH(parser_helper("1e/"),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '1e/'");
- CHECK_THROWS_WITH(parser_helper("1e:"),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '1e:'");
- CHECK_THROWS_WITH(parser_helper("1E."),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '1E.'");
- CHECK_THROWS_WITH(parser_helper("1E/"),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '1E/'");
- CHECK_THROWS_WITH(parser_helper("1E:"),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '1E:'");
-
- // unexpected end of null
- CHECK_THROWS_AS(parser_helper("n"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("nu"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("nul"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("nulk"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("nulm"), json::parse_error&);
- CHECK_THROWS_WITH(parser_helper("n"),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid literal; last read: 'n'");
- CHECK_THROWS_WITH(parser_helper("nu"),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid literal; last read: 'nu'");
- CHECK_THROWS_WITH(parser_helper("nul"),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: 'nul'");
- CHECK_THROWS_WITH(parser_helper("nulk"),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: 'nulk'");
- CHECK_THROWS_WITH(parser_helper("nulm"),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: 'nulm'");
-
- // unexpected end of true
- CHECK_THROWS_AS(parser_helper("t"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("tr"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("tru"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("trud"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("truf"), json::parse_error&);
- CHECK_THROWS_WITH(parser_helper("t"),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid literal; last read: 't'");
- CHECK_THROWS_WITH(parser_helper("tr"),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid literal; last read: 'tr'");
- CHECK_THROWS_WITH(parser_helper("tru"),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: 'tru'");
- CHECK_THROWS_WITH(parser_helper("trud"),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: 'trud'");
- CHECK_THROWS_WITH(parser_helper("truf"),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: 'truf'");
-
- // unexpected end of false
- CHECK_THROWS_AS(parser_helper("f"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("fa"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("fal"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("fals"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("falsd"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("falsf"), json::parse_error&);
- CHECK_THROWS_WITH(parser_helper("f"),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid literal; last read: 'f'");
- CHECK_THROWS_WITH(parser_helper("fa"),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid literal; last read: 'fa'");
- CHECK_THROWS_WITH(parser_helper("fal"),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: 'fal'");
- CHECK_THROWS_WITH(parser_helper("fals"),
- "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid literal; last read: 'fals'");
- CHECK_THROWS_WITH(parser_helper("falsd"),
- "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid literal; last read: 'falsd'");
- CHECK_THROWS_WITH(parser_helper("falsf"),
- "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid literal; last read: 'falsf'");
-
- // missing/unexpected end of array
- CHECK_THROWS_AS(parser_helper("["), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("[1"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("[1,"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("[1,]"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("]"), json::parse_error&);
- CHECK_THROWS_WITH(parser_helper("["),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
- CHECK_THROWS_WITH(parser_helper("[1"),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing array - unexpected end of input; expected ']'");
- CHECK_THROWS_WITH(parser_helper("[1,"),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
- CHECK_THROWS_WITH(parser_helper("[1,]"),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - unexpected ']'; expected '[', '{', or a literal");
- CHECK_THROWS_WITH(parser_helper("]"),
- "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected ']'; expected '[', '{', or a literal");
-
- // missing/unexpected end of object
- CHECK_THROWS_AS(parser_helper("{"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("{\"foo\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("{\"foo\":"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("{\"foo\":}"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("{\"foo\":1,}"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("}"), json::parse_error&);
- CHECK_THROWS_WITH(parser_helper("{"),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing object key - unexpected end of input; expected string literal");
- CHECK_THROWS_WITH(parser_helper("{\"foo\""),
- "[json.exception.parse_error.101] parse error at line 1, column 7: syntax error while parsing object separator - unexpected end of input; expected ':'");
- CHECK_THROWS_WITH(parser_helper("{\"foo\":"),
- "[json.exception.parse_error.101] parse error at line 1, column 8: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
- CHECK_THROWS_WITH(parser_helper("{\"foo\":}"),
- "[json.exception.parse_error.101] parse error at line 1, column 8: syntax error while parsing value - unexpected '}'; expected '[', '{', or a literal");
- CHECK_THROWS_WITH(parser_helper("{\"foo\":1,}"),
- "[json.exception.parse_error.101] parse error at line 1, column 10: syntax error while parsing object key - unexpected '}'; expected string literal");
- CHECK_THROWS_WITH(parser_helper("}"),
- "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected '}'; expected '[', '{', or a literal");
-
- // missing/unexpected end of string
- CHECK_THROWS_AS(parser_helper("\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\\\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\\u\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\\u0\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\\u01\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\\u012\""), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\\u"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\\u0"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\\u01"), json::parse_error&);
- CHECK_THROWS_AS(parser_helper("\"\\u012"), json::parse_error&);
- CHECK_THROWS_WITH(parser_helper("\""),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: missing closing quote; last read: '\"'");
- CHECK_THROWS_WITH(parser_helper("\"\\\""),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid string: missing closing quote; last read: '\"\\\"'");
- CHECK_THROWS_WITH(parser_helper("\"\\u\""),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u\"'");
- CHECK_THROWS_WITH(parser_helper("\"\\u0\""),
- "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u0\"'");
- CHECK_THROWS_WITH(parser_helper("\"\\u01\""),
- "[json.exception.parse_error.101] parse error at line 1, column 6: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u01\"'");
- CHECK_THROWS_WITH(parser_helper("\"\\u012\""),
- "[json.exception.parse_error.101] parse error at line 1, column 7: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u012\"'");
- CHECK_THROWS_WITH(parser_helper("\"\\u"),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u'");
- CHECK_THROWS_WITH(parser_helper("\"\\u0"),
- "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u0'");
- CHECK_THROWS_WITH(parser_helper("\"\\u01"),
- "[json.exception.parse_error.101] parse error at line 1, column 6: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u01'");
- CHECK_THROWS_WITH(parser_helper("\"\\u012"),
- "[json.exception.parse_error.101] parse error at line 1, column 7: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u012'");
-
- // invalid escapes
- for (int c = 1; c < 128; ++c)
- {
- auto s = std::string("\"\\") + std::string(1, static_cast<char>(c)) + "\"";
-
- switch (c)
- {
- // valid escapes
- case ('"'):
- case ('\\'):
- case ('/'):
- case ('b'):
- case ('f'):
- case ('n'):
- case ('r'):
- case ('t'):
- {
- CHECK_NOTHROW(parser_helper(s));
- break;
- }
-
- // \u must be followed with four numbers, so we skip it here
- case ('u'):
- {
- break;
- }
-
- // any other combination of backslash and character is invalid
- default:
- {
- CHECK_THROWS_AS(parser_helper(s), json::parse_error&);
- // only check error message if c is not a control character
- if (c > 0x1f)
- {
- CHECK_THROWS_WITH_STD_STR(parser_helper(s),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid string: forbidden character after backslash; last read: '\"\\" + std::string(1, static_cast<char>(c)) + "'");
- }
- break;
- }
- }
- }
-
- // invalid \uxxxx escapes
- {
- // check whether character is a valid hex character
- const auto valid = [](int c)
- {
- switch (c)
- {
- case ('0'):
- case ('1'):
- case ('2'):
- case ('3'):
- case ('4'):
- case ('5'):
- case ('6'):
- case ('7'):
- case ('8'):
- case ('9'):
- case ('a'):
- case ('b'):
- case ('c'):
- case ('d'):
- case ('e'):
- case ('f'):
- case ('A'):
- case ('B'):
- case ('C'):
- case ('D'):
- case ('E'):
- case ('F'):
- {
- return true;
- }
-
- default:
- {
- return false;
- }
- }
- };
-
- for (int c = 1; c < 128; ++c)
- {
- std::string s = "\"\\u";
-
- // create a string with the iterated character at each position
- auto s1 = s + "000" + std::string(1, static_cast<char>(c)) + "\"";
- auto s2 = s + "00" + std::string(1, static_cast<char>(c)) + "0\"";
- auto s3 = s + "0" + std::string(1, static_cast<char>(c)) + "00\"";
- auto s4 = s + std::string(1, static_cast<char>(c)) + "000\"";
-
- if (valid(c))
- {
- CAPTURE(s1)
- CHECK_NOTHROW(parser_helper(s1));
- CAPTURE(s2)
- CHECK_NOTHROW(parser_helper(s2));
- CAPTURE(s3)
- CHECK_NOTHROW(parser_helper(s3));
- CAPTURE(s4)
- CHECK_NOTHROW(parser_helper(s4));
- }
- else
- {
- CAPTURE(s1)
- CHECK_THROWS_AS(parser_helper(s1), json::parse_error&);
- // only check error message if c is not a control character
- if (c > 0x1f)
- {
- CHECK_THROWS_WITH_STD_STR(parser_helper(s1),
- "[json.exception.parse_error.101] parse error at line 1, column 7: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '" + s1.substr(0, 7) + "'");
- }
-
- CAPTURE(s2)
- CHECK_THROWS_AS(parser_helper(s2), json::parse_error&);
- // only check error message if c is not a control character
- if (c > 0x1f)
- {
- CHECK_THROWS_WITH_STD_STR(parser_helper(s2),
- "[json.exception.parse_error.101] parse error at line 1, column 6: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '" + s2.substr(0, 6) + "'");
- }
-
- CAPTURE(s3)
- CHECK_THROWS_AS(parser_helper(s3), json::parse_error&);
- // only check error message if c is not a control character
- if (c > 0x1f)
- {
- CHECK_THROWS_WITH_STD_STR(parser_helper(s3),
- "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '" + s3.substr(0, 5) + "'");
- }
-
- CAPTURE(s4)
- CHECK_THROWS_AS(parser_helper(s4), json::parse_error&);
- // only check error message if c is not a control character
- if (c > 0x1f)
- {
- CHECK_THROWS_WITH_STD_STR(parser_helper(s4),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '" + s4.substr(0, 4) + "'");
- }
- }
- }
- }
-
- json _;
-
- // missing part of a surrogate pair
- CHECK_THROWS_AS(_ = json::parse("\"\\uD80C\""), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse("\"\\uD80C\""),
- "[json.exception.parse_error.101] parse error at line 1, column 8: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD80C\"'");
- // invalid surrogate pair
- CHECK_THROWS_AS(_ = json::parse("\"\\uD80C\\uD80C\""), json::parse_error&);
- CHECK_THROWS_AS(_ = json::parse("\"\\uD80C\\u0000\""), json::parse_error&);
- CHECK_THROWS_AS(_ = json::parse("\"\\uD80C\\uFFFF\""), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse("\"\\uD80C\\uD80C\""),
- "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD80C\\uD80C'");
- CHECK_THROWS_WITH(_ = json::parse("\"\\uD80C\\u0000\""),
- "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD80C\\u0000'");
- CHECK_THROWS_WITH(_ = json::parse("\"\\uD80C\\uFFFF\""),
- "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD80C\\uFFFF'");
- }
-
- SECTION("parse errors (accept)")
- {
- // unexpected end of number
- CHECK(accept_helper("0.") == false);
- CHECK(accept_helper("-") == false);
- CHECK(accept_helper("--") == false);
- CHECK(accept_helper("-0.") == false);
- CHECK(accept_helper("-.") == false);
- CHECK(accept_helper("-:") == false);
- CHECK(accept_helper("0.:") == false);
- CHECK(accept_helper("e.") == false);
- CHECK(accept_helper("1e.") == false);
- CHECK(accept_helper("1e/") == false);
- CHECK(accept_helper("1e:") == false);
- CHECK(accept_helper("1E.") == false);
- CHECK(accept_helper("1E/") == false);
- CHECK(accept_helper("1E:") == false);
-
- // unexpected end of null
- CHECK(accept_helper("n") == false);
- CHECK(accept_helper("nu") == false);
- CHECK(accept_helper("nul") == false);
-
- // unexpected end of true
- CHECK(accept_helper("t") == false);
- CHECK(accept_helper("tr") == false);
- CHECK(accept_helper("tru") == false);
-
- // unexpected end of false
- CHECK(accept_helper("f") == false);
- CHECK(accept_helper("fa") == false);
- CHECK(accept_helper("fal") == false);
- CHECK(accept_helper("fals") == false);
-
- // missing/unexpected end of array
- CHECK(accept_helper("[") == false);
- CHECK(accept_helper("[1") == false);
- CHECK(accept_helper("[1,") == false);
- CHECK(accept_helper("[1,]") == false);
- CHECK(accept_helper("]") == false);
-
- // missing/unexpected end of object
- CHECK(accept_helper("{") == false);
- CHECK(accept_helper("{\"foo\"") == false);
- CHECK(accept_helper("{\"foo\":") == false);
- CHECK(accept_helper("{\"foo\":}") == false);
- CHECK(accept_helper("{\"foo\":1,}") == false);
- CHECK(accept_helper("}") == false);
-
- // missing/unexpected end of string
- CHECK(accept_helper("\"") == false);
- CHECK(accept_helper("\"\\\"") == false);
- CHECK(accept_helper("\"\\u\"") == false);
- CHECK(accept_helper("\"\\u0\"") == false);
- CHECK(accept_helper("\"\\u01\"") == false);
- CHECK(accept_helper("\"\\u012\"") == false);
- CHECK(accept_helper("\"\\u") == false);
- CHECK(accept_helper("\"\\u0") == false);
- CHECK(accept_helper("\"\\u01") == false);
- CHECK(accept_helper("\"\\u012") == false);
-
- // unget of newline
- CHECK(parser_helper("\n123\n") == 123);
-
- // invalid escapes
- for (int c = 1; c < 128; ++c)
- {
- auto s = std::string("\"\\") + std::string(1, static_cast<char>(c)) + "\"";
-
- switch (c)
- {
- // valid escapes
- case ('"'):
- case ('\\'):
- case ('/'):
- case ('b'):
- case ('f'):
- case ('n'):
- case ('r'):
- case ('t'):
- {
- CHECK(json::parser(nlohmann::detail::input_adapter(s)).accept());
- break;
- }
-
- // \u must be followed with four numbers, so we skip it here
- case ('u'):
- {
- break;
- }
-
- // any other combination of backslash and character is invalid
- default:
- {
- CHECK(json::parser(nlohmann::detail::input_adapter(s)).accept() == false);
- break;
- }
- }
- }
-
- // invalid \uxxxx escapes
- {
- // check whether character is a valid hex character
- const auto valid = [](int c)
- {
- switch (c)
- {
- case ('0'):
- case ('1'):
- case ('2'):
- case ('3'):
- case ('4'):
- case ('5'):
- case ('6'):
- case ('7'):
- case ('8'):
- case ('9'):
- case ('a'):
- case ('b'):
- case ('c'):
- case ('d'):
- case ('e'):
- case ('f'):
- case ('A'):
- case ('B'):
- case ('C'):
- case ('D'):
- case ('E'):
- case ('F'):
- {
- return true;
- }
-
- default:
- {
- return false;
- }
- }
- };
-
- for (int c = 1; c < 128; ++c)
- {
- std::string s = "\"\\u";
-
- // create a string with the iterated character at each position
- const auto s1 = s + "000" + std::string(1, static_cast<char>(c)) + "\"";
- const auto s2 = s + "00" + std::string(1, static_cast<char>(c)) + "0\"";
- const auto s3 = s + "0" + std::string(1, static_cast<char>(c)) + "00\"";
- const auto s4 = s + std::string(1, static_cast<char>(c)) + "000\"";
-
- if (valid(c))
- {
- CAPTURE(s1)
- CHECK(json::parser(nlohmann::detail::input_adapter(s1)).accept());
- CAPTURE(s2)
- CHECK(json::parser(nlohmann::detail::input_adapter(s2)).accept());
- CAPTURE(s3)
- CHECK(json::parser(nlohmann::detail::input_adapter(s3)).accept());
- CAPTURE(s4)
- CHECK(json::parser(nlohmann::detail::input_adapter(s4)).accept());
- }
- else
- {
- CAPTURE(s1)
- CHECK(json::parser(nlohmann::detail::input_adapter(s1)).accept() == false);
-
- CAPTURE(s2)
- CHECK(json::parser(nlohmann::detail::input_adapter(s2)).accept() == false);
-
- CAPTURE(s3)
- CHECK(json::parser(nlohmann::detail::input_adapter(s3)).accept() == false);
-
- CAPTURE(s4)
- CHECK(json::parser(nlohmann::detail::input_adapter(s4)).accept() == false);
- }
- }
- }
-
- // missing part of a surrogate pair
- CHECK(accept_helper("\"\\uD80C\"") == false);
- // invalid surrogate pair
- CHECK(accept_helper("\"\\uD80C\\uD80C\"") == false);
- CHECK(accept_helper("\"\\uD80C\\u0000\"") == false);
- CHECK(accept_helper("\"\\uD80C\\uFFFF\"") == false);
- }
-
- SECTION("tests found by mutate++")
- {
- // test case to make sure no comma precedes the first key
- CHECK_THROWS_AS(parser_helper("{,\"key\": false}"), json::parse_error&);
- CHECK_THROWS_WITH(parser_helper("{,\"key\": false}"),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing object key - unexpected ','; expected string literal");
- // test case to make sure an object is properly closed
- CHECK_THROWS_AS(parser_helper("[{\"key\": false true]"), json::parse_error&);
- CHECK_THROWS_WITH(parser_helper("[{\"key\": false true]"),
- "[json.exception.parse_error.101] parse error at line 1, column 19: syntax error while parsing object - unexpected true literal; expected '}'");
-
- // test case to make sure the callback is properly evaluated after reading a key
- {
- json::parser_callback_t cb = [](int /*unused*/, json::parse_event_t event, json& /*unused*/)
- {
- return event != json::parse_event_t::key;
- };
-
- json x = json::parse("{\"key\": false}", cb);
- CHECK(x == json::object());
- }
- }
-
- SECTION("callback function")
- {
- const auto* s_object = R"(
- {
- "foo": 2,
- "bar": {
- "baz": 1
- }
- }
- )";
-
- const auto* s_array = R"(
- [1,2,[3,4,5],4,5]
- )";
-
- const auto* structured_array = R"(
- [
- 1,
- {
- "foo": "bar"
- },
- {
- "qux": "baz"
- }
- ]
- )";
-
- SECTION("filter nothing")
- {
- json j_object = json::parse(s_object, [](int /*unused*/, json::parse_event_t /*unused*/, const json& /*unused*/)
- {
- return true;
- });
-
- CHECK (j_object == json({{"foo", 2}, {"bar", {{"baz", 1}}}}));
-
- json j_array = json::parse(s_array, [](int /*unused*/, json::parse_event_t /*unused*/, const json& /*unused*/)
- {
- return true;
- });
-
- CHECK (j_array == json({1, 2, {3, 4, 5}, 4, 5}));
- }
-
- SECTION("filter everything")
- {
- json j_object = json::parse(s_object, [](int /*unused*/, json::parse_event_t /*unused*/, const json& /*unused*/)
- {
- return false;
- });
-
- // the top-level object will be discarded, leaving a null
- CHECK (j_object.is_null());
-
- json j_array = json::parse(s_array, [](int /*unused*/, json::parse_event_t /*unused*/, const json& /*unused*/)
- {
- return false;
- });
-
- // the top-level array will be discarded, leaving a null
- CHECK (j_array.is_null());
- }
-
- SECTION("filter specific element")
- {
- json j_object = json::parse(s_object, [](int /*unused*/, json::parse_event_t /*unused*/, const json & j)
- {
- // 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)
- {
- return j != json(2);
- });
-
- CHECK (j_array == json({1, {3, 4, 5}, 4, 5}));
- }
-
- SECTION("filter object in array")
- {
- json j_filtered1 = json::parse(structured_array, [](int /*unused*/, json::parse_event_t e, const json & parsed)
- {
- return !(e == json::parse_event_t::object_end && parsed.contains("foo"));
- });
-
- // the specified object will be discarded, and removed.
- CHECK (j_filtered1.size() == 2);
- CHECK (j_filtered1 == json({1, {{"qux", "baz"}}}));
-
- json j_filtered2 = json::parse(structured_array, [](int /*unused*/, json::parse_event_t e, const json& /*parsed*/)
- {
- return e != json::parse_event_t::object_end;
- });
-
- // removed all objects in array.
- CHECK (j_filtered2.size() == 1);
- CHECK (j_filtered2 == json({1}));
- }
-
- SECTION("filter specific events")
- {
- SECTION("first closing event")
- {
- {
- json j_object = json::parse(s_object, [](int /*unused*/, json::parse_event_t e, const json& /*unused*/)
- {
- static bool first = true;
- if (e == json::parse_event_t::object_end && first)
- {
- first = false;
- return false;
- }
-
- return true;
- });
-
- // the first completed object will be discarded
- CHECK (j_object == json({{"foo", 2}}));
- }
-
- {
- json j_array = json::parse(s_array, [](int /*unused*/, json::parse_event_t e, const json& /*unused*/)
- {
- static bool first = true;
- if (e == json::parse_event_t::array_end && first)
- {
- first = false;
- return false;
- }
-
- return true;
- });
-
- // the first completed array will be discarded
- CHECK (j_array == json({1, 2, 4, 5}));
- }
- }
- }
-
- SECTION("special cases")
- {
- // the following test cases cover the situation in which an empty
- // object and array is discarded only after the closing character
- // has been read
-
- json j_empty_object = json::parse("{}", [](int /*unused*/, json::parse_event_t e, const json& /*unused*/)
- {
- return e != json::parse_event_t::object_end;
- });
- CHECK(j_empty_object == json());
-
- json j_empty_array = json::parse("[]", [](int /*unused*/, json::parse_event_t e, const json& /*unused*/)
- {
- return e != json::parse_event_t::array_end;
- });
- CHECK(j_empty_array == json());
- }
- }
-
- SECTION("constructing from contiguous containers")
- {
- SECTION("from std::vector")
- {
- std::vector<uint8_t> v = {'t', 'r', 'u', 'e'};
- json j;
- json::parser(nlohmann::detail::input_adapter(std::begin(v), std::end(v))).parse(true, j);
- CHECK(j == json(true));
- }
-
- SECTION("from std::array")
- {
- std::array<uint8_t, 5> v { {'t', 'r', 'u', 'e'} };
- json j;
- json::parser(nlohmann::detail::input_adapter(std::begin(v), std::end(v))).parse(true, j);
- CHECK(j == json(true));
- }
-
- SECTION("from array")
- {
- uint8_t v[] = {'t', 'r', 'u', 'e'}; // NOLINT(cppcoreguidelines-avoid-c-arrays,hicpp-avoid-c-arrays,modernize-avoid-c-arrays)
- json j;
- json::parser(nlohmann::detail::input_adapter(std::begin(v), std::end(v))).parse(true, j);
- CHECK(j == json(true));
- }
-
- SECTION("from char literal")
- {
- CHECK(parser_helper("true") == json(true));
- }
-
- SECTION("from std::string")
- {
- std::string v = {'t', 'r', 'u', 'e'};
- json j;
- json::parser(nlohmann::detail::input_adapter(std::begin(v), std::end(v))).parse(true, j);
- CHECK(j == json(true));
- }
-
- SECTION("from std::initializer_list")
- {
- std::initializer_list<uint8_t> v = {'t', 'r', 'u', 'e'};
- json j;
- json::parser(nlohmann::detail::input_adapter(std::begin(v), std::end(v))).parse(true, j);
- CHECK(j == json(true));
- }
-
- SECTION("from std::valarray")
- {
- std::valarray<uint8_t> v = {'t', 'r', 'u', 'e'};
- json j;
- json::parser(nlohmann::detail::input_adapter(std::begin(v), std::end(v))).parse(true, j);
- CHECK(j == json(true));
- }
- }
-
- SECTION("improve test coverage")
- {
- SECTION("parser with callback")
- {
- json::parser_callback_t cb = [](int /*unused*/, json::parse_event_t /*unused*/, json& /*unused*/)
- {
- return true;
- };
-
- CHECK(json::parse("{\"foo\": true:", cb, false).is_discarded());
-
- json _;
- CHECK_THROWS_AS(_ = json::parse("{\"foo\": true:", cb), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse("{\"foo\": true:", cb),
- "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing object - unexpected ':'; expected '}'");
-
- CHECK_THROWS_AS(_ = json::parse("1.18973e+4932", cb), json::out_of_range&);
- CHECK_THROWS_WITH(_ = json::parse("1.18973e+4932", cb),
- "[json.exception.out_of_range.406] number overflow parsing '1.18973e+4932'");
- }
-
- SECTION("SAX parser")
- {
- SECTION("} without value")
- {
- SaxCountdown s(1);
- CHECK(json::sax_parse("{}", &s) == false);
- }
-
- SECTION("} with value")
- {
- SaxCountdown s(3);
- CHECK(json::sax_parse("{\"k1\": true}", &s) == false);
- }
-
- SECTION("second key")
- {
- SaxCountdown s(3);
- CHECK(json::sax_parse("{\"k1\": true, \"k2\": false}", &s) == false);
- }
-
- SECTION("] without value")
- {
- SaxCountdown s(1);
- CHECK(json::sax_parse("[]", &s) == false);
- }
-
- SECTION("] with value")
- {
- SaxCountdown s(2);
- CHECK(json::sax_parse("[1]", &s) == false);
- }
-
- SECTION("float")
- {
- SaxCountdown s(0);
- CHECK(json::sax_parse("3.14", &s) == false);
- }
-
- SECTION("false")
- {
- SaxCountdown s(0);
- CHECK(json::sax_parse("false", &s) == false);
- }
-
- SECTION("null")
- {
- SaxCountdown s(0);
- CHECK(json::sax_parse("null", &s) == false);
- }
-
- SECTION("true")
- {
- SaxCountdown s(0);
- CHECK(json::sax_parse("true", &s) == false);
- }
-
- SECTION("unsigned")
- {
- SaxCountdown s(0);
- CHECK(json::sax_parse("12", &s) == false);
- }
-
- SECTION("integer")
- {
- SaxCountdown s(0);
- CHECK(json::sax_parse("-12", &s) == false);
- }
-
- SECTION("string")
- {
- SaxCountdown s(0);
- CHECK(json::sax_parse("\"foo\"", &s) == false);
- }
- }
- }
-
- SECTION("error messages for comments")
- {
- json _;
- CHECK_THROWS_WITH_AS(_ = json::parse("/a", nullptr, true, true), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid comment; expecting '/' or '*' after '/'; last read: '/a'", json::parse_error);
- CHECK_THROWS_WITH_AS(_ = json::parse("/*", nullptr, true, true), "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid comment; missing closing '*/'; last read: '/*<U+0000>'", json::parse_error);
- }
-}
diff --git a/test/src/unit-comparison.cpp b/test/src/unit-comparison.cpp
deleted file mode 100644
index 4feccef..0000000
--- a/test/src/unit-comparison.cpp
+++ /dev/null
@@ -1,270 +0,0 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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;
-
-namespace
-{
-// helper function to check std::less<json::value_t>
-// see https://en.cppreference.com/w/cpp/utility/functional/less
-template <typename A, typename B, typename U = std::less<json::value_t>>
-bool f(A a, B b, U u = U())
-{
- return u(a, b);
-}
-} // namespace
-
-TEST_CASE("lexicographical comparison operators")
-{
- SECTION("types")
- {
- std::vector<json::value_t> j_types =
- {
- json::value_t::null,
- json::value_t::boolean,
- json::value_t::number_integer,
- json::value_t::number_unsigned,
- json::value_t::number_float,
- json::value_t::object,
- json::value_t::array,
- json::value_t::string,
- json::value_t::binary
- };
-
- 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}
- };
-
- for (size_t i = 0; i < j_types.size(); ++i)
- {
- 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]);
- }
- }
- }
- }
-
- 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})
- };
-
- SECTION("comparison: equal")
- {
- 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}
- };
-
- for (size_t i = 0; i < j_values.size(); ++i)
- {
- 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] );
- }
- }
-
- // comparison with discarded elements
- json j_discarded(json::value_t::discarded);
- for (const auto& v : j_values)
- {
- CHECK( (v == j_discarded) == false);
- CHECK( (j_discarded == v) == false);
- CHECK( (j_discarded == j_discarded) == false);
- }
-
- // compare with null pointer
- json j_null;
- CHECK(j_null == nullptr);
- CHECK(nullptr == j_null);
- }
-
- SECTION("comparison: not equal")
- {
- 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]) );
- }
- }
-
- // 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));
- }
-
- 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}
- };
-
- for (size_t i = 0; i < j_values.size(); ++i)
- {
- 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] );
- }
- }
-
- // 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")
- {
- 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]) );
- }
- }
- }
-
- SECTION("comparison: greater than")
- {
- 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]) );
- }
- }
- }
-
- SECTION("comparison: greater than or equal")
- {
- 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]) );
- }
- }
- }
- }
-}
diff --git a/test/src/unit-convenience.cpp b/test/src/unit-convenience.cpp
deleted file mode 100644
index e66b42c..0000000
--- a/test/src/unit-convenience.cpp
+++ /dev/null
@@ -1,117 +0,0 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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"
-
-#define JSON_TESTS_PRIVATE
-#include <nlohmann/json.hpp>
-using nlohmann::json;
-
-#include <sstream>
-
-namespace
-{
-void check_escaped(const char* original, const char* escaped = "", bool ensure_ascii = false);
-void check_escaped(const char* original, const char* escaped, const bool ensure_ascii)
-{
- std::stringstream ss;
- json::serializer s(nlohmann::detail::output_adapter<char>(ss), ' ');
- s.dump_escaped(original, ensure_ascii);
- CHECK(ss.str() == escaped);
-}
-} // namespace
-
-TEST_CASE("convenience functions")
-{
- SECTION("type name as string")
- {
- CHECK(std::string(json(json::value_t::null).type_name()) == "null");
- CHECK(std::string(json(json::value_t::object).type_name()) == "object");
- CHECK(std::string(json(json::value_t::array).type_name()) == "array");
- CHECK(std::string(json(json::value_t::number_integer).type_name()) == "number");
- CHECK(std::string(json(json::value_t::number_unsigned).type_name()) == "number");
- CHECK(std::string(json(json::value_t::number_float).type_name()) == "number");
- CHECK(std::string(json(json::value_t::binary).type_name()) == "binary");
- CHECK(std::string(json(json::value_t::boolean).type_name()) == "boolean");
- CHECK(std::string(json(json::value_t::string).type_name()) == "string");
- CHECK(std::string(json(json::value_t::discarded).type_name()) == "discarded");
- }
-
- SECTION("string escape")
- {
- check_escaped("\"", "\\\"");
- check_escaped("\\", "\\\\");
- check_escaped("\b", "\\b");
- check_escaped("\f", "\\f");
- check_escaped("\n", "\\n");
- check_escaped("\r", "\\r");
- check_escaped("\t", "\\t");
-
- check_escaped("\x01", "\\u0001");
- check_escaped("\x02", "\\u0002");
- check_escaped("\x03", "\\u0003");
- check_escaped("\x04", "\\u0004");
- check_escaped("\x05", "\\u0005");
- check_escaped("\x06", "\\u0006");
- check_escaped("\x07", "\\u0007");
- check_escaped("\x08", "\\b");
- check_escaped("\x09", "\\t");
- check_escaped("\x0a", "\\n");
- check_escaped("\x0b", "\\u000b");
- check_escaped("\x0c", "\\f");
- check_escaped("\x0d", "\\r");
- check_escaped("\x0e", "\\u000e");
- check_escaped("\x0f", "\\u000f");
- check_escaped("\x10", "\\u0010");
- check_escaped("\x11", "\\u0011");
- check_escaped("\x12", "\\u0012");
- check_escaped("\x13", "\\u0013");
- check_escaped("\x14", "\\u0014");
- check_escaped("\x15", "\\u0015");
- check_escaped("\x16", "\\u0016");
- check_escaped("\x17", "\\u0017");
- check_escaped("\x18", "\\u0018");
- check_escaped("\x19", "\\u0019");
- check_escaped("\x1a", "\\u001a");
- check_escaped("\x1b", "\\u001b");
- check_escaped("\x1c", "\\u001c");
- check_escaped("\x1d", "\\u001d");
- check_escaped("\x1e", "\\u001e");
- check_escaped("\x1f", "\\u001f");
-
- // invalid UTF-8 characters
- CHECK_THROWS_AS(check_escaped("ä\xA9ü"), json::type_error&);
- CHECK_THROWS_WITH(check_escaped("ä\xA9ü"),
- "[json.exception.type_error.316] invalid UTF-8 byte at index 2: 0xA9");
-
- CHECK_THROWS_AS(check_escaped("\xC2"), json::type_error&);
- CHECK_THROWS_WITH(check_escaped("\xC2"),
- "[json.exception.type_error.316] incomplete UTF-8 string; last byte: 0xC2");
- }
-}
diff --git a/test/src/unit-disabled_exceptions.cpp b/test/src/unit-disabled_exceptions.cpp
deleted file mode 100644
index 44a2b6c..0000000
--- a/test/src/unit-disabled_exceptions.cpp
+++ /dev/null
@@ -1,72 +0,0 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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"
-
-// disable -Wnoexcept as exceptions are switched off for this test suite
-DOCTEST_GCC_SUPPRESS_WARNING_PUSH
-DOCTEST_GCC_SUPPRESS_WARNING("-Wnoexcept")
-
-#include <nlohmann/json.hpp>
-using json = nlohmann::json;
-
-/////////////////////////////////////////////////////////////////////
-// for #2824
-/////////////////////////////////////////////////////////////////////
-
-class sax_no_exception : public nlohmann::detail::json_sax_dom_parser<json>
-{
- public:
- explicit sax_no_exception(json& j) : nlohmann::detail::json_sax_dom_parser<json>(j, false) {}
-
- static bool parse_error(std::size_t /*position*/, const std::string& /*last_token*/, const json::exception& ex)
- {
- error_string = new std::string(ex.what()); // NOLINT(cppcoreguidelines-owning-memory)
- return false;
- }
-
- static std::string* error_string;
-};
-
-std::string* sax_no_exception::error_string = nullptr;
-
-TEST_CASE("Tests with disabled exceptions")
-{
- SECTION("issue #2824 - encoding of json::exception::what()")
- {
- json j;
- sax_no_exception sax(j);
-
- CHECK (!json::sax_parse("xyz", &sax));
- CHECK(*sax_no_exception::error_string == "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - invalid literal; last read: 'x'");
- delete sax_no_exception::error_string; // NOLINT(cppcoreguidelines-owning-memory)
- }
-}
-
-DOCTEST_GCC_SUPPRESS_WARNING_POP
diff --git a/test/src/unit-element_access1.cpp b/test/src/unit-element_access1.cpp
deleted file mode 100644
index f3e7942..0000000
--- a/test/src/unit-element_access1.cpp
+++ /dev/null
@@ -1,1006 +0,0 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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;
-
-TEST_CASE("element access 1")
-{
- SECTION("array")
- {
- json j = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- const json j_const = j;
-
- SECTION("access specified element with bounds checking")
- {
- SECTION("access within bounds")
- {
- CHECK(j.at(0) == json(1));
- CHECK(j.at(1) == json(1u));
- CHECK(j.at(2) == json(true));
- CHECK(j.at(3) == json(nullptr));
- CHECK(j.at(4) == json("string"));
- CHECK(j.at(5) == json(42.23));
- CHECK(j.at(6) == json::object());
- CHECK(j.at(7) == json({1, 2, 3}));
-
- CHECK(j_const.at(0) == json(1));
- CHECK(j_const.at(1) == json(1u));
- CHECK(j_const.at(2) == json(true));
- CHECK(j_const.at(3) == json(nullptr));
- CHECK(j_const.at(4) == json("string"));
- CHECK(j_const.at(5) == json(42.23));
- CHECK(j_const.at(6) == json::object());
- CHECK(j_const.at(7) == json({1, 2, 3}));
- }
-
- SECTION("access outside bounds")
- {
- CHECK_THROWS_AS(j.at(8), json::out_of_range&);
- CHECK_THROWS_AS(j_const.at(8), json::out_of_range&);
-
- CHECK_THROWS_WITH(j.at(8),
- "[json.exception.out_of_range.401] array index 8 is out of range");
- CHECK_THROWS_WITH(j_const.at(8),
- "[json.exception.out_of_range.401] array index 8 is out of range");
- }
-
- SECTION("access on non-array type")
- {
- SECTION("null")
- {
- json j_nonarray(json::value_t::null);
- const json j_nonarray_const(j_nonarray);
- CHECK_THROWS_AS(j_nonarray.at(0), json::type_error&);
- CHECK_THROWS_AS(j_nonarray_const.at(0), json::type_error&);
-
- CHECK_THROWS_WITH(j_nonarray.at(0), "[json.exception.type_error.304] cannot use at() with null");
- CHECK_THROWS_WITH(j_nonarray_const.at(0), "[json.exception.type_error.304] cannot use at() with null");
- }
-
- SECTION("boolean")
- {
- json j_nonarray(json::value_t::boolean);
- const json j_nonarray_const(j_nonarray);
- CHECK_THROWS_AS(j_nonarray.at(0), json::type_error&);
- CHECK_THROWS_AS(j_nonarray_const.at(0), json::type_error&);
-
- CHECK_THROWS_WITH(j_nonarray.at(0), "[json.exception.type_error.304] cannot use at() with boolean");
- CHECK_THROWS_WITH(j_nonarray_const.at(0), "[json.exception.type_error.304] cannot use at() with boolean");
- }
-
- SECTION("string")
- {
- json j_nonarray(json::value_t::string);
- const json j_nonarray_const(j_nonarray);
- CHECK_THROWS_AS(j_nonarray.at(0), json::type_error&);
- CHECK_THROWS_AS(j_nonarray_const.at(0), json::type_error&);
-
- CHECK_THROWS_WITH(j_nonarray.at(0), "[json.exception.type_error.304] cannot use at() with string");
- CHECK_THROWS_WITH(j_nonarray_const.at(0), "[json.exception.type_error.304] cannot use at() with string");
- }
-
- SECTION("object")
- {
- json j_nonarray(json::value_t::object);
- const json j_nonarray_const(j_nonarray);
- CHECK_THROWS_AS(j_nonarray.at(0), json::type_error&);
- CHECK_THROWS_AS(j_nonarray_const.at(0), json::type_error&);
-
- CHECK_THROWS_WITH(j_nonarray.at(0), "[json.exception.type_error.304] cannot use at() with object");
- CHECK_THROWS_WITH(j_nonarray_const.at(0), "[json.exception.type_error.304] cannot use at() with object");
- }
-
- SECTION("number (integer)")
- {
- json j_nonarray(json::value_t::number_integer);
- const json j_nonarray_const(j_nonarray);
- CHECK_THROWS_AS(j_nonarray.at(0), json::type_error&);
- CHECK_THROWS_AS(j_nonarray_const.at(0), json::type_error&);
-
- CHECK_THROWS_WITH(j_nonarray.at(0), "[json.exception.type_error.304] cannot use at() with number");
- CHECK_THROWS_WITH(j_nonarray_const.at(0), "[json.exception.type_error.304] cannot use at() with number");
- }
-
- SECTION("number (unsigned)")
- {
- json j_nonarray(json::value_t::number_unsigned);
- const json j_nonarray_const(j_nonarray);
- CHECK_THROWS_AS(j_nonarray.at(0), json::type_error&);
- CHECK_THROWS_AS(j_nonarray_const.at(0), json::type_error&);
-
- CHECK_THROWS_WITH(j_nonarray.at(0), "[json.exception.type_error.304] cannot use at() with number");
- CHECK_THROWS_WITH(j_nonarray_const.at(0), "[json.exception.type_error.304] cannot use at() with number");
- }
-
- SECTION("number (floating-point)")
- {
- json j_nonarray(json::value_t::number_float);
- const json j_nonarray_const(j_nonarray);
- CHECK_THROWS_AS(j_nonarray.at(0), json::type_error&);
- CHECK_THROWS_AS(j_nonarray_const.at(0), json::type_error&);
-
- CHECK_THROWS_WITH(j_nonarray.at(0), "[json.exception.type_error.304] cannot use at() with number");
- CHECK_THROWS_WITH(j_nonarray_const.at(0), "[json.exception.type_error.304] cannot use at() with number");
- }
- }
- }
-
- SECTION("front and back")
- {
- CHECK(j.front() == json(1));
- CHECK(j_const.front() == json(1));
- CHECK(j.back() == json({1, 2, 3}));
- CHECK(j_const.back() == json({1, 2, 3}));
- }
-
- SECTION("access specified element")
- {
- SECTION("access within bounds")
- {
- CHECK(j[0] == json(1));
- CHECK(j[1] == json(1u));
- CHECK(j[2] == json(true));
- CHECK(j[3] == json(nullptr));
- CHECK(j[4] == json("string"));
- CHECK(j[5] == json(42.23));
- CHECK(j[6] == json::object());
- CHECK(j[7] == json({1, 2, 3}));
-
- CHECK(j_const[0] == json(1));
- CHECK(j_const[1] == json(1u));
- CHECK(j_const[2] == json(true));
- CHECK(j_const[3] == json(nullptr));
- CHECK(j_const[4] == json("string"));
- CHECK(j_const[5] == json(42.23));
- CHECK(j_const[6] == json::object());
- CHECK(j_const[7] == json({1, 2, 3}));
- }
-
- SECTION("access on non-array type")
- {
- SECTION("null")
- {
- SECTION("standard tests")
- {
- json j_nonarray(json::value_t::null);
- const json j_nonarray_const(j_nonarray);
- CHECK_NOTHROW(j_nonarray[0]);
- CHECK_THROWS_AS(j_nonarray_const[0], json::type_error&);
- CHECK_THROWS_WITH(j_nonarray_const[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with null");
- }
-
- SECTION("implicit transformation to properly filled array")
- {
- json j_nonarray;
- j_nonarray[3] = 42;
- CHECK(j_nonarray == json({nullptr, nullptr, nullptr, 42}));
- }
- }
-
- SECTION("boolean")
- {
- json j_nonarray(json::value_t::boolean);
- const json j_nonarray_const(j_nonarray);
- CHECK_THROWS_AS(j_nonarray[0], json::type_error&);
- CHECK_THROWS_AS(j_nonarray_const[0], json::type_error&);
- CHECK_THROWS_WITH(j_nonarray[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with boolean");
- CHECK_THROWS_WITH(j_nonarray_const[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with boolean");
- }
-
- SECTION("string")
- {
- json j_nonarray(json::value_t::string);
- const json j_nonarray_const(j_nonarray);
- CHECK_THROWS_AS(j_nonarray[0], json::type_error&);
- CHECK_THROWS_AS(j_nonarray_const[0], json::type_error&);
- CHECK_THROWS_WITH(j_nonarray[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with string");
- CHECK_THROWS_WITH(j_nonarray_const[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with string");
- }
-
- SECTION("object")
- {
- json j_nonarray(json::value_t::object);
- const json j_nonarray_const(j_nonarray);
- CHECK_THROWS_AS(j_nonarray[0], json::type_error&);
- CHECK_THROWS_AS(j_nonarray_const[0], json::type_error&);
- CHECK_THROWS_WITH(j_nonarray[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with object");
- CHECK_THROWS_WITH(j_nonarray_const[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with object");
- }
-
- SECTION("number (integer)")
- {
- json j_nonarray(json::value_t::number_integer);
- const json j_nonarray_const(j_nonarray);
- CHECK_THROWS_AS(j_nonarray[0], json::type_error&);
- CHECK_THROWS_AS(j_nonarray_const[0], json::type_error&);
- CHECK_THROWS_WITH(j_nonarray[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with number");
- CHECK_THROWS_WITH(j_nonarray_const[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with number");
- }
-
- SECTION("number (unsigned)")
- {
- json j_nonarray(json::value_t::number_unsigned);
- const json j_nonarray_const(j_nonarray);
- CHECK_THROWS_AS(j_nonarray[0], json::type_error&);
- CHECK_THROWS_AS(j_nonarray_const[0], json::type_error&);
- CHECK_THROWS_WITH(j_nonarray[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with number");
- CHECK_THROWS_WITH(j_nonarray_const[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with number");
- }
-
- SECTION("number (floating-point)")
- {
- json j_nonarray(json::value_t::number_float);
- const json j_nonarray_const(j_nonarray);
- CHECK_THROWS_AS(j_nonarray[0], json::type_error&);
- CHECK_THROWS_AS(j_nonarray_const[0], json::type_error&);
- CHECK_THROWS_WITH(j_nonarray[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with number");
- CHECK_THROWS_WITH(j_nonarray_const[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with number");
- }
- }
- }
-
- SECTION("remove specified element")
- {
- SECTION("remove element by index")
- {
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- jarray.erase(0);
- CHECK(jarray == json({1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}}));
- }
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- jarray.erase(1);
- CHECK(jarray == json({1, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}}));
- }
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- jarray.erase(2);
- CHECK(jarray == json({1, 1u, nullptr, "string", 42.23, json::object(), {1, 2, 3}}));
- }
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- jarray.erase(3);
- CHECK(jarray == json({1, 1u, true, "string", 42.23, json::object(), {1, 2, 3}}));
- }
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- jarray.erase(4);
- CHECK(jarray == json({1, 1u, true, nullptr, 42.23, json::object(), {1, 2, 3}}));
- }
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- jarray.erase(5);
- CHECK(jarray == json({1, 1u, true, nullptr, "string", json::object(), {1, 2, 3}}));
- }
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- jarray.erase(6);
- CHECK(jarray == json({1, 1u, true, nullptr, "string", 42.23, {1, 2, 3}}));
- }
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- jarray.erase(7);
- CHECK(jarray == json({1, 1u, true, nullptr, "string", 42.23, json::object()}));
- }
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- CHECK_THROWS_AS(jarray.erase(8), json::out_of_range&);
- CHECK_THROWS_WITH(jarray.erase(8),
- "[json.exception.out_of_range.401] array index 8 is out of range");
- }
- }
-
- SECTION("remove element by iterator")
- {
- SECTION("erase(begin())")
- {
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- json::iterator it2 = jarray.erase(jarray.begin());
- CHECK(jarray == json({1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}}));
- CHECK(*it2 == json(1u));
- }
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- json::const_iterator it2 = jarray.erase(jarray.cbegin());
- CHECK(jarray == json({1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}}));
- CHECK(*it2 == json(1u));
- }
- }
-
- SECTION("erase(begin(), end())")
- {
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- json::iterator it2 = jarray.erase(jarray.begin(), jarray.end());
- CHECK(jarray == json::array());
- CHECK(it2 == jarray.end());
- }
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- json::const_iterator it2 = jarray.erase(jarray.cbegin(), jarray.cend());
- CHECK(jarray == json::array());
- CHECK(it2 == jarray.cend());
- }
- }
-
- SECTION("erase(begin(), begin())")
- {
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- json::iterator it2 = jarray.erase(jarray.begin(), jarray.begin());
- CHECK(jarray == json({1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}}));
- CHECK(*it2 == json(1));
- }
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- json::const_iterator it2 = jarray.erase(jarray.cbegin(), jarray.cbegin());
- CHECK(jarray == json({1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}}));
- CHECK(*it2 == json(1));
- }
- }
-
- SECTION("erase at offset")
- {
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- json::iterator it = jarray.begin() + 4;
- json::iterator it2 = jarray.erase(it);
- CHECK(jarray == json({1, 1u, true, nullptr, 42.23, json::object(), {1, 2, 3}}));
- CHECK(*it2 == json(42.23));
- }
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- json::const_iterator it = jarray.cbegin() + 4;
- json::const_iterator it2 = jarray.erase(it);
- CHECK(jarray == json({1, 1u, true, nullptr, 42.23, json::object(), {1, 2, 3}}));
- CHECK(*it2 == json(42.23));
- }
- }
-
- SECTION("erase subrange")
- {
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- json::iterator it2 = jarray.erase(jarray.begin() + 3, jarray.begin() + 6);
- CHECK(jarray == json({1, 1u, true, json::object(), {1, 2, 3}}));
- CHECK(*it2 == json::object());
- }
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- json::const_iterator it2 = jarray.erase(jarray.cbegin() + 3, jarray.cbegin() + 6);
- CHECK(jarray == json({1, 1u, true, json::object(), {1, 2, 3}}));
- CHECK(*it2 == json::object());
- }
- }
-
- SECTION("different arrays")
- {
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- json jarray2 = {"foo", "bar"};
- CHECK_THROWS_AS(jarray.erase(jarray2.begin()), json::invalid_iterator&);
- CHECK_THROWS_AS(jarray.erase(jarray.begin(), jarray2.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(jarray.erase(jarray2.begin(), jarray.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(jarray.erase(jarray2.begin(), jarray2.end()), json::invalid_iterator&);
-
- CHECK_THROWS_WITH(jarray.erase(jarray2.begin()),
- "[json.exception.invalid_iterator.202] iterator does not fit current value");
- CHECK_THROWS_WITH(jarray.erase(jarray.begin(), jarray2.end()),
- "[json.exception.invalid_iterator.203] iterators do not fit current value");
- CHECK_THROWS_WITH(jarray.erase(jarray2.begin(), jarray.end()),
- "[json.exception.invalid_iterator.203] iterators do not fit current value");
- CHECK_THROWS_WITH(jarray.erase(jarray2.begin(), jarray2.end()),
- "[json.exception.invalid_iterator.203] iterators do not fit current value");
- }
- {
- json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
- json jarray2 = {"foo", "bar"};
- CHECK_THROWS_AS(jarray.erase(jarray2.cbegin()), json::invalid_iterator&);
- CHECK_THROWS_AS(jarray.erase(jarray.cbegin(), jarray2.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(jarray.erase(jarray2.cbegin(), jarray.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(jarray.erase(jarray2.cbegin(), jarray2.cend()), json::invalid_iterator&);
-
- CHECK_THROWS_WITH(jarray.erase(jarray2.cbegin()),
- "[json.exception.invalid_iterator.202] iterator does not fit current value");
- CHECK_THROWS_WITH(jarray.erase(jarray.cbegin(), jarray2.cend()),
- "[json.exception.invalid_iterator.203] iterators do not fit current value");
- CHECK_THROWS_WITH(jarray.erase(jarray2.cbegin(), jarray.cend()),
- "[json.exception.invalid_iterator.203] iterators do not fit current value");
- CHECK_THROWS_WITH(jarray.erase(jarray2.cbegin(), jarray2.cend()),
- "[json.exception.invalid_iterator.203] iterators do not fit current value");
- }
- }
- }
-
- SECTION("remove element by index in non-array type")
- {
- SECTION("null")
- {
- json j_nonobject(json::value_t::null);
- CHECK_THROWS_AS(j_nonobject.erase(0), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.erase(0),
- "[json.exception.type_error.307] cannot use erase() with null");
- }
-
- SECTION("boolean")
- {
- json j_nonobject(json::value_t::boolean);
- CHECK_THROWS_AS(j_nonobject.erase(0), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.erase(0),
- "[json.exception.type_error.307] cannot use erase() with boolean");
- }
-
- SECTION("string")
- {
- json j_nonobject(json::value_t::string);
- CHECK_THROWS_AS(j_nonobject.erase(0), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.erase(0),
- "[json.exception.type_error.307] cannot use erase() with string");
- }
-
- SECTION("object")
- {
- json j_nonobject(json::value_t::object);
- CHECK_THROWS_AS(j_nonobject.erase(0), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.erase(0),
- "[json.exception.type_error.307] cannot use erase() with object");
- }
-
- SECTION("number (integer)")
- {
- json j_nonobject(json::value_t::number_integer);
- CHECK_THROWS_AS(j_nonobject.erase(0), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.erase(0),
- "[json.exception.type_error.307] cannot use erase() with number");
- }
-
- SECTION("number (unsigned)")
- {
- json j_nonobject(json::value_t::number_unsigned);
- CHECK_THROWS_AS(j_nonobject.erase(0), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.erase(0),
- "[json.exception.type_error.307] cannot use erase() with number");
- }
-
- SECTION("number (floating-point)")
- {
- json j_nonobject(json::value_t::number_float);
- CHECK_THROWS_AS(j_nonobject.erase(0), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.erase(0),
- "[json.exception.type_error.307] cannot use erase() with number");
- }
- }
- }
- }
-
- SECTION("other values")
- {
- SECTION("front and back")
- {
- SECTION("null")
- {
- {
- json j;
- CHECK_THROWS_AS(j.front(), json::invalid_iterator&);
- CHECK_THROWS_AS(j.back(), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.front(), "[json.exception.invalid_iterator.214] cannot get value");
- CHECK_THROWS_WITH(j.back(), "[json.exception.invalid_iterator.214] cannot get value");
- }
- {
- const json j{};
- CHECK_THROWS_AS(j.front(), json::invalid_iterator&);
- CHECK_THROWS_AS(j.back(), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.front(), "[json.exception.invalid_iterator.214] cannot get value");
- CHECK_THROWS_WITH(j.back(), "[json.exception.invalid_iterator.214] cannot get value");
- }
- }
-
- SECTION("string")
- {
- {
- json j = "foo";
- CHECK(j.front() == j);
- CHECK(j.back() == j);
- }
- {
- const json j = "bar";
- CHECK(j.front() == j);
- CHECK(j.back() == j);
- }
- }
-
- SECTION("number (boolean)")
- {
- {
- json j = false;
- CHECK(j.front() == j);
- CHECK(j.back() == j);
- }
- {
- const json j = true;
- CHECK(j.front() == j);
- CHECK(j.back() == j);
- }
- }
-
- SECTION("number (integer)")
- {
- {
- json j = 17;
- CHECK(j.front() == j);
- CHECK(j.back() == j);
- }
- {
- const json j = 17;
- CHECK(j.front() == j);
- CHECK(j.back() == j);
- }
- }
-
- SECTION("number (unsigned)")
- {
- {
- json j = 17u;
- CHECK(j.front() == j);
- CHECK(j.back() == j);
- }
- {
- const json j = 17u;
- CHECK(j.front() == j);
- CHECK(j.back() == j);
- }
- }
-
- SECTION("number (floating point)")
- {
- {
- json j = 23.42;
- CHECK(j.front() == j);
- CHECK(j.back() == j);
- }
- {
- const json j = 23.42;
- CHECK(j.front() == j);
- CHECK(j.back() == j);
- }
- }
- }
-
- SECTION("erase with one valid iterator")
- {
- SECTION("null")
- {
- {
- json j;
- CHECK_THROWS_AS(j.erase(j.begin()), json::type_error&);
- CHECK_THROWS_WITH(j.erase(j.begin()),
- "[json.exception.type_error.307] cannot use erase() with null");
- }
- {
- json j;
- CHECK_THROWS_AS(j.erase(j.cbegin()), json::type_error&);
- CHECK_THROWS_WITH(j.erase(j.begin()),
- "[json.exception.type_error.307] cannot use erase() with null");
- }
- }
-
- SECTION("string")
- {
- {
- json j = "foo";
- json::iterator it = j.erase(j.begin());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- {
- json j = "bar";
- json::const_iterator it = j.erase(j.cbegin());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- }
-
- SECTION("number (boolean)")
- {
- {
- json j = false;
- json::iterator it = j.erase(j.begin());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- {
- json j = true;
- json::const_iterator it = j.erase(j.cbegin());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- }
-
- SECTION("number (integer)")
- {
- {
- json j = 17;
- json::iterator it = j.erase(j.begin());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- {
- json j = 17;
- json::const_iterator it = j.erase(j.cbegin());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- }
-
- SECTION("number (unsigned)")
- {
- {
- json j = 17u;
- json::iterator it = j.erase(j.begin());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- {
- json j = 17u;
- json::const_iterator it = j.erase(j.cbegin());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- }
-
- SECTION("number (floating point)")
- {
- {
- json j = 23.42;
- json::iterator it = j.erase(j.begin());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- {
- json j = 23.42;
- json::const_iterator it = j.erase(j.cbegin());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- }
-
- SECTION("binary")
- {
- {
- json j = json::binary({1, 2, 3});
- json::iterator it = j.erase(j.begin());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- {
- json j = json::binary({1, 2, 3});
- json::const_iterator it = j.erase(j.cbegin());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- }
- }
-
- SECTION("erase with one invalid iterator")
- {
- SECTION("string")
- {
- {
- json j = "foo";
- CHECK_THROWS_AS(j.erase(j.end()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.end()),
- "[json.exception.invalid_iterator.205] iterator out of range");
- }
- {
- json j = "bar";
- CHECK_THROWS_AS(j.erase(j.cend()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.cend()),
- "[json.exception.invalid_iterator.205] iterator out of range");
- }
- }
-
- SECTION("number (boolean)")
- {
- {
- json j = false;
- CHECK_THROWS_AS(j.erase(j.end()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.end()),
- "[json.exception.invalid_iterator.205] iterator out of range");
- }
- {
- json j = true;
- CHECK_THROWS_AS(j.erase(j.cend()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.cend()),
- "[json.exception.invalid_iterator.205] iterator out of range");
- }
- }
-
- SECTION("number (integer)")
- {
- {
- json j = 17;
- CHECK_THROWS_AS(j.erase(j.end()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.end()),
- "[json.exception.invalid_iterator.205] iterator out of range");
- }
- {
- json j = 17;
- CHECK_THROWS_AS(j.erase(j.cend()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.cend()),
- "[json.exception.invalid_iterator.205] iterator out of range");
- }
- }
-
- SECTION("number (unsigned)")
- {
- {
- json j = 17u;
- CHECK_THROWS_AS(j.erase(j.end()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.end()),
- "[json.exception.invalid_iterator.205] iterator out of range");
- }
- {
- json j = 17u;
- CHECK_THROWS_AS(j.erase(j.cend()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.cend()),
- "[json.exception.invalid_iterator.205] iterator out of range");
- }
- }
-
- SECTION("number (floating point)")
- {
- {
- json j = 23.42;
- CHECK_THROWS_AS(j.erase(j.end()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.end()),
- "[json.exception.invalid_iterator.205] iterator out of range");
- }
- {
- json j = 23.42;
- CHECK_THROWS_AS(j.erase(j.cend()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.cend()),
- "[json.exception.invalid_iterator.205] iterator out of range");
- }
- }
- }
-
- SECTION("erase with two valid iterators")
- {
- SECTION("null")
- {
- {
- json j;
- CHECK_THROWS_AS(j.erase(j.begin(), j.end()), json::type_error&);
- CHECK_THROWS_WITH(j.erase(j.begin(), j.end()),
- "[json.exception.type_error.307] cannot use erase() with null");
- }
- {
- json j;
- CHECK_THROWS_AS(j.erase(j.cbegin(), j.cend()), json::type_error&);
- CHECK_THROWS_WITH(j.erase(j.cbegin(), j.cend()),
- "[json.exception.type_error.307] cannot use erase() with null");
- }
- }
-
- SECTION("string")
- {
- {
- json j = "foo";
- json::iterator it = j.erase(j.begin(), j.end());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- {
- json j = "bar";
- json::const_iterator it = j.erase(j.cbegin(), j.cend());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- }
-
- SECTION("number (boolean)")
- {
- {
- json j = false;
- json::iterator it = j.erase(j.begin(), j.end());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- {
- json j = true;
- json::const_iterator it = j.erase(j.cbegin(), j.cend());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- }
-
- SECTION("number (integer)")
- {
- {
- json j = 17;
- json::iterator it = j.erase(j.begin(), j.end());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- {
- json j = 17;
- json::const_iterator it = j.erase(j.cbegin(), j.cend());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- }
-
- SECTION("number (unsigned)")
- {
- {
- json j = 17u;
- json::iterator it = j.erase(j.begin(), j.end());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- {
- json j = 17u;
- json::const_iterator it = j.erase(j.cbegin(), j.cend());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- }
-
- SECTION("number (floating point)")
- {
- {
- json j = 23.42;
- json::iterator it = j.erase(j.begin(), j.end());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- {
- json j = 23.42;
- json::const_iterator it = j.erase(j.cbegin(), j.cend());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- }
-
- SECTION("binary")
- {
- {
- json j = json::binary({1, 2, 3});
- json::iterator it = j.erase(j.begin(), j.end());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- {
- json j = json::binary({1, 2, 3});
- json::const_iterator it = j.erase(j.cbegin(), j.cend());
- CHECK(j.type() == json::value_t::null);
- CHECK(it == j.end());
- }
- }
- }
-
- SECTION("erase with two invalid iterators")
- {
- SECTION("string")
- {
- {
- json j = "foo";
- CHECK_THROWS_AS(j.erase(j.end(), j.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(j.erase(j.begin(), j.begin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(j.erase(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range");
- }
- {
- json j = "bar";
- CHECK_THROWS_AS(j.erase(j.cend(), j.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(j.erase(j.cbegin(), j.cbegin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(j.erase(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range");
- }
- }
-
- SECTION("number (boolean)")
- {
- {
- json j = false;
- CHECK_THROWS_AS(j.erase(j.end(), j.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(j.erase(j.begin(), j.begin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(j.erase(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range");
- }
- {
- json j = true;
- CHECK_THROWS_AS(j.erase(j.cend(), j.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(j.erase(j.cbegin(), j.cbegin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(j.erase(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range");
- }
- }
-
- SECTION("number (integer)")
- {
- {
- json j = 17;
- CHECK_THROWS_AS(j.erase(j.end(), j.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(j.erase(j.begin(), j.begin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(j.erase(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range");
- }
- {
- json j = 17;
- CHECK_THROWS_AS(j.erase(j.cend(), j.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(j.erase(j.cbegin(), j.cbegin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(j.erase(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range");
- }
- }
-
- SECTION("number (unsigned)")
- {
- {
- json j = 17u;
- CHECK_THROWS_AS(j.erase(j.end(), j.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(j.erase(j.begin(), j.begin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(j.erase(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range");
- }
- {
- json j = 17u;
- CHECK_THROWS_AS(j.erase(j.cend(), j.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(j.erase(j.cbegin(), j.cbegin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(j.erase(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range");
- }
- }
-
- SECTION("number (floating point)")
- {
- {
- json j = 23.42;
- CHECK_THROWS_AS(j.erase(j.end(), j.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(j.erase(j.begin(), j.begin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(j.erase(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range");
- }
- {
- json j = 23.42;
- CHECK_THROWS_AS(j.erase(j.cend(), j.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(j.erase(j.cbegin(), j.cbegin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(j.erase(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(j.erase(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range");
- }
- }
- }
- }
-}
diff --git a/test/src/unit-element_access2.cpp b/test/src/unit-element_access2.cpp
deleted file mode 100644
index 670458c..0000000
--- a/test/src/unit-element_access2.cpp
+++ /dev/null
@@ -1,1109 +0,0 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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;
-
-TEST_CASE("element access 2")
-{
- SECTION("object")
- {
- json j = {{"integer", 1}, {"unsigned", 1u}, {"floating", 42.23}, {"null", nullptr}, {"string", "hello world"}, {"boolean", true}, {"object", json::object()}, {"array", {1, 2, 3}}};
- const json j_const = j;
-
- SECTION("access specified element with bounds checking")
- {
- SECTION("access within bounds")
- {
- CHECK(j.at("integer") == json(1));
- CHECK(j.at("unsigned") == json(1u));
- CHECK(j.at("boolean") == json(true));
- CHECK(j.at("null") == json(nullptr));
- CHECK(j.at("string") == json("hello world"));
- CHECK(j.at("floating") == json(42.23));
- CHECK(j.at("object") == json::object());
- CHECK(j.at("array") == json({1, 2, 3}));
-
- CHECK(j_const.at("integer") == json(1));
- CHECK(j_const.at("unsigned") == json(1u));
- CHECK(j_const.at("boolean") == json(true));
- CHECK(j_const.at("null") == json(nullptr));
- CHECK(j_const.at("string") == json("hello world"));
- CHECK(j_const.at("floating") == json(42.23));
- CHECK(j_const.at("object") == json::object());
- CHECK(j_const.at("array") == json({1, 2, 3}));
- }
-
- SECTION("access outside bounds")
- {
- CHECK_THROWS_AS(j.at("foo"), json::out_of_range&);
- CHECK_THROWS_AS(j_const.at("foo"), json::out_of_range&);
- CHECK_THROWS_WITH(j.at("foo"),
- "[json.exception.out_of_range.403] key 'foo' not found");
- CHECK_THROWS_WITH(j_const.at("foo"),
- "[json.exception.out_of_range.403] key 'foo' not found");
- }
-
- SECTION("access on non-object type")
- {
- SECTION("null")
- {
- json j_nonobject(json::value_t::null);
- const json j_nonobject_const(j_nonobject);
- CHECK_THROWS_AS(j_nonobject.at("foo"), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.at("foo"), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.at("foo"), "[json.exception.type_error.304] cannot use at() with null");
- CHECK_THROWS_WITH(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with null");
- }
-
- SECTION("boolean")
- {
- json j_nonobject(json::value_t::boolean);
- const json j_nonobject_const(j_nonobject);
- CHECK_THROWS_AS(j_nonobject.at("foo"), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.at("foo"), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.at("foo"), "[json.exception.type_error.304] cannot use at() with boolean");
- CHECK_THROWS_WITH(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with boolean");
- }
-
- SECTION("string")
- {
- json j_nonobject(json::value_t::string);
- const json j_nonobject_const(j_nonobject);
- CHECK_THROWS_AS(j_nonobject.at("foo"), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.at("foo"), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.at("foo"), "[json.exception.type_error.304] cannot use at() with string");
- CHECK_THROWS_WITH(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with string");
- }
-
- SECTION("array")
- {
- json j_nonobject(json::value_t::array);
- const json j_nonobject_const(j_nonobject);
- CHECK_THROWS_AS(j_nonobject.at("foo"), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.at("foo"), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.at("foo"), "[json.exception.type_error.304] cannot use at() with array");
- CHECK_THROWS_WITH(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with array");
- }
-
- SECTION("number (integer)")
- {
- json j_nonobject(json::value_t::number_integer);
- const json j_nonobject_const(j_nonobject);
- CHECK_THROWS_AS(j_nonobject.at("foo"), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.at("foo"), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.at("foo"), "[json.exception.type_error.304] cannot use at() with number");
- CHECK_THROWS_WITH(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with number");
- }
-
- SECTION("number (unsigned)")
- {
- json j_nonobject(json::value_t::number_unsigned);
- const json j_nonobject_const(j_nonobject);
- CHECK_THROWS_AS(j_nonobject.at("foo"), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.at("foo"), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.at("foo"), "[json.exception.type_error.304] cannot use at() with number");
- CHECK_THROWS_WITH(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with number");
- }
-
- SECTION("number (floating-point)")
- {
- json j_nonobject(json::value_t::number_float);
- const json j_nonobject_const(j_nonobject);
- CHECK_THROWS_AS(j_nonobject.at("foo"), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.at("foo"), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.at("foo"), "[json.exception.type_error.304] cannot use at() with number");
- CHECK_THROWS_WITH(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with number");
- }
- }
- }
-
- SECTION("access specified element with default value")
- {
- SECTION("given a key")
- {
- SECTION("access existing value")
- {
- CHECK(j.value("integer", 2) == 1);
- CHECK(j.value("integer", 1.0) == Approx(1));
- CHECK(j.value("unsigned", 2) == 1u);
- CHECK(j.value("unsigned", 1.0) == Approx(1u));
- CHECK(j.value("null", json(1)) == json());
- CHECK(j.value("boolean", false) == true);
- CHECK(j.value("string", "bar") == "hello world");
- CHECK(j.value("string", std::string("bar")) == "hello world");
- CHECK(j.value("floating", 12.34) == Approx(42.23));
- CHECK(j.value("floating", 12) == 42);
- CHECK(j.value("object", json({{"foo", "bar"}})) == json::object());
- CHECK(j.value("array", json({10, 100})) == json({1, 2, 3}));
-
- CHECK(j_const.value("integer", 2) == 1);
- CHECK(j_const.value("integer", 1.0) == Approx(1));
- CHECK(j_const.value("unsigned", 2) == 1u);
- CHECK(j_const.value("unsigned", 1.0) == Approx(1u));
- CHECK(j_const.value("boolean", false) == true);
- CHECK(j_const.value("string", "bar") == "hello world");
- CHECK(j_const.value("string", std::string("bar")) == "hello world");
- CHECK(j_const.value("floating", 12.34) == Approx(42.23));
- 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}));
- }
-
- SECTION("access non-existing value")
- {
- CHECK(j.value("_", 2) == 2);
- CHECK(j.value("_", 2u) == 2u);
- CHECK(j.value("_", false) == false);
- CHECK(j.value("_", "bar") == "bar");
- CHECK(j.value("_", 12.34) == Approx(12.34));
- CHECK(j.value("_", json({{"foo", "bar"}})) == json({{"foo", "bar"}}));
- CHECK(j.value("_", json({10, 100})) == json({10, 100}));
-
- CHECK(j_const.value("_", 2) == 2);
- CHECK(j_const.value("_", 2u) == 2u);
- CHECK(j_const.value("_", false) == false);
- CHECK(j_const.value("_", "bar") == "bar");
- 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}));
- }
-
- SECTION("access on non-object type")
- {
- SECTION("null")
- {
- json j_nonobject(json::value_t::null);
- const json j_nonobject_const(json::value_t::null);
- CHECK_THROWS_AS(j_nonobject.value("foo", 1), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.value("foo", 1), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.value("foo", 1),
- "[json.exception.type_error.306] cannot use value() with null");
- CHECK_THROWS_WITH(j_nonobject_const.value("foo", 1),
- "[json.exception.type_error.306] cannot use value() with null");
- }
-
- SECTION("boolean")
- {
- json j_nonobject(json::value_t::boolean);
- const json j_nonobject_const(json::value_t::boolean);
- CHECK_THROWS_AS(j_nonobject.value("foo", 1), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.value("foo", 1), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.value("foo", 1),
- "[json.exception.type_error.306] cannot use value() with boolean");
- CHECK_THROWS_WITH(j_nonobject_const.value("foo", 1),
- "[json.exception.type_error.306] cannot use value() with boolean");
- }
-
- SECTION("string")
- {
- json j_nonobject(json::value_t::string);
- const json j_nonobject_const(json::value_t::string);
- CHECK_THROWS_AS(j_nonobject.value("foo", 1), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.value("foo", 1), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.value("foo", 1),
- "[json.exception.type_error.306] cannot use value() with string");
- CHECK_THROWS_WITH(j_nonobject_const.value("foo", 1),
- "[json.exception.type_error.306] cannot use value() with string");
- }
-
- SECTION("array")
- {
- json j_nonobject(json::value_t::array);
- const json j_nonobject_const(json::value_t::array);
- CHECK_THROWS_AS(j_nonobject.value("foo", 1), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.value("foo", 1), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.value("foo", 1),
- "[json.exception.type_error.306] cannot use value() with array");
- CHECK_THROWS_WITH(j_nonobject_const.value("foo", 1),
- "[json.exception.type_error.306] cannot use value() with array");
- }
-
- SECTION("number (integer)")
- {
- json j_nonobject(json::value_t::number_integer);
- const json j_nonobject_const(json::value_t::number_integer);
- CHECK_THROWS_AS(j_nonobject.value("foo", 1), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.value("foo", 1), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.value("foo", 1),
- "[json.exception.type_error.306] cannot use value() with number");
- CHECK_THROWS_WITH(j_nonobject_const.value("foo", 1),
- "[json.exception.type_error.306] cannot use value() with number");
- }
-
- SECTION("number (unsigned)")
- {
- json j_nonobject(json::value_t::number_unsigned);
- const json j_nonobject_const(json::value_t::number_unsigned);
- CHECK_THROWS_AS(j_nonobject.value("foo", 1), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.value("foo", 1), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.value("foo", 1),
- "[json.exception.type_error.306] cannot use value() with number");
- CHECK_THROWS_WITH(j_nonobject_const.value("foo", 1),
- "[json.exception.type_error.306] cannot use value() with number");
- }
-
- SECTION("number (floating-point)")
- {
- json j_nonobject(json::value_t::number_float);
- const json j_nonobject_const(json::value_t::number_float);
- CHECK_THROWS_AS(j_nonobject.value("foo", 1), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.value("foo", 1), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.value("foo", 1),
- "[json.exception.type_error.306] cannot use value() with number");
- CHECK_THROWS_WITH(j_nonobject_const.value("foo", 1),
- "[json.exception.type_error.306] cannot use value() with number");
- }
- }
- }
-
- SECTION("given a JSON pointer")
- {
- SECTION("access existing value")
- {
- CHECK(j.value("/integer"_json_pointer, 2) == 1);
- CHECK(j.value("/integer"_json_pointer, 1.0) == Approx(1));
- CHECK(j.value("/unsigned"_json_pointer, 2) == 1u);
- CHECK(j.value("/unsigned"_json_pointer, 1.0) == Approx(1u));
- CHECK(j.value("/null"_json_pointer, json(1)) == json());
- CHECK(j.value("/boolean"_json_pointer, false) == true);
- CHECK(j.value("/string"_json_pointer, "bar") == "hello world");
- CHECK(j.value("/string"_json_pointer, std::string("bar")) == "hello world");
- CHECK(j.value("/floating"_json_pointer, 12.34) == Approx(42.23));
- CHECK(j.value("/floating"_json_pointer, 12) == 42);
- CHECK(j.value("/object"_json_pointer, json({{"foo", "bar"}})) == json::object());
- CHECK(j.value("/array"_json_pointer, json({10, 100})) == json({1, 2, 3}));
-
- CHECK(j_const.value("/integer"_json_pointer, 2) == 1);
- CHECK(j_const.value("/integer"_json_pointer, 1.0) == Approx(1));
- CHECK(j_const.value("/unsigned"_json_pointer, 2) == 1u);
- CHECK(j_const.value("/unsigned"_json_pointer, 1.0) == Approx(1u));
- CHECK(j_const.value("/boolean"_json_pointer, false) == true);
- CHECK(j_const.value("/string"_json_pointer, "bar") == "hello world");
- CHECK(j_const.value("/string"_json_pointer, std::string("bar")) == "hello world");
- CHECK(j_const.value("/floating"_json_pointer, 12.34) == Approx(42.23));
- CHECK(j_const.value("/floating"_json_pointer, 12) == 42);
- CHECK(j_const.value("/object"_json_pointer, json({{"foo", "bar"}})) == json::object());
- CHECK(j_const.value("/array"_json_pointer, json({10, 100})) == json({1, 2, 3}));
- }
-
- SECTION("access on non-object type")
- {
- SECTION("null")
- {
- json j_nonobject(json::value_t::null);
- const json j_nonobject_const(json::value_t::null);
- CHECK_THROWS_AS(j_nonobject.value("/foo"_json_pointer, 1), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.value("/foo"_json_pointer, 1), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.value("/foo"_json_pointer, 1),
- "[json.exception.type_error.306] cannot use value() with null");
- CHECK_THROWS_WITH(j_nonobject_const.value("/foo"_json_pointer, 1),
- "[json.exception.type_error.306] cannot use value() with null");
- }
-
- SECTION("boolean")
- {
- json j_nonobject(json::value_t::boolean);
- const json j_nonobject_const(json::value_t::boolean);
- CHECK_THROWS_AS(j_nonobject.value("/foo"_json_pointer, 1), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.value("/foo"_json_pointer, 1), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.value("/foo"_json_pointer, 1),
- "[json.exception.type_error.306] cannot use value() with boolean");
- CHECK_THROWS_WITH(j_nonobject_const.value("/foo"_json_pointer, 1),
- "[json.exception.type_error.306] cannot use value() with boolean");
- }
-
- SECTION("string")
- {
- json j_nonobject(json::value_t::string);
- const json j_nonobject_const(json::value_t::string);
- CHECK_THROWS_AS(j_nonobject.value("/foo"_json_pointer, 1), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.value("/foo"_json_pointer, 1), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.value("/foo"_json_pointer, 1),
- "[json.exception.type_error.306] cannot use value() with string");
- CHECK_THROWS_WITH(j_nonobject_const.value("/foo"_json_pointer, 1),
- "[json.exception.type_error.306] cannot use value() with string");
- }
-
- SECTION("array")
- {
- json j_nonobject(json::value_t::array);
- const json j_nonobject_const(json::value_t::array);
- CHECK_THROWS_AS(j_nonobject.value("/foo"_json_pointer, 1), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.value("/foo"_json_pointer, 1), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.value("/foo"_json_pointer, 1),
- "[json.exception.type_error.306] cannot use value() with array");
- CHECK_THROWS_WITH(j_nonobject_const.value("/foo"_json_pointer, 1),
- "[json.exception.type_error.306] cannot use value() with array");
- }
-
- SECTION("number (integer)")
- {
- json j_nonobject(json::value_t::number_integer);
- const json j_nonobject_const(json::value_t::number_integer);
- CHECK_THROWS_AS(j_nonobject.value("/foo"_json_pointer, 1), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.value("/foo"_json_pointer, 1), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.value("/foo"_json_pointer, 1),
- "[json.exception.type_error.306] cannot use value() with number");
- CHECK_THROWS_WITH(j_nonobject_const.value("/foo"_json_pointer, 1),
- "[json.exception.type_error.306] cannot use value() with number");
- }
-
- SECTION("number (unsigned)")
- {
- json j_nonobject(json::value_t::number_unsigned);
- const json j_nonobject_const(json::value_t::number_unsigned);
- CHECK_THROWS_AS(j_nonobject.value("/foo"_json_pointer, 1), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.value("/foo"_json_pointer, 1), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.value("/foo"_json_pointer, 1),
- "[json.exception.type_error.306] cannot use value() with number");
- CHECK_THROWS_WITH(j_nonobject_const.value("/foo"_json_pointer, 1),
- "[json.exception.type_error.306] cannot use value() with number");
- }
-
- SECTION("number (floating-point)")
- {
- json j_nonobject(json::value_t::number_float);
- const json j_nonobject_const(json::value_t::number_float);
- CHECK_THROWS_AS(j_nonobject.value("/foo"_json_pointer, 1), json::type_error&);
- CHECK_THROWS_AS(j_nonobject_const.value("/foo"_json_pointer, 1), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.value("/foo"_json_pointer, 1),
- "[json.exception.type_error.306] cannot use value() with number");
- CHECK_THROWS_WITH(j_nonobject_const.value("/foo"_json_pointer, 1),
- "[json.exception.type_error.306] cannot use value() with number");
- }
- }
- }
- }
-
- SECTION("front and back")
- {
- // "array" is the smallest key
- CHECK(j.front() == json({1, 2, 3}));
- CHECK(j_const.front() == json({1, 2, 3}));
- // "unsigned" is the largest key
- CHECK(j.back() == json(1u));
- CHECK(j_const.back() == json(1u));
- }
-
- SECTION("access specified element")
- {
- SECTION("access within bounds")
- {
- CHECK(j["integer"] == json(1));
- CHECK(j[json::object_t::key_type("integer")] == j["integer"]);
-
- CHECK(j["unsigned"] == json(1u));
- CHECK(j[json::object_t::key_type("unsigned")] == j["unsigned"]);
-
- CHECK(j["boolean"] == json(true));
- CHECK(j[json::object_t::key_type("boolean")] == j["boolean"]);
-
- CHECK(j["null"] == json(nullptr));
- CHECK(j[json::object_t::key_type("null")] == j["null"]);
-
- CHECK(j["string"] == json("hello world"));
- CHECK(j[json::object_t::key_type("string")] == j["string"]);
-
- CHECK(j["floating"] == json(42.23));
- CHECK(j[json::object_t::key_type("floating")] == j["floating"]);
-
- CHECK(j["object"] == json::object());
- CHECK(j[json::object_t::key_type("object")] == j["object"]);
-
- CHECK(j["array"] == json({1, 2, 3}));
- CHECK(j[json::object_t::key_type("array")] == j["array"]);
-
- CHECK(j_const["integer"] == json(1));
- CHECK(j_const[json::object_t::key_type("integer")] == j["integer"]);
-
- CHECK(j_const["boolean"] == json(true));
- CHECK(j_const[json::object_t::key_type("boolean")] == j["boolean"]);
-
- CHECK(j_const["null"] == json(nullptr));
- CHECK(j_const[json::object_t::key_type("null")] == j["null"]);
-
- CHECK(j_const["string"] == json("hello world"));
- CHECK(j_const[json::object_t::key_type("string")] == j["string"]);
-
- CHECK(j_const["floating"] == json(42.23));
- CHECK(j_const[json::object_t::key_type("floating")] == j["floating"]);
-
- CHECK(j_const["object"] == json::object());
- CHECK(j_const[json::object_t::key_type("object")] == j["object"]);
-
- CHECK(j_const["array"] == json({1, 2, 3}));
- CHECK(j_const[json::object_t::key_type("array")] == j["array"]);
- }
-
- SECTION("access on non-object type")
- {
- SECTION("null")
- {
- 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_AS(j_const_nonobject["foo"], json::type_error&);
- CHECK_THROWS_AS(j_const_nonobject[json::object_t::key_type("foo")], json::type_error&);
- CHECK_THROWS_WITH(j_const_nonobject["foo"], "[json.exception.type_error.305] cannot use operator[] with a string argument with null");
- CHECK_THROWS_WITH(j_const_nonobject[json::object_t::key_type("foo")],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with null");
- }
-
- SECTION("boolean")
- {
- json j_nonobject(json::value_t::boolean);
- const json j_const_nonobject(j_nonobject);
- CHECK_THROWS_AS(j_nonobject["foo"], json::type_error&);
- CHECK_THROWS_AS(j_nonobject[json::object_t::key_type("foo")], json::type_error&);
- CHECK_THROWS_AS(j_const_nonobject["foo"], json::type_error&);
- CHECK_THROWS_AS(j_const_nonobject[json::object_t::key_type("foo")], json::type_error&);
- CHECK_THROWS_WITH(j_nonobject["foo"],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with boolean");
- CHECK_THROWS_WITH(j_nonobject[json::object_t::key_type("foo")],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with boolean");
- CHECK_THROWS_WITH(j_const_nonobject["foo"],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with boolean");
- CHECK_THROWS_WITH(j_const_nonobject[json::object_t::key_type("foo")],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with boolean");
- }
-
- SECTION("string")
- {
- json j_nonobject(json::value_t::string);
- const json j_const_nonobject(j_nonobject);
- CHECK_THROWS_AS(j_nonobject["foo"], json::type_error&);
- CHECK_THROWS_AS(j_nonobject[json::object_t::key_type("foo")], json::type_error&);
- CHECK_THROWS_AS(j_const_nonobject["foo"], json::type_error&);
- CHECK_THROWS_AS(j_const_nonobject[json::object_t::key_type("foo")], json::type_error&);
- CHECK_THROWS_WITH(j_nonobject["foo"],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with string");
- CHECK_THROWS_WITH(j_nonobject[json::object_t::key_type("foo")],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with string");
- CHECK_THROWS_WITH(j_const_nonobject["foo"],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with string");
- CHECK_THROWS_WITH(j_const_nonobject[json::object_t::key_type("foo")],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with string");
- }
-
- SECTION("array")
- {
- json j_nonobject(json::value_t::array);
- const json j_const_nonobject(j_nonobject);
- CHECK_THROWS_AS(j_nonobject["foo"], json::type_error&);
- CHECK_THROWS_AS(j_nonobject[json::object_t::key_type("foo")], json::type_error&);
- CHECK_THROWS_AS(j_const_nonobject["foo"], json::type_error&);
- CHECK_THROWS_AS(j_const_nonobject[json::object_t::key_type("foo")], json::type_error&);
- CHECK_THROWS_WITH(j_nonobject["foo"],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with array");
- CHECK_THROWS_WITH(j_nonobject[json::object_t::key_type("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with array");
- CHECK_THROWS_WITH(j_const_nonobject["foo"],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with array");
- CHECK_THROWS_WITH(j_const_nonobject[json::object_t::key_type("foo")],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with array");
- }
-
- SECTION("number (integer)")
- {
- json j_nonobject(json::value_t::number_integer);
- const json j_const_nonobject(j_nonobject);
- CHECK_THROWS_AS(j_nonobject["foo"], json::type_error&);
- CHECK_THROWS_AS(j_nonobject[json::object_t::key_type("foo")], json::type_error&);
- CHECK_THROWS_AS(j_const_nonobject["foo"], json::type_error&);
- CHECK_THROWS_AS(j_const_nonobject[json::object_t::key_type("foo")], json::type_error&);
- CHECK_THROWS_WITH(j_nonobject["foo"],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with number");
- CHECK_THROWS_WITH(j_nonobject[json::object_t::key_type("foo")],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with number");
- CHECK_THROWS_WITH(j_const_nonobject["foo"],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with number");
- CHECK_THROWS_WITH(j_const_nonobject[json::object_t::key_type("foo")],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with number");
- }
-
- SECTION("number (unsigned)")
- {
- json j_nonobject(json::value_t::number_unsigned);
- const json j_const_nonobject(j_nonobject);
- CHECK_THROWS_AS(j_nonobject["foo"], json::type_error&);
- CHECK_THROWS_AS(j_nonobject[json::object_t::key_type("foo")], json::type_error&);
- CHECK_THROWS_AS(j_const_nonobject["foo"], json::type_error&);
- CHECK_THROWS_AS(j_const_nonobject[json::object_t::key_type("foo")], json::type_error&);
- CHECK_THROWS_WITH(j_nonobject["foo"],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with number");
- CHECK_THROWS_WITH(j_nonobject[json::object_t::key_type("foo")],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with number");
- CHECK_THROWS_WITH(j_const_nonobject["foo"],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with number");
- CHECK_THROWS_WITH(j_const_nonobject[json::object_t::key_type("foo")],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with number");
- }
-
- SECTION("number (floating-point)")
- {
- json j_nonobject(json::value_t::number_float);
- const json j_const_nonobject(j_nonobject);
- CHECK_THROWS_AS(j_nonobject["foo"], json::type_error&);
- CHECK_THROWS_AS(j_nonobject[json::object_t::key_type("foo")], json::type_error&);
- CHECK_THROWS_AS(j_const_nonobject["foo"], json::type_error&);
- CHECK_THROWS_AS(j_const_nonobject[json::object_t::key_type("foo")], json::type_error&);
- CHECK_THROWS_WITH(j_nonobject["foo"],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with number");
- CHECK_THROWS_WITH(j_nonobject[json::object_t::key_type("foo")],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with number");
- CHECK_THROWS_WITH(j_const_nonobject["foo"],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with number");
- CHECK_THROWS_WITH(j_const_nonobject[json::object_t::key_type("foo")],
- "[json.exception.type_error.305] cannot use operator[] with a string argument with number");
- }
- }
- }
-
- SECTION("remove specified element")
- {
- SECTION("remove element by key")
- {
- CHECK(j.find("integer") != j.end());
- CHECK(j.erase("integer") == 1);
- CHECK(j.find("integer") == j.end());
- CHECK(j.erase("integer") == 0);
-
- CHECK(j.find("unsigned") != j.end());
- CHECK(j.erase("unsigned") == 1);
- CHECK(j.find("unsigned") == j.end());
- CHECK(j.erase("unsigned") == 0);
-
- CHECK(j.find("boolean") != j.end());
- CHECK(j.erase("boolean") == 1);
- CHECK(j.find("boolean") == j.end());
- CHECK(j.erase("boolean") == 0);
-
- CHECK(j.find("null") != j.end());
- CHECK(j.erase("null") == 1);
- CHECK(j.find("null") == j.end());
- CHECK(j.erase("null") == 0);
-
- CHECK(j.find("string") != j.end());
- CHECK(j.erase("string") == 1);
- CHECK(j.find("string") == j.end());
- CHECK(j.erase("string") == 0);
-
- CHECK(j.find("floating") != j.end());
- CHECK(j.erase("floating") == 1);
- CHECK(j.find("floating") == j.end());
- CHECK(j.erase("floating") == 0);
-
- CHECK(j.find("object") != j.end());
- CHECK(j.erase("object") == 1);
- CHECK(j.find("object") == j.end());
- CHECK(j.erase("object") == 0);
-
- CHECK(j.find("array") != j.end());
- CHECK(j.erase("array") == 1);
- CHECK(j.find("array") == j.end());
- CHECK(j.erase("array") == 0);
- }
-
- SECTION("remove element by iterator")
- {
- SECTION("erase(begin())")
- {
- {
- json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
- json::iterator it2 = jobject.erase(jobject.begin());
- CHECK(jobject == json({{"b", 1}, {"c", 17u}}));
- CHECK(*it2 == json(1));
- }
- {
- json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
- json::const_iterator it2 = jobject.erase(jobject.cbegin());
- CHECK(jobject == json({{"b", 1}, {"c", 17u}}));
- CHECK(*it2 == json(1));
- }
- }
-
- SECTION("erase(begin(), end())")
- {
- {
- json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
- json::iterator it2 = jobject.erase(jobject.begin(), jobject.end());
- CHECK(jobject == json::object());
- CHECK(it2 == jobject.end());
- }
- {
- json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
- json::const_iterator it2 = jobject.erase(jobject.cbegin(), jobject.cend());
- CHECK(jobject == json::object());
- CHECK(it2 == jobject.cend());
- }
- }
-
- SECTION("erase(begin(), begin())")
- {
- {
- json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
- json::iterator it2 = jobject.erase(jobject.begin(), jobject.begin());
- CHECK(jobject == json({{"a", "a"}, {"b", 1}, {"c", 17u}}));
- CHECK(*it2 == json("a"));
- }
- {
- json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
- json::const_iterator it2 = jobject.erase(jobject.cbegin(), jobject.cbegin());
- CHECK(jobject == json({{"a", "a"}, {"b", 1}, {"c", 17u}}));
- CHECK(*it2 == json("a"));
- }
- }
-
- SECTION("erase at offset")
- {
- {
- json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
- json::iterator it = jobject.find("b");
- json::iterator it2 = jobject.erase(it);
- CHECK(jobject == json({{"a", "a"}, {"c", 17u}}));
- CHECK(*it2 == json(17));
- }
- {
- json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
- json::const_iterator it = jobject.find("b");
- json::const_iterator it2 = jobject.erase(it);
- CHECK(jobject == json({{"a", "a"}, {"c", 17u}}));
- CHECK(*it2 == json(17));
- }
- }
-
- SECTION("erase subrange")
- {
- {
- json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}, {"d", false}, {"e", true}};
- json::iterator it2 = jobject.erase(jobject.find("b"), jobject.find("e"));
- CHECK(jobject == json({{"a", "a"}, {"e", true}}));
- CHECK(*it2 == json(true));
- }
- {
- json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}, {"d", false}, {"e", true}};
- json::const_iterator it2 = jobject.erase(jobject.find("b"), jobject.find("e"));
- CHECK(jobject == json({{"a", "a"}, {"e", true}}));
- CHECK(*it2 == json(true));
- }
- }
-
- SECTION("different objects")
- {
- {
- json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}, {"d", false}, {"e", true}};
- json jobject2 = {{"a", "a"}, {"b", 1}, {"c", 17u}};
- CHECK_THROWS_AS(jobject.erase(jobject2.begin()), json::invalid_iterator&);
- CHECK_THROWS_AS(jobject.erase(jobject.begin(), jobject2.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(jobject.erase(jobject2.begin(), jobject.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(jobject.erase(jobject2.begin(), jobject2.end()), json::invalid_iterator&);
- CHECK_THROWS_WITH(jobject.erase(jobject2.begin()),
- "[json.exception.invalid_iterator.202] iterator does not fit current value");
- CHECK_THROWS_WITH(jobject.erase(jobject.begin(), jobject2.end()),
- "[json.exception.invalid_iterator.203] iterators do not fit current value");
- CHECK_THROWS_WITH(jobject.erase(jobject2.begin(), jobject.end()),
- "[json.exception.invalid_iterator.203] iterators do not fit current value");
- CHECK_THROWS_WITH(jobject.erase(jobject2.begin(), jobject2.end()),
- "[json.exception.invalid_iterator.203] iterators do not fit current value");
- }
- {
- json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}, {"d", false}, {"e", true}};
- json jobject2 = {{"a", "a"}, {"b", 1}, {"c", 17u}};
- CHECK_THROWS_AS(jobject.erase(jobject2.cbegin()), json::invalid_iterator&);
- CHECK_THROWS_AS(jobject.erase(jobject.cbegin(), jobject2.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(jobject.erase(jobject2.cbegin(), jobject.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(jobject.erase(jobject2.cbegin(), jobject2.cend()), json::invalid_iterator&);
- CHECK_THROWS_WITH(jobject.erase(jobject2.cbegin()),
- "[json.exception.invalid_iterator.202] iterator does not fit current value");
- CHECK_THROWS_WITH(jobject.erase(jobject.cbegin(), jobject2.cend()),
- "[json.exception.invalid_iterator.203] iterators do not fit current value");
- CHECK_THROWS_WITH(jobject.erase(jobject2.cbegin(), jobject.cend()),
- "[json.exception.invalid_iterator.203] iterators do not fit current value");
- CHECK_THROWS_WITH(jobject.erase(jobject2.cbegin(), jobject2.cend()),
- "[json.exception.invalid_iterator.203] iterators do not fit current value");
- }
- }
- }
-
- SECTION("remove element by key in non-object type")
- {
- SECTION("null")
- {
- json j_nonobject(json::value_t::null);
- CHECK_THROWS_AS(j_nonobject.erase("foo"), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.erase("foo"),
- "[json.exception.type_error.307] cannot use erase() with null");
- }
-
- SECTION("boolean")
- {
- json j_nonobject(json::value_t::boolean);
- CHECK_THROWS_AS(j_nonobject.erase("foo"), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.erase("foo"),
- "[json.exception.type_error.307] cannot use erase() with boolean");
- }
-
- SECTION("string")
- {
- json j_nonobject(json::value_t::string);
- CHECK_THROWS_AS(j_nonobject.erase("foo"), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.erase("foo"),
- "[json.exception.type_error.307] cannot use erase() with string");
- }
-
- SECTION("array")
- {
- json j_nonobject(json::value_t::array);
- CHECK_THROWS_AS(j_nonobject.erase("foo"), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.erase("foo"),
- "[json.exception.type_error.307] cannot use erase() with array");
- }
-
- SECTION("number (integer)")
- {
- json j_nonobject(json::value_t::number_integer);
- CHECK_THROWS_AS(j_nonobject.erase("foo"), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.erase("foo"),
- "[json.exception.type_error.307] cannot use erase() with number");
- }
-
- SECTION("number (floating-point)")
- {
- json j_nonobject(json::value_t::number_float);
- CHECK_THROWS_AS(j_nonobject.erase("foo"), json::type_error&);
- CHECK_THROWS_WITH(j_nonobject.erase("foo"),
- "[json.exception.type_error.307] cannot use erase() with number");
- }
- }
- }
-
- SECTION("find an element in an object")
- {
- SECTION("existing element")
- {
- for (const auto* 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));
- }
- }
-
- SECTION("nonexisting element")
- {
- CHECK(j.find("foo") == j.end());
- CHECK(j_const.find("foo") == j_const.end());
- }
-
- SECTION("all types")
- {
- SECTION("null")
- {
- 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());
- }
-
- 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());
- }
-
- 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());
- }
-
- 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());
- }
-
- 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());
- }
-
- 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());
- }
-
- 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());
- }
-
- 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());
- }
- }
- }
-
- SECTION("count keys in an object")
- {
- SECTION("existing element")
- {
- for (const auto* key :
- {"integer", "unsigned", "floating", "null", "string", "boolean", "object", "array"
- })
- {
- CHECK(j.count(key) == 1);
- CHECK(j_const.count(key) == 1);
- }
- }
-
- SECTION("nonexisting element")
- {
- CHECK(j.count("foo") == 0);
- CHECK(j_const.count("foo") == 0);
- }
-
- SECTION("all types")
- {
- SECTION("null")
- {
- 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);
- }
-
- 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);
- }
-
- 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);
- }
-
- 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);
- }
-
- 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);
- }
-
- 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);
- }
-
- 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);
- }
-
- 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);
- }
- }
- }
-
- SECTION("check existence of key in an object")
- {
- SECTION("existing element")
- {
- for (const auto* key :
- {"integer", "unsigned", "floating", "null", "string", "boolean", "object", "array"
- })
- {
- CHECK(j.contains(key) == true);
- CHECK(j_const.contains(key) == true);
- }
- }
-
- SECTION("nonexisting element")
- {
- CHECK(j.contains("foo") == false);
- CHECK(j_const.contains("foo") == false);
- }
-
- SECTION("all types")
- {
- SECTION("null")
- {
- 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);
- }
-
- 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);
- }
-
- 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);
- }
-
- 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);
- }
-
- 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);
- }
-
- 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);
- }
-
- 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);
- }
-
- 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.contains("foo") == false);
- CHECK(j_nonobject_const.contains("foo") == false);
- }
- }
- }
- }
-}
-
-#if !defined(JSON_NOEXCEPTION)
-TEST_CASE("element access 2 (throwing tests)")
-{
- SECTION("object")
- {
- json j = {{"integer", 1}, {"unsigned", 1u}, {"floating", 42.23}, {"null", nullptr}, {"string", "hello world"}, {"boolean", true}, {"object", json::object()}, {"array", {1, 2, 3}}};
- const json j_const = {{"integer", 1}, {"unsigned", 1u}, {"floating", 42.23}, {"null", nullptr}, {"string", "hello world"}, {"boolean", true}, {"object", json::object()}, {"array", {1, 2, 3}}};
-
- SECTION("access specified element with default value")
- {
- SECTION("given a JSON pointer")
- {
- SECTION("access non-existing value")
- {
- CHECK(j.value("/not/existing"_json_pointer, 2) == 2);
- CHECK(j.value("/not/existing"_json_pointer, 2u) == 2u);
- CHECK(j.value("/not/existing"_json_pointer, false) == false);
- CHECK(j.value("/not/existing"_json_pointer, "bar") == "bar");
- CHECK(j.value("/not/existing"_json_pointer, 12.34) == Approx(12.34));
- CHECK(j.value("/not/existing"_json_pointer, json({{"foo", "bar"}})) == json({{"foo", "bar"}}));
- CHECK(j.value("/not/existing"_json_pointer, json({10, 100})) == json({10, 100}));
-
- CHECK(j_const.value("/not/existing"_json_pointer, 2) == 2);
- CHECK(j_const.value("/not/existing"_json_pointer, 2u) == 2u);
- CHECK(j_const.value("/not/existing"_json_pointer, false) == false);
- CHECK(j_const.value("/not/existing"_json_pointer, "bar") == "bar");
- CHECK(j_const.value("/not/existing"_json_pointer, 12.34) == Approx(12.34));
- CHECK(j_const.value("/not/existing"_json_pointer, json({{"foo", "bar"}})) == json({{"foo", "bar"}}));
- CHECK(j_const.value("/not/existing"_json_pointer, json({10, 100})) == json({10, 100}));
- }
- }
- }
- }
-}
-#endif
diff --git a/test/src/unit-iterators2.cpp b/test/src/unit-iterators2.cpp
deleted file mode 100644
index bf0b35f..0000000
--- a/test/src/unit-iterators2.cpp
+++ /dev/null
@@ -1,1000 +0,0 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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;
-
-TEST_CASE("iterators 2")
-{
- SECTION("iterator comparisons")
- {
- json j_values = {nullptr, true, 42, 42u, 23.23, {{"one", 1}, {"two", 2}}, {1, 2, 3, 4, 5}, "Hello, world"};
-
- for (json& j : j_values)
- {
- auto it1 = j.begin();
- auto it2 = j.begin();
- auto it3 = j.begin();
- ++it2;
- ++it3;
- ++it3;
- auto it1_c = j.cbegin();
- auto it2_c = j.cbegin();
- auto it3_c = j.cbegin();
- ++it2_c;
- ++it3_c;
- ++it3_c;
-
- // comparison: equal
- {
- CHECK(it1 == it1);
- CHECK(!(it1 == it2));
- CHECK(!(it1 == it3));
- CHECK(!(it2 == it3));
- CHECK(it1_c == it1_c);
- CHECK(!(it1_c == it2_c));
- CHECK(!(it1_c == it3_c));
- CHECK(!(it2_c == it3_c));
- }
-
- // comparison: not equal
- {
- // check definition
- CHECK( (it1 != it1) == !(it1 == it1) );
- CHECK( (it1 != it2) == !(it1 == it2) );
- CHECK( (it1 != it3) == !(it1 == it3) );
- CHECK( (it2 != it3) == !(it2 == it3) );
- CHECK( (it1_c != it1_c) == !(it1_c == it1_c) );
- CHECK( (it1_c != it2_c) == !(it1_c == it2_c) );
- CHECK( (it1_c != it3_c) == !(it1_c == it3_c) );
- CHECK( (it2_c != it3_c) == !(it2_c == it3_c) );
- }
-
- // comparison: smaller
- {
- if (j.type() == json::value_t::object)
- {
- CHECK_THROWS_AS(it1 < it1, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 < it2, json::invalid_iterator&);
- CHECK_THROWS_AS(it2 < it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 < it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c < it1_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c < it2_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it2_c < it3_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c < it3_c, json::invalid_iterator&);
-#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(it1 < it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 < it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 < it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 < it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c < it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c < it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c < it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c < it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
-#else
- CHECK_THROWS_WITH(it1 < it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 < it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 < it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 < it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c < it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c < it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c < it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c < it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
-#endif
- }
- else
- {
- CHECK(!(it1 < it1));
- CHECK(it1 < it2);
- CHECK(it1 < it3);
- CHECK(it2 < it3);
- CHECK(!(it1_c < it1_c));
- CHECK(it1_c < it2_c);
- CHECK(it1_c < it3_c);
- CHECK(it2_c < it3_c);
- }
- }
-
- // comparison: less than or equal
- {
- if (j.type() == json::value_t::object)
- {
- CHECK_THROWS_AS(it1 <= it1, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 <= it2, json::invalid_iterator&);
- CHECK_THROWS_AS(it2 <= it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 <= it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c <= it1_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c <= it2_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it2_c <= it3_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c <= it3_c, json::invalid_iterator&);
-#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(it1 <= it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 <= it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 <= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 <= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c <= it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c <= it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c <= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c <= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
-#else
- CHECK_THROWS_WITH(it1 <= it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 <= it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 <= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 <= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c <= it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c <= it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c <= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c <= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
-#endif
- }
- else
- {
- // check definition
- CHECK( (it1 <= it1) == !(it1 < it1) );
- CHECK( (it1 <= it2) == !(it2 < it1) );
- CHECK( (it1 <= it3) == !(it3 < it1) );
- CHECK( (it2 <= it3) == !(it3 < it2) );
- CHECK( (it1_c <= it1_c) == !(it1_c < it1_c) );
- CHECK( (it1_c <= it2_c) == !(it2_c < it1_c) );
- CHECK( (it1_c <= it3_c) == !(it3_c < it1_c) );
- CHECK( (it2_c <= it3_c) == !(it3_c < it2_c) );
- }
- }
-
- // comparison: greater than
- {
- if (j.type() == json::value_t::object)
- {
- CHECK_THROWS_AS(it1 > it1, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 > it2, json::invalid_iterator&);
- CHECK_THROWS_AS(it2 > it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 > it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c > it1_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c > it2_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it2_c > it3_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c > it3_c, json::invalid_iterator&);
-#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(it1 > it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 > it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 > it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 > it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c > it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c > it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c > it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c > it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
-#else
- CHECK_THROWS_WITH(it1 > it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 > it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 > it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 > it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c > it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c > it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c > it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c > it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
-#endif
- }
- else
- {
- // check definition
- CHECK( (it1 > it1) == (it1 < it1) );
- CHECK( (it1 > it2) == (it2 < it1) );
- CHECK( (it1 > it3) == (it3 < it1) );
- CHECK( (it2 > it3) == (it3 < it2) );
- CHECK( (it1_c > it1_c) == (it1_c < it1_c) );
- CHECK( (it1_c > it2_c) == (it2_c < it1_c) );
- CHECK( (it1_c > it3_c) == (it3_c < it1_c) );
- CHECK( (it2_c > it3_c) == (it3_c < it2_c) );
- }
- }
-
- // comparison: greater than or equal
- {
- if (j.type() == json::value_t::object)
- {
- CHECK_THROWS_AS(it1 >= it1, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 >= it2, json::invalid_iterator&);
- CHECK_THROWS_AS(it2 >= it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 >= it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c >= it1_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c >= it2_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it2_c >= it3_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c >= it3_c, json::invalid_iterator&);
-#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(it1 >= it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 >= it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 >= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 >= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c >= it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c >= it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c >= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c >= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
-#else
- CHECK_THROWS_WITH(it1 >= it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 >= it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 >= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 >= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c >= it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c >= it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c >= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c >= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
-#endif
- }
- else
- {
- // check definition
- CHECK( (it1 >= it1) == !(it1 < it1) );
- CHECK( (it1 >= it2) == !(it1 < it2) );
- CHECK( (it1 >= it3) == !(it1 < it3) );
- CHECK( (it2 >= it3) == !(it2 < it3) );
- CHECK( (it1_c >= it1_c) == !(it1_c < it1_c) );
- CHECK( (it1_c >= it2_c) == !(it1_c < it2_c) );
- CHECK( (it1_c >= it3_c) == !(it1_c < it3_c) );
- CHECK( (it2_c >= it3_c) == !(it2_c < it3_c) );
- }
- }
- }
-
- // check exceptions if different objects are compared
- for (auto j : j_values)
- {
- for (auto k : j_values)
- {
- if (j != k)
- {
- CHECK_THROWS_AS(j.begin() == k.begin(), json::invalid_iterator&);
- CHECK_THROWS_AS(j.cbegin() == k.cbegin(), json::invalid_iterator&);
- CHECK_THROWS_AS(j.begin() < k.begin(), json::invalid_iterator&);
- CHECK_THROWS_AS(j.cbegin() < k.cbegin(), json::invalid_iterator&);
-#if JSON_DIAGNOSTICS
- // the output differs in each loop, so we cannot fix a string for the expected exception
-#else
- CHECK_THROWS_WITH(j.begin() == k.begin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers");
- CHECK_THROWS_WITH(j.cbegin() == k.cbegin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers");
- CHECK_THROWS_WITH(j.begin() < k.begin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers");
- CHECK_THROWS_WITH(j.cbegin() < k.cbegin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers");
-#endif
- }
- }
- }
- }
-
- SECTION("iterator arithmetic")
- {
- json j_object = {{"one", 1}, {"two", 2}, {"three", 3}};
- json j_array = {1, 2, 3, 4, 5, 6};
- json j_null = nullptr;
- json j_value = 42;
-
- SECTION("addition and subtraction")
- {
- SECTION("object")
- {
- {
- auto it = j_object.begin();
- CHECK_THROWS_AS(it += 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it += 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.cbegin();
- CHECK_THROWS_AS(it += 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it += 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.begin();
- CHECK_THROWS_AS(it + 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it + 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.cbegin();
- CHECK_THROWS_AS(it + 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it + 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.begin();
- CHECK_THROWS_AS(1 + it, json::invalid_iterator&);
- CHECK_THROWS_WITH(1 + it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.cbegin();
- CHECK_THROWS_AS(1 + it, json::invalid_iterator&);
- CHECK_THROWS_WITH(1 + it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.begin();
- CHECK_THROWS_AS(it -= 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it -= 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.cbegin();
- CHECK_THROWS_AS(it -= 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it -= 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.begin();
- CHECK_THROWS_AS(it - 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it - 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.cbegin();
- CHECK_THROWS_AS(it - 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it - 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.begin();
- CHECK_THROWS_AS(it - it, json::invalid_iterator&);
- CHECK_THROWS_WITH(it - it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.cbegin();
- CHECK_THROWS_AS(it - it, json::invalid_iterator&);
- CHECK_THROWS_WITH(it - it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- }
-
- SECTION("array")
- {
- {
- auto it = j_array.begin();
- it += 3;
- CHECK((j_array.begin() + 3) == it);
- CHECK((3 + j_array.begin()) == it);
- CHECK((it - 3) == j_array.begin());
- CHECK((it - j_array.begin()) == 3);
- CHECK(*it == json(4));
- it -= 2;
- CHECK(*it == json(2));
- }
- {
- auto it = j_array.cbegin();
- it += 3;
- CHECK((j_array.cbegin() + 3) == it);
- CHECK((3 + j_array.cbegin()) == it);
- CHECK((it - 3) == j_array.cbegin());
- CHECK((it - j_array.cbegin()) == 3);
- CHECK(*it == json(4));
- it -= 2;
- CHECK(*it == json(2));
- }
- }
-
- SECTION("null")
- {
- {
- auto it = j_null.begin();
- it += 3;
- CHECK((j_null.begin() + 3) == it);
- CHECK((3 + j_null.begin()) == it);
- CHECK((it - 3) == j_null.begin());
- CHECK((it - j_null.begin()) == 3);
- CHECK(it != j_null.end());
- it -= 3;
- CHECK(it == j_null.end());
- }
- {
- auto it = j_null.cbegin();
- it += 3;
- CHECK((j_null.cbegin() + 3) == it);
- CHECK((3 + j_null.cbegin()) == it);
- CHECK((it - 3) == j_null.cbegin());
- CHECK((it - j_null.cbegin()) == 3);
- CHECK(it != j_null.cend());
- it -= 3;
- CHECK(it == j_null.cend());
- }
- }
-
- SECTION("value")
- {
- {
- auto it = j_value.begin();
- it += 3;
- CHECK((j_value.begin() + 3) == it);
- CHECK((3 + j_value.begin()) == it);
- CHECK((it - 3) == j_value.begin());
- CHECK((it - j_value.begin()) == 3);
- CHECK(it != j_value.end());
- it -= 3;
- CHECK(*it == json(42));
- }
- {
- auto it = j_value.cbegin();
- it += 3;
- CHECK((j_value.cbegin() + 3) == it);
- CHECK((3 + j_value.cbegin()) == it);
- CHECK((it - 3) == j_value.cbegin());
- CHECK((it - j_value.cbegin()) == 3);
- CHECK(it != j_value.cend());
- it -= 3;
- CHECK(*it == json(42));
- }
- }
- }
-
- SECTION("subscript operator")
- {
- SECTION("object")
- {
- {
- auto it = j_object.begin();
- CHECK_THROWS_AS(it[0], json::invalid_iterator&);
- CHECK_THROWS_AS(it[1], json::invalid_iterator&);
- CHECK_THROWS_WITH(it[0], "[json.exception.invalid_iterator.208] cannot use operator[] for object iterators");
- CHECK_THROWS_WITH(it[1], "[json.exception.invalid_iterator.208] cannot use operator[] for object iterators");
- }
- {
- auto it = j_object.cbegin();
- CHECK_THROWS_AS(it[0], json::invalid_iterator&);
- CHECK_THROWS_AS(it[1], json::invalid_iterator&);
- CHECK_THROWS_WITH(it[0], "[json.exception.invalid_iterator.208] cannot use operator[] for object iterators");
- CHECK_THROWS_WITH(it[1], "[json.exception.invalid_iterator.208] cannot use operator[] for object iterators");
- }
- }
-
- SECTION("array")
- {
- {
- auto it = j_array.begin();
- CHECK(it[0] == json(1));
- CHECK(it[1] == json(2));
- CHECK(it[2] == json(3));
- CHECK(it[3] == json(4));
- CHECK(it[4] == json(5));
- CHECK(it[5] == json(6));
- }
- {
- auto it = j_array.cbegin();
- CHECK(it[0] == json(1));
- CHECK(it[1] == json(2));
- CHECK(it[2] == json(3));
- CHECK(it[3] == json(4));
- CHECK(it[4] == json(5));
- CHECK(it[5] == json(6));
- }
- }
-
- SECTION("null")
- {
- {
- auto it = j_null.begin();
- CHECK_THROWS_AS(it[0], json::invalid_iterator&);
- CHECK_THROWS_AS(it[1], json::invalid_iterator&);
- CHECK_THROWS_WITH(it[0], "[json.exception.invalid_iterator.214] cannot get value");
- CHECK_THROWS_WITH(it[1], "[json.exception.invalid_iterator.214] cannot get value");
- }
- {
- auto it = j_null.cbegin();
- CHECK_THROWS_AS(it[0], json::invalid_iterator&);
- CHECK_THROWS_AS(it[1], json::invalid_iterator&);
- CHECK_THROWS_WITH(it[0], "[json.exception.invalid_iterator.214] cannot get value");
- CHECK_THROWS_WITH(it[1], "[json.exception.invalid_iterator.214] cannot get value");
- }
- }
-
- SECTION("value")
- {
- {
- auto it = j_value.begin();
- CHECK(it[0] == json(42));
- CHECK_THROWS_AS(it[1], json::invalid_iterator&);
- CHECK_THROWS_WITH(it[1], "[json.exception.invalid_iterator.214] cannot get value");
- }
- {
- auto it = j_value.cbegin();
- CHECK(it[0] == json(42));
- CHECK_THROWS_AS(it[1], json::invalid_iterator&);
- CHECK_THROWS_WITH(it[1], "[json.exception.invalid_iterator.214] cannot get value");
- }
- }
- }
- }
-
- SECTION("reverse iterator comparisons")
- {
- json j_values = {nullptr, true, 42, 42u, 23.23, {{"one", 1}, {"two", 2}}, {1, 2, 3, 4, 5}, "Hello, world"};
-
- for (json& j : j_values)
- {
- auto it1 = j.rbegin();
- auto it2 = j.rbegin();
- auto it3 = j.rbegin();
- ++it2;
- ++it3;
- ++it3;
- auto it1_c = j.crbegin();
- auto it2_c = j.crbegin();
- auto it3_c = j.crbegin();
- ++it2_c;
- ++it3_c;
- ++it3_c;
-
- // comparison: equal
- {
- CHECK(it1 == it1);
- CHECK(!(it1 == it2));
- CHECK(!(it1 == it3));
- CHECK(!(it2 == it3));
- CHECK(it1_c == it1_c);
- CHECK(!(it1_c == it2_c));
- CHECK(!(it1_c == it3_c));
- CHECK(!(it2_c == it3_c));
- }
-
- // comparison: not equal
- {
- // check definition
- CHECK( (it1 != it1) == !(it1 == it1) );
- CHECK( (it1 != it2) == !(it1 == it2) );
- CHECK( (it1 != it3) == !(it1 == it3) );
- CHECK( (it2 != it3) == !(it2 == it3) );
- CHECK( (it1_c != it1_c) == !(it1_c == it1_c) );
- CHECK( (it1_c != it2_c) == !(it1_c == it2_c) );
- CHECK( (it1_c != it3_c) == !(it1_c == it3_c) );
- CHECK( (it2_c != it3_c) == !(it2_c == it3_c) );
- }
-
- // comparison: smaller
- {
- if (j.type() == json::value_t::object)
- {
- CHECK_THROWS_AS(it1 < it1, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 < it2, json::invalid_iterator&);
- CHECK_THROWS_AS(it2 < it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 < it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c < it1_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c < it2_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it2_c < it3_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c < it3_c, json::invalid_iterator&);
-#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(it1 < it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 < it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 < it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 < it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c < it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c < it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c < it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c < it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
-#else
- CHECK_THROWS_WITH(it1 < it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 < it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 < it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 < it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c < it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c < it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c < it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c < it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
-#endif
- }
- else
- {
- CHECK(!(it1 < it1));
- CHECK(it1 < it2);
- CHECK(it1 < it3);
- CHECK(it2 < it3);
- CHECK(!(it1_c < it1_c));
- CHECK(it1_c < it2_c);
- CHECK(it1_c < it3_c);
- CHECK(it2_c < it3_c);
- }
- }
-
- // comparison: less than or equal
- {
- if (j.type() == json::value_t::object)
- {
- CHECK_THROWS_AS(it1 <= it1, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 <= it2, json::invalid_iterator&);
- CHECK_THROWS_AS(it2 <= it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 <= it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c <= it1_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c <= it2_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it2_c <= it3_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c <= it3_c, json::invalid_iterator&);
-#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(it1 <= it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 <= it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 <= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 <= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c <= it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c <= it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c <= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c <= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
-#else
- CHECK_THROWS_WITH(it1 <= it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 <= it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 <= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 <= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c <= it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c <= it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c <= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c <= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
-#endif
- }
- else
- {
- // check definition
- CHECK( (it1 <= it1) == !(it1 < it1) );
- CHECK( (it1 <= it2) == !(it2 < it1) );
- CHECK( (it1 <= it3) == !(it3 < it1) );
- CHECK( (it2 <= it3) == !(it3 < it2) );
- CHECK( (it1_c <= it1_c) == !(it1_c < it1_c) );
- CHECK( (it1_c <= it2_c) == !(it2_c < it1_c) );
- CHECK( (it1_c <= it3_c) == !(it3_c < it1_c) );
- CHECK( (it2_c <= it3_c) == !(it3_c < it2_c) );
- }
- }
-
- // comparison: greater than
- {
- if (j.type() == json::value_t::object)
- {
- CHECK_THROWS_AS(it1 > it1, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 > it2, json::invalid_iterator&);
- CHECK_THROWS_AS(it2 > it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 > it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c > it1_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c > it2_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it2_c > it3_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c > it3_c, json::invalid_iterator&);
-#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(it1 > it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 > it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 > it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 > it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c > it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c > it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c > it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c > it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
-#else
- CHECK_THROWS_WITH(it1 > it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 > it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 > it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 > it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c > it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c > it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c > it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c > it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
-#endif
- }
- else
- {
- // check definition
- CHECK( (it1 > it1) == (it1 < it1) );
- CHECK( (it1 > it2) == (it2 < it1) );
- CHECK( (it1 > it3) == (it3 < it1) );
- CHECK( (it2 > it3) == (it3 < it2) );
- CHECK( (it1_c > it1_c) == (it1_c < it1_c) );
- CHECK( (it1_c > it2_c) == (it2_c < it1_c) );
- CHECK( (it1_c > it3_c) == (it3_c < it1_c) );
- CHECK( (it2_c > it3_c) == (it3_c < it2_c) );
- }
- }
-
- // comparison: greater than or equal
- {
- if (j.type() == json::value_t::object)
- {
- CHECK_THROWS_AS(it1 >= it1, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 >= it2, json::invalid_iterator&);
- CHECK_THROWS_AS(it2 >= it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1 >= it3, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c >= it1_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c >= it2_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it2_c >= it3_c, json::invalid_iterator&);
- CHECK_THROWS_AS(it1_c >= it3_c, json::invalid_iterator&);
-#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(it1 >= it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 >= it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 >= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 >= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c >= it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c >= it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c >= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c >= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators");
-#else
- CHECK_THROWS_WITH(it1 >= it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 >= it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2 >= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1 >= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c >= it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c >= it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it2_c >= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
- CHECK_THROWS_WITH(it1_c >= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators");
-#endif
- }
- else
- {
- // check definition
- CHECK( (it1 >= it1) == !(it1 < it1) );
- CHECK( (it1 >= it2) == !(it1 < it2) );
- CHECK( (it1 >= it3) == !(it1 < it3) );
- CHECK( (it2 >= it3) == !(it2 < it3) );
- CHECK( (it1_c >= it1_c) == !(it1_c < it1_c) );
- CHECK( (it1_c >= it2_c) == !(it1_c < it2_c) );
- CHECK( (it1_c >= it3_c) == !(it1_c < it3_c) );
- CHECK( (it2_c >= it3_c) == !(it2_c < it3_c) );
- }
- }
- }
-
- // check exceptions if different objects are compared
- for (auto j : j_values)
- {
- for (auto k : j_values)
- {
- if (j != k)
- {
- CHECK_THROWS_AS(j.rbegin() == k.rbegin(), json::invalid_iterator&);
- CHECK_THROWS_AS(j.crbegin() == k.crbegin(), json::invalid_iterator&);
- CHECK_THROWS_AS(j.rbegin() < k.rbegin(), json::invalid_iterator&);
- CHECK_THROWS_AS(j.crbegin() < k.crbegin(), json::invalid_iterator&);
-#if JSON_DIAGNOSTICS
- // the output differs in each loop, so we cannot fix a string for the expected exception
-#else
- CHECK_THROWS_WITH(j.rbegin() == k.rbegin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers");
- CHECK_THROWS_WITH(j.crbegin() == k.crbegin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers");
- CHECK_THROWS_WITH(j.rbegin() < k.rbegin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers");
- CHECK_THROWS_WITH(j.crbegin() < k.crbegin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers");
-#endif
- }
- }
- }
- }
-
- SECTION("reverse iterator arithmetic")
- {
- json j_object = {{"one", 1}, {"two", 2}, {"three", 3}};
- json j_array = {1, 2, 3, 4, 5, 6};
- json j_null = nullptr;
- json j_value = 42;
-
- SECTION("addition and subtraction")
- {
- SECTION("object")
- {
- {
- auto it = j_object.rbegin();
- CHECK_THROWS_AS(it += 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it += 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.crbegin();
- CHECK_THROWS_AS(it += 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it += 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.rbegin();
- CHECK_THROWS_AS(it + 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it + 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.crbegin();
- CHECK_THROWS_AS(it + 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it + 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.rbegin();
- CHECK_THROWS_AS(1 + it, json::invalid_iterator&);
- CHECK_THROWS_WITH(1 + it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.crbegin();
- CHECK_THROWS_AS(1 + it, json::invalid_iterator&);
- CHECK_THROWS_WITH(1 + it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.rbegin();
- CHECK_THROWS_AS(it -= 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it -= 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.crbegin();
- CHECK_THROWS_AS(it -= 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it -= 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.rbegin();
- CHECK_THROWS_AS(it - 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it - 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.crbegin();
- CHECK_THROWS_AS(it - 1, json::invalid_iterator&);
- CHECK_THROWS_WITH(it - 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.rbegin();
- CHECK_THROWS_AS(it - it, json::invalid_iterator&);
- CHECK_THROWS_WITH(it - it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.crbegin();
- CHECK_THROWS_AS(it - it, json::invalid_iterator&);
- CHECK_THROWS_WITH(it - it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- }
-
- SECTION("array")
- {
- {
- auto it = j_array.rbegin();
- it += 3;
- CHECK((j_array.rbegin() + 3) == it);
- CHECK(json::reverse_iterator(3 + j_array.rbegin()) == it);
- CHECK((it - 3) == j_array.rbegin());
- CHECK((it - j_array.rbegin()) == 3);
- CHECK(*it == json(3));
- it -= 2;
- CHECK(*it == json(5));
- }
- {
- auto it = j_array.crbegin();
- it += 3;
- CHECK((j_array.crbegin() + 3) == it);
- CHECK(json::const_reverse_iterator(3 + j_array.crbegin()) == it);
- CHECK((it - 3) == j_array.crbegin());
- CHECK((it - j_array.crbegin()) == 3);
- CHECK(*it == json(3));
- it -= 2;
- CHECK(*it == json(5));
- }
- }
-
- SECTION("null")
- {
- {
- auto it = j_null.rbegin();
- it += 3;
- CHECK((j_null.rbegin() + 3) == it);
- CHECK(json::reverse_iterator(3 + j_null.rbegin()) == it);
- CHECK((it - 3) == j_null.rbegin());
- CHECK((it - j_null.rbegin()) == 3);
- CHECK(it != j_null.rend());
- it -= 3;
- CHECK(it == j_null.rend());
- }
- {
- auto it = j_null.crbegin();
- it += 3;
- CHECK((j_null.crbegin() + 3) == it);
- CHECK(json::const_reverse_iterator(3 + j_null.crbegin()) == it);
- CHECK((it - 3) == j_null.crbegin());
- CHECK((it - j_null.crbegin()) == 3);
- CHECK(it != j_null.crend());
- it -= 3;
- CHECK(it == j_null.crend());
- }
- }
-
- SECTION("value")
- {
- {
- auto it = j_value.rbegin();
- it += 3;
- CHECK((j_value.rbegin() + 3) == it);
- CHECK(json::reverse_iterator(3 + j_value.rbegin()) == it);
- CHECK((it - 3) == j_value.rbegin());
- CHECK((it - j_value.rbegin()) == 3);
- CHECK(it != j_value.rend());
- it -= 3;
- CHECK(*it == json(42));
- }
- {
- auto it = j_value.crbegin();
- it += 3;
- CHECK((j_value.crbegin() + 3) == it);
- CHECK(json::const_reverse_iterator(3 + j_value.crbegin()) == it);
- CHECK((it - 3) == j_value.crbegin());
- CHECK((it - j_value.crbegin()) == 3);
- CHECK(it != j_value.crend());
- it -= 3;
- CHECK(*it == json(42));
- }
- }
- }
-
- SECTION("subscript operator")
- {
- SECTION("object")
- {
- {
- auto it = j_object.rbegin();
- CHECK_THROWS_AS(it[0], json::invalid_iterator&);
- CHECK_THROWS_AS(it[1], json::invalid_iterator&);
- CHECK_THROWS_WITH(it[0], "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- CHECK_THROWS_WITH(it[1], "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- {
- auto it = j_object.crbegin();
- CHECK_THROWS_AS(it[0], json::invalid_iterator&);
- CHECK_THROWS_AS(it[1], json::invalid_iterator&);
- CHECK_THROWS_WITH(it[0], "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- CHECK_THROWS_WITH(it[1], "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
- }
- }
-
- SECTION("array")
- {
- {
- auto it = j_array.rbegin();
- CHECK(it[0] == json(6));
- CHECK(it[1] == json(5));
- CHECK(it[2] == json(4));
- CHECK(it[3] == json(3));
- CHECK(it[4] == json(2));
- CHECK(it[5] == json(1));
- }
- {
- auto it = j_array.crbegin();
- CHECK(it[0] == json(6));
- CHECK(it[1] == json(5));
- CHECK(it[2] == json(4));
- CHECK(it[3] == json(3));
- CHECK(it[4] == json(2));
- CHECK(it[5] == json(1));
- }
- }
-
- SECTION("null")
- {
- {
- auto it = j_null.rbegin();
- CHECK_THROWS_AS(it[0], json::invalid_iterator&);
- CHECK_THROWS_AS(it[1], json::invalid_iterator&);
- CHECK_THROWS_WITH(it[0], "[json.exception.invalid_iterator.214] cannot get value");
- CHECK_THROWS_WITH(it[1], "[json.exception.invalid_iterator.214] cannot get value");
- }
- {
- auto it = j_null.crbegin();
- CHECK_THROWS_AS(it[0], json::invalid_iterator&);
- CHECK_THROWS_AS(it[1], json::invalid_iterator&);
- CHECK_THROWS_WITH(it[0], "[json.exception.invalid_iterator.214] cannot get value");
- CHECK_THROWS_WITH(it[1], "[json.exception.invalid_iterator.214] cannot get value");
- }
- }
-
- SECTION("value")
- {
- {
- auto it = j_value.rbegin();
- CHECK(it[0] == json(42));
- CHECK_THROWS_AS(it[1], json::invalid_iterator&);
- CHECK_THROWS_WITH(it[1], "[json.exception.invalid_iterator.214] cannot get value");
- }
- {
- auto it = j_value.crbegin();
- CHECK(it[0] == json(42));
- CHECK_THROWS_AS(it[1], json::invalid_iterator&);
- CHECK_THROWS_WITH(it[1], "[json.exception.invalid_iterator.214] cannot get value");
- }
- }
- }
- }
-}
diff --git a/test/src/unit-large_json.cpp b/test/src/unit-large_json.cpp
deleted file mode 100644
index bf1a3c5..0000000
--- a/test/src/unit-large_json.cpp
+++ /dev/null
@@ -1,50 +0,0 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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 <algorithm>
-
-TEST_CASE("tests on very large JSONs")
-{
- SECTION("issue #1419 - Segmentation fault (stack overflow) due to unbounded recursion")
- {
- const auto depth = 5000000;
-
- std::string s(static_cast<std::size_t>(2 * depth), '[');
- std::fill(s.begin() + depth, s.end(), ']');
-
- json _;
- CHECK_NOTHROW(_ = nlohmann::json::parse(s));
- }
-}
-
diff --git a/test/src/unit-meta.cpp b/test/src/unit-meta.cpp
deleted file mode 100644
index 65af799..0000000
--- a/test/src/unit-meta.cpp
+++ /dev/null
@@ -1,57 +0,0 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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;
-
-TEST_CASE("version information")
-{
- SECTION("meta()")
- {
- json j = json::meta();
-
- CHECK(j["name"] == "JSON for Modern C++");
- CHECK(j["copyright"] == "(C) 2013-2022 Niels Lohmann");
- CHECK(j["url"] == "https://github.com/nlohmann/json");
- CHECK(j["version"] == json(
- {
- {"string", "3.10.5"},
- {"major", 3},
- {"minor", 10},
- {"patch", 5}
- }));
-
- CHECK(j.find("platform") != j.end());
- CHECK(j.at("compiler").find("family") != j.at("compiler").end());
- CHECK(j.at("compiler").find("version") != j.at("compiler").end());
- CHECK(j.at("compiler").find("c++") != j.at("compiler").end());
- }
-}
diff --git a/test/src/unit-ordered_json.cpp b/test/src/unit-ordered_json.cpp
deleted file mode 100644
index 551ae76..0000000
--- a/test/src/unit-ordered_json.cpp
+++ /dev/null
@@ -1,93 +0,0 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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;
-using nlohmann::ordered_json;
-
-
-TEST_CASE("ordered_json")
-{
- json j;
- ordered_json oj;
-
- j["element3"] = 3;
- j["element1"] = 1;
- j["element2"] = 2;
-
- oj["element3"] = 3;
- oj["element1"] = 1;
- oj["element2"] = 2;
-
- CHECK(j.dump() == "{\"element1\":1,\"element2\":2,\"element3\":3}");
- CHECK(oj.dump() == "{\"element3\":3,\"element1\":1,\"element2\":2}");
-
- CHECK(j == json(oj));
- CHECK(ordered_json(json(oj)) == ordered_json(j));
-
- j.erase("element1");
- oj.erase("element1");
-
- CHECK(j.dump() == "{\"element2\":2,\"element3\":3}");
- CHECK(oj.dump() == "{\"element3\":3,\"element2\":2}");
-
- // remove again and nothing changes
- j.erase("element1");
- oj.erase("element1");
-
- CHECK(j.dump() == "{\"element2\":2,\"element3\":3}");
- CHECK(oj.dump() == "{\"element3\":3,\"element2\":2}");
-
- // There are no dup keys cause constructor calls emplace...
- json multi {{"z", 1}, {"m", 2}, {"m", 3}, {"y", 4}, {"m", 5}};
- CHECK(multi.size() == 3);
- CHECK(multi.dump() == "{\"m\":2,\"y\":4,\"z\":1}");
-
- ordered_json multi_ordered {{"z", 1}, {"m", 2}, {"m", 3}, {"y", 4}, {"m", 5}};
- CHECK(multi_ordered.size() == 3);
- CHECK(multi_ordered.dump() == "{\"z\":1,\"m\":2,\"y\":4}");
- CHECK(multi_ordered.erase("m") == 1);
- CHECK(multi_ordered.dump() == "{\"z\":1,\"y\":4}");
-
- // Ranged insert test.
- // It seems that values shouldn't be overwritten. Only new values are added
- json j1 {{"c", 1}, {"b", 2}, {"a", 3}};
- const json j2 {{"c", 77}, {"d", 42}, {"a", 4}};
- j1.insert( j2.cbegin(), j2.cend() );
- CHECK(j1.size() == 4);
- CHECK(j1.dump() == "{\"a\":3,\"b\":2,\"c\":1,\"d\":42}");
-
- ordered_json oj1 {{"c", 1}, {"b", 2}, {"a", 3}};
- const ordered_json oj2 {{"c", 77}, {"d", 42}, {"a", 4}};
- oj1.insert( oj2.cbegin(), oj2.cend() );
- CHECK(oj1.size() == 4);
- CHECK(oj1.dump() == "{\"c\":1,\"b\":2,\"a\":3,\"d\":42}");
-}
diff --git a/test/src/unit-reference_access.cpp b/test/src/unit-reference_access.cpp
deleted file mode 100644
index 1342d47..0000000
--- a/test/src/unit-reference_access.cpp
+++ /dev/null
@@ -1,317 +0,0 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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;
-
-TEST_CASE("reference access")
-{
- // create a JSON value with different types
- json json_types =
- {
- {"boolean", true},
- {
- "number", {
- {"integer", 42},
- {"floating-point", 17.23}
- }
- },
- {"string", "Hello, world!"},
- {"array", {1, 2, 3, 4, 5}},
- {"null", nullptr}
- };
-
- SECTION("reference access to object_t")
- {
- using test_type = json::object_t;
- json value = {{"one", 1}, {"two", 2}};
-
- // check if references are returned correctly
- auto& p1 = value.get_ref<test_type&>();
- CHECK(&p1 == value.get_ptr<test_type*>());
- CHECK(p1 == value.get<test_type>());
-
- const auto& p2 = value.get_ref<const test_type&>();
- CHECK(&p2 == value.get_ptr<const test_type*>());
- CHECK(p2 == value.get<test_type>());
-
- // check if mismatching references throw correctly
- CHECK_NOTHROW(value.get_ref<json::object_t&>());
- CHECK_THROWS_AS(value.get_ref<json::array_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::array_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is object");
- CHECK_THROWS_AS(value.get_ref<json::string_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::string_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is object");
- CHECK_THROWS_AS(value.get_ref<json::boolean_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::boolean_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is object");
- CHECK_THROWS_AS(value.get_ref<json::number_integer_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_integer_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is object");
- CHECK_THROWS_AS(value.get_ref<json::number_unsigned_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_unsigned_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is object");
- CHECK_THROWS_AS(value.get_ref<json::number_float_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_float_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is object");
- }
-
- SECTION("const reference access to const object_t")
- {
- using test_type = json::object_t;
- const json value = {{"one", 1}, {"two", 2}};
-
- // this should not compile
- // test_type& p1 = value.get_ref<test_type&>();
-
- // check if references are returned correctly
- const auto& p2 = value.get_ref<const test_type&>();
- CHECK(&p2 == value.get_ptr<const test_type*>());
- CHECK(p2 == value.get<test_type>());
- }
-
- SECTION("reference access to array_t")
- {
- using test_type = json::array_t;
- json value = {1, 2, 3, 4};
-
- // check if references are returned correctly
- auto& p1 = value.get_ref<test_type&>();
- CHECK(&p1 == value.get_ptr<test_type*>());
- CHECK(p1 == value.get<test_type>());
-
- const auto& p2 = value.get_ref<const test_type&>();
- CHECK(&p2 == value.get_ptr<const test_type*>());
- CHECK(p2 == value.get<test_type>());
-
- // check if mismatching references throw correctly
- CHECK_THROWS_AS(value.get_ref<json::object_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::object_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is array");
- CHECK_NOTHROW(value.get_ref<json::array_t&>());
- CHECK_THROWS_AS(value.get_ref<json::string_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::string_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is array");
- CHECK_THROWS_AS(value.get_ref<json::boolean_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::boolean_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is array");
- CHECK_THROWS_AS(value.get_ref<json::number_integer_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_integer_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is array");
- CHECK_THROWS_AS(value.get_ref<json::number_unsigned_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_unsigned_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is array");
- CHECK_THROWS_AS(value.get_ref<json::number_float_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_float_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is array");
- }
-
- SECTION("reference access to string_t")
- {
- using test_type = json::string_t;
- json value = "hello";
-
- // check if references are returned correctly
- auto& p1 = value.get_ref<test_type&>();
- CHECK(&p1 == value.get_ptr<test_type*>());
- CHECK(p1 == value.get<test_type>());
-
- const auto& p2 = value.get_ref<const test_type&>();
- CHECK(&p2 == value.get_ptr<const test_type*>());
- CHECK(p2 == value.get<test_type>());
-
- // check if mismatching references throw correctly
- CHECK_THROWS_AS(value.get_ref<json::object_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::object_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is string");
- CHECK_THROWS_AS(value.get_ref<json::array_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::array_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is string");
- CHECK_NOTHROW(value.get_ref<json::string_t&>());
- CHECK_THROWS_AS(value.get_ref<json::boolean_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::boolean_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is string");
- CHECK_THROWS_AS(value.get_ref<json::number_integer_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_integer_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is string");
- CHECK_THROWS_AS(value.get_ref<json::number_unsigned_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_unsigned_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is string");
- CHECK_THROWS_AS(value.get_ref<json::number_float_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_float_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is string");
- }
-
- SECTION("reference access to boolean_t")
- {
- using test_type = json::boolean_t;
- json value = false;
-
- // check if references are returned correctly
- auto& p1 = value.get_ref<test_type&>();
- CHECK(&p1 == value.get_ptr<test_type*>());
- CHECK(p1 == value.get<test_type>());
-
- const auto& p2 = value.get_ref<const test_type&>();
- CHECK(&p2 == value.get_ptr<const test_type*>());
- CHECK(p2 == value.get<test_type>());
-
- // check if mismatching references throw correctly
- CHECK_THROWS_AS(value.get_ref<json::object_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::object_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is boolean");
- CHECK_THROWS_AS(value.get_ref<json::array_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::array_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is boolean");
- CHECK_THROWS_AS(value.get_ref<json::string_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::string_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is boolean");
- CHECK_NOTHROW(value.get_ref<json::boolean_t&>());
- CHECK_THROWS_AS(value.get_ref<json::number_integer_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_integer_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is boolean");
- CHECK_THROWS_AS(value.get_ref<json::number_unsigned_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_unsigned_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is boolean");
- CHECK_THROWS_AS(value.get_ref<json::number_float_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_float_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is boolean");
- }
-
- SECTION("reference access to number_integer_t")
- {
- using test_type = json::number_integer_t;
- json value = -23;
-
- // check if references are returned correctly
- auto& p1 = value.get_ref<test_type&>();
- CHECK(&p1 == value.get_ptr<test_type*>());
- CHECK(p1 == value.get<test_type>());
-
- const auto& p2 = value.get_ref<const test_type&>();
- CHECK(&p2 == value.get_ptr<const test_type*>());
- CHECK(p2 == value.get<test_type>());
-
- // check if mismatching references throw correctly
- CHECK_THROWS_AS(value.get_ref<json::object_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::object_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_THROWS_AS(value.get_ref<json::array_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::array_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_THROWS_AS(value.get_ref<json::string_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::string_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_THROWS_AS(value.get_ref<json::boolean_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::boolean_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_NOTHROW(value.get_ref<json::number_integer_t&>());
- CHECK_THROWS_AS(value.get_ref<json::number_unsigned_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_unsigned_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_THROWS_AS(value.get_ref<json::number_float_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_float_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- }
-
- SECTION("reference access to number_unsigned_t")
- {
- using test_type = json::number_unsigned_t;
- json value = 23u;
-
- // check if references are returned correctly
- auto& p1 = value.get_ref<test_type&>();
- CHECK(&p1 == value.get_ptr<test_type*>());
- CHECK(p1 == value.get<test_type>());
-
- const auto& p2 = value.get_ref<const test_type&>();
- CHECK(&p2 == value.get_ptr<const test_type*>());
- CHECK(p2 == value.get<test_type>());
-
- // check if mismatching references throw correctly
- CHECK_THROWS_AS(value.get_ref<json::object_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::object_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_THROWS_AS(value.get_ref<json::array_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::array_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_THROWS_AS(value.get_ref<json::string_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::string_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_THROWS_AS(value.get_ref<json::boolean_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::boolean_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- //CHECK_THROWS_AS(value.get_ref<json::number_integer_t&>(), json::type_error&);
- //CHECK_THROWS_WITH(value.get_ref<json::number_integer_t&>(),
- // "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_NOTHROW(value.get_ref<json::number_unsigned_t&>());
- CHECK_THROWS_AS(value.get_ref<json::number_float_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_float_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- }
-
- SECTION("reference access to number_float_t")
- {
- using test_type = json::number_float_t;
- json value = 42.23;
-
- // check if references are returned correctly
- auto& p1 = value.get_ref<test_type&>();
- CHECK(&p1 == value.get_ptr<test_type*>());
- CHECK(p1 == value.get<test_type>());
-
- const auto& p2 = value.get_ref<const test_type&>();
- CHECK(&p2 == value.get_ptr<const test_type*>());
- CHECK(p2 == value.get<test_type>());
-
- // check if mismatching references throw correctly
- CHECK_THROWS_AS(value.get_ref<json::object_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::object_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_THROWS_AS(value.get_ref<json::array_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::array_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_THROWS_AS(value.get_ref<json::string_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::string_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_THROWS_AS(value.get_ref<json::boolean_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::boolean_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_THROWS_AS(value.get_ref<json::number_integer_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_integer_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_THROWS_AS(value.get_ref<json::number_unsigned_t&>(), json::type_error&);
- CHECK_THROWS_WITH(value.get_ref<json::number_unsigned_t&>(),
- "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number");
- CHECK_NOTHROW(value.get_ref<json::number_float_t&>());
- }
-}
diff --git a/test/src/unit-wstring.cpp b/test/src/unit-wstring.cpp
deleted file mode 100644
index d15ac84..0000000
--- a/test/src/unit-wstring.cpp
+++ /dev/null
@@ -1,117 +0,0 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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;
-
-namespace
-{
-bool wstring_is_utf16();
-bool wstring_is_utf16()
-{
- return (std::wstring(L"đŠ") == std::wstring(L"\U0001F4A9"));
-}
-
-bool u16string_is_utf16();
-bool u16string_is_utf16()
-{
- return (std::u16string(u"đŠ") == std::u16string(u"\U0001F4A9"));
-}
-
-bool u32string_is_utf32();
-bool u32string_is_utf32()
-{
- return (std::u32string(U"đŠ") == std::u32string(U"\U0001F4A9"));
-}
-} // namespace
-
-TEST_CASE("wide strings")
-{
- SECTION("std::wstring")
- {
- if (wstring_is_utf16())
- {
- std::wstring w = L"[12.2,\"á
aäöđ¤đ§ĸ\"]";
- json j = json::parse(w);
- CHECK(j.dump() == "[12.2,\"á
aäöđ¤đ§ĸ\"]");
- }
- }
-
- SECTION("invalid std::wstring")
- {
- if (wstring_is_utf16())
- {
- std::wstring w = L"\"\xDBFF";
- json _;
- CHECK_THROWS_AS(_ = json::parse(w), json::parse_error&);
- }
- }
-
- SECTION("std::u16string")
- {
- if (u16string_is_utf16())
- {
- std::u16string w = u"[12.2,\"á
aäöđ¤đ§ĸ\"]";
- json j = json::parse(w);
- CHECK(j.dump() == "[12.2,\"á
aäöđ¤đ§ĸ\"]");
- }
- }
-
- SECTION("invalid std::u16string")
- {
- if (wstring_is_utf16())
- {
- std::u16string w = u"\"\xDBFF";
- json _;
- CHECK_THROWS_AS(_ = json::parse(w), json::parse_error&);
- }
- }
-
- SECTION("std::u32string")
- {
- if (u32string_is_utf32())
- {
- std::u32string w = U"[12.2,\"á
aäöđ¤đ§ĸ\"]";
- json j = json::parse(w);
- CHECK(j.dump() == "[12.2,\"á
aäöđ¤đ§ĸ\"]");
- }
- }
-
- SECTION("invalid std::u32string")
- {
- if (u32string_is_utf32())
- {
- std::u32string w = U"\"\x110000";
- json _;
- CHECK_THROWS_AS(_ = json::parse(w), json::parse_error&);
- }
- }
-}
diff --git a/test/src/unit.cpp b/test/src/unit.cpp
deleted file mode 100644
index efb0ff5..0000000
--- a/test/src/unit.cpp
+++ /dev/null
@@ -1,31 +0,0 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
-
-#define DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
-#include "doctest_compatibility.h"
diff --git a/test/thirdparty/doctest/LICENSE.txt b/test/thirdparty/doctest/LICENSE.txt
deleted file mode 100644
index d67bb64..0000000
--- a/test/thirdparty/doctest/LICENSE.txt
+++ /dev/null
@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2016-2021 Viktor Kirilov
-
-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.
diff --git a/test/thirdparty/fifo_map/LICENSE.MIT b/test/thirdparty/fifo_map/LICENSE.MIT
deleted file mode 100644
index 8c59cdf..0000000
--- a/test/thirdparty/fifo_map/LICENSE.MIT
+++ /dev/null
@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2015-2017 Niels Lohmann
-
-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.
diff --git a/test/thirdparty/imapdl/gpl-3.0.txt b/test/thirdparty/imapdl/gpl-3.0.txt
deleted file mode 100644
index f288702..0000000
--- a/test/thirdparty/imapdl/gpl-3.0.txt
+++ /dev/null
@@ -1,674 +0,0 @@
- GNU GENERAL PUBLIC LICENSE
- Version 3, 29 June 2007
-
- Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
- Preamble
-
- The GNU General Public License is a free, copyleft license for
-software and other kinds of works.
-
- The licenses for most software and other practical works are designed
-to take away your freedom to share and change the works. By contrast,
-the GNU General Public License is intended to guarantee your freedom to
-share and change all versions of a program--to make sure it remains free
-software for all its users. We, the Free Software Foundation, use the
-GNU General Public License for most of our software; it applies also to
-any other work released this way by its authors. You can apply it to
-your programs, too.
-
- When we speak of free software, we are referring to freedom, not
-price. Our General Public Licenses are designed to make sure that you
-have the freedom to distribute copies of free software (and charge for
-them if you wish), that you receive source code or can get it if you
-want it, that you can change the software or use pieces of it in new
-free programs, and that you know you can do these things.
-
- To protect your rights, we need to prevent others from denying you
-these rights or asking you to surrender the rights. Therefore, you have
-certain responsibilities if you distribute copies of the software, or if
-you modify it: responsibilities to respect the freedom of others.
-
- For example, if you distribute copies of such a program, whether
-gratis or for a fee, you must pass on to the recipients the same
-freedoms that you received. You must make sure that they, too, receive
-or can get the source code. And you must show them these terms so they
-know their rights.
-
- Developers that use the GNU GPL protect your rights with two steps:
-(1) assert copyright on the software, and (2) offer you this License
-giving you legal permission to copy, distribute and/or modify it.
-
- For the developers' and authors' protection, the GPL clearly explains
-that there is no warranty for this free software. For both users' and
-authors' sake, the GPL requires that modified versions be marked as
-changed, so that their problems will not be attributed erroneously to
-authors of previous versions.
-
- Some devices are designed to deny users access to install or run
-modified versions of the software inside them, although the manufacturer
-can do so. This is fundamentally incompatible with the aim of
-protecting users' freedom to change the software. The systematic
-pattern of such abuse occurs in the area of products for individuals to
-use, which is precisely where it is most unacceptable. Therefore, we
-have designed this version of the GPL to prohibit the practice for those
-products. If such problems arise substantially in other domains, we
-stand ready to extend this provision to those domains in future versions
-of the GPL, as needed to protect the freedom of users.
-
- Finally, every program is threatened constantly by software patents.
-States should not allow patents to restrict development and use of
-software on general-purpose computers, but in those that do, we wish to
-avoid the special danger that patents applied to a free program could
-make it effectively proprietary. To prevent this, the GPL assures that
-patents cannot be used to render the program non-free.
-
- The precise terms and conditions for copying, distribution and
-modification follow.
-
- TERMS AND CONDITIONS
-
- 0. Definitions.
-
- "This License" refers to version 3 of the GNU General Public License.
-
- "Copyright" also means copyright-like laws that apply to other kinds of
-works, such as semiconductor masks.
-
- "The Program" refers to any copyrightable work licensed under this
-License. Each licensee is addressed as "you". "Licensees" and
-"recipients" may be individuals or organizations.
-
- To "modify" a work means to copy from or adapt all or part of the work
-in a fashion requiring copyright permission, other than the making of an
-exact copy. The resulting work is called a "modified version" of the
-earlier work or a work "based on" the earlier work.
-
- A "covered work" means either the unmodified Program or a work based
-on the Program.
-
- To "propagate" a work means to do anything with it that, without
-permission, would make you directly or secondarily liable for
-infringement under applicable copyright law, except executing it on a
-computer or modifying a private copy. Propagation includes copying,
-distribution (with or without modification), making available to the
-public, and in some countries other activities as well.
-
- To "convey" a work means any kind of propagation that enables other
-parties to make or receive copies. Mere interaction with a user through
-a computer network, with no transfer of a copy, is not conveying.
-
- An interactive user interface displays "Appropriate Legal Notices"
-to the extent that it includes a convenient and prominently visible
-feature that (1) displays an appropriate copyright notice, and (2)
-tells the user that there is no warranty for the work (except to the
-extent that warranties are provided), that licensees may convey the
-work under this License, and how to view a copy of this License. If
-the interface presents a list of user commands or options, such as a
-menu, a prominent item in the list meets this criterion.
-
- 1. Source Code.
-
- The "source code" for a work means the preferred form of the work
-for making modifications to it. "Object code" means any non-source
-form of a work.
-
- A "Standard Interface" means an interface that either is an official
-standard defined by a recognized standards body, or, in the case of
-interfaces specified for a particular programming language, one that
-is widely used among developers working in that language.
-
- The "System Libraries" of an executable work include anything, other
-than the work as a whole, that (a) is included in the normal form of
-packaging a Major Component, but which is not part of that Major
-Component, and (b) serves only to enable use of the work with that
-Major Component, or to implement a Standard Interface for which an
-implementation is available to the public in source code form. A
-"Major Component", in this context, means a major essential component
-(kernel, window system, and so on) of the specific operating system
-(if any) on which the executable work runs, or a compiler used to
-produce the work, or an object code interpreter used to run it.
-
- The "Corresponding Source" for a work in object code form means all
-the source code needed to generate, install, and (for an executable
-work) run the object code and to modify the work, including scripts to
-control those activities. However, it does not include the work's
-System Libraries, or general-purpose tools or generally available free
-programs which are used unmodified in performing those activities but
-which are not part of the work. For example, Corresponding Source
-includes interface definition files associated with source files for
-the work, and the source code for shared libraries and dynamically
-linked subprograms that the work is specifically designed to require,
-such as by intimate data communication or control flow between those
-subprograms and other parts of the work.
-
- The Corresponding Source need not include anything that users
-can regenerate automatically from other parts of the Corresponding
-Source.
-
- The Corresponding Source for a work in source code form is that
-same work.
-
- 2. Basic Permissions.
-
- All rights granted under this License are granted for the term of
-copyright on the Program, and are irrevocable provided the stated
-conditions are met. This License explicitly affirms your unlimited
-permission to run the unmodified Program. The output from running a
-covered work is covered by this License only if the output, given its
-content, constitutes a covered work. This License acknowledges your
-rights of fair use or other equivalent, as provided by copyright law.
-
- You may make, run and propagate covered works that you do not
-convey, without conditions so long as your license otherwise remains
-in force. You may convey covered works to others for the sole purpose
-of having them make modifications exclusively for you, or provide you
-with facilities for running those works, provided that you comply with
-the terms of this License in conveying all material for which you do
-not control copyright. Those thus making or running the covered works
-for you must do so exclusively on your behalf, under your direction
-and control, on terms that prohibit them from making any copies of
-your copyrighted material outside their relationship with you.
-
- Conveying under any other circumstances is permitted solely under
-the conditions stated below. Sublicensing is not allowed; section 10
-makes it unnecessary.
-
- 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
-
- No covered work shall be deemed part of an effective technological
-measure under any applicable law fulfilling obligations under article
-11 of the WIPO copyright treaty adopted on 20 December 1996, or
-similar laws prohibiting or restricting circumvention of such
-measures.
-
- When you convey a covered work, you waive any legal power to forbid
-circumvention of technological measures to the extent such circumvention
-is effected by exercising rights under this License with respect to
-the covered work, and you disclaim any intention to limit operation or
-modification of the work as a means of enforcing, against the work's
-users, your or third parties' legal rights to forbid circumvention of
-technological measures.
-
- 4. Conveying Verbatim Copies.
-
- You may convey verbatim copies of the Program's source code as you
-receive it, in any medium, provided that you conspicuously and
-appropriately publish on each copy an appropriate copyright notice;
-keep intact all notices stating that this License and any
-non-permissive terms added in accord with section 7 apply to the code;
-keep intact all notices of the absence of any warranty; and give all
-recipients a copy of this License along with the Program.
-
- You may charge any price or no price for each copy that you convey,
-and you may offer support or warranty protection for a fee.
-
- 5. Conveying Modified Source Versions.
-
- You may convey a work based on the Program, or the modifications to
-produce it from the Program, in the form of source code under the
-terms of section 4, provided that you also meet all of these conditions:
-
- a) The work must carry prominent notices stating that you modified
- it, and giving a relevant date.
-
- b) The work must carry prominent notices stating that it is
- released under this License and any conditions added under section
- 7. This requirement modifies the requirement in section 4 to
- "keep intact all notices".
-
- c) You must license the entire work, as a whole, under this
- License to anyone who comes into possession of a copy. This
- License will therefore apply, along with any applicable section 7
- additional terms, to the whole of the work, and all its parts,
- regardless of how they are packaged. This License gives no
- permission to license the work in any other way, but it does not
- invalidate such permission if you have separately received it.
-
- d) If the work has interactive user interfaces, each must display
- Appropriate Legal Notices; however, if the Program has interactive
- interfaces that do not display Appropriate Legal Notices, your
- work need not make them do so.
-
- A compilation of a covered work with other separate and independent
-works, which are not by their nature extensions of the covered work,
-and which are not combined with it such as to form a larger program,
-in or on a volume of a storage or distribution medium, is called an
-"aggregate" if the compilation and its resulting copyright are not
-used to limit the access or legal rights of the compilation's users
-beyond what the individual works permit. Inclusion of a covered work
-in an aggregate does not cause this License to apply to the other
-parts of the aggregate.
-
- 6. Conveying Non-Source Forms.
-
- You may convey a covered work in object code form under the terms
-of sections 4 and 5, provided that you also convey the
-machine-readable Corresponding Source under the terms of this License,
-in one of these ways:
-
- a) Convey the object code in, or embodied in, a physical product
- (including a physical distribution medium), accompanied by the
- Corresponding Source fixed on a durable physical medium
- customarily used for software interchange.
-
- b) Convey the object code in, or embodied in, a physical product
- (including a physical distribution medium), accompanied by a
- written offer, valid for at least three years and valid for as
- long as you offer spare parts or customer support for that product
- model, to give anyone who possesses the object code either (1) a
- copy of the Corresponding Source for all the software in the
- product that is covered by this License, on a durable physical
- medium customarily used for software interchange, for a price no
- more than your reasonable cost of physically performing this
- conveying of source, or (2) access to copy the
- Corresponding Source from a network server at no charge.
-
- c) Convey individual copies of the object code with a copy of the
- written offer to provide the Corresponding Source. This
- alternative is allowed only occasionally and noncommercially, and
- only if you received the object code with such an offer, in accord
- with subsection 6b.
-
- d) Convey the object code by offering access from a designated
- place (gratis or for a charge), and offer equivalent access to the
- Corresponding Source in the same way through the same place at no
- further charge. You need not require recipients to copy the
- Corresponding Source along with the object code. If the place to
- copy the object code is a network server, the Corresponding Source
- may be on a different server (operated by you or a third party)
- that supports equivalent copying facilities, provided you maintain
- clear directions next to the object code saying where to find the
- Corresponding Source. Regardless of what server hosts the
- Corresponding Source, you remain obligated to ensure that it is
- available for as long as needed to satisfy these requirements.
-
- e) Convey the object code using peer-to-peer transmission, provided
- you inform other peers where the object code and Corresponding
- Source of the work are being offered to the general public at no
- charge under subsection 6d.
-
- A separable portion of the object code, whose source code is excluded
-from the Corresponding Source as a System Library, need not be
-included in conveying the object code work.
-
- A "User Product" is either (1) a "consumer product", which means any
-tangible personal property which is normally used for personal, family,
-or household purposes, or (2) anything designed or sold for incorporation
-into a dwelling. In determining whether a product is a consumer product,
-doubtful cases shall be resolved in favor of coverage. For a particular
-product received by a particular user, "normally used" refers to a
-typical or common use of that class of product, regardless of the status
-of the particular user or of the way in which the particular user
-actually uses, or expects or is expected to use, the product. A product
-is a consumer product regardless of whether the product has substantial
-commercial, industrial or non-consumer uses, unless such uses represent
-the only significant mode of use of the product.
-
- "Installation Information" for a User Product means any methods,
-procedures, authorization keys, or other information required to install
-and execute modified versions of a covered work in that User Product from
-a modified version of its Corresponding Source. The information must
-suffice to ensure that the continued functioning of the modified object
-code is in no case prevented or interfered with solely because
-modification has been made.
-
- If you convey an object code work under this section in, or with, or
-specifically for use in, a User Product, and the conveying occurs as
-part of a transaction in which the right of possession and use of the
-User Product is transferred to the recipient in perpetuity or for a
-fixed term (regardless of how the transaction is characterized), the
-Corresponding Source conveyed under this section must be accompanied
-by the Installation Information. But this requirement does not apply
-if neither you nor any third party retains the ability to install
-modified object code on the User Product (for example, the work has
-been installed in ROM).
-
- The requirement to provide Installation Information does not include a
-requirement to continue to provide support service, warranty, or updates
-for a work that has been modified or installed by the recipient, or for
-the User Product in which it has been modified or installed. Access to a
-network may be denied when the modification itself materially and
-adversely affects the operation of the network or violates the rules and
-protocols for communication across the network.
-
- Corresponding Source conveyed, and Installation Information provided,
-in accord with this section must be in a format that is publicly
-documented (and with an implementation available to the public in
-source code form), and must require no special password or key for
-unpacking, reading or copying.
-
- 7. Additional Terms.
-
- "Additional permissions" are terms that supplement the terms of this
-License by making exceptions from one or more of its conditions.
-Additional permissions that are applicable to the entire Program shall
-be treated as though they were included in this License, to the extent
-that they are valid under applicable law. If additional permissions
-apply only to part of the Program, that part may be used separately
-under those permissions, but the entire Program remains governed by
-this License without regard to the additional permissions.
-
- When you convey a copy of a covered work, you may at your option
-remove any additional permissions from that copy, or from any part of
-it. (Additional permissions may be written to require their own
-removal in certain cases when you modify the work.) You may place
-additional permissions on material, added by you to a covered work,
-for which you have or can give appropriate copyright permission.
-
- Notwithstanding any other provision of this License, for material you
-add to a covered work, you may (if authorized by the copyright holders of
-that material) supplement the terms of this License with terms:
-
- a) Disclaiming warranty or limiting liability differently from the
- terms of sections 15 and 16 of this License; or
-
- b) Requiring preservation of specified reasonable legal notices or
- author attributions in that material or in the Appropriate Legal
- Notices displayed by works containing it; or
-
- c) Prohibiting misrepresentation of the origin of that material, or
- requiring that modified versions of such material be marked in
- reasonable ways as different from the original version; or
-
- d) Limiting the use for publicity purposes of names of licensors or
- authors of the material; or
-
- e) Declining to grant rights under trademark law for use of some
- trade names, trademarks, or service marks; or
-
- f) Requiring indemnification of licensors and authors of that
- material by anyone who conveys the material (or modified versions of
- it) with contractual assumptions of liability to the recipient, for
- any liability that these contractual assumptions directly impose on
- those licensors and authors.
-
- All other non-permissive additional terms are considered "further
-restrictions" within the meaning of section 10. If the Program as you
-received it, or any part of it, contains a notice stating that it is
-governed by this License along with a term that is a further
-restriction, you may remove that term. If a license document contains
-a further restriction but permits relicensing or conveying under this
-License, you may add to a covered work material governed by the terms
-of that license document, provided that the further restriction does
-not survive such relicensing or conveying.
-
- If you add terms to a covered work in accord with this section, you
-must place, in the relevant source files, a statement of the
-additional terms that apply to those files, or a notice indicating
-where to find the applicable terms.
-
- Additional terms, permissive or non-permissive, may be stated in the
-form of a separately written license, or stated as exceptions;
-the above requirements apply either way.
-
- 8. Termination.
-
- You may not propagate or modify a covered work except as expressly
-provided under this License. Any attempt otherwise to propagate or
-modify it is void, and will automatically terminate your rights under
-this License (including any patent licenses granted under the third
-paragraph of section 11).
-
- However, if you cease all violation of this License, then your
-license from a particular copyright holder is reinstated (a)
-provisionally, unless and until the copyright holder explicitly and
-finally terminates your license, and (b) permanently, if the copyright
-holder fails to notify you of the violation by some reasonable means
-prior to 60 days after the cessation.
-
- Moreover, your license from a particular copyright holder is
-reinstated permanently if the copyright holder notifies you of the
-violation by some reasonable means, this is the first time you have
-received notice of violation of this License (for any work) from that
-copyright holder, and you cure the violation prior to 30 days after
-your receipt of the notice.
-
- Termination of your rights under this section does not terminate the
-licenses of parties who have received copies or rights from you under
-this License. If your rights have been terminated and not permanently
-reinstated, you do not qualify to receive new licenses for the same
-material under section 10.
-
- 9. Acceptance Not Required for Having Copies.
-
- You are not required to accept this License in order to receive or
-run a copy of the Program. Ancillary propagation of a covered work
-occurring solely as a consequence of using peer-to-peer transmission
-to receive a copy likewise does not require acceptance. However,
-nothing other than this License grants you permission to propagate or
-modify any covered work. These actions infringe copyright if you do
-not accept this License. Therefore, by modifying or propagating a
-covered work, you indicate your acceptance of this License to do so.
-
- 10. Automatic Licensing of Downstream Recipients.
-
- Each time you convey a covered work, the recipient automatically
-receives a license from the original licensors, to run, modify and
-propagate that work, subject to this License. You are not responsible
-for enforcing compliance by third parties with this License.
-
- An "entity transaction" is a transaction transferring control of an
-organization, or substantially all assets of one, or subdividing an
-organization, or merging organizations. If propagation of a covered
-work results from an entity transaction, each party to that
-transaction who receives a copy of the work also receives whatever
-licenses to the work the party's predecessor in interest had or could
-give under the previous paragraph, plus a right to possession of the
-Corresponding Source of the work from the predecessor in interest, if
-the predecessor has it or can get it with reasonable efforts.
-
- You may not impose any further restrictions on the exercise of the
-rights granted or affirmed under this License. For example, you may
-not impose a license fee, royalty, or other charge for exercise of
-rights granted under this License, and you may not initiate litigation
-(including a cross-claim or counterclaim in a lawsuit) alleging that
-any patent claim is infringed by making, using, selling, offering for
-sale, or importing the Program or any portion of it.
-
- 11. Patents.
-
- A "contributor" is a copyright holder who authorizes use under this
-License of the Program or a work on which the Program is based. The
-work thus licensed is called the contributor's "contributor version".
-
- A contributor's "essential patent claims" are all patent claims
-owned or controlled by the contributor, whether already acquired or
-hereafter acquired, that would be infringed by some manner, permitted
-by this License, of making, using, or selling its contributor version,
-but do not include claims that would be infringed only as a
-consequence of further modification of the contributor version. For
-purposes of this definition, "control" includes the right to grant
-patent sublicenses in a manner consistent with the requirements of
-this License.
-
- Each contributor grants you a non-exclusive, worldwide, royalty-free
-patent license under the contributor's essential patent claims, to
-make, use, sell, offer for sale, import and otherwise run, modify and
-propagate the contents of its contributor version.
-
- In the following three paragraphs, a "patent license" is any express
-agreement or commitment, however denominated, not to enforce a patent
-(such as an express permission to practice a patent or covenant not to
-sue for patent infringement). To "grant" such a patent license to a
-party means to make such an agreement or commitment not to enforce a
-patent against the party.
-
- If you convey a covered work, knowingly relying on a patent license,
-and the Corresponding Source of the work is not available for anyone
-to copy, free of charge and under the terms of this License, through a
-publicly available network server or other readily accessible means,
-then you must either (1) cause the Corresponding Source to be so
-available, or (2) arrange to deprive yourself of the benefit of the
-patent license for this particular work, or (3) arrange, in a manner
-consistent with the requirements of this License, to extend the patent
-license to downstream recipients. "Knowingly relying" means you have
-actual knowledge that, but for the patent license, your conveying the
-covered work in a country, or your recipient's use of the covered work
-in a country, would infringe one or more identifiable patents in that
-country that you have reason to believe are valid.
-
- If, pursuant to or in connection with a single transaction or
-arrangement, you convey, or propagate by procuring conveyance of, a
-covered work, and grant a patent license to some of the parties
-receiving the covered work authorizing them to use, propagate, modify
-or convey a specific copy of the covered work, then the patent license
-you grant is automatically extended to all recipients of the covered
-work and works based on it.
-
- A patent license is "discriminatory" if it does not include within
-the scope of its coverage, prohibits the exercise of, or is
-conditioned on the non-exercise of one or more of the rights that are
-specifically granted under this License. You may not convey a covered
-work if you are a party to an arrangement with a third party that is
-in the business of distributing software, under which you make payment
-to the third party based on the extent of your activity of conveying
-the work, and under which the third party grants, to any of the
-parties who would receive the covered work from you, a discriminatory
-patent license (a) in connection with copies of the covered work
-conveyed by you (or copies made from those copies), or (b) primarily
-for and in connection with specific products or compilations that
-contain the covered work, unless you entered into that arrangement,
-or that patent license was granted, prior to 28 March 2007.
-
- Nothing in this License shall be construed as excluding or limiting
-any implied license or other defenses to infringement that may
-otherwise be available to you under applicable patent law.
-
- 12. No Surrender of Others' Freedom.
-
- If conditions are imposed on you (whether by court order, agreement or
-otherwise) that contradict the conditions of this License, they do not
-excuse you from the conditions of this License. If you cannot convey a
-covered work so as to satisfy simultaneously your obligations under this
-License and any other pertinent obligations, then as a consequence you may
-not convey it at all. For example, if you agree to terms that obligate you
-to collect a royalty for further conveying from those to whom you convey
-the Program, the only way you could satisfy both those terms and this
-License would be to refrain entirely from conveying the Program.
-
- 13. Use with the GNU Affero General Public License.
-
- Notwithstanding any other provision of this License, you have
-permission to link or combine any covered work with a work licensed
-under version 3 of the GNU Affero General Public License into a single
-combined work, and to convey the resulting work. The terms of this
-License will continue to apply to the part which is the covered work,
-but the special requirements of the GNU Affero General Public License,
-section 13, concerning interaction through a network will apply to the
-combination as such.
-
- 14. Revised Versions of this License.
-
- The Free Software Foundation may publish revised and/or new versions of
-the GNU General Public License from time to time. Such new versions will
-be similar in spirit to the present version, but may differ in detail to
-address new problems or concerns.
-
- Each version is given a distinguishing version number. If the
-Program specifies that a certain numbered version of the GNU General
-Public License "or any later version" applies to it, you have the
-option of following the terms and conditions either of that numbered
-version or of any later version published by the Free Software
-Foundation. If the Program does not specify a version number of the
-GNU General Public License, you may choose any version ever published
-by the Free Software Foundation.
-
- If the Program specifies that a proxy can decide which future
-versions of the GNU General Public License can be used, that proxy's
-public statement of acceptance of a version permanently authorizes you
-to choose that version for the Program.
-
- Later license versions may give you additional or different
-permissions. However, no additional obligations are imposed on any
-author or copyright holder as a result of your choosing to follow a
-later version.
-
- 15. Disclaimer of Warranty.
-
- THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
-APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
-HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
-OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
-THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
-IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
-ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
-
- 16. Limitation of Liability.
-
- IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
-WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
-THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
-GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
-USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
-DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
-PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
-EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
-SUCH DAMAGES.
-
- 17. Interpretation of Sections 15 and 16.
-
- If the disclaimer of warranty and limitation of liability provided
-above cannot be given local legal effect according to their terms,
-reviewing courts shall apply local law that most closely approximates
-an absolute waiver of all civil liability in connection with the
-Program, unless a warranty or assumption of liability accompanies a
-copy of the Program in return for a fee.
-
- END OF TERMS AND CONDITIONS
-
- How to Apply These Terms to Your New Programs
-
- If you develop a new program, and you want it to be of the greatest
-possible use to the public, the best way to achieve this is to make it
-free software which everyone can redistribute and change under these terms.
-
- To do so, attach the following notices to the program. It is safest
-to attach them to the start of each source file to most effectively
-state the exclusion of warranty; and each file should have at least
-the "copyright" line and a pointer to where the full notice is found.
-
- <one line to give the program's name and a brief idea of what it does.>
- Copyright (C) <year> <name of author>
-
- This program is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation, either version 3 of the License, or
- (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program. If not, see <https://www.gnu.org/licenses/>.
-
-Also add information on how to contact you by electronic and paper mail.
-
- If the program does terminal interaction, make it output a short
-notice like this when it starts in an interactive mode:
-
- <program> Copyright (C) <year> <name of author>
- This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
- This is free software, and you are welcome to redistribute it
- under certain conditions; type `show c' for details.
-
-The hypothetical commands `show w' and `show c' should show the appropriate
-parts of the General Public License. Of course, your program's commands
-might be different; for a GUI interface, you would use an "about box".
-
- You should also get your employer (if you work as a programmer) or school,
-if any, to sign a "copyright disclaimer" for the program, if necessary.
-For more information on this, and how to apply and follow the GNU GPL, see
-<https://www.gnu.org/licenses/>.
-
- The GNU General Public License does not permit incorporating your program
-into proprietary programs. If your program is a subroutine library, you
-may consider it more useful to permit linking proprietary applications with
-the library. If this is what you want to do, use the GNU Lesser General
-Public License instead of this License. But first, please read
-<https://www.gnu.org/licenses/why-not-lgpl.html>.
diff --git a/tests/CMakeLists.txt b/tests/CMakeLists.txt
new file mode 100644
index 0000000..65b610f
--- /dev/null
+++ b/tests/CMakeLists.txt
@@ -0,0 +1,174 @@
+cmake_minimum_required(VERSION 3.13)
+
+option(JSON_Valgrind "Execute test suite with Valgrind." OFF)
+option(JSON_FastTests "Skip expensive/slow tests." 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)
+
+#############################################################################
+# override standard support
+#############################################################################
+
+# Clang only supports C++17 starting from Clang 5.0
+if (CMAKE_CXX_COMPILER_ID STREQUAL "Clang" AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 5.0)
+ unset(compiler_supports_cpp_17)
+endif()
+# MSVC 2015 (14.0) does not support C++17
+if (CMAKE_CXX_COMPILER_ID STREQUAL "MSVC" AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 19.1)
+ unset(compiler_supports_cpp_17)
+endif()
+
+# Clang C++20 support appears insufficient prior to Clang 9.0 (based on CI build failure)
+if (CMAKE_CXX_COMPILER_ID STREQUAL "Clang" AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 9.0)
+ unset(compiler_supports_cpp_20)
+endif()
+# GCC started supporting C++20 features in 8.0 but a test for #3070 segfaults prior to 9.0
+if (CMAKE_CXX_COMPILER_ID STREQUAL "GNU" AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 9.0)
+ unset(compiler_supports_cpp_20)
+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
+ 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>
+
+ # 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
+ thirdparty/fifo_map
+ ${PROJECT_BINARY_DIR}/include)
+target_link_libraries(test_main PUBLIC ${NLOHMANN_JSON_TARGET_NAME})
+
+#############################################################################
+# define test- and standard-specific build settings
+#############################################################################
+
+if (CMAKE_CXX_COMPILER_ID STREQUAL "GNU"
+ AND CMAKE_CXX_COMPILER_VERSION VERSION_GREATER_EQUAL 8.0
+ AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 9.0 AND NOT MINGW)
+ # fix for https://gcc.gnu.org/bugzilla/show_bug.cgi?id=90050
+ json_test_set_test_options(all CXX_STANDARDS 17 LINK_LIBRARIES stdc++fs)
+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;test-binary_formats" LINK_OPTIONS /STACK:4000000)
+endif()
+
+# disable exceptions for test-disabled_exceptions
+json_test_set_test_options(test-disabled_exceptions
+ COMPILE_DEFINITIONS
+ JSON_NOEXCEPTION
+ # disabled due to https://github.com/nlohmann/json/discussions/2824
+ #$<$<CXX_COMPILER_ID:MSVC>:_HAS_EXCEPTIONS=0>
+ COMPILE_OPTIONS
+ $<$<CXX_COMPILER_ID:AppleClang>:-fno-exceptions> $<$<CXX_COMPILER_ID:Clang>:-fno-exceptions>
+ $<$<CXX_COMPILER_ID:GNU>:-fno-exceptions>
+ $<$<CXX_COMPILER_ID:Intel>:-fno-exceptions> $<$<CXX_COMPILER_ID:IntelLLVM>:-fno-exceptions>
+ # disabled due to https://github.com/nlohmann/json/discussions/2824
+ #$<$<CXX_COMPILER_ID:MSVC>:/EH>
+)
+
+# raise timeout of expensive Unicode test
+json_test_set_test_options(test-unicode4 TEST_PROPERTIES TIMEOUT 3000)
+
+#############################################################################
+# add unit tests
+#############################################################################
+
+if("${JSON_TestStandards}" STREQUAL "")
+ set(test_cxx_standards 11 14 17 20 23)
+ unset(test_force)
+else()
+ set(test_cxx_standards ${JSON_TestStandards})
+ set(test_force FORCE)
+endif()
+
+# Print selected standards marking unavailable ones with brackets
+set(msg_standards "")
+foreach(cxx_standard ${test_cxx_standards})
+ if(compiler_supports_cpp_${cxx_standard})
+ list(APPEND msg_standards ${cxx_standard})
+ else()
+ list(APPEND msg_standards [${cxx_standard}])
+ endif()
+endforeach()
+string(JOIN " " msg_standards ${msg_standards})
+set(msg "Testing standards: ${msg_standards}")
+if(test_force)
+ string(APPEND msg " (forced)")
+endif()
+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)
+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_32bit_test_only)
+ # Skip all other tests in this file
+ return()
+endif()
+
+# 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
+
+#############################################################################
+# test ABI compatibility
+#############################################################################
+
+add_subdirectory(abi)
+
+#############################################################################
+# Test the generated build configs
+#############################################################################
+
+# these tests depend on the generated file nlohmann_jsonConfig.cmake
+if (JSON_Install)
+ add_subdirectory(cmake_import)
+ add_subdirectory(cmake_import_minver)
+endif()
+
+add_subdirectory(cmake_add_subdirectory)
+add_subdirectory(cmake_fetch_content)
+add_subdirectory(cmake_fetch_content2)
+add_subdirectory(cmake_target_include_directories)
diff --git a/test/Makefile b/tests/Makefile
similarity index 86%
rename from test/Makefile
rename to tests/Makefile
index 2d08a8f..3a11ce7 100644
--- a/test/Makefile
+++ b/tests/Makefile
@@ -10,7 +10,7 @@
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_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/tests/abi/CMakeLists.txt b/tests/abi/CMakeLists.txt
new file mode 100644
index 0000000..c1ae543
--- /dev/null
+++ b/tests/abi/CMakeLists.txt
@@ -0,0 +1,29 @@
+# common build settings
+add_library(abi_compat_common INTERFACE)
+target_compile_definitions(abi_compat_common INTERFACE
+ DOCTEST_CONFIG_SUPER_FAST_ASSERTS
+ JSON_TEST_KEEP_MACROS)
+target_compile_features(abi_compat_common INTERFACE cxx_std_11)
+target_compile_options(abi_compat_common INTERFACE
+ $<$<CXX_COMPILER_ID:MSVC>:/EHsc;$<$<CONFIG:Release>:/Od>>
+ # MSVC: Force to always compile with W4
+ $<$<CXX_COMPILER_ID:MSVC>:/W4>
+
+ # 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(abi_compat_common SYSTEM INTERFACE
+ ../thirdparty/doctest
+ include)
+target_link_libraries(abi_compat_common INTERFACE ${NLOHMANN_JSON_TARGET_NAME})
+
+# shared main()
+add_library(abi_compat_main STATIC main.cpp)
+target_link_libraries(abi_compat_main PUBLIC abi_compat_common)
+
+# add individual tests
+add_subdirectory(diag)
+add_subdirectory(inline_ns)
diff --git a/tests/abi/diag/CMakeLists.txt b/tests/abi/diag/CMakeLists.txt
new file mode 100644
index 0000000..3935ff1
--- /dev/null
+++ b/tests/abi/diag/CMakeLists.txt
@@ -0,0 +1,19 @@
+# test linking library built with different JSON_DIAGNOSTICS setting
+# into the same executable
+
+# compile code using JSON_DIAGNOSTICS=1
+add_library(abi_compat_diag_on STATIC diag_on.cpp)
+target_link_libraries(abi_compat_diag_on PUBLIC abi_compat_common)
+
+# compile code using JSON_DIAGNOSTICS=0
+add_library(abi_compat_diag_off STATIC diag_off.cpp)
+target_link_libraries(abi_compat_diag_off PUBLIC abi_compat_common)
+
+# build test executable and add test
+add_executable(abi_compat_diag diag.cpp)
+target_link_libraries(abi_compat_diag PRIVATE
+ abi_compat_main abi_compat_diag_on abi_compat_diag_off)
+
+add_test(
+ NAME test-abi_compat_diag
+ COMMAND abi_compat_diag ${DOCTEST_TEST_FILTER})
diff --git a/tests/abi/diag/diag.cpp b/tests/abi/diag/diag.cpp
new file mode 100644
index 0000000..94d135d
--- /dev/null
+++ b/tests/abi/diag/diag.cpp
@@ -0,0 +1,29 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#include "diag.hpp"
+
+TEST_CASE("ABI compatible diagnostics")
+{
+ SECTION("basic_json size")
+ {
+ // basic_json with diagnostics is larger because of added data members
+ CHECK(json_sizeof_diag_on() == json_sizeof_diag_on_explicit());
+ CHECK(json_sizeof_diag_off() == json_sizeof_diag_off_explicit());
+ CHECK(json_sizeof_diag_on() > json_sizeof_diag_off());
+ }
+
+ SECTION("basic_json at")
+ {
+ // accessing a nonexistent key throws different exception with diagnostics
+ CHECK_THROWS_WITH(json_at_diag_on(), "[json.exception.out_of_range.403] (/foo) key 'bar' not found");
+ CHECK_THROWS_WITH(json_at_diag_off(), "[json.exception.out_of_range.403] key 'bar' not found");
+ }
+}
diff --git a/tests/abi/diag/diag.hpp b/tests/abi/diag/diag.hpp
new file mode 100644
index 0000000..8d06acd
--- /dev/null
+++ b/tests/abi/diag/diag.hpp
@@ -0,0 +1,20 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include <cstddef>
+
+std::size_t json_sizeof_diag_on();
+std::size_t json_sizeof_diag_on_explicit();
+
+std::size_t json_sizeof_diag_off();
+std::size_t json_sizeof_diag_off_explicit();
+
+void json_at_diag_on();
+void json_at_diag_off();
diff --git a/tests/abi/diag/diag_off.cpp b/tests/abi/diag/diag_off.cpp
new file mode 100644
index 0000000..045b70a
--- /dev/null
+++ b/tests/abi/diag/diag_off.cpp
@@ -0,0 +1,30 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#undef JSON_DIAGNOSTICS
+#define JSON_DIAGNOSTICS 0
+#include <nlohmann/json.hpp>
+
+#include "diag.hpp"
+
+std::size_t json_sizeof_diag_off()
+{
+ return sizeof(nlohmann::json);
+}
+
+std::size_t json_sizeof_diag_off_explicit()
+{
+ return sizeof(::NLOHMANN_JSON_NAMESPACE::json);
+}
+
+void json_at_diag_off()
+{
+ using nlohmann::json;
+ json j = json{{"foo", json::object()}};
+ j.at(json::json_pointer("/foo/bar"));
+}
diff --git a/tests/abi/diag/diag_on.cpp b/tests/abi/diag/diag_on.cpp
new file mode 100644
index 0000000..1df606c
--- /dev/null
+++ b/tests/abi/diag/diag_on.cpp
@@ -0,0 +1,30 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#undef JSON_DIAGNOSTICS
+#define JSON_DIAGNOSTICS 1
+#include <nlohmann/json.hpp>
+
+#include "diag.hpp"
+
+std::size_t json_sizeof_diag_on()
+{
+ return sizeof(nlohmann::json);
+}
+
+std::size_t json_sizeof_diag_on_explicit()
+{
+ return sizeof(::NLOHMANN_JSON_NAMESPACE::json);
+}
+
+void json_at_diag_on()
+{
+ using nlohmann::json;
+ json j = json{{"foo", json::object()}};
+ j.at(json::json_pointer("/foo/bar"));
+}
diff --git a/tests/abi/include/nlohmann/json_v3_10_5.hpp b/tests/abi/include/nlohmann/json_v3_10_5.hpp
new file mode 100644
index 0000000..cb27e05
--- /dev/null
+++ b/tests/abi/include/nlohmann/json_v3_10_5.hpp
@@ -0,0 +1,22091 @@
+/*
+ __ _____ _____ _____
+ __| | __| | | | JSON for Modern C++
+| | |__ | | | | | | 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.
+*/
+
+/****************************************************************************\
+ * Note on documentation: The source files contain links to the online *
+ * documentation of the public API at https://json.nlohmann.me. This URL *
+ * 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. *
+\****************************************************************************/
+
+#ifndef INCLUDE_NLOHMANN_JSON_HPP_
+#define INCLUDE_NLOHMANN_JSON_HPP_
+
+#define NLOHMANN_JSON_VERSION_MAJOR 3
+#define NLOHMANN_JSON_VERSION_MINOR 10
+#define NLOHMANN_JSON_VERSION_PATCH 5
+
+#include <algorithm> // all_of, find, for_each
+#include <cstddef> // nullptr_t, ptrdiff_t, size_t
+#include <functional> // hash, less
+#include <initializer_list> // initializer_list
+#ifndef JSON_NO_IO
+ #include <iosfwd> // istream, ostream
+#endif // JSON_NO_IO
+#include <iterator> // random_access_iterator_tag
+#include <memory> // unique_ptr
+#include <numeric> // accumulate
+#include <string> // string, stoi, to_string
+#include <utility> // declval, forward, move, pair, swap
+#include <vector> // vector
+
+// #include <nlohmann/adl_serializer.hpp>
+
+
+#include <type_traits>
+#include <utility>
+
+// #include <nlohmann/detail/conversions/from_json.hpp>
+
+
+#include <algorithm> // transform
+#include <array> // array
+#include <forward_list> // forward_list
+#include <iterator> // inserter, front_inserter, end
+#include <map> // map
+#include <string> // string
+#include <tuple> // tuple, make_tuple
+#include <type_traits> // is_arithmetic, is_same, is_enum, underlying_type, is_convertible
+#include <unordered_map> // unordered_map
+#include <utility> // pair, declval
+#include <valarray> // valarray
+
+// #include <nlohmann/detail/exceptions.hpp>
+
+
+#include <exception> // exception
+#include <stdexcept> // runtime_error
+#include <string> // to_string
+#include <vector> // vector
+
+// #include <nlohmann/detail/value_t.hpp>
+
+
+#include <array> // array
+#include <cstddef> // size_t
+#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 <string>
+// #include <nlohmann/detail/macro_scope.hpp>
+
+
+#include <utility> // declval, pair
+// #include <nlohmann/thirdparty/hedley/hedley.hpp>
+
+
+/* Hedley - https://nemequ.github.io/hedley
+ * Created by Evan Nemerson <evan@nemerson.com>
+ *
+ * To the extent possible under law, the author(s) have dedicated all
+ * copyright and related and neighboring rights to this software to
+ * the public domain worldwide. This software is distributed without
+ * any warranty.
+ *
+ * For details, see <http://creativecommons.org/publicdomain/zero/1.0/>.
+ * SPDX-License-Identifier: CC0-1.0
+ */
+
+#if !defined(JSON_HEDLEY_VERSION) || (JSON_HEDLEY_VERSION < 15)
+#if defined(JSON_HEDLEY_VERSION)
+ #undef JSON_HEDLEY_VERSION
+#endif
+#define JSON_HEDLEY_VERSION 15
+
+#if defined(JSON_HEDLEY_STRINGIFY_EX)
+ #undef JSON_HEDLEY_STRINGIFY_EX
+#endif
+#define JSON_HEDLEY_STRINGIFY_EX(x) #x
+
+#if defined(JSON_HEDLEY_STRINGIFY)
+ #undef JSON_HEDLEY_STRINGIFY
+#endif
+#define JSON_HEDLEY_STRINGIFY(x) JSON_HEDLEY_STRINGIFY_EX(x)
+
+#if defined(JSON_HEDLEY_CONCAT_EX)
+ #undef JSON_HEDLEY_CONCAT_EX
+#endif
+#define JSON_HEDLEY_CONCAT_EX(a,b) a##b
+
+#if defined(JSON_HEDLEY_CONCAT)
+ #undef JSON_HEDLEY_CONCAT
+#endif
+#define JSON_HEDLEY_CONCAT(a,b) JSON_HEDLEY_CONCAT_EX(a,b)
+
+#if defined(JSON_HEDLEY_CONCAT3_EX)
+ #undef JSON_HEDLEY_CONCAT3_EX
+#endif
+#define JSON_HEDLEY_CONCAT3_EX(a,b,c) a##b##c
+
+#if defined(JSON_HEDLEY_CONCAT3)
+ #undef JSON_HEDLEY_CONCAT3
+#endif
+#define JSON_HEDLEY_CONCAT3(a,b,c) JSON_HEDLEY_CONCAT3_EX(a,b,c)
+
+#if defined(JSON_HEDLEY_VERSION_ENCODE)
+ #undef JSON_HEDLEY_VERSION_ENCODE
+#endif
+#define JSON_HEDLEY_VERSION_ENCODE(major,minor,revision) (((major) * 1000000) + ((minor) * 1000) + (revision))
+
+#if defined(JSON_HEDLEY_VERSION_DECODE_MAJOR)
+ #undef JSON_HEDLEY_VERSION_DECODE_MAJOR
+#endif
+#define JSON_HEDLEY_VERSION_DECODE_MAJOR(version) ((version) / 1000000)
+
+#if defined(JSON_HEDLEY_VERSION_DECODE_MINOR)
+ #undef JSON_HEDLEY_VERSION_DECODE_MINOR
+#endif
+#define JSON_HEDLEY_VERSION_DECODE_MINOR(version) (((version) % 1000000) / 1000)
+
+#if defined(JSON_HEDLEY_VERSION_DECODE_REVISION)
+ #undef JSON_HEDLEY_VERSION_DECODE_REVISION
+#endif
+#define JSON_HEDLEY_VERSION_DECODE_REVISION(version) ((version) % 1000)
+
+#if defined(JSON_HEDLEY_GNUC_VERSION)
+ #undef JSON_HEDLEY_GNUC_VERSION
+#endif
+#if defined(__GNUC__) && defined(__GNUC_PATCHLEVEL__)
+ #define JSON_HEDLEY_GNUC_VERSION JSON_HEDLEY_VERSION_ENCODE(__GNUC__, __GNUC_MINOR__, __GNUC_PATCHLEVEL__)
+#elif defined(__GNUC__)
+ #define JSON_HEDLEY_GNUC_VERSION JSON_HEDLEY_VERSION_ENCODE(__GNUC__, __GNUC_MINOR__, 0)
+#endif
+
+#if defined(JSON_HEDLEY_GNUC_VERSION_CHECK)
+ #undef JSON_HEDLEY_GNUC_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_GNUC_VERSION)
+ #define JSON_HEDLEY_GNUC_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_GNUC_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_GNUC_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_MSVC_VERSION)
+ #undef JSON_HEDLEY_MSVC_VERSION
+#endif
+#if defined(_MSC_FULL_VER) && (_MSC_FULL_VER >= 140000000) && !defined(__ICL)
+ #define JSON_HEDLEY_MSVC_VERSION JSON_HEDLEY_VERSION_ENCODE(_MSC_FULL_VER / 10000000, (_MSC_FULL_VER % 10000000) / 100000, (_MSC_FULL_VER % 100000) / 100)
+#elif defined(_MSC_FULL_VER) && !defined(__ICL)
+ #define JSON_HEDLEY_MSVC_VERSION JSON_HEDLEY_VERSION_ENCODE(_MSC_FULL_VER / 1000000, (_MSC_FULL_VER % 1000000) / 10000, (_MSC_FULL_VER % 10000) / 10)
+#elif defined(_MSC_VER) && !defined(__ICL)
+ #define JSON_HEDLEY_MSVC_VERSION JSON_HEDLEY_VERSION_ENCODE(_MSC_VER / 100, _MSC_VER % 100, 0)
+#endif
+
+#if defined(JSON_HEDLEY_MSVC_VERSION_CHECK)
+ #undef JSON_HEDLEY_MSVC_VERSION_CHECK
+#endif
+#if !defined(JSON_HEDLEY_MSVC_VERSION)
+ #define JSON_HEDLEY_MSVC_VERSION_CHECK(major,minor,patch) (0)
+#elif defined(_MSC_VER) && (_MSC_VER >= 1400)
+ #define JSON_HEDLEY_MSVC_VERSION_CHECK(major,minor,patch) (_MSC_FULL_VER >= ((major * 10000000) + (minor * 100000) + (patch)))
+#elif defined(_MSC_VER) && (_MSC_VER >= 1200)
+ #define JSON_HEDLEY_MSVC_VERSION_CHECK(major,minor,patch) (_MSC_FULL_VER >= ((major * 1000000) + (minor * 10000) + (patch)))
+#else
+ #define JSON_HEDLEY_MSVC_VERSION_CHECK(major,minor,patch) (_MSC_VER >= ((major * 100) + (minor)))
+#endif
+
+#if defined(JSON_HEDLEY_INTEL_VERSION)
+ #undef JSON_HEDLEY_INTEL_VERSION
+#endif
+#if defined(__INTEL_COMPILER) && defined(__INTEL_COMPILER_UPDATE) && !defined(__ICL)
+ #define JSON_HEDLEY_INTEL_VERSION JSON_HEDLEY_VERSION_ENCODE(__INTEL_COMPILER / 100, __INTEL_COMPILER % 100, __INTEL_COMPILER_UPDATE)
+#elif defined(__INTEL_COMPILER) && !defined(__ICL)
+ #define JSON_HEDLEY_INTEL_VERSION JSON_HEDLEY_VERSION_ENCODE(__INTEL_COMPILER / 100, __INTEL_COMPILER % 100, 0)
+#endif
+
+#if defined(JSON_HEDLEY_INTEL_VERSION_CHECK)
+ #undef JSON_HEDLEY_INTEL_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_INTEL_VERSION)
+ #define JSON_HEDLEY_INTEL_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_INTEL_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_INTEL_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_INTEL_CL_VERSION)
+ #undef JSON_HEDLEY_INTEL_CL_VERSION
+#endif
+#if defined(__INTEL_COMPILER) && defined(__INTEL_COMPILER_UPDATE) && defined(__ICL)
+ #define JSON_HEDLEY_INTEL_CL_VERSION JSON_HEDLEY_VERSION_ENCODE(__INTEL_COMPILER, __INTEL_COMPILER_UPDATE, 0)
+#endif
+
+#if defined(JSON_HEDLEY_INTEL_CL_VERSION_CHECK)
+ #undef JSON_HEDLEY_INTEL_CL_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_INTEL_CL_VERSION)
+ #define JSON_HEDLEY_INTEL_CL_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_INTEL_CL_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_INTEL_CL_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_PGI_VERSION)
+ #undef JSON_HEDLEY_PGI_VERSION
+#endif
+#if defined(__PGI) && defined(__PGIC__) && defined(__PGIC_MINOR__) && defined(__PGIC_PATCHLEVEL__)
+ #define JSON_HEDLEY_PGI_VERSION JSON_HEDLEY_VERSION_ENCODE(__PGIC__, __PGIC_MINOR__, __PGIC_PATCHLEVEL__)
+#endif
+
+#if defined(JSON_HEDLEY_PGI_VERSION_CHECK)
+ #undef JSON_HEDLEY_PGI_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_PGI_VERSION)
+ #define JSON_HEDLEY_PGI_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_PGI_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_PGI_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_SUNPRO_VERSION)
+ #undef JSON_HEDLEY_SUNPRO_VERSION
+#endif
+#if defined(__SUNPRO_C) && (__SUNPRO_C > 0x1000)
+ #define JSON_HEDLEY_SUNPRO_VERSION JSON_HEDLEY_VERSION_ENCODE((((__SUNPRO_C >> 16) & 0xf) * 10) + ((__SUNPRO_C >> 12) & 0xf), (((__SUNPRO_C >> 8) & 0xf) * 10) + ((__SUNPRO_C >> 4) & 0xf), (__SUNPRO_C & 0xf) * 10)
+#elif defined(__SUNPRO_C)
+ #define JSON_HEDLEY_SUNPRO_VERSION JSON_HEDLEY_VERSION_ENCODE((__SUNPRO_C >> 8) & 0xf, (__SUNPRO_C >> 4) & 0xf, (__SUNPRO_C) & 0xf)
+#elif defined(__SUNPRO_CC) && (__SUNPRO_CC > 0x1000)
+ #define JSON_HEDLEY_SUNPRO_VERSION JSON_HEDLEY_VERSION_ENCODE((((__SUNPRO_CC >> 16) & 0xf) * 10) + ((__SUNPRO_CC >> 12) & 0xf), (((__SUNPRO_CC >> 8) & 0xf) * 10) + ((__SUNPRO_CC >> 4) & 0xf), (__SUNPRO_CC & 0xf) * 10)
+#elif defined(__SUNPRO_CC)
+ #define JSON_HEDLEY_SUNPRO_VERSION JSON_HEDLEY_VERSION_ENCODE((__SUNPRO_CC >> 8) & 0xf, (__SUNPRO_CC >> 4) & 0xf, (__SUNPRO_CC) & 0xf)
+#endif
+
+#if defined(JSON_HEDLEY_SUNPRO_VERSION_CHECK)
+ #undef JSON_HEDLEY_SUNPRO_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_SUNPRO_VERSION)
+ #define JSON_HEDLEY_SUNPRO_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_SUNPRO_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_SUNPRO_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_EMSCRIPTEN_VERSION)
+ #undef JSON_HEDLEY_EMSCRIPTEN_VERSION
+#endif
+#if defined(__EMSCRIPTEN__)
+ #define JSON_HEDLEY_EMSCRIPTEN_VERSION JSON_HEDLEY_VERSION_ENCODE(__EMSCRIPTEN_major__, __EMSCRIPTEN_minor__, __EMSCRIPTEN_tiny__)
+#endif
+
+#if defined(JSON_HEDLEY_EMSCRIPTEN_VERSION_CHECK)
+ #undef JSON_HEDLEY_EMSCRIPTEN_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_EMSCRIPTEN_VERSION)
+ #define JSON_HEDLEY_EMSCRIPTEN_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_EMSCRIPTEN_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_EMSCRIPTEN_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_ARM_VERSION)
+ #undef JSON_HEDLEY_ARM_VERSION
+#endif
+#if defined(__CC_ARM) && defined(__ARMCOMPILER_VERSION)
+ #define JSON_HEDLEY_ARM_VERSION JSON_HEDLEY_VERSION_ENCODE(__ARMCOMPILER_VERSION / 1000000, (__ARMCOMPILER_VERSION % 1000000) / 10000, (__ARMCOMPILER_VERSION % 10000) / 100)
+#elif defined(__CC_ARM) && defined(__ARMCC_VERSION)
+ #define JSON_HEDLEY_ARM_VERSION JSON_HEDLEY_VERSION_ENCODE(__ARMCC_VERSION / 1000000, (__ARMCC_VERSION % 1000000) / 10000, (__ARMCC_VERSION % 10000) / 100)
+#endif
+
+#if defined(JSON_HEDLEY_ARM_VERSION_CHECK)
+ #undef JSON_HEDLEY_ARM_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_ARM_VERSION)
+ #define JSON_HEDLEY_ARM_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_ARM_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_ARM_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_IBM_VERSION)
+ #undef JSON_HEDLEY_IBM_VERSION
+#endif
+#if defined(__ibmxl__)
+ #define JSON_HEDLEY_IBM_VERSION JSON_HEDLEY_VERSION_ENCODE(__ibmxl_version__, __ibmxl_release__, __ibmxl_modification__)
+#elif defined(__xlC__) && defined(__xlC_ver__)
+ #define JSON_HEDLEY_IBM_VERSION JSON_HEDLEY_VERSION_ENCODE(__xlC__ >> 8, __xlC__ & 0xff, (__xlC_ver__ >> 8) & 0xff)
+#elif defined(__xlC__)
+ #define JSON_HEDLEY_IBM_VERSION JSON_HEDLEY_VERSION_ENCODE(__xlC__ >> 8, __xlC__ & 0xff, 0)
+#endif
+
+#if defined(JSON_HEDLEY_IBM_VERSION_CHECK)
+ #undef JSON_HEDLEY_IBM_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_IBM_VERSION)
+ #define JSON_HEDLEY_IBM_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_IBM_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_IBM_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_TI_VERSION)
+ #undef JSON_HEDLEY_TI_VERSION
+#endif
+#if \
+ defined(__TI_COMPILER_VERSION__) && \
+ ( \
+ defined(__TMS470__) || defined(__TI_ARM__) || \
+ defined(__MSP430__) || \
+ defined(__TMS320C2000__) \
+ )
+#if (__TI_COMPILER_VERSION__ >= 16000000)
+ #define JSON_HEDLEY_TI_VERSION JSON_HEDLEY_VERSION_ENCODE(__TI_COMPILER_VERSION__ / 1000000, (__TI_COMPILER_VERSION__ % 1000000) / 1000, (__TI_COMPILER_VERSION__ % 1000))
+#endif
+#endif
+
+#if defined(JSON_HEDLEY_TI_VERSION_CHECK)
+ #undef JSON_HEDLEY_TI_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_TI_VERSION)
+ #define JSON_HEDLEY_TI_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_TI_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_TI_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_TI_CL2000_VERSION)
+ #undef JSON_HEDLEY_TI_CL2000_VERSION
+#endif
+#if defined(__TI_COMPILER_VERSION__) && defined(__TMS320C2000__)
+ #define JSON_HEDLEY_TI_CL2000_VERSION JSON_HEDLEY_VERSION_ENCODE(__TI_COMPILER_VERSION__ / 1000000, (__TI_COMPILER_VERSION__ % 1000000) / 1000, (__TI_COMPILER_VERSION__ % 1000))
+#endif
+
+#if defined(JSON_HEDLEY_TI_CL2000_VERSION_CHECK)
+ #undef JSON_HEDLEY_TI_CL2000_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_TI_CL2000_VERSION)
+ #define JSON_HEDLEY_TI_CL2000_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_TI_CL2000_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_TI_CL2000_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_TI_CL430_VERSION)
+ #undef JSON_HEDLEY_TI_CL430_VERSION
+#endif
+#if defined(__TI_COMPILER_VERSION__) && defined(__MSP430__)
+ #define JSON_HEDLEY_TI_CL430_VERSION JSON_HEDLEY_VERSION_ENCODE(__TI_COMPILER_VERSION__ / 1000000, (__TI_COMPILER_VERSION__ % 1000000) / 1000, (__TI_COMPILER_VERSION__ % 1000))
+#endif
+
+#if defined(JSON_HEDLEY_TI_CL430_VERSION_CHECK)
+ #undef JSON_HEDLEY_TI_CL430_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_TI_CL430_VERSION)
+ #define JSON_HEDLEY_TI_CL430_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_TI_CL430_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_TI_CL430_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_TI_ARMCL_VERSION)
+ #undef JSON_HEDLEY_TI_ARMCL_VERSION
+#endif
+#if defined(__TI_COMPILER_VERSION__) && (defined(__TMS470__) || defined(__TI_ARM__))
+ #define JSON_HEDLEY_TI_ARMCL_VERSION JSON_HEDLEY_VERSION_ENCODE(__TI_COMPILER_VERSION__ / 1000000, (__TI_COMPILER_VERSION__ % 1000000) / 1000, (__TI_COMPILER_VERSION__ % 1000))
+#endif
+
+#if defined(JSON_HEDLEY_TI_ARMCL_VERSION_CHECK)
+ #undef JSON_HEDLEY_TI_ARMCL_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_TI_ARMCL_VERSION)
+ #define JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_TI_ARMCL_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_TI_CL6X_VERSION)
+ #undef JSON_HEDLEY_TI_CL6X_VERSION
+#endif
+#if defined(__TI_COMPILER_VERSION__) && defined(__TMS320C6X__)
+ #define JSON_HEDLEY_TI_CL6X_VERSION JSON_HEDLEY_VERSION_ENCODE(__TI_COMPILER_VERSION__ / 1000000, (__TI_COMPILER_VERSION__ % 1000000) / 1000, (__TI_COMPILER_VERSION__ % 1000))
+#endif
+
+#if defined(JSON_HEDLEY_TI_CL6X_VERSION_CHECK)
+ #undef JSON_HEDLEY_TI_CL6X_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_TI_CL6X_VERSION)
+ #define JSON_HEDLEY_TI_CL6X_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_TI_CL6X_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_TI_CL6X_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_TI_CL7X_VERSION)
+ #undef JSON_HEDLEY_TI_CL7X_VERSION
+#endif
+#if defined(__TI_COMPILER_VERSION__) && defined(__C7000__)
+ #define JSON_HEDLEY_TI_CL7X_VERSION JSON_HEDLEY_VERSION_ENCODE(__TI_COMPILER_VERSION__ / 1000000, (__TI_COMPILER_VERSION__ % 1000000) / 1000, (__TI_COMPILER_VERSION__ % 1000))
+#endif
+
+#if defined(JSON_HEDLEY_TI_CL7X_VERSION_CHECK)
+ #undef JSON_HEDLEY_TI_CL7X_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_TI_CL7X_VERSION)
+ #define JSON_HEDLEY_TI_CL7X_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_TI_CL7X_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_TI_CL7X_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_TI_CLPRU_VERSION)
+ #undef JSON_HEDLEY_TI_CLPRU_VERSION
+#endif
+#if defined(__TI_COMPILER_VERSION__) && defined(__PRU__)
+ #define JSON_HEDLEY_TI_CLPRU_VERSION JSON_HEDLEY_VERSION_ENCODE(__TI_COMPILER_VERSION__ / 1000000, (__TI_COMPILER_VERSION__ % 1000000) / 1000, (__TI_COMPILER_VERSION__ % 1000))
+#endif
+
+#if defined(JSON_HEDLEY_TI_CLPRU_VERSION_CHECK)
+ #undef JSON_HEDLEY_TI_CLPRU_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_TI_CLPRU_VERSION)
+ #define JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_TI_CLPRU_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_CRAY_VERSION)
+ #undef JSON_HEDLEY_CRAY_VERSION
+#endif
+#if defined(_CRAYC)
+ #if defined(_RELEASE_PATCHLEVEL)
+ #define JSON_HEDLEY_CRAY_VERSION JSON_HEDLEY_VERSION_ENCODE(_RELEASE_MAJOR, _RELEASE_MINOR, _RELEASE_PATCHLEVEL)
+ #else
+ #define JSON_HEDLEY_CRAY_VERSION JSON_HEDLEY_VERSION_ENCODE(_RELEASE_MAJOR, _RELEASE_MINOR, 0)
+ #endif
+#endif
+
+#if defined(JSON_HEDLEY_CRAY_VERSION_CHECK)
+ #undef JSON_HEDLEY_CRAY_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_CRAY_VERSION)
+ #define JSON_HEDLEY_CRAY_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_CRAY_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_CRAY_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_IAR_VERSION)
+ #undef JSON_HEDLEY_IAR_VERSION
+#endif
+#if defined(__IAR_SYSTEMS_ICC__)
+ #if __VER__ > 1000
+ #define JSON_HEDLEY_IAR_VERSION JSON_HEDLEY_VERSION_ENCODE((__VER__ / 1000000), ((__VER__ / 1000) % 1000), (__VER__ % 1000))
+ #else
+ #define JSON_HEDLEY_IAR_VERSION JSON_HEDLEY_VERSION_ENCODE(__VER__ / 100, __VER__ % 100, 0)
+ #endif
+#endif
+
+#if defined(JSON_HEDLEY_IAR_VERSION_CHECK)
+ #undef JSON_HEDLEY_IAR_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_IAR_VERSION)
+ #define JSON_HEDLEY_IAR_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_IAR_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_IAR_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_TINYC_VERSION)
+ #undef JSON_HEDLEY_TINYC_VERSION
+#endif
+#if defined(__TINYC__)
+ #define JSON_HEDLEY_TINYC_VERSION JSON_HEDLEY_VERSION_ENCODE(__TINYC__ / 1000, (__TINYC__ / 100) % 10, __TINYC__ % 100)
+#endif
+
+#if defined(JSON_HEDLEY_TINYC_VERSION_CHECK)
+ #undef JSON_HEDLEY_TINYC_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_TINYC_VERSION)
+ #define JSON_HEDLEY_TINYC_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_TINYC_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_TINYC_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_DMC_VERSION)
+ #undef JSON_HEDLEY_DMC_VERSION
+#endif
+#if defined(__DMC__)
+ #define JSON_HEDLEY_DMC_VERSION JSON_HEDLEY_VERSION_ENCODE(__DMC__ >> 8, (__DMC__ >> 4) & 0xf, __DMC__ & 0xf)
+#endif
+
+#if defined(JSON_HEDLEY_DMC_VERSION_CHECK)
+ #undef JSON_HEDLEY_DMC_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_DMC_VERSION)
+ #define JSON_HEDLEY_DMC_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_DMC_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_DMC_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_COMPCERT_VERSION)
+ #undef JSON_HEDLEY_COMPCERT_VERSION
+#endif
+#if defined(__COMPCERT_VERSION__)
+ #define JSON_HEDLEY_COMPCERT_VERSION JSON_HEDLEY_VERSION_ENCODE(__COMPCERT_VERSION__ / 10000, (__COMPCERT_VERSION__ / 100) % 100, __COMPCERT_VERSION__ % 100)
+#endif
+
+#if defined(JSON_HEDLEY_COMPCERT_VERSION_CHECK)
+ #undef JSON_HEDLEY_COMPCERT_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_COMPCERT_VERSION)
+ #define JSON_HEDLEY_COMPCERT_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_COMPCERT_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_COMPCERT_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_PELLES_VERSION)
+ #undef JSON_HEDLEY_PELLES_VERSION
+#endif
+#if defined(__POCC__)
+ #define JSON_HEDLEY_PELLES_VERSION JSON_HEDLEY_VERSION_ENCODE(__POCC__ / 100, __POCC__ % 100, 0)
+#endif
+
+#if defined(JSON_HEDLEY_PELLES_VERSION_CHECK)
+ #undef JSON_HEDLEY_PELLES_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_PELLES_VERSION)
+ #define JSON_HEDLEY_PELLES_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_PELLES_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_PELLES_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_MCST_LCC_VERSION)
+ #undef JSON_HEDLEY_MCST_LCC_VERSION
+#endif
+#if defined(__LCC__) && defined(__LCC_MINOR__)
+ #define JSON_HEDLEY_MCST_LCC_VERSION JSON_HEDLEY_VERSION_ENCODE(__LCC__ / 100, __LCC__ % 100, __LCC_MINOR__)
+#endif
+
+#if defined(JSON_HEDLEY_MCST_LCC_VERSION_CHECK)
+ #undef JSON_HEDLEY_MCST_LCC_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_MCST_LCC_VERSION)
+ #define JSON_HEDLEY_MCST_LCC_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_MCST_LCC_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_MCST_LCC_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_GCC_VERSION)
+ #undef JSON_HEDLEY_GCC_VERSION
+#endif
+#if \
+ defined(JSON_HEDLEY_GNUC_VERSION) && \
+ !defined(__clang__) && \
+ !defined(JSON_HEDLEY_INTEL_VERSION) && \
+ !defined(JSON_HEDLEY_PGI_VERSION) && \
+ !defined(JSON_HEDLEY_ARM_VERSION) && \
+ !defined(JSON_HEDLEY_CRAY_VERSION) && \
+ !defined(JSON_HEDLEY_TI_VERSION) && \
+ !defined(JSON_HEDLEY_TI_ARMCL_VERSION) && \
+ !defined(JSON_HEDLEY_TI_CL430_VERSION) && \
+ !defined(JSON_HEDLEY_TI_CL2000_VERSION) && \
+ !defined(JSON_HEDLEY_TI_CL6X_VERSION) && \
+ !defined(JSON_HEDLEY_TI_CL7X_VERSION) && \
+ !defined(JSON_HEDLEY_TI_CLPRU_VERSION) && \
+ !defined(__COMPCERT__) && \
+ !defined(JSON_HEDLEY_MCST_LCC_VERSION)
+ #define JSON_HEDLEY_GCC_VERSION JSON_HEDLEY_GNUC_VERSION
+#endif
+
+#if defined(JSON_HEDLEY_GCC_VERSION_CHECK)
+ #undef JSON_HEDLEY_GCC_VERSION_CHECK
+#endif
+#if defined(JSON_HEDLEY_GCC_VERSION)
+ #define JSON_HEDLEY_GCC_VERSION_CHECK(major,minor,patch) (JSON_HEDLEY_GCC_VERSION >= JSON_HEDLEY_VERSION_ENCODE(major, minor, patch))
+#else
+ #define JSON_HEDLEY_GCC_VERSION_CHECK(major,minor,patch) (0)
+#endif
+
+#if defined(JSON_HEDLEY_HAS_ATTRIBUTE)
+ #undef JSON_HEDLEY_HAS_ATTRIBUTE
+#endif
+#if \
+ defined(__has_attribute) && \
+ ( \
+ (!defined(JSON_HEDLEY_IAR_VERSION) || JSON_HEDLEY_IAR_VERSION_CHECK(8,5,9)) \
+ )
+# define JSON_HEDLEY_HAS_ATTRIBUTE(attribute) __has_attribute(attribute)
+#else
+# define JSON_HEDLEY_HAS_ATTRIBUTE(attribute) (0)
+#endif
+
+#if defined(JSON_HEDLEY_GNUC_HAS_ATTRIBUTE)
+ #undef JSON_HEDLEY_GNUC_HAS_ATTRIBUTE
+#endif
+#if defined(__has_attribute)
+ #define JSON_HEDLEY_GNUC_HAS_ATTRIBUTE(attribute,major,minor,patch) JSON_HEDLEY_HAS_ATTRIBUTE(attribute)
+#else
+ #define JSON_HEDLEY_GNUC_HAS_ATTRIBUTE(attribute,major,minor,patch) JSON_HEDLEY_GNUC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if defined(JSON_HEDLEY_GCC_HAS_ATTRIBUTE)
+ #undef JSON_HEDLEY_GCC_HAS_ATTRIBUTE
+#endif
+#if defined(__has_attribute)
+ #define JSON_HEDLEY_GCC_HAS_ATTRIBUTE(attribute,major,minor,patch) JSON_HEDLEY_HAS_ATTRIBUTE(attribute)
+#else
+ #define JSON_HEDLEY_GCC_HAS_ATTRIBUTE(attribute,major,minor,patch) JSON_HEDLEY_GCC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if defined(JSON_HEDLEY_HAS_CPP_ATTRIBUTE)
+ #undef JSON_HEDLEY_HAS_CPP_ATTRIBUTE
+#endif
+#if \
+ defined(__has_cpp_attribute) && \
+ defined(__cplusplus) && \
+ (!defined(JSON_HEDLEY_SUNPRO_VERSION) || JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,15,0))
+ #define JSON_HEDLEY_HAS_CPP_ATTRIBUTE(attribute) __has_cpp_attribute(attribute)
+#else
+ #define JSON_HEDLEY_HAS_CPP_ATTRIBUTE(attribute) (0)
+#endif
+
+#if defined(JSON_HEDLEY_HAS_CPP_ATTRIBUTE_NS)
+ #undef JSON_HEDLEY_HAS_CPP_ATTRIBUTE_NS
+#endif
+#if !defined(__cplusplus) || !defined(__has_cpp_attribute)
+ #define JSON_HEDLEY_HAS_CPP_ATTRIBUTE_NS(ns,attribute) (0)
+#elif \
+ !defined(JSON_HEDLEY_PGI_VERSION) && \
+ !defined(JSON_HEDLEY_IAR_VERSION) && \
+ (!defined(JSON_HEDLEY_SUNPRO_VERSION) || JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,15,0)) && \
+ (!defined(JSON_HEDLEY_MSVC_VERSION) || JSON_HEDLEY_MSVC_VERSION_CHECK(19,20,0))
+ #define JSON_HEDLEY_HAS_CPP_ATTRIBUTE_NS(ns,attribute) JSON_HEDLEY_HAS_CPP_ATTRIBUTE(ns::attribute)
+#else
+ #define JSON_HEDLEY_HAS_CPP_ATTRIBUTE_NS(ns,attribute) (0)
+#endif
+
+#if defined(JSON_HEDLEY_GNUC_HAS_CPP_ATTRIBUTE)
+ #undef JSON_HEDLEY_GNUC_HAS_CPP_ATTRIBUTE
+#endif
+#if defined(__has_cpp_attribute) && defined(__cplusplus)
+ #define JSON_HEDLEY_GNUC_HAS_CPP_ATTRIBUTE(attribute,major,minor,patch) __has_cpp_attribute(attribute)
+#else
+ #define JSON_HEDLEY_GNUC_HAS_CPP_ATTRIBUTE(attribute,major,minor,patch) JSON_HEDLEY_GNUC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if defined(JSON_HEDLEY_GCC_HAS_CPP_ATTRIBUTE)
+ #undef JSON_HEDLEY_GCC_HAS_CPP_ATTRIBUTE
+#endif
+#if defined(__has_cpp_attribute) && defined(__cplusplus)
+ #define JSON_HEDLEY_GCC_HAS_CPP_ATTRIBUTE(attribute,major,minor,patch) __has_cpp_attribute(attribute)
+#else
+ #define JSON_HEDLEY_GCC_HAS_CPP_ATTRIBUTE(attribute,major,minor,patch) JSON_HEDLEY_GCC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if defined(JSON_HEDLEY_HAS_BUILTIN)
+ #undef JSON_HEDLEY_HAS_BUILTIN
+#endif
+#if defined(__has_builtin)
+ #define JSON_HEDLEY_HAS_BUILTIN(builtin) __has_builtin(builtin)
+#else
+ #define JSON_HEDLEY_HAS_BUILTIN(builtin) (0)
+#endif
+
+#if defined(JSON_HEDLEY_GNUC_HAS_BUILTIN)
+ #undef JSON_HEDLEY_GNUC_HAS_BUILTIN
+#endif
+#if defined(__has_builtin)
+ #define JSON_HEDLEY_GNUC_HAS_BUILTIN(builtin,major,minor,patch) __has_builtin(builtin)
+#else
+ #define JSON_HEDLEY_GNUC_HAS_BUILTIN(builtin,major,minor,patch) JSON_HEDLEY_GNUC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if defined(JSON_HEDLEY_GCC_HAS_BUILTIN)
+ #undef JSON_HEDLEY_GCC_HAS_BUILTIN
+#endif
+#if defined(__has_builtin)
+ #define JSON_HEDLEY_GCC_HAS_BUILTIN(builtin,major,minor,patch) __has_builtin(builtin)
+#else
+ #define JSON_HEDLEY_GCC_HAS_BUILTIN(builtin,major,minor,patch) JSON_HEDLEY_GCC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if defined(JSON_HEDLEY_HAS_FEATURE)
+ #undef JSON_HEDLEY_HAS_FEATURE
+#endif
+#if defined(__has_feature)
+ #define JSON_HEDLEY_HAS_FEATURE(feature) __has_feature(feature)
+#else
+ #define JSON_HEDLEY_HAS_FEATURE(feature) (0)
+#endif
+
+#if defined(JSON_HEDLEY_GNUC_HAS_FEATURE)
+ #undef JSON_HEDLEY_GNUC_HAS_FEATURE
+#endif
+#if defined(__has_feature)
+ #define JSON_HEDLEY_GNUC_HAS_FEATURE(feature,major,minor,patch) __has_feature(feature)
+#else
+ #define JSON_HEDLEY_GNUC_HAS_FEATURE(feature,major,minor,patch) JSON_HEDLEY_GNUC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if defined(JSON_HEDLEY_GCC_HAS_FEATURE)
+ #undef JSON_HEDLEY_GCC_HAS_FEATURE
+#endif
+#if defined(__has_feature)
+ #define JSON_HEDLEY_GCC_HAS_FEATURE(feature,major,minor,patch) __has_feature(feature)
+#else
+ #define JSON_HEDLEY_GCC_HAS_FEATURE(feature,major,minor,patch) JSON_HEDLEY_GCC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if defined(JSON_HEDLEY_HAS_EXTENSION)
+ #undef JSON_HEDLEY_HAS_EXTENSION
+#endif
+#if defined(__has_extension)
+ #define JSON_HEDLEY_HAS_EXTENSION(extension) __has_extension(extension)
+#else
+ #define JSON_HEDLEY_HAS_EXTENSION(extension) (0)
+#endif
+
+#if defined(JSON_HEDLEY_GNUC_HAS_EXTENSION)
+ #undef JSON_HEDLEY_GNUC_HAS_EXTENSION
+#endif
+#if defined(__has_extension)
+ #define JSON_HEDLEY_GNUC_HAS_EXTENSION(extension,major,minor,patch) __has_extension(extension)
+#else
+ #define JSON_HEDLEY_GNUC_HAS_EXTENSION(extension,major,minor,patch) JSON_HEDLEY_GNUC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if defined(JSON_HEDLEY_GCC_HAS_EXTENSION)
+ #undef JSON_HEDLEY_GCC_HAS_EXTENSION
+#endif
+#if defined(__has_extension)
+ #define JSON_HEDLEY_GCC_HAS_EXTENSION(extension,major,minor,patch) __has_extension(extension)
+#else
+ #define JSON_HEDLEY_GCC_HAS_EXTENSION(extension,major,minor,patch) JSON_HEDLEY_GCC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if defined(JSON_HEDLEY_HAS_DECLSPEC_ATTRIBUTE)
+ #undef JSON_HEDLEY_HAS_DECLSPEC_ATTRIBUTE
+#endif
+#if defined(__has_declspec_attribute)
+ #define JSON_HEDLEY_HAS_DECLSPEC_ATTRIBUTE(attribute) __has_declspec_attribute(attribute)
+#else
+ #define JSON_HEDLEY_HAS_DECLSPEC_ATTRIBUTE(attribute) (0)
+#endif
+
+#if defined(JSON_HEDLEY_GNUC_HAS_DECLSPEC_ATTRIBUTE)
+ #undef JSON_HEDLEY_GNUC_HAS_DECLSPEC_ATTRIBUTE
+#endif
+#if defined(__has_declspec_attribute)
+ #define JSON_HEDLEY_GNUC_HAS_DECLSPEC_ATTRIBUTE(attribute,major,minor,patch) __has_declspec_attribute(attribute)
+#else
+ #define JSON_HEDLEY_GNUC_HAS_DECLSPEC_ATTRIBUTE(attribute,major,minor,patch) JSON_HEDLEY_GNUC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if defined(JSON_HEDLEY_GCC_HAS_DECLSPEC_ATTRIBUTE)
+ #undef JSON_HEDLEY_GCC_HAS_DECLSPEC_ATTRIBUTE
+#endif
+#if defined(__has_declspec_attribute)
+ #define JSON_HEDLEY_GCC_HAS_DECLSPEC_ATTRIBUTE(attribute,major,minor,patch) __has_declspec_attribute(attribute)
+#else
+ #define JSON_HEDLEY_GCC_HAS_DECLSPEC_ATTRIBUTE(attribute,major,minor,patch) JSON_HEDLEY_GCC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if defined(JSON_HEDLEY_HAS_WARNING)
+ #undef JSON_HEDLEY_HAS_WARNING
+#endif
+#if defined(__has_warning)
+ #define JSON_HEDLEY_HAS_WARNING(warning) __has_warning(warning)
+#else
+ #define JSON_HEDLEY_HAS_WARNING(warning) (0)
+#endif
+
+#if defined(JSON_HEDLEY_GNUC_HAS_WARNING)
+ #undef JSON_HEDLEY_GNUC_HAS_WARNING
+#endif
+#if defined(__has_warning)
+ #define JSON_HEDLEY_GNUC_HAS_WARNING(warning,major,minor,patch) __has_warning(warning)
+#else
+ #define JSON_HEDLEY_GNUC_HAS_WARNING(warning,major,minor,patch) JSON_HEDLEY_GNUC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if defined(JSON_HEDLEY_GCC_HAS_WARNING)
+ #undef JSON_HEDLEY_GCC_HAS_WARNING
+#endif
+#if defined(__has_warning)
+ #define JSON_HEDLEY_GCC_HAS_WARNING(warning,major,minor,patch) __has_warning(warning)
+#else
+ #define JSON_HEDLEY_GCC_HAS_WARNING(warning,major,minor,patch) JSON_HEDLEY_GCC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if \
+ (defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L)) || \
+ defined(__clang__) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(3,0,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_IAR_VERSION_CHECK(8,0,0) || \
+ JSON_HEDLEY_PGI_VERSION_CHECK(18,4,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0) || \
+ JSON_HEDLEY_TI_VERSION_CHECK(15,12,0) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(4,7,0) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(2,0,1) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,1,0) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,0,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0) || \
+ JSON_HEDLEY_CRAY_VERSION_CHECK(5,0,0) || \
+ JSON_HEDLEY_TINYC_VERSION_CHECK(0,9,17) || \
+ JSON_HEDLEY_SUNPRO_VERSION_CHECK(8,0,0) || \
+ (JSON_HEDLEY_IBM_VERSION_CHECK(10,1,0) && defined(__C99_PRAGMA_OPERATOR))
+ #define JSON_HEDLEY_PRAGMA(value) _Pragma(#value)
+#elif JSON_HEDLEY_MSVC_VERSION_CHECK(15,0,0)
+ #define JSON_HEDLEY_PRAGMA(value) __pragma(value)
+#else
+ #define JSON_HEDLEY_PRAGMA(value)
+#endif
+
+#if defined(JSON_HEDLEY_DIAGNOSTIC_PUSH)
+ #undef JSON_HEDLEY_DIAGNOSTIC_PUSH
+#endif
+#if defined(JSON_HEDLEY_DIAGNOSTIC_POP)
+ #undef JSON_HEDLEY_DIAGNOSTIC_POP
+#endif
+#if defined(__clang__)
+ #define JSON_HEDLEY_DIAGNOSTIC_PUSH _Pragma("clang diagnostic push")
+ #define JSON_HEDLEY_DIAGNOSTIC_POP _Pragma("clang diagnostic pop")
+#elif JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_PUSH _Pragma("warning(push)")
+ #define JSON_HEDLEY_DIAGNOSTIC_POP _Pragma("warning(pop)")
+#elif JSON_HEDLEY_GCC_VERSION_CHECK(4,6,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_PUSH _Pragma("GCC diagnostic push")
+ #define JSON_HEDLEY_DIAGNOSTIC_POP _Pragma("GCC diagnostic pop")
+#elif \
+ JSON_HEDLEY_MSVC_VERSION_CHECK(15,0,0) || \
+ JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_PUSH __pragma(warning(push))
+ #define JSON_HEDLEY_DIAGNOSTIC_POP __pragma(warning(pop))
+#elif JSON_HEDLEY_ARM_VERSION_CHECK(5,6,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_PUSH _Pragma("push")
+ #define JSON_HEDLEY_DIAGNOSTIC_POP _Pragma("pop")
+#elif \
+ JSON_HEDLEY_TI_VERSION_CHECK(15,12,0) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(5,2,0) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,4,0) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(8,1,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_PUSH _Pragma("diag_push")
+ #define JSON_HEDLEY_DIAGNOSTIC_POP _Pragma("diag_pop")
+#elif JSON_HEDLEY_PELLES_VERSION_CHECK(2,90,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_PUSH _Pragma("warning(push)")
+ #define JSON_HEDLEY_DIAGNOSTIC_POP _Pragma("warning(pop)")
+#else
+ #define JSON_HEDLEY_DIAGNOSTIC_PUSH
+ #define JSON_HEDLEY_DIAGNOSTIC_POP
+#endif
+
+/* JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_ is for
+ HEDLEY INTERNAL USE ONLY. API subject to change without notice. */
+#if defined(JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_)
+ #undef JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_
+#endif
+#if defined(__cplusplus)
+# if JSON_HEDLEY_HAS_WARNING("-Wc++98-compat")
+# if JSON_HEDLEY_HAS_WARNING("-Wc++17-extensions")
+# if JSON_HEDLEY_HAS_WARNING("-Wc++1z-extensions")
+# define JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_(xpr) \
+ JSON_HEDLEY_DIAGNOSTIC_PUSH \
+ _Pragma("clang diagnostic ignored \"-Wc++98-compat\"") \
+ _Pragma("clang diagnostic ignored \"-Wc++17-extensions\"") \
+ _Pragma("clang diagnostic ignored \"-Wc++1z-extensions\"") \
+ xpr \
+ JSON_HEDLEY_DIAGNOSTIC_POP
+# else
+# define JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_(xpr) \
+ JSON_HEDLEY_DIAGNOSTIC_PUSH \
+ _Pragma("clang diagnostic ignored \"-Wc++98-compat\"") \
+ _Pragma("clang diagnostic ignored \"-Wc++17-extensions\"") \
+ xpr \
+ JSON_HEDLEY_DIAGNOSTIC_POP
+# endif
+# else
+# define JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_(xpr) \
+ JSON_HEDLEY_DIAGNOSTIC_PUSH \
+ _Pragma("clang diagnostic ignored \"-Wc++98-compat\"") \
+ xpr \
+ JSON_HEDLEY_DIAGNOSTIC_POP
+# endif
+# endif
+#endif
+#if !defined(JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_(x) x
+#endif
+
+#if defined(JSON_HEDLEY_CONST_CAST)
+ #undef JSON_HEDLEY_CONST_CAST
+#endif
+#if defined(__cplusplus)
+# define JSON_HEDLEY_CONST_CAST(T, expr) (const_cast<T>(expr))
+#elif \
+ JSON_HEDLEY_HAS_WARNING("-Wcast-qual") || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(4,6,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0)
+# define JSON_HEDLEY_CONST_CAST(T, expr) (__extension__ ({ \
+ JSON_HEDLEY_DIAGNOSTIC_PUSH \
+ JSON_HEDLEY_DIAGNOSTIC_DISABLE_CAST_QUAL \
+ ((T) (expr)); \
+ JSON_HEDLEY_DIAGNOSTIC_POP \
+ }))
+#else
+# define JSON_HEDLEY_CONST_CAST(T, expr) ((T) (expr))
+#endif
+
+#if defined(JSON_HEDLEY_REINTERPRET_CAST)
+ #undef JSON_HEDLEY_REINTERPRET_CAST
+#endif
+#if defined(__cplusplus)
+ #define JSON_HEDLEY_REINTERPRET_CAST(T, expr) (reinterpret_cast<T>(expr))
+#else
+ #define JSON_HEDLEY_REINTERPRET_CAST(T, expr) ((T) (expr))
+#endif
+
+#if defined(JSON_HEDLEY_STATIC_CAST)
+ #undef JSON_HEDLEY_STATIC_CAST
+#endif
+#if defined(__cplusplus)
+ #define JSON_HEDLEY_STATIC_CAST(T, expr) (static_cast<T>(expr))
+#else
+ #define JSON_HEDLEY_STATIC_CAST(T, expr) ((T) (expr))
+#endif
+
+#if defined(JSON_HEDLEY_CPP_CAST)
+ #undef JSON_HEDLEY_CPP_CAST
+#endif
+#if defined(__cplusplus)
+# if JSON_HEDLEY_HAS_WARNING("-Wold-style-cast")
+# define JSON_HEDLEY_CPP_CAST(T, expr) \
+ JSON_HEDLEY_DIAGNOSTIC_PUSH \
+ _Pragma("clang diagnostic ignored \"-Wold-style-cast\"") \
+ ((T) (expr)) \
+ JSON_HEDLEY_DIAGNOSTIC_POP
+# elif JSON_HEDLEY_IAR_VERSION_CHECK(8,3,0)
+# define JSON_HEDLEY_CPP_CAST(T, expr) \
+ JSON_HEDLEY_DIAGNOSTIC_PUSH \
+ _Pragma("diag_suppress=Pe137") \
+ JSON_HEDLEY_DIAGNOSTIC_POP
+# else
+# define JSON_HEDLEY_CPP_CAST(T, expr) ((T) (expr))
+# endif
+#else
+# define JSON_HEDLEY_CPP_CAST(T, expr) (expr)
+#endif
+
+#if defined(JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED)
+ #undef JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED
+#endif
+#if JSON_HEDLEY_HAS_WARNING("-Wdeprecated-declarations")
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED _Pragma("clang diagnostic ignored \"-Wdeprecated-declarations\"")
+#elif JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED _Pragma("warning(disable:1478 1786)")
+#elif JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED __pragma(warning(disable:1478 1786))
+#elif JSON_HEDLEY_PGI_VERSION_CHECK(20,7,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED _Pragma("diag_suppress 1215,1216,1444,1445")
+#elif JSON_HEDLEY_PGI_VERSION_CHECK(17,10,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED _Pragma("diag_suppress 1215,1444")
+#elif JSON_HEDLEY_GCC_VERSION_CHECK(4,3,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED _Pragma("GCC diagnostic ignored \"-Wdeprecated-declarations\"")
+#elif JSON_HEDLEY_MSVC_VERSION_CHECK(15,0,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED __pragma(warning(disable:4996))
+#elif JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED _Pragma("diag_suppress 1215,1444")
+#elif \
+ JSON_HEDLEY_TI_VERSION_CHECK(15,12,0) || \
+ (JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(4,8,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(5,2,0) || \
+ (JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,4,0) || \
+ (JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,3,0) || \
+ (JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,2,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,5,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED _Pragma("diag_suppress 1291,1718")
+#elif JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,13,0) && !defined(__cplusplus)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED _Pragma("error_messages(off,E_DEPRECATED_ATT,E_DEPRECATED_ATT_MESS)")
+#elif JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,13,0) && defined(__cplusplus)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED _Pragma("error_messages(off,symdeprecated,symdeprecated2)")
+#elif JSON_HEDLEY_IAR_VERSION_CHECK(8,0,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED _Pragma("diag_suppress=Pe1444,Pe1215")
+#elif JSON_HEDLEY_PELLES_VERSION_CHECK(2,90,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED _Pragma("warn(disable:2241)")
+#else
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED
+#endif
+
+#if defined(JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS)
+ #undef JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS
+#endif
+#if JSON_HEDLEY_HAS_WARNING("-Wunknown-pragmas")
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS _Pragma("clang diagnostic ignored \"-Wunknown-pragmas\"")
+#elif JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS _Pragma("warning(disable:161)")
+#elif JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS __pragma(warning(disable:161))
+#elif JSON_HEDLEY_PGI_VERSION_CHECK(17,10,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS _Pragma("diag_suppress 1675")
+#elif JSON_HEDLEY_GCC_VERSION_CHECK(4,3,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS _Pragma("GCC diagnostic ignored \"-Wunknown-pragmas\"")
+#elif JSON_HEDLEY_MSVC_VERSION_CHECK(15,0,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS __pragma(warning(disable:4068))
+#elif \
+ JSON_HEDLEY_TI_VERSION_CHECK(16,9,0) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(8,0,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,3,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS _Pragma("diag_suppress 163")
+#elif JSON_HEDLEY_TI_CL6X_VERSION_CHECK(8,0,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS _Pragma("diag_suppress 163")
+#elif JSON_HEDLEY_IAR_VERSION_CHECK(8,0,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS _Pragma("diag_suppress=Pe161")
+#elif JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS _Pragma("diag_suppress 161")
+#else
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS
+#endif
+
+#if defined(JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES)
+ #undef JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES
+#endif
+#if JSON_HEDLEY_HAS_WARNING("-Wunknown-attributes")
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES _Pragma("clang diagnostic ignored \"-Wunknown-attributes\"")
+#elif JSON_HEDLEY_GCC_VERSION_CHECK(4,6,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES _Pragma("GCC diagnostic ignored \"-Wdeprecated-declarations\"")
+#elif JSON_HEDLEY_INTEL_VERSION_CHECK(17,0,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES _Pragma("warning(disable:1292)")
+#elif JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES __pragma(warning(disable:1292))
+#elif JSON_HEDLEY_MSVC_VERSION_CHECK(19,0,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES __pragma(warning(disable:5030))
+#elif JSON_HEDLEY_PGI_VERSION_CHECK(20,7,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES _Pragma("diag_suppress 1097,1098")
+#elif JSON_HEDLEY_PGI_VERSION_CHECK(17,10,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES _Pragma("diag_suppress 1097")
+#elif JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,14,0) && defined(__cplusplus)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES _Pragma("error_messages(off,attrskipunsup)")
+#elif \
+ JSON_HEDLEY_TI_VERSION_CHECK(18,1,0) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(8,3,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES _Pragma("diag_suppress 1173")
+#elif JSON_HEDLEY_IAR_VERSION_CHECK(8,0,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES _Pragma("diag_suppress=Pe1097")
+#elif JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES _Pragma("diag_suppress 1097")
+#else
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES
+#endif
+
+#if defined(JSON_HEDLEY_DIAGNOSTIC_DISABLE_CAST_QUAL)
+ #undef JSON_HEDLEY_DIAGNOSTIC_DISABLE_CAST_QUAL
+#endif
+#if JSON_HEDLEY_HAS_WARNING("-Wcast-qual")
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_CAST_QUAL _Pragma("clang diagnostic ignored \"-Wcast-qual\"")
+#elif JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_CAST_QUAL _Pragma("warning(disable:2203 2331)")
+#elif JSON_HEDLEY_GCC_VERSION_CHECK(3,0,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_CAST_QUAL _Pragma("GCC diagnostic ignored \"-Wcast-qual\"")
+#else
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_CAST_QUAL
+#endif
+
+#if defined(JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNUSED_FUNCTION)
+ #undef JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNUSED_FUNCTION
+#endif
+#if JSON_HEDLEY_HAS_WARNING("-Wunused-function")
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNUSED_FUNCTION _Pragma("clang diagnostic ignored \"-Wunused-function\"")
+#elif JSON_HEDLEY_GCC_VERSION_CHECK(3,4,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNUSED_FUNCTION _Pragma("GCC diagnostic ignored \"-Wunused-function\"")
+#elif JSON_HEDLEY_MSVC_VERSION_CHECK(1,0,0)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNUSED_FUNCTION __pragma(warning(disable:4505))
+#elif JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNUSED_FUNCTION _Pragma("diag_suppress 3142")
+#else
+ #define JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNUSED_FUNCTION
+#endif
+
+#if defined(JSON_HEDLEY_DEPRECATED)
+ #undef JSON_HEDLEY_DEPRECATED
+#endif
+#if defined(JSON_HEDLEY_DEPRECATED_FOR)
+ #undef JSON_HEDLEY_DEPRECATED_FOR
+#endif
+#if \
+ JSON_HEDLEY_MSVC_VERSION_CHECK(14,0,0) || \
+ JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0)
+ #define JSON_HEDLEY_DEPRECATED(since) __declspec(deprecated("Since " # since))
+ #define JSON_HEDLEY_DEPRECATED_FOR(since, replacement) __declspec(deprecated("Since " #since "; use " #replacement))
+#elif \
+ (JSON_HEDLEY_HAS_EXTENSION(attribute_deprecated_with_message) && !defined(JSON_HEDLEY_IAR_VERSION)) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(4,5,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(5,6,0) || \
+ JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,13,0) || \
+ JSON_HEDLEY_PGI_VERSION_CHECK(17,10,0) || \
+ JSON_HEDLEY_TI_VERSION_CHECK(18,1,0) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(18,1,0) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(8,3,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,3,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_DEPRECATED(since) __attribute__((__deprecated__("Since " #since)))
+ #define JSON_HEDLEY_DEPRECATED_FOR(since, replacement) __attribute__((__deprecated__("Since " #since "; use " #replacement)))
+#elif defined(__cplusplus) && (__cplusplus >= 201402L)
+ #define JSON_HEDLEY_DEPRECATED(since) JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_([[deprecated("Since " #since)]])
+ #define JSON_HEDLEY_DEPRECATED_FOR(since, replacement) JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_([[deprecated("Since " #since "; use " #replacement)]])
+#elif \
+ JSON_HEDLEY_HAS_ATTRIBUTE(deprecated) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(3,1,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0) || \
+ JSON_HEDLEY_TI_VERSION_CHECK(15,12,0) || \
+ (JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(4,8,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(5,2,0) || \
+ (JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,4,0) || \
+ (JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,3,0) || \
+ (JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,2,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,5,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10) || \
+ JSON_HEDLEY_IAR_VERSION_CHECK(8,10,0)
+ #define JSON_HEDLEY_DEPRECATED(since) __attribute__((__deprecated__))
+ #define JSON_HEDLEY_DEPRECATED_FOR(since, replacement) __attribute__((__deprecated__))
+#elif \
+ JSON_HEDLEY_MSVC_VERSION_CHECK(13,10,0) || \
+ JSON_HEDLEY_PELLES_VERSION_CHECK(6,50,0) || \
+ JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0)
+ #define JSON_HEDLEY_DEPRECATED(since) __declspec(deprecated)
+ #define JSON_HEDLEY_DEPRECATED_FOR(since, replacement) __declspec(deprecated)
+#elif JSON_HEDLEY_IAR_VERSION_CHECK(8,0,0)
+ #define JSON_HEDLEY_DEPRECATED(since) _Pragma("deprecated")
+ #define JSON_HEDLEY_DEPRECATED_FOR(since, replacement) _Pragma("deprecated")
+#else
+ #define JSON_HEDLEY_DEPRECATED(since)
+ #define JSON_HEDLEY_DEPRECATED_FOR(since, replacement)
+#endif
+
+#if defined(JSON_HEDLEY_UNAVAILABLE)
+ #undef JSON_HEDLEY_UNAVAILABLE
+#endif
+#if \
+ JSON_HEDLEY_HAS_ATTRIBUTE(warning) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(4,3,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_UNAVAILABLE(available_since) __attribute__((__warning__("Not available until " #available_since)))
+#else
+ #define JSON_HEDLEY_UNAVAILABLE(available_since)
+#endif
+
+#if defined(JSON_HEDLEY_WARN_UNUSED_RESULT)
+ #undef JSON_HEDLEY_WARN_UNUSED_RESULT
+#endif
+#if defined(JSON_HEDLEY_WARN_UNUSED_RESULT_MSG)
+ #undef JSON_HEDLEY_WARN_UNUSED_RESULT_MSG
+#endif
+#if \
+ JSON_HEDLEY_HAS_ATTRIBUTE(warn_unused_result) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(3,4,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_TI_VERSION_CHECK(15,12,0) || \
+ (JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(4,8,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(5,2,0) || \
+ (JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,4,0) || \
+ (JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,3,0) || \
+ (JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,2,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,5,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0) || \
+ (JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,15,0) && defined(__cplusplus)) || \
+ JSON_HEDLEY_PGI_VERSION_CHECK(17,10,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_WARN_UNUSED_RESULT __attribute__((__warn_unused_result__))
+ #define JSON_HEDLEY_WARN_UNUSED_RESULT_MSG(msg) __attribute__((__warn_unused_result__))
+#elif (JSON_HEDLEY_HAS_CPP_ATTRIBUTE(nodiscard) >= 201907L)
+ #define JSON_HEDLEY_WARN_UNUSED_RESULT JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_([[nodiscard]])
+ #define JSON_HEDLEY_WARN_UNUSED_RESULT_MSG(msg) JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_([[nodiscard(msg)]])
+#elif JSON_HEDLEY_HAS_CPP_ATTRIBUTE(nodiscard)
+ #define JSON_HEDLEY_WARN_UNUSED_RESULT JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_([[nodiscard]])
+ #define JSON_HEDLEY_WARN_UNUSED_RESULT_MSG(msg) JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_([[nodiscard]])
+#elif defined(_Check_return_) /* SAL */
+ #define JSON_HEDLEY_WARN_UNUSED_RESULT _Check_return_
+ #define JSON_HEDLEY_WARN_UNUSED_RESULT_MSG(msg) _Check_return_
+#else
+ #define JSON_HEDLEY_WARN_UNUSED_RESULT
+ #define JSON_HEDLEY_WARN_UNUSED_RESULT_MSG(msg)
+#endif
+
+#if defined(JSON_HEDLEY_SENTINEL)
+ #undef JSON_HEDLEY_SENTINEL
+#endif
+#if \
+ JSON_HEDLEY_HAS_ATTRIBUTE(sentinel) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(4,0,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(5,4,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_SENTINEL(position) __attribute__((__sentinel__(position)))
+#else
+ #define JSON_HEDLEY_SENTINEL(position)
+#endif
+
+#if defined(JSON_HEDLEY_NO_RETURN)
+ #undef JSON_HEDLEY_NO_RETURN
+#endif
+#if JSON_HEDLEY_IAR_VERSION_CHECK(8,0,0)
+ #define JSON_HEDLEY_NO_RETURN __noreturn
+#elif \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_NO_RETURN __attribute__((__noreturn__))
+#elif defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L
+ #define JSON_HEDLEY_NO_RETURN _Noreturn
+#elif defined(__cplusplus) && (__cplusplus >= 201103L)
+ #define JSON_HEDLEY_NO_RETURN JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_([[noreturn]])
+#elif \
+ JSON_HEDLEY_HAS_ATTRIBUTE(noreturn) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(3,2,0) || \
+ JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,11,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0) || \
+ JSON_HEDLEY_IBM_VERSION_CHECK(10,1,0) || \
+ JSON_HEDLEY_TI_VERSION_CHECK(15,12,0) || \
+ (JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(4,8,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(5,2,0) || \
+ (JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,4,0) || \
+ (JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,3,0) || \
+ (JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,2,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,5,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0) || \
+ JSON_HEDLEY_IAR_VERSION_CHECK(8,10,0)
+ #define JSON_HEDLEY_NO_RETURN __attribute__((__noreturn__))
+#elif JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,10,0)
+ #define JSON_HEDLEY_NO_RETURN _Pragma("does_not_return")
+#elif \
+ JSON_HEDLEY_MSVC_VERSION_CHECK(13,10,0) || \
+ JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0)
+ #define JSON_HEDLEY_NO_RETURN __declspec(noreturn)
+#elif JSON_HEDLEY_TI_CL6X_VERSION_CHECK(6,0,0) && defined(__cplusplus)
+ #define JSON_HEDLEY_NO_RETURN _Pragma("FUNC_NEVER_RETURNS;")
+#elif JSON_HEDLEY_COMPCERT_VERSION_CHECK(3,2,0)
+ #define JSON_HEDLEY_NO_RETURN __attribute((noreturn))
+#elif JSON_HEDLEY_PELLES_VERSION_CHECK(9,0,0)
+ #define JSON_HEDLEY_NO_RETURN __declspec(noreturn)
+#else
+ #define JSON_HEDLEY_NO_RETURN
+#endif
+
+#if defined(JSON_HEDLEY_NO_ESCAPE)
+ #undef JSON_HEDLEY_NO_ESCAPE
+#endif
+#if JSON_HEDLEY_HAS_ATTRIBUTE(noescape)
+ #define JSON_HEDLEY_NO_ESCAPE __attribute__((__noescape__))
+#else
+ #define JSON_HEDLEY_NO_ESCAPE
+#endif
+
+#if defined(JSON_HEDLEY_UNREACHABLE)
+ #undef JSON_HEDLEY_UNREACHABLE
+#endif
+#if defined(JSON_HEDLEY_UNREACHABLE_RETURN)
+ #undef JSON_HEDLEY_UNREACHABLE_RETURN
+#endif
+#if defined(JSON_HEDLEY_ASSUME)
+ #undef JSON_HEDLEY_ASSUME
+#endif
+#if \
+ JSON_HEDLEY_MSVC_VERSION_CHECK(13,10,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0)
+ #define JSON_HEDLEY_ASSUME(expr) __assume(expr)
+#elif JSON_HEDLEY_HAS_BUILTIN(__builtin_assume)
+ #define JSON_HEDLEY_ASSUME(expr) __builtin_assume(expr)
+#elif \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,2,0) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(4,0,0)
+ #if defined(__cplusplus)
+ #define JSON_HEDLEY_ASSUME(expr) std::_nassert(expr)
+ #else
+ #define JSON_HEDLEY_ASSUME(expr) _nassert(expr)
+ #endif
+#endif
+#if \
+ (JSON_HEDLEY_HAS_BUILTIN(__builtin_unreachable) && (!defined(JSON_HEDLEY_ARM_VERSION))) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(4,5,0) || \
+ JSON_HEDLEY_PGI_VERSION_CHECK(18,10,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_IBM_VERSION_CHECK(13,1,5) || \
+ JSON_HEDLEY_CRAY_VERSION_CHECK(10,0,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_UNREACHABLE() __builtin_unreachable()
+#elif defined(JSON_HEDLEY_ASSUME)
+ #define JSON_HEDLEY_UNREACHABLE() JSON_HEDLEY_ASSUME(0)
+#endif
+#if !defined(JSON_HEDLEY_ASSUME)
+ #if defined(JSON_HEDLEY_UNREACHABLE)
+ #define JSON_HEDLEY_ASSUME(expr) JSON_HEDLEY_STATIC_CAST(void, ((expr) ? 1 : (JSON_HEDLEY_UNREACHABLE(), 1)))
+ #else
+ #define JSON_HEDLEY_ASSUME(expr) JSON_HEDLEY_STATIC_CAST(void, expr)
+ #endif
+#endif
+#if defined(JSON_HEDLEY_UNREACHABLE)
+ #if \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,2,0) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(4,0,0)
+ #define JSON_HEDLEY_UNREACHABLE_RETURN(value) return (JSON_HEDLEY_STATIC_CAST(void, JSON_HEDLEY_ASSUME(0)), (value))
+ #else
+ #define JSON_HEDLEY_UNREACHABLE_RETURN(value) JSON_HEDLEY_UNREACHABLE()
+ #endif
+#else
+ #define JSON_HEDLEY_UNREACHABLE_RETURN(value) return (value)
+#endif
+#if !defined(JSON_HEDLEY_UNREACHABLE)
+ #define JSON_HEDLEY_UNREACHABLE() JSON_HEDLEY_ASSUME(0)
+#endif
+
+JSON_HEDLEY_DIAGNOSTIC_PUSH
+#if JSON_HEDLEY_HAS_WARNING("-Wpedantic")
+ #pragma clang diagnostic ignored "-Wpedantic"
+#endif
+#if JSON_HEDLEY_HAS_WARNING("-Wc++98-compat-pedantic") && defined(__cplusplus)
+ #pragma clang diagnostic ignored "-Wc++98-compat-pedantic"
+#endif
+#if JSON_HEDLEY_GCC_HAS_WARNING("-Wvariadic-macros",4,0,0)
+ #if defined(__clang__)
+ #pragma clang diagnostic ignored "-Wvariadic-macros"
+ #elif defined(JSON_HEDLEY_GCC_VERSION)
+ #pragma GCC diagnostic ignored "-Wvariadic-macros"
+ #endif
+#endif
+#if defined(JSON_HEDLEY_NON_NULL)
+ #undef JSON_HEDLEY_NON_NULL
+#endif
+#if \
+ JSON_HEDLEY_HAS_ATTRIBUTE(nonnull) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(3,3,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0)
+ #define JSON_HEDLEY_NON_NULL(...) __attribute__((__nonnull__(__VA_ARGS__)))
+#else
+ #define JSON_HEDLEY_NON_NULL(...)
+#endif
+JSON_HEDLEY_DIAGNOSTIC_POP
+
+#if defined(JSON_HEDLEY_PRINTF_FORMAT)
+ #undef JSON_HEDLEY_PRINTF_FORMAT
+#endif
+#if defined(__MINGW32__) && JSON_HEDLEY_GCC_HAS_ATTRIBUTE(format,4,4,0) && !defined(__USE_MINGW_ANSI_STDIO)
+ #define JSON_HEDLEY_PRINTF_FORMAT(string_idx,first_to_check) __attribute__((__format__(ms_printf, string_idx, first_to_check)))
+#elif defined(__MINGW32__) && JSON_HEDLEY_GCC_HAS_ATTRIBUTE(format,4,4,0) && defined(__USE_MINGW_ANSI_STDIO)
+ #define JSON_HEDLEY_PRINTF_FORMAT(string_idx,first_to_check) __attribute__((__format__(gnu_printf, string_idx, first_to_check)))
+#elif \
+ JSON_HEDLEY_HAS_ATTRIBUTE(format) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(3,1,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(5,6,0) || \
+ JSON_HEDLEY_IBM_VERSION_CHECK(10,1,0) || \
+ JSON_HEDLEY_TI_VERSION_CHECK(15,12,0) || \
+ (JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(4,8,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(5,2,0) || \
+ (JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,4,0) || \
+ (JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,3,0) || \
+ (JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,2,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,5,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_PRINTF_FORMAT(string_idx,first_to_check) __attribute__((__format__(__printf__, string_idx, first_to_check)))
+#elif JSON_HEDLEY_PELLES_VERSION_CHECK(6,0,0)
+ #define JSON_HEDLEY_PRINTF_FORMAT(string_idx,first_to_check) __declspec(vaformat(printf,string_idx,first_to_check))
+#else
+ #define JSON_HEDLEY_PRINTF_FORMAT(string_idx,first_to_check)
+#endif
+
+#if defined(JSON_HEDLEY_CONSTEXPR)
+ #undef JSON_HEDLEY_CONSTEXPR
+#endif
+#if defined(__cplusplus)
+ #if __cplusplus >= 201103L
+ #define JSON_HEDLEY_CONSTEXPR JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_(constexpr)
+ #endif
+#endif
+#if !defined(JSON_HEDLEY_CONSTEXPR)
+ #define JSON_HEDLEY_CONSTEXPR
+#endif
+
+#if defined(JSON_HEDLEY_PREDICT)
+ #undef JSON_HEDLEY_PREDICT
+#endif
+#if defined(JSON_HEDLEY_LIKELY)
+ #undef JSON_HEDLEY_LIKELY
+#endif
+#if defined(JSON_HEDLEY_UNLIKELY)
+ #undef JSON_HEDLEY_UNLIKELY
+#endif
+#if defined(JSON_HEDLEY_UNPREDICTABLE)
+ #undef JSON_HEDLEY_UNPREDICTABLE
+#endif
+#if JSON_HEDLEY_HAS_BUILTIN(__builtin_unpredictable)
+ #define JSON_HEDLEY_UNPREDICTABLE(expr) __builtin_unpredictable((expr))
+#endif
+#if \
+ (JSON_HEDLEY_HAS_BUILTIN(__builtin_expect_with_probability) && !defined(JSON_HEDLEY_PGI_VERSION)) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(9,0,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+# define JSON_HEDLEY_PREDICT(expr, value, probability) __builtin_expect_with_probability( (expr), (value), (probability))
+# define JSON_HEDLEY_PREDICT_TRUE(expr, probability) __builtin_expect_with_probability(!!(expr), 1 , (probability))
+# define JSON_HEDLEY_PREDICT_FALSE(expr, probability) __builtin_expect_with_probability(!!(expr), 0 , (probability))
+# define JSON_HEDLEY_LIKELY(expr) __builtin_expect (!!(expr), 1 )
+# define JSON_HEDLEY_UNLIKELY(expr) __builtin_expect (!!(expr), 0 )
+#elif \
+ (JSON_HEDLEY_HAS_BUILTIN(__builtin_expect) && !defined(JSON_HEDLEY_INTEL_CL_VERSION)) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(3,0,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ (JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,15,0) && defined(__cplusplus)) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0) || \
+ JSON_HEDLEY_IBM_VERSION_CHECK(10,1,0) || \
+ JSON_HEDLEY_TI_VERSION_CHECK(15,12,0) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(4,7,0) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(3,1,0) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,1,0) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(6,1,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0) || \
+ JSON_HEDLEY_TINYC_VERSION_CHECK(0,9,27) || \
+ JSON_HEDLEY_CRAY_VERSION_CHECK(8,1,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+# define JSON_HEDLEY_PREDICT(expr, expected, probability) \
+ (((probability) >= 0.9) ? __builtin_expect((expr), (expected)) : (JSON_HEDLEY_STATIC_CAST(void, expected), (expr)))
+# define JSON_HEDLEY_PREDICT_TRUE(expr, probability) \
+ (__extension__ ({ \
+ double hedley_probability_ = (probability); \
+ ((hedley_probability_ >= 0.9) ? __builtin_expect(!!(expr), 1) : ((hedley_probability_ <= 0.1) ? __builtin_expect(!!(expr), 0) : !!(expr))); \
+ }))
+# define JSON_HEDLEY_PREDICT_FALSE(expr, probability) \
+ (__extension__ ({ \
+ double hedley_probability_ = (probability); \
+ ((hedley_probability_ >= 0.9) ? __builtin_expect(!!(expr), 0) : ((hedley_probability_ <= 0.1) ? __builtin_expect(!!(expr), 1) : !!(expr))); \
+ }))
+# define JSON_HEDLEY_LIKELY(expr) __builtin_expect(!!(expr), 1)
+# define JSON_HEDLEY_UNLIKELY(expr) __builtin_expect(!!(expr), 0)
+#else
+# define JSON_HEDLEY_PREDICT(expr, expected, probability) (JSON_HEDLEY_STATIC_CAST(void, expected), (expr))
+# define JSON_HEDLEY_PREDICT_TRUE(expr, probability) (!!(expr))
+# define JSON_HEDLEY_PREDICT_FALSE(expr, probability) (!!(expr))
+# define JSON_HEDLEY_LIKELY(expr) (!!(expr))
+# define JSON_HEDLEY_UNLIKELY(expr) (!!(expr))
+#endif
+#if !defined(JSON_HEDLEY_UNPREDICTABLE)
+ #define JSON_HEDLEY_UNPREDICTABLE(expr) JSON_HEDLEY_PREDICT(expr, 1, 0.5)
+#endif
+
+#if defined(JSON_HEDLEY_MALLOC)
+ #undef JSON_HEDLEY_MALLOC
+#endif
+#if \
+ JSON_HEDLEY_HAS_ATTRIBUTE(malloc) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(3,1,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,11,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0) || \
+ JSON_HEDLEY_IBM_VERSION_CHECK(12,1,0) || \
+ JSON_HEDLEY_TI_VERSION_CHECK(15,12,0) || \
+ (JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(4,8,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(5,2,0) || \
+ (JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,4,0) || \
+ (JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,3,0) || \
+ (JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,2,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,5,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_MALLOC __attribute__((__malloc__))
+#elif JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,10,0)
+ #define JSON_HEDLEY_MALLOC _Pragma("returns_new_memory")
+#elif \
+ JSON_HEDLEY_MSVC_VERSION_CHECK(14,0,0) || \
+ JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0)
+ #define JSON_HEDLEY_MALLOC __declspec(restrict)
+#else
+ #define JSON_HEDLEY_MALLOC
+#endif
+
+#if defined(JSON_HEDLEY_PURE)
+ #undef JSON_HEDLEY_PURE
+#endif
+#if \
+ JSON_HEDLEY_HAS_ATTRIBUTE(pure) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(2,96,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,11,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0) || \
+ JSON_HEDLEY_IBM_VERSION_CHECK(10,1,0) || \
+ JSON_HEDLEY_TI_VERSION_CHECK(15,12,0) || \
+ (JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(4,8,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(5,2,0) || \
+ (JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,4,0) || \
+ (JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,3,0) || \
+ (JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,2,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,5,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0) || \
+ JSON_HEDLEY_PGI_VERSION_CHECK(17,10,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+# define JSON_HEDLEY_PURE __attribute__((__pure__))
+#elif JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,10,0)
+# define JSON_HEDLEY_PURE _Pragma("does_not_write_global_data")
+#elif defined(__cplusplus) && \
+ ( \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(2,0,1) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(4,0,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) \
+ )
+# define JSON_HEDLEY_PURE _Pragma("FUNC_IS_PURE;")
+#else
+# define JSON_HEDLEY_PURE
+#endif
+
+#if defined(JSON_HEDLEY_CONST)
+ #undef JSON_HEDLEY_CONST
+#endif
+#if \
+ JSON_HEDLEY_HAS_ATTRIBUTE(const) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(2,5,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,11,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0) || \
+ JSON_HEDLEY_IBM_VERSION_CHECK(10,1,0) || \
+ JSON_HEDLEY_TI_VERSION_CHECK(15,12,0) || \
+ (JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(4,8,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(5,2,0) || \
+ (JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,4,0) || \
+ (JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,3,0) || \
+ (JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,2,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,5,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0) || \
+ JSON_HEDLEY_PGI_VERSION_CHECK(17,10,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_CONST __attribute__((__const__))
+#elif \
+ JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,10,0)
+ #define JSON_HEDLEY_CONST _Pragma("no_side_effect")
+#else
+ #define JSON_HEDLEY_CONST JSON_HEDLEY_PURE
+#endif
+
+#if defined(JSON_HEDLEY_RESTRICT)
+ #undef JSON_HEDLEY_RESTRICT
+#endif
+#if defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L) && !defined(__cplusplus)
+ #define JSON_HEDLEY_RESTRICT restrict
+#elif \
+ JSON_HEDLEY_GCC_VERSION_CHECK(3,1,0) || \
+ JSON_HEDLEY_MSVC_VERSION_CHECK(14,0,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0) || \
+ JSON_HEDLEY_IBM_VERSION_CHECK(10,1,0) || \
+ JSON_HEDLEY_PGI_VERSION_CHECK(17,10,0) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,3,0) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,2,4) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(8,1,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ (JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,14,0) && defined(__cplusplus)) || \
+ JSON_HEDLEY_IAR_VERSION_CHECK(8,0,0) || \
+ defined(__clang__) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_RESTRICT __restrict
+#elif JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,3,0) && !defined(__cplusplus)
+ #define JSON_HEDLEY_RESTRICT _Restrict
+#else
+ #define JSON_HEDLEY_RESTRICT
+#endif
+
+#if defined(JSON_HEDLEY_INLINE)
+ #undef JSON_HEDLEY_INLINE
+#endif
+#if \
+ (defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L)) || \
+ (defined(__cplusplus) && (__cplusplus >= 199711L))
+ #define JSON_HEDLEY_INLINE inline
+#elif \
+ defined(JSON_HEDLEY_GCC_VERSION) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(6,2,0)
+ #define JSON_HEDLEY_INLINE __inline__
+#elif \
+ JSON_HEDLEY_MSVC_VERSION_CHECK(12,0,0) || \
+ JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(5,1,0) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(3,1,0) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,2,0) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(8,0,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_INLINE __inline
+#else
+ #define JSON_HEDLEY_INLINE
+#endif
+
+#if defined(JSON_HEDLEY_ALWAYS_INLINE)
+ #undef JSON_HEDLEY_ALWAYS_INLINE
+#endif
+#if \
+ JSON_HEDLEY_HAS_ATTRIBUTE(always_inline) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(4,0,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,11,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0) || \
+ JSON_HEDLEY_IBM_VERSION_CHECK(10,1,0) || \
+ JSON_HEDLEY_TI_VERSION_CHECK(15,12,0) || \
+ (JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(4,8,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(5,2,0) || \
+ (JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,4,0) || \
+ (JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,3,0) || \
+ (JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,2,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,5,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10) || \
+ JSON_HEDLEY_IAR_VERSION_CHECK(8,10,0)
+# define JSON_HEDLEY_ALWAYS_INLINE __attribute__((__always_inline__)) JSON_HEDLEY_INLINE
+#elif \
+ JSON_HEDLEY_MSVC_VERSION_CHECK(12,0,0) || \
+ JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0)
+# define JSON_HEDLEY_ALWAYS_INLINE __forceinline
+#elif defined(__cplusplus) && \
+ ( \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(5,2,0) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,3,0) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,4,0) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(6,1,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0) \
+ )
+# define JSON_HEDLEY_ALWAYS_INLINE _Pragma("FUNC_ALWAYS_INLINE;")
+#elif JSON_HEDLEY_IAR_VERSION_CHECK(8,0,0)
+# define JSON_HEDLEY_ALWAYS_INLINE _Pragma("inline=forced")
+#else
+# define JSON_HEDLEY_ALWAYS_INLINE JSON_HEDLEY_INLINE
+#endif
+
+#if defined(JSON_HEDLEY_NEVER_INLINE)
+ #undef JSON_HEDLEY_NEVER_INLINE
+#endif
+#if \
+ JSON_HEDLEY_HAS_ATTRIBUTE(noinline) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(4,0,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,11,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0) || \
+ JSON_HEDLEY_IBM_VERSION_CHECK(10,1,0) || \
+ JSON_HEDLEY_TI_VERSION_CHECK(15,12,0) || \
+ (JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(4,8,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_ARMCL_VERSION_CHECK(5,2,0) || \
+ (JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL2000_VERSION_CHECK(6,4,0) || \
+ (JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,0,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(4,3,0) || \
+ (JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,2,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,5,0) || \
+ JSON_HEDLEY_TI_CL7X_VERSION_CHECK(1,2,0) || \
+ JSON_HEDLEY_TI_CLPRU_VERSION_CHECK(2,1,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10) || \
+ JSON_HEDLEY_IAR_VERSION_CHECK(8,10,0)
+ #define JSON_HEDLEY_NEVER_INLINE __attribute__((__noinline__))
+#elif \
+ JSON_HEDLEY_MSVC_VERSION_CHECK(13,10,0) || \
+ JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0)
+ #define JSON_HEDLEY_NEVER_INLINE __declspec(noinline)
+#elif JSON_HEDLEY_PGI_VERSION_CHECK(10,2,0)
+ #define JSON_HEDLEY_NEVER_INLINE _Pragma("noinline")
+#elif JSON_HEDLEY_TI_CL6X_VERSION_CHECK(6,0,0) && defined(__cplusplus)
+ #define JSON_HEDLEY_NEVER_INLINE _Pragma("FUNC_CANNOT_INLINE;")
+#elif JSON_HEDLEY_IAR_VERSION_CHECK(8,0,0)
+ #define JSON_HEDLEY_NEVER_INLINE _Pragma("inline=never")
+#elif JSON_HEDLEY_COMPCERT_VERSION_CHECK(3,2,0)
+ #define JSON_HEDLEY_NEVER_INLINE __attribute((noinline))
+#elif JSON_HEDLEY_PELLES_VERSION_CHECK(9,0,0)
+ #define JSON_HEDLEY_NEVER_INLINE __declspec(noinline)
+#else
+ #define JSON_HEDLEY_NEVER_INLINE
+#endif
+
+#if defined(JSON_HEDLEY_PRIVATE)
+ #undef JSON_HEDLEY_PRIVATE
+#endif
+#if defined(JSON_HEDLEY_PUBLIC)
+ #undef JSON_HEDLEY_PUBLIC
+#endif
+#if defined(JSON_HEDLEY_IMPORT)
+ #undef JSON_HEDLEY_IMPORT
+#endif
+#if defined(_WIN32) || defined(__CYGWIN__)
+# define JSON_HEDLEY_PRIVATE
+# define JSON_HEDLEY_PUBLIC __declspec(dllexport)
+# define JSON_HEDLEY_IMPORT __declspec(dllimport)
+#else
+# if \
+ JSON_HEDLEY_HAS_ATTRIBUTE(visibility) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(3,3,0) || \
+ JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,11,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0) || \
+ JSON_HEDLEY_IBM_VERSION_CHECK(13,1,0) || \
+ ( \
+ defined(__TI_EABI__) && \
+ ( \
+ (JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,2,0) && defined(__TI_GNU_ATTRIBUTE_SUPPORT__)) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(7,5,0) \
+ ) \
+ ) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+# define JSON_HEDLEY_PRIVATE __attribute__((__visibility__("hidden")))
+# define JSON_HEDLEY_PUBLIC __attribute__((__visibility__("default")))
+# else
+# define JSON_HEDLEY_PRIVATE
+# define JSON_HEDLEY_PUBLIC
+# endif
+# define JSON_HEDLEY_IMPORT extern
+#endif
+
+#if defined(JSON_HEDLEY_NO_THROW)
+ #undef JSON_HEDLEY_NO_THROW
+#endif
+#if \
+ JSON_HEDLEY_HAS_ATTRIBUTE(nothrow) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(3,3,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_NO_THROW __attribute__((__nothrow__))
+#elif \
+ JSON_HEDLEY_MSVC_VERSION_CHECK(13,1,0) || \
+ JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0)
+ #define JSON_HEDLEY_NO_THROW __declspec(nothrow)
+#else
+ #define JSON_HEDLEY_NO_THROW
+#endif
+
+#if defined(JSON_HEDLEY_FALL_THROUGH)
+ #undef JSON_HEDLEY_FALL_THROUGH
+#endif
+#if \
+ JSON_HEDLEY_HAS_ATTRIBUTE(fallthrough) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(7,0,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_FALL_THROUGH __attribute__((__fallthrough__))
+#elif JSON_HEDLEY_HAS_CPP_ATTRIBUTE_NS(clang,fallthrough)
+ #define JSON_HEDLEY_FALL_THROUGH JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_([[clang::fallthrough]])
+#elif JSON_HEDLEY_HAS_CPP_ATTRIBUTE(fallthrough)
+ #define JSON_HEDLEY_FALL_THROUGH JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_([[fallthrough]])
+#elif defined(__fallthrough) /* SAL */
+ #define JSON_HEDLEY_FALL_THROUGH __fallthrough
+#else
+ #define JSON_HEDLEY_FALL_THROUGH
+#endif
+
+#if defined(JSON_HEDLEY_RETURNS_NON_NULL)
+ #undef JSON_HEDLEY_RETURNS_NON_NULL
+#endif
+#if \
+ JSON_HEDLEY_HAS_ATTRIBUTE(returns_nonnull) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(4,9,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_RETURNS_NON_NULL __attribute__((__returns_nonnull__))
+#elif defined(_Ret_notnull_) /* SAL */
+ #define JSON_HEDLEY_RETURNS_NON_NULL _Ret_notnull_
+#else
+ #define JSON_HEDLEY_RETURNS_NON_NULL
+#endif
+
+#if defined(JSON_HEDLEY_ARRAY_PARAM)
+ #undef JSON_HEDLEY_ARRAY_PARAM
+#endif
+#if \
+ defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L) && \
+ !defined(__STDC_NO_VLA__) && \
+ !defined(__cplusplus) && \
+ !defined(JSON_HEDLEY_PGI_VERSION) && \
+ !defined(JSON_HEDLEY_TINYC_VERSION)
+ #define JSON_HEDLEY_ARRAY_PARAM(name) (name)
+#else
+ #define JSON_HEDLEY_ARRAY_PARAM(name)
+#endif
+
+#if defined(JSON_HEDLEY_IS_CONSTANT)
+ #undef JSON_HEDLEY_IS_CONSTANT
+#endif
+#if defined(JSON_HEDLEY_REQUIRE_CONSTEXPR)
+ #undef JSON_HEDLEY_REQUIRE_CONSTEXPR
+#endif
+/* JSON_HEDLEY_IS_CONSTEXPR_ is for
+ HEDLEY INTERNAL USE ONLY. API subject to change without notice. */
+#if defined(JSON_HEDLEY_IS_CONSTEXPR_)
+ #undef JSON_HEDLEY_IS_CONSTEXPR_
+#endif
+#if \
+ JSON_HEDLEY_HAS_BUILTIN(__builtin_constant_p) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(3,4,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_TINYC_VERSION_CHECK(0,9,19) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(4,1,0) || \
+ JSON_HEDLEY_IBM_VERSION_CHECK(13,1,0) || \
+ JSON_HEDLEY_TI_CL6X_VERSION_CHECK(6,1,0) || \
+ (JSON_HEDLEY_SUNPRO_VERSION_CHECK(5,10,0) && !defined(__cplusplus)) || \
+ JSON_HEDLEY_CRAY_VERSION_CHECK(8,1,0) || \
+ JSON_HEDLEY_MCST_LCC_VERSION_CHECK(1,25,10)
+ #define JSON_HEDLEY_IS_CONSTANT(expr) __builtin_constant_p(expr)
+#endif
+#if !defined(__cplusplus)
+# if \
+ JSON_HEDLEY_HAS_BUILTIN(__builtin_types_compatible_p) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(3,4,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ JSON_HEDLEY_IBM_VERSION_CHECK(13,1,0) || \
+ JSON_HEDLEY_CRAY_VERSION_CHECK(8,1,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(5,4,0) || \
+ JSON_HEDLEY_TINYC_VERSION_CHECK(0,9,24)
+#if defined(__INTPTR_TYPE__)
+ #define JSON_HEDLEY_IS_CONSTEXPR_(expr) __builtin_types_compatible_p(__typeof__((1 ? (void*) ((__INTPTR_TYPE__) ((expr) * 0)) : (int*) 0)), int*)
+#else
+ #include <stdint.h>
+ #define JSON_HEDLEY_IS_CONSTEXPR_(expr) __builtin_types_compatible_p(__typeof__((1 ? (void*) ((intptr_t) ((expr) * 0)) : (int*) 0)), int*)
+#endif
+# elif \
+ ( \
+ defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 201112L) && \
+ !defined(JSON_HEDLEY_SUNPRO_VERSION) && \
+ !defined(JSON_HEDLEY_PGI_VERSION) && \
+ !defined(JSON_HEDLEY_IAR_VERSION)) || \
+ (JSON_HEDLEY_HAS_EXTENSION(c_generic_selections) && !defined(JSON_HEDLEY_IAR_VERSION)) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(4,9,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(17,0,0) || \
+ JSON_HEDLEY_IBM_VERSION_CHECK(12,1,0) || \
+ JSON_HEDLEY_ARM_VERSION_CHECK(5,3,0)
+#if defined(__INTPTR_TYPE__)
+ #define JSON_HEDLEY_IS_CONSTEXPR_(expr) _Generic((1 ? (void*) ((__INTPTR_TYPE__) ((expr) * 0)) : (int*) 0), int*: 1, void*: 0)
+#else
+ #include <stdint.h>
+ #define JSON_HEDLEY_IS_CONSTEXPR_(expr) _Generic((1 ? (void*) ((intptr_t) * 0) : (int*) 0), int*: 1, void*: 0)
+#endif
+# elif \
+ defined(JSON_HEDLEY_GCC_VERSION) || \
+ defined(JSON_HEDLEY_INTEL_VERSION) || \
+ defined(JSON_HEDLEY_TINYC_VERSION) || \
+ defined(JSON_HEDLEY_TI_ARMCL_VERSION) || \
+ JSON_HEDLEY_TI_CL430_VERSION_CHECK(18,12,0) || \
+ defined(JSON_HEDLEY_TI_CL2000_VERSION) || \
+ defined(JSON_HEDLEY_TI_CL6X_VERSION) || \
+ defined(JSON_HEDLEY_TI_CL7X_VERSION) || \
+ defined(JSON_HEDLEY_TI_CLPRU_VERSION) || \
+ defined(__clang__)
+# define JSON_HEDLEY_IS_CONSTEXPR_(expr) ( \
+ sizeof(void) != \
+ sizeof(*( \
+ 1 ? \
+ ((void*) ((expr) * 0L) ) : \
+((struct { char v[sizeof(void) * 2]; } *) 1) \
+ ) \
+ ) \
+ )
+# endif
+#endif
+#if defined(JSON_HEDLEY_IS_CONSTEXPR_)
+ #if !defined(JSON_HEDLEY_IS_CONSTANT)
+ #define JSON_HEDLEY_IS_CONSTANT(expr) JSON_HEDLEY_IS_CONSTEXPR_(expr)
+ #endif
+ #define JSON_HEDLEY_REQUIRE_CONSTEXPR(expr) (JSON_HEDLEY_IS_CONSTEXPR_(expr) ? (expr) : (-1))
+#else
+ #if !defined(JSON_HEDLEY_IS_CONSTANT)
+ #define JSON_HEDLEY_IS_CONSTANT(expr) (0)
+ #endif
+ #define JSON_HEDLEY_REQUIRE_CONSTEXPR(expr) (expr)
+#endif
+
+#if defined(JSON_HEDLEY_BEGIN_C_DECLS)
+ #undef JSON_HEDLEY_BEGIN_C_DECLS
+#endif
+#if defined(JSON_HEDLEY_END_C_DECLS)
+ #undef JSON_HEDLEY_END_C_DECLS
+#endif
+#if defined(JSON_HEDLEY_C_DECL)
+ #undef JSON_HEDLEY_C_DECL
+#endif
+#if defined(__cplusplus)
+ #define JSON_HEDLEY_BEGIN_C_DECLS extern "C" {
+ #define JSON_HEDLEY_END_C_DECLS }
+ #define JSON_HEDLEY_C_DECL extern "C"
+#else
+ #define JSON_HEDLEY_BEGIN_C_DECLS
+ #define JSON_HEDLEY_END_C_DECLS
+ #define JSON_HEDLEY_C_DECL
+#endif
+
+#if defined(JSON_HEDLEY_STATIC_ASSERT)
+ #undef JSON_HEDLEY_STATIC_ASSERT
+#endif
+#if \
+ !defined(__cplusplus) && ( \
+ (defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 201112L)) || \
+ (JSON_HEDLEY_HAS_FEATURE(c_static_assert) && !defined(JSON_HEDLEY_INTEL_CL_VERSION)) || \
+ JSON_HEDLEY_GCC_VERSION_CHECK(6,0,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0) || \
+ defined(_Static_assert) \
+ )
+# define JSON_HEDLEY_STATIC_ASSERT(expr, message) _Static_assert(expr, message)
+#elif \
+ (defined(__cplusplus) && (__cplusplus >= 201103L)) || \
+ JSON_HEDLEY_MSVC_VERSION_CHECK(16,0,0) || \
+ JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0)
+# define JSON_HEDLEY_STATIC_ASSERT(expr, message) JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_(static_assert(expr, message))
+#else
+# define JSON_HEDLEY_STATIC_ASSERT(expr, message)
+#endif
+
+#if defined(JSON_HEDLEY_NULL)
+ #undef JSON_HEDLEY_NULL
+#endif
+#if defined(__cplusplus)
+ #if __cplusplus >= 201103L
+ #define JSON_HEDLEY_NULL JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_(nullptr)
+ #elif defined(NULL)
+ #define JSON_HEDLEY_NULL NULL
+ #else
+ #define JSON_HEDLEY_NULL JSON_HEDLEY_STATIC_CAST(void*, 0)
+ #endif
+#elif defined(NULL)
+ #define JSON_HEDLEY_NULL NULL
+#else
+ #define JSON_HEDLEY_NULL ((void*) 0)
+#endif
+
+#if defined(JSON_HEDLEY_MESSAGE)
+ #undef JSON_HEDLEY_MESSAGE
+#endif
+#if JSON_HEDLEY_HAS_WARNING("-Wunknown-pragmas")
+# define JSON_HEDLEY_MESSAGE(msg) \
+ JSON_HEDLEY_DIAGNOSTIC_PUSH \
+ JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS \
+ JSON_HEDLEY_PRAGMA(message msg) \
+ JSON_HEDLEY_DIAGNOSTIC_POP
+#elif \
+ JSON_HEDLEY_GCC_VERSION_CHECK(4,4,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0)
+# define JSON_HEDLEY_MESSAGE(msg) JSON_HEDLEY_PRAGMA(message msg)
+#elif JSON_HEDLEY_CRAY_VERSION_CHECK(5,0,0)
+# define JSON_HEDLEY_MESSAGE(msg) JSON_HEDLEY_PRAGMA(_CRI message msg)
+#elif JSON_HEDLEY_IAR_VERSION_CHECK(8,0,0)
+# define JSON_HEDLEY_MESSAGE(msg) JSON_HEDLEY_PRAGMA(message(msg))
+#elif JSON_HEDLEY_PELLES_VERSION_CHECK(2,0,0)
+# define JSON_HEDLEY_MESSAGE(msg) JSON_HEDLEY_PRAGMA(message(msg))
+#else
+# define JSON_HEDLEY_MESSAGE(msg)
+#endif
+
+#if defined(JSON_HEDLEY_WARNING)
+ #undef JSON_HEDLEY_WARNING
+#endif
+#if JSON_HEDLEY_HAS_WARNING("-Wunknown-pragmas")
+# define JSON_HEDLEY_WARNING(msg) \
+ JSON_HEDLEY_DIAGNOSTIC_PUSH \
+ JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS \
+ JSON_HEDLEY_PRAGMA(clang warning msg) \
+ JSON_HEDLEY_DIAGNOSTIC_POP
+#elif \
+ JSON_HEDLEY_GCC_VERSION_CHECK(4,8,0) || \
+ JSON_HEDLEY_PGI_VERSION_CHECK(18,4,0) || \
+ JSON_HEDLEY_INTEL_VERSION_CHECK(13,0,0)
+# define JSON_HEDLEY_WARNING(msg) JSON_HEDLEY_PRAGMA(GCC warning msg)
+#elif \
+ JSON_HEDLEY_MSVC_VERSION_CHECK(15,0,0) || \
+ JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0)
+# define JSON_HEDLEY_WARNING(msg) JSON_HEDLEY_PRAGMA(message(msg))
+#else
+# define JSON_HEDLEY_WARNING(msg) JSON_HEDLEY_MESSAGE(msg)
+#endif
+
+#if defined(JSON_HEDLEY_REQUIRE)
+ #undef JSON_HEDLEY_REQUIRE
+#endif
+#if defined(JSON_HEDLEY_REQUIRE_MSG)
+ #undef JSON_HEDLEY_REQUIRE_MSG
+#endif
+#if JSON_HEDLEY_HAS_ATTRIBUTE(diagnose_if)
+# if JSON_HEDLEY_HAS_WARNING("-Wgcc-compat")
+# define JSON_HEDLEY_REQUIRE(expr) \
+ JSON_HEDLEY_DIAGNOSTIC_PUSH \
+ _Pragma("clang diagnostic ignored \"-Wgcc-compat\"") \
+ __attribute__((diagnose_if(!(expr), #expr, "error"))) \
+ JSON_HEDLEY_DIAGNOSTIC_POP
+# define JSON_HEDLEY_REQUIRE_MSG(expr,msg) \
+ JSON_HEDLEY_DIAGNOSTIC_PUSH \
+ _Pragma("clang diagnostic ignored \"-Wgcc-compat\"") \
+ __attribute__((diagnose_if(!(expr), msg, "error"))) \
+ JSON_HEDLEY_DIAGNOSTIC_POP
+# else
+# define JSON_HEDLEY_REQUIRE(expr) __attribute__((diagnose_if(!(expr), #expr, "error")))
+# define JSON_HEDLEY_REQUIRE_MSG(expr,msg) __attribute__((diagnose_if(!(expr), msg, "error")))
+# endif
+#else
+# define JSON_HEDLEY_REQUIRE(expr)
+# define JSON_HEDLEY_REQUIRE_MSG(expr,msg)
+#endif
+
+#if defined(JSON_HEDLEY_FLAGS)
+ #undef JSON_HEDLEY_FLAGS
+#endif
+#if JSON_HEDLEY_HAS_ATTRIBUTE(flag_enum) && (!defined(__cplusplus) || JSON_HEDLEY_HAS_WARNING("-Wbitfield-enum-conversion"))
+ #define JSON_HEDLEY_FLAGS __attribute__((__flag_enum__))
+#else
+ #define JSON_HEDLEY_FLAGS
+#endif
+
+#if defined(JSON_HEDLEY_FLAGS_CAST)
+ #undef JSON_HEDLEY_FLAGS_CAST
+#endif
+#if JSON_HEDLEY_INTEL_VERSION_CHECK(19,0,0)
+# define JSON_HEDLEY_FLAGS_CAST(T, expr) (__extension__ ({ \
+ JSON_HEDLEY_DIAGNOSTIC_PUSH \
+ _Pragma("warning(disable:188)") \
+ ((T) (expr)); \
+ JSON_HEDLEY_DIAGNOSTIC_POP \
+ }))
+#else
+# define JSON_HEDLEY_FLAGS_CAST(T, expr) JSON_HEDLEY_STATIC_CAST(T, expr)
+#endif
+
+#if defined(JSON_HEDLEY_EMPTY_BASES)
+ #undef JSON_HEDLEY_EMPTY_BASES
+#endif
+#if \
+ (JSON_HEDLEY_MSVC_VERSION_CHECK(19,0,23918) && !JSON_HEDLEY_MSVC_VERSION_CHECK(20,0,0)) || \
+ JSON_HEDLEY_INTEL_CL_VERSION_CHECK(2021,1,0)
+ #define JSON_HEDLEY_EMPTY_BASES __declspec(empty_bases)
+#else
+ #define JSON_HEDLEY_EMPTY_BASES
+#endif
+
+/* Remaining macros are deprecated. */
+
+#if defined(JSON_HEDLEY_GCC_NOT_CLANG_VERSION_CHECK)
+ #undef JSON_HEDLEY_GCC_NOT_CLANG_VERSION_CHECK
+#endif
+#if defined(__clang__)
+ #define JSON_HEDLEY_GCC_NOT_CLANG_VERSION_CHECK(major,minor,patch) (0)
+#else
+ #define JSON_HEDLEY_GCC_NOT_CLANG_VERSION_CHECK(major,minor,patch) JSON_HEDLEY_GCC_VERSION_CHECK(major,minor,patch)
+#endif
+
+#if defined(JSON_HEDLEY_CLANG_HAS_ATTRIBUTE)
+ #undef JSON_HEDLEY_CLANG_HAS_ATTRIBUTE
+#endif
+#define JSON_HEDLEY_CLANG_HAS_ATTRIBUTE(attribute) JSON_HEDLEY_HAS_ATTRIBUTE(attribute)
+
+#if defined(JSON_HEDLEY_CLANG_HAS_CPP_ATTRIBUTE)
+ #undef JSON_HEDLEY_CLANG_HAS_CPP_ATTRIBUTE
+#endif
+#define JSON_HEDLEY_CLANG_HAS_CPP_ATTRIBUTE(attribute) JSON_HEDLEY_HAS_CPP_ATTRIBUTE(attribute)
+
+#if defined(JSON_HEDLEY_CLANG_HAS_BUILTIN)
+ #undef JSON_HEDLEY_CLANG_HAS_BUILTIN
+#endif
+#define JSON_HEDLEY_CLANG_HAS_BUILTIN(builtin) JSON_HEDLEY_HAS_BUILTIN(builtin)
+
+#if defined(JSON_HEDLEY_CLANG_HAS_FEATURE)
+ #undef JSON_HEDLEY_CLANG_HAS_FEATURE
+#endif
+#define JSON_HEDLEY_CLANG_HAS_FEATURE(feature) JSON_HEDLEY_HAS_FEATURE(feature)
+
+#if defined(JSON_HEDLEY_CLANG_HAS_EXTENSION)
+ #undef JSON_HEDLEY_CLANG_HAS_EXTENSION
+#endif
+#define JSON_HEDLEY_CLANG_HAS_EXTENSION(extension) JSON_HEDLEY_HAS_EXTENSION(extension)
+
+#if defined(JSON_HEDLEY_CLANG_HAS_DECLSPEC_DECLSPEC_ATTRIBUTE)
+ #undef JSON_HEDLEY_CLANG_HAS_DECLSPEC_DECLSPEC_ATTRIBUTE
+#endif
+#define JSON_HEDLEY_CLANG_HAS_DECLSPEC_ATTRIBUTE(attribute) JSON_HEDLEY_HAS_DECLSPEC_ATTRIBUTE(attribute)
+
+#if defined(JSON_HEDLEY_CLANG_HAS_WARNING)
+ #undef JSON_HEDLEY_CLANG_HAS_WARNING
+#endif
+#define JSON_HEDLEY_CLANG_HAS_WARNING(warning) JSON_HEDLEY_HAS_WARNING(warning)
+
+#endif /* !defined(JSON_HEDLEY_VERSION) || (JSON_HEDLEY_VERSION < X) */
+
+// #include <nlohmann/detail/meta/detected.hpp>
+
+
+#include <type_traits>
+
+// #include <nlohmann/detail/meta/void_t.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+template<typename ...Ts> struct make_void
+{
+ using type = void;
+};
+template<typename ...Ts> using void_t = typename make_void<Ts...>::type;
+} // namespace detail
+} // namespace nlohmann
+
+
+// https://en.cppreference.com/w/cpp/experimental/is_detected
+namespace nlohmann
+{
+namespace detail
+{
+struct nonesuch
+{
+ nonesuch() = delete;
+ ~nonesuch() = delete;
+ nonesuch(nonesuch const&) = delete;
+ nonesuch(nonesuch const&&) = delete;
+ void operator=(nonesuch const&) = delete;
+ void operator=(nonesuch&&) = delete;
+};
+
+template<class Default,
+ class AlwaysVoid,
+ template<class...> class Op,
+ class... Args>
+struct detector
+{
+ using value_t = std::false_type;
+ using type = Default;
+};
+
+template<class Default, template<class...> class Op, class... Args>
+struct detector<Default, void_t<Op<Args...>>, Op, Args...>
+{
+ using value_t = std::true_type;
+ using type = Op<Args...>;
+};
+
+template<template<class...> class Op, class... Args>
+using is_detected = typename detector<nonesuch, void, Op, Args...>::value_t;
+
+template<template<class...> class Op, class... Args>
+struct is_detected_lazy : is_detected<Op, Args...> { };
+
+template<template<class...> class Op, class... Args>
+using detected_t = typename detector<nonesuch, void, Op, Args...>::type;
+
+template<class Default, template<class...> class Op, class... Args>
+using detected_or = detector<Default, void, Op, Args...>;
+
+template<class Default, template<class...> class Op, class... Args>
+using detected_or_t = typename detected_or<Default, Op, Args...>::type;
+
+template<class Expected, template<class...> class Op, class... Args>
+using is_detected_exact = std::is_same<Expected, detected_t<Op, Args...>>;
+
+template<class To, template<class...> class Op, class... Args>
+using is_detected_convertible =
+ std::is_convertible<detected_t<Op, Args...>, To>;
+} // namespace detail
+} // namespace nlohmann
+
+
+// This file contains all internal macro definitions
+// You MUST include macro_unscope.hpp at the end of json.hpp to undef all of them
+
+// exclude unsupported compilers
+#if !defined(JSON_SKIP_UNSUPPORTED_COMPILER_CHECK)
+ #if defined(__clang__)
+ #if (__clang_major__ * 10000 + __clang_minor__ * 100 + __clang_patchlevel__) < 30400
+ #error "unsupported Clang version - see https://github.com/nlohmann/json#supported-compilers"
+ #endif
+ #elif defined(__GNUC__) && !(defined(__ICC) || defined(__INTEL_COMPILER))
+ #if (__GNUC__ * 10000 + __GNUC_MINOR__ * 100 + __GNUC_PATCHLEVEL__) < 40800
+ #error "unsupported GCC version - see https://github.com/nlohmann/json#supported-compilers"
+ #endif
+ #endif
+#endif
+
+// C++ language standard detection
+// if the user manually specified the used c++ version this is skipped
+#if !defined(JSON_HAS_CPP_20) && !defined(JSON_HAS_CPP_17) && !defined(JSON_HAS_CPP_14) && !defined(JSON_HAS_CPP_11)
+ #if (defined(__cplusplus) && __cplusplus >= 202002L) || (defined(_MSVC_LANG) && _MSVC_LANG >= 202002L)
+ #define JSON_HAS_CPP_20
+ #define JSON_HAS_CPP_17
+ #define JSON_HAS_CPP_14
+ #elif (defined(__cplusplus) && __cplusplus >= 201703L) || (defined(_HAS_CXX17) && _HAS_CXX17 == 1) // fix for issue #464
+ #define JSON_HAS_CPP_17
+ #define JSON_HAS_CPP_14
+ #elif (defined(__cplusplus) && __cplusplus >= 201402L) || (defined(_HAS_CXX14) && _HAS_CXX14 == 1)
+ #define JSON_HAS_CPP_14
+ #endif
+ // the cpp 11 flag is always specified because it is the minimal required version
+ #define JSON_HAS_CPP_11
+#endif
+
+#if !defined(JSON_HAS_FILESYSTEM) && !defined(JSON_HAS_EXPERIMENTAL_FILESYSTEM)
+ #ifdef JSON_HAS_CPP_17
+ #if defined(__cpp_lib_filesystem)
+ #define JSON_HAS_FILESYSTEM 1
+ #elif defined(__cpp_lib_experimental_filesystem)
+ #define JSON_HAS_EXPERIMENTAL_FILESYSTEM 1
+ #elif !defined(__has_include)
+ #define JSON_HAS_EXPERIMENTAL_FILESYSTEM 1
+ #elif __has_include(<filesystem>)
+ #define JSON_HAS_FILESYSTEM 1
+ #elif __has_include(<experimental/filesystem>)
+ #define JSON_HAS_EXPERIMENTAL_FILESYSTEM 1
+ #endif
+
+ // std::filesystem does not work on MinGW GCC 8: https://sourceforge.net/p/mingw-w64/bugs/737/
+ #if defined(__MINGW32__) && defined(__GNUC__) && __GNUC__ == 8
+ #undef JSON_HAS_FILESYSTEM
+ #undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
+ #endif
+
+ // no filesystem support before GCC 8: https://en.cppreference.com/w/cpp/compiler_support
+ #if defined(__GNUC__) && !defined(__clang__) && __GNUC__ < 8
+ #undef JSON_HAS_FILESYSTEM
+ #undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
+ #endif
+
+ // no filesystem support before Clang 7: https://en.cppreference.com/w/cpp/compiler_support
+ #if defined(__clang_major__) && __clang_major__ < 7
+ #undef JSON_HAS_FILESYSTEM
+ #undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
+ #endif
+
+ // no filesystem support before MSVC 19.14: https://en.cppreference.com/w/cpp/compiler_support
+ #if defined(_MSC_VER) && _MSC_VER < 1940
+ #undef JSON_HAS_FILESYSTEM
+ #undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
+ #endif
+
+ // no filesystem support before iOS 13
+ #if defined(__IPHONE_OS_VERSION_MIN_REQUIRED) && __IPHONE_OS_VERSION_MIN_REQUIRED < 130000
+ #undef JSON_HAS_FILESYSTEM
+ #undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
+ #endif
+
+ // no filesystem support before macOS Catalina
+ #if defined(__MAC_OS_X_VERSION_MIN_REQUIRED) && __MAC_OS_X_VERSION_MIN_REQUIRED < 101500
+ #undef JSON_HAS_FILESYSTEM
+ #undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
+ #endif
+ #endif
+#endif
+
+#ifndef JSON_HAS_EXPERIMENTAL_FILESYSTEM
+ #define JSON_HAS_EXPERIMENTAL_FILESYSTEM 0
+#endif
+
+#ifndef JSON_HAS_FILESYSTEM
+ #define JSON_HAS_FILESYSTEM 0
+#endif
+
+// disable documentation warnings on clang
+#if defined(__clang__)
+ #pragma clang diagnostic push
+ #pragma clang diagnostic ignored "-Wdocumentation"
+ #pragma clang diagnostic ignored "-Wdocumentation-unknown-command"
+#endif
+
+// allow disabling exceptions
+#if (defined(__cpp_exceptions) || defined(__EXCEPTIONS) || defined(_CPPUNWIND)) && !defined(JSON_NOEXCEPTION)
+ #define JSON_THROW(exception) throw exception
+ #define JSON_TRY try
+ #define JSON_CATCH(exception) catch(exception)
+ #define JSON_INTERNAL_CATCH(exception) catch(exception)
+#else
+ #include <cstdlib>
+ #define JSON_THROW(exception) std::abort()
+ #define JSON_TRY if(true)
+ #define JSON_CATCH(exception) if(false)
+ #define JSON_INTERNAL_CATCH(exception) if(false)
+#endif
+
+// override exception macros
+#if defined(JSON_THROW_USER)
+ #undef JSON_THROW
+ #define JSON_THROW JSON_THROW_USER
+#endif
+#if defined(JSON_TRY_USER)
+ #undef JSON_TRY
+ #define JSON_TRY JSON_TRY_USER
+#endif
+#if defined(JSON_CATCH_USER)
+ #undef JSON_CATCH
+ #define JSON_CATCH JSON_CATCH_USER
+ #undef JSON_INTERNAL_CATCH
+ #define JSON_INTERNAL_CATCH JSON_CATCH_USER
+#endif
+#if defined(JSON_INTERNAL_CATCH_USER)
+ #undef JSON_INTERNAL_CATCH
+ #define JSON_INTERNAL_CATCH JSON_INTERNAL_CATCH_USER
+#endif
+
+// allow overriding assert
+#if !defined(JSON_ASSERT)
+ #include <cassert> // assert
+ #define JSON_ASSERT(x) assert(x)
+#endif
+
+// allow to access some private functions (needed by the test suite)
+#if defined(JSON_TESTS_PRIVATE)
+ #define JSON_PRIVATE_UNLESS_TESTED public
+#else
+ #define JSON_PRIVATE_UNLESS_TESTED private
+#endif
+
+/*!
+@brief macro to briefly define a mapping between an enum and JSON
+@def NLOHMANN_JSON_SERIALIZE_ENUM
+@since version 3.4.0
+*/
+#define NLOHMANN_JSON_SERIALIZE_ENUM(ENUM_TYPE, ...) \
+ template<typename BasicJsonType> \
+ inline void to_json(BasicJsonType& j, const ENUM_TYPE& e) \
+ { \
+ static_assert(std::is_enum<ENUM_TYPE>::value, #ENUM_TYPE " must be an enum!"); \
+ static const std::pair<ENUM_TYPE, BasicJsonType> m[] = __VA_ARGS__; \
+ auto it = std::find_if(std::begin(m), std::end(m), \
+ [e](const std::pair<ENUM_TYPE, BasicJsonType>& ej_pair) -> bool \
+ { \
+ return ej_pair.first == e; \
+ }); \
+ j = ((it != std::end(m)) ? it : std::begin(m))->second; \
+ } \
+ template<typename BasicJsonType> \
+ inline void from_json(const BasicJsonType& j, ENUM_TYPE& e) \
+ { \
+ static_assert(std::is_enum<ENUM_TYPE>::value, #ENUM_TYPE " must be an enum!"); \
+ static const std::pair<ENUM_TYPE, BasicJsonType> m[] = __VA_ARGS__; \
+ auto it = std::find_if(std::begin(m), std::end(m), \
+ [&j](const std::pair<ENUM_TYPE, BasicJsonType>& ej_pair) -> bool \
+ { \
+ return ej_pair.second == j; \
+ }); \
+ e = ((it != std::end(m)) ? it : std::begin(m))->first; \
+ }
+
+// Ugly macros to avoid uglier copy-paste when specializing basic_json. They
+// may be removed in the future once the class is split.
+
+#define NLOHMANN_BASIC_JSON_TPL_DECLARATION \
+ template<template<typename, typename, typename...> class ObjectType, \
+ template<typename, typename...> class ArrayType, \
+ class StringType, class BooleanType, class NumberIntegerType, \
+ class NumberUnsignedType, class NumberFloatType, \
+ template<typename> class AllocatorType, \
+ template<typename, typename = void> class JSONSerializer, \
+ class BinaryType>
+
+#define NLOHMANN_BASIC_JSON_TPL \
+ basic_json<ObjectType, ArrayType, StringType, BooleanType, \
+ NumberIntegerType, NumberUnsignedType, NumberFloatType, \
+ AllocatorType, JSONSerializer, BinaryType>
+
+// Macros to simplify conversion from/to types
+
+#define NLOHMANN_JSON_EXPAND( x ) x
+#define NLOHMANN_JSON_GET_MACRO(_1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18, _19, _20, _21, _22, _23, _24, _25, _26, _27, _28, _29, _30, _31, _32, _33, _34, _35, _36, _37, _38, _39, _40, _41, _42, _43, _44, _45, _46, _47, _48, _49, _50, _51, _52, _53, _54, _55, _56, _57, _58, _59, _60, _61, _62, _63, _64, NAME,...) NAME
+#define NLOHMANN_JSON_PASTE(...) NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_GET_MACRO(__VA_ARGS__, \
+ NLOHMANN_JSON_PASTE64, \
+ NLOHMANN_JSON_PASTE63, \
+ NLOHMANN_JSON_PASTE62, \
+ NLOHMANN_JSON_PASTE61, \
+ NLOHMANN_JSON_PASTE60, \
+ NLOHMANN_JSON_PASTE59, \
+ NLOHMANN_JSON_PASTE58, \
+ NLOHMANN_JSON_PASTE57, \
+ NLOHMANN_JSON_PASTE56, \
+ NLOHMANN_JSON_PASTE55, \
+ NLOHMANN_JSON_PASTE54, \
+ NLOHMANN_JSON_PASTE53, \
+ NLOHMANN_JSON_PASTE52, \
+ NLOHMANN_JSON_PASTE51, \
+ NLOHMANN_JSON_PASTE50, \
+ NLOHMANN_JSON_PASTE49, \
+ NLOHMANN_JSON_PASTE48, \
+ NLOHMANN_JSON_PASTE47, \
+ NLOHMANN_JSON_PASTE46, \
+ NLOHMANN_JSON_PASTE45, \
+ NLOHMANN_JSON_PASTE44, \
+ NLOHMANN_JSON_PASTE43, \
+ NLOHMANN_JSON_PASTE42, \
+ NLOHMANN_JSON_PASTE41, \
+ NLOHMANN_JSON_PASTE40, \
+ NLOHMANN_JSON_PASTE39, \
+ NLOHMANN_JSON_PASTE38, \
+ NLOHMANN_JSON_PASTE37, \
+ NLOHMANN_JSON_PASTE36, \
+ NLOHMANN_JSON_PASTE35, \
+ NLOHMANN_JSON_PASTE34, \
+ NLOHMANN_JSON_PASTE33, \
+ NLOHMANN_JSON_PASTE32, \
+ NLOHMANN_JSON_PASTE31, \
+ NLOHMANN_JSON_PASTE30, \
+ NLOHMANN_JSON_PASTE29, \
+ NLOHMANN_JSON_PASTE28, \
+ NLOHMANN_JSON_PASTE27, \
+ NLOHMANN_JSON_PASTE26, \
+ NLOHMANN_JSON_PASTE25, \
+ NLOHMANN_JSON_PASTE24, \
+ NLOHMANN_JSON_PASTE23, \
+ NLOHMANN_JSON_PASTE22, \
+ NLOHMANN_JSON_PASTE21, \
+ NLOHMANN_JSON_PASTE20, \
+ NLOHMANN_JSON_PASTE19, \
+ NLOHMANN_JSON_PASTE18, \
+ NLOHMANN_JSON_PASTE17, \
+ NLOHMANN_JSON_PASTE16, \
+ NLOHMANN_JSON_PASTE15, \
+ NLOHMANN_JSON_PASTE14, \
+ NLOHMANN_JSON_PASTE13, \
+ NLOHMANN_JSON_PASTE12, \
+ NLOHMANN_JSON_PASTE11, \
+ NLOHMANN_JSON_PASTE10, \
+ NLOHMANN_JSON_PASTE9, \
+ NLOHMANN_JSON_PASTE8, \
+ NLOHMANN_JSON_PASTE7, \
+ NLOHMANN_JSON_PASTE6, \
+ NLOHMANN_JSON_PASTE5, \
+ NLOHMANN_JSON_PASTE4, \
+ NLOHMANN_JSON_PASTE3, \
+ NLOHMANN_JSON_PASTE2, \
+ NLOHMANN_JSON_PASTE1)(__VA_ARGS__))
+#define NLOHMANN_JSON_PASTE2(func, v1) func(v1)
+#define NLOHMANN_JSON_PASTE3(func, v1, v2) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE2(func, v2)
+#define NLOHMANN_JSON_PASTE4(func, v1, v2, v3) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE3(func, v2, v3)
+#define NLOHMANN_JSON_PASTE5(func, v1, v2, v3, v4) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE4(func, v2, v3, v4)
+#define NLOHMANN_JSON_PASTE6(func, v1, v2, v3, v4, v5) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE5(func, v2, v3, v4, v5)
+#define NLOHMANN_JSON_PASTE7(func, v1, v2, v3, v4, v5, v6) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE6(func, v2, v3, v4, v5, v6)
+#define NLOHMANN_JSON_PASTE8(func, v1, v2, v3, v4, v5, v6, v7) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE7(func, v2, v3, v4, v5, v6, v7)
+#define NLOHMANN_JSON_PASTE9(func, v1, v2, v3, v4, v5, v6, v7, v8) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE8(func, v2, v3, v4, v5, v6, v7, v8)
+#define NLOHMANN_JSON_PASTE10(func, v1, v2, v3, v4, v5, v6, v7, v8, v9) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE9(func, v2, v3, v4, v5, v6, v7, v8, v9)
+#define NLOHMANN_JSON_PASTE11(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE10(func, v2, v3, v4, v5, v6, v7, v8, v9, v10)
+#define NLOHMANN_JSON_PASTE12(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE11(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11)
+#define NLOHMANN_JSON_PASTE13(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE12(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12)
+#define NLOHMANN_JSON_PASTE14(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE13(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13)
+#define NLOHMANN_JSON_PASTE15(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE14(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14)
+#define NLOHMANN_JSON_PASTE16(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE15(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15)
+#define NLOHMANN_JSON_PASTE17(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE16(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16)
+#define NLOHMANN_JSON_PASTE18(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE17(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17)
+#define NLOHMANN_JSON_PASTE19(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE18(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18)
+#define NLOHMANN_JSON_PASTE20(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE19(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19)
+#define NLOHMANN_JSON_PASTE21(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE20(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20)
+#define NLOHMANN_JSON_PASTE22(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE21(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21)
+#define NLOHMANN_JSON_PASTE23(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE22(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22)
+#define NLOHMANN_JSON_PASTE24(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE23(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23)
+#define NLOHMANN_JSON_PASTE25(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE24(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24)
+#define NLOHMANN_JSON_PASTE26(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE25(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25)
+#define NLOHMANN_JSON_PASTE27(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE26(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26)
+#define NLOHMANN_JSON_PASTE28(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE27(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27)
+#define NLOHMANN_JSON_PASTE29(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE28(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28)
+#define NLOHMANN_JSON_PASTE30(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE29(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29)
+#define NLOHMANN_JSON_PASTE31(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE30(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30)
+#define NLOHMANN_JSON_PASTE32(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE31(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31)
+#define NLOHMANN_JSON_PASTE33(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE32(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32)
+#define NLOHMANN_JSON_PASTE34(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE33(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33)
+#define NLOHMANN_JSON_PASTE35(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE34(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34)
+#define NLOHMANN_JSON_PASTE36(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE35(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35)
+#define NLOHMANN_JSON_PASTE37(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE36(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36)
+#define NLOHMANN_JSON_PASTE38(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE37(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37)
+#define NLOHMANN_JSON_PASTE39(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE38(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38)
+#define NLOHMANN_JSON_PASTE40(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE39(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39)
+#define NLOHMANN_JSON_PASTE41(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE40(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40)
+#define NLOHMANN_JSON_PASTE42(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE41(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41)
+#define NLOHMANN_JSON_PASTE43(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE42(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42)
+#define NLOHMANN_JSON_PASTE44(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE43(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43)
+#define NLOHMANN_JSON_PASTE45(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE44(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44)
+#define NLOHMANN_JSON_PASTE46(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE45(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45)
+#define NLOHMANN_JSON_PASTE47(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE46(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46)
+#define NLOHMANN_JSON_PASTE48(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE47(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47)
+#define NLOHMANN_JSON_PASTE49(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE48(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48)
+#define NLOHMANN_JSON_PASTE50(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE49(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49)
+#define NLOHMANN_JSON_PASTE51(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE50(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50)
+#define NLOHMANN_JSON_PASTE52(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE51(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51)
+#define NLOHMANN_JSON_PASTE53(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE52(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52)
+#define NLOHMANN_JSON_PASTE54(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE53(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53)
+#define NLOHMANN_JSON_PASTE55(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE54(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54)
+#define NLOHMANN_JSON_PASTE56(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE55(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55)
+#define NLOHMANN_JSON_PASTE57(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE56(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56)
+#define NLOHMANN_JSON_PASTE58(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56, v57) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE57(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56, v57)
+#define NLOHMANN_JSON_PASTE59(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56, v57, v58) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE58(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56, v57, v58)
+#define NLOHMANN_JSON_PASTE60(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56, v57, v58, v59) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE59(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56, v57, v58, v59)
+#define NLOHMANN_JSON_PASTE61(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56, v57, v58, v59, v60) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE60(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56, v57, v58, v59, v60)
+#define NLOHMANN_JSON_PASTE62(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56, v57, v58, v59, v60, v61) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE61(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56, v57, v58, v59, v60, v61)
+#define NLOHMANN_JSON_PASTE63(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56, v57, v58, v59, v60, v61, v62) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE62(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56, v57, v58, v59, v60, v61, v62)
+#define NLOHMANN_JSON_PASTE64(func, v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56, v57, v58, v59, v60, v61, v62, v63) NLOHMANN_JSON_PASTE2(func, v1) NLOHMANN_JSON_PASTE63(func, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22, v23, v24, v25, v26, v27, v28, v29, v30, v31, v32, v33, v34, v35, v36, v37, v38, v39, v40, v41, v42, v43, v44, v45, v46, v47, v48, v49, v50, v51, v52, v53, v54, v55, v56, v57, v58, v59, v60, v61, v62, v63)
+
+#define NLOHMANN_JSON_TO(v1) nlohmann_json_j[#v1] = nlohmann_json_t.v1;
+#define NLOHMANN_JSON_FROM(v1) nlohmann_json_j.at(#v1).get_to(nlohmann_json_t.v1);
+
+/*!
+@brief macro
+@def NLOHMANN_DEFINE_TYPE_INTRUSIVE
+@since version 3.9.0
+*/
+#define NLOHMANN_DEFINE_TYPE_INTRUSIVE(Type, ...) \
+ friend void to_json(nlohmann::json& nlohmann_json_j, const Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_TO, __VA_ARGS__)) } \
+ friend void from_json(const nlohmann::json& nlohmann_json_j, Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_FROM, __VA_ARGS__)) }
+
+/*!
+@brief macro
+@def NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE
+@since version 3.9.0
+*/
+#define NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(Type, ...) \
+ inline void to_json(nlohmann::json& nlohmann_json_j, const Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_TO, __VA_ARGS__)) } \
+ inline void from_json(const nlohmann::json& nlohmann_json_j, Type& nlohmann_json_t) { NLOHMANN_JSON_EXPAND(NLOHMANN_JSON_PASTE(NLOHMANN_JSON_FROM, __VA_ARGS__)) }
+
+
+// inspired from https://stackoverflow.com/a/26745591
+// allows to call any std function as if (e.g. with begin):
+// using std::begin; begin(x);
+//
+// it allows using the detected idiom to retrieve the return type
+// of such an expression
+#define NLOHMANN_CAN_CALL_STD_FUNC_IMPL(std_name) \
+ namespace detail { \
+ using std::std_name; \
+ \
+ template<typename... T> \
+ using result_of_##std_name = decltype(std_name(std::declval<T>()...)); \
+ } \
+ \
+ namespace detail2 { \
+ struct std_name##_tag \
+ { \
+ }; \
+ \
+ template<typename... T> \
+ std_name##_tag std_name(T&&...); \
+ \
+ template<typename... T> \
+ using result_of_##std_name = decltype(std_name(std::declval<T>()...)); \
+ \
+ template<typename... T> \
+ struct would_call_std_##std_name \
+ { \
+ static constexpr auto const value = ::nlohmann::detail:: \
+ is_detected_exact<std_name##_tag, result_of_##std_name, T...>::value; \
+ }; \
+ } /* namespace detail2 */ \
+ \
+ template<typename... T> \
+ struct would_call_std_##std_name : detail2::would_call_std_##std_name<T...> \
+ { \
+ }
+
+#ifndef JSON_USE_IMPLICIT_CONVERSIONS
+ #define JSON_USE_IMPLICIT_CONVERSIONS 1
+#endif
+
+#if JSON_USE_IMPLICIT_CONVERSIONS
+ #define JSON_EXPLICIT
+#else
+ #define JSON_EXPLICIT explicit
+#endif
+
+#ifndef JSON_DIAGNOSTICS
+ #define JSON_DIAGNOSTICS 0
+#endif
+
+
+namespace nlohmann
+{
+namespace detail
+{
+
+/*!
+@brief replace all occurrences of a substring by another string
+
+@param[in,out] s the string to manipulate; changed so that all
+ occurrences of @a f are replaced with @a t
+@param[in] f the substring to replace with @a t
+@param[in] t the string to replace @a f
+
+@pre The search string @a f must not be empty. **This precondition is
+enforced with an assertion.**
+
+@since version 2.0.0
+*/
+inline void replace_substring(std::string& s, const std::string& f,
+ const std::string& t)
+{
+ JSON_ASSERT(!f.empty());
+ for (auto pos = s.find(f); // find first occurrence of f
+ pos != std::string::npos; // make sure f was found
+ s.replace(pos, f.size(), t), // replace with t, and
+ pos = s.find(f, pos + t.size())) // find next occurrence of f
+ {}
+}
+
+/*!
+ * @brief string escaping as described in RFC 6901 (Sect. 4)
+ * @param[in] s string to escape
+ * @return escaped string
+ *
+ * Note the order of escaping "~" to "~0" and "/" to "~1" is important.
+ */
+inline std::string escape(std::string s)
+{
+ replace_substring(s, "~", "~0");
+ replace_substring(s, "/", "~1");
+ return s;
+}
+
+/*!
+ * @brief string unescaping as described in RFC 6901 (Sect. 4)
+ * @param[in] s string to unescape
+ * @return unescaped string
+ *
+ * Note the order of escaping "~1" to "/" and "~0" to "~" is important.
+ */
+static void unescape(std::string& s)
+{
+ replace_substring(s, "~1", "/");
+ replace_substring(s, "~0", "~");
+}
+
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/input/position_t.hpp>
+
+
+#include <cstddef> // size_t
+
+namespace nlohmann
+{
+namespace detail
+{
+/// struct to capture the start position of the current token
+struct position_t
+{
+ /// the total number of characters read
+ std::size_t chars_read_total = 0;
+ /// the number of characters read in the current line
+ std::size_t chars_read_current_line = 0;
+ /// the number of lines read
+ std::size_t lines_read = 0;
+
+ /// conversion to size_t to preserve SAX interface
+ constexpr operator size_t() const
+ {
+ return chars_read_total;
+ }
+};
+
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+////////////////
+// exceptions //
+////////////////
+
+/// @brief general exception of the @ref basic_json class
+/// @sa https://json.nlohmann.me/api/basic_json/exception/
+class exception : public std::exception
+{
+ public:
+ /// returns the explanatory string
+ const char* what() const noexcept override
+ {
+ return m.what();
+ }
+
+ /// the id of the exception
+ const int id; // NOLINT(cppcoreguidelines-non-private-member-variables-in-classes)
+
+ protected:
+ JSON_HEDLEY_NON_NULL(3)
+ exception(int id_, const char* what_arg) : id(id_), m(what_arg) {} // NOLINT(bugprone-throw-keyword-missing)
+
+ static std::string name(const std::string& ename, int id_)
+ {
+ return "[json.exception." + ename + "." + std::to_string(id_) + "] ";
+ }
+
+ template<typename BasicJsonType>
+ static std::string diagnostics(const BasicJsonType& leaf_element)
+ {
+#if JSON_DIAGNOSTICS
+ std::vector<std::string> tokens;
+ for (const auto* current = &leaf_element; current->m_parent != nullptr; current = current->m_parent)
+ {
+ switch (current->m_parent->type())
+ {
+ case value_t::array:
+ {
+ for (std::size_t i = 0; i < current->m_parent->m_value.array->size(); ++i)
+ {
+ if (¤t->m_parent->m_value.array->operator[](i) == current)
+ {
+ tokens.emplace_back(std::to_string(i));
+ break;
+ }
+ }
+ break;
+ }
+
+ case value_t::object:
+ {
+ for (const auto& element : *current->m_parent->m_value.object)
+ {
+ if (&element.second == current)
+ {
+ tokens.emplace_back(element.first.c_str());
+ break;
+ }
+ }
+ break;
+ }
+
+ case value_t::null: // LCOV_EXCL_LINE
+ case value_t::string: // LCOV_EXCL_LINE
+ case value_t::boolean: // LCOV_EXCL_LINE
+ case value_t::number_integer: // LCOV_EXCL_LINE
+ case value_t::number_unsigned: // LCOV_EXCL_LINE
+ case value_t::number_float: // LCOV_EXCL_LINE
+ case value_t::binary: // LCOV_EXCL_LINE
+ case value_t::discarded: // LCOV_EXCL_LINE
+ default: // LCOV_EXCL_LINE
+ break; // LCOV_EXCL_LINE
+ }
+ }
+
+ if (tokens.empty())
+ {
+ return "";
+ }
+
+ return "(" + std::accumulate(tokens.rbegin(), tokens.rend(), std::string{},
+ [](const std::string & a, const std::string & b)
+ {
+ return a + "/" + detail::escape(b);
+ }) + ") ";
+#else
+ static_cast<void>(leaf_element);
+ return "";
+#endif
+ }
+
+ private:
+ /// an exception object as storage for error messages
+ std::runtime_error m;
+};
+
+/// @brief exception indicating a parse error
+/// @sa https://json.nlohmann.me/api/basic_json/parse_error/
+class parse_error : public exception
+{
+ public:
+ /*!
+ @brief create a parse error exception
+ @param[in] id_ the id of the exception
+ @param[in] pos the position where the error occurred (or with
+ chars_read_total=0 if the position cannot be
+ determined)
+ @param[in] what_arg the explanatory string
+ @return parse_error object
+ */
+ template<typename BasicJsonType>
+ static parse_error create(int id_, const position_t& pos, const std::string& what_arg, const BasicJsonType& context)
+ {
+ std::string w = exception::name("parse_error", id_) + "parse error" +
+ position_string(pos) + ": " + exception::diagnostics(context) + what_arg;
+ return {id_, pos.chars_read_total, w.c_str()};
+ }
+
+ template<typename BasicJsonType>
+ static parse_error create(int id_, std::size_t byte_, const std::string& what_arg, const BasicJsonType& context)
+ {
+ std::string w = exception::name("parse_error", id_) + "parse error" +
+ (byte_ != 0 ? (" at byte " + std::to_string(byte_)) : "") +
+ ": " + exception::diagnostics(context) + what_arg;
+ return {id_, byte_, w.c_str()};
+ }
+
+ /*!
+ @brief byte index of the parse error
+
+ The byte index of the last read character in the input file.
+
+ @note For an input with n bytes, 1 is the index of the first character and
+ n+1 is the index of the terminating null byte or the end of file.
+ This also holds true when reading a byte vector (CBOR or MessagePack).
+ */
+ const std::size_t byte;
+
+ private:
+ parse_error(int id_, std::size_t byte_, const char* what_arg)
+ : exception(id_, what_arg), byte(byte_) {}
+
+ static std::string position_string(const position_t& pos)
+ {
+ return " at line " + std::to_string(pos.lines_read + 1) +
+ ", column " + std::to_string(pos.chars_read_current_line);
+ }
+};
+
+/// @brief exception indicating errors with iterators
+/// @sa https://json.nlohmann.me/api/basic_json/invalid_iterator/
+class invalid_iterator : public exception
+{
+ public:
+ template<typename BasicJsonType>
+ static invalid_iterator create(int id_, const std::string& what_arg, const BasicJsonType& context)
+ {
+ std::string w = exception::name("invalid_iterator", id_) + exception::diagnostics(context) + what_arg;
+ return {id_, w.c_str()};
+ }
+
+ private:
+ JSON_HEDLEY_NON_NULL(3)
+ invalid_iterator(int id_, const char* what_arg)
+ : exception(id_, what_arg) {}
+};
+
+/// @brief exception indicating executing a member function with a wrong type
+/// @sa https://json.nlohmann.me/api/basic_json/type_error/
+class type_error : public exception
+{
+ public:
+ template<typename BasicJsonType>
+ static type_error create(int id_, const std::string& what_arg, const BasicJsonType& context)
+ {
+ std::string w = exception::name("type_error", id_) + exception::diagnostics(context) + what_arg;
+ return {id_, w.c_str()};
+ }
+
+ private:
+ JSON_HEDLEY_NON_NULL(3)
+ type_error(int id_, const char* what_arg) : exception(id_, what_arg) {}
+};
+
+/// @brief exception indicating access out of the defined range
+/// @sa https://json.nlohmann.me/api/basic_json/out_of_range/
+class out_of_range : public exception
+{
+ public:
+ template<typename BasicJsonType>
+ static out_of_range create(int id_, const std::string& what_arg, const BasicJsonType& context)
+ {
+ std::string w = exception::name("out_of_range", id_) + exception::diagnostics(context) + what_arg;
+ return {id_, w.c_str()};
+ }
+
+ private:
+ JSON_HEDLEY_NON_NULL(3)
+ out_of_range(int id_, const char* what_arg) : exception(id_, what_arg) {}
+};
+
+/// @brief exception indicating other library errors
+/// @sa https://json.nlohmann.me/api/basic_json/other_error/
+class other_error : public exception
+{
+ public:
+ template<typename BasicJsonType>
+ static other_error create(int id_, const std::string& what_arg, const BasicJsonType& context)
+ {
+ std::string w = exception::name("other_error", id_) + exception::diagnostics(context) + what_arg;
+ return {id_, w.c_str()};
+ }
+
+ private:
+ JSON_HEDLEY_NON_NULL(3)
+ other_error(int id_, const char* what_arg) : exception(id_, what_arg) {}
+};
+
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+// #include <nlohmann/detail/meta/cpp_future.hpp>
+
+
+#include <cstddef> // size_t
+#include <type_traits> // conditional, enable_if, false_type, integral_constant, is_constructible, is_integral, is_same, remove_cv, remove_reference, true_type
+#include <utility> // index_sequence, make_index_sequence, index_sequence_for
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+
+template<typename T>
+using uncvref_t = typename std::remove_cv<typename std::remove_reference<T>::type>::type;
+
+#ifdef JSON_HAS_CPP_14
+
+// the following utilities are natively available in C++14
+using std::enable_if_t;
+using std::index_sequence;
+using std::make_index_sequence;
+using std::index_sequence_for;
+
+#else
+
+// alias templates to reduce boilerplate
+template<bool B, typename T = void>
+using enable_if_t = typename std::enable_if<B, T>::type;
+
+// The following code is taken from https://github.com/abseil/abseil-cpp/blob/10cb35e459f5ecca5b2ff107635da0bfa41011b4/absl/utility/utility.h
+// which is part of Google Abseil (https://github.com/abseil/abseil-cpp), licensed under the Apache License 2.0.
+
+//// START OF CODE FROM GOOGLE ABSEIL
+
+// integer_sequence
+//
+// Class template representing a compile-time integer sequence. An instantiation
+// of `integer_sequence<T, Ints...>` has a sequence of integers encoded in its
+// type through its template arguments (which is a common need when
+// working with C++11 variadic templates). `absl::integer_sequence` is designed
+// to be a drop-in replacement for C++14's `std::integer_sequence`.
+//
+// Example:
+//
+// template< class T, T... Ints >
+// void user_function(integer_sequence<T, Ints...>);
+//
+// int main()
+// {
+// // user_function's `T` will be deduced to `int` and `Ints...`
+// // will be deduced to `0, 1, 2, 3, 4`.
+// user_function(make_integer_sequence<int, 5>());
+// }
+template <typename T, T... Ints>
+struct integer_sequence
+{
+ using value_type = T;
+ static constexpr std::size_t size() noexcept
+ {
+ return sizeof...(Ints);
+ }
+};
+
+// index_sequence
+//
+// A helper template for an `integer_sequence` of `size_t`,
+// `absl::index_sequence` is designed to be a drop-in replacement for C++14's
+// `std::index_sequence`.
+template <size_t... Ints>
+using index_sequence = integer_sequence<size_t, Ints...>;
+
+namespace utility_internal
+{
+
+template <typename Seq, size_t SeqSize, size_t Rem>
+struct Extend;
+
+// Note that SeqSize == sizeof...(Ints). It's passed explicitly for efficiency.
+template <typename T, T... Ints, size_t SeqSize>
+struct Extend<integer_sequence<T, Ints...>, SeqSize, 0>
+{
+ using type = integer_sequence < T, Ints..., (Ints + SeqSize)... >;
+};
+
+template <typename T, T... Ints, size_t SeqSize>
+struct Extend<integer_sequence<T, Ints...>, SeqSize, 1>
+{
+ using type = integer_sequence < T, Ints..., (Ints + SeqSize)..., 2 * SeqSize >;
+};
+
+// Recursion helper for 'make_integer_sequence<T, N>'.
+// 'Gen<T, N>::type' is an alias for 'integer_sequence<T, 0, 1, ... N-1>'.
+template <typename T, size_t N>
+struct Gen
+{
+ using type =
+ typename Extend < typename Gen < T, N / 2 >::type, N / 2, N % 2 >::type;
+};
+
+template <typename T>
+struct Gen<T, 0>
+{
+ using type = integer_sequence<T>;
+};
+
+} // namespace utility_internal
+
+// Compile-time sequences of integers
+
+// make_integer_sequence
+//
+// This template alias is equivalent to
+// `integer_sequence<int, 0, 1, ..., N-1>`, and is designed to be a drop-in
+// replacement for C++14's `std::make_integer_sequence`.
+template <typename T, T N>
+using make_integer_sequence = typename utility_internal::Gen<T, N>::type;
+
+// make_index_sequence
+//
+// This template alias is equivalent to `index_sequence<0, 1, ..., N-1>`,
+// and is designed to be a drop-in replacement for C++14's
+// `std::make_index_sequence`.
+template <size_t N>
+using make_index_sequence = make_integer_sequence<size_t, N>;
+
+// index_sequence_for
+//
+// Converts a typename pack into an index sequence of the same length, and
+// is designed to be a drop-in replacement for C++14's
+// `std::index_sequence_for()`
+template <typename... Ts>
+using index_sequence_for = make_index_sequence<sizeof...(Ts)>;
+
+//// END OF CODE FROM GOOGLE ABSEIL
+
+#endif
+
+// dispatch utility (taken from ranges-v3)
+template<unsigned N> struct priority_tag : priority_tag < N - 1 > {};
+template<> struct priority_tag<0> {};
+
+// taken from ranges-v3
+template<typename T>
+struct static_const
+{
+ static constexpr T value{};
+};
+
+template<typename T>
+constexpr T static_const<T>::value; // NOLINT(readability-redundant-declaration)
+
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/meta/identity_tag.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+// dispatching helper struct
+template <class T> struct identity_tag {};
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/meta/type_traits.hpp>
+
+
+#include <limits> // numeric_limits
+#include <type_traits> // false_type, is_constructible, is_integral, is_same, true_type
+#include <utility> // declval
+#include <tuple> // tuple
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+
+// #include <nlohmann/detail/iterators/iterator_traits.hpp>
+
+
+#include <iterator> // random_access_iterator_tag
+
+// #include <nlohmann/detail/meta/void_t.hpp>
+
+// #include <nlohmann/detail/meta/cpp_future.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+template<typename It, typename = void>
+struct iterator_types {};
+
+template<typename It>
+struct iterator_types <
+ It,
+ void_t<typename It::difference_type, typename It::value_type, typename It::pointer,
+ typename It::reference, typename It::iterator_category >>
+{
+ using difference_type = typename It::difference_type;
+ using value_type = typename It::value_type;
+ using pointer = typename It::pointer;
+ using reference = typename It::reference;
+ using iterator_category = typename It::iterator_category;
+};
+
+// This is required as some compilers implement std::iterator_traits in a way that
+// doesn't work with SFINAE. See https://github.com/nlohmann/json/issues/1341.
+template<typename T, typename = void>
+struct iterator_traits
+{
+};
+
+template<typename T>
+struct iterator_traits < T, enable_if_t < !std::is_pointer<T>::value >>
+ : iterator_types<T>
+{
+};
+
+template<typename T>
+struct iterator_traits<T*, enable_if_t<std::is_object<T>::value>>
+{
+ using iterator_category = std::random_access_iterator_tag;
+ using value_type = T;
+ using difference_type = ptrdiff_t;
+ using pointer = T*;
+ using reference = T&;
+};
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/meta/call_std/begin.hpp>
+
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+
+namespace nlohmann
+{
+NLOHMANN_CAN_CALL_STD_FUNC_IMPL(begin);
+} // namespace nlohmann
+
+// #include <nlohmann/detail/meta/call_std/end.hpp>
+
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+
+namespace nlohmann
+{
+NLOHMANN_CAN_CALL_STD_FUNC_IMPL(end);
+} // namespace nlohmann
+
+// #include <nlohmann/detail/meta/cpp_future.hpp>
+
+// #include <nlohmann/detail/meta/detected.hpp>
+
+// #include <nlohmann/json_fwd.hpp>
+#ifndef INCLUDE_NLOHMANN_JSON_FWD_HPP_
+#define INCLUDE_NLOHMANN_JSON_FWD_HPP_
+
+#include <cstdint> // int64_t, uint64_t
+#include <map> // map
+#include <memory> // allocator
+#include <string> // string
+#include <vector> // vector
+
+/*!
+@brief namespace for Niels Lohmann
+@see https://github.com/nlohmann
+@since version 1.0.0
+*/
+namespace nlohmann
+{
+/*!
+@brief default JSONSerializer template argument
+
+This serializer ignores the template arguments and uses ADL
+([argument-dependent lookup](https://en.cppreference.com/w/cpp/language/adl))
+for serialization.
+*/
+template<typename T = void, typename SFINAE = void>
+struct adl_serializer;
+
+/// a class to store JSON values
+/// @sa https://json.nlohmann.me/api/basic_json/
+template<template<typename U, typename V, typename... Args> class ObjectType =
+ std::map,
+ template<typename U, typename... Args> class ArrayType = std::vector,
+ class StringType = std::string, class BooleanType = bool,
+ class NumberIntegerType = std::int64_t,
+ class NumberUnsignedType = std::uint64_t,
+ class NumberFloatType = double,
+ template<typename U> class AllocatorType = std::allocator,
+ template<typename T, typename SFINAE = void> class JSONSerializer =
+ adl_serializer,
+ class BinaryType = std::vector<std::uint8_t>>
+class basic_json;
+
+/// @brief JSON Pointer defines a string syntax for identifying a specific value within a JSON document
+/// @sa https://json.nlohmann.me/api/json_pointer/
+template<typename BasicJsonType>
+class json_pointer;
+
+/*!
+@brief default specialization
+@sa https://json.nlohmann.me/api/json/
+*/
+using json = basic_json<>;
+
+/// @brief a minimal map-like container that preserves insertion order
+/// @sa https://json.nlohmann.me/api/ordered_map/
+template<class Key, class T, class IgnoredLess, class Allocator>
+struct ordered_map;
+
+/// @brief specialization that maintains the insertion order of object keys
+/// @sa https://json.nlohmann.me/api/ordered_json/
+using ordered_json = basic_json<nlohmann::ordered_map>;
+
+} // namespace nlohmann
+
+#endif // INCLUDE_NLOHMANN_JSON_FWD_HPP_
+
+
+namespace nlohmann
+{
+/*!
+@brief detail namespace with internal helper functions
+
+This namespace collects functions that should not be exposed,
+implementations of some @ref basic_json methods, and meta-programming helpers.
+
+@since version 2.1.0
+*/
+namespace detail
+{
+/////////////
+// helpers //
+/////////////
+
+// Note to maintainers:
+//
+// Every trait in this file expects a non CV-qualified type.
+// The only exceptions are in the 'aliases for detected' section
+// (i.e. those of the form: decltype(T::member_function(std::declval<T>())))
+//
+// In this case, T has to be properly CV-qualified to constraint the function arguments
+// (e.g. to_json(BasicJsonType&, const T&))
+
+template<typename> struct is_basic_json : std::false_type {};
+
+NLOHMANN_BASIC_JSON_TPL_DECLARATION
+struct is_basic_json<NLOHMANN_BASIC_JSON_TPL> : std::true_type {};
+
+//////////////////////
+// json_ref helpers //
+//////////////////////
+
+template<typename>
+class json_ref;
+
+template<typename>
+struct is_json_ref : std::false_type {};
+
+template<typename T>
+struct is_json_ref<json_ref<T>> : std::true_type {};
+
+//////////////////////////
+// aliases for detected //
+//////////////////////////
+
+template<typename T>
+using mapped_type_t = typename T::mapped_type;
+
+template<typename T>
+using key_type_t = typename T::key_type;
+
+template<typename T>
+using value_type_t = typename T::value_type;
+
+template<typename T>
+using difference_type_t = typename T::difference_type;
+
+template<typename T>
+using pointer_t = typename T::pointer;
+
+template<typename T>
+using reference_t = typename T::reference;
+
+template<typename T>
+using iterator_category_t = typename T::iterator_category;
+
+template<typename T, typename... Args>
+using to_json_function = decltype(T::to_json(std::declval<Args>()...));
+
+template<typename T, typename... Args>
+using from_json_function = decltype(T::from_json(std::declval<Args>()...));
+
+template<typename T, typename U>
+using get_template_function = decltype(std::declval<T>().template get<U>());
+
+// trait checking if JSONSerializer<T>::from_json(json const&, udt&) exists
+template<typename BasicJsonType, typename T, typename = void>
+struct has_from_json : std::false_type {};
+
+// trait checking if j.get<T> is valid
+// use this trait instead of std::is_constructible or std::is_convertible,
+// both rely on, or make use of implicit conversions, and thus fail when T
+// has several constructors/operator= (see https://github.com/nlohmann/json/issues/958)
+template <typename BasicJsonType, typename T>
+struct is_getable
+{
+ static constexpr bool value = is_detected<get_template_function, const BasicJsonType&, T>::value;
+};
+
+template<typename BasicJsonType, typename T>
+struct has_from_json < BasicJsonType, T, enable_if_t < !is_basic_json<T>::value >>
+{
+ using serializer = typename BasicJsonType::template json_serializer<T, void>;
+
+ static constexpr bool value =
+ is_detected_exact<void, from_json_function, serializer,
+ const BasicJsonType&, T&>::value;
+};
+
+// This trait checks if JSONSerializer<T>::from_json(json const&) exists
+// this overload is used for non-default-constructible user-defined-types
+template<typename BasicJsonType, typename T, typename = void>
+struct has_non_default_from_json : std::false_type {};
+
+template<typename BasicJsonType, typename T>
+struct has_non_default_from_json < BasicJsonType, T, enable_if_t < !is_basic_json<T>::value >>
+{
+ using serializer = typename BasicJsonType::template json_serializer<T, void>;
+
+ static constexpr bool value =
+ is_detected_exact<T, from_json_function, serializer,
+ const BasicJsonType&>::value;
+};
+
+// This trait checks if BasicJsonType::json_serializer<T>::to_json exists
+// Do not evaluate the trait when T is a basic_json type, to avoid template instantiation infinite recursion.
+template<typename BasicJsonType, typename T, typename = void>
+struct has_to_json : std::false_type {};
+
+template<typename BasicJsonType, typename T>
+struct has_to_json < BasicJsonType, T, enable_if_t < !is_basic_json<T>::value >>
+{
+ using serializer = typename BasicJsonType::template json_serializer<T, void>;
+
+ static constexpr bool value =
+ is_detected_exact<void, to_json_function, serializer, BasicJsonType&,
+ T>::value;
+};
+
+
+///////////////////
+// is_ functions //
+///////////////////
+
+// https://en.cppreference.com/w/cpp/types/conjunction
+template<class...> struct conjunction : std::true_type { };
+template<class B1> struct conjunction<B1> : B1 { };
+template<class B1, class... Bn>
+struct conjunction<B1, Bn...>
+: std::conditional<bool(B1::value), conjunction<Bn...>, B1>::type {};
+
+// https://en.cppreference.com/w/cpp/types/negation
+template<class B> struct negation : std::integral_constant < bool, !B::value > { };
+
+// Reimplementation of is_constructible and is_default_constructible, due to them being broken for
+// std::pair and std::tuple until LWG 2367 fix (see https://cplusplus.github.io/LWG/lwg-defects.html#2367).
+// This causes compile errors in e.g. clang 3.5 or gcc 4.9.
+template <typename T>
+struct is_default_constructible : std::is_default_constructible<T> {};
+
+template <typename T1, typename T2>
+struct is_default_constructible<std::pair<T1, T2>>
+ : conjunction<is_default_constructible<T1>, is_default_constructible<T2>> {};
+
+template <typename T1, typename T2>
+struct is_default_constructible<const std::pair<T1, T2>>
+ : conjunction<is_default_constructible<T1>, is_default_constructible<T2>> {};
+
+template <typename... Ts>
+struct is_default_constructible<std::tuple<Ts...>>
+ : conjunction<is_default_constructible<Ts>...> {};
+
+template <typename... Ts>
+struct is_default_constructible<const std::tuple<Ts...>>
+ : conjunction<is_default_constructible<Ts>...> {};
+
+
+template <typename T, typename... Args>
+struct is_constructible : std::is_constructible<T, Args...> {};
+
+template <typename T1, typename T2>
+struct is_constructible<std::pair<T1, T2>> : is_default_constructible<std::pair<T1, T2>> {};
+
+template <typename T1, typename T2>
+struct is_constructible<const std::pair<T1, T2>> : is_default_constructible<const std::pair<T1, T2>> {};
+
+template <typename... Ts>
+struct is_constructible<std::tuple<Ts...>> : is_default_constructible<std::tuple<Ts...>> {};
+
+template <typename... Ts>
+struct is_constructible<const std::tuple<Ts...>> : is_default_constructible<const std::tuple<Ts...>> {};
+
+
+template<typename T, typename = void>
+struct is_iterator_traits : std::false_type {};
+
+template<typename T>
+struct is_iterator_traits<iterator_traits<T>>
+{
+ private:
+ using traits = iterator_traits<T>;
+
+ public:
+ static constexpr auto value =
+ is_detected<value_type_t, traits>::value &&
+ is_detected<difference_type_t, traits>::value &&
+ is_detected<pointer_t, traits>::value &&
+ is_detected<iterator_category_t, traits>::value &&
+ is_detected<reference_t, traits>::value;
+};
+
+template<typename T>
+struct is_range
+{
+ private:
+ using t_ref = typename std::add_lvalue_reference<T>::type;
+
+ using iterator = detected_t<result_of_begin, t_ref>;
+ using sentinel = detected_t<result_of_end, t_ref>;
+
+ // to be 100% correct, it should use https://en.cppreference.com/w/cpp/iterator/input_or_output_iterator
+ // and https://en.cppreference.com/w/cpp/iterator/sentinel_for
+ // but reimplementing these would be too much work, as a lot of other concepts are used underneath
+ static constexpr auto is_iterator_begin =
+ is_iterator_traits<iterator_traits<iterator>>::value;
+
+ public:
+ static constexpr bool value = !std::is_same<iterator, nonesuch>::value && !std::is_same<sentinel, nonesuch>::value && is_iterator_begin;
+};
+
+template<typename R>
+using iterator_t = enable_if_t<is_range<R>::value, result_of_begin<decltype(std::declval<R&>())>>;
+
+template<typename T>
+using range_value_t = value_type_t<iterator_traits<iterator_t<T>>>;
+
+// The following implementation of is_complete_type is taken from
+// https://blogs.msdn.microsoft.com/vcblog/2015/12/02/partial-support-for-expression-sfinae-in-vs-2015-update-1/
+// and is written by Xiang Fan who agreed to using it in this library.
+
+template<typename T, typename = void>
+struct is_complete_type : std::false_type {};
+
+template<typename T>
+struct is_complete_type<T, decltype(void(sizeof(T)))> : std::true_type {};
+
+template<typename BasicJsonType, typename CompatibleObjectType,
+ typename = void>
+struct is_compatible_object_type_impl : std::false_type {};
+
+template<typename BasicJsonType, typename CompatibleObjectType>
+struct is_compatible_object_type_impl <
+ BasicJsonType, CompatibleObjectType,
+ enable_if_t < is_detected<mapped_type_t, CompatibleObjectType>::value&&
+ is_detected<key_type_t, CompatibleObjectType>::value >>
+{
+ using object_t = typename BasicJsonType::object_t;
+
+ // macOS's is_constructible does not play well with nonesuch...
+ static constexpr bool value =
+ is_constructible<typename object_t::key_type,
+ typename CompatibleObjectType::key_type>::value &&
+ is_constructible<typename object_t::mapped_type,
+ typename CompatibleObjectType::mapped_type>::value;
+};
+
+template<typename BasicJsonType, typename CompatibleObjectType>
+struct is_compatible_object_type
+ : is_compatible_object_type_impl<BasicJsonType, CompatibleObjectType> {};
+
+template<typename BasicJsonType, typename ConstructibleObjectType,
+ typename = void>
+struct is_constructible_object_type_impl : std::false_type {};
+
+template<typename BasicJsonType, typename ConstructibleObjectType>
+struct is_constructible_object_type_impl <
+ BasicJsonType, ConstructibleObjectType,
+ enable_if_t < is_detected<mapped_type_t, ConstructibleObjectType>::value&&
+ is_detected<key_type_t, ConstructibleObjectType>::value >>
+{
+ using object_t = typename BasicJsonType::object_t;
+
+ static constexpr bool value =
+ (is_default_constructible<ConstructibleObjectType>::value &&
+ (std::is_move_assignable<ConstructibleObjectType>::value ||
+ std::is_copy_assignable<ConstructibleObjectType>::value) &&
+ (is_constructible<typename ConstructibleObjectType::key_type,
+ typename object_t::key_type>::value &&
+ std::is_same <
+ typename object_t::mapped_type,
+ typename ConstructibleObjectType::mapped_type >::value)) ||
+ (has_from_json<BasicJsonType,
+ typename ConstructibleObjectType::mapped_type>::value ||
+ has_non_default_from_json <
+ BasicJsonType,
+ typename ConstructibleObjectType::mapped_type >::value);
+};
+
+template<typename BasicJsonType, typename ConstructibleObjectType>
+struct is_constructible_object_type
+ : is_constructible_object_type_impl<BasicJsonType,
+ ConstructibleObjectType> {};
+
+template<typename BasicJsonType, typename CompatibleStringType>
+struct is_compatible_string_type
+{
+ static constexpr auto value =
+ is_constructible<typename BasicJsonType::string_t, CompatibleStringType>::value;
+};
+
+template<typename BasicJsonType, typename ConstructibleStringType>
+struct is_constructible_string_type
+{
+ static constexpr auto value =
+ is_constructible<ConstructibleStringType,
+ typename BasicJsonType::string_t>::value;
+};
+
+template<typename BasicJsonType, typename CompatibleArrayType, typename = void>
+struct is_compatible_array_type_impl : std::false_type {};
+
+template<typename BasicJsonType, typename CompatibleArrayType>
+struct is_compatible_array_type_impl <
+ BasicJsonType, CompatibleArrayType,
+ enable_if_t <
+ is_detected<iterator_t, CompatibleArrayType>::value&&
+ is_iterator_traits<iterator_traits<detected_t<iterator_t, CompatibleArrayType>>>::value&&
+// special case for types like std::filesystem::path whose iterator's value_type are themselves
+// c.f. https://github.com/nlohmann/json/pull/3073
+ !std::is_same<CompatibleArrayType, detected_t<range_value_t, CompatibleArrayType>>::value >>
+{
+ static constexpr bool value =
+ is_constructible<BasicJsonType,
+ range_value_t<CompatibleArrayType>>::value;
+};
+
+template<typename BasicJsonType, typename CompatibleArrayType>
+struct is_compatible_array_type
+ : is_compatible_array_type_impl<BasicJsonType, CompatibleArrayType> {};
+
+template<typename BasicJsonType, typename ConstructibleArrayType, typename = void>
+struct is_constructible_array_type_impl : std::false_type {};
+
+template<typename BasicJsonType, typename ConstructibleArrayType>
+struct is_constructible_array_type_impl <
+ BasicJsonType, ConstructibleArrayType,
+ enable_if_t<std::is_same<ConstructibleArrayType,
+ typename BasicJsonType::value_type>::value >>
+ : std::true_type {};
+
+template<typename BasicJsonType, typename ConstructibleArrayType>
+struct is_constructible_array_type_impl <
+ BasicJsonType, ConstructibleArrayType,
+ enable_if_t < !std::is_same<ConstructibleArrayType,
+ typename BasicJsonType::value_type>::value&&
+ !is_compatible_string_type<BasicJsonType, ConstructibleArrayType>::value&&
+ is_default_constructible<ConstructibleArrayType>::value&&
+(std::is_move_assignable<ConstructibleArrayType>::value ||
+ std::is_copy_assignable<ConstructibleArrayType>::value)&&
+is_detected<iterator_t, ConstructibleArrayType>::value&&
+is_iterator_traits<iterator_traits<detected_t<iterator_t, ConstructibleArrayType>>>::value&&
+is_detected<range_value_t, ConstructibleArrayType>::value&&
+// special case for types like std::filesystem::path whose iterator's value_type are themselves
+// c.f. https://github.com/nlohmann/json/pull/3073
+!std::is_same<ConstructibleArrayType, detected_t<range_value_t, ConstructibleArrayType>>::value&&
+ is_complete_type <
+ detected_t<range_value_t, ConstructibleArrayType >>::value >>
+{
+ using value_type = range_value_t<ConstructibleArrayType>;
+
+ static constexpr bool value =
+ std::is_same<value_type,
+ typename BasicJsonType::array_t::value_type>::value ||
+ has_from_json<BasicJsonType,
+ value_type>::value ||
+ has_non_default_from_json <
+ BasicJsonType,
+ value_type >::value;
+};
+
+template<typename BasicJsonType, typename ConstructibleArrayType>
+struct is_constructible_array_type
+ : is_constructible_array_type_impl<BasicJsonType, ConstructibleArrayType> {};
+
+template<typename RealIntegerType, typename CompatibleNumberIntegerType,
+ typename = void>
+struct is_compatible_integer_type_impl : std::false_type {};
+
+template<typename RealIntegerType, typename CompatibleNumberIntegerType>
+struct is_compatible_integer_type_impl <
+ RealIntegerType, CompatibleNumberIntegerType,
+ enable_if_t < std::is_integral<RealIntegerType>::value&&
+ std::is_integral<CompatibleNumberIntegerType>::value&&
+ !std::is_same<bool, CompatibleNumberIntegerType>::value >>
+{
+ // is there an assert somewhere on overflows?
+ using RealLimits = std::numeric_limits<RealIntegerType>;
+ using CompatibleLimits = std::numeric_limits<CompatibleNumberIntegerType>;
+
+ static constexpr auto value =
+ is_constructible<RealIntegerType,
+ CompatibleNumberIntegerType>::value &&
+ CompatibleLimits::is_integer &&
+ RealLimits::is_signed == CompatibleLimits::is_signed;
+};
+
+template<typename RealIntegerType, typename CompatibleNumberIntegerType>
+struct is_compatible_integer_type
+ : is_compatible_integer_type_impl<RealIntegerType,
+ CompatibleNumberIntegerType> {};
+
+template<typename BasicJsonType, typename CompatibleType, typename = void>
+struct is_compatible_type_impl: std::false_type {};
+
+template<typename BasicJsonType, typename CompatibleType>
+struct is_compatible_type_impl <
+ BasicJsonType, CompatibleType,
+ enable_if_t<is_complete_type<CompatibleType>::value >>
+{
+ static constexpr bool value =
+ has_to_json<BasicJsonType, CompatibleType>::value;
+};
+
+template<typename BasicJsonType, typename CompatibleType>
+struct is_compatible_type
+ : is_compatible_type_impl<BasicJsonType, CompatibleType> {};
+
+template<typename T1, typename T2>
+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>...> {};
+
+// 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>
+struct is_ordered_map
+{
+ using one = char;
+
+ struct two
+ {
+ char x[2]; // NOLINT(cppcoreguidelines-avoid-c-arrays,hicpp-avoid-c-arrays,modernize-avoid-c-arrays)
+ };
+
+ template <typename C> static one test( decltype(&C::capacity) ) ;
+ template <typename C> static two test(...);
+
+ enum { value = sizeof(test<T>(nullptr)) == sizeof(char) }; // NOLINT(cppcoreguidelines-pro-type-vararg,hicpp-vararg)
+};
+
+// to avoid useless casts (see https://github.com/nlohmann/json/issues/2893#issuecomment-889152324)
+template < typename T, typename U, enable_if_t < !std::is_same<T, U>::value, int > = 0 >
+T conditional_static_cast(U value)
+{
+ return static_cast<T>(value);
+}
+
+template<typename T, typename U, enable_if_t<std::is_same<T, U>::value, int> = 0>
+T conditional_static_cast(U value)
+{
+ return value;
+}
+
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/value_t.hpp>
+
+
+#if JSON_HAS_EXPERIMENTAL_FILESYSTEM
+#include <experimental/filesystem>
+namespace nlohmann::detail
+{
+namespace std_fs = std::experimental::filesystem;
+} // namespace nlohmann::detail
+#elif JSON_HAS_FILESYSTEM
+#include <filesystem>
+namespace nlohmann::detail
+{
+namespace std_fs = std::filesystem;
+} // namespace nlohmann::detail
+#endif
+
+namespace nlohmann
+{
+namespace detail
+{
+template<typename BasicJsonType>
+void from_json(const BasicJsonType& j, typename std::nullptr_t& n)
+{
+ if (JSON_HEDLEY_UNLIKELY(!j.is_null()))
+ {
+ JSON_THROW(type_error::create(302, "type must be null, but is " + std::string(j.type_name()), j));
+ }
+ n = nullptr;
+}
+
+// overloads for basic_json template parameters
+template < typename BasicJsonType, typename ArithmeticType,
+ enable_if_t < std::is_arithmetic<ArithmeticType>::value&&
+ !std::is_same<ArithmeticType, typename BasicJsonType::boolean_t>::value,
+ int > = 0 >
+void get_arithmetic_value(const BasicJsonType& j, ArithmeticType& val)
+{
+ switch (static_cast<value_t>(j))
+ {
+ case value_t::number_unsigned:
+ {
+ val = static_cast<ArithmeticType>(*j.template get_ptr<const typename BasicJsonType::number_unsigned_t*>());
+ break;
+ }
+ case value_t::number_integer:
+ {
+ val = static_cast<ArithmeticType>(*j.template get_ptr<const typename BasicJsonType::number_integer_t*>());
+ break;
+ }
+ case value_t::number_float:
+ {
+ val = static_cast<ArithmeticType>(*j.template get_ptr<const typename BasicJsonType::number_float_t*>());
+ break;
+ }
+
+ case value_t::null:
+ case value_t::object:
+ case value_t::array:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ JSON_THROW(type_error::create(302, "type must be number, but is " + std::string(j.type_name()), j));
+ }
+}
+
+template<typename BasicJsonType>
+void from_json(const BasicJsonType& j, typename BasicJsonType::boolean_t& b)
+{
+ if (JSON_HEDLEY_UNLIKELY(!j.is_boolean()))
+ {
+ JSON_THROW(type_error::create(302, "type must be boolean, but is " + std::string(j.type_name()), j));
+ }
+ b = *j.template get_ptr<const typename BasicJsonType::boolean_t*>();
+}
+
+template<typename BasicJsonType>
+void from_json(const BasicJsonType& j, typename BasicJsonType::string_t& s)
+{
+ if (JSON_HEDLEY_UNLIKELY(!j.is_string()))
+ {
+ JSON_THROW(type_error::create(302, "type must be string, but is " + std::string(j.type_name()), j));
+ }
+ s = *j.template get_ptr<const typename BasicJsonType::string_t*>();
+}
+
+template <
+ typename BasicJsonType, typename ConstructibleStringType,
+ enable_if_t <
+ is_constructible_string_type<BasicJsonType, ConstructibleStringType>::value&&
+ !std::is_same<typename BasicJsonType::string_t,
+ ConstructibleStringType>::value,
+ int > = 0 >
+void from_json(const BasicJsonType& j, ConstructibleStringType& s)
+{
+ if (JSON_HEDLEY_UNLIKELY(!j.is_string()))
+ {
+ JSON_THROW(type_error::create(302, "type must be string, but is " + std::string(j.type_name()), j));
+ }
+
+ s = *j.template get_ptr<const typename BasicJsonType::string_t*>();
+}
+
+template<typename BasicJsonType>
+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)
+{
+ get_arithmetic_value(j, val);
+}
+
+template<typename BasicJsonType>
+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)
+{
+ typename std::underlying_type<EnumType>::type val;
+ get_arithmetic_value(j, val);
+ e = static_cast<EnumType>(val);
+}
+
+// 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)
+{
+ if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
+ {
+ JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ }
+ l.clear();
+ std::transform(j.rbegin(), j.rend(),
+ std::front_inserter(l), [](const BasicJsonType & i)
+ {
+ return i.template get<T>();
+ });
+}
+
+// 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)
+{
+ if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
+ {
+ JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ }
+ l.resize(j.size());
+ std::transform(j.begin(), j.end(), std::begin(l),
+ [](const BasicJsonType & elem)
+ {
+ return elem.template get<T>();
+ });
+}
+
+template<typename BasicJsonType, typename T, std::size_t N>
+auto from_json(const BasicJsonType& j, T (&arr)[N]) // NOLINT(cppcoreguidelines-avoid-c-arrays,hicpp-avoid-c-arrays,modernize-avoid-c-arrays)
+-> decltype(j.template get<T>(), void())
+{
+ for (std::size_t i = 0; i < N; ++i)
+ {
+ arr[i] = j.at(i).template get<T>();
+ }
+}
+
+template<typename BasicJsonType>
+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*>();
+}
+
+template<typename BasicJsonType, typename T, std::size_t N>
+auto from_json_array_impl(const BasicJsonType& j, std::array<T, N>& arr,
+ priority_tag<2> /*unused*/)
+-> decltype(j.template get<T>(), void())
+{
+ for (std::size_t i = 0; i < N; ++i)
+ {
+ arr[i] = j.at(i).template get<T>();
+ }
+}
+
+template<typename BasicJsonType, typename ConstructibleArrayType,
+ enable_if_t<
+ std::is_assignable<ConstructibleArrayType&, ConstructibleArrayType>::value,
+ int> = 0>
+auto from_json_array_impl(const BasicJsonType& j, ConstructibleArrayType& arr, priority_tag<1> /*unused*/)
+-> decltype(
+ arr.reserve(std::declval<typename ConstructibleArrayType::size_type>()),
+ j.template get<typename ConstructibleArrayType::value_type>(),
+ void())
+{
+ using std::end;
+
+ ConstructibleArrayType ret;
+ ret.reserve(j.size());
+ std::transform(j.begin(), j.end(),
+ std::inserter(ret, end(ret)), [](const BasicJsonType & i)
+ {
+ // get<BasicJsonType>() returns *this, this won't call a from_json
+ // method when value_type is BasicJsonType
+ return i.template get<typename ConstructibleArrayType::value_type>();
+ });
+ arr = std::move(ret);
+}
+
+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*/)
+{
+ using std::end;
+
+ ConstructibleArrayType ret;
+ std::transform(
+ j.begin(), j.end(), std::inserter(ret, end(ret)),
+ [](const BasicJsonType & i)
+ {
+ // get<BasicJsonType>() returns *this, this won't call a from_json
+ // method when value_type is BasicJsonType
+ return i.template get<typename ConstructibleArrayType::value_type>();
+ });
+ arr = std::move(ret);
+}
+
+template < typename BasicJsonType, typename ConstructibleArrayType,
+ enable_if_t <
+ is_constructible_array_type<BasicJsonType, ConstructibleArrayType>::value&&
+ !is_constructible_object_type<BasicJsonType, ConstructibleArrayType>::value&&
+ !is_constructible_string_type<BasicJsonType, ConstructibleArrayType>::value&&
+ !std::is_same<ConstructibleArrayType, typename BasicJsonType::binary_t>::value&&
+ !is_basic_json<ConstructibleArrayType>::value,
+ int > = 0 >
+auto from_json(const BasicJsonType& j, ConstructibleArrayType& arr)
+-> decltype(from_json_array_impl(j, arr, priority_tag<3> {}),
+j.template get<typename ConstructibleArrayType::value_type>(),
+void())
+{
+ if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
+ {
+ JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ }
+
+ from_json_array_impl(j, arr, priority_tag<3> {});
+}
+
+template < typename BasicJsonType, typename T, std::size_t... Idx >
+std::array<T, sizeof...(Idx)> from_json_inplace_array_impl(BasicJsonType&& j,
+ identity_tag<std::array<T, sizeof...(Idx)>> /*unused*/, index_sequence<Idx...> /*unused*/)
+{
+ return { { std::forward<BasicJsonType>(j).at(Idx).template get<T>()... } };
+}
+
+template < typename BasicJsonType, typename T, std::size_t N >
+auto from_json(BasicJsonType&& j, identity_tag<std::array<T, N>> tag)
+-> decltype(from_json_inplace_array_impl(std::forward<BasicJsonType>(j), tag, make_index_sequence<N> {}))
+{
+ if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
+ {
+ JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ }
+
+ return from_json_inplace_array_impl(std::forward<BasicJsonType>(j), tag, make_index_sequence<N> {});
+}
+
+template<typename BasicJsonType>
+void from_json(const BasicJsonType& j, typename BasicJsonType::binary_t& bin)
+{
+ if (JSON_HEDLEY_UNLIKELY(!j.is_binary()))
+ {
+ JSON_THROW(type_error::create(302, "type must be binary, but is " + std::string(j.type_name()), j));
+ }
+
+ bin = *j.template get_ptr<const typename BasicJsonType::binary_t*>();
+}
+
+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)
+{
+ if (JSON_HEDLEY_UNLIKELY(!j.is_object()))
+ {
+ JSON_THROW(type_error::create(302, "type must be object, but is " + std::string(j.type_name()), j));
+ }
+
+ ConstructibleObjectType ret;
+ const auto* inner_object = j.template get_ptr<const typename BasicJsonType::object_t*>();
+ using value_type = typename ConstructibleObjectType::value_type;
+ std::transform(
+ inner_object->begin(), inner_object->end(),
+ std::inserter(ret, ret.begin()),
+ [](typename BasicJsonType::object_t::value_type const & p)
+ {
+ return value_type(p.first, p.second.template get<typename ConstructibleObjectType::mapped_type>());
+ });
+ obj = std::move(ret);
+}
+
+// overload for arithmetic types, not chosen for basic_json template arguments
+// (BooleanType, etc..); note: Is it really necessary to provide explicit
+// overloads for boolean_t etc. in case of a custom BooleanType which is not
+// an arithmetic type?
+template < typename BasicJsonType, typename ArithmeticType,
+ enable_if_t <
+ std::is_arithmetic<ArithmeticType>::value&&
+ !std::is_same<ArithmeticType, typename BasicJsonType::number_unsigned_t>::value&&
+ !std::is_same<ArithmeticType, typename BasicJsonType::number_integer_t>::value&&
+ !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)
+{
+ switch (static_cast<value_t>(j))
+ {
+ case value_t::number_unsigned:
+ {
+ val = static_cast<ArithmeticType>(*j.template get_ptr<const typename BasicJsonType::number_unsigned_t*>());
+ break;
+ }
+ case value_t::number_integer:
+ {
+ val = static_cast<ArithmeticType>(*j.template get_ptr<const typename BasicJsonType::number_integer_t*>());
+ break;
+ }
+ case value_t::number_float:
+ {
+ val = static_cast<ArithmeticType>(*j.template get_ptr<const typename BasicJsonType::number_float_t*>());
+ break;
+ }
+ case value_t::boolean:
+ {
+ val = static_cast<ArithmeticType>(*j.template get_ptr<const typename BasicJsonType::boolean_t*>());
+ break;
+ }
+
+ case value_t::null:
+ case value_t::object:
+ case value_t::array:
+ case value_t::string:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ JSON_THROW(type_error::create(302, "type must be number, but is " + std::string(j.type_name()), j));
+ }
+}
+
+template<typename BasicJsonType, typename... Args, std::size_t... Idx>
+std::tuple<Args...> from_json_tuple_impl_base(BasicJsonType&& j, index_sequence<Idx...> /*unused*/)
+{
+ return std::make_tuple(std::forward<BasicJsonType>(j).at(Idx).template get<Args>()...);
+}
+
+template < typename BasicJsonType, class A1, class A2 >
+std::pair<A1, A2> from_json_tuple_impl(BasicJsonType&& j, identity_tag<std::pair<A1, A2>> /*unused*/, priority_tag<0> /*unused*/)
+{
+ return {std::forward<BasicJsonType>(j).at(0).template get<A1>(),
+ std::forward<BasicJsonType>(j).at(1).template get<A2>()};
+}
+
+template<typename BasicJsonType, typename A1, typename A2>
+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> {});
+}
+
+template<typename BasicJsonType, typename... Args>
+std::tuple<Args...> from_json_tuple_impl(BasicJsonType&& j, identity_tag<std::tuple<Args...>> /*unused*/, priority_tag<2> /*unused*/)
+{
+ return from_json_tuple_impl_base<BasicJsonType, Args...>(std::forward<BasicJsonType>(j), index_sequence_for<Args...> {});
+}
+
+template<typename BasicJsonType, typename... Args>
+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...> {});
+}
+
+template<typename BasicJsonType, typename TupleRelated>
+auto from_json(BasicJsonType&& j, TupleRelated&& t)
+-> decltype(from_json_tuple_impl(std::forward<BasicJsonType>(j), std::forward<TupleRelated>(t), priority_tag<3> {}))
+{
+ if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
+ {
+ JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ }
+
+ return from_json_tuple_impl(std::forward<BasicJsonType>(j), std::forward<TupleRelated>(t), priority_tag<3> {});
+}
+
+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)
+{
+ if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
+ {
+ JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ }
+ m.clear();
+ for (const auto& p : j)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!p.is_array()))
+ {
+ JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(p.type_name()), j));
+ }
+ m.emplace(p.at(0).template get<Key>(), p.at(1).template get<Value>());
+ }
+}
+
+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)
+{
+ if (JSON_HEDLEY_UNLIKELY(!j.is_array()))
+ {
+ JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(j.type_name()), j));
+ }
+ m.clear();
+ for (const auto& p : j)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!p.is_array()))
+ {
+ JSON_THROW(type_error::create(302, "type must be array, but is " + std::string(p.type_name()), j));
+ }
+ m.emplace(p.at(0).template get<Key>(), p.at(1).template get<Value>());
+ }
+}
+
+#if JSON_HAS_FILESYSTEM || JSON_HAS_EXPERIMENTAL_FILESYSTEM
+template<typename BasicJsonType>
+void from_json(const BasicJsonType& j, std_fs::path& p)
+{
+ if (JSON_HEDLEY_UNLIKELY(!j.is_string()))
+ {
+ JSON_THROW(type_error::create(302, "type must be string, but is " + std::string(j.type_name()), j));
+ }
+ p = *j.template get_ptr<const typename BasicJsonType::string_t*>();
+}
+#endif
+
+struct from_json_fn
+{
+ template<typename BasicJsonType, typename T>
+ auto operator()(const BasicJsonType& j, T&& val) const
+ noexcept(noexcept(from_json(j, std::forward<T>(val))))
+ -> decltype(from_json(j, std::forward<T>(val)))
+ {
+ return from_json(j, std::forward<T>(val));
+ }
+};
+} // namespace detail
+
+/// 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)
+} // namespace
+} // namespace nlohmann
+
+// #include <nlohmann/detail/conversions/to_json.hpp>
+
+
+#include <algorithm> // copy
+#include <iterator> // begin, end
+#include <string> // string
+#include <tuple> // tuple, get
+#include <type_traits> // is_same, is_constructible, is_floating_point, is_enum, underlying_type
+#include <utility> // move, forward, declval, pair
+#include <valarray> // valarray
+#include <vector> // vector
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+// #include <nlohmann/detail/iterators/iteration_proxy.hpp>
+
+
+#include <cstddef> // size_t
+#include <iterator> // input_iterator_tag
+#include <string> // string, to_string
+#include <tuple> // tuple_size, get, tuple_element
+#include <utility> // move
+
+// #include <nlohmann/detail/meta/type_traits.hpp>
+
+// #include <nlohmann/detail/value_t.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+template<typename string_type>
+void int_to_string( string_type& target, std::size_t value )
+{
+ // For ADL
+ using std::to_string;
+ target = to_string(value);
+}
+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 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;
+ /// an index for arrays (used to create key names)
+ std::size_t array_index = 0;
+ /// last stringified array index
+ mutable std::size_t array_index_last = 0;
+ /// 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{};
+
+ public:
+ explicit iteration_proxy_value(IteratorType it) noexcept
+ : anchor(std::move(it))
+ {}
+
+ /// dereference operator (needed for range-based for)
+ iteration_proxy_value& operator*()
+ {
+ return *this;
+ }
+
+ /// increment operator (needed for range-based for)
+ iteration_proxy_value& operator++()
+ {
+ ++anchor;
+ ++array_index;
+
+ return *this;
+ }
+
+ /// equality operator (needed for InputIterator)
+ bool operator==(const iteration_proxy_value& o) const
+ {
+ return anchor == o.anchor;
+ }
+
+ /// inequality operator (needed for range-based for)
+ bool operator!=(const iteration_proxy_value& o) const
+ {
+ return anchor != o.anchor;
+ }
+
+ /// return key of the iterator
+ const string_type& key() const
+ {
+ JSON_ASSERT(anchor.m_object != nullptr);
+
+ switch (anchor.m_object->type())
+ {
+ // use integer array index as key
+ case value_t::array:
+ {
+ if (array_index != array_index_last)
+ {
+ int_to_string( array_index_str, array_index );
+ array_index_last = array_index;
+ }
+ return array_index_str;
+ }
+
+ // use key from the object
+ case value_t::object:
+ return anchor.key();
+
+ // use an empty key for all primitive types
+ case value_t::null:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ return empty_str;
+ }
+ }
+
+ /// return value of the iterator
+ typename IteratorType::reference value() const
+ {
+ return anchor.value();
+ }
+};
+
+/// proxy class for the items() function
+template<typename IteratorType> class iteration_proxy
+{
+ private:
+ /// the container to iterate
+ typename IteratorType::reference container;
+
+ public:
+ /// construct iteration proxy from a container
+ explicit iteration_proxy(typename IteratorType::reference cont) noexcept
+ : container(cont) {}
+
+ /// return iterator begin (needed for range-based for)
+ iteration_proxy_value<IteratorType> begin() noexcept
+ {
+ return iteration_proxy_value<IteratorType>(container.begin());
+ }
+
+ /// return iterator end (needed for range-based for)
+ iteration_proxy_value<IteratorType> end() noexcept
+ {
+ 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
+template<std::size_t N, typename IteratorType, enable_if_t<N == 0, int> = 0>
+auto get(const nlohmann::detail::iteration_proxy_value<IteratorType>& i) -> decltype(i.key())
+{
+ return i.key();
+}
+// Structured Bindings Support
+// For further reference see https://blog.tartanllama.xyz/structured-bindings/
+// And see https://github.com/nlohmann/json/pull/1391
+template<std::size_t N, typename IteratorType, enable_if_t<N == 1, int> = 0>
+auto get(const nlohmann::detail::iteration_proxy_value<IteratorType>& i) -> decltype(i.value())
+{
+ return i.value();
+}
+} // namespace detail
+} // namespace nlohmann
+
+// The Addition to the STD Namespace is required to add
+// Structured Bindings Support to the iteration_proxy_value class
+// For further reference see https://blog.tartanllama.xyz/structured-bindings/
+// And see https://github.com/nlohmann/json/pull/1391
+namespace std
+{
+#if defined(__clang__)
+ // Fix: https://github.com/nlohmann/json/issues/1401
+ #pragma clang diagnostic push
+ #pragma clang diagnostic ignored "-Wmismatched-tags"
+#endif
+template<typename IteratorType>
+class tuple_size<::nlohmann::detail::iteration_proxy_value<IteratorType>>
+ : public std::integral_constant<std::size_t, 2> {};
+
+template<std::size_t N, typename IteratorType>
+class tuple_element<N, ::nlohmann::detail::iteration_proxy_value<IteratorType >>
+{
+ public:
+ using type = decltype(
+ get<N>(std::declval <
+ ::nlohmann::detail::iteration_proxy_value<IteratorType >> ()));
+};
+#if defined(__clang__)
+ #pragma clang diagnostic pop
+#endif
+} // namespace std
+
+// #include <nlohmann/detail/meta/cpp_future.hpp>
+
+// #include <nlohmann/detail/meta/type_traits.hpp>
+
+// #include <nlohmann/detail/value_t.hpp>
+
+
+#if JSON_HAS_EXPERIMENTAL_FILESYSTEM
+#include <experimental/filesystem>
+namespace nlohmann::detail
+{
+namespace std_fs = std::experimental::filesystem;
+} // namespace nlohmann::detail
+#elif JSON_HAS_FILESYSTEM
+#include <filesystem>
+namespace nlohmann::detail
+{
+namespace std_fs = std::filesystem;
+} // namespace nlohmann::detail
+#endif
+
+namespace nlohmann
+{
+namespace detail
+{
+//////////////////
+// constructors //
+//////////////////
+
+/*
+ * Note all external_constructor<>::construct functions need to call
+ * j.m_value.destroy(j.m_type) to avoid a memory leak in case j contains an
+ * allocated value (e.g., a string). See bug issue
+ * https://github.com/nlohmann/json/issues/2865 for more information.
+ */
+
+template<value_t> struct external_constructor;
+
+template<>
+struct external_constructor<value_t::boolean>
+{
+ template<typename BasicJsonType>
+ static void construct(BasicJsonType& j, typename BasicJsonType::boolean_t b) noexcept
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::boolean;
+ j.m_value = b;
+ j.assert_invariant();
+ }
+};
+
+template<>
+struct external_constructor<value_t::string>
+{
+ template<typename BasicJsonType>
+ static void construct(BasicJsonType& j, const typename BasicJsonType::string_t& s)
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::string;
+ j.m_value = s;
+ j.assert_invariant();
+ }
+
+ template<typename BasicJsonType>
+ static void construct(BasicJsonType& j, typename BasicJsonType::string_t&& s)
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::string;
+ j.m_value = std::move(s);
+ j.assert_invariant();
+ }
+
+ template < typename BasicJsonType, typename CompatibleStringType,
+ enable_if_t < !std::is_same<CompatibleStringType, typename BasicJsonType::string_t>::value,
+ int > = 0 >
+ static void construct(BasicJsonType& j, const CompatibleStringType& str)
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::string;
+ j.m_value.string = j.template create<typename BasicJsonType::string_t>(str);
+ j.assert_invariant();
+ }
+};
+
+template<>
+struct external_constructor<value_t::binary>
+{
+ template<typename BasicJsonType>
+ static void construct(BasicJsonType& j, const typename BasicJsonType::binary_t& b)
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::binary;
+ j.m_value = typename BasicJsonType::binary_t(b);
+ j.assert_invariant();
+ }
+
+ template<typename BasicJsonType>
+ static void construct(BasicJsonType& j, typename BasicJsonType::binary_t&& b)
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::binary;
+ j.m_value = typename BasicJsonType::binary_t(std::move(b));
+ j.assert_invariant();
+ }
+};
+
+template<>
+struct external_constructor<value_t::number_float>
+{
+ template<typename BasicJsonType>
+ static void construct(BasicJsonType& j, typename BasicJsonType::number_float_t val) noexcept
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::number_float;
+ j.m_value = val;
+ j.assert_invariant();
+ }
+};
+
+template<>
+struct external_constructor<value_t::number_unsigned>
+{
+ template<typename BasicJsonType>
+ static void construct(BasicJsonType& j, typename BasicJsonType::number_unsigned_t val) noexcept
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::number_unsigned;
+ j.m_value = val;
+ j.assert_invariant();
+ }
+};
+
+template<>
+struct external_constructor<value_t::number_integer>
+{
+ template<typename BasicJsonType>
+ static void construct(BasicJsonType& j, typename BasicJsonType::number_integer_t val) noexcept
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::number_integer;
+ j.m_value = val;
+ j.assert_invariant();
+ }
+};
+
+template<>
+struct external_constructor<value_t::array>
+{
+ template<typename BasicJsonType>
+ static void construct(BasicJsonType& j, const typename BasicJsonType::array_t& arr)
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::array;
+ j.m_value = arr;
+ j.set_parents();
+ j.assert_invariant();
+ }
+
+ template<typename BasicJsonType>
+ static void construct(BasicJsonType& j, typename BasicJsonType::array_t&& arr)
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::array;
+ j.m_value = std::move(arr);
+ j.set_parents();
+ j.assert_invariant();
+ }
+
+ template < typename BasicJsonType, typename CompatibleArrayType,
+ enable_if_t < !std::is_same<CompatibleArrayType, typename BasicJsonType::array_t>::value,
+ int > = 0 >
+ static void construct(BasicJsonType& j, const CompatibleArrayType& arr)
+ {
+ using std::begin;
+ using std::end;
+
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::array;
+ j.m_value.array = j.template create<typename BasicJsonType::array_t>(begin(arr), end(arr));
+ j.set_parents();
+ j.assert_invariant();
+ }
+
+ template<typename BasicJsonType>
+ static void construct(BasicJsonType& j, const std::vector<bool>& arr)
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::array;
+ j.m_value = value_t::array;
+ j.m_value.array->reserve(arr.size());
+ for (const bool x : arr)
+ {
+ j.m_value.array->push_back(x);
+ j.set_parent(j.m_value.array->back());
+ }
+ j.assert_invariant();
+ }
+
+ template<typename BasicJsonType, typename T,
+ enable_if_t<std::is_convertible<T, BasicJsonType>::value, int> = 0>
+ static void construct(BasicJsonType& j, const std::valarray<T>& arr)
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::array;
+ j.m_value = value_t::array;
+ j.m_value.array->resize(arr.size());
+ if (arr.size() > 0)
+ {
+ std::copy(std::begin(arr), std::end(arr), j.m_value.array->begin());
+ }
+ j.set_parents();
+ j.assert_invariant();
+ }
+};
+
+template<>
+struct external_constructor<value_t::object>
+{
+ template<typename BasicJsonType>
+ static void construct(BasicJsonType& j, const typename BasicJsonType::object_t& obj)
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::object;
+ j.m_value = obj;
+ j.set_parents();
+ j.assert_invariant();
+ }
+
+ template<typename BasicJsonType>
+ static void construct(BasicJsonType& j, typename BasicJsonType::object_t&& obj)
+ {
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::object;
+ j.m_value = std::move(obj);
+ j.set_parents();
+ j.assert_invariant();
+ }
+
+ template < typename BasicJsonType, typename CompatibleObjectType,
+ enable_if_t < !std::is_same<CompatibleObjectType, typename BasicJsonType::object_t>::value, int > = 0 >
+ static void construct(BasicJsonType& j, const CompatibleObjectType& obj)
+ {
+ using std::begin;
+ using std::end;
+
+ j.m_value.destroy(j.m_type);
+ j.m_type = value_t::object;
+ j.m_value.object = j.template create<typename BasicJsonType::object_t>(begin(obj), end(obj));
+ j.set_parents();
+ j.assert_invariant();
+ }
+};
+
+/////////////
+// to_json //
+/////////////
+
+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
+{
+ 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)
+{
+ external_constructor<value_t::string>::construct(j, s);
+}
+
+template<typename BasicJsonType>
+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
+{
+ 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
+{
+ 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
+{
+ 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
+{
+ 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)
+{
+ external_constructor<value_t::array>::construct(j, e);
+}
+
+template < typename BasicJsonType, typename CompatibleArrayType,
+ enable_if_t < is_compatible_array_type<BasicJsonType,
+ CompatibleArrayType>::value&&
+ !is_compatible_object_type<BasicJsonType, CompatibleArrayType>::value&&
+ !is_compatible_string_type<BasicJsonType, CompatibleArrayType>::value&&
+ !std::is_same<typename BasicJsonType::binary_t, CompatibleArrayType>::value&&
+ !is_basic_json<CompatibleArrayType>::value,
+ int > = 0 >
+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)
+{
+ 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)
+{
+ external_constructor<value_t::array>::construct(j, std::move(arr));
+}
+
+template<typename BasicJsonType>
+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)
+{
+ external_constructor<value_t::object>::construct(j, obj);
+}
+
+template<typename BasicJsonType>
+void to_json(BasicJsonType& j, typename BasicJsonType::object_t&& obj)
+{
+ external_constructor<value_t::object>::construct(j, std::move(obj));
+}
+
+template <
+ typename BasicJsonType, typename T, std::size_t N,
+ 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)
+{
+ 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)
+{
+ j = { p.first, p.second };
+}
+
+// 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)
+{
+ 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*/)
+{
+ 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)
+{
+ 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)
+{
+ j = p.string();
+}
+#endif
+
+struct to_json_fn
+{
+ template<typename BasicJsonType, typename T>
+ auto operator()(BasicJsonType& j, T&& val) const noexcept(noexcept(to_json(j, std::forward<T>(val))))
+ -> decltype(to_json(j, std::forward<T>(val)), void())
+ {
+ return to_json(j, std::forward<T>(val));
+ }
+};
+} // namespace detail
+
+/// 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)
+} // namespace
+} // namespace nlohmann
+
+// #include <nlohmann/detail/meta/identity_tag.hpp>
+
+// #include <nlohmann/detail/meta/type_traits.hpp>
+
+
+namespace nlohmann
+{
+
+/// @sa https://json.nlohmann.me/api/adl_serializer/
+template<typename ValueType, typename>
+struct adl_serializer
+{
+ /// @brief convert a JSON value to any value type
+ /// @sa https://json.nlohmann.me/api/adl_serializer/from_json/
+ template<typename BasicJsonType, typename TargetType = ValueType>
+ static auto from_json(BasicJsonType && j, TargetType& val) noexcept(
+ noexcept(::nlohmann::from_json(std::forward<BasicJsonType>(j), val)))
+ -> decltype(::nlohmann::from_json(std::forward<BasicJsonType>(j), val), void())
+ {
+ ::nlohmann::from_json(std::forward<BasicJsonType>(j), val);
+ }
+
+ /// @brief convert a JSON value to any value type
+ /// @sa https://json.nlohmann.me/api/adl_serializer/from_json/
+ template<typename BasicJsonType, typename TargetType = ValueType>
+ static auto from_json(BasicJsonType && j) noexcept(
+ noexcept(::nlohmann::from_json(std::forward<BasicJsonType>(j), detail::identity_tag<TargetType> {})))
+ -> decltype(::nlohmann::from_json(std::forward<BasicJsonType>(j), detail::identity_tag<TargetType> {}))
+ {
+ return ::nlohmann::from_json(std::forward<BasicJsonType>(j), detail::identity_tag<TargetType> {});
+ }
+
+ /// @brief convert any value type to a JSON value
+ /// @sa https://json.nlohmann.me/api/adl_serializer/to_json/
+ template<typename BasicJsonType, typename TargetType = ValueType>
+ static auto to_json(BasicJsonType& j, TargetType && val) noexcept(
+ noexcept(::nlohmann::to_json(j, std::forward<TargetType>(val))))
+ -> decltype(::nlohmann::to_json(j, std::forward<TargetType>(val)), void())
+ {
+ ::nlohmann::to_json(j, std::forward<TargetType>(val));
+ }
+};
+} // namespace nlohmann
+
+// #include <nlohmann/byte_container_with_subtype.hpp>
+
+
+#include <cstdint> // uint8_t, uint64_t
+#include <tuple> // tie
+#include <utility> // move
+
+namespace nlohmann
+{
+
+/// @brief an internal type for a backed binary type
+/// @sa https://json.nlohmann.me/api/byte_container_with_subtype/
+template<typename BinaryType>
+class byte_container_with_subtype : public BinaryType
+{
+ public:
+ using container_type = BinaryType;
+ using subtype_type = std::uint64_t;
+
+ /// @sa https://json.nlohmann.me/api/byte_container_with_subtype/byte_container_with_subtype/
+ byte_container_with_subtype() noexcept(noexcept(container_type()))
+ : container_type()
+ {}
+
+ /// @sa https://json.nlohmann.me/api/byte_container_with_subtype/byte_container_with_subtype/
+ byte_container_with_subtype(const container_type& b) noexcept(noexcept(container_type(b)))
+ : container_type(b)
+ {}
+
+ /// @sa https://json.nlohmann.me/api/byte_container_with_subtype/byte_container_with_subtype/
+ byte_container_with_subtype(container_type&& b) noexcept(noexcept(container_type(std::move(b))))
+ : container_type(std::move(b))
+ {}
+
+ /// @sa https://json.nlohmann.me/api/byte_container_with_subtype/byte_container_with_subtype/
+ byte_container_with_subtype(const container_type& b, subtype_type subtype_) noexcept(noexcept(container_type(b)))
+ : container_type(b)
+ , m_subtype(subtype_)
+ , m_has_subtype(true)
+ {}
+
+ /// @sa https://json.nlohmann.me/api/byte_container_with_subtype/byte_container_with_subtype/
+ byte_container_with_subtype(container_type&& b, subtype_type subtype_) noexcept(noexcept(container_type(std::move(b))))
+ : container_type(std::move(b))
+ , m_subtype(subtype_)
+ , m_has_subtype(true)
+ {}
+
+ bool operator==(const byte_container_with_subtype& rhs) const
+ {
+ return std::tie(static_cast<const BinaryType&>(*this), m_subtype, m_has_subtype) ==
+ std::tie(static_cast<const BinaryType&>(rhs), rhs.m_subtype, rhs.m_has_subtype);
+ }
+
+ bool operator!=(const byte_container_with_subtype& rhs) const
+ {
+ return !(rhs == *this);
+ }
+
+ /// @brief sets the binary subtype
+ /// @sa https://json.nlohmann.me/api/byte_container_with_subtype/set_subtype/
+ void set_subtype(subtype_type subtype_) noexcept
+ {
+ m_subtype = subtype_;
+ m_has_subtype = true;
+ }
+
+ /// @brief return the binary subtype
+ /// @sa https://json.nlohmann.me/api/byte_container_with_subtype/subtype/
+ constexpr subtype_type subtype() const noexcept
+ {
+ return m_has_subtype ? m_subtype : static_cast<subtype_type>(-1);
+ }
+
+ /// @brief return whether the value has a subtype
+ /// @sa https://json.nlohmann.me/api/byte_container_with_subtype/has_subtype/
+ constexpr bool has_subtype() const noexcept
+ {
+ return m_has_subtype;
+ }
+
+ /// @brief clears the binary subtype
+ /// @sa https://json.nlohmann.me/api/byte_container_with_subtype/clear_subtype/
+ void clear_subtype() noexcept
+ {
+ m_subtype = 0;
+ m_has_subtype = false;
+ }
+
+ private:
+ subtype_type m_subtype = 0;
+ bool m_has_subtype = false;
+};
+
+} // namespace nlohmann
+
+// #include <nlohmann/detail/conversions/from_json.hpp>
+
+// #include <nlohmann/detail/conversions/to_json.hpp>
+
+// #include <nlohmann/detail/exceptions.hpp>
+
+// #include <nlohmann/detail/hash.hpp>
+
+
+#include <cstdint> // uint8_t
+#include <cstddef> // size_t
+#include <functional> // hash
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+// #include <nlohmann/detail/value_t.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+
+// boost::hash_combine
+inline std::size_t combine(std::size_t seed, std::size_t h) noexcept
+{
+ seed ^= h + 0x9e3779b9 + (seed << 6U) + (seed >> 2U);
+ return seed;
+}
+
+/*!
+@brief hash a JSON value
+
+The hash function tries to rely on std::hash where possible. Furthermore, the
+type of the JSON value is taken into account to have different hash values for
+null, 0, 0U, and false, etc.
+
+@tparam BasicJsonType basic_json specialization
+@param j JSON value to hash
+@return hash value of j
+*/
+template<typename BasicJsonType>
+std::size_t hash(const BasicJsonType& j)
+{
+ using string_t = typename BasicJsonType::string_t;
+ using number_integer_t = typename BasicJsonType::number_integer_t;
+ using number_unsigned_t = typename BasicJsonType::number_unsigned_t;
+ using number_float_t = typename BasicJsonType::number_float_t;
+
+ const auto type = static_cast<std::size_t>(j.type());
+ switch (j.type())
+ {
+ case BasicJsonType::value_t::null:
+ case BasicJsonType::value_t::discarded:
+ {
+ return combine(type, 0);
+ }
+
+ case BasicJsonType::value_t::object:
+ {
+ auto seed = combine(type, j.size());
+ for (const auto& element : j.items())
+ {
+ const auto h = std::hash<string_t> {}(element.key());
+ seed = combine(seed, h);
+ seed = combine(seed, hash(element.value()));
+ }
+ return seed;
+ }
+
+ case BasicJsonType::value_t::array:
+ {
+ auto seed = combine(type, j.size());
+ for (const auto& element : j)
+ {
+ seed = combine(seed, hash(element));
+ }
+ return seed;
+ }
+
+ case BasicJsonType::value_t::string:
+ {
+ const auto h = std::hash<string_t> {}(j.template get_ref<const string_t&>());
+ return combine(type, h);
+ }
+
+ case BasicJsonType::value_t::boolean:
+ {
+ const auto h = std::hash<bool> {}(j.template get<bool>());
+ return combine(type, h);
+ }
+
+ case BasicJsonType::value_t::number_integer:
+ {
+ const auto h = std::hash<number_integer_t> {}(j.template get<number_integer_t>());
+ return combine(type, h);
+ }
+
+ case BasicJsonType::value_t::number_unsigned:
+ {
+ const auto h = std::hash<number_unsigned_t> {}(j.template get<number_unsigned_t>());
+ return combine(type, h);
+ }
+
+ case BasicJsonType::value_t::number_float:
+ {
+ const auto h = std::hash<number_float_t> {}(j.template get<number_float_t>());
+ return combine(type, h);
+ }
+
+ case BasicJsonType::value_t::binary:
+ {
+ auto seed = combine(type, j.get_binary().size());
+ const auto h = std::hash<bool> {}(j.get_binary().has_subtype());
+ seed = combine(seed, h);
+ seed = combine(seed, static_cast<std::size_t>(j.get_binary().subtype()));
+ for (const auto byte : j.get_binary())
+ {
+ seed = combine(seed, std::hash<std::uint8_t> {}(byte));
+ }
+ return seed;
+ }
+
+ default: // LCOV_EXCL_LINE
+ JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert) LCOV_EXCL_LINE
+ return 0; // LCOV_EXCL_LINE
+ }
+}
+
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/input/binary_reader.hpp>
+
+
+#include <algorithm> // generate_n
+#include <array> // array
+#include <cmath> // ldexp
+#include <cstddef> // size_t
+#include <cstdint> // uint8_t, uint16_t, uint32_t, uint64_t
+#include <cstdio> // snprintf
+#include <cstring> // memcpy
+#include <iterator> // back_inserter
+#include <limits> // numeric_limits
+#include <string> // char_traits, string
+#include <utility> // make_pair, move
+#include <vector> // vector
+
+// #include <nlohmann/detail/exceptions.hpp>
+
+// #include <nlohmann/detail/input/input_adapters.hpp>
+
+
+#include <array> // array
+#include <cstddef> // size_t
+#include <cstring> // strlen
+#include <iterator> // begin, end, iterator_traits, random_access_iterator_tag, distance, next
+#include <memory> // shared_ptr, make_shared, addressof
+#include <numeric> // accumulate
+#include <string> // string, char_traits
+#include <type_traits> // enable_if, is_base_of, is_pointer, is_integral, remove_pointer
+#include <utility> // pair, declval
+
+#ifndef JSON_NO_IO
+ #include <cstdio> // FILE *
+ #include <istream> // istream
+#endif // JSON_NO_IO
+
+// #include <nlohmann/detail/iterators/iterator_traits.hpp>
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+/// the supported input formats
+enum class input_format_t { json, cbor, msgpack, ubjson, bson };
+
+////////////////////
+// input adapters //
+////////////////////
+
+#ifndef JSON_NO_IO
+/*!
+Input adapter for stdio file access. This adapter read only 1 byte and do not use any
+ buffer. This adapter is a very low level adapter.
+*/
+class file_input_adapter
+{
+ public:
+ using char_type = char;
+
+ JSON_HEDLEY_NON_NULL(2)
+ explicit file_input_adapter(std::FILE* f) noexcept
+ : m_file(f)
+ {}
+
+ // make class move-only
+ file_input_adapter(const file_input_adapter&) = delete;
+ file_input_adapter(file_input_adapter&&) noexcept = default;
+ file_input_adapter& operator=(const file_input_adapter&) = delete;
+ file_input_adapter& operator=(file_input_adapter&&) = delete;
+ ~file_input_adapter() = default;
+
+ std::char_traits<char>::int_type get_character() noexcept
+ {
+ return std::fgetc(m_file);
+ }
+
+ private:
+ /// the file pointer to read from
+ std::FILE* m_file;
+};
+
+
+/*!
+Input adapter for a (caching) istream. Ignores a UFT Byte Order Mark at
+beginning of input. Does not support changing the underlying std::streambuf
+in mid-input. Maintains underlying std::istream and std::streambuf to support
+subsequent use of standard std::istream operations to process any input
+characters following those used in parsing the JSON input. Clears the
+std::istream flags; any input errors (e.g., EOF) will be detected by the first
+subsequent call for input from the std::istream.
+*/
+class input_stream_adapter
+{
+ public:
+ using char_type = char;
+
+ ~input_stream_adapter()
+ {
+ // clear stream flags; we use underlying streambuf I/O, do not
+ // maintain ifstream flags, except eof
+ if (is != nullptr)
+ {
+ is->clear(is->rdstate() & std::ios::eofbit);
+ }
+ }
+
+ explicit input_stream_adapter(std::istream& i)
+ : is(&i), sb(i.rdbuf())
+ {}
+
+ // delete because of pointer members
+ input_stream_adapter(const input_stream_adapter&) = delete;
+ input_stream_adapter& operator=(input_stream_adapter&) = delete;
+ input_stream_adapter& operator=(input_stream_adapter&&) = delete;
+
+ input_stream_adapter(input_stream_adapter&& rhs) noexcept
+ : is(rhs.is), sb(rhs.sb)
+ {
+ rhs.is = nullptr;
+ rhs.sb = nullptr;
+ }
+
+ // std::istream/std::streambuf use std::char_traits<char>::to_int_type, to
+ // ensure that std::char_traits<char>::eof() and the character 0xFF do not
+ // end up as the same value, e.g. 0xFFFFFFFF.
+ std::char_traits<char>::int_type get_character()
+ {
+ auto res = sb->sbumpc();
+ // set eof manually, as we don't use the istream interface.
+ if (JSON_HEDLEY_UNLIKELY(res == std::char_traits<char>::eof()))
+ {
+ is->clear(is->rdstate() | std::ios::eofbit);
+ }
+ return res;
+ }
+
+ private:
+ /// the associated input stream
+ std::istream* is = nullptr;
+ std::streambuf* sb = nullptr;
+};
+#endif // JSON_NO_IO
+
+// General-purpose iterator-based adapter. It might not be as fast as
+// theoretically possible for some containers, but it is extremely versatile.
+template<typename IteratorType>
+class iterator_input_adapter
+{
+ public:
+ using char_type = typename std::iterator_traits<IteratorType>::value_type;
+
+ iterator_input_adapter(IteratorType first, IteratorType last)
+ : current(std::move(first)), end(std::move(last))
+ {}
+
+ typename std::char_traits<char_type>::int_type get_character()
+ {
+ if (JSON_HEDLEY_LIKELY(current != end))
+ {
+ auto result = std::char_traits<char_type>::to_int_type(*current);
+ std::advance(current, 1);
+ return result;
+ }
+
+ return std::char_traits<char_type>::eof();
+ }
+
+ private:
+ IteratorType current;
+ IteratorType end;
+
+ template<typename BaseInputAdapter, size_t T>
+ friend struct wide_string_input_helper;
+
+ bool empty() const
+ {
+ return current == end;
+ }
+};
+
+
+template<typename BaseInputAdapter, size_t T>
+struct wide_string_input_helper;
+
+template<typename BaseInputAdapter>
+struct wide_string_input_helper<BaseInputAdapter, 4>
+{
+ // UTF-32
+ static void fill_buffer(BaseInputAdapter& input,
+ std::array<std::char_traits<char>::int_type, 4>& utf8_bytes,
+ size_t& utf8_bytes_index,
+ size_t& utf8_bytes_filled)
+ {
+ utf8_bytes_index = 0;
+
+ if (JSON_HEDLEY_UNLIKELY(input.empty()))
+ {
+ utf8_bytes[0] = std::char_traits<char>::eof();
+ utf8_bytes_filled = 1;
+ }
+ else
+ {
+ // get the current character
+ const auto wc = input.get_character();
+
+ // UTF-32 to UTF-8 encoding
+ if (wc < 0x80)
+ {
+ utf8_bytes[0] = static_cast<std::char_traits<char>::int_type>(wc);
+ utf8_bytes_filled = 1;
+ }
+ else if (wc <= 0x7FF)
+ {
+ utf8_bytes[0] = static_cast<std::char_traits<char>::int_type>(0xC0u | ((static_cast<unsigned int>(wc) >> 6u) & 0x1Fu));
+ utf8_bytes[1] = static_cast<std::char_traits<char>::int_type>(0x80u | (static_cast<unsigned int>(wc) & 0x3Fu));
+ utf8_bytes_filled = 2;
+ }
+ else if (wc <= 0xFFFF)
+ {
+ utf8_bytes[0] = static_cast<std::char_traits<char>::int_type>(0xE0u | ((static_cast<unsigned int>(wc) >> 12u) & 0x0Fu));
+ utf8_bytes[1] = static_cast<std::char_traits<char>::int_type>(0x80u | ((static_cast<unsigned int>(wc) >> 6u) & 0x3Fu));
+ utf8_bytes[2] = static_cast<std::char_traits<char>::int_type>(0x80u | (static_cast<unsigned int>(wc) & 0x3Fu));
+ utf8_bytes_filled = 3;
+ }
+ else if (wc <= 0x10FFFF)
+ {
+ utf8_bytes[0] = static_cast<std::char_traits<char>::int_type>(0xF0u | ((static_cast<unsigned int>(wc) >> 18u) & 0x07u));
+ utf8_bytes[1] = static_cast<std::char_traits<char>::int_type>(0x80u | ((static_cast<unsigned int>(wc) >> 12u) & 0x3Fu));
+ utf8_bytes[2] = static_cast<std::char_traits<char>::int_type>(0x80u | ((static_cast<unsigned int>(wc) >> 6u) & 0x3Fu));
+ utf8_bytes[3] = static_cast<std::char_traits<char>::int_type>(0x80u | (static_cast<unsigned int>(wc) & 0x3Fu));
+ utf8_bytes_filled = 4;
+ }
+ else
+ {
+ // unknown character
+ utf8_bytes[0] = static_cast<std::char_traits<char>::int_type>(wc);
+ utf8_bytes_filled = 1;
+ }
+ }
+ }
+};
+
+template<typename BaseInputAdapter>
+struct wide_string_input_helper<BaseInputAdapter, 2>
+{
+ // UTF-16
+ static void fill_buffer(BaseInputAdapter& input,
+ std::array<std::char_traits<char>::int_type, 4>& utf8_bytes,
+ size_t& utf8_bytes_index,
+ size_t& utf8_bytes_filled)
+ {
+ utf8_bytes_index = 0;
+
+ if (JSON_HEDLEY_UNLIKELY(input.empty()))
+ {
+ utf8_bytes[0] = std::char_traits<char>::eof();
+ utf8_bytes_filled = 1;
+ }
+ else
+ {
+ // get the current character
+ const auto wc = input.get_character();
+
+ // UTF-16 to UTF-8 encoding
+ if (wc < 0x80)
+ {
+ utf8_bytes[0] = static_cast<std::char_traits<char>::int_type>(wc);
+ utf8_bytes_filled = 1;
+ }
+ else if (wc <= 0x7FF)
+ {
+ utf8_bytes[0] = static_cast<std::char_traits<char>::int_type>(0xC0u | ((static_cast<unsigned int>(wc) >> 6u)));
+ utf8_bytes[1] = static_cast<std::char_traits<char>::int_type>(0x80u | (static_cast<unsigned int>(wc) & 0x3Fu));
+ utf8_bytes_filled = 2;
+ }
+ else if (0xD800 > wc || wc >= 0xE000)
+ {
+ utf8_bytes[0] = static_cast<std::char_traits<char>::int_type>(0xE0u | ((static_cast<unsigned int>(wc) >> 12u)));
+ utf8_bytes[1] = static_cast<std::char_traits<char>::int_type>(0x80u | ((static_cast<unsigned int>(wc) >> 6u) & 0x3Fu));
+ utf8_bytes[2] = static_cast<std::char_traits<char>::int_type>(0x80u | (static_cast<unsigned int>(wc) & 0x3Fu));
+ utf8_bytes_filled = 3;
+ }
+ else
+ {
+ if (JSON_HEDLEY_UNLIKELY(!input.empty()))
+ {
+ const auto wc2 = static_cast<unsigned int>(input.get_character());
+ const auto charcode = 0x10000u + (((static_cast<unsigned int>(wc) & 0x3FFu) << 10u) | (wc2 & 0x3FFu));
+ utf8_bytes[0] = static_cast<std::char_traits<char>::int_type>(0xF0u | (charcode >> 18u));
+ utf8_bytes[1] = static_cast<std::char_traits<char>::int_type>(0x80u | ((charcode >> 12u) & 0x3Fu));
+ utf8_bytes[2] = static_cast<std::char_traits<char>::int_type>(0x80u | ((charcode >> 6u) & 0x3Fu));
+ utf8_bytes[3] = static_cast<std::char_traits<char>::int_type>(0x80u | (charcode & 0x3Fu));
+ utf8_bytes_filled = 4;
+ }
+ else
+ {
+ utf8_bytes[0] = static_cast<std::char_traits<char>::int_type>(wc);
+ utf8_bytes_filled = 1;
+ }
+ }
+ }
+ }
+};
+
+// Wraps another input apdater to convert wide character types into individual bytes.
+template<typename BaseInputAdapter, typename WideCharType>
+class wide_string_input_adapter
+{
+ public:
+ using char_type = char;
+
+ wide_string_input_adapter(BaseInputAdapter base)
+ : base_adapter(base) {}
+
+ typename std::char_traits<char>::int_type get_character() noexcept
+ {
+ // check if buffer needs to be filled
+ if (utf8_bytes_index == utf8_bytes_filled)
+ {
+ fill_buffer<sizeof(WideCharType)>();
+
+ JSON_ASSERT(utf8_bytes_filled > 0);
+ JSON_ASSERT(utf8_bytes_index == 0);
+ }
+
+ // use buffer
+ JSON_ASSERT(utf8_bytes_filled > 0);
+ JSON_ASSERT(utf8_bytes_index < utf8_bytes_filled);
+ return utf8_bytes[utf8_bytes_index++];
+ }
+
+ private:
+ BaseInputAdapter base_adapter;
+
+ template<size_t T>
+ void fill_buffer()
+ {
+ wide_string_input_helper<BaseInputAdapter, T>::fill_buffer(base_adapter, utf8_bytes, utf8_bytes_index, utf8_bytes_filled);
+ }
+
+ /// a buffer for UTF-8 bytes
+ std::array<std::char_traits<char>::int_type, 4> utf8_bytes = {{0, 0, 0, 0}};
+
+ /// index to the utf8_codes array for the next valid byte
+ std::size_t utf8_bytes_index = 0;
+ /// number of valid bytes in the utf8_codes array
+ std::size_t utf8_bytes_filled = 0;
+};
+
+
+template<typename IteratorType, typename Enable = void>
+struct iterator_input_adapter_factory
+{
+ using iterator_type = IteratorType;
+ using char_type = typename std::iterator_traits<iterator_type>::value_type;
+ using adapter_type = iterator_input_adapter<iterator_type>;
+
+ static adapter_type create(IteratorType first, IteratorType last)
+ {
+ return adapter_type(std::move(first), std::move(last));
+ }
+};
+
+template<typename T>
+struct is_iterator_of_multibyte
+{
+ using value_type = typename std::iterator_traits<T>::value_type;
+ enum
+ {
+ value = sizeof(value_type) > 1
+ };
+};
+
+template<typename IteratorType>
+struct iterator_input_adapter_factory<IteratorType, enable_if_t<is_iterator_of_multibyte<IteratorType>::value>>
+{
+ using iterator_type = IteratorType;
+ using char_type = typename std::iterator_traits<iterator_type>::value_type;
+ using base_adapter_type = iterator_input_adapter<iterator_type>;
+ using adapter_type = wide_string_input_adapter<base_adapter_type, char_type>;
+
+ static adapter_type create(IteratorType first, IteratorType last)
+ {
+ return adapter_type(base_adapter_type(std::move(first), std::move(last)));
+ }
+};
+
+// General purpose iterator-based input
+template<typename IteratorType>
+typename iterator_input_adapter_factory<IteratorType>::adapter_type input_adapter(IteratorType first, IteratorType last)
+{
+ using factory_type = iterator_input_adapter_factory<IteratorType>;
+ return factory_type::create(first, last);
+}
+
+// Convenience shorthand from container to iterator
+// Enables ADL on begin(container) and end(container)
+// Encloses the using declarations in namespace for not to leak them to outside scope
+
+namespace container_input_adapter_factory_impl
+{
+
+using std::begin;
+using std::end;
+
+template<typename ContainerType, typename Enable = void>
+struct container_input_adapter_factory {};
+
+template<typename ContainerType>
+struct container_input_adapter_factory< ContainerType,
+ void_t<decltype(begin(std::declval<ContainerType>()), end(std::declval<ContainerType>()))>>
+ {
+ using adapter_type = decltype(input_adapter(begin(std::declval<ContainerType>()), end(std::declval<ContainerType>())));
+
+ static adapter_type create(const ContainerType& container)
+{
+ return input_adapter(begin(container), end(container));
+}
+ };
+
+} // namespace container_input_adapter_factory_impl
+
+template<typename ContainerType>
+typename container_input_adapter_factory_impl::container_input_adapter_factory<ContainerType>::adapter_type input_adapter(const ContainerType& container)
+{
+ return container_input_adapter_factory_impl::container_input_adapter_factory<ContainerType>::create(container);
+}
+
+#ifndef JSON_NO_IO
+// Special cases with fast paths
+inline file_input_adapter input_adapter(std::FILE* file)
+{
+ return file_input_adapter(file);
+}
+
+inline input_stream_adapter input_adapter(std::istream& stream)
+{
+ return input_stream_adapter(stream);
+}
+
+inline input_stream_adapter input_adapter(std::istream&& stream)
+{
+ return input_stream_adapter(stream);
+}
+#endif // JSON_NO_IO
+
+using contiguous_bytes_input_adapter = decltype(input_adapter(std::declval<const char*>(), std::declval<const char*>()));
+
+// Null-delimited strings, and the like.
+template < typename CharT,
+ typename std::enable_if <
+ std::is_pointer<CharT>::value&&
+ !std::is_array<CharT>::value&&
+ std::is_integral<typename std::remove_pointer<CharT>::type>::value&&
+ sizeof(typename std::remove_pointer<CharT>::type) == 1,
+ int >::type = 0 >
+contiguous_bytes_input_adapter input_adapter(CharT b)
+{
+ auto length = std::strlen(reinterpret_cast<const char*>(b));
+ const auto* ptr = reinterpret_cast<const char*>(b);
+ return input_adapter(ptr, ptr + length);
+}
+
+template<typename T, std::size_t N>
+auto input_adapter(T (&array)[N]) -> decltype(input_adapter(array, array + N)) // NOLINT(cppcoreguidelines-avoid-c-arrays,hicpp-avoid-c-arrays,modernize-avoid-c-arrays)
+{
+ return input_adapter(array, array + N);
+}
+
+// This class only handles inputs of input_buffer_adapter type.
+// It's required so that expressions like {ptr, len} can be implicitly cast
+// to the correct adapter.
+class span_input_adapter
+{
+ public:
+ template < typename CharT,
+ typename std::enable_if <
+ std::is_pointer<CharT>::value&&
+ std::is_integral<typename std::remove_pointer<CharT>::type>::value&&
+ sizeof(typename std::remove_pointer<CharT>::type) == 1,
+ int >::type = 0 >
+ span_input_adapter(CharT b, std::size_t l)
+ : ia(reinterpret_cast<const char*>(b), reinterpret_cast<const char*>(b) + l) {}
+
+ template<class IteratorType,
+ typename std::enable_if<
+ std::is_same<typename iterator_traits<IteratorType>::iterator_category, std::random_access_iterator_tag>::value,
+ int>::type = 0>
+ span_input_adapter(IteratorType first, IteratorType last)
+ : ia(input_adapter(first, last)) {}
+
+ contiguous_bytes_input_adapter&& get()
+ {
+ return std::move(ia); // NOLINT(hicpp-move-const-arg,performance-move-const-arg)
+ }
+
+ private:
+ contiguous_bytes_input_adapter ia;
+};
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/input/json_sax.hpp>
+
+
+#include <cstddef>
+#include <string> // string
+#include <utility> // move
+#include <vector> // vector
+
+// #include <nlohmann/detail/exceptions.hpp>
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+
+namespace nlohmann
+{
+
+/*!
+@brief SAX interface
+
+This class describes the SAX interface used by @ref nlohmann::json::sax_parse.
+Each function is called in different situations while the input is parsed. The
+boolean return value informs the parser whether to continue processing the
+input.
+*/
+template<typename BasicJsonType>
+struct json_sax
+{
+ using number_integer_t = typename BasicJsonType::number_integer_t;
+ using number_unsigned_t = typename BasicJsonType::number_unsigned_t;
+ using number_float_t = typename BasicJsonType::number_float_t;
+ using string_t = typename BasicJsonType::string_t;
+ using binary_t = typename BasicJsonType::binary_t;
+
+ /*!
+ @brief a null value was read
+ @return whether parsing should proceed
+ */
+ virtual bool null() = 0;
+
+ /*!
+ @brief a boolean value was read
+ @param[in] val boolean value
+ @return whether parsing should proceed
+ */
+ virtual bool boolean(bool val) = 0;
+
+ /*!
+ @brief an integer number was read
+ @param[in] val integer value
+ @return whether parsing should proceed
+ */
+ virtual bool number_integer(number_integer_t val) = 0;
+
+ /*!
+ @brief an unsigned integer number was read
+ @param[in] val unsigned integer value
+ @return whether parsing should proceed
+ */
+ virtual bool number_unsigned(number_unsigned_t val) = 0;
+
+ /*!
+ @brief a floating-point number was read
+ @param[in] val floating-point value
+ @param[in] s raw token value
+ @return whether parsing should proceed
+ */
+ virtual bool number_float(number_float_t val, const string_t& s) = 0;
+
+ /*!
+ @brief a string value was read
+ @param[in] val string value
+ @return whether parsing should proceed
+ @note It is safe to move the passed string value.
+ */
+ virtual bool string(string_t& val) = 0;
+
+ /*!
+ @brief a binary value was read
+ @param[in] val binary value
+ @return whether parsing should proceed
+ @note It is safe to move the passed binary value.
+ */
+ virtual bool binary(binary_t& val) = 0;
+
+ /*!
+ @brief the beginning of an object was read
+ @param[in] elements number of object elements or -1 if unknown
+ @return whether parsing should proceed
+ @note binary formats may report the number of elements
+ */
+ virtual bool start_object(std::size_t elements) = 0;
+
+ /*!
+ @brief an object key was read
+ @param[in] val object key
+ @return whether parsing should proceed
+ @note It is safe to move the passed string.
+ */
+ virtual bool key(string_t& val) = 0;
+
+ /*!
+ @brief the end of an object was read
+ @return whether parsing should proceed
+ */
+ virtual bool end_object() = 0;
+
+ /*!
+ @brief the beginning of an array was read
+ @param[in] elements number of array elements or -1 if unknown
+ @return whether parsing should proceed
+ @note binary formats may report the number of elements
+ */
+ virtual bool start_array(std::size_t elements) = 0;
+
+ /*!
+ @brief the end of an array was read
+ @return whether parsing should proceed
+ */
+ virtual bool end_array() = 0;
+
+ /*!
+ @brief a parse error occurred
+ @param[in] position the position in the input where the error occurs
+ @param[in] last_token the last read token
+ @param[in] ex an exception object describing the error
+ @return whether parsing should proceed (must return false)
+ */
+ virtual bool parse_error(std::size_t position,
+ const std::string& last_token,
+ const detail::exception& ex) = 0;
+
+ json_sax() = default;
+ json_sax(const json_sax&) = default;
+ json_sax(json_sax&&) noexcept = default;
+ json_sax& operator=(const json_sax&) = default;
+ json_sax& operator=(json_sax&&) noexcept = default;
+ virtual ~json_sax() = default;
+};
+
+
+namespace detail
+{
+/*!
+@brief SAX implementation to create a JSON value from SAX events
+
+This class implements the @ref json_sax interface and processes the SAX events
+to create a JSON value which makes it basically a DOM parser. The structure or
+hierarchy of the JSON value is managed by the stack `ref_stack` which contains
+a pointer to the respective array or object for each recursion depth.
+
+After successful parsing, the value that is passed by reference to the
+constructor contains the parsed value.
+
+@tparam BasicJsonType the JSON type
+*/
+template<typename BasicJsonType>
+class json_sax_dom_parser
+{
+ public:
+ using number_integer_t = typename BasicJsonType::number_integer_t;
+ using number_unsigned_t = typename BasicJsonType::number_unsigned_t;
+ using number_float_t = typename BasicJsonType::number_float_t;
+ using string_t = typename BasicJsonType::string_t;
+ using binary_t = typename BasicJsonType::binary_t;
+
+ /*!
+ @param[in,out] r reference to a JSON value that is manipulated while
+ parsing
+ @param[in] allow_exceptions_ whether parse errors yield exceptions
+ */
+ explicit json_sax_dom_parser(BasicJsonType& r, const bool allow_exceptions_ = true)
+ : root(r), allow_exceptions(allow_exceptions_)
+ {}
+
+ // make class move-only
+ json_sax_dom_parser(const json_sax_dom_parser&) = delete;
+ json_sax_dom_parser(json_sax_dom_parser&&) = default; // NOLINT(hicpp-noexcept-move,performance-noexcept-move-constructor)
+ json_sax_dom_parser& operator=(const json_sax_dom_parser&) = delete;
+ json_sax_dom_parser& operator=(json_sax_dom_parser&&) = default; // NOLINT(hicpp-noexcept-move,performance-noexcept-move-constructor)
+ ~json_sax_dom_parser() = default;
+
+ bool null()
+ {
+ handle_value(nullptr);
+ return true;
+ }
+
+ bool boolean(bool val)
+ {
+ handle_value(val);
+ return true;
+ }
+
+ bool number_integer(number_integer_t val)
+ {
+ handle_value(val);
+ return true;
+ }
+
+ bool number_unsigned(number_unsigned_t val)
+ {
+ handle_value(val);
+ return true;
+ }
+
+ bool number_float(number_float_t val, const string_t& /*unused*/)
+ {
+ handle_value(val);
+ return true;
+ }
+
+ bool string(string_t& val)
+ {
+ handle_value(val);
+ return true;
+ }
+
+ bool binary(binary_t& val)
+ {
+ handle_value(std::move(val));
+ return true;
+ }
+
+ bool start_object(std::size_t len)
+ {
+ ref_stack.push_back(handle_value(BasicJsonType::value_t::object));
+
+ if (JSON_HEDLEY_UNLIKELY(len != static_cast<std::size_t>(-1) && len > ref_stack.back()->max_size()))
+ {
+ JSON_THROW(out_of_range::create(408, "excessive object size: " + std::to_string(len), *ref_stack.back()));
+ }
+
+ return true;
+ }
+
+ bool key(string_t& val)
+ {
+ // add null at given key and store the reference for later
+ object_element = &(ref_stack.back()->m_value.object->operator[](val));
+ return true;
+ }
+
+ bool end_object()
+ {
+ ref_stack.back()->set_parents();
+ ref_stack.pop_back();
+ return true;
+ }
+
+ bool start_array(std::size_t len)
+ {
+ ref_stack.push_back(handle_value(BasicJsonType::value_t::array));
+
+ if (JSON_HEDLEY_UNLIKELY(len != static_cast<std::size_t>(-1) && len > ref_stack.back()->max_size()))
+ {
+ JSON_THROW(out_of_range::create(408, "excessive array size: " + std::to_string(len), *ref_stack.back()));
+ }
+
+ return true;
+ }
+
+ bool end_array()
+ {
+ ref_stack.back()->set_parents();
+ ref_stack.pop_back();
+ return true;
+ }
+
+ template<class Exception>
+ bool parse_error(std::size_t /*unused*/, const std::string& /*unused*/,
+ const Exception& ex)
+ {
+ errored = true;
+ static_cast<void>(ex);
+ if (allow_exceptions)
+ {
+ JSON_THROW(ex);
+ }
+ return false;
+ }
+
+ constexpr bool is_errored() const
+ {
+ return errored;
+ }
+
+ private:
+ /*!
+ @invariant If the ref stack is empty, then the passed value will be the new
+ root.
+ @invariant If the ref stack contains a value, then it is an array or an
+ object to which we can add elements
+ */
+ template<typename Value>
+ JSON_HEDLEY_RETURNS_NON_NULL
+ BasicJsonType* handle_value(Value&& v)
+ {
+ if (ref_stack.empty())
+ {
+ root = BasicJsonType(std::forward<Value>(v));
+ return &root;
+ }
+
+ JSON_ASSERT(ref_stack.back()->is_array() || ref_stack.back()->is_object());
+
+ if (ref_stack.back()->is_array())
+ {
+ ref_stack.back()->m_value.array->emplace_back(std::forward<Value>(v));
+ return &(ref_stack.back()->m_value.array->back());
+ }
+
+ JSON_ASSERT(ref_stack.back()->is_object());
+ JSON_ASSERT(object_element);
+ *object_element = BasicJsonType(std::forward<Value>(v));
+ return object_element;
+ }
+
+ /// the parsed JSON value
+ BasicJsonType& root;
+ /// stack to model hierarchy of values
+ std::vector<BasicJsonType*> ref_stack {};
+ /// helper to hold the reference for the next object element
+ BasicJsonType* object_element = nullptr;
+ /// whether a syntax error occurred
+ bool errored = false;
+ /// whether to throw exceptions in case of errors
+ const bool allow_exceptions = true;
+};
+
+template<typename BasicJsonType>
+class json_sax_dom_callback_parser
+{
+ public:
+ using number_integer_t = typename BasicJsonType::number_integer_t;
+ using number_unsigned_t = typename BasicJsonType::number_unsigned_t;
+ using number_float_t = typename BasicJsonType::number_float_t;
+ using string_t = typename BasicJsonType::string_t;
+ using binary_t = typename BasicJsonType::binary_t;
+ using parser_callback_t = typename BasicJsonType::parser_callback_t;
+ using parse_event_t = typename BasicJsonType::parse_event_t;
+
+ json_sax_dom_callback_parser(BasicJsonType& r,
+ const parser_callback_t cb,
+ const bool allow_exceptions_ = true)
+ : root(r), callback(cb), allow_exceptions(allow_exceptions_)
+ {
+ keep_stack.push_back(true);
+ }
+
+ // make class move-only
+ json_sax_dom_callback_parser(const json_sax_dom_callback_parser&) = delete;
+ json_sax_dom_callback_parser(json_sax_dom_callback_parser&&) = default; // NOLINT(hicpp-noexcept-move,performance-noexcept-move-constructor)
+ json_sax_dom_callback_parser& operator=(const json_sax_dom_callback_parser&) = delete;
+ json_sax_dom_callback_parser& operator=(json_sax_dom_callback_parser&&) = default; // NOLINT(hicpp-noexcept-move,performance-noexcept-move-constructor)
+ ~json_sax_dom_callback_parser() = default;
+
+ bool null()
+ {
+ handle_value(nullptr);
+ return true;
+ }
+
+ bool boolean(bool val)
+ {
+ handle_value(val);
+ return true;
+ }
+
+ bool number_integer(number_integer_t val)
+ {
+ handle_value(val);
+ return true;
+ }
+
+ bool number_unsigned(number_unsigned_t val)
+ {
+ handle_value(val);
+ return true;
+ }
+
+ bool number_float(number_float_t val, const string_t& /*unused*/)
+ {
+ handle_value(val);
+ return true;
+ }
+
+ bool string(string_t& val)
+ {
+ handle_value(val);
+ return true;
+ }
+
+ bool binary(binary_t& val)
+ {
+ handle_value(std::move(val));
+ return true;
+ }
+
+ bool start_object(std::size_t len)
+ {
+ // check callback for object start
+ const bool keep = callback(static_cast<int>(ref_stack.size()), parse_event_t::object_start, discarded);
+ keep_stack.push_back(keep);
+
+ auto val = handle_value(BasicJsonType::value_t::object, true);
+ ref_stack.push_back(val.second);
+
+ // check object limit
+ if (ref_stack.back() && JSON_HEDLEY_UNLIKELY(len != static_cast<std::size_t>(-1) && len > ref_stack.back()->max_size()))
+ {
+ JSON_THROW(out_of_range::create(408, "excessive object size: " + std::to_string(len), *ref_stack.back()));
+ }
+
+ return true;
+ }
+
+ bool key(string_t& val)
+ {
+ BasicJsonType k = BasicJsonType(val);
+
+ // check callback for key
+ const bool keep = callback(static_cast<int>(ref_stack.size()), parse_event_t::key, k);
+ key_keep_stack.push_back(keep);
+
+ // add discarded value at given key and store the reference for later
+ if (keep && ref_stack.back())
+ {
+ object_element = &(ref_stack.back()->m_value.object->operator[](val) = discarded);
+ }
+
+ return true;
+ }
+
+ bool end_object()
+ {
+ if (ref_stack.back())
+ {
+ if (!callback(static_cast<int>(ref_stack.size()) - 1, parse_event_t::object_end, *ref_stack.back()))
+ {
+ // discard object
+ *ref_stack.back() = discarded;
+ }
+ else
+ {
+ ref_stack.back()->set_parents();
+ }
+ }
+
+ JSON_ASSERT(!ref_stack.empty());
+ JSON_ASSERT(!keep_stack.empty());
+ ref_stack.pop_back();
+ keep_stack.pop_back();
+
+ if (!ref_stack.empty() && ref_stack.back() && ref_stack.back()->is_structured())
+ {
+ // remove discarded value
+ for (auto it = ref_stack.back()->begin(); it != ref_stack.back()->end(); ++it)
+ {
+ if (it->is_discarded())
+ {
+ ref_stack.back()->erase(it);
+ break;
+ }
+ }
+ }
+
+ return true;
+ }
+
+ bool start_array(std::size_t len)
+ {
+ const bool keep = callback(static_cast<int>(ref_stack.size()), parse_event_t::array_start, discarded);
+ keep_stack.push_back(keep);
+
+ auto val = handle_value(BasicJsonType::value_t::array, true);
+ ref_stack.push_back(val.second);
+
+ // check array limit
+ if (ref_stack.back() && JSON_HEDLEY_UNLIKELY(len != static_cast<std::size_t>(-1) && len > ref_stack.back()->max_size()))
+ {
+ JSON_THROW(out_of_range::create(408, "excessive array size: " + std::to_string(len), *ref_stack.back()));
+ }
+
+ return true;
+ }
+
+ bool end_array()
+ {
+ bool keep = true;
+
+ if (ref_stack.back())
+ {
+ keep = callback(static_cast<int>(ref_stack.size()) - 1, parse_event_t::array_end, *ref_stack.back());
+ if (keep)
+ {
+ ref_stack.back()->set_parents();
+ }
+ else
+ {
+ // discard array
+ *ref_stack.back() = discarded;
+ }
+ }
+
+ JSON_ASSERT(!ref_stack.empty());
+ JSON_ASSERT(!keep_stack.empty());
+ ref_stack.pop_back();
+ keep_stack.pop_back();
+
+ // remove discarded value
+ if (!keep && !ref_stack.empty() && ref_stack.back()->is_array())
+ {
+ ref_stack.back()->m_value.array->pop_back();
+ }
+
+ return true;
+ }
+
+ template<class Exception>
+ bool parse_error(std::size_t /*unused*/, const std::string& /*unused*/,
+ const Exception& ex)
+ {
+ errored = true;
+ static_cast<void>(ex);
+ if (allow_exceptions)
+ {
+ JSON_THROW(ex);
+ }
+ return false;
+ }
+
+ constexpr bool is_errored() const
+ {
+ return errored;
+ }
+
+ private:
+ /*!
+ @param[in] v value to add to the JSON value we build during parsing
+ @param[in] skip_callback whether we should skip calling the callback
+ function; this is required after start_array() and
+ start_object() SAX events, because otherwise we would call the
+ callback function with an empty array or object, respectively.
+
+ @invariant If the ref stack is empty, then the passed value will be the new
+ root.
+ @invariant If the ref stack contains a value, then it is an array or an
+ object to which we can add elements
+
+ @return pair of boolean (whether value should be kept) and pointer (to the
+ passed value in the ref_stack hierarchy; nullptr if not kept)
+ */
+ template<typename Value>
+ std::pair<bool, BasicJsonType*> handle_value(Value&& v, const bool skip_callback = false)
+ {
+ JSON_ASSERT(!keep_stack.empty());
+
+ // do not handle this value if we know it would be added to a discarded
+ // container
+ if (!keep_stack.back())
+ {
+ return {false, nullptr};
+ }
+
+ // create value
+ auto value = BasicJsonType(std::forward<Value>(v));
+
+ // check callback
+ const bool keep = skip_callback || callback(static_cast<int>(ref_stack.size()), parse_event_t::value, value);
+
+ // do not handle this value if we just learnt it shall be discarded
+ if (!keep)
+ {
+ return {false, nullptr};
+ }
+
+ if (ref_stack.empty())
+ {
+ root = std::move(value);
+ return {true, &root};
+ }
+
+ // skip this value if we already decided to skip the parent
+ // (https://github.com/nlohmann/json/issues/971#issuecomment-413678360)
+ if (!ref_stack.back())
+ {
+ return {false, nullptr};
+ }
+
+ // we now only expect arrays and objects
+ JSON_ASSERT(ref_stack.back()->is_array() || ref_stack.back()->is_object());
+
+ // array
+ if (ref_stack.back()->is_array())
+ {
+ ref_stack.back()->m_value.array->emplace_back(std::move(value));
+ return {true, &(ref_stack.back()->m_value.array->back())};
+ }
+
+ // object
+ JSON_ASSERT(ref_stack.back()->is_object());
+ // check if we should store an element for the current key
+ JSON_ASSERT(!key_keep_stack.empty());
+ const bool store_element = key_keep_stack.back();
+ key_keep_stack.pop_back();
+
+ if (!store_element)
+ {
+ return {false, nullptr};
+ }
+
+ JSON_ASSERT(object_element);
+ *object_element = std::move(value);
+ return {true, object_element};
+ }
+
+ /// the parsed JSON value
+ BasicJsonType& root;
+ /// stack to model hierarchy of values
+ std::vector<BasicJsonType*> ref_stack {};
+ /// stack to manage which values to keep
+ std::vector<bool> keep_stack {};
+ /// stack to manage which object keys to keep
+ std::vector<bool> key_keep_stack {};
+ /// helper to hold the reference for the next object element
+ BasicJsonType* object_element = nullptr;
+ /// whether a syntax error occurred
+ bool errored = false;
+ /// callback function
+ const parser_callback_t callback = nullptr;
+ /// whether to throw exceptions in case of errors
+ const bool allow_exceptions = true;
+ /// a discarded value for the callback
+ BasicJsonType discarded = BasicJsonType::value_t::discarded;
+};
+
+template<typename BasicJsonType>
+class json_sax_acceptor
+{
+ public:
+ using number_integer_t = typename BasicJsonType::number_integer_t;
+ using number_unsigned_t = typename BasicJsonType::number_unsigned_t;
+ using number_float_t = typename BasicJsonType::number_float_t;
+ using string_t = typename BasicJsonType::string_t;
+ using binary_t = typename BasicJsonType::binary_t;
+
+ bool null()
+ {
+ return true;
+ }
+
+ bool boolean(bool /*unused*/)
+ {
+ return true;
+ }
+
+ bool number_integer(number_integer_t /*unused*/)
+ {
+ return true;
+ }
+
+ bool number_unsigned(number_unsigned_t /*unused*/)
+ {
+ return true;
+ }
+
+ bool number_float(number_float_t /*unused*/, const string_t& /*unused*/)
+ {
+ return true;
+ }
+
+ bool string(string_t& /*unused*/)
+ {
+ return true;
+ }
+
+ bool binary(binary_t& /*unused*/)
+ {
+ return true;
+ }
+
+ bool start_object(std::size_t /*unused*/ = static_cast<std::size_t>(-1))
+ {
+ return true;
+ }
+
+ bool key(string_t& /*unused*/)
+ {
+ return true;
+ }
+
+ bool end_object()
+ {
+ return true;
+ }
+
+ bool start_array(std::size_t /*unused*/ = static_cast<std::size_t>(-1))
+ {
+ return true;
+ }
+
+ bool end_array()
+ {
+ return true;
+ }
+
+ bool parse_error(std::size_t /*unused*/, const std::string& /*unused*/, const detail::exception& /*unused*/)
+ {
+ return false;
+ }
+};
+} // namespace detail
+
+} // namespace nlohmann
+
+// #include <nlohmann/detail/input/lexer.hpp>
+
+
+#include <array> // array
+#include <clocale> // localeconv
+#include <cstddef> // size_t
+#include <cstdio> // snprintf
+#include <cstdlib> // strtof, strtod, strtold, strtoll, strtoull
+#include <initializer_list> // initializer_list
+#include <string> // char_traits, string
+#include <utility> // move
+#include <vector> // vector
+
+// #include <nlohmann/detail/input/input_adapters.hpp>
+
+// #include <nlohmann/detail/input/position_t.hpp>
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+///////////
+// lexer //
+///////////
+
+template<typename BasicJsonType>
+class lexer_base
+{
+ public:
+ /// token types for the parser
+ enum class token_type
+ {
+ uninitialized, ///< indicating the scanner is uninitialized
+ literal_true, ///< the `true` literal
+ literal_false, ///< the `false` literal
+ literal_null, ///< the `null` literal
+ value_string, ///< a string -- use get_string() for actual value
+ value_unsigned, ///< an unsigned integer -- use get_number_unsigned() for actual value
+ value_integer, ///< a signed integer -- use get_number_integer() for actual value
+ value_float, ///< an floating point number -- use get_number_float() for actual value
+ begin_array, ///< the character for array begin `[`
+ begin_object, ///< the character for object begin `{`
+ end_array, ///< the character for array end `]`
+ end_object, ///< the character for object end `}`
+ name_separator, ///< the name separator `:`
+ value_separator, ///< the value separator `,`
+ parse_error, ///< indicating a parse error
+ end_of_input, ///< indicating the end of the input buffer
+ literal_or_value ///< a literal or the begin of a value (only for diagnostics)
+ };
+
+ /// return name of values of type token_type (only used for errors)
+ JSON_HEDLEY_RETURNS_NON_NULL
+ JSON_HEDLEY_CONST
+ static const char* token_type_name(const token_type t) noexcept
+ {
+ switch (t)
+ {
+ case token_type::uninitialized:
+ return "<uninitialized>";
+ case token_type::literal_true:
+ return "true literal";
+ case token_type::literal_false:
+ return "false literal";
+ case token_type::literal_null:
+ return "null literal";
+ case token_type::value_string:
+ return "string literal";
+ case token_type::value_unsigned:
+ case token_type::value_integer:
+ case token_type::value_float:
+ return "number literal";
+ case token_type::begin_array:
+ return "'['";
+ case token_type::begin_object:
+ return "'{'";
+ case token_type::end_array:
+ return "']'";
+ case token_type::end_object:
+ return "'}'";
+ case token_type::name_separator:
+ return "':'";
+ case token_type::value_separator:
+ return "','";
+ case token_type::parse_error:
+ return "<parse error>";
+ case token_type::end_of_input:
+ return "end of input";
+ case token_type::literal_or_value:
+ return "'[', '{', or a literal";
+ // LCOV_EXCL_START
+ default: // catch non-enum values
+ return "unknown token";
+ // LCOV_EXCL_STOP
+ }
+ }
+};
+/*!
+@brief lexical analysis
+
+This class organizes the lexical analysis during JSON deserialization.
+*/
+template<typename BasicJsonType, typename InputAdapterType>
+class lexer : public lexer_base<BasicJsonType>
+{
+ using number_integer_t = typename BasicJsonType::number_integer_t;
+ using number_unsigned_t = typename BasicJsonType::number_unsigned_t;
+ using number_float_t = typename BasicJsonType::number_float_t;
+ using string_t = typename BasicJsonType::string_t;
+ using char_type = typename InputAdapterType::char_type;
+ using char_int_type = typename std::char_traits<char_type>::int_type;
+
+ public:
+ using token_type = typename lexer_base<BasicJsonType>::token_type;
+
+ explicit lexer(InputAdapterType&& adapter, bool ignore_comments_ = false) noexcept
+ : ia(std::move(adapter))
+ , ignore_comments(ignore_comments_)
+ , decimal_point_char(static_cast<char_int_type>(get_decimal_point()))
+ {}
+
+ // delete because of pointer members
+ lexer(const lexer&) = delete;
+ lexer(lexer&&) = default; // NOLINT(hicpp-noexcept-move,performance-noexcept-move-constructor)
+ lexer& operator=(lexer&) = delete;
+ lexer& operator=(lexer&&) = default; // NOLINT(hicpp-noexcept-move,performance-noexcept-move-constructor)
+ ~lexer() = default;
+
+ private:
+ /////////////////////
+ // locales
+ /////////////////////
+
+ /// return the locale-dependent decimal point
+ JSON_HEDLEY_PURE
+ static char get_decimal_point() noexcept
+ {
+ const auto* loc = localeconv();
+ JSON_ASSERT(loc != nullptr);
+ return (loc->decimal_point == nullptr) ? '.' : *(loc->decimal_point);
+ }
+
+ /////////////////////
+ // scan functions
+ /////////////////////
+
+ /*!
+ @brief get codepoint from 4 hex characters following `\u`
+
+ For input "\u c1 c2 c3 c4" the codepoint is:
+ (c1 * 0x1000) + (c2 * 0x0100) + (c3 * 0x0010) + c4
+ = (c1 << 12) + (c2 << 8) + (c3 << 4) + (c4 << 0)
+
+ Furthermore, the possible characters '0'..'9', 'A'..'F', and 'a'..'f'
+ must be converted to the integers 0x0..0x9, 0xA..0xF, 0xA..0xF, resp. The
+ conversion is done by subtracting the offset (0x30, 0x37, and 0x57)
+ between the ASCII value of the character and the desired integer value.
+
+ @return codepoint (0x0000..0xFFFF) or -1 in case of an error (e.g. EOF or
+ non-hex character)
+ */
+ int get_codepoint()
+ {
+ // this function only makes sense after reading `\u`
+ JSON_ASSERT(current == 'u');
+ int codepoint = 0;
+
+ const auto factors = { 12u, 8u, 4u, 0u };
+ for (const auto factor : factors)
+ {
+ get();
+
+ if (current >= '0' && current <= '9')
+ {
+ codepoint += static_cast<int>((static_cast<unsigned int>(current) - 0x30u) << factor);
+ }
+ else if (current >= 'A' && current <= 'F')
+ {
+ codepoint += static_cast<int>((static_cast<unsigned int>(current) - 0x37u) << factor);
+ }
+ else if (current >= 'a' && current <= 'f')
+ {
+ codepoint += static_cast<int>((static_cast<unsigned int>(current) - 0x57u) << factor);
+ }
+ else
+ {
+ return -1;
+ }
+ }
+
+ JSON_ASSERT(0x0000 <= codepoint && codepoint <= 0xFFFF);
+ return codepoint;
+ }
+
+ /*!
+ @brief check if the next byte(s) are inside a given range
+
+ Adds the current byte and, for each passed range, reads a new byte and
+ checks if it is inside the range. If a violation was detected, set up an
+ error message and return false. Otherwise, return true.
+
+ @param[in] ranges list of integers; interpreted as list of pairs of
+ inclusive lower and upper bound, respectively
+
+ @pre The passed list @a ranges must have 2, 4, or 6 elements; that is,
+ 1, 2, or 3 pairs. This precondition is enforced by an assertion.
+
+ @return true if and only if no range violation was detected
+ */
+ bool next_byte_in_range(std::initializer_list<char_int_type> ranges)
+ {
+ JSON_ASSERT(ranges.size() == 2 || ranges.size() == 4 || ranges.size() == 6);
+ add(current);
+
+ for (auto range = ranges.begin(); range != ranges.end(); ++range)
+ {
+ get();
+ if (JSON_HEDLEY_LIKELY(*range <= current && current <= *(++range)))
+ {
+ add(current);
+ }
+ else
+ {
+ error_message = "invalid string: ill-formed UTF-8 byte";
+ return false;
+ }
+ }
+
+ return true;
+ }
+
+ /*!
+ @brief scan a string literal
+
+ This function scans a string according to Sect. 7 of RFC 8259. While
+ scanning, bytes are escaped and copied into buffer token_buffer. Then the
+ function returns successfully, token_buffer is *not* null-terminated (as it
+ may contain \0 bytes), and token_buffer.size() is the number of bytes in the
+ string.
+
+ @return token_type::value_string if string could be successfully scanned,
+ token_type::parse_error otherwise
+
+ @note In case of errors, variable error_message contains a textual
+ description.
+ */
+ token_type scan_string()
+ {
+ // reset token_buffer (ignore opening quote)
+ reset();
+
+ // we entered the function by reading an open quote
+ JSON_ASSERT(current == '\"');
+
+ while (true)
+ {
+ // get next character
+ switch (get())
+ {
+ // end of file while parsing string
+ case std::char_traits<char_type>::eof():
+ {
+ error_message = "invalid string: missing closing quote";
+ return token_type::parse_error;
+ }
+
+ // closing quote
+ case '\"':
+ {
+ return token_type::value_string;
+ }
+
+ // escapes
+ case '\\':
+ {
+ switch (get())
+ {
+ // quotation mark
+ case '\"':
+ add('\"');
+ break;
+ // reverse solidus
+ case '\\':
+ add('\\');
+ break;
+ // solidus
+ case '/':
+ add('/');
+ break;
+ // backspace
+ case 'b':
+ add('\b');
+ break;
+ // form feed
+ case 'f':
+ add('\f');
+ break;
+ // line feed
+ case 'n':
+ add('\n');
+ break;
+ // carriage return
+ case 'r':
+ add('\r');
+ break;
+ // tab
+ case 't':
+ add('\t');
+ break;
+
+ // unicode escapes
+ case 'u':
+ {
+ const int codepoint1 = get_codepoint();
+ int codepoint = codepoint1; // start with codepoint1
+
+ if (JSON_HEDLEY_UNLIKELY(codepoint1 == -1))
+ {
+ error_message = "invalid string: '\\u' must be followed by 4 hex digits";
+ return token_type::parse_error;
+ }
+
+ // check if code point is a high surrogate
+ if (0xD800 <= codepoint1 && codepoint1 <= 0xDBFF)
+ {
+ // expect next \uxxxx entry
+ if (JSON_HEDLEY_LIKELY(get() == '\\' && get() == 'u'))
+ {
+ const int codepoint2 = get_codepoint();
+
+ if (JSON_HEDLEY_UNLIKELY(codepoint2 == -1))
+ {
+ error_message = "invalid string: '\\u' must be followed by 4 hex digits";
+ return token_type::parse_error;
+ }
+
+ // check if codepoint2 is a low surrogate
+ if (JSON_HEDLEY_LIKELY(0xDC00 <= codepoint2 && codepoint2 <= 0xDFFF))
+ {
+ // overwrite codepoint
+ codepoint = static_cast<int>(
+ // high surrogate occupies the most significant 22 bits
+ (static_cast<unsigned int>(codepoint1) << 10u)
+ // low surrogate occupies the least significant 15 bits
+ + static_cast<unsigned int>(codepoint2)
+ // there is still the 0xD800, 0xDC00 and 0x10000 noise
+ // in the result, so we have to subtract with:
+ // (0xD800 << 10) + DC00 - 0x10000 = 0x35FDC00
+ - 0x35FDC00u);
+ }
+ else
+ {
+ error_message = "invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF";
+ return token_type::parse_error;
+ }
+ }
+ else
+ {
+ error_message = "invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF";
+ return token_type::parse_error;
+ }
+ }
+ else
+ {
+ if (JSON_HEDLEY_UNLIKELY(0xDC00 <= codepoint1 && codepoint1 <= 0xDFFF))
+ {
+ error_message = "invalid string: surrogate U+DC00..U+DFFF must follow U+D800..U+DBFF";
+ return token_type::parse_error;
+ }
+ }
+
+ // result of the above calculation yields a proper codepoint
+ JSON_ASSERT(0x00 <= codepoint && codepoint <= 0x10FFFF);
+
+ // translate codepoint into bytes
+ if (codepoint < 0x80)
+ {
+ // 1-byte characters: 0xxxxxxx (ASCII)
+ add(static_cast<char_int_type>(codepoint));
+ }
+ else if (codepoint <= 0x7FF)
+ {
+ // 2-byte characters: 110xxxxx 10xxxxxx
+ add(static_cast<char_int_type>(0xC0u | (static_cast<unsigned int>(codepoint) >> 6u)));
+ add(static_cast<char_int_type>(0x80u | (static_cast<unsigned int>(codepoint) & 0x3Fu)));
+ }
+ else if (codepoint <= 0xFFFF)
+ {
+ // 3-byte characters: 1110xxxx 10xxxxxx 10xxxxxx
+ add(static_cast<char_int_type>(0xE0u | (static_cast<unsigned int>(codepoint) >> 12u)));
+ add(static_cast<char_int_type>(0x80u | ((static_cast<unsigned int>(codepoint) >> 6u) & 0x3Fu)));
+ add(static_cast<char_int_type>(0x80u | (static_cast<unsigned int>(codepoint) & 0x3Fu)));
+ }
+ else
+ {
+ // 4-byte characters: 11110xxx 10xxxxxx 10xxxxxx 10xxxxxx
+ add(static_cast<char_int_type>(0xF0u | (static_cast<unsigned int>(codepoint) >> 18u)));
+ add(static_cast<char_int_type>(0x80u | ((static_cast<unsigned int>(codepoint) >> 12u) & 0x3Fu)));
+ add(static_cast<char_int_type>(0x80u | ((static_cast<unsigned int>(codepoint) >> 6u) & 0x3Fu)));
+ add(static_cast<char_int_type>(0x80u | (static_cast<unsigned int>(codepoint) & 0x3Fu)));
+ }
+
+ break;
+ }
+
+ // other characters after escape
+ default:
+ error_message = "invalid string: forbidden character after backslash";
+ return token_type::parse_error;
+ }
+
+ break;
+ }
+
+ // invalid control characters
+ case 0x00:
+ {
+ error_message = "invalid string: control character U+0000 (NUL) must be escaped to \\u0000";
+ return token_type::parse_error;
+ }
+
+ case 0x01:
+ {
+ error_message = "invalid string: control character U+0001 (SOH) must be escaped to \\u0001";
+ return token_type::parse_error;
+ }
+
+ case 0x02:
+ {
+ error_message = "invalid string: control character U+0002 (STX) must be escaped to \\u0002";
+ return token_type::parse_error;
+ }
+
+ case 0x03:
+ {
+ error_message = "invalid string: control character U+0003 (ETX) must be escaped to \\u0003";
+ return token_type::parse_error;
+ }
+
+ case 0x04:
+ {
+ error_message = "invalid string: control character U+0004 (EOT) must be escaped to \\u0004";
+ return token_type::parse_error;
+ }
+
+ case 0x05:
+ {
+ error_message = "invalid string: control character U+0005 (ENQ) must be escaped to \\u0005";
+ return token_type::parse_error;
+ }
+
+ case 0x06:
+ {
+ error_message = "invalid string: control character U+0006 (ACK) must be escaped to \\u0006";
+ return token_type::parse_error;
+ }
+
+ case 0x07:
+ {
+ error_message = "invalid string: control character U+0007 (BEL) must be escaped to \\u0007";
+ return token_type::parse_error;
+ }
+
+ case 0x08:
+ {
+ error_message = "invalid string: control character U+0008 (BS) must be escaped to \\u0008 or \\b";
+ return token_type::parse_error;
+ }
+
+ case 0x09:
+ {
+ error_message = "invalid string: control character U+0009 (HT) must be escaped to \\u0009 or \\t";
+ return token_type::parse_error;
+ }
+
+ case 0x0A:
+ {
+ error_message = "invalid string: control character U+000A (LF) must be escaped to \\u000A or \\n";
+ return token_type::parse_error;
+ }
+
+ case 0x0B:
+ {
+ error_message = "invalid string: control character U+000B (VT) must be escaped to \\u000B";
+ return token_type::parse_error;
+ }
+
+ case 0x0C:
+ {
+ error_message = "invalid string: control character U+000C (FF) must be escaped to \\u000C or \\f";
+ return token_type::parse_error;
+ }
+
+ case 0x0D:
+ {
+ error_message = "invalid string: control character U+000D (CR) must be escaped to \\u000D or \\r";
+ return token_type::parse_error;
+ }
+
+ case 0x0E:
+ {
+ error_message = "invalid string: control character U+000E (SO) must be escaped to \\u000E";
+ return token_type::parse_error;
+ }
+
+ case 0x0F:
+ {
+ error_message = "invalid string: control character U+000F (SI) must be escaped to \\u000F";
+ return token_type::parse_error;
+ }
+
+ case 0x10:
+ {
+ error_message = "invalid string: control character U+0010 (DLE) must be escaped to \\u0010";
+ return token_type::parse_error;
+ }
+
+ case 0x11:
+ {
+ error_message = "invalid string: control character U+0011 (DC1) must be escaped to \\u0011";
+ return token_type::parse_error;
+ }
+
+ case 0x12:
+ {
+ error_message = "invalid string: control character U+0012 (DC2) must be escaped to \\u0012";
+ return token_type::parse_error;
+ }
+
+ case 0x13:
+ {
+ error_message = "invalid string: control character U+0013 (DC3) must be escaped to \\u0013";
+ return token_type::parse_error;
+ }
+
+ case 0x14:
+ {
+ error_message = "invalid string: control character U+0014 (DC4) must be escaped to \\u0014";
+ return token_type::parse_error;
+ }
+
+ case 0x15:
+ {
+ error_message = "invalid string: control character U+0015 (NAK) must be escaped to \\u0015";
+ return token_type::parse_error;
+ }
+
+ case 0x16:
+ {
+ error_message = "invalid string: control character U+0016 (SYN) must be escaped to \\u0016";
+ return token_type::parse_error;
+ }
+
+ case 0x17:
+ {
+ error_message = "invalid string: control character U+0017 (ETB) must be escaped to \\u0017";
+ return token_type::parse_error;
+ }
+
+ case 0x18:
+ {
+ error_message = "invalid string: control character U+0018 (CAN) must be escaped to \\u0018";
+ return token_type::parse_error;
+ }
+
+ case 0x19:
+ {
+ error_message = "invalid string: control character U+0019 (EM) must be escaped to \\u0019";
+ return token_type::parse_error;
+ }
+
+ case 0x1A:
+ {
+ error_message = "invalid string: control character U+001A (SUB) must be escaped to \\u001A";
+ return token_type::parse_error;
+ }
+
+ case 0x1B:
+ {
+ error_message = "invalid string: control character U+001B (ESC) must be escaped to \\u001B";
+ return token_type::parse_error;
+ }
+
+ case 0x1C:
+ {
+ error_message = "invalid string: control character U+001C (FS) must be escaped to \\u001C";
+ return token_type::parse_error;
+ }
+
+ case 0x1D:
+ {
+ error_message = "invalid string: control character U+001D (GS) must be escaped to \\u001D";
+ return token_type::parse_error;
+ }
+
+ case 0x1E:
+ {
+ error_message = "invalid string: control character U+001E (RS) must be escaped to \\u001E";
+ return token_type::parse_error;
+ }
+
+ case 0x1F:
+ {
+ error_message = "invalid string: control character U+001F (US) must be escaped to \\u001F";
+ return token_type::parse_error;
+ }
+
+ // U+0020..U+007F (except U+0022 (quote) and U+005C (backspace))
+ case 0x20:
+ case 0x21:
+ case 0x23:
+ case 0x24:
+ case 0x25:
+ case 0x26:
+ case 0x27:
+ case 0x28:
+ case 0x29:
+ case 0x2A:
+ case 0x2B:
+ case 0x2C:
+ case 0x2D:
+ case 0x2E:
+ case 0x2F:
+ case 0x30:
+ case 0x31:
+ case 0x32:
+ case 0x33:
+ case 0x34:
+ case 0x35:
+ case 0x36:
+ case 0x37:
+ case 0x38:
+ case 0x39:
+ case 0x3A:
+ case 0x3B:
+ case 0x3C:
+ case 0x3D:
+ case 0x3E:
+ case 0x3F:
+ case 0x40:
+ case 0x41:
+ case 0x42:
+ case 0x43:
+ case 0x44:
+ case 0x45:
+ case 0x46:
+ case 0x47:
+ case 0x48:
+ case 0x49:
+ case 0x4A:
+ case 0x4B:
+ case 0x4C:
+ case 0x4D:
+ case 0x4E:
+ case 0x4F:
+ case 0x50:
+ case 0x51:
+ case 0x52:
+ case 0x53:
+ case 0x54:
+ case 0x55:
+ case 0x56:
+ case 0x57:
+ case 0x58:
+ case 0x59:
+ case 0x5A:
+ case 0x5B:
+ case 0x5D:
+ case 0x5E:
+ case 0x5F:
+ case 0x60:
+ case 0x61:
+ case 0x62:
+ case 0x63:
+ case 0x64:
+ case 0x65:
+ case 0x66:
+ case 0x67:
+ case 0x68:
+ case 0x69:
+ case 0x6A:
+ case 0x6B:
+ case 0x6C:
+ case 0x6D:
+ case 0x6E:
+ case 0x6F:
+ case 0x70:
+ case 0x71:
+ case 0x72:
+ case 0x73:
+ case 0x74:
+ case 0x75:
+ case 0x76:
+ case 0x77:
+ case 0x78:
+ case 0x79:
+ case 0x7A:
+ case 0x7B:
+ case 0x7C:
+ case 0x7D:
+ case 0x7E:
+ case 0x7F:
+ {
+ add(current);
+ break;
+ }
+
+ // U+0080..U+07FF: bytes C2..DF 80..BF
+ case 0xC2:
+ case 0xC3:
+ case 0xC4:
+ case 0xC5:
+ case 0xC6:
+ case 0xC7:
+ case 0xC8:
+ case 0xC9:
+ case 0xCA:
+ case 0xCB:
+ case 0xCC:
+ case 0xCD:
+ case 0xCE:
+ case 0xCF:
+ case 0xD0:
+ case 0xD1:
+ case 0xD2:
+ case 0xD3:
+ case 0xD4:
+ case 0xD5:
+ case 0xD6:
+ case 0xD7:
+ case 0xD8:
+ case 0xD9:
+ case 0xDA:
+ case 0xDB:
+ case 0xDC:
+ case 0xDD:
+ case 0xDE:
+ case 0xDF:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!next_byte_in_range({0x80, 0xBF})))
+ {
+ return token_type::parse_error;
+ }
+ break;
+ }
+
+ // U+0800..U+0FFF: bytes E0 A0..BF 80..BF
+ case 0xE0:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!(next_byte_in_range({0xA0, 0xBF, 0x80, 0xBF}))))
+ {
+ return token_type::parse_error;
+ }
+ break;
+ }
+
+ // U+1000..U+CFFF: bytes E1..EC 80..BF 80..BF
+ // U+E000..U+FFFF: bytes EE..EF 80..BF 80..BF
+ case 0xE1:
+ case 0xE2:
+ case 0xE3:
+ case 0xE4:
+ case 0xE5:
+ case 0xE6:
+ case 0xE7:
+ case 0xE8:
+ case 0xE9:
+ case 0xEA:
+ case 0xEB:
+ case 0xEC:
+ case 0xEE:
+ case 0xEF:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!(next_byte_in_range({0x80, 0xBF, 0x80, 0xBF}))))
+ {
+ return token_type::parse_error;
+ }
+ break;
+ }
+
+ // U+D000..U+D7FF: bytes ED 80..9F 80..BF
+ case 0xED:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!(next_byte_in_range({0x80, 0x9F, 0x80, 0xBF}))))
+ {
+ return token_type::parse_error;
+ }
+ break;
+ }
+
+ // U+10000..U+3FFFF F0 90..BF 80..BF 80..BF
+ case 0xF0:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!(next_byte_in_range({0x90, 0xBF, 0x80, 0xBF, 0x80, 0xBF}))))
+ {
+ return token_type::parse_error;
+ }
+ break;
+ }
+
+ // U+40000..U+FFFFF F1..F3 80..BF 80..BF 80..BF
+ case 0xF1:
+ case 0xF2:
+ case 0xF3:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!(next_byte_in_range({0x80, 0xBF, 0x80, 0xBF, 0x80, 0xBF}))))
+ {
+ return token_type::parse_error;
+ }
+ break;
+ }
+
+ // U+100000..U+10FFFF F4 80..8F 80..BF 80..BF
+ case 0xF4:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!(next_byte_in_range({0x80, 0x8F, 0x80, 0xBF, 0x80, 0xBF}))))
+ {
+ return token_type::parse_error;
+ }
+ break;
+ }
+
+ // remaining bytes (80..C1 and F5..FF) are ill-formed
+ default:
+ {
+ error_message = "invalid string: ill-formed UTF-8 byte";
+ return token_type::parse_error;
+ }
+ }
+ }
+ }
+
+ /*!
+ * @brief scan a comment
+ * @return whether comment could be scanned successfully
+ */
+ bool scan_comment()
+ {
+ switch (get())
+ {
+ // single-line comments skip input until a newline or EOF is read
+ case '/':
+ {
+ while (true)
+ {
+ switch (get())
+ {
+ case '\n':
+ case '\r':
+ case std::char_traits<char_type>::eof():
+ case '\0':
+ return true;
+
+ default:
+ break;
+ }
+ }
+ }
+
+ // multi-line comments skip input until */ is read
+ case '*':
+ {
+ while (true)
+ {
+ switch (get())
+ {
+ case std::char_traits<char_type>::eof():
+ case '\0':
+ {
+ error_message = "invalid comment; missing closing '*/'";
+ return false;
+ }
+
+ case '*':
+ {
+ switch (get())
+ {
+ case '/':
+ return true;
+
+ default:
+ {
+ unget();
+ continue;
+ }
+ }
+ }
+
+ default:
+ continue;
+ }
+ }
+ }
+
+ // unexpected character after reading '/'
+ default:
+ {
+ error_message = "invalid comment; expecting '/' or '*' after '/'";
+ return false;
+ }
+ }
+ }
+
+ JSON_HEDLEY_NON_NULL(2)
+ static void strtof(float& f, const char* str, char** endptr) noexcept
+ {
+ f = std::strtof(str, endptr);
+ }
+
+ JSON_HEDLEY_NON_NULL(2)
+ static void strtof(double& f, const char* str, char** endptr) noexcept
+ {
+ f = std::strtod(str, endptr);
+ }
+
+ JSON_HEDLEY_NON_NULL(2)
+ static void strtof(long double& f, const char* str, char** endptr) noexcept
+ {
+ f = std::strtold(str, endptr);
+ }
+
+ /*!
+ @brief scan a number literal
+
+ This function scans a string according to Sect. 6 of RFC 8259.
+
+ The function is realized with a deterministic finite state machine derived
+ from the grammar described in RFC 8259. Starting in state "init", the
+ input is read and used to determined the next state. Only state "done"
+ accepts the number. State "error" is a trap state to model errors. In the
+ table below, "anything" means any character but the ones listed before.
+
+ state | 0 | 1-9 | e E | + | - | . | anything
+ ---------|----------|----------|----------|---------|---------|----------|-----------
+ init | zero | any1 | [error] | [error] | minus | [error] | [error]
+ minus | zero | any1 | [error] | [error] | [error] | [error] | [error]
+ zero | done | done | exponent | done | done | decimal1 | done
+ any1 | any1 | any1 | exponent | done | done | decimal1 | done
+ decimal1 | decimal2 | decimal2 | [error] | [error] | [error] | [error] | [error]
+ decimal2 | decimal2 | decimal2 | exponent | done | done | done | done
+ exponent | any2 | any2 | [error] | sign | sign | [error] | [error]
+ sign | any2 | any2 | [error] | [error] | [error] | [error] | [error]
+ any2 | any2 | any2 | done | done | done | done | done
+
+ The state machine is realized with one label per state (prefixed with
+ "scan_number_") and `goto` statements between them. The state machine
+ contains cycles, but any cycle can be left when EOF is read. Therefore,
+ the function is guaranteed to terminate.
+
+ During scanning, the read bytes are stored in token_buffer. This string is
+ then converted to a signed integer, an unsigned integer, or a
+ floating-point number.
+
+ @return token_type::value_unsigned, token_type::value_integer, or
+ token_type::value_float if number could be successfully scanned,
+ token_type::parse_error otherwise
+
+ @note The scanner is independent of the current locale. Internally, the
+ locale's decimal point is used instead of `.` to work with the
+ locale-dependent converters.
+ */
+ token_type scan_number() // lgtm [cpp/use-of-goto]
+ {
+ // reset token_buffer to store the number's bytes
+ reset();
+
+ // the type of the parsed number; initially set to unsigned; will be
+ // changed if minus sign, decimal point or exponent is read
+ token_type number_type = token_type::value_unsigned;
+
+ // state (init): we just found out we need to scan a number
+ switch (current)
+ {
+ case '-':
+ {
+ add(current);
+ goto scan_number_minus;
+ }
+
+ case '0':
+ {
+ add(current);
+ goto scan_number_zero;
+ }
+
+ case '1':
+ case '2':
+ case '3':
+ case '4':
+ case '5':
+ case '6':
+ case '7':
+ case '8':
+ case '9':
+ {
+ add(current);
+ goto scan_number_any1;
+ }
+
+ // all other characters are rejected outside scan_number()
+ default: // LCOV_EXCL_LINE
+ JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert) LCOV_EXCL_LINE
+ }
+
+scan_number_minus:
+ // state: we just parsed a leading minus sign
+ number_type = token_type::value_integer;
+ switch (get())
+ {
+ case '0':
+ {
+ add(current);
+ goto scan_number_zero;
+ }
+
+ case '1':
+ case '2':
+ case '3':
+ case '4':
+ case '5':
+ case '6':
+ case '7':
+ case '8':
+ case '9':
+ {
+ add(current);
+ goto scan_number_any1;
+ }
+
+ default:
+ {
+ error_message = "invalid number; expected digit after '-'";
+ return token_type::parse_error;
+ }
+ }
+
+scan_number_zero:
+ // state: we just parse a zero (maybe with a leading minus sign)
+ switch (get())
+ {
+ case '.':
+ {
+ add(decimal_point_char);
+ goto scan_number_decimal1;
+ }
+
+ case 'e':
+ case 'E':
+ {
+ add(current);
+ goto scan_number_exponent;
+ }
+
+ default:
+ goto scan_number_done;
+ }
+
+scan_number_any1:
+ // state: we just parsed a number 0-9 (maybe with a leading minus sign)
+ switch (get())
+ {
+ case '0':
+ case '1':
+ case '2':
+ case '3':
+ case '4':
+ case '5':
+ case '6':
+ case '7':
+ case '8':
+ case '9':
+ {
+ add(current);
+ goto scan_number_any1;
+ }
+
+ case '.':
+ {
+ add(decimal_point_char);
+ goto scan_number_decimal1;
+ }
+
+ case 'e':
+ case 'E':
+ {
+ add(current);
+ goto scan_number_exponent;
+ }
+
+ default:
+ goto scan_number_done;
+ }
+
+scan_number_decimal1:
+ // state: we just parsed a decimal point
+ number_type = token_type::value_float;
+ switch (get())
+ {
+ case '0':
+ case '1':
+ case '2':
+ case '3':
+ case '4':
+ case '5':
+ case '6':
+ case '7':
+ case '8':
+ case '9':
+ {
+ add(current);
+ goto scan_number_decimal2;
+ }
+
+ default:
+ {
+ error_message = "invalid number; expected digit after '.'";
+ return token_type::parse_error;
+ }
+ }
+
+scan_number_decimal2:
+ // we just parsed at least one number after a decimal point
+ switch (get())
+ {
+ case '0':
+ case '1':
+ case '2':
+ case '3':
+ case '4':
+ case '5':
+ case '6':
+ case '7':
+ case '8':
+ case '9':
+ {
+ add(current);
+ goto scan_number_decimal2;
+ }
+
+ case 'e':
+ case 'E':
+ {
+ add(current);
+ goto scan_number_exponent;
+ }
+
+ default:
+ goto scan_number_done;
+ }
+
+scan_number_exponent:
+ // we just parsed an exponent
+ number_type = token_type::value_float;
+ switch (get())
+ {
+ case '+':
+ case '-':
+ {
+ add(current);
+ goto scan_number_sign;
+ }
+
+ case '0':
+ case '1':
+ case '2':
+ case '3':
+ case '4':
+ case '5':
+ case '6':
+ case '7':
+ case '8':
+ case '9':
+ {
+ add(current);
+ goto scan_number_any2;
+ }
+
+ default:
+ {
+ error_message =
+ "invalid number; expected '+', '-', or digit after exponent";
+ return token_type::parse_error;
+ }
+ }
+
+scan_number_sign:
+ // we just parsed an exponent sign
+ switch (get())
+ {
+ case '0':
+ case '1':
+ case '2':
+ case '3':
+ case '4':
+ case '5':
+ case '6':
+ case '7':
+ case '8':
+ case '9':
+ {
+ add(current);
+ goto scan_number_any2;
+ }
+
+ default:
+ {
+ error_message = "invalid number; expected digit after exponent sign";
+ return token_type::parse_error;
+ }
+ }
+
+scan_number_any2:
+ // we just parsed a number after the exponent or exponent sign
+ switch (get())
+ {
+ case '0':
+ case '1':
+ case '2':
+ case '3':
+ case '4':
+ case '5':
+ case '6':
+ case '7':
+ case '8':
+ case '9':
+ {
+ add(current);
+ goto scan_number_any2;
+ }
+
+ default:
+ goto scan_number_done;
+ }
+
+scan_number_done:
+ // unget the character after the number (we only read it to know that
+ // we are done scanning a number)
+ unget();
+
+ char* endptr = nullptr; // NOLINT(cppcoreguidelines-pro-type-vararg,hicpp-vararg)
+ errno = 0;
+
+ // try to parse integers first and fall back to floats
+ if (number_type == token_type::value_unsigned)
+ {
+ const auto x = std::strtoull(token_buffer.data(), &endptr, 10);
+
+ // we checked the number format before
+ JSON_ASSERT(endptr == token_buffer.data() + token_buffer.size());
+
+ if (errno == 0)
+ {
+ value_unsigned = static_cast<number_unsigned_t>(x);
+ if (value_unsigned == x)
+ {
+ return token_type::value_unsigned;
+ }
+ }
+ }
+ else if (number_type == token_type::value_integer)
+ {
+ const auto x = std::strtoll(token_buffer.data(), &endptr, 10);
+
+ // we checked the number format before
+ JSON_ASSERT(endptr == token_buffer.data() + token_buffer.size());
+
+ if (errno == 0)
+ {
+ value_integer = static_cast<number_integer_t>(x);
+ if (value_integer == x)
+ {
+ return token_type::value_integer;
+ }
+ }
+ }
+
+ // this code is reached if we parse a floating-point number or if an
+ // integer conversion above failed
+ strtof(value_float, token_buffer.data(), &endptr);
+
+ // we checked the number format before
+ JSON_ASSERT(endptr == token_buffer.data() + token_buffer.size());
+
+ return token_type::value_float;
+ }
+
+ /*!
+ @param[in] literal_text the literal text to expect
+ @param[in] length the length of the passed literal text
+ @param[in] return_type the token type to return on success
+ */
+ JSON_HEDLEY_NON_NULL(2)
+ token_type scan_literal(const char_type* literal_text, const std::size_t length,
+ token_type return_type)
+ {
+ JSON_ASSERT(std::char_traits<char_type>::to_char_type(current) == literal_text[0]);
+ for (std::size_t i = 1; i < length; ++i)
+ {
+ if (JSON_HEDLEY_UNLIKELY(std::char_traits<char_type>::to_char_type(get()) != literal_text[i]))
+ {
+ error_message = "invalid literal";
+ return token_type::parse_error;
+ }
+ }
+ return return_type;
+ }
+
+ /////////////////////
+ // input management
+ /////////////////////
+
+ /// reset token_buffer; current character is beginning of token
+ void reset() noexcept
+ {
+ token_buffer.clear();
+ token_string.clear();
+ token_string.push_back(std::char_traits<char_type>::to_char_type(current));
+ }
+
+ /*
+ @brief get next character from the input
+
+ This function provides the interface to the used input adapter. It does
+ not throw in case the input reached EOF, but returns a
+ `std::char_traits<char>::eof()` in that case. Stores the scanned characters
+ for use in error messages.
+
+ @return character read from the input
+ */
+ char_int_type get()
+ {
+ ++position.chars_read_total;
+ ++position.chars_read_current_line;
+
+ if (next_unget)
+ {
+ // just reset the next_unget variable and work with current
+ next_unget = false;
+ }
+ else
+ {
+ current = ia.get_character();
+ }
+
+ if (JSON_HEDLEY_LIKELY(current != std::char_traits<char_type>::eof()))
+ {
+ token_string.push_back(std::char_traits<char_type>::to_char_type(current));
+ }
+
+ if (current == '\n')
+ {
+ ++position.lines_read;
+ position.chars_read_current_line = 0;
+ }
+
+ return current;
+ }
+
+ /*!
+ @brief unget current character (read it again on next get)
+
+ We implement unget by setting variable next_unget to true. The input is not
+ changed - we just simulate ungetting by modifying chars_read_total,
+ chars_read_current_line, and token_string. The next call to get() will
+ behave as if the unget character is read again.
+ */
+ void unget()
+ {
+ next_unget = true;
+
+ --position.chars_read_total;
+
+ // in case we "unget" a newline, we have to also decrement the lines_read
+ if (position.chars_read_current_line == 0)
+ {
+ if (position.lines_read > 0)
+ {
+ --position.lines_read;
+ }
+ }
+ else
+ {
+ --position.chars_read_current_line;
+ }
+
+ if (JSON_HEDLEY_LIKELY(current != std::char_traits<char_type>::eof()))
+ {
+ JSON_ASSERT(!token_string.empty());
+ token_string.pop_back();
+ }
+ }
+
+ /// add a character to token_buffer
+ void add(char_int_type c)
+ {
+ token_buffer.push_back(static_cast<typename string_t::value_type>(c));
+ }
+
+ public:
+ /////////////////////
+ // value getters
+ /////////////////////
+
+ /// return integer value
+ constexpr number_integer_t get_number_integer() const noexcept
+ {
+ return value_integer;
+ }
+
+ /// return unsigned integer value
+ constexpr number_unsigned_t get_number_unsigned() const noexcept
+ {
+ return value_unsigned;
+ }
+
+ /// return floating-point value
+ constexpr number_float_t get_number_float() const noexcept
+ {
+ return value_float;
+ }
+
+ /// return current string value (implicitly resets the token; useful only once)
+ string_t& get_string()
+ {
+ return token_buffer;
+ }
+
+ /////////////////////
+ // diagnostics
+ /////////////////////
+
+ /// return position of last read token
+ constexpr position_t get_position() const noexcept
+ {
+ return position;
+ }
+
+ /// return the last read token (for errors only). Will never contain EOF
+ /// (an arbitrary value that is not a valid char value, often -1), because
+ /// 255 may legitimately occur. May contain NUL, which should be escaped.
+ std::string get_token_string() const
+ {
+ // escape control characters
+ std::string result;
+ for (const auto c : token_string)
+ {
+ if (static_cast<unsigned char>(c) <= '\x1F')
+ {
+ // escape control characters
+ std::array<char, 9> cs{{}};
+ static_cast<void>((std::snprintf)(cs.data(), cs.size(), "<U+%.4X>", static_cast<unsigned char>(c))); // NOLINT(cppcoreguidelines-pro-type-vararg,hicpp-vararg)
+ result += cs.data();
+ }
+ else
+ {
+ // add character as is
+ result.push_back(static_cast<std::string::value_type>(c));
+ }
+ }
+
+ return result;
+ }
+
+ /// return syntax error message
+ JSON_HEDLEY_RETURNS_NON_NULL
+ constexpr const char* get_error_message() const noexcept
+ {
+ return error_message;
+ }
+
+ /////////////////////
+ // actual scanner
+ /////////////////////
+
+ /*!
+ @brief skip the UTF-8 byte order mark
+ @return true iff there is no BOM or the correct BOM has been skipped
+ */
+ bool skip_bom()
+ {
+ if (get() == 0xEF)
+ {
+ // check if we completely parse the BOM
+ return get() == 0xBB && get() == 0xBF;
+ }
+
+ // the first character is not the beginning of the BOM; unget it to
+ // process is later
+ unget();
+ return true;
+ }
+
+ void skip_whitespace()
+ {
+ do
+ {
+ get();
+ }
+ while (current == ' ' || current == '\t' || current == '\n' || current == '\r');
+ }
+
+ token_type scan()
+ {
+ // initially, skip the BOM
+ if (position.chars_read_total == 0 && !skip_bom())
+ {
+ error_message = "invalid BOM; must be 0xEF 0xBB 0xBF if given";
+ return token_type::parse_error;
+ }
+
+ // read next character and ignore whitespace
+ skip_whitespace();
+
+ // ignore comments
+ while (ignore_comments && current == '/')
+ {
+ if (!scan_comment())
+ {
+ return token_type::parse_error;
+ }
+
+ // skip following whitespace
+ skip_whitespace();
+ }
+
+ switch (current)
+ {
+ // structural characters
+ case '[':
+ return token_type::begin_array;
+ case ']':
+ return token_type::end_array;
+ case '{':
+ return token_type::begin_object;
+ case '}':
+ return token_type::end_object;
+ case ':':
+ return token_type::name_separator;
+ case ',':
+ return token_type::value_separator;
+
+ // literals
+ case 't':
+ {
+ std::array<char_type, 4> true_literal = {{static_cast<char_type>('t'), static_cast<char_type>('r'), static_cast<char_type>('u'), static_cast<char_type>('e')}};
+ return scan_literal(true_literal.data(), true_literal.size(), token_type::literal_true);
+ }
+ case 'f':
+ {
+ std::array<char_type, 5> false_literal = {{static_cast<char_type>('f'), static_cast<char_type>('a'), static_cast<char_type>('l'), static_cast<char_type>('s'), static_cast<char_type>('e')}};
+ return scan_literal(false_literal.data(), false_literal.size(), token_type::literal_false);
+ }
+ case 'n':
+ {
+ std::array<char_type, 4> null_literal = {{static_cast<char_type>('n'), static_cast<char_type>('u'), static_cast<char_type>('l'), static_cast<char_type>('l')}};
+ return scan_literal(null_literal.data(), null_literal.size(), token_type::literal_null);
+ }
+
+ // string
+ case '\"':
+ return scan_string();
+
+ // number
+ case '-':
+ case '0':
+ case '1':
+ case '2':
+ case '3':
+ case '4':
+ case '5':
+ case '6':
+ case '7':
+ case '8':
+ case '9':
+ return scan_number();
+
+ // end of input (the null byte is needed when parsing from
+ // string literals)
+ case '\0':
+ case std::char_traits<char_type>::eof():
+ return token_type::end_of_input;
+
+ // error
+ default:
+ error_message = "invalid literal";
+ return token_type::parse_error;
+ }
+ }
+
+ private:
+ /// input adapter
+ InputAdapterType ia;
+
+ /// whether comments should be ignored (true) or signaled as errors (false)
+ const bool ignore_comments = false;
+
+ /// the current character
+ char_int_type current = std::char_traits<char_type>::eof();
+
+ /// whether the next get() call should just return current
+ bool next_unget = false;
+
+ /// the start position of the current token
+ position_t position {};
+
+ /// raw input token string (for error messages)
+ std::vector<char_type> token_string {};
+
+ /// buffer for variable-length tokens (numbers, strings)
+ string_t token_buffer {};
+
+ /// a description of occurred lexer errors
+ const char* error_message = "";
+
+ // number values
+ number_integer_t value_integer = 0;
+ number_unsigned_t value_unsigned = 0;
+ number_float_t value_float = 0;
+
+ /// the decimal point
+ const char_int_type decimal_point_char = '.';
+};
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+// #include <nlohmann/detail/meta/is_sax.hpp>
+
+
+#include <cstdint> // size_t
+#include <utility> // declval
+#include <string> // string
+
+// #include <nlohmann/detail/meta/detected.hpp>
+
+// #include <nlohmann/detail/meta/type_traits.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+template<typename T>
+using null_function_t = decltype(std::declval<T&>().null());
+
+template<typename T>
+using boolean_function_t =
+ decltype(std::declval<T&>().boolean(std::declval<bool>()));
+
+template<typename T, typename Integer>
+using number_integer_function_t =
+ decltype(std::declval<T&>().number_integer(std::declval<Integer>()));
+
+template<typename T, typename Unsigned>
+using number_unsigned_function_t =
+ decltype(std::declval<T&>().number_unsigned(std::declval<Unsigned>()));
+
+template<typename T, typename Float, typename String>
+using number_float_function_t = decltype(std::declval<T&>().number_float(
+ std::declval<Float>(), std::declval<const String&>()));
+
+template<typename T, typename String>
+using string_function_t =
+ decltype(std::declval<T&>().string(std::declval<String&>()));
+
+template<typename T, typename Binary>
+using binary_function_t =
+ decltype(std::declval<T&>().binary(std::declval<Binary&>()));
+
+template<typename T>
+using start_object_function_t =
+ decltype(std::declval<T&>().start_object(std::declval<std::size_t>()));
+
+template<typename T, typename String>
+using key_function_t =
+ decltype(std::declval<T&>().key(std::declval<String&>()));
+
+template<typename T>
+using end_object_function_t = decltype(std::declval<T&>().end_object());
+
+template<typename T>
+using start_array_function_t =
+ decltype(std::declval<T&>().start_array(std::declval<std::size_t>()));
+
+template<typename T>
+using end_array_function_t = decltype(std::declval<T&>().end_array());
+
+template<typename T, typename Exception>
+using parse_error_function_t = decltype(std::declval<T&>().parse_error(
+ std::declval<std::size_t>(), std::declval<const std::string&>(),
+ std::declval<const Exception&>()));
+
+template<typename SAX, typename BasicJsonType>
+struct is_sax
+{
+ private:
+ static_assert(is_basic_json<BasicJsonType>::value,
+ "BasicJsonType must be of type basic_json<...>");
+
+ using number_integer_t = typename BasicJsonType::number_integer_t;
+ using number_unsigned_t = typename BasicJsonType::number_unsigned_t;
+ using number_float_t = typename BasicJsonType::number_float_t;
+ using string_t = typename BasicJsonType::string_t;
+ using binary_t = typename BasicJsonType::binary_t;
+ using exception_t = typename BasicJsonType::exception;
+
+ public:
+ static constexpr bool value =
+ is_detected_exact<bool, null_function_t, SAX>::value &&
+ is_detected_exact<bool, boolean_function_t, SAX>::value &&
+ is_detected_exact<bool, number_integer_function_t, SAX, number_integer_t>::value &&
+ is_detected_exact<bool, number_unsigned_function_t, SAX, number_unsigned_t>::value &&
+ is_detected_exact<bool, number_float_function_t, SAX, number_float_t, string_t>::value &&
+ is_detected_exact<bool, string_function_t, SAX, string_t>::value &&
+ is_detected_exact<bool, binary_function_t, SAX, binary_t>::value &&
+ is_detected_exact<bool, start_object_function_t, SAX>::value &&
+ is_detected_exact<bool, key_function_t, SAX, string_t>::value &&
+ is_detected_exact<bool, end_object_function_t, SAX>::value &&
+ is_detected_exact<bool, start_array_function_t, SAX>::value &&
+ is_detected_exact<bool, end_array_function_t, SAX>::value &&
+ is_detected_exact<bool, parse_error_function_t, SAX, exception_t>::value;
+};
+
+template<typename SAX, typename BasicJsonType>
+struct is_sax_static_asserts
+{
+ private:
+ static_assert(is_basic_json<BasicJsonType>::value,
+ "BasicJsonType must be of type basic_json<...>");
+
+ using number_integer_t = typename BasicJsonType::number_integer_t;
+ using number_unsigned_t = typename BasicJsonType::number_unsigned_t;
+ using number_float_t = typename BasicJsonType::number_float_t;
+ using string_t = typename BasicJsonType::string_t;
+ using binary_t = typename BasicJsonType::binary_t;
+ using exception_t = typename BasicJsonType::exception;
+
+ public:
+ static_assert(is_detected_exact<bool, null_function_t, SAX>::value,
+ "Missing/invalid function: bool null()");
+ static_assert(is_detected_exact<bool, boolean_function_t, SAX>::value,
+ "Missing/invalid function: bool boolean(bool)");
+ static_assert(is_detected_exact<bool, boolean_function_t, SAX>::value,
+ "Missing/invalid function: bool boolean(bool)");
+ static_assert(
+ is_detected_exact<bool, number_integer_function_t, SAX,
+ number_integer_t>::value,
+ "Missing/invalid function: bool number_integer(number_integer_t)");
+ static_assert(
+ is_detected_exact<bool, number_unsigned_function_t, SAX,
+ number_unsigned_t>::value,
+ "Missing/invalid function: bool number_unsigned(number_unsigned_t)");
+ static_assert(is_detected_exact<bool, number_float_function_t, SAX,
+ number_float_t, string_t>::value,
+ "Missing/invalid function: bool number_float(number_float_t, const string_t&)");
+ static_assert(
+ is_detected_exact<bool, string_function_t, SAX, string_t>::value,
+ "Missing/invalid function: bool string(string_t&)");
+ static_assert(
+ is_detected_exact<bool, binary_function_t, SAX, binary_t>::value,
+ "Missing/invalid function: bool binary(binary_t&)");
+ static_assert(is_detected_exact<bool, start_object_function_t, SAX>::value,
+ "Missing/invalid function: bool start_object(std::size_t)");
+ static_assert(is_detected_exact<bool, key_function_t, SAX, string_t>::value,
+ "Missing/invalid function: bool key(string_t&)");
+ static_assert(is_detected_exact<bool, end_object_function_t, SAX>::value,
+ "Missing/invalid function: bool end_object()");
+ static_assert(is_detected_exact<bool, start_array_function_t, SAX>::value,
+ "Missing/invalid function: bool start_array(std::size_t)");
+ static_assert(is_detected_exact<bool, end_array_function_t, SAX>::value,
+ "Missing/invalid function: bool end_array()");
+ static_assert(
+ is_detected_exact<bool, parse_error_function_t, SAX, exception_t>::value,
+ "Missing/invalid function: bool parse_error(std::size_t, const "
+ "std::string&, const exception&)");
+};
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/meta/type_traits.hpp>
+
+// #include <nlohmann/detail/value_t.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+
+/// how to treat CBOR tags
+enum class cbor_tag_handler_t
+{
+ error, ///< throw a parse_error exception in case of a tag
+ ignore, ///< ignore tags
+ store ///< store tags as binary type
+};
+
+/*!
+@brief determine system byte order
+
+@return true if and only if system's byte order is little endian
+
+@note from https://stackoverflow.com/a/1001328/266378
+*/
+static inline bool little_endianness(int num = 1) noexcept
+{
+ return *reinterpret_cast<char*>(&num) == 1;
+}
+
+
+///////////////////
+// binary reader //
+///////////////////
+
+/*!
+@brief deserialization of CBOR, MessagePack, and UBJSON values
+*/
+template<typename BasicJsonType, typename InputAdapterType, typename SAX = json_sax_dom_parser<BasicJsonType>>
+class binary_reader
+{
+ using number_integer_t = typename BasicJsonType::number_integer_t;
+ using number_unsigned_t = typename BasicJsonType::number_unsigned_t;
+ using number_float_t = typename BasicJsonType::number_float_t;
+ using string_t = typename BasicJsonType::string_t;
+ using binary_t = typename BasicJsonType::binary_t;
+ using json_sax_t = SAX;
+ using char_type = typename InputAdapterType::char_type;
+ using char_int_type = typename std::char_traits<char_type>::int_type;
+
+ public:
+ /*!
+ @brief create a binary reader
+
+ @param[in] adapter input adapter to read from
+ */
+ explicit binary_reader(InputAdapterType&& adapter) noexcept : ia(std::move(adapter))
+ {
+ (void)detail::is_sax_static_asserts<SAX, BasicJsonType> {};
+ }
+
+ // make class move-only
+ binary_reader(const binary_reader&) = delete;
+ binary_reader(binary_reader&&) = default; // NOLINT(hicpp-noexcept-move,performance-noexcept-move-constructor)
+ binary_reader& operator=(const binary_reader&) = delete;
+ binary_reader& operator=(binary_reader&&) = default; // NOLINT(hicpp-noexcept-move,performance-noexcept-move-constructor)
+ ~binary_reader() = default;
+
+ /*!
+ @param[in] format the binary format to parse
+ @param[in] sax_ a SAX event processor
+ @param[in] strict whether to expect the input to be consumed completed
+ @param[in] tag_handler how to treat CBOR tags
+
+ @return whether parsing was successful
+ */
+ JSON_HEDLEY_NON_NULL(3)
+ bool sax_parse(const input_format_t format,
+ json_sax_t* sax_,
+ const bool strict = true,
+ const cbor_tag_handler_t tag_handler = cbor_tag_handler_t::error)
+ {
+ sax = sax_;
+ bool result = false;
+
+ switch (format)
+ {
+ case input_format_t::bson:
+ result = parse_bson_internal();
+ break;
+
+ case input_format_t::cbor:
+ result = parse_cbor_internal(true, tag_handler);
+ break;
+
+ case input_format_t::msgpack:
+ result = parse_msgpack_internal();
+ break;
+
+ case input_format_t::ubjson:
+ result = parse_ubjson_internal();
+ 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
+ }
+
+ // strict mode: next byte must be EOF
+ if (result && strict)
+ {
+ if (format == input_format_t::ubjson)
+ {
+ get_ignore_noop();
+ }
+ else
+ {
+ get();
+ }
+
+ 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, "expected end of input; last byte: 0x" + get_token_string(), "value"), BasicJsonType()));
+ }
+ }
+
+ return result;
+ }
+
+ private:
+ //////////
+ // BSON //
+ //////////
+
+ /*!
+ @brief Reads in a BSON-object and passes it to the SAX-parser.
+ @return whether a valid BSON-value was passed to the SAX parser
+ */
+ bool parse_bson_internal()
+ {
+ std::int32_t document_size{};
+ get_number<std::int32_t, true>(input_format_t::bson, document_size);
+
+ if (JSON_HEDLEY_UNLIKELY(!sax->start_object(static_cast<std::size_t>(-1))))
+ {
+ return false;
+ }
+
+ if (JSON_HEDLEY_UNLIKELY(!parse_bson_element_list(/*is_array*/false)))
+ {
+ return false;
+ }
+
+ return sax->end_object();
+ }
+
+ /*!
+ @brief Parses a C-style string from the BSON input.
+ @param[in,out] result A reference to the string variable where the read
+ string is to be stored.
+ @return `true` if the \x00-byte indicating the end of the string was
+ encountered before the EOF; false` indicates an unexpected EOF.
+ */
+ bool get_bson_cstr(string_t& result)
+ {
+ auto out = std::back_inserter(result);
+ while (true)
+ {
+ get();
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::bson, "cstring")))
+ {
+ return false;
+ }
+ if (current == 0x00)
+ {
+ return true;
+ }
+ *out++ = static_cast<typename string_t::value_type>(current);
+ }
+ }
+
+ /*!
+ @brief Parses a zero-terminated string of length @a len from the BSON
+ input.
+ @param[in] len The length (including the zero-byte at the end) of the
+ string to be read.
+ @param[in,out] result A reference to the string variable where the read
+ string is to be stored.
+ @tparam NumberType The type of the length @a len
+ @pre len >= 1
+ @return `true` if the string was successfully parsed
+ */
+ template<typename NumberType>
+ bool get_bson_string(const NumberType len, string_t& result)
+ {
+ if (JSON_HEDLEY_UNLIKELY(len < 1))
+ {
+ 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::bson, "string length must be at least 1, is " + std::to_string(len), "string"), BasicJsonType()));
+ }
+
+ return get_string(input_format_t::bson, len - static_cast<NumberType>(1), result) && get() != std::char_traits<char_type>::eof();
+ }
+
+ /*!
+ @brief Parses a byte array input of length @a len from the BSON input.
+ @param[in] len The length of the byte array to be read.
+ @param[in,out] result A reference to the binary variable where the read
+ array is to be stored.
+ @tparam NumberType The type of the length @a len
+ @pre len >= 0
+ @return `true` if the byte array was successfully parsed
+ */
+ template<typename NumberType>
+ bool get_bson_binary(const NumberType len, binary_t& result)
+ {
+ if (JSON_HEDLEY_UNLIKELY(len < 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_t::bson, "byte array length cannot be negative, is " + std::to_string(len), "binary"), BasicJsonType()));
+ }
+
+ // All BSON binary values have a subtype
+ std::uint8_t subtype{};
+ get_number<std::uint8_t>(input_format_t::bson, subtype);
+ result.set_subtype(subtype);
+
+ return get_binary(input_format_t::bson, len, result);
+ }
+
+ /*!
+ @brief Read a BSON document element of the given @a element_type.
+ @param[in] element_type The BSON element type, c.f. http://bsonspec.org/spec.html
+ @param[in] element_type_parse_position The position in the input stream,
+ where the `element_type` was read.
+ @warning Not all BSON element types are supported yet. An unsupported
+ @a element_type will give rise to a parse_error.114:
+ Unsupported BSON record type 0x...
+ @return whether a valid BSON-object/array was passed to the SAX parser
+ */
+ bool parse_bson_element_internal(const char_int_type element_type,
+ const std::size_t element_type_parse_position)
+ {
+ switch (element_type)
+ {
+ case 0x01: // double
+ {
+ double number{};
+ return get_number<double, true>(input_format_t::bson, number) && sax->number_float(static_cast<number_float_t>(number), "");
+ }
+
+ case 0x02: // string
+ {
+ std::int32_t len{};
+ string_t value;
+ return get_number<std::int32_t, true>(input_format_t::bson, len) && get_bson_string(len, value) && sax->string(value);
+ }
+
+ case 0x03: // object
+ {
+ return parse_bson_internal();
+ }
+
+ case 0x04: // array
+ {
+ return parse_bson_array();
+ }
+
+ case 0x05: // binary
+ {
+ std::int32_t len{};
+ binary_t value;
+ return get_number<std::int32_t, true>(input_format_t::bson, len) && get_bson_binary(len, value) && sax->binary(value);
+ }
+
+ case 0x08: // boolean
+ {
+ return sax->boolean(get() != 0);
+ }
+
+ case 0x0A: // null
+ {
+ return sax->null();
+ }
+
+ case 0x10: // int32
+ {
+ std::int32_t value{};
+ return get_number<std::int32_t, true>(input_format_t::bson, value) && sax->number_integer(value);
+ }
+
+ case 0x12: // int64
+ {
+ std::int64_t value{};
+ return get_number<std::int64_t, true>(input_format_t::bson, value) && sax->number_integer(value);
+ }
+
+ default: // anything else not supported (yet)
+ {
+ std::array<char, 3> cr{{}};
+ static_cast<void>((std::snprintf)(cr.data(), cr.size(), "%.2hhX", static_cast<unsigned char>(element_type))); // NOLINT(cppcoreguidelines-pro-type-vararg,hicpp-vararg)
+ return sax->parse_error(element_type_parse_position, std::string(cr.data()), parse_error::create(114, element_type_parse_position, "Unsupported BSON record type 0x" + std::string(cr.data()), BasicJsonType()));
+ }
+ }
+ }
+
+ /*!
+ @brief Read a BSON element list (as specified in the BSON-spec)
+
+ The same binary layout is used for objects and arrays, hence it must be
+ indicated with the argument @a is_array which one is expected
+ (true --> array, false --> object).
+
+ @param[in] is_array Determines if the element list being read is to be
+ treated as an object (@a is_array == false), or as an
+ array (@a is_array == true).
+ @return whether a valid BSON-object/array was passed to the SAX parser
+ */
+ bool parse_bson_element_list(const bool is_array)
+ {
+ string_t key;
+
+ while (auto element_type = get())
+ {
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::bson, "element list")))
+ {
+ return false;
+ }
+
+ const std::size_t element_type_parse_position = chars_read;
+ if (JSON_HEDLEY_UNLIKELY(!get_bson_cstr(key)))
+ {
+ return false;
+ }
+
+ if (!is_array && !sax->key(key))
+ {
+ return false;
+ }
+
+ if (JSON_HEDLEY_UNLIKELY(!parse_bson_element_internal(element_type, element_type_parse_position)))
+ {
+ return false;
+ }
+
+ // get_bson_cstr only appends
+ key.clear();
+ }
+
+ return true;
+ }
+
+ /*!
+ @brief Reads an array from the BSON input and passes it to the SAX-parser.
+ @return whether a valid BSON-array was passed to the SAX parser
+ */
+ bool parse_bson_array()
+ {
+ std::int32_t document_size{};
+ get_number<std::int32_t, true>(input_format_t::bson, document_size);
+
+ if (JSON_HEDLEY_UNLIKELY(!sax->start_array(static_cast<std::size_t>(-1))))
+ {
+ return false;
+ }
+
+ if (JSON_HEDLEY_UNLIKELY(!parse_bson_element_list(/*is_array*/true)))
+ {
+ return false;
+ }
+
+ return sax->end_array();
+ }
+
+ //////////
+ // CBOR //
+ //////////
+
+ /*!
+ @param[in] get_char whether a new character should be retrieved from the
+ input (true) or whether the last read character should
+ be considered instead (false)
+ @param[in] tag_handler how CBOR tags should be treated
+
+ @return whether a valid CBOR value was passed to the SAX parser
+ */
+ bool parse_cbor_internal(const bool get_char,
+ const cbor_tag_handler_t tag_handler)
+ {
+ switch (get_char ? get() : current)
+ {
+ // EOF
+ case std::char_traits<char_type>::eof():
+ return unexpect_eof(input_format_t::cbor, "value");
+
+ // Integer 0x00..0x17 (0..23)
+ case 0x00:
+ case 0x01:
+ case 0x02:
+ case 0x03:
+ case 0x04:
+ case 0x05:
+ case 0x06:
+ case 0x07:
+ case 0x08:
+ case 0x09:
+ case 0x0A:
+ case 0x0B:
+ case 0x0C:
+ case 0x0D:
+ case 0x0E:
+ case 0x0F:
+ case 0x10:
+ case 0x11:
+ case 0x12:
+ case 0x13:
+ case 0x14:
+ case 0x15:
+ case 0x16:
+ case 0x17:
+ return sax->number_unsigned(static_cast<number_unsigned_t>(current));
+
+ case 0x18: // Unsigned integer (one-byte uint8_t follows)
+ {
+ std::uint8_t number{};
+ return get_number(input_format_t::cbor, number) && sax->number_unsigned(number);
+ }
+
+ case 0x19: // Unsigned integer (two-byte uint16_t follows)
+ {
+ std::uint16_t number{};
+ return get_number(input_format_t::cbor, number) && sax->number_unsigned(number);
+ }
+
+ case 0x1A: // Unsigned integer (four-byte uint32_t follows)
+ {
+ std::uint32_t number{};
+ return get_number(input_format_t::cbor, number) && sax->number_unsigned(number);
+ }
+
+ case 0x1B: // Unsigned integer (eight-byte uint64_t follows)
+ {
+ std::uint64_t number{};
+ return get_number(input_format_t::cbor, number) && sax->number_unsigned(number);
+ }
+
+ // Negative integer -1-0x00..-1-0x17 (-1..-24)
+ case 0x20:
+ case 0x21:
+ case 0x22:
+ case 0x23:
+ case 0x24:
+ case 0x25:
+ case 0x26:
+ case 0x27:
+ case 0x28:
+ case 0x29:
+ case 0x2A:
+ case 0x2B:
+ case 0x2C:
+ case 0x2D:
+ case 0x2E:
+ case 0x2F:
+ case 0x30:
+ case 0x31:
+ case 0x32:
+ case 0x33:
+ case 0x34:
+ case 0x35:
+ case 0x36:
+ case 0x37:
+ return sax->number_integer(static_cast<std::int8_t>(0x20 - 1 - current));
+
+ case 0x38: // Negative integer (one-byte uint8_t follows)
+ {
+ std::uint8_t number{};
+ return get_number(input_format_t::cbor, number) && sax->number_integer(static_cast<number_integer_t>(-1) - number);
+ }
+
+ case 0x39: // Negative integer -1-n (two-byte uint16_t follows)
+ {
+ std::uint16_t number{};
+ return get_number(input_format_t::cbor, number) && sax->number_integer(static_cast<number_integer_t>(-1) - number);
+ }
+
+ case 0x3A: // Negative integer -1-n (four-byte uint32_t follows)
+ {
+ std::uint32_t number{};
+ return get_number(input_format_t::cbor, number) && sax->number_integer(static_cast<number_integer_t>(-1) - number);
+ }
+
+ case 0x3B: // Negative integer -1-n (eight-byte uint64_t follows)
+ {
+ std::uint64_t number{};
+ return get_number(input_format_t::cbor, number) && sax->number_integer(static_cast<number_integer_t>(-1)
+ - static_cast<number_integer_t>(number));
+ }
+
+ // Binary data (0x00..0x17 bytes follow)
+ case 0x40:
+ case 0x41:
+ case 0x42:
+ case 0x43:
+ case 0x44:
+ case 0x45:
+ case 0x46:
+ case 0x47:
+ case 0x48:
+ case 0x49:
+ case 0x4A:
+ case 0x4B:
+ case 0x4C:
+ case 0x4D:
+ case 0x4E:
+ case 0x4F:
+ case 0x50:
+ case 0x51:
+ case 0x52:
+ case 0x53:
+ case 0x54:
+ case 0x55:
+ case 0x56:
+ case 0x57:
+ case 0x58: // Binary data (one-byte uint8_t for n follows)
+ case 0x59: // Binary data (two-byte uint16_t for n follow)
+ case 0x5A: // Binary data (four-byte uint32_t for n follow)
+ case 0x5B: // Binary data (eight-byte uint64_t for n follow)
+ case 0x5F: // Binary data (indefinite length)
+ {
+ binary_t b;
+ return get_cbor_binary(b) && sax->binary(b);
+ }
+
+ // UTF-8 string (0x00..0x17 bytes follow)
+ case 0x60:
+ case 0x61:
+ case 0x62:
+ case 0x63:
+ case 0x64:
+ case 0x65:
+ case 0x66:
+ case 0x67:
+ case 0x68:
+ case 0x69:
+ case 0x6A:
+ case 0x6B:
+ case 0x6C:
+ case 0x6D:
+ case 0x6E:
+ case 0x6F:
+ case 0x70:
+ case 0x71:
+ case 0x72:
+ case 0x73:
+ case 0x74:
+ case 0x75:
+ case 0x76:
+ case 0x77:
+ case 0x78: // UTF-8 string (one-byte uint8_t for n follows)
+ case 0x79: // UTF-8 string (two-byte uint16_t for n follow)
+ case 0x7A: // UTF-8 string (four-byte uint32_t for n follow)
+ case 0x7B: // UTF-8 string (eight-byte uint64_t for n follow)
+ case 0x7F: // UTF-8 string (indefinite length)
+ {
+ string_t s;
+ return get_cbor_string(s) && sax->string(s);
+ }
+
+ // array (0x00..0x17 data items follow)
+ case 0x80:
+ case 0x81:
+ case 0x82:
+ case 0x83:
+ case 0x84:
+ case 0x85:
+ case 0x86:
+ case 0x87:
+ case 0x88:
+ case 0x89:
+ case 0x8A:
+ case 0x8B:
+ case 0x8C:
+ case 0x8D:
+ case 0x8E:
+ case 0x8F:
+ case 0x90:
+ case 0x91:
+ case 0x92:
+ case 0x93:
+ case 0x94:
+ case 0x95:
+ case 0x96:
+ case 0x97:
+ return get_cbor_array(static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x1Fu), tag_handler);
+
+ case 0x98: // array (one-byte uint8_t for n follows)
+ {
+ std::uint8_t len{};
+ return get_number(input_format_t::cbor, len) && get_cbor_array(static_cast<std::size_t>(len), tag_handler);
+ }
+
+ case 0x99: // array (two-byte uint16_t for n follow)
+ {
+ std::uint16_t len{};
+ return get_number(input_format_t::cbor, len) && get_cbor_array(static_cast<std::size_t>(len), tag_handler);
+ }
+
+ 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);
+ }
+
+ 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);
+ }
+
+ case 0x9F: // array (indefinite length)
+ return get_cbor_array(static_cast<std::size_t>(-1), tag_handler);
+
+ // map (0x00..0x17 pairs of data items follow)
+ case 0xA0:
+ case 0xA1:
+ case 0xA2:
+ case 0xA3:
+ case 0xA4:
+ case 0xA5:
+ case 0xA6:
+ case 0xA7:
+ case 0xA8:
+ case 0xA9:
+ case 0xAA:
+ case 0xAB:
+ case 0xAC:
+ case 0xAD:
+ case 0xAE:
+ case 0xAF:
+ case 0xB0:
+ case 0xB1:
+ case 0xB2:
+ case 0xB3:
+ case 0xB4:
+ case 0xB5:
+ case 0xB6:
+ case 0xB7:
+ return get_cbor_object(static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x1Fu), tag_handler);
+
+ case 0xB8: // map (one-byte uint8_t for n follows)
+ {
+ std::uint8_t len{};
+ return get_number(input_format_t::cbor, len) && get_cbor_object(static_cast<std::size_t>(len), tag_handler);
+ }
+
+ case 0xB9: // map (two-byte uint16_t for n follow)
+ {
+ std::uint16_t len{};
+ return get_number(input_format_t::cbor, len) && get_cbor_object(static_cast<std::size_t>(len), tag_handler);
+ }
+
+ 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);
+ }
+
+ 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);
+ }
+
+ case 0xBF: // map (indefinite length)
+ return get_cbor_object(static_cast<std::size_t>(-1), tag_handler);
+
+ case 0xC6: // tagged item
+ case 0xC7:
+ case 0xC8:
+ case 0xC9:
+ case 0xCA:
+ case 0xCB:
+ case 0xCC:
+ case 0xCD:
+ case 0xCE:
+ case 0xCF:
+ case 0xD0:
+ case 0xD1:
+ case 0xD2:
+ case 0xD3:
+ case 0xD4:
+ case 0xD8: // tagged item (1 bytes follow)
+ case 0xD9: // tagged item (2 bytes follow)
+ case 0xDA: // tagged item (4 bytes follow)
+ case 0xDB: // tagged item (8 bytes follow)
+ {
+ switch (tag_handler)
+ {
+ case cbor_tag_handler_t::error:
+ {
+ 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::cbor, "invalid byte: 0x" + last_token, "value"), BasicJsonType()));
+ }
+
+ case cbor_tag_handler_t::ignore:
+ {
+ // ignore binary subtype
+ switch (current)
+ {
+ case 0xD8:
+ {
+ std::uint8_t subtype_to_ignore{};
+ get_number(input_format_t::cbor, subtype_to_ignore);
+ break;
+ }
+ case 0xD9:
+ {
+ std::uint16_t subtype_to_ignore{};
+ get_number(input_format_t::cbor, subtype_to_ignore);
+ break;
+ }
+ case 0xDA:
+ {
+ std::uint32_t subtype_to_ignore{};
+ get_number(input_format_t::cbor, subtype_to_ignore);
+ break;
+ }
+ case 0xDB:
+ {
+ std::uint64_t subtype_to_ignore{};
+ get_number(input_format_t::cbor, subtype_to_ignore);
+ break;
+ }
+ default:
+ break;
+ }
+ return parse_cbor_internal(true, tag_handler);
+ }
+
+ case cbor_tag_handler_t::store:
+ {
+ binary_t b;
+ // use binary subtype and store in binary container
+ switch (current)
+ {
+ case 0xD8:
+ {
+ std::uint8_t subtype{};
+ get_number(input_format_t::cbor, subtype);
+ b.set_subtype(detail::conditional_static_cast<typename binary_t::subtype_type>(subtype));
+ break;
+ }
+ case 0xD9:
+ {
+ std::uint16_t subtype{};
+ get_number(input_format_t::cbor, subtype);
+ b.set_subtype(detail::conditional_static_cast<typename binary_t::subtype_type>(subtype));
+ break;
+ }
+ case 0xDA:
+ {
+ std::uint32_t subtype{};
+ get_number(input_format_t::cbor, subtype);
+ b.set_subtype(detail::conditional_static_cast<typename binary_t::subtype_type>(subtype));
+ break;
+ }
+ case 0xDB:
+ {
+ std::uint64_t subtype{};
+ get_number(input_format_t::cbor, subtype);
+ b.set_subtype(detail::conditional_static_cast<typename binary_t::subtype_type>(subtype));
+ break;
+ }
+ default:
+ return parse_cbor_internal(true, tag_handler);
+ }
+ get();
+ return get_cbor_binary(b) && sax->binary(b);
+ }
+
+ default: // LCOV_EXCL_LINE
+ JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert) LCOV_EXCL_LINE
+ return false; // LCOV_EXCL_LINE
+ }
+ }
+
+ case 0xF4: // false
+ return sax->boolean(false);
+
+ case 0xF5: // true
+ return sax->boolean(true);
+
+ case 0xF6: // null
+ return sax->null();
+
+ case 0xF9: // Half-Precision Float (two-byte IEEE 754)
+ {
+ const auto byte1_raw = get();
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::cbor, "number")))
+ {
+ return false;
+ }
+ const auto byte2_raw = get();
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::cbor, "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>((byte1 << 8u) + byte2);
+ 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 0xFA: // Single-Precision Float (four-byte IEEE 754)
+ {
+ float number{};
+ return get_number(input_format_t::cbor, number) && sax->number_float(static_cast<number_float_t>(number), "");
+ }
+
+ case 0xFB: // Double-Precision Float (eight-byte IEEE 754)
+ {
+ double number{};
+ return get_number(input_format_t::cbor, number) && sax->number_float(static_cast<number_float_t>(number), "");
+ }
+
+ default: // anything else (0xFF is handled inside the other types)
+ {
+ 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::cbor, "invalid byte: 0x" + last_token, "value"), BasicJsonType()));
+ }
+ }
+ }
+
+ /*!
+ @brief reads a CBOR string
+
+ This function first reads starting bytes to determine the expected
+ string length and then copies this number of bytes into a string.
+ Additionally, CBOR's strings with indefinite lengths are supported.
+
+ @param[out] result created string
+
+ @return whether string creation completed
+ */
+ bool get_cbor_string(string_t& result)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::cbor, "string")))
+ {
+ return false;
+ }
+
+ switch (current)
+ {
+ // UTF-8 string (0x00..0x17 bytes follow)
+ case 0x60:
+ case 0x61:
+ case 0x62:
+ case 0x63:
+ case 0x64:
+ case 0x65:
+ case 0x66:
+ case 0x67:
+ case 0x68:
+ case 0x69:
+ case 0x6A:
+ case 0x6B:
+ case 0x6C:
+ case 0x6D:
+ case 0x6E:
+ case 0x6F:
+ case 0x70:
+ case 0x71:
+ case 0x72:
+ case 0x73:
+ case 0x74:
+ case 0x75:
+ case 0x76:
+ case 0x77:
+ {
+ return get_string(input_format_t::cbor, static_cast<unsigned int>(current) & 0x1Fu, result);
+ }
+
+ case 0x78: // UTF-8 string (one-byte uint8_t for n follows)
+ {
+ std::uint8_t len{};
+ return get_number(input_format_t::cbor, len) && get_string(input_format_t::cbor, len, result);
+ }
+
+ case 0x79: // UTF-8 string (two-byte uint16_t for n follow)
+ {
+ std::uint16_t len{};
+ return get_number(input_format_t::cbor, len) && get_string(input_format_t::cbor, len, result);
+ }
+
+ case 0x7A: // UTF-8 string (four-byte uint32_t for n follow)
+ {
+ std::uint32_t len{};
+ return get_number(input_format_t::cbor, len) && get_string(input_format_t::cbor, len, result);
+ }
+
+ case 0x7B: // UTF-8 string (eight-byte uint64_t for n follow)
+ {
+ std::uint64_t len{};
+ return get_number(input_format_t::cbor, len) && get_string(input_format_t::cbor, len, result);
+ }
+
+ case 0x7F: // UTF-8 string (indefinite length)
+ {
+ while (get() != 0xFF)
+ {
+ string_t chunk;
+ if (!get_cbor_string(chunk))
+ {
+ return false;
+ }
+ result.append(chunk);
+ }
+ return true;
+ }
+
+ 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::cbor, "expected length specification (0x60-0x7B) or indefinite string type (0x7F); last byte: 0x" + last_token, "string"), BasicJsonType()));
+ }
+ }
+ }
+
+ /*!
+ @brief reads a CBOR byte array
+
+ This function first reads starting bytes to determine the expected
+ byte array length and then copies this number of bytes into the byte array.
+ Additionally, CBOR's byte arrays with indefinite lengths are supported.
+
+ @param[out] result created byte array
+
+ @return whether byte array creation completed
+ */
+ bool get_cbor_binary(binary_t& result)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::cbor, "binary")))
+ {
+ return false;
+ }
+
+ switch (current)
+ {
+ // Binary data (0x00..0x17 bytes follow)
+ case 0x40:
+ case 0x41:
+ case 0x42:
+ case 0x43:
+ case 0x44:
+ case 0x45:
+ case 0x46:
+ case 0x47:
+ case 0x48:
+ case 0x49:
+ case 0x4A:
+ case 0x4B:
+ case 0x4C:
+ case 0x4D:
+ case 0x4E:
+ case 0x4F:
+ case 0x50:
+ case 0x51:
+ case 0x52:
+ case 0x53:
+ case 0x54:
+ case 0x55:
+ case 0x56:
+ case 0x57:
+ {
+ return get_binary(input_format_t::cbor, static_cast<unsigned int>(current) & 0x1Fu, result);
+ }
+
+ case 0x58: // Binary data (one-byte uint8_t for n follows)
+ {
+ std::uint8_t len{};
+ return get_number(input_format_t::cbor, len) &&
+ get_binary(input_format_t::cbor, len, result);
+ }
+
+ case 0x59: // Binary data (two-byte uint16_t for n follow)
+ {
+ std::uint16_t len{};
+ return get_number(input_format_t::cbor, len) &&
+ get_binary(input_format_t::cbor, len, result);
+ }
+
+ case 0x5A: // Binary data (four-byte uint32_t for n follow)
+ {
+ std::uint32_t len{};
+ return get_number(input_format_t::cbor, len) &&
+ get_binary(input_format_t::cbor, len, result);
+ }
+
+ case 0x5B: // Binary data (eight-byte uint64_t for n follow)
+ {
+ std::uint64_t len{};
+ return get_number(input_format_t::cbor, len) &&
+ get_binary(input_format_t::cbor, len, result);
+ }
+
+ case 0x5F: // Binary data (indefinite length)
+ {
+ while (get() != 0xFF)
+ {
+ binary_t chunk;
+ if (!get_cbor_binary(chunk))
+ {
+ return false;
+ }
+ result.insert(result.end(), chunk.begin(), chunk.end());
+ }
+ return true;
+ }
+
+ 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::cbor, "expected length specification (0x40-0x5B) or indefinite binary array type (0x5F); last byte: 0x" + last_token, "binary"), BasicJsonType()));
+ }
+ }
+ }
+
+ /*!
+ @param[in] len the length of the array or static_cast<std::size_t>(-1) for an
+ array of indefinite size
+ @param[in] tag_handler how CBOR tags should be treated
+ @return whether array creation completed
+ */
+ bool get_cbor_array(const std::size_t len,
+ const cbor_tag_handler_t tag_handler)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->start_array(len)))
+ {
+ return false;
+ }
+
+ if (len != static_cast<std::size_t>(-1))
+ {
+ for (std::size_t i = 0; i < len; ++i)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!parse_cbor_internal(true, tag_handler)))
+ {
+ return false;
+ }
+ }
+ }
+ else
+ {
+ while (get() != 0xFF)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!parse_cbor_internal(false, tag_handler)))
+ {
+ return false;
+ }
+ }
+ }
+
+ return sax->end_array();
+ }
+
+ /*!
+ @param[in] len the length of the object or static_cast<std::size_t>(-1) for an
+ object of indefinite size
+ @param[in] tag_handler how CBOR tags should be treated
+ @return whether object creation completed
+ */
+ bool get_cbor_object(const std::size_t len,
+ const cbor_tag_handler_t tag_handler)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->start_object(len)))
+ {
+ return false;
+ }
+
+ if (len != 0)
+ {
+ string_t key;
+ if (len != static_cast<std::size_t>(-1))
+ {
+ for (std::size_t i = 0; i < len; ++i)
+ {
+ get();
+ if (JSON_HEDLEY_UNLIKELY(!get_cbor_string(key) || !sax->key(key)))
+ {
+ return false;
+ }
+
+ if (JSON_HEDLEY_UNLIKELY(!parse_cbor_internal(true, tag_handler)))
+ {
+ return false;
+ }
+ key.clear();
+ }
+ }
+ else
+ {
+ while (get() != 0xFF)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!get_cbor_string(key) || !sax->key(key)))
+ {
+ return false;
+ }
+
+ if (JSON_HEDLEY_UNLIKELY(!parse_cbor_internal(true, tag_handler)))
+ {
+ return false;
+ }
+ key.clear();
+ }
+ }
+ }
+
+ return sax->end_object();
+ }
+
+ /////////////
+ // MsgPack //
+ /////////////
+
+ /*!
+ @return whether a valid MessagePack value was passed to the SAX parser
+ */
+ bool parse_msgpack_internal()
+ {
+ switch (get())
+ {
+ // EOF
+ case std::char_traits<char_type>::eof():
+ return unexpect_eof(input_format_t::msgpack, "value");
+
+ // positive fixint
+ case 0x00:
+ case 0x01:
+ case 0x02:
+ case 0x03:
+ case 0x04:
+ case 0x05:
+ case 0x06:
+ case 0x07:
+ case 0x08:
+ case 0x09:
+ case 0x0A:
+ case 0x0B:
+ case 0x0C:
+ case 0x0D:
+ case 0x0E:
+ case 0x0F:
+ case 0x10:
+ case 0x11:
+ case 0x12:
+ case 0x13:
+ case 0x14:
+ case 0x15:
+ case 0x16:
+ case 0x17:
+ case 0x18:
+ case 0x19:
+ case 0x1A:
+ case 0x1B:
+ case 0x1C:
+ case 0x1D:
+ case 0x1E:
+ case 0x1F:
+ case 0x20:
+ case 0x21:
+ case 0x22:
+ case 0x23:
+ case 0x24:
+ case 0x25:
+ case 0x26:
+ case 0x27:
+ case 0x28:
+ case 0x29:
+ case 0x2A:
+ case 0x2B:
+ case 0x2C:
+ case 0x2D:
+ case 0x2E:
+ case 0x2F:
+ case 0x30:
+ case 0x31:
+ case 0x32:
+ case 0x33:
+ case 0x34:
+ case 0x35:
+ case 0x36:
+ case 0x37:
+ case 0x38:
+ case 0x39:
+ case 0x3A:
+ case 0x3B:
+ case 0x3C:
+ case 0x3D:
+ case 0x3E:
+ case 0x3F:
+ case 0x40:
+ case 0x41:
+ case 0x42:
+ case 0x43:
+ case 0x44:
+ case 0x45:
+ case 0x46:
+ case 0x47:
+ case 0x48:
+ case 0x49:
+ case 0x4A:
+ case 0x4B:
+ case 0x4C:
+ case 0x4D:
+ case 0x4E:
+ case 0x4F:
+ case 0x50:
+ case 0x51:
+ case 0x52:
+ case 0x53:
+ case 0x54:
+ case 0x55:
+ case 0x56:
+ case 0x57:
+ case 0x58:
+ case 0x59:
+ case 0x5A:
+ case 0x5B:
+ case 0x5C:
+ case 0x5D:
+ case 0x5E:
+ case 0x5F:
+ case 0x60:
+ case 0x61:
+ case 0x62:
+ case 0x63:
+ case 0x64:
+ case 0x65:
+ case 0x66:
+ case 0x67:
+ case 0x68:
+ case 0x69:
+ case 0x6A:
+ case 0x6B:
+ case 0x6C:
+ case 0x6D:
+ case 0x6E:
+ case 0x6F:
+ case 0x70:
+ case 0x71:
+ case 0x72:
+ case 0x73:
+ case 0x74:
+ case 0x75:
+ case 0x76:
+ case 0x77:
+ case 0x78:
+ case 0x79:
+ case 0x7A:
+ case 0x7B:
+ case 0x7C:
+ case 0x7D:
+ case 0x7E:
+ case 0x7F:
+ return sax->number_unsigned(static_cast<number_unsigned_t>(current));
+
+ // fixmap
+ case 0x80:
+ case 0x81:
+ case 0x82:
+ case 0x83:
+ case 0x84:
+ case 0x85:
+ case 0x86:
+ case 0x87:
+ case 0x88:
+ case 0x89:
+ case 0x8A:
+ case 0x8B:
+ case 0x8C:
+ case 0x8D:
+ case 0x8E:
+ case 0x8F:
+ return get_msgpack_object(static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x0Fu));
+
+ // fixarray
+ case 0x90:
+ case 0x91:
+ case 0x92:
+ case 0x93:
+ case 0x94:
+ case 0x95:
+ case 0x96:
+ case 0x97:
+ case 0x98:
+ case 0x99:
+ case 0x9A:
+ case 0x9B:
+ case 0x9C:
+ case 0x9D:
+ case 0x9E:
+ case 0x9F:
+ return get_msgpack_array(static_cast<std::size_t>(static_cast<unsigned int>(current) & 0x0Fu));
+
+ // fixstr
+ case 0xA0:
+ case 0xA1:
+ case 0xA2:
+ case 0xA3:
+ case 0xA4:
+ case 0xA5:
+ case 0xA6:
+ case 0xA7:
+ case 0xA8:
+ case 0xA9:
+ case 0xAA:
+ case 0xAB:
+ case 0xAC:
+ case 0xAD:
+ case 0xAE:
+ case 0xAF:
+ case 0xB0:
+ case 0xB1:
+ case 0xB2:
+ case 0xB3:
+ case 0xB4:
+ case 0xB5:
+ case 0xB6:
+ case 0xB7:
+ case 0xB8:
+ case 0xB9:
+ case 0xBA:
+ case 0xBB:
+ case 0xBC:
+ case 0xBD:
+ case 0xBE:
+ case 0xBF:
+ case 0xD9: // str 8
+ case 0xDA: // str 16
+ case 0xDB: // str 32
+ {
+ string_t s;
+ return get_msgpack_string(s) && sax->string(s);
+ }
+
+ case 0xC0: // nil
+ return sax->null();
+
+ case 0xC2: // false
+ return sax->boolean(false);
+
+ case 0xC3: // true
+ return sax->boolean(true);
+
+ case 0xC4: // bin 8
+ case 0xC5: // bin 16
+ case 0xC6: // bin 32
+ case 0xC7: // ext 8
+ case 0xC8: // ext 16
+ case 0xC9: // ext 32
+ case 0xD4: // fixext 1
+ case 0xD5: // fixext 2
+ case 0xD6: // fixext 4
+ case 0xD7: // fixext 8
+ case 0xD8: // fixext 16
+ {
+ binary_t b;
+ return get_msgpack_binary(b) && sax->binary(b);
+ }
+
+ case 0xCA: // float 32
+ {
+ float number{};
+ return get_number(input_format_t::msgpack, number) && sax->number_float(static_cast<number_float_t>(number), "");
+ }
+
+ case 0xCB: // float 64
+ {
+ double number{};
+ return get_number(input_format_t::msgpack, number) && sax->number_float(static_cast<number_float_t>(number), "");
+ }
+
+ case 0xCC: // uint 8
+ {
+ std::uint8_t number{};
+ return get_number(input_format_t::msgpack, number) && sax->number_unsigned(number);
+ }
+
+ case 0xCD: // uint 16
+ {
+ std::uint16_t number{};
+ return get_number(input_format_t::msgpack, number) && sax->number_unsigned(number);
+ }
+
+ case 0xCE: // uint 32
+ {
+ std::uint32_t number{};
+ return get_number(input_format_t::msgpack, number) && sax->number_unsigned(number);
+ }
+
+ case 0xCF: // uint 64
+ {
+ std::uint64_t number{};
+ return get_number(input_format_t::msgpack, number) && sax->number_unsigned(number);
+ }
+
+ case 0xD0: // int 8
+ {
+ std::int8_t number{};
+ return get_number(input_format_t::msgpack, number) && sax->number_integer(number);
+ }
+
+ case 0xD1: // int 16
+ {
+ std::int16_t number{};
+ return get_number(input_format_t::msgpack, number) && sax->number_integer(number);
+ }
+
+ case 0xD2: // int 32
+ {
+ std::int32_t number{};
+ return get_number(input_format_t::msgpack, number) && sax->number_integer(number);
+ }
+
+ case 0xD3: // int 64
+ {
+ std::int64_t number{};
+ return get_number(input_format_t::msgpack, number) && sax->number_integer(number);
+ }
+
+ case 0xDC: // array 16
+ {
+ std::uint16_t len{};
+ return get_number(input_format_t::msgpack, len) && get_msgpack_array(static_cast<std::size_t>(len));
+ }
+
+ 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));
+ }
+
+ case 0xDE: // map 16
+ {
+ std::uint16_t len{};
+ return get_number(input_format_t::msgpack, len) && get_msgpack_object(static_cast<std::size_t>(len));
+ }
+
+ 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));
+ }
+
+ // negative fixint
+ case 0xE0:
+ case 0xE1:
+ case 0xE2:
+ case 0xE3:
+ case 0xE4:
+ case 0xE5:
+ case 0xE6:
+ case 0xE7:
+ case 0xE8:
+ case 0xE9:
+ case 0xEA:
+ case 0xEB:
+ case 0xEC:
+ case 0xED:
+ case 0xEE:
+ case 0xEF:
+ case 0xF0:
+ case 0xF1:
+ case 0xF2:
+ case 0xF3:
+ case 0xF4:
+ case 0xF5:
+ case 0xF6:
+ case 0xF7:
+ case 0xF8:
+ case 0xF9:
+ case 0xFA:
+ case 0xFB:
+ case 0xFC:
+ case 0xFD:
+ case 0xFE:
+ case 0xFF:
+ return sax->number_integer(static_cast<std::int8_t>(current));
+
+ 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::msgpack, "invalid byte: 0x" + last_token, "value"), BasicJsonType()));
+ }
+ }
+ }
+
+ /*!
+ @brief reads a MessagePack string
+
+ This function first reads starting bytes to determine the expected
+ string length and then copies this number of bytes into a string.
+
+ @param[out] result created string
+
+ @return whether string creation completed
+ */
+ bool get_msgpack_string(string_t& result)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::msgpack, "string")))
+ {
+ return false;
+ }
+
+ switch (current)
+ {
+ // fixstr
+ case 0xA0:
+ case 0xA1:
+ case 0xA2:
+ case 0xA3:
+ case 0xA4:
+ case 0xA5:
+ case 0xA6:
+ case 0xA7:
+ case 0xA8:
+ case 0xA9:
+ case 0xAA:
+ case 0xAB:
+ case 0xAC:
+ case 0xAD:
+ case 0xAE:
+ case 0xAF:
+ case 0xB0:
+ case 0xB1:
+ case 0xB2:
+ case 0xB3:
+ case 0xB4:
+ case 0xB5:
+ case 0xB6:
+ case 0xB7:
+ case 0xB8:
+ case 0xB9:
+ case 0xBA:
+ case 0xBB:
+ case 0xBC:
+ case 0xBD:
+ case 0xBE:
+ case 0xBF:
+ {
+ return get_string(input_format_t::msgpack, static_cast<unsigned int>(current) & 0x1Fu, result);
+ }
+
+ case 0xD9: // str 8
+ {
+ std::uint8_t len{};
+ return get_number(input_format_t::msgpack, len) && get_string(input_format_t::msgpack, len, result);
+ }
+
+ case 0xDA: // str 16
+ {
+ std::uint16_t len{};
+ return get_number(input_format_t::msgpack, len) && get_string(input_format_t::msgpack, len, result);
+ }
+
+ case 0xDB: // str 32
+ {
+ std::uint32_t len{};
+ return get_number(input_format_t::msgpack, len) && get_string(input_format_t::msgpack, 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::msgpack, "expected length specification (0xA0-0xBF, 0xD9-0xDB); last byte: 0x" + last_token, "string"), BasicJsonType()));
+ }
+ }
+ }
+
+ /*!
+ @brief reads a MessagePack byte array
+
+ This function first reads starting bytes to determine the expected
+ byte array length and then copies this number of bytes into a byte array.
+
+ @param[out] result created byte array
+
+ @return whether byte array creation completed
+ */
+ bool get_msgpack_binary(binary_t& result)
+ {
+ // helper function to set the subtype
+ auto assign_and_return_true = [&result](std::int8_t subtype)
+ {
+ result.set_subtype(static_cast<std::uint8_t>(subtype));
+ return true;
+ };
+
+ switch (current)
+ {
+ case 0xC4: // bin 8
+ {
+ std::uint8_t len{};
+ return get_number(input_format_t::msgpack, len) &&
+ get_binary(input_format_t::msgpack, len, result);
+ }
+
+ case 0xC5: // bin 16
+ {
+ std::uint16_t len{};
+ return get_number(input_format_t::msgpack, len) &&
+ get_binary(input_format_t::msgpack, len, result);
+ }
+
+ case 0xC6: // bin 32
+ {
+ std::uint32_t len{};
+ return get_number(input_format_t::msgpack, len) &&
+ get_binary(input_format_t::msgpack, len, result);
+ }
+
+ case 0xC7: // ext 8
+ {
+ std::uint8_t len{};
+ std::int8_t subtype{};
+ return get_number(input_format_t::msgpack, len) &&
+ get_number(input_format_t::msgpack, subtype) &&
+ get_binary(input_format_t::msgpack, len, result) &&
+ assign_and_return_true(subtype);
+ }
+
+ case 0xC8: // ext 16
+ {
+ std::uint16_t len{};
+ std::int8_t subtype{};
+ return get_number(input_format_t::msgpack, len) &&
+ get_number(input_format_t::msgpack, subtype) &&
+ get_binary(input_format_t::msgpack, len, result) &&
+ assign_and_return_true(subtype);
+ }
+
+ case 0xC9: // ext 32
+ {
+ std::uint32_t len{};
+ std::int8_t subtype{};
+ return get_number(input_format_t::msgpack, len) &&
+ get_number(input_format_t::msgpack, subtype) &&
+ get_binary(input_format_t::msgpack, len, result) &&
+ assign_and_return_true(subtype);
+ }
+
+ case 0xD4: // fixext 1
+ {
+ std::int8_t subtype{};
+ return get_number(input_format_t::msgpack, subtype) &&
+ get_binary(input_format_t::msgpack, 1, result) &&
+ assign_and_return_true(subtype);
+ }
+
+ case 0xD5: // fixext 2
+ {
+ std::int8_t subtype{};
+ return get_number(input_format_t::msgpack, subtype) &&
+ get_binary(input_format_t::msgpack, 2, result) &&
+ assign_and_return_true(subtype);
+ }
+
+ case 0xD6: // fixext 4
+ {
+ std::int8_t subtype{};
+ return get_number(input_format_t::msgpack, subtype) &&
+ get_binary(input_format_t::msgpack, 4, result) &&
+ assign_and_return_true(subtype);
+ }
+
+ case 0xD7: // fixext 8
+ {
+ std::int8_t subtype{};
+ return get_number(input_format_t::msgpack, subtype) &&
+ get_binary(input_format_t::msgpack, 8, result) &&
+ assign_and_return_true(subtype);
+ }
+
+ case 0xD8: // fixext 16
+ {
+ std::int8_t subtype{};
+ return get_number(input_format_t::msgpack, subtype) &&
+ get_binary(input_format_t::msgpack, 16, result) &&
+ assign_and_return_true(subtype);
+ }
+
+ default: // LCOV_EXCL_LINE
+ return false; // LCOV_EXCL_LINE
+ }
+ }
+
+ /*!
+ @param[in] len the length of the array
+ @return whether array creation completed
+ */
+ bool get_msgpack_array(const std::size_t len)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->start_array(len)))
+ {
+ return false;
+ }
+
+ for (std::size_t i = 0; i < len; ++i)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!parse_msgpack_internal()))
+ {
+ return false;
+ }
+ }
+
+ return sax->end_array();
+ }
+
+ /*!
+ @param[in] len the length of the object
+ @return whether object creation completed
+ */
+ bool get_msgpack_object(const std::size_t len)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->start_object(len)))
+ {
+ return false;
+ }
+
+ string_t key;
+ for (std::size_t i = 0; i < len; ++i)
+ {
+ get();
+ if (JSON_HEDLEY_UNLIKELY(!get_msgpack_string(key) || !sax->key(key)))
+ {
+ return false;
+ }
+
+ if (JSON_HEDLEY_UNLIKELY(!parse_msgpack_internal()))
+ {
+ return false;
+ }
+ key.clear();
+ }
+
+ return sax->end_object();
+ }
+
+ ////////////
+ // UBJSON //
+ ////////////
+
+ /*!
+ @param[in] get_char whether a new character should be retrieved from the
+ input (true, default) or whether the last read
+ character should be considered instead
+
+ @return whether a valid UBJSON value was passed to the SAX parser
+ */
+ bool parse_ubjson_internal(const bool get_char = true)
+ {
+ return get_ubjson_value(get_char ? get_ignore_noop() : current);
+ }
+
+ /*!
+ @brief reads a UBJSON string
+
+ This function is either called after reading the 'S' byte explicitly
+ indicating a string, or in case of an object key where the 'S' byte can be
+ left out.
+
+ @param[out] result created string
+ @param[in] get_char whether a new character should be retrieved from the
+ input (true, default) or whether the last read
+ character should be considered instead
+
+ @return whether string creation completed
+ */
+ bool get_ubjson_string(string_t& result, const bool get_char = true)
+ {
+ if (get_char)
+ {
+ get(); // TODO(niels): may we ignore N here?
+ }
+
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "value")))
+ {
+ return false;
+ }
+
+ switch (current)
+ {
+ case 'U':
+ {
+ std::uint8_t len{};
+ return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, len, result);
+ }
+
+ case 'i':
+ {
+ std::int8_t len{};
+ return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, len, result);
+ }
+
+ case 'I':
+ {
+ std::int16_t len{};
+ return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, len, result);
+ }
+
+ case 'l':
+ {
+ std::int32_t len{};
+ return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, len, result);
+ }
+
+ case 'L':
+ {
+ std::int64_t len{};
+ return get_number(input_format_t::ubjson, len) && get_string(input_format_t::ubjson, 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, "expected length type specification (U, i, I, l, L); last byte: 0x" + last_token, "string"), BasicJsonType()));
+ }
+ }
+
+ /*!
+ @param[out] result determined size
+ @return whether size determination completed
+ */
+ bool get_ubjson_size_value(std::size_t& result)
+ {
+ switch (get_ignore_noop())
+ {
+ case 'U':
+ {
+ std::uint8_t number{};
+ if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+ {
+ return false;
+ }
+ result = static_cast<std::size_t>(number);
+ return true;
+ }
+
+ case 'i':
+ {
+ std::int8_t number{};
+ if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+ {
+ return false;
+ }
+ result = static_cast<std::size_t>(number); // NOLINT(bugprone-signed-char-misuse,cert-str34-c): number is not a char
+ return true;
+ }
+
+ case 'I':
+ {
+ std::int16_t number{};
+ if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+ {
+ return false;
+ }
+ result = static_cast<std::size_t>(number);
+ return true;
+ }
+
+ case 'l':
+ {
+ std::int32_t number{};
+ if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+ {
+ return false;
+ }
+ result = static_cast<std::size_t>(number);
+ return true;
+ }
+
+ case 'L':
+ {
+ std::int64_t number{};
+ if (JSON_HEDLEY_UNLIKELY(!get_number(input_format_t::ubjson, number)))
+ {
+ return false;
+ }
+ result = static_cast<std::size_t>(number);
+ return true;
+ }
+
+ 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, "expected length type specification (U, i, I, l, L) after '#'; last byte: 0x" + last_token, "size"), BasicJsonType()));
+ }
+ }
+ }
+
+ /*!
+ @brief determine the type and size for a container
+
+ In the optimized UBJSON format, a type and a size can be provided to allow
+ for a more compact representation.
+
+ @param[out] result pair of the size and the type
+
+ @return whether pair creation completed
+ */
+ bool get_ubjson_size_type(std::pair<std::size_t, char_int_type>& result)
+ {
+ result.first = string_t::npos; // size
+ result.second = 0; // type
+
+ get_ignore_noop();
+
+ if (current == '$')
+ {
+ result.second = get(); // must not ignore 'N', because 'N' maybe the type
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "type")))
+ {
+ return false;
+ }
+
+ get_ignore_noop();
+ if (JSON_HEDLEY_UNLIKELY(current != '#'))
+ {
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "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, "expected '#' after type information; last byte: 0x" + last_token, "size"), BasicJsonType()));
+ }
+
+ return get_ubjson_size_value(result.first);
+ }
+
+ if (current == '#')
+ {
+ return get_ubjson_size_value(result.first);
+ }
+
+ return true;
+ }
+
+ /*!
+ @param prefix the previously read or set type prefix
+ @return whether value creation completed
+ */
+ bool get_ubjson_value(const char_int_type prefix)
+ {
+ switch (prefix)
+ {
+ case std::char_traits<char_type>::eof(): // EOF
+ return unexpect_eof(input_format_t::ubjson, "value");
+
+ case 'T': // true
+ return sax->boolean(true);
+ case 'F': // false
+ return sax->boolean(false);
+
+ case 'Z': // null
+ return sax->null();
+
+ case 'U':
+ {
+ std::uint8_t number{};
+ return get_number(input_format_t::ubjson, number) && sax->number_unsigned(number);
+ }
+
+ case 'i':
+ {
+ std::int8_t number{};
+ return get_number(input_format_t::ubjson, number) && sax->number_integer(number);
+ }
+
+ case 'I':
+ {
+ std::int16_t number{};
+ return get_number(input_format_t::ubjson, number) && sax->number_integer(number);
+ }
+
+ case 'l':
+ {
+ std::int32_t number{};
+ return get_number(input_format_t::ubjson, number) && sax->number_integer(number);
+ }
+
+ case 'L':
+ {
+ std::int64_t number{};
+ return get_number(input_format_t::ubjson, number) && sax->number_integer(number);
+ }
+
+ case 'd':
+ {
+ float number{};
+ return get_number(input_format_t::ubjson, 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), "");
+ }
+
+ case 'H':
+ {
+ return get_ubjson_high_precision_number();
+ }
+
+ case 'C': // char
+ {
+ get();
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "char")))
+ {
+ return false;
+ }
+ if (JSON_HEDLEY_UNLIKELY(current > 127))
+ {
+ 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, "byte after 'C' must be in range 0x00..0x7F; last byte: 0x" + last_token, "char"), BasicJsonType()));
+ }
+ string_t s(1, static_cast<typename string_t::value_type>(current));
+ return sax->string(s);
+ }
+
+ case 'S': // string
+ {
+ string_t s;
+ return get_ubjson_string(s) && sax->string(s);
+ }
+
+ case '[': // array
+ return get_ubjson_array();
+
+ case '{': // object
+ 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, "invalid byte: 0x" + last_token, "value"), BasicJsonType()));
+ }
+ }
+ }
+
+ /*!
+ @return whether array creation completed
+ */
+ bool get_ubjson_array()
+ {
+ std::pair<std::size_t, char_int_type> size_and_type;
+ if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type)))
+ {
+ return false;
+ }
+
+ if (size_and_type.first != string_t::npos)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->start_array(size_and_type.first)))
+ {
+ return false;
+ }
+
+ 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_value(size_and_type.second)))
+ {
+ return false;
+ }
+ }
+ }
+ }
+ else
+ {
+ for (std::size_t i = 0; i < size_and_type.first; ++i)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!parse_ubjson_internal()))
+ {
+ return false;
+ }
+ }
+ }
+ }
+ else
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->start_array(static_cast<std::size_t>(-1))))
+ {
+ return false;
+ }
+
+ while (current != ']')
+ {
+ if (JSON_HEDLEY_UNLIKELY(!parse_ubjson_internal(false)))
+ {
+ return false;
+ }
+ get_ignore_noop();
+ }
+ }
+
+ return sax->end_array();
+ }
+
+ /*!
+ @return whether object creation completed
+ */
+ bool get_ubjson_object()
+ {
+ std::pair<std::size_t, char_int_type> size_and_type;
+ if (JSON_HEDLEY_UNLIKELY(!get_ubjson_size_type(size_and_type)))
+ {
+ return false;
+ }
+
+ string_t key;
+ if (size_and_type.first != string_t::npos)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->start_object(size_and_type.first)))
+ {
+ return false;
+ }
+
+ if (size_and_type.second != 0)
+ {
+ for (std::size_t i = 0; i < size_and_type.first; ++i)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!get_ubjson_string(key) || !sax->key(key)))
+ {
+ return false;
+ }
+ if (JSON_HEDLEY_UNLIKELY(!get_ubjson_value(size_and_type.second)))
+ {
+ return false;
+ }
+ key.clear();
+ }
+ }
+ else
+ {
+ for (std::size_t i = 0; i < size_and_type.first; ++i)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!get_ubjson_string(key) || !sax->key(key)))
+ {
+ return false;
+ }
+ if (JSON_HEDLEY_UNLIKELY(!parse_ubjson_internal()))
+ {
+ return false;
+ }
+ key.clear();
+ }
+ }
+ }
+ else
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->start_object(static_cast<std::size_t>(-1))))
+ {
+ return false;
+ }
+
+ while (current != '}')
+ {
+ if (JSON_HEDLEY_UNLIKELY(!get_ubjson_string(key, false) || !sax->key(key)))
+ {
+ return false;
+ }
+ if (JSON_HEDLEY_UNLIKELY(!parse_ubjson_internal()))
+ {
+ return false;
+ }
+ get_ignore_noop();
+ key.clear();
+ }
+ }
+
+ return sax->end_object();
+ }
+
+ // Note, no reader for UBJSON binary types is implemented because they do
+ // not exist
+
+ bool get_ubjson_high_precision_number()
+ {
+ // get size of following number string
+ std::size_t size{};
+ auto res = get_ubjson_size_value(size);
+ if (JSON_HEDLEY_UNLIKELY(!res))
+ {
+ return res;
+ }
+
+ // get number string
+ std::vector<char> number_vector;
+ for (std::size_t i = 0; i < size; ++i)
+ {
+ get();
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(input_format_t::ubjson, "number")))
+ {
+ return false;
+ }
+ number_vector.push_back(static_cast<char>(current));
+ }
+
+ // parse number string
+ using ia_type = decltype(detail::input_adapter(number_vector));
+ auto number_lexer = detail::lexer<BasicJsonType, ia_type>(detail::input_adapter(number_vector), false);
+ const auto result_number = number_lexer.scan();
+ const auto number_string = number_lexer.get_token_string();
+ const auto result_remainder = number_lexer.scan();
+
+ using token_type = typename detail::lexer_base<BasicJsonType>::token_type;
+
+ 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, "invalid number text: " + number_lexer.get_token_string(), "high-precision number"), BasicJsonType()));
+ }
+
+ switch (result_number)
+ {
+ case token_type::value_integer:
+ return sax->number_integer(number_lexer.get_number_integer());
+ case token_type::value_unsigned:
+ return sax->number_unsigned(number_lexer.get_number_unsigned());
+ case token_type::value_float:
+ return sax->number_float(number_lexer.get_number_float(), std::move(number_string));
+ case token_type::uninitialized:
+ case token_type::literal_true:
+ case token_type::literal_false:
+ case token_type::literal_null:
+ case token_type::value_string:
+ case token_type::begin_array:
+ case token_type::begin_object:
+ case token_type::end_array:
+ case token_type::end_object:
+ case token_type::name_separator:
+ case token_type::value_separator:
+ case token_type::parse_error:
+ case token_type::end_of_input:
+ 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, "invalid number text: " + number_lexer.get_token_string(), "high-precision number"), BasicJsonType()));
+ }
+ }
+
+ ///////////////////////
+ // Utility functions //
+ ///////////////////////
+
+ /*!
+ @brief get next character from the input
+
+ This function provides the interface to the used input adapter. It does
+ not throw in case the input reached EOF, but returns a -'ve valued
+ `std::char_traits<char_type>::eof()` in that case.
+
+ @return character read from the input
+ */
+ char_int_type get()
+ {
+ ++chars_read;
+ return current = ia.get_character();
+ }
+
+ /*!
+ @return character read from the input after ignoring all 'N' entries
+ */
+ char_int_type get_ignore_noop()
+ {
+ do
+ {
+ get();
+ }
+ while (current == 'N');
+
+ return current;
+ }
+
+ /*
+ @brief read a number from the input
+
+ @tparam NumberType the type of the number
+ @param[in] format the current format (for diagnostics)
+ @param[out] result number of type @a NumberType
+
+ @return whether conversion completed
+
+ @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.
+ */
+ template<typename NumberType, bool InputIsLittleEndian = false>
+ bool get_number(const input_format_t format, NumberType& result)
+ {
+ // step 1: read input into array with system's byte order
+ std::array<std::uint8_t, sizeof(NumberType)> vec{};
+ for (std::size_t i = 0; i < sizeof(NumberType); ++i)
+ {
+ get();
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(format, "number")))
+ {
+ return false;
+ }
+
+ // reverse byte order prior to conversion if necessary
+ if (is_little_endian != InputIsLittleEndian)
+ {
+ vec[sizeof(NumberType) - i - 1] = static_cast<std::uint8_t>(current);
+ }
+ else
+ {
+ vec[i] = static_cast<std::uint8_t>(current); // LCOV_EXCL_LINE
+ }
+ }
+
+ // step 2: convert array into number of type T and return
+ std::memcpy(&result, vec.data(), sizeof(NumberType));
+ return true;
+ }
+
+ /*!
+ @brief create a string by reading characters from the input
+
+ @tparam NumberType the type of the number
+ @param[in] format the current format (for diagnostics)
+ @param[in] len number of characters to read
+ @param[out] result string created by reading @a len bytes
+
+ @return whether string creation completed
+
+ @note We can not reserve @a len bytes for the result, because @a len
+ may be too large. Usually, @ref unexpect_eof() detects the end of
+ the input before we run out of string memory.
+ */
+ template<typename NumberType>
+ bool get_string(const input_format_t format,
+ const NumberType len,
+ string_t& result)
+ {
+ bool success = true;
+ for (NumberType i = 0; i < len; i++)
+ {
+ get();
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(format, "string")))
+ {
+ success = false;
+ break;
+ }
+ result.push_back(static_cast<typename string_t::value_type>(current));
+ }
+ return success;
+ }
+
+ /*!
+ @brief create a byte array by reading bytes from the input
+
+ @tparam NumberType the type of the number
+ @param[in] format the current format (for diagnostics)
+ @param[in] len number of bytes to read
+ @param[out] result byte array created by reading @a len bytes
+
+ @return whether byte array creation completed
+
+ @note We can not reserve @a len bytes for the result, because @a len
+ may be too large. Usually, @ref unexpect_eof() detects the end of
+ the input before we run out of memory.
+ */
+ template<typename NumberType>
+ bool get_binary(const input_format_t format,
+ const NumberType len,
+ binary_t& result)
+ {
+ bool success = true;
+ for (NumberType i = 0; i < len; i++)
+ {
+ get();
+ if (JSON_HEDLEY_UNLIKELY(!unexpect_eof(format, "binary")))
+ {
+ success = false;
+ break;
+ }
+ result.push_back(static_cast<std::uint8_t>(current));
+ }
+ return success;
+ }
+
+ /*!
+ @param[in] format the current format (for diagnostics)
+ @param[in] context further context information (for diagnostics)
+ @return whether the last read character is not EOF
+ */
+ JSON_HEDLEY_NON_NULL(3)
+ bool unexpect_eof(const input_format_t format, const char* context) const
+ {
+ if (JSON_HEDLEY_UNLIKELY(current == std::char_traits<char_type>::eof()))
+ {
+ return sax->parse_error(chars_read, "<end of file>",
+ parse_error::create(110, chars_read, exception_message(format, "unexpected end of input", context), BasicJsonType()));
+ }
+ return true;
+ }
+
+ /*!
+ @return a string representation of the last read byte
+ */
+ std::string get_token_string() const
+ {
+ std::array<char, 3> cr{{}};
+ static_cast<void>((std::snprintf)(cr.data(), cr.size(), "%.2hhX", static_cast<unsigned char>(current))); // NOLINT(cppcoreguidelines-pro-type-vararg,hicpp-vararg)
+ return std::string{cr.data()};
+ }
+
+ /*!
+ @param[in] format the current format
+ @param[in] detail a detailed error message
+ @param[in] context further context information
+ @return a message string to use in the parse_error exceptions
+ */
+ std::string exception_message(const input_format_t format,
+ const std::string& detail,
+ const std::string& context) const
+ {
+ std::string error_msg = "syntax error while parsing ";
+
+ switch (format)
+ {
+ case input_format_t::cbor:
+ error_msg += "CBOR";
+ break;
+
+ case input_format_t::msgpack:
+ error_msg += "MessagePack";
+ break;
+
+ case input_format_t::ubjson:
+ error_msg += "UBJSON";
+ break;
+
+ case input_format_t::bson:
+ error_msg += "BSON";
+ 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
+ }
+
+ return error_msg + " " + context + ": " + detail;
+ }
+
+ private:
+ /// input adapter
+ InputAdapterType ia;
+
+ /// the current character
+ char_int_type current = std::char_traits<char_type>::eof();
+
+ /// the number of characters read
+ std::size_t chars_read = 0;
+
+ /// whether we can assume little endianness
+ const bool is_little_endian = little_endianness();
+
+ /// the SAX parser
+ json_sax_t* sax = nullptr;
+};
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/input/input_adapters.hpp>
+
+// #include <nlohmann/detail/input/lexer.hpp>
+
+// #include <nlohmann/detail/input/parser.hpp>
+
+
+#include <cmath> // isfinite
+#include <cstdint> // uint8_t
+#include <functional> // function
+#include <string> // string
+#include <utility> // move
+#include <vector> // vector
+
+// #include <nlohmann/detail/exceptions.hpp>
+
+// #include <nlohmann/detail/input/input_adapters.hpp>
+
+// #include <nlohmann/detail/input/json_sax.hpp>
+
+// #include <nlohmann/detail/input/lexer.hpp>
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+// #include <nlohmann/detail/meta/is_sax.hpp>
+
+// #include <nlohmann/detail/value_t.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+////////////
+// parser //
+////////////
+
+enum class parse_event_t : std::uint8_t
+{
+ /// the parser read `{` and started to process a JSON object
+ object_start,
+ /// the parser read `}` and finished processing a JSON object
+ object_end,
+ /// the parser read `[` and started to process a JSON array
+ array_start,
+ /// the parser read `]` and finished processing a JSON array
+ array_end,
+ /// the parser read a key of a value in an object
+ key,
+ /// the parser finished reading a JSON value
+ value
+};
+
+template<typename BasicJsonType>
+using parser_callback_t =
+ std::function<bool(int /*depth*/, parse_event_t /*event*/, BasicJsonType& /*parsed*/)>;
+
+/*!
+@brief syntax analysis
+
+This class implements a recursive descent parser.
+*/
+template<typename BasicJsonType, typename InputAdapterType>
+class parser
+{
+ using number_integer_t = typename BasicJsonType::number_integer_t;
+ using number_unsigned_t = typename BasicJsonType::number_unsigned_t;
+ using number_float_t = typename BasicJsonType::number_float_t;
+ using string_t = typename BasicJsonType::string_t;
+ using lexer_t = lexer<BasicJsonType, InputAdapterType>;
+ using token_type = typename lexer_t::token_type;
+
+ public:
+ /// a parser reading from an input adapter
+ explicit parser(InputAdapterType&& adapter,
+ const parser_callback_t<BasicJsonType> cb = nullptr,
+ const bool allow_exceptions_ = true,
+ const bool skip_comments = false)
+ : callback(cb)
+ , m_lexer(std::move(adapter), skip_comments)
+ , allow_exceptions(allow_exceptions_)
+ {
+ // read first token
+ get_token();
+ }
+
+ /*!
+ @brief public parser interface
+
+ @param[in] strict whether to expect the last token to be EOF
+ @param[in,out] result parsed JSON value
+
+ @throw parse_error.101 in case of an unexpected token
+ @throw parse_error.102 if to_unicode fails or surrogate error
+ @throw parse_error.103 if to_unicode fails
+ */
+ void parse(const bool strict, BasicJsonType& result)
+ {
+ if (callback)
+ {
+ json_sax_dom_callback_parser<BasicJsonType> sdp(result, callback, allow_exceptions);
+ sax_parse_internal(&sdp);
+
+ // in strict mode, input must be completely read
+ if (strict && (get_token() != token_type::end_of_input))
+ {
+ sdp.parse_error(m_lexer.get_position(),
+ m_lexer.get_token_string(),
+ parse_error::create(101, m_lexer.get_position(),
+ exception_message(token_type::end_of_input, "value"), BasicJsonType()));
+ }
+
+ // in case of an error, return discarded value
+ if (sdp.is_errored())
+ {
+ result = value_t::discarded;
+ return;
+ }
+
+ // set top-level value to null if it was discarded by the callback
+ // function
+ if (result.is_discarded())
+ {
+ result = nullptr;
+ }
+ }
+ else
+ {
+ json_sax_dom_parser<BasicJsonType> sdp(result, allow_exceptions);
+ sax_parse_internal(&sdp);
+
+ // in strict mode, input must be completely read
+ if (strict && (get_token() != token_type::end_of_input))
+ {
+ sdp.parse_error(m_lexer.get_position(),
+ m_lexer.get_token_string(),
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_of_input, "value"), BasicJsonType()));
+ }
+
+ // in case of an error, return discarded value
+ if (sdp.is_errored())
+ {
+ result = value_t::discarded;
+ return;
+ }
+ }
+
+ result.assert_invariant();
+ }
+
+ /*!
+ @brief public accept interface
+
+ @param[in] strict whether to expect the last token to be EOF
+ @return whether the input is a proper JSON text
+ */
+ bool accept(const bool strict = true)
+ {
+ json_sax_acceptor<BasicJsonType> sax_acceptor;
+ return sax_parse(&sax_acceptor, strict);
+ }
+
+ template<typename SAX>
+ JSON_HEDLEY_NON_NULL(2)
+ bool sax_parse(SAX* sax, const bool strict = true)
+ {
+ (void)detail::is_sax_static_asserts<SAX, BasicJsonType> {};
+ const bool result = sax_parse_internal(sax);
+
+ // strict mode: next byte must be EOF
+ if (result && strict && (get_token() != token_type::end_of_input))
+ {
+ return sax->parse_error(m_lexer.get_position(),
+ m_lexer.get_token_string(),
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_of_input, "value"), BasicJsonType()));
+ }
+
+ return result;
+ }
+
+ private:
+ template<typename SAX>
+ JSON_HEDLEY_NON_NULL(2)
+ bool sax_parse_internal(SAX* sax)
+ {
+ // stack to remember the hierarchy of structured values we are parsing
+ // true = array; false = object
+ std::vector<bool> states;
+ // value to avoid a goto (see comment where set to true)
+ bool skip_to_state_evaluation = false;
+
+ while (true)
+ {
+ if (!skip_to_state_evaluation)
+ {
+ // invariant: get_token() was called before each iteration
+ switch (last_token)
+ {
+ case token_type::begin_object:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->start_object(static_cast<std::size_t>(-1))))
+ {
+ return false;
+ }
+
+ // closing } -> we are done
+ if (get_token() == token_type::end_object)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->end_object()))
+ {
+ return false;
+ }
+ break;
+ }
+
+ // parse key
+ if (JSON_HEDLEY_UNLIKELY(last_token != token_type::value_string))
+ {
+ return sax->parse_error(m_lexer.get_position(),
+ m_lexer.get_token_string(),
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::value_string, "object key"), BasicJsonType()));
+ }
+ if (JSON_HEDLEY_UNLIKELY(!sax->key(m_lexer.get_string())))
+ {
+ return false;
+ }
+
+ // parse separator (:)
+ if (JSON_HEDLEY_UNLIKELY(get_token() != token_type::name_separator))
+ {
+ return sax->parse_error(m_lexer.get_position(),
+ m_lexer.get_token_string(),
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::name_separator, "object separator"), BasicJsonType()));
+ }
+
+ // remember we are now inside an object
+ states.push_back(false);
+
+ // parse values
+ get_token();
+ continue;
+ }
+
+ case token_type::begin_array:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->start_array(static_cast<std::size_t>(-1))))
+ {
+ return false;
+ }
+
+ // closing ] -> we are done
+ if (get_token() == token_type::end_array)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->end_array()))
+ {
+ return false;
+ }
+ break;
+ }
+
+ // remember we are now inside an array
+ states.push_back(true);
+
+ // parse values (no need to call get_token)
+ continue;
+ }
+
+ case token_type::value_float:
+ {
+ const auto res = m_lexer.get_number_float();
+
+ if (JSON_HEDLEY_UNLIKELY(!std::isfinite(res)))
+ {
+ return sax->parse_error(m_lexer.get_position(),
+ m_lexer.get_token_string(),
+ out_of_range::create(406, "number overflow parsing '" + m_lexer.get_token_string() + "'", BasicJsonType()));
+ }
+
+ if (JSON_HEDLEY_UNLIKELY(!sax->number_float(res, m_lexer.get_string())))
+ {
+ return false;
+ }
+
+ break;
+ }
+
+ case token_type::literal_false:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->boolean(false)))
+ {
+ return false;
+ }
+ break;
+ }
+
+ case token_type::literal_null:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->null()))
+ {
+ return false;
+ }
+ break;
+ }
+
+ case token_type::literal_true:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->boolean(true)))
+ {
+ return false;
+ }
+ break;
+ }
+
+ case token_type::value_integer:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->number_integer(m_lexer.get_number_integer())))
+ {
+ return false;
+ }
+ break;
+ }
+
+ case token_type::value_string:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->string(m_lexer.get_string())))
+ {
+ return false;
+ }
+ break;
+ }
+
+ case token_type::value_unsigned:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->number_unsigned(m_lexer.get_number_unsigned())))
+ {
+ return false;
+ }
+ break;
+ }
+
+ case token_type::parse_error:
+ {
+ // using "uninitialized" to avoid "expected" message
+ return sax->parse_error(m_lexer.get_position(),
+ m_lexer.get_token_string(),
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::uninitialized, "value"), BasicJsonType()));
+ }
+
+ case token_type::uninitialized:
+ case token_type::end_array:
+ case token_type::end_object:
+ case token_type::name_separator:
+ case token_type::value_separator:
+ case token_type::end_of_input:
+ case token_type::literal_or_value:
+ default: // the last token was unexpected
+ {
+ return sax->parse_error(m_lexer.get_position(),
+ m_lexer.get_token_string(),
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::literal_or_value, "value"), BasicJsonType()));
+ }
+ }
+ }
+ else
+ {
+ skip_to_state_evaluation = false;
+ }
+
+ // we reached this line after we successfully parsed a value
+ if (states.empty())
+ {
+ // empty stack: we reached the end of the hierarchy: done
+ return true;
+ }
+
+ if (states.back()) // array
+ {
+ // comma -> next value
+ if (get_token() == token_type::value_separator)
+ {
+ // parse a new value
+ get_token();
+ continue;
+ }
+
+ // closing ]
+ if (JSON_HEDLEY_LIKELY(last_token == token_type::end_array))
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->end_array()))
+ {
+ return false;
+ }
+
+ // We are done with this array. Before we can parse a
+ // new value, we need to evaluate the new state first.
+ // By setting skip_to_state_evaluation to false, we
+ // are effectively jumping to the beginning of this if.
+ JSON_ASSERT(!states.empty());
+ states.pop_back();
+ skip_to_state_evaluation = true;
+ continue;
+ }
+
+ return sax->parse_error(m_lexer.get_position(),
+ m_lexer.get_token_string(),
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_array, "array"), BasicJsonType()));
+ }
+
+ // states.back() is false -> object
+
+ // comma -> next value
+ if (get_token() == token_type::value_separator)
+ {
+ // parse key
+ if (JSON_HEDLEY_UNLIKELY(get_token() != token_type::value_string))
+ {
+ return sax->parse_error(m_lexer.get_position(),
+ m_lexer.get_token_string(),
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::value_string, "object key"), BasicJsonType()));
+ }
+
+ if (JSON_HEDLEY_UNLIKELY(!sax->key(m_lexer.get_string())))
+ {
+ return false;
+ }
+
+ // parse separator (:)
+ if (JSON_HEDLEY_UNLIKELY(get_token() != token_type::name_separator))
+ {
+ return sax->parse_error(m_lexer.get_position(),
+ m_lexer.get_token_string(),
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::name_separator, "object separator"), BasicJsonType()));
+ }
+
+ // parse values
+ get_token();
+ continue;
+ }
+
+ // closing }
+ if (JSON_HEDLEY_LIKELY(last_token == token_type::end_object))
+ {
+ if (JSON_HEDLEY_UNLIKELY(!sax->end_object()))
+ {
+ return false;
+ }
+
+ // We are done with this object. Before we can parse a
+ // new value, we need to evaluate the new state first.
+ // By setting skip_to_state_evaluation to false, we
+ // are effectively jumping to the beginning of this if.
+ JSON_ASSERT(!states.empty());
+ states.pop_back();
+ skip_to_state_evaluation = true;
+ continue;
+ }
+
+ return sax->parse_error(m_lexer.get_position(),
+ m_lexer.get_token_string(),
+ parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_object, "object"), BasicJsonType()));
+ }
+ }
+
+ /// get next token from lexer
+ token_type get_token()
+ {
+ return last_token = m_lexer.scan();
+ }
+
+ std::string exception_message(const token_type expected, const std::string& context)
+ {
+ std::string error_msg = "syntax error ";
+
+ if (!context.empty())
+ {
+ error_msg += "while parsing " + context + " ";
+ }
+
+ error_msg += "- ";
+
+ if (last_token == token_type::parse_error)
+ {
+ error_msg += std::string(m_lexer.get_error_message()) + "; last read: '" +
+ m_lexer.get_token_string() + "'";
+ }
+ else
+ {
+ error_msg += "unexpected " + std::string(lexer_t::token_type_name(last_token));
+ }
+
+ if (expected != token_type::uninitialized)
+ {
+ error_msg += "; expected " + std::string(lexer_t::token_type_name(expected));
+ }
+
+ return error_msg;
+ }
+
+ private:
+ /// callback function
+ const parser_callback_t<BasicJsonType> callback = nullptr;
+ /// the type of the last read token
+ token_type last_token = token_type::uninitialized;
+ /// the lexer
+ lexer_t m_lexer;
+ /// whether to throw exceptions in case of errors
+ const bool allow_exceptions = true;
+};
+
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/iterators/internal_iterator.hpp>
+
+
+// #include <nlohmann/detail/iterators/primitive_iterator.hpp>
+
+
+#include <cstddef> // ptrdiff_t
+#include <limits> // numeric_limits
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+/*
+@brief an iterator for primitive JSON types
+
+This class models an iterator for primitive JSON types (boolean, number,
+string). It's only purpose is to allow the iterator/const_iterator classes
+to "iterate" over primitive values. Internally, the iterator is modeled by
+a `difference_type` variable. Value begin_value (`0`) models the begin,
+end_value (`1`) models past the end.
+*/
+class primitive_iterator_t
+{
+ private:
+ using difference_type = std::ptrdiff_t;
+ static constexpr difference_type begin_value = 0;
+ static constexpr difference_type end_value = begin_value + 1;
+
+ JSON_PRIVATE_UNLESS_TESTED:
+ /// iterator as signed integer type
+ difference_type m_it = (std::numeric_limits<std::ptrdiff_t>::min)();
+
+ public:
+ constexpr difference_type get_value() const noexcept
+ {
+ return m_it;
+ }
+
+ /// set iterator to a defined beginning
+ void set_begin() noexcept
+ {
+ m_it = begin_value;
+ }
+
+ /// set iterator to a defined past the end
+ void set_end() noexcept
+ {
+ m_it = end_value;
+ }
+
+ /// return whether the iterator can be dereferenced
+ constexpr bool is_begin() const noexcept
+ {
+ return m_it == begin_value;
+ }
+
+ /// return whether the iterator is at end
+ constexpr bool is_end() const noexcept
+ {
+ return m_it == end_value;
+ }
+
+ friend constexpr bool operator==(primitive_iterator_t lhs, primitive_iterator_t rhs) noexcept
+ {
+ return lhs.m_it == rhs.m_it;
+ }
+
+ friend constexpr bool operator<(primitive_iterator_t lhs, primitive_iterator_t rhs) noexcept
+ {
+ return lhs.m_it < rhs.m_it;
+ }
+
+ primitive_iterator_t operator+(difference_type n) noexcept
+ {
+ auto result = *this;
+ result += n;
+ return result;
+ }
+
+ friend constexpr difference_type operator-(primitive_iterator_t lhs, primitive_iterator_t rhs) noexcept
+ {
+ return lhs.m_it - rhs.m_it;
+ }
+
+ primitive_iterator_t& operator++() noexcept
+ {
+ ++m_it;
+ return *this;
+ }
+
+ primitive_iterator_t const operator++(int) noexcept // NOLINT(readability-const-return-type)
+ {
+ auto result = *this;
+ ++m_it;
+ return result;
+ }
+
+ primitive_iterator_t& operator--() noexcept
+ {
+ --m_it;
+ return *this;
+ }
+
+ primitive_iterator_t const operator--(int) noexcept // NOLINT(readability-const-return-type)
+ {
+ auto result = *this;
+ --m_it;
+ return result;
+ }
+
+ primitive_iterator_t& operator+=(difference_type n) noexcept
+ {
+ m_it += n;
+ return *this;
+ }
+
+ primitive_iterator_t& operator-=(difference_type n) noexcept
+ {
+ m_it -= n;
+ return *this;
+ }
+};
+} // namespace detail
+} // namespace nlohmann
+
+
+namespace nlohmann
+{
+namespace detail
+{
+/*!
+@brief an iterator value
+
+@note This structure could easily be a union, but MSVC currently does not allow
+unions members with complex constructors, see https://github.com/nlohmann/json/pull/105.
+*/
+template<typename BasicJsonType> struct internal_iterator
+{
+ /// iterator for JSON objects
+ typename BasicJsonType::object_t::iterator object_iterator {};
+ /// iterator for JSON arrays
+ typename BasicJsonType::array_t::iterator array_iterator {};
+ /// generic iterator for all other types
+ primitive_iterator_t primitive_iterator {};
+};
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/iterators/iter_impl.hpp>
+
+
+#include <iterator> // iterator, random_access_iterator_tag, bidirectional_iterator_tag, advance, next
+#include <type_traits> // conditional, is_const, remove_const
+
+// #include <nlohmann/detail/exceptions.hpp>
+
+// #include <nlohmann/detail/iterators/internal_iterator.hpp>
+
+// #include <nlohmann/detail/iterators/primitive_iterator.hpp>
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+// #include <nlohmann/detail/meta/cpp_future.hpp>
+
+// #include <nlohmann/detail/meta/type_traits.hpp>
+
+// #include <nlohmann/detail/value_t.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+// forward declare, to be able to friend it later on
+template<typename IteratorType> class iteration_proxy;
+template<typename IteratorType> class iteration_proxy_value;
+
+/*!
+@brief a template for a bidirectional iterator for the @ref basic_json class
+This class implements a both iterators (iterator and const_iterator) for the
+@ref basic_json class.
+@note An iterator is called *initialized* when a pointer to a JSON value has
+ been set (e.g., by a constructor or a copy assignment). If the iterator is
+ default-constructed, it is *uninitialized* and most methods are undefined.
+ **The library uses assertions to detect calls on uninitialized iterators.**
+@requirement The class satisfies the following concept requirements:
+-
+[BidirectionalIterator](https://en.cppreference.com/w/cpp/named_req/BidirectionalIterator):
+ The iterator that can be moved can be moved in both directions (i.e.
+ incremented and decremented).
+@since version 1.0.0, simplified in version 2.0.9, change to bidirectional
+ iterators in version 3.0.0 (see https://github.com/nlohmann/json/issues/593)
+*/
+template<typename BasicJsonType>
+class iter_impl // NOLINT(cppcoreguidelines-special-member-functions,hicpp-special-member-functions)
+{
+ /// the iterator with BasicJsonType of different const-ness
+ using other_iter_impl = iter_impl<typename std::conditional<std::is_const<BasicJsonType>::value, typename std::remove_const<BasicJsonType>::type, const BasicJsonType>::type>;
+ /// allow basic_json to access private members
+ friend other_iter_impl;
+ friend BasicJsonType;
+ friend iteration_proxy<iter_impl>;
+ friend iteration_proxy_value<iter_impl>;
+
+ using object_t = typename BasicJsonType::object_t;
+ using array_t = typename BasicJsonType::array_t;
+ // 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");
+
+ 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
+ /// iterator_category, value_type, difference_type, pointer, and reference.
+ /// Note that value_type is required to be non-const, even for constant iterators.
+ using iterator_category = std::bidirectional_iterator_tag;
+
+ /// the type of the values when the iterator is dereferenced
+ using value_type = typename BasicJsonType::value_type;
+ /// a type to represent differences between iterators
+ using difference_type = typename BasicJsonType::difference_type;
+ /// defines a pointer to the type iterated over (value_type)
+ using pointer = typename std::conditional<std::is_const<BasicJsonType>::value,
+ typename BasicJsonType::const_pointer,
+ typename BasicJsonType::pointer>::type;
+ /// defines a reference to the type iterated over (value_type)
+ using reference =
+ typename std::conditional<std::is_const<BasicJsonType>::value,
+ typename BasicJsonType::const_reference,
+ typename BasicJsonType::reference>::type;
+
+ iter_impl() = default;
+ ~iter_impl() = default;
+ iter_impl(iter_impl&&) noexcept = default;
+ iter_impl& operator=(iter_impl&&) noexcept = default;
+
+ /*!
+ @brief constructor for a given JSON instance
+ @param[in] object pointer to a JSON object for this iterator
+ @pre object != nullptr
+ @post The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ explicit iter_impl(pointer object) noexcept : m_object(object)
+ {
+ JSON_ASSERT(m_object != nullptr);
+
+ switch (m_object->m_type)
+ {
+ case value_t::object:
+ {
+ m_it.object_iterator = typename object_t::iterator();
+ break;
+ }
+
+ case value_t::array:
+ {
+ m_it.array_iterator = typename array_t::iterator();
+ break;
+ }
+
+ case value_t::null:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ {
+ m_it.primitive_iterator = primitive_iterator_t();
+ break;
+ }
+ }
+ }
+
+ /*!
+ @note The conventional copy constructor and copy assignment are implicitly
+ defined. Combined with the following converting constructor and
+ assignment, they support: (1) copy from iterator to iterator, (2)
+ copy from const iterator to const iterator, and (3) conversion from
+ iterator to const iterator. However conversion from const iterator
+ to iterator is not defined.
+ */
+
+ /*!
+ @brief const copy constructor
+ @param[in] other const iterator to copy from
+ @note This copy constructor had to be defined explicitly to circumvent a bug
+ occurring on msvc v19.0 compiler (VS 2015) debug build. For more
+ information refer to: https://github.com/nlohmann/json/issues/1608
+ */
+ iter_impl(const iter_impl<const BasicJsonType>& other) noexcept
+ : m_object(other.m_object), m_it(other.m_it)
+ {}
+
+ /*!
+ @brief converting assignment
+ @param[in] other const iterator to copy from
+ @return const/non-const iterator
+ @note It is not checked whether @a other is initialized.
+ */
+ iter_impl& operator=(const iter_impl<const BasicJsonType>& other) noexcept
+ {
+ if (&other != this)
+ {
+ m_object = other.m_object;
+ m_it = other.m_it;
+ }
+ return *this;
+ }
+
+ /*!
+ @brief converting constructor
+ @param[in] other non-const iterator to copy from
+ @note It is not checked whether @a other is initialized.
+ */
+ iter_impl(const iter_impl<typename std::remove_const<BasicJsonType>::type>& other) noexcept
+ : m_object(other.m_object), m_it(other.m_it)
+ {}
+
+ /*!
+ @brief converting assignment
+ @param[in] other non-const iterator to copy from
+ @return const/non-const iterator
+ @note It is not checked whether @a other is initialized.
+ */
+ iter_impl& operator=(const iter_impl<typename std::remove_const<BasicJsonType>::type>& other) noexcept // NOLINT(cert-oop54-cpp)
+ {
+ m_object = other.m_object;
+ m_it = other.m_it;
+ return *this;
+ }
+
+ JSON_PRIVATE_UNLESS_TESTED:
+ /*!
+ @brief set the iterator to the first value
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ void set_begin() noexcept
+ {
+ JSON_ASSERT(m_object != nullptr);
+
+ switch (m_object->m_type)
+ {
+ case value_t::object:
+ {
+ m_it.object_iterator = m_object->m_value.object->begin();
+ break;
+ }
+
+ case value_t::array:
+ {
+ m_it.array_iterator = m_object->m_value.array->begin();
+ break;
+ }
+
+ case value_t::null:
+ {
+ // set to end so begin()==end() is true: null is empty
+ m_it.primitive_iterator.set_end();
+ break;
+ }
+
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ {
+ m_it.primitive_iterator.set_begin();
+ break;
+ }
+ }
+ }
+
+ /*!
+ @brief set the iterator past the last value
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ void set_end() noexcept
+ {
+ JSON_ASSERT(m_object != nullptr);
+
+ switch (m_object->m_type)
+ {
+ case value_t::object:
+ {
+ m_it.object_iterator = m_object->m_value.object->end();
+ break;
+ }
+
+ case value_t::array:
+ {
+ m_it.array_iterator = m_object->m_value.array->end();
+ break;
+ }
+
+ case value_t::null:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ {
+ m_it.primitive_iterator.set_end();
+ break;
+ }
+ }
+ }
+
+ public:
+ /*!
+ @brief return a reference to the value pointed to by the iterator
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ reference operator*() const
+ {
+ JSON_ASSERT(m_object != nullptr);
+
+ switch (m_object->m_type)
+ {
+ case value_t::object:
+ {
+ JSON_ASSERT(m_it.object_iterator != m_object->m_value.object->end());
+ return m_it.object_iterator->second;
+ }
+
+ case value_t::array:
+ {
+ JSON_ASSERT(m_it.array_iterator != m_object->m_value.array->end());
+ return *m_it.array_iterator;
+ }
+
+ case value_t::null:
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ {
+ if (JSON_HEDLEY_LIKELY(m_it.primitive_iterator.is_begin()))
+ {
+ return *m_object;
+ }
+
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+ }
+ }
+ }
+
+ /*!
+ @brief dereference the iterator
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ pointer operator->() const
+ {
+ JSON_ASSERT(m_object != nullptr);
+
+ switch (m_object->m_type)
+ {
+ case value_t::object:
+ {
+ JSON_ASSERT(m_it.object_iterator != m_object->m_value.object->end());
+ return &(m_it.object_iterator->second);
+ }
+
+ case value_t::array:
+ {
+ JSON_ASSERT(m_it.array_iterator != m_object->m_value.array->end());
+ return &*m_it.array_iterator;
+ }
+
+ case value_t::null:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ {
+ if (JSON_HEDLEY_LIKELY(m_it.primitive_iterator.is_begin()))
+ {
+ return m_object;
+ }
+
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+ }
+ }
+ }
+
+ /*!
+ @brief post-increment (it++)
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ iter_impl const operator++(int) // NOLINT(readability-const-return-type)
+ {
+ auto result = *this;
+ ++(*this);
+ return result;
+ }
+
+ /*!
+ @brief pre-increment (++it)
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ iter_impl& operator++()
+ {
+ JSON_ASSERT(m_object != nullptr);
+
+ switch (m_object->m_type)
+ {
+ case value_t::object:
+ {
+ std::advance(m_it.object_iterator, 1);
+ break;
+ }
+
+ case value_t::array:
+ {
+ std::advance(m_it.array_iterator, 1);
+ break;
+ }
+
+ case value_t::null:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ {
+ ++m_it.primitive_iterator;
+ break;
+ }
+ }
+
+ return *this;
+ }
+
+ /*!
+ @brief post-decrement (it--)
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ iter_impl const operator--(int) // NOLINT(readability-const-return-type)
+ {
+ auto result = *this;
+ --(*this);
+ return result;
+ }
+
+ /*!
+ @brief pre-decrement (--it)
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ iter_impl& operator--()
+ {
+ JSON_ASSERT(m_object != nullptr);
+
+ switch (m_object->m_type)
+ {
+ case value_t::object:
+ {
+ std::advance(m_it.object_iterator, -1);
+ break;
+ }
+
+ case value_t::array:
+ {
+ std::advance(m_it.array_iterator, -1);
+ break;
+ }
+
+ case value_t::null:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ {
+ --m_it.primitive_iterator;
+ break;
+ }
+ }
+
+ return *this;
+ }
+
+ /*!
+ @brief comparison: equal
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ template < typename IterImpl, detail::enable_if_t < (std::is_same<IterImpl, iter_impl>::value || std::is_same<IterImpl, other_iter_impl>::value), std::nullptr_t > = nullptr >
+ bool operator==(const IterImpl& other) const
+ {
+ // if objects are not the same, the comparison is undefined
+ if (JSON_HEDLEY_UNLIKELY(m_object != other.m_object))
+ {
+ JSON_THROW(invalid_iterator::create(212, "cannot compare iterators of different containers", *m_object));
+ }
+
+ JSON_ASSERT(m_object != nullptr);
+
+ switch (m_object->m_type)
+ {
+ case value_t::object:
+ return (m_it.object_iterator == other.m_it.object_iterator);
+
+ case value_t::array:
+ return (m_it.array_iterator == other.m_it.array_iterator);
+
+ case value_t::null:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ return (m_it.primitive_iterator == other.m_it.primitive_iterator);
+ }
+ }
+
+ /*!
+ @brief comparison: not equal
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ template < typename IterImpl, detail::enable_if_t < (std::is_same<IterImpl, iter_impl>::value || std::is_same<IterImpl, other_iter_impl>::value), std::nullptr_t > = nullptr >
+ bool operator!=(const IterImpl& other) const
+ {
+ return !operator==(other);
+ }
+
+ /*!
+ @brief comparison: smaller
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ bool operator<(const iter_impl& other) const
+ {
+ // if objects are not the same, the comparison is undefined
+ if (JSON_HEDLEY_UNLIKELY(m_object != other.m_object))
+ {
+ JSON_THROW(invalid_iterator::create(212, "cannot compare iterators of different containers", *m_object));
+ }
+
+ JSON_ASSERT(m_object != nullptr);
+
+ switch (m_object->m_type)
+ {
+ case value_t::object:
+ JSON_THROW(invalid_iterator::create(213, "cannot compare order of object iterators", *m_object));
+
+ case value_t::array:
+ return (m_it.array_iterator < other.m_it.array_iterator);
+
+ case value_t::null:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ return (m_it.primitive_iterator < other.m_it.primitive_iterator);
+ }
+ }
+
+ /*!
+ @brief comparison: less than or equal
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ bool operator<=(const iter_impl& other) const
+ {
+ return !other.operator < (*this);
+ }
+
+ /*!
+ @brief comparison: greater than
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ bool operator>(const iter_impl& other) const
+ {
+ return !operator<=(other);
+ }
+
+ /*!
+ @brief comparison: greater than or equal
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ bool operator>=(const iter_impl& other) const
+ {
+ return !operator<(other);
+ }
+
+ /*!
+ @brief add to iterator
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ iter_impl& operator+=(difference_type i)
+ {
+ JSON_ASSERT(m_object != nullptr);
+
+ switch (m_object->m_type)
+ {
+ case value_t::object:
+ JSON_THROW(invalid_iterator::create(209, "cannot use offsets with object iterators", *m_object));
+
+ case value_t::array:
+ {
+ std::advance(m_it.array_iterator, i);
+ break;
+ }
+
+ case value_t::null:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ {
+ m_it.primitive_iterator += i;
+ break;
+ }
+ }
+
+ return *this;
+ }
+
+ /*!
+ @brief subtract from iterator
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ iter_impl& operator-=(difference_type i)
+ {
+ return operator+=(-i);
+ }
+
+ /*!
+ @brief add to iterator
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ iter_impl operator+(difference_type i) const
+ {
+ auto result = *this;
+ result += i;
+ return result;
+ }
+
+ /*!
+ @brief addition of distance and iterator
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ friend iter_impl operator+(difference_type i, const iter_impl& it)
+ {
+ auto result = it;
+ result += i;
+ return result;
+ }
+
+ /*!
+ @brief subtract from iterator
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ iter_impl operator-(difference_type i) const
+ {
+ auto result = *this;
+ result -= i;
+ return result;
+ }
+
+ /*!
+ @brief return difference
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ difference_type operator-(const iter_impl& other) const
+ {
+ JSON_ASSERT(m_object != nullptr);
+
+ switch (m_object->m_type)
+ {
+ case value_t::object:
+ JSON_THROW(invalid_iterator::create(209, "cannot use offsets with object iterators", *m_object));
+
+ case value_t::array:
+ return m_it.array_iterator - other.m_it.array_iterator;
+
+ case value_t::null:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ return m_it.primitive_iterator - other.m_it.primitive_iterator;
+ }
+ }
+
+ /*!
+ @brief access to successor
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ reference operator[](difference_type n) const
+ {
+ JSON_ASSERT(m_object != nullptr);
+
+ switch (m_object->m_type)
+ {
+ case value_t::object:
+ JSON_THROW(invalid_iterator::create(208, "cannot use operator[] for object iterators", *m_object));
+
+ case value_t::array:
+ return *std::next(m_it.array_iterator, n);
+
+ case value_t::null:
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ {
+ if (JSON_HEDLEY_LIKELY(m_it.primitive_iterator.get_value() == -n))
+ {
+ return *m_object;
+ }
+
+ JSON_THROW(invalid_iterator::create(214, "cannot get value", *m_object));
+ }
+ }
+ }
+
+ /*!
+ @brief return the key of an object iterator
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ const typename object_t::key_type& key() const
+ {
+ JSON_ASSERT(m_object != nullptr);
+
+ if (JSON_HEDLEY_LIKELY(m_object->is_object()))
+ {
+ return m_it.object_iterator->first;
+ }
+
+ JSON_THROW(invalid_iterator::create(207, "cannot use key() for non-object iterators", *m_object));
+ }
+
+ /*!
+ @brief return the value of an iterator
+ @pre The iterator is initialized; i.e. `m_object != nullptr`.
+ */
+ reference value() const
+ {
+ return operator*();
+ }
+
+ JSON_PRIVATE_UNLESS_TESTED:
+ /// associated JSON instance
+ pointer m_object = nullptr;
+ /// the actual iterator of the associated instance
+ internal_iterator<typename std::remove_const<BasicJsonType>::type> m_it {};
+};
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/iterators/iteration_proxy.hpp>
+
+// #include <nlohmann/detail/iterators/json_reverse_iterator.hpp>
+
+
+#include <cstddef> // ptrdiff_t
+#include <iterator> // reverse_iterator
+#include <utility> // declval
+
+namespace nlohmann
+{
+namespace detail
+{
+//////////////////////
+// reverse_iterator //
+//////////////////////
+
+/*!
+@brief a template for a reverse iterator class
+
+@tparam Base the base iterator type to reverse. Valid types are @ref
+iterator (to create @ref reverse_iterator) and @ref const_iterator (to
+create @ref const_reverse_iterator).
+
+@requirement The class satisfies the following concept requirements:
+-
+[BidirectionalIterator](https://en.cppreference.com/w/cpp/named_req/BidirectionalIterator):
+ The iterator that can be moved can be moved in both directions (i.e.
+ incremented and decremented).
+- [OutputIterator](https://en.cppreference.com/w/cpp/named_req/OutputIterator):
+ It is possible to write to the pointed-to element (only if @a Base is
+ @ref iterator).
+
+@since version 1.0.0
+*/
+template<typename Base>
+class json_reverse_iterator : public std::reverse_iterator<Base>
+{
+ public:
+ using difference_type = std::ptrdiff_t;
+ /// shortcut to the reverse iterator adapter
+ using base_iterator = std::reverse_iterator<Base>;
+ /// the reference type for the pointed-to element
+ using reference = typename Base::reference;
+
+ /// create reverse iterator from iterator
+ explicit json_reverse_iterator(const typename base_iterator::iterator_type& it) noexcept
+ : base_iterator(it) {}
+
+ /// create reverse iterator from base class
+ explicit json_reverse_iterator(const base_iterator& it) noexcept : base_iterator(it) {}
+
+ /// post-increment (it++)
+ json_reverse_iterator const operator++(int) // NOLINT(readability-const-return-type)
+ {
+ return static_cast<json_reverse_iterator>(base_iterator::operator++(1));
+ }
+
+ /// pre-increment (++it)
+ json_reverse_iterator& operator++()
+ {
+ return static_cast<json_reverse_iterator&>(base_iterator::operator++());
+ }
+
+ /// post-decrement (it--)
+ json_reverse_iterator const operator--(int) // NOLINT(readability-const-return-type)
+ {
+ return static_cast<json_reverse_iterator>(base_iterator::operator--(1));
+ }
+
+ /// pre-decrement (--it)
+ json_reverse_iterator& operator--()
+ {
+ return static_cast<json_reverse_iterator&>(base_iterator::operator--());
+ }
+
+ /// add to iterator
+ json_reverse_iterator& operator+=(difference_type i)
+ {
+ return static_cast<json_reverse_iterator&>(base_iterator::operator+=(i));
+ }
+
+ /// add to iterator
+ json_reverse_iterator operator+(difference_type i) const
+ {
+ return static_cast<json_reverse_iterator>(base_iterator::operator+(i));
+ }
+
+ /// subtract from iterator
+ json_reverse_iterator operator-(difference_type i) const
+ {
+ return static_cast<json_reverse_iterator>(base_iterator::operator-(i));
+ }
+
+ /// return difference
+ difference_type operator-(const json_reverse_iterator& other) const
+ {
+ return base_iterator(*this) - base_iterator(other);
+ }
+
+ /// access to successor
+ reference operator[](difference_type n) const
+ {
+ return *(this->operator+(n));
+ }
+
+ /// return the key of an object iterator
+ auto key() const -> decltype(std::declval<Base>().key())
+ {
+ auto it = --this->base();
+ return it.key();
+ }
+
+ /// return the value of an iterator
+ reference value() const
+ {
+ auto it = --this->base();
+ return it.operator * ();
+ }
+};
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/iterators/primitive_iterator.hpp>
+
+// #include <nlohmann/detail/json_pointer.hpp>
+
+
+#include <algorithm> // all_of
+#include <cctype> // isdigit
+#include <limits> // max
+#include <numeric> // accumulate
+#include <string> // string
+#include <utility> // move
+#include <vector> // vector
+
+// #include <nlohmann/detail/exceptions.hpp>
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+// #include <nlohmann/detail/string_escape.hpp>
+
+// #include <nlohmann/detail/value_t.hpp>
+
+
+namespace nlohmann
+{
+
+/// @brief JSON Pointer defines a string syntax for identifying a specific value within a JSON document
+/// @sa https://json.nlohmann.me/api/json_pointer/
+template<typename BasicJsonType>
+class json_pointer
+{
+ // allow basic_json to access private members
+ NLOHMANN_BASIC_JSON_TPL_DECLARATION
+ friend class basic_json;
+
+ public:
+ /// @brief create JSON pointer
+ /// @sa https://json.nlohmann.me/api/json_pointer/json_pointer/
+ explicit json_pointer(const std::string& s = "")
+ : reference_tokens(split(s))
+ {}
+
+ /// @brief return a string representation of the JSON pointer
+ /// @sa https://json.nlohmann.me/api/json_pointer/to_string/
+ std::string to_string() const
+ {
+ return std::accumulate(reference_tokens.begin(), reference_tokens.end(),
+ std::string{},
+ [](const std::string & a, const std::string & b)
+ {
+ return a + "/" + detail::escape(b);
+ });
+ }
+
+ /// @brief return a string representation of the JSON pointer
+ /// @sa https://json.nlohmann.me/api/json_pointer/operator_string/
+ operator std::string() const
+ {
+ return to_string();
+ }
+
+ /// @brief append another JSON pointer at the end of this JSON pointer
+ /// @sa https://json.nlohmann.me/api/json_pointer/operator_slasheq/
+ json_pointer& operator/=(const json_pointer& ptr)
+ {
+ reference_tokens.insert(reference_tokens.end(),
+ ptr.reference_tokens.begin(),
+ ptr.reference_tokens.end());
+ return *this;
+ }
+
+ /// @brief append an unescaped reference token at the end of this JSON pointer
+ /// @sa https://json.nlohmann.me/api/json_pointer/operator_slasheq/
+ json_pointer& operator/=(std::string token)
+ {
+ push_back(std::move(token));
+ return *this;
+ }
+
+ /// @brief append an array index at the end of this JSON pointer
+ /// @sa https://json.nlohmann.me/api/json_pointer/operator_slasheq/
+ json_pointer& operator/=(std::size_t array_idx)
+ {
+ return *this /= std::to_string(array_idx);
+ }
+
+ /// @brief create a new JSON pointer by appending the right JSON pointer at the end of the left JSON pointer
+ /// @sa https://json.nlohmann.me/api/json_pointer/operator_slash/
+ friend json_pointer operator/(const json_pointer& lhs,
+ const json_pointer& rhs)
+ {
+ return json_pointer(lhs) /= rhs;
+ }
+
+ /// @brief create a new JSON pointer by appending the unescaped token at the end of the JSON pointer
+ /// @sa https://json.nlohmann.me/api/json_pointer/operator_slash/
+ friend json_pointer operator/(const json_pointer& lhs, std::string token) // NOLINT(performance-unnecessary-value-param)
+ {
+ return json_pointer(lhs) /= std::move(token);
+ }
+
+ /// @brief create a new JSON pointer by appending the array-index-token at the end of the JSON pointer
+ /// @sa https://json.nlohmann.me/api/json_pointer/operator_slash/
+ friend json_pointer operator/(const json_pointer& lhs, std::size_t array_idx)
+ {
+ return json_pointer(lhs) /= array_idx;
+ }
+
+ /// @brief returns the parent of this JSON pointer
+ /// @sa https://json.nlohmann.me/api/json_pointer/parent_pointer/
+ json_pointer parent_pointer() const
+ {
+ if (empty())
+ {
+ return *this;
+ }
+
+ json_pointer res = *this;
+ res.pop_back();
+ return res;
+ }
+
+ /// @brief remove last reference token
+ /// @sa https://json.nlohmann.me/api/json_pointer/pop_back/
+ void pop_back()
+ {
+ if (JSON_HEDLEY_UNLIKELY(empty()))
+ {
+ JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", BasicJsonType()));
+ }
+
+ reference_tokens.pop_back();
+ }
+
+ /// @brief return last reference token
+ /// @sa https://json.nlohmann.me/api/json_pointer/back/
+ const std::string& back() const
+ {
+ if (JSON_HEDLEY_UNLIKELY(empty()))
+ {
+ JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", BasicJsonType()));
+ }
+
+ return reference_tokens.back();
+ }
+
+ /// @brief append an unescaped token at the end of the reference pointer
+ /// @sa https://json.nlohmann.me/api/json_pointer/push_back/
+ void push_back(const std::string& token)
+ {
+ reference_tokens.push_back(token);
+ }
+
+ /// @brief append an unescaped token at the end of the reference pointer
+ /// @sa https://json.nlohmann.me/api/json_pointer/push_back/
+ void push_back(std::string&& token)
+ {
+ reference_tokens.push_back(std::move(token));
+ }
+
+ /// @brief return whether pointer points to the root document
+ /// @sa https://json.nlohmann.me/api/json_pointer/empty/
+ bool empty() const noexcept
+ {
+ return reference_tokens.empty();
+ }
+
+ private:
+ /*!
+ @param[in] s reference token to be converted into an array index
+
+ @return integer representation of @a s
+
+ @throw parse_error.106 if an array index begins with '0'
+ @throw parse_error.109 if an array index begins not with a digit
+ @throw out_of_range.404 if string @a s could not be converted to an integer
+ @throw out_of_range.410 if an array index exceeds size_type
+ */
+ static typename BasicJsonType::size_type array_index(const std::string& s)
+ {
+ using size_type = typename BasicJsonType::size_type;
+
+ // error condition (cf. RFC 6901, Sect. 4)
+ if (JSON_HEDLEY_UNLIKELY(s.size() > 1 && s[0] == '0'))
+ {
+ JSON_THROW(detail::parse_error::create(106, 0, "array index '" + s + "' must not begin with '0'", BasicJsonType()));
+ }
+
+ // error condition (cf. RFC 6901, Sect. 4)
+ if (JSON_HEDLEY_UNLIKELY(s.size() > 1 && !(s[0] >= '1' && s[0] <= '9')))
+ {
+ JSON_THROW(detail::parse_error::create(109, 0, "array index '" + s + "' is not a number", BasicJsonType()));
+ }
+
+ std::size_t processed_chars = 0;
+ unsigned long long res = 0; // NOLINT(runtime/int)
+ JSON_TRY
+ {
+ res = std::stoull(s, &processed_chars);
+ }
+ JSON_CATCH(std::out_of_range&)
+ {
+ JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + s + "'", BasicJsonType()));
+ }
+
+ // check if the string was completely read
+ if (JSON_HEDLEY_UNLIKELY(processed_chars != s.size()))
+ {
+ JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + s + "'", BasicJsonType()));
+ }
+
+ // only triggered on special platforms (like 32bit), see also
+ // https://github.com/nlohmann/json/pull/2203
+ if (res >= static_cast<unsigned long long>((std::numeric_limits<size_type>::max)())) // NOLINT(runtime/int)
+ {
+ JSON_THROW(detail::out_of_range::create(410, "array index " + s + " exceeds size_type", BasicJsonType())); // LCOV_EXCL_LINE
+ }
+
+ return static_cast<size_type>(res);
+ }
+
+ JSON_PRIVATE_UNLESS_TESTED:
+ json_pointer top() const
+ {
+ if (JSON_HEDLEY_UNLIKELY(empty()))
+ {
+ JSON_THROW(detail::out_of_range::create(405, "JSON pointer has no parent", BasicJsonType()));
+ }
+
+ json_pointer result = *this;
+ result.reference_tokens = {reference_tokens[0]};
+ return result;
+ }
+
+ private:
+ /*!
+ @brief create and return a reference to the pointed to value
+
+ @complexity Linear in the number of reference tokens.
+
+ @throw parse_error.109 if array index is not a number
+ @throw type_error.313 if value cannot be unflattened
+ */
+ BasicJsonType& get_and_create(BasicJsonType& j) const
+ {
+ auto* result = &j;
+
+ // in case no reference tokens exist, return a reference to the JSON value
+ // j which will be overwritten by a primitive value
+ for (const auto& reference_token : reference_tokens)
+ {
+ switch (result->type())
+ {
+ case detail::value_t::null:
+ {
+ if (reference_token == "0")
+ {
+ // start a new array if reference token is 0
+ result = &result->operator[](0);
+ }
+ else
+ {
+ // start a new object otherwise
+ result = &result->operator[](reference_token);
+ }
+ break;
+ }
+
+ case detail::value_t::object:
+ {
+ // create an entry in the object
+ result = &result->operator[](reference_token);
+ break;
+ }
+
+ case detail::value_t::array:
+ {
+ // create an entry in the array
+ result = &result->operator[](array_index(reference_token));
+ break;
+ }
+
+ /*
+ The following code is only reached if there exists a reference
+ token _and_ the current value is primitive. In this case, we have
+ an error situation, because primitive values may only occur as
+ single value; that is, with an empty list of reference tokens.
+ */
+ case detail::value_t::string:
+ case detail::value_t::boolean:
+ case detail::value_t::number_integer:
+ case detail::value_t::number_unsigned:
+ case detail::value_t::number_float:
+ case detail::value_t::binary:
+ case detail::value_t::discarded:
+ default:
+ JSON_THROW(detail::type_error::create(313, "invalid value to unflatten", j));
+ }
+ }
+
+ return *result;
+ }
+
+ /*!
+ @brief return a reference to the pointed to value
+
+ @note This version does not throw if a value is not present, but tries to
+ create nested values instead. For instance, calling this function
+ with pointer `"/this/that"` on a null value is equivalent to calling
+ `operator[]("this").operator[]("that")` on that value, effectively
+ changing the null value to an object.
+
+ @param[in] ptr a JSON value
+
+ @return reference to the JSON value pointed to by the JSON pointer
+
+ @complexity Linear in the length of the JSON pointer.
+
+ @throw parse_error.106 if an array index begins with '0'
+ @throw parse_error.109 if an array index was not a number
+ @throw out_of_range.404 if the JSON pointer can not be resolved
+ */
+ BasicJsonType& get_unchecked(BasicJsonType* ptr) const
+ {
+ for (const auto& reference_token : reference_tokens)
+ {
+ // convert null values to arrays or objects before continuing
+ if (ptr->is_null())
+ {
+ // check if reference token is a number
+ const bool nums =
+ std::all_of(reference_token.begin(), reference_token.end(),
+ [](const unsigned char x)
+ {
+ return std::isdigit(x);
+ });
+
+ // change value to array for numbers or "-" or to object otherwise
+ *ptr = (nums || reference_token == "-")
+ ? detail::value_t::array
+ : detail::value_t::object;
+ }
+
+ switch (ptr->type())
+ {
+ case detail::value_t::object:
+ {
+ // use unchecked object access
+ ptr = &ptr->operator[](reference_token);
+ break;
+ }
+
+ case detail::value_t::array:
+ {
+ if (reference_token == "-")
+ {
+ // explicitly treat "-" as index beyond the end
+ ptr = &ptr->operator[](ptr->m_value.array->size());
+ }
+ else
+ {
+ // convert array index to number; unchecked access
+ ptr = &ptr->operator[](array_index(reference_token));
+ }
+ break;
+ }
+
+ case detail::value_t::null:
+ case detail::value_t::string:
+ case detail::value_t::boolean:
+ case detail::value_t::number_integer:
+ case detail::value_t::number_unsigned:
+ case detail::value_t::number_float:
+ case detail::value_t::binary:
+ case detail::value_t::discarded:
+ default:
+ JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + reference_token + "'", *ptr));
+ }
+ }
+
+ return *ptr;
+ }
+
+ /*!
+ @throw parse_error.106 if an array index begins with '0'
+ @throw parse_error.109 if an array index was not a number
+ @throw out_of_range.402 if the array index '-' is used
+ @throw out_of_range.404 if the JSON pointer can not be resolved
+ */
+ BasicJsonType& get_checked(BasicJsonType* ptr) const
+ {
+ for (const auto& reference_token : reference_tokens)
+ {
+ switch (ptr->type())
+ {
+ case detail::value_t::object:
+ {
+ // note: at performs range check
+ ptr = &ptr->at(reference_token);
+ break;
+ }
+
+ case detail::value_t::array:
+ {
+ if (JSON_HEDLEY_UNLIKELY(reference_token == "-"))
+ {
+ // "-" always fails the range check
+ JSON_THROW(detail::out_of_range::create(402,
+ "array index '-' (" + std::to_string(ptr->m_value.array->size()) +
+ ") is out of range", *ptr));
+ }
+
+ // note: at performs range check
+ ptr = &ptr->at(array_index(reference_token));
+ break;
+ }
+
+ case detail::value_t::null:
+ case detail::value_t::string:
+ case detail::value_t::boolean:
+ case detail::value_t::number_integer:
+ case detail::value_t::number_unsigned:
+ case detail::value_t::number_float:
+ case detail::value_t::binary:
+ case detail::value_t::discarded:
+ default:
+ JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + reference_token + "'", *ptr));
+ }
+ }
+
+ return *ptr;
+ }
+
+ /*!
+ @brief return a const reference to the pointed to value
+
+ @param[in] ptr a JSON value
+
+ @return const reference to the JSON value pointed to by the JSON
+ pointer
+
+ @throw parse_error.106 if an array index begins with '0'
+ @throw parse_error.109 if an array index was not a number
+ @throw out_of_range.402 if the array index '-' is used
+ @throw out_of_range.404 if the JSON pointer can not be resolved
+ */
+ const BasicJsonType& get_unchecked(const BasicJsonType* ptr) const
+ {
+ for (const auto& reference_token : reference_tokens)
+ {
+ switch (ptr->type())
+ {
+ case detail::value_t::object:
+ {
+ // use unchecked object access
+ ptr = &ptr->operator[](reference_token);
+ break;
+ }
+
+ case detail::value_t::array:
+ {
+ if (JSON_HEDLEY_UNLIKELY(reference_token == "-"))
+ {
+ // "-" cannot be used for const access
+ JSON_THROW(detail::out_of_range::create(402, "array index '-' (" + std::to_string(ptr->m_value.array->size()) + ") is out of range", *ptr));
+ }
+
+ // use unchecked array access
+ ptr = &ptr->operator[](array_index(reference_token));
+ break;
+ }
+
+ case detail::value_t::null:
+ case detail::value_t::string:
+ case detail::value_t::boolean:
+ case detail::value_t::number_integer:
+ case detail::value_t::number_unsigned:
+ case detail::value_t::number_float:
+ case detail::value_t::binary:
+ case detail::value_t::discarded:
+ default:
+ JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + reference_token + "'", *ptr));
+ }
+ }
+
+ return *ptr;
+ }
+
+ /*!
+ @throw parse_error.106 if an array index begins with '0'
+ @throw parse_error.109 if an array index was not a number
+ @throw out_of_range.402 if the array index '-' is used
+ @throw out_of_range.404 if the JSON pointer can not be resolved
+ */
+ const BasicJsonType& get_checked(const BasicJsonType* ptr) const
+ {
+ for (const auto& reference_token : reference_tokens)
+ {
+ switch (ptr->type())
+ {
+ case detail::value_t::object:
+ {
+ // note: at performs range check
+ ptr = &ptr->at(reference_token);
+ break;
+ }
+
+ case detail::value_t::array:
+ {
+ if (JSON_HEDLEY_UNLIKELY(reference_token == "-"))
+ {
+ // "-" always fails the range check
+ JSON_THROW(detail::out_of_range::create(402,
+ "array index '-' (" + std::to_string(ptr->m_value.array->size()) +
+ ") is out of range", *ptr));
+ }
+
+ // note: at performs range check
+ ptr = &ptr->at(array_index(reference_token));
+ break;
+ }
+
+ case detail::value_t::null:
+ case detail::value_t::string:
+ case detail::value_t::boolean:
+ case detail::value_t::number_integer:
+ case detail::value_t::number_unsigned:
+ case detail::value_t::number_float:
+ case detail::value_t::binary:
+ case detail::value_t::discarded:
+ default:
+ JSON_THROW(detail::out_of_range::create(404, "unresolved reference token '" + reference_token + "'", *ptr));
+ }
+ }
+
+ return *ptr;
+ }
+
+ /*!
+ @throw parse_error.106 if an array index begins with '0'
+ @throw parse_error.109 if an array index was not a number
+ */
+ bool contains(const BasicJsonType* ptr) const
+ {
+ for (const auto& reference_token : reference_tokens)
+ {
+ switch (ptr->type())
+ {
+ case detail::value_t::object:
+ {
+ if (!ptr->contains(reference_token))
+ {
+ // we did not find the key in the object
+ return false;
+ }
+
+ ptr = &ptr->operator[](reference_token);
+ break;
+ }
+
+ case detail::value_t::array:
+ {
+ if (JSON_HEDLEY_UNLIKELY(reference_token == "-"))
+ {
+ // "-" always fails the range check
+ return false;
+ }
+ if (JSON_HEDLEY_UNLIKELY(reference_token.size() == 1 && !("0" <= reference_token && reference_token <= "9")))
+ {
+ // invalid char
+ return false;
+ }
+ if (JSON_HEDLEY_UNLIKELY(reference_token.size() > 1))
+ {
+ if (JSON_HEDLEY_UNLIKELY(!('1' <= reference_token[0] && reference_token[0] <= '9')))
+ {
+ // first char should be between '1' and '9'
+ return false;
+ }
+ for (std::size_t i = 1; i < reference_token.size(); i++)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!('0' <= reference_token[i] && reference_token[i] <= '9')))
+ {
+ // other char should be between '0' and '9'
+ return false;
+ }
+ }
+ }
+
+ const auto idx = array_index(reference_token);
+ if (idx >= ptr->size())
+ {
+ // index out of range
+ return false;
+ }
+
+ ptr = &ptr->operator[](idx);
+ break;
+ }
+
+ case detail::value_t::null:
+ case detail::value_t::string:
+ case detail::value_t::boolean:
+ case detail::value_t::number_integer:
+ case detail::value_t::number_unsigned:
+ case detail::value_t::number_float:
+ case detail::value_t::binary:
+ case detail::value_t::discarded:
+ default:
+ {
+ // we do not expect primitive values if there is still a
+ // reference token to process
+ return false;
+ }
+ }
+ }
+
+ // no reference token left means we found a primitive value
+ return true;
+ }
+
+ /*!
+ @brief split the string input to reference tokens
+
+ @note This function is only called by the json_pointer constructor.
+ All exceptions below are documented there.
+
+ @throw parse_error.107 if the pointer is not empty or begins with '/'
+ @throw parse_error.108 if character '~' is not followed by '0' or '1'
+ */
+ static std::vector<std::string> split(const std::string& reference_string)
+ {
+ std::vector<std::string> result;
+
+ // special case: empty reference string -> no reference tokens
+ if (reference_string.empty())
+ {
+ return result;
+ }
+
+ // check if nonempty reference string begins with slash
+ if (JSON_HEDLEY_UNLIKELY(reference_string[0] != '/'))
+ {
+ JSON_THROW(detail::parse_error::create(107, 1, "JSON pointer must be empty or begin with '/' - was: '" + reference_string + "'", BasicJsonType()));
+ }
+
+ // extract the reference tokens:
+ // - slash: position of the last read slash (or end of string)
+ // - start: position after the previous slash
+ for (
+ // search for the first slash after the first character
+ std::size_t slash = reference_string.find_first_of('/', 1),
+ // set the beginning of the first reference token
+ start = 1;
+ // we can stop if start == 0 (if slash == std::string::npos)
+ start != 0;
+ // set the beginning of the next reference token
+ // (will eventually be 0 if slash == std::string::npos)
+ start = (slash == std::string::npos) ? 0 : slash + 1,
+ // find next slash
+ slash = reference_string.find_first_of('/', start))
+ {
+ // use the text between the beginning of the reference token
+ // (start) and the last slash (slash).
+ auto reference_token = reference_string.substr(start, slash - start);
+
+ // check reference tokens are properly escaped
+ for (std::size_t pos = reference_token.find_first_of('~');
+ pos != std::string::npos;
+ pos = reference_token.find_first_of('~', pos + 1))
+ {
+ JSON_ASSERT(reference_token[pos] == '~');
+
+ // ~ must be followed by 0 or 1
+ if (JSON_HEDLEY_UNLIKELY(pos == reference_token.size() - 1 ||
+ (reference_token[pos + 1] != '0' &&
+ reference_token[pos + 1] != '1')))
+ {
+ JSON_THROW(detail::parse_error::create(108, 0, "escape character '~' must be followed with '0' or '1'", BasicJsonType()));
+ }
+ }
+
+ // finally, store the reference token
+ detail::unescape(reference_token);
+ result.push_back(reference_token);
+ }
+
+ return result;
+ }
+
+ private:
+ /*!
+ @param[in] reference_string the reference string to the current value
+ @param[in] value the value to consider
+ @param[in,out] result the result object to insert values to
+
+ @note Empty objects or arrays are flattened to `null`.
+ */
+ static void flatten(const std::string& reference_string,
+ const BasicJsonType& value,
+ BasicJsonType& result)
+ {
+ switch (value.type())
+ {
+ case detail::value_t::array:
+ {
+ if (value.m_value.array->empty())
+ {
+ // flatten empty array as null
+ result[reference_string] = nullptr;
+ }
+ else
+ {
+ // iterate array and use index as reference string
+ for (std::size_t i = 0; i < value.m_value.array->size(); ++i)
+ {
+ flatten(reference_string + "/" + std::to_string(i),
+ value.m_value.array->operator[](i), result);
+ }
+ }
+ break;
+ }
+
+ case detail::value_t::object:
+ {
+ if (value.m_value.object->empty())
+ {
+ // flatten empty object as null
+ result[reference_string] = nullptr;
+ }
+ else
+ {
+ // iterate object and use keys as reference string
+ for (const auto& element : *value.m_value.object)
+ {
+ flatten(reference_string + "/" + detail::escape(element.first), element.second, result);
+ }
+ }
+ break;
+ }
+
+ case detail::value_t::null:
+ case detail::value_t::string:
+ case detail::value_t::boolean:
+ case detail::value_t::number_integer:
+ case detail::value_t::number_unsigned:
+ case detail::value_t::number_float:
+ case detail::value_t::binary:
+ case detail::value_t::discarded:
+ default:
+ {
+ // add primitive value with its reference string
+ result[reference_string] = value;
+ break;
+ }
+ }
+ }
+
+ /*!
+ @param[in] value flattened JSON
+
+ @return unflattened JSON
+
+ @throw parse_error.109 if array index is not a number
+ @throw type_error.314 if value is not an object
+ @throw type_error.315 if object values are not primitive
+ @throw type_error.313 if value cannot be unflattened
+ */
+ static BasicJsonType
+ unflatten(const BasicJsonType& value)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!value.is_object()))
+ {
+ JSON_THROW(detail::type_error::create(314, "only objects can be unflattened", value));
+ }
+
+ BasicJsonType result;
+
+ // iterate the JSON object values
+ for (const auto& element : *value.m_value.object)
+ {
+ if (JSON_HEDLEY_UNLIKELY(!element.second.is_primitive()))
+ {
+ JSON_THROW(detail::type_error::create(315, "values in object must be primitive", element.second));
+ }
+
+ // assign value to reference pointed to by JSON pointer; Note that if
+ // the JSON pointer is "" (i.e., points to the whole value), function
+ // get_and_create returns a reference to result itself. An assignment
+ // will then create a primitive value.
+ json_pointer(element.first).get_and_create(result) = element.second;
+ }
+
+ return result;
+ }
+
+ /*!
+ @brief compares two JSON pointers for equality
+
+ @param[in] lhs JSON pointer to compare
+ @param[in] rhs JSON pointer to compare
+ @return whether @a lhs is equal to @a rhs
+
+ @complexity Linear in the length of the JSON pointer
+
+ @exceptionsafety No-throw guarantee: this function never throws exceptions.
+ */
+ friend bool operator==(json_pointer const& lhs,
+ json_pointer const& rhs) noexcept
+ {
+ return lhs.reference_tokens == rhs.reference_tokens;
+ }
+
+ /*!
+ @brief compares two JSON pointers for inequality
+
+ @param[in] lhs JSON pointer to compare
+ @param[in] rhs JSON pointer to compare
+ @return whether @a lhs is not equal @a rhs
+
+ @complexity Linear in the length of the JSON pointer
+
+ @exceptionsafety No-throw guarantee: this function never throws exceptions.
+ */
+ friend bool operator!=(json_pointer const& lhs,
+ json_pointer const& rhs) noexcept
+ {
+ return !(lhs == rhs);
+ }
+
+ /// the reference tokens
+ std::vector<std::string> reference_tokens;
+};
+} // namespace nlohmann
+
+// #include <nlohmann/detail/json_ref.hpp>
+
+
+#include <initializer_list>
+#include <utility>
+
+// #include <nlohmann/detail/meta/type_traits.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+template<typename BasicJsonType>
+class json_ref
+{
+ public:
+ using value_type = BasicJsonType;
+
+ json_ref(value_type&& value)
+ : owned_value(std::move(value))
+ {}
+
+ json_ref(const value_type& value)
+ : value_ref(&value)
+ {}
+
+ json_ref(std::initializer_list<json_ref> init)
+ : owned_value(init)
+ {}
+
+ template <
+ class... Args,
+ enable_if_t<std::is_constructible<value_type, Args...>::value, int> = 0 >
+ json_ref(Args && ... args)
+ : owned_value(std::forward<Args>(args)...)
+ {}
+
+ // class should be movable only
+ json_ref(json_ref&&) noexcept = default;
+ json_ref(const json_ref&) = delete;
+ json_ref& operator=(const json_ref&) = delete;
+ json_ref& operator=(json_ref&&) = delete;
+ ~json_ref() = default;
+
+ value_type moved_or_copied() const
+ {
+ if (value_ref == nullptr)
+ {
+ return std::move(owned_value);
+ }
+ return *value_ref;
+ }
+
+ value_type const& operator*() const
+ {
+ return value_ref ? *value_ref : owned_value;
+ }
+
+ value_type const* operator->() const
+ {
+ return &** this;
+ }
+
+ private:
+ mutable value_type owned_value = nullptr;
+ value_type const* value_ref = nullptr;
+};
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+// #include <nlohmann/detail/string_escape.hpp>
+
+// #include <nlohmann/detail/meta/cpp_future.hpp>
+
+// #include <nlohmann/detail/meta/type_traits.hpp>
+
+// #include <nlohmann/detail/output/binary_writer.hpp>
+
+
+#include <algorithm> // reverse
+#include <array> // array
+#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 <nlohmann/detail/input/binary_reader.hpp>
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+// #include <nlohmann/detail/output/output_adapters.hpp>
+
+
+#include <algorithm> // copy
+#include <cstddef> // size_t
+#include <iterator> // back_inserter
+#include <memory> // shared_ptr, make_shared
+#include <string> // basic_string
+#include <vector> // vector
+
+#ifndef JSON_NO_IO
+ #include <ios> // streamsize
+ #include <ostream> // basic_ostream
+#endif // JSON_NO_IO
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+/// abstract output adapter interface
+template<typename CharType> struct output_adapter_protocol
+{
+ virtual void write_character(CharType c) = 0;
+ virtual void write_characters(const CharType* s, std::size_t length) = 0;
+ virtual ~output_adapter_protocol() = default;
+
+ output_adapter_protocol() = default;
+ output_adapter_protocol(const output_adapter_protocol&) = default;
+ output_adapter_protocol(output_adapter_protocol&&) noexcept = default;
+ output_adapter_protocol& operator=(const output_adapter_protocol&) = default;
+ output_adapter_protocol& operator=(output_adapter_protocol&&) noexcept = default;
+};
+
+/// a type to simplify interfaces
+template<typename CharType>
+using output_adapter_t = std::shared_ptr<output_adapter_protocol<CharType>>;
+
+/// output adapter for byte vectors
+template<typename CharType, typename AllocatorType = std::allocator<CharType>>
+class output_vector_adapter : public output_adapter_protocol<CharType>
+{
+ public:
+ explicit output_vector_adapter(std::vector<CharType, AllocatorType>& vec) noexcept
+ : v(vec)
+ {}
+
+ void write_character(CharType c) override
+ {
+ v.push_back(c);
+ }
+
+ JSON_HEDLEY_NON_NULL(2)
+ void write_characters(const CharType* s, std::size_t length) override
+ {
+ std::copy(s, s + length, std::back_inserter(v));
+ }
+
+ private:
+ std::vector<CharType, AllocatorType>& v;
+};
+
+#ifndef JSON_NO_IO
+/// output adapter for output streams
+template<typename CharType>
+class output_stream_adapter : public output_adapter_protocol<CharType>
+{
+ public:
+ explicit output_stream_adapter(std::basic_ostream<CharType>& s) noexcept
+ : stream(s)
+ {}
+
+ void write_character(CharType c) override
+ {
+ stream.put(c);
+ }
+
+ JSON_HEDLEY_NON_NULL(2)
+ void write_characters(const CharType* s, std::size_t length) override
+ {
+ stream.write(s, static_cast<std::streamsize>(length));
+ }
+
+ private:
+ std::basic_ostream<CharType>& stream;
+};
+#endif // JSON_NO_IO
+
+/// output adapter for basic_string
+template<typename CharType, typename StringType = std::basic_string<CharType>>
+class output_string_adapter : public output_adapter_protocol<CharType>
+{
+ public:
+ explicit output_string_adapter(StringType& s) noexcept
+ : str(s)
+ {}
+
+ void write_character(CharType c) override
+ {
+ str.push_back(c);
+ }
+
+ JSON_HEDLEY_NON_NULL(2)
+ void write_characters(const CharType* s, std::size_t length) override
+ {
+ str.append(s, length);
+ }
+
+ private:
+ StringType& str;
+};
+
+template<typename CharType, typename StringType = std::basic_string<CharType>>
+class output_adapter
+{
+ public:
+ template<typename AllocatorType = std::allocator<CharType>>
+ output_adapter(std::vector<CharType, AllocatorType>& vec)
+ : oa(std::make_shared<output_vector_adapter<CharType, AllocatorType>>(vec)) {}
+
+#ifndef JSON_NO_IO
+ output_adapter(std::basic_ostream<CharType>& s)
+ : oa(std::make_shared<output_stream_adapter<CharType>>(s)) {}
+#endif // JSON_NO_IO
+
+ output_adapter(StringType& s)
+ : oa(std::make_shared<output_string_adapter<CharType, StringType>>(s)) {}
+
+ operator output_adapter_t<CharType>()
+ {
+ return oa;
+ }
+
+ private:
+ output_adapter_t<CharType> oa = nullptr;
+};
+} // namespace detail
+} // namespace nlohmann
+
+
+namespace nlohmann
+{
+namespace detail
+{
+///////////////////
+// binary writer //
+///////////////////
+
+/*!
+@brief serialization to CBOR and MessagePack values
+*/
+template<typename BasicJsonType, typename CharType>
+class binary_writer
+{
+ using string_t = typename BasicJsonType::string_t;
+ using binary_t = typename BasicJsonType::binary_t;
+ using number_float_t = typename BasicJsonType::number_float_t;
+
+ public:
+ /*!
+ @brief create a binary writer
+
+ @param[in] adapter output adapter to write to
+ */
+ explicit binary_writer(output_adapter_t<CharType> adapter) : oa(std::move(adapter))
+ {
+ JSON_ASSERT(oa);
+ }
+
+ /*!
+ @param[in] j JSON value to serialize
+ @pre j.type() == value_t::object
+ */
+ void write_bson(const BasicJsonType& j)
+ {
+ switch (j.type())
+ {
+ case value_t::object:
+ {
+ write_bson_object(*j.m_value.object);
+ break;
+ }
+
+ case value_t::null:
+ case value_t::array:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ {
+ JSON_THROW(type_error::create(317, "to serialize to BSON, top-level type must be object, but is " + std::string(j.type_name()), j));
+ }
+ }
+ }
+
+ /*!
+ @param[in] j JSON value to serialize
+ */
+ void write_cbor(const BasicJsonType& j)
+ {
+ switch (j.type())
+ {
+ case value_t::null:
+ {
+ oa->write_character(to_char_type(0xF6));
+ break;
+ }
+
+ case value_t::boolean:
+ {
+ oa->write_character(j.m_value.boolean
+ ? to_char_type(0xF5)
+ : to_char_type(0xF4));
+ break;
+ }
+
+ case value_t::number_integer:
+ {
+ if (j.m_value.number_integer >= 0)
+ {
+ // CBOR does not differentiate between positive signed
+ // integers and unsigned integers. Therefore, we used the
+ // code from the value_t::number_unsigned case here.
+ if (j.m_value.number_integer <= 0x17)
+ {
+ write_number(static_cast<std::uint8_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_integer <= (std::numeric_limits<std::uint8_t>::max)())
+ {
+ oa->write_character(to_char_type(0x18));
+ write_number(static_cast<std::uint8_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_integer <= (std::numeric_limits<std::uint16_t>::max)())
+ {
+ oa->write_character(to_char_type(0x19));
+ write_number(static_cast<std::uint16_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_integer <= (std::numeric_limits<std::uint32_t>::max)())
+ {
+ oa->write_character(to_char_type(0x1A));
+ write_number(static_cast<std::uint32_t>(j.m_value.number_integer));
+ }
+ else
+ {
+ oa->write_character(to_char_type(0x1B));
+ write_number(static_cast<std::uint64_t>(j.m_value.number_integer));
+ }
+ }
+ else
+ {
+ // The conversions below encode the sign in the first
+ // byte, and the value is converted to a positive number.
+ const auto positive_number = -1 - j.m_value.number_integer;
+ if (j.m_value.number_integer >= -24)
+ {
+ write_number(static_cast<std::uint8_t>(0x20 + positive_number));
+ }
+ else if (positive_number <= (std::numeric_limits<std::uint8_t>::max)())
+ {
+ oa->write_character(to_char_type(0x38));
+ write_number(static_cast<std::uint8_t>(positive_number));
+ }
+ else if (positive_number <= (std::numeric_limits<std::uint16_t>::max)())
+ {
+ oa->write_character(to_char_type(0x39));
+ write_number(static_cast<std::uint16_t>(positive_number));
+ }
+ else if (positive_number <= (std::numeric_limits<std::uint32_t>::max)())
+ {
+ oa->write_character(to_char_type(0x3A));
+ write_number(static_cast<std::uint32_t>(positive_number));
+ }
+ else
+ {
+ oa->write_character(to_char_type(0x3B));
+ write_number(static_cast<std::uint64_t>(positive_number));
+ }
+ }
+ break;
+ }
+
+ case value_t::number_unsigned:
+ {
+ if (j.m_value.number_unsigned <= 0x17)
+ {
+ write_number(static_cast<std::uint8_t>(j.m_value.number_unsigned));
+ }
+ else if (j.m_value.number_unsigned <= (std::numeric_limits<std::uint8_t>::max)())
+ {
+ oa->write_character(to_char_type(0x18));
+ write_number(static_cast<std::uint8_t>(j.m_value.number_unsigned));
+ }
+ else if (j.m_value.number_unsigned <= (std::numeric_limits<std::uint16_t>::max)())
+ {
+ oa->write_character(to_char_type(0x19));
+ write_number(static_cast<std::uint16_t>(j.m_value.number_unsigned));
+ }
+ else if (j.m_value.number_unsigned <= (std::numeric_limits<std::uint32_t>::max)())
+ {
+ oa->write_character(to_char_type(0x1A));
+ write_number(static_cast<std::uint32_t>(j.m_value.number_unsigned));
+ }
+ else
+ {
+ oa->write_character(to_char_type(0x1B));
+ write_number(static_cast<std::uint64_t>(j.m_value.number_unsigned));
+ }
+ break;
+ }
+
+ case value_t::number_float:
+ {
+ if (std::isnan(j.m_value.number_float))
+ {
+ // NaN is 0xf97e00 in CBOR
+ oa->write_character(to_char_type(0xF9));
+ oa->write_character(to_char_type(0x7E));
+ oa->write_character(to_char_type(0x00));
+ }
+ else if (std::isinf(j.m_value.number_float))
+ {
+ // Infinity is 0xf97c00, -Infinity is 0xf9fc00
+ oa->write_character(to_char_type(0xf9));
+ oa->write_character(j.m_value.number_float > 0 ? to_char_type(0x7C) : to_char_type(0xFC));
+ oa->write_character(to_char_type(0x00));
+ }
+ else
+ {
+ write_compact_float(j.m_value.number_float, detail::input_format_t::cbor);
+ }
+ break;
+ }
+
+ case value_t::string:
+ {
+ // step 1: write control byte and the string length
+ const auto N = j.m_value.string->size();
+ if (N <= 0x17)
+ {
+ write_number(static_cast<std::uint8_t>(0x60 + N));
+ }
+ else if (N <= (std::numeric_limits<std::uint8_t>::max)())
+ {
+ oa->write_character(to_char_type(0x78));
+ write_number(static_cast<std::uint8_t>(N));
+ }
+ else if (N <= (std::numeric_limits<std::uint16_t>::max)())
+ {
+ oa->write_character(to_char_type(0x79));
+ write_number(static_cast<std::uint16_t>(N));
+ }
+ else if (N <= (std::numeric_limits<std::uint32_t>::max)())
+ {
+ oa->write_character(to_char_type(0x7A));
+ write_number(static_cast<std::uint32_t>(N));
+ }
+ // LCOV_EXCL_START
+ else if (N <= (std::numeric_limits<std::uint64_t>::max)())
+ {
+ oa->write_character(to_char_type(0x7B));
+ write_number(static_cast<std::uint64_t>(N));
+ }
+ // LCOV_EXCL_STOP
+
+ // step 2: write the string
+ oa->write_characters(
+ reinterpret_cast<const CharType*>(j.m_value.string->c_str()),
+ j.m_value.string->size());
+ break;
+ }
+
+ case value_t::array:
+ {
+ // step 1: write control byte and the array size
+ const auto N = j.m_value.array->size();
+ if (N <= 0x17)
+ {
+ write_number(static_cast<std::uint8_t>(0x80 + N));
+ }
+ else if (N <= (std::numeric_limits<std::uint8_t>::max)())
+ {
+ oa->write_character(to_char_type(0x98));
+ write_number(static_cast<std::uint8_t>(N));
+ }
+ else if (N <= (std::numeric_limits<std::uint16_t>::max)())
+ {
+ oa->write_character(to_char_type(0x99));
+ write_number(static_cast<std::uint16_t>(N));
+ }
+ else if (N <= (std::numeric_limits<std::uint32_t>::max)())
+ {
+ oa->write_character(to_char_type(0x9A));
+ write_number(static_cast<std::uint32_t>(N));
+ }
+ // LCOV_EXCL_START
+ else if (N <= (std::numeric_limits<std::uint64_t>::max)())
+ {
+ oa->write_character(to_char_type(0x9B));
+ write_number(static_cast<std::uint64_t>(N));
+ }
+ // LCOV_EXCL_STOP
+
+ // step 2: write each element
+ for (const auto& el : *j.m_value.array)
+ {
+ write_cbor(el);
+ }
+ break;
+ }
+
+ case value_t::binary:
+ {
+ if (j.m_value.binary->has_subtype())
+ {
+ if (j.m_value.binary->subtype() <= (std::numeric_limits<std::uint8_t>::max)())
+ {
+ write_number(static_cast<std::uint8_t>(0xd8));
+ write_number(static_cast<std::uint8_t>(j.m_value.binary->subtype()));
+ }
+ else if (j.m_value.binary->subtype() <= (std::numeric_limits<std::uint16_t>::max)())
+ {
+ write_number(static_cast<std::uint8_t>(0xd9));
+ write_number(static_cast<std::uint16_t>(j.m_value.binary->subtype()));
+ }
+ else if (j.m_value.binary->subtype() <= (std::numeric_limits<std::uint32_t>::max)())
+ {
+ write_number(static_cast<std::uint8_t>(0xda));
+ write_number(static_cast<std::uint32_t>(j.m_value.binary->subtype()));
+ }
+ else if (j.m_value.binary->subtype() <= (std::numeric_limits<std::uint64_t>::max)())
+ {
+ write_number(static_cast<std::uint8_t>(0xdb));
+ write_number(static_cast<std::uint64_t>(j.m_value.binary->subtype()));
+ }
+ }
+
+ // step 1: write control byte and the binary array size
+ const auto N = j.m_value.binary->size();
+ if (N <= 0x17)
+ {
+ write_number(static_cast<std::uint8_t>(0x40 + N));
+ }
+ else if (N <= (std::numeric_limits<std::uint8_t>::max)())
+ {
+ oa->write_character(to_char_type(0x58));
+ write_number(static_cast<std::uint8_t>(N));
+ }
+ else if (N <= (std::numeric_limits<std::uint16_t>::max)())
+ {
+ oa->write_character(to_char_type(0x59));
+ write_number(static_cast<std::uint16_t>(N));
+ }
+ else if (N <= (std::numeric_limits<std::uint32_t>::max)())
+ {
+ oa->write_character(to_char_type(0x5A));
+ write_number(static_cast<std::uint32_t>(N));
+ }
+ // LCOV_EXCL_START
+ else if (N <= (std::numeric_limits<std::uint64_t>::max)())
+ {
+ oa->write_character(to_char_type(0x5B));
+ write_number(static_cast<std::uint64_t>(N));
+ }
+ // LCOV_EXCL_STOP
+
+ // step 2: write each element
+ oa->write_characters(
+ reinterpret_cast<const CharType*>(j.m_value.binary->data()),
+ N);
+
+ break;
+ }
+
+ case value_t::object:
+ {
+ // step 1: write control byte and the object size
+ const auto N = j.m_value.object->size();
+ if (N <= 0x17)
+ {
+ write_number(static_cast<std::uint8_t>(0xA0 + N));
+ }
+ else if (N <= (std::numeric_limits<std::uint8_t>::max)())
+ {
+ oa->write_character(to_char_type(0xB8));
+ write_number(static_cast<std::uint8_t>(N));
+ }
+ else if (N <= (std::numeric_limits<std::uint16_t>::max)())
+ {
+ oa->write_character(to_char_type(0xB9));
+ write_number(static_cast<std::uint16_t>(N));
+ }
+ else if (N <= (std::numeric_limits<std::uint32_t>::max)())
+ {
+ oa->write_character(to_char_type(0xBA));
+ write_number(static_cast<std::uint32_t>(N));
+ }
+ // LCOV_EXCL_START
+ else if (N <= (std::numeric_limits<std::uint64_t>::max)())
+ {
+ oa->write_character(to_char_type(0xBB));
+ write_number(static_cast<std::uint64_t>(N));
+ }
+ // LCOV_EXCL_STOP
+
+ // step 2: write each element
+ for (const auto& el : *j.m_value.object)
+ {
+ write_cbor(el.first);
+ write_cbor(el.second);
+ }
+ break;
+ }
+
+ case value_t::discarded:
+ default:
+ break;
+ }
+ }
+
+ /*!
+ @param[in] j JSON value to serialize
+ */
+ void write_msgpack(const BasicJsonType& j)
+ {
+ switch (j.type())
+ {
+ case value_t::null: // nil
+ {
+ oa->write_character(to_char_type(0xC0));
+ break;
+ }
+
+ case value_t::boolean: // true and false
+ {
+ oa->write_character(j.m_value.boolean
+ ? to_char_type(0xC3)
+ : to_char_type(0xC2));
+ break;
+ }
+
+ case value_t::number_integer:
+ {
+ if (j.m_value.number_integer >= 0)
+ {
+ // MessagePack does not differentiate between positive
+ // signed integers and unsigned integers. Therefore, we used
+ // the code from the value_t::number_unsigned case here.
+ if (j.m_value.number_unsigned < 128)
+ {
+ // positive fixnum
+ write_number(static_cast<std::uint8_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_unsigned <= (std::numeric_limits<std::uint8_t>::max)())
+ {
+ // uint 8
+ oa->write_character(to_char_type(0xCC));
+ write_number(static_cast<std::uint8_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_unsigned <= (std::numeric_limits<std::uint16_t>::max)())
+ {
+ // uint 16
+ oa->write_character(to_char_type(0xCD));
+ write_number(static_cast<std::uint16_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_unsigned <= (std::numeric_limits<std::uint32_t>::max)())
+ {
+ // uint 32
+ oa->write_character(to_char_type(0xCE));
+ write_number(static_cast<std::uint32_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_unsigned <= (std::numeric_limits<std::uint64_t>::max)())
+ {
+ // uint 64
+ oa->write_character(to_char_type(0xCF));
+ write_number(static_cast<std::uint64_t>(j.m_value.number_integer));
+ }
+ }
+ else
+ {
+ if (j.m_value.number_integer >= -32)
+ {
+ // negative fixnum
+ write_number(static_cast<std::int8_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_integer >= (std::numeric_limits<std::int8_t>::min)() &&
+ j.m_value.number_integer <= (std::numeric_limits<std::int8_t>::max)())
+ {
+ // int 8
+ oa->write_character(to_char_type(0xD0));
+ write_number(static_cast<std::int8_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_integer >= (std::numeric_limits<std::int16_t>::min)() &&
+ j.m_value.number_integer <= (std::numeric_limits<std::int16_t>::max)())
+ {
+ // int 16
+ oa->write_character(to_char_type(0xD1));
+ write_number(static_cast<std::int16_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_integer >= (std::numeric_limits<std::int32_t>::min)() &&
+ j.m_value.number_integer <= (std::numeric_limits<std::int32_t>::max)())
+ {
+ // int 32
+ oa->write_character(to_char_type(0xD2));
+ write_number(static_cast<std::int32_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_integer >= (std::numeric_limits<std::int64_t>::min)() &&
+ j.m_value.number_integer <= (std::numeric_limits<std::int64_t>::max)())
+ {
+ // int 64
+ oa->write_character(to_char_type(0xD3));
+ write_number(static_cast<std::int64_t>(j.m_value.number_integer));
+ }
+ }
+ break;
+ }
+
+ case value_t::number_unsigned:
+ {
+ if (j.m_value.number_unsigned < 128)
+ {
+ // positive fixnum
+ write_number(static_cast<std::uint8_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_unsigned <= (std::numeric_limits<std::uint8_t>::max)())
+ {
+ // uint 8
+ oa->write_character(to_char_type(0xCC));
+ write_number(static_cast<std::uint8_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_unsigned <= (std::numeric_limits<std::uint16_t>::max)())
+ {
+ // uint 16
+ oa->write_character(to_char_type(0xCD));
+ write_number(static_cast<std::uint16_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_unsigned <= (std::numeric_limits<std::uint32_t>::max)())
+ {
+ // uint 32
+ oa->write_character(to_char_type(0xCE));
+ write_number(static_cast<std::uint32_t>(j.m_value.number_integer));
+ }
+ else if (j.m_value.number_unsigned <= (std::numeric_limits<std::uint64_t>::max)())
+ {
+ // uint 64
+ oa->write_character(to_char_type(0xCF));
+ write_number(static_cast<std::uint64_t>(j.m_value.number_integer));
+ }
+ break;
+ }
+
+ case value_t::number_float:
+ {
+ write_compact_float(j.m_value.number_float, detail::input_format_t::msgpack);
+ break;
+ }
+
+ case value_t::string:
+ {
+ // step 1: write control byte and the string length
+ const auto N = j.m_value.string->size();
+ if (N <= 31)
+ {
+ // fixstr
+ write_number(static_cast<std::uint8_t>(0xA0 | N));
+ }
+ else if (N <= (std::numeric_limits<std::uint8_t>::max)())
+ {
+ // str 8
+ oa->write_character(to_char_type(0xD9));
+ write_number(static_cast<std::uint8_t>(N));
+ }
+ else if (N <= (std::numeric_limits<std::uint16_t>::max)())
+ {
+ // str 16
+ oa->write_character(to_char_type(0xDA));
+ write_number(static_cast<std::uint16_t>(N));
+ }
+ else if (N <= (std::numeric_limits<std::uint32_t>::max)())
+ {
+ // str 32
+ oa->write_character(to_char_type(0xDB));
+ write_number(static_cast<std::uint32_t>(N));
+ }
+
+ // step 2: write the string
+ oa->write_characters(
+ reinterpret_cast<const CharType*>(j.m_value.string->c_str()),
+ j.m_value.string->size());
+ break;
+ }
+
+ case value_t::array:
+ {
+ // step 1: write control byte and the array size
+ const auto N = j.m_value.array->size();
+ if (N <= 15)
+ {
+ // fixarray
+ write_number(static_cast<std::uint8_t>(0x90 | N));
+ }
+ else if (N <= (std::numeric_limits<std::uint16_t>::max)())
+ {
+ // array 16
+ oa->write_character(to_char_type(0xDC));
+ write_number(static_cast<std::uint16_t>(N));
+ }
+ else if (N <= (std::numeric_limits<std::uint32_t>::max)())
+ {
+ // array 32
+ oa->write_character(to_char_type(0xDD));
+ write_number(static_cast<std::uint32_t>(N));
+ }
+
+ // step 2: write each element
+ for (const auto& el : *j.m_value.array)
+ {
+ write_msgpack(el);
+ }
+ break;
+ }
+
+ case value_t::binary:
+ {
+ // step 0: determine if the binary type has a set subtype to
+ // determine whether or not to use the ext or fixext types
+ const bool use_ext = j.m_value.binary->has_subtype();
+
+ // step 1: write control byte and the byte string length
+ const auto N = j.m_value.binary->size();
+ if (N <= (std::numeric_limits<std::uint8_t>::max)())
+ {
+ std::uint8_t output_type{};
+ bool fixed = true;
+ if (use_ext)
+ {
+ switch (N)
+ {
+ case 1:
+ output_type = 0xD4; // fixext 1
+ break;
+ case 2:
+ output_type = 0xD5; // fixext 2
+ break;
+ case 4:
+ output_type = 0xD6; // fixext 4
+ break;
+ case 8:
+ output_type = 0xD7; // fixext 8
+ break;
+ case 16:
+ output_type = 0xD8; // fixext 16
+ break;
+ default:
+ output_type = 0xC7; // ext 8
+ fixed = false;
+ break;
+ }
+
+ }
+ else
+ {
+ output_type = 0xC4; // bin 8
+ fixed = false;
+ }
+
+ oa->write_character(to_char_type(output_type));
+ if (!fixed)
+ {
+ write_number(static_cast<std::uint8_t>(N));
+ }
+ }
+ else if (N <= (std::numeric_limits<std::uint16_t>::max)())
+ {
+ std::uint8_t output_type = use_ext
+ ? 0xC8 // ext 16
+ : 0xC5; // bin 16
+
+ oa->write_character(to_char_type(output_type));
+ write_number(static_cast<std::uint16_t>(N));
+ }
+ else if (N <= (std::numeric_limits<std::uint32_t>::max)())
+ {
+ std::uint8_t output_type = use_ext
+ ? 0xC9 // ext 32
+ : 0xC6; // bin 32
+
+ oa->write_character(to_char_type(output_type));
+ write_number(static_cast<std::uint32_t>(N));
+ }
+
+ // step 1.5: if this is an ext type, write the subtype
+ if (use_ext)
+ {
+ write_number(static_cast<std::int8_t>(j.m_value.binary->subtype()));
+ }
+
+ // step 2: write the byte string
+ oa->write_characters(
+ reinterpret_cast<const CharType*>(j.m_value.binary->data()),
+ N);
+
+ break;
+ }
+
+ case value_t::object:
+ {
+ // step 1: write control byte and the object size
+ const auto N = j.m_value.object->size();
+ if (N <= 15)
+ {
+ // fixmap
+ write_number(static_cast<std::uint8_t>(0x80 | (N & 0xF)));
+ }
+ else if (N <= (std::numeric_limits<std::uint16_t>::max)())
+ {
+ // map 16
+ oa->write_character(to_char_type(0xDE));
+ write_number(static_cast<std::uint16_t>(N));
+ }
+ else if (N <= (std::numeric_limits<std::uint32_t>::max)())
+ {
+ // map 32
+ oa->write_character(to_char_type(0xDF));
+ write_number(static_cast<std::uint32_t>(N));
+ }
+
+ // step 2: write each element
+ for (const auto& el : *j.m_value.object)
+ {
+ write_msgpack(el.first);
+ write_msgpack(el.second);
+ }
+ break;
+ }
+
+ case value_t::discarded:
+ default:
+ break;
+ }
+ }
+
+ /*!
+ @param[in] j JSON value to serialize
+ @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
+ */
+ void write_ubjson(const BasicJsonType& j, const bool use_count,
+ const bool use_type, const bool add_prefix = true)
+ {
+ switch (j.type())
+ {
+ case value_t::null:
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('Z'));
+ }
+ break;
+ }
+
+ case value_t::boolean:
+ {
+ if (add_prefix)
+ {
+ oa->write_character(j.m_value.boolean
+ ? to_char_type('T')
+ : to_char_type('F'));
+ }
+ break;
+ }
+
+ case value_t::number_integer:
+ {
+ write_number_with_ubjson_prefix(j.m_value.number_integer, add_prefix);
+ break;
+ }
+
+ case value_t::number_unsigned:
+ {
+ write_number_with_ubjson_prefix(j.m_value.number_unsigned, add_prefix);
+ break;
+ }
+
+ case value_t::number_float:
+ {
+ write_number_with_ubjson_prefix(j.m_value.number_float, add_prefix);
+ break;
+ }
+
+ case value_t::string:
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('S'));
+ }
+ write_number_with_ubjson_prefix(j.m_value.string->size(), true);
+ oa->write_characters(
+ reinterpret_cast<const CharType*>(j.m_value.string->c_str()),
+ j.m_value.string->size());
+ break;
+ }
+
+ case value_t::array:
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('['));
+ }
+
+ bool prefix_required = true;
+ if (use_type && !j.m_value.array->empty())
+ {
+ JSON_ASSERT(use_count);
+ const CharType first_prefix = ubjson_prefix(j.front());
+ const bool same_prefix = std::all_of(j.begin() + 1, j.end(),
+ [this, first_prefix](const BasicJsonType & v)
+ {
+ return ubjson_prefix(v) == first_prefix;
+ });
+
+ if (same_prefix)
+ {
+ prefix_required = false;
+ oa->write_character(to_char_type('$'));
+ oa->write_character(first_prefix);
+ }
+ }
+
+ if (use_count)
+ {
+ oa->write_character(to_char_type('#'));
+ write_number_with_ubjson_prefix(j.m_value.array->size(), true);
+ }
+
+ for (const auto& el : *j.m_value.array)
+ {
+ write_ubjson(el, use_count, use_type, prefix_required);
+ }
+
+ if (!use_count)
+ {
+ oa->write_character(to_char_type(']'));
+ }
+
+ break;
+ }
+
+ case value_t::binary:
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('['));
+ }
+
+ if (use_type && !j.m_value.binary->empty())
+ {
+ JSON_ASSERT(use_count);
+ oa->write_character(to_char_type('$'));
+ oa->write_character('U');
+ }
+
+ if (use_count)
+ {
+ oa->write_character(to_char_type('#'));
+ write_number_with_ubjson_prefix(j.m_value.binary->size(), true);
+ }
+
+ if (use_type)
+ {
+ oa->write_characters(
+ reinterpret_cast<const CharType*>(j.m_value.binary->data()),
+ j.m_value.binary->size());
+ }
+ else
+ {
+ for (size_t i = 0; i < j.m_value.binary->size(); ++i)
+ {
+ oa->write_character(to_char_type('U'));
+ oa->write_character(j.m_value.binary->data()[i]);
+ }
+ }
+
+ if (!use_count)
+ {
+ oa->write_character(to_char_type(']'));
+ }
+
+ break;
+ }
+
+ case value_t::object:
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('{'));
+ }
+
+ bool prefix_required = true;
+ if (use_type && !j.m_value.object->empty())
+ {
+ JSON_ASSERT(use_count);
+ const CharType first_prefix = ubjson_prefix(j.front());
+ const bool same_prefix = std::all_of(j.begin(), j.end(),
+ [this, first_prefix](const BasicJsonType & v)
+ {
+ return ubjson_prefix(v) == first_prefix;
+ });
+
+ if (same_prefix)
+ {
+ prefix_required = false;
+ oa->write_character(to_char_type('$'));
+ oa->write_character(first_prefix);
+ }
+ }
+
+ if (use_count)
+ {
+ oa->write_character(to_char_type('#'));
+ write_number_with_ubjson_prefix(j.m_value.object->size(), true);
+ }
+
+ for (const auto& el : *j.m_value.object)
+ {
+ write_number_with_ubjson_prefix(el.first.size(), true);
+ oa->write_characters(
+ reinterpret_cast<const CharType*>(el.first.c_str()),
+ el.first.size());
+ write_ubjson(el.second, use_count, use_type, prefix_required);
+ }
+
+ if (!use_count)
+ {
+ oa->write_character(to_char_type('}'));
+ }
+
+ break;
+ }
+
+ case value_t::discarded:
+ default:
+ break;
+ }
+ }
+
+ private:
+ //////////
+ // BSON //
+ //////////
+
+ /*!
+ @return The size of a BSON document entry header, including the id marker
+ and the entry name size (and its null-terminator).
+ */
+ static std::size_t calc_bson_entry_header_size(const string_t& name, const BasicJsonType& j)
+ {
+ const auto it = name.find(static_cast<typename string_t::value_type>(0));
+ if (JSON_HEDLEY_UNLIKELY(it != BasicJsonType::string_t::npos))
+ {
+ JSON_THROW(out_of_range::create(409, "BSON key cannot contain code point U+0000 (at byte " + std::to_string(it) + ")", j));
+ static_cast<void>(j);
+ }
+
+ return /*id*/ 1ul + name.size() + /*zero-terminator*/1u;
+ }
+
+ /*!
+ @brief Writes the given @a element_type and @a name to the output adapter
+ */
+ void write_bson_entry_header(const string_t& name,
+ const std::uint8_t element_type)
+ {
+ oa->write_character(to_char_type(element_type)); // boolean
+ oa->write_characters(
+ reinterpret_cast<const CharType*>(name.c_str()),
+ name.size() + 1u);
+ }
+
+ /*!
+ @brief Writes a BSON element with key @a name and boolean value @a value
+ */
+ void write_bson_boolean(const string_t& name,
+ const bool value)
+ {
+ write_bson_entry_header(name, 0x08);
+ oa->write_character(value ? to_char_type(0x01) : to_char_type(0x00));
+ }
+
+ /*!
+ @brief Writes a BSON element with key @a name and double value @a value
+ */
+ void write_bson_double(const string_t& name,
+ const double value)
+ {
+ write_bson_entry_header(name, 0x01);
+ write_number<double, true>(value);
+ }
+
+ /*!
+ @return The size of the BSON-encoded string in @a value
+ */
+ static std::size_t calc_bson_string_size(const string_t& value)
+ {
+ return sizeof(std::int32_t) + value.size() + 1ul;
+ }
+
+ /*!
+ @brief Writes a BSON element with key @a name and string value @a value
+ */
+ void write_bson_string(const string_t& name,
+ const string_t& value)
+ {
+ write_bson_entry_header(name, 0x02);
+
+ write_number<std::int32_t, true>(static_cast<std::int32_t>(value.size() + 1ul));
+ oa->write_characters(
+ reinterpret_cast<const CharType*>(value.c_str()),
+ value.size() + 1);
+ }
+
+ /*!
+ @brief Writes a BSON element with key @a name and null value
+ */
+ void write_bson_null(const string_t& name)
+ {
+ write_bson_entry_header(name, 0x0A);
+ }
+
+ /*!
+ @return The size of the BSON-encoded integer @a value
+ */
+ static std::size_t calc_bson_integer_size(const std::int64_t value)
+ {
+ return (std::numeric_limits<std::int32_t>::min)() <= value && value <= (std::numeric_limits<std::int32_t>::max)()
+ ? sizeof(std::int32_t)
+ : sizeof(std::int64_t);
+ }
+
+ /*!
+ @brief Writes a BSON element with key @a name and integer @a value
+ */
+ void write_bson_integer(const string_t& name,
+ const std::int64_t value)
+ {
+ 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));
+ }
+ else
+ {
+ write_bson_entry_header(name, 0x12); // int64
+ write_number<std::int64_t, true>(static_cast<std::int64_t>(value));
+ }
+ }
+
+ /*!
+ @return The size of the BSON-encoded unsigned integer in @a j
+ */
+ static constexpr std::size_t calc_bson_unsigned_size(const std::uint64_t value) noexcept
+ {
+ return (value <= static_cast<std::uint64_t>((std::numeric_limits<std::int32_t>::max)()))
+ ? sizeof(std::int32_t)
+ : sizeof(std::int64_t);
+ }
+
+ /*!
+ @brief Writes a BSON element with key @a name and unsigned @a value
+ */
+ void write_bson_unsigned(const string_t& name,
+ const BasicJsonType& j)
+ {
+ 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));
+ }
+ 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));
+ }
+ else
+ {
+ JSON_THROW(out_of_range::create(407, "integer number " + std::to_string(j.m_value.number_unsigned) + " cannot be represented by BSON as it does not fit int64", j));
+ }
+ }
+
+ /*!
+ @brief Writes a BSON element with key @a name and object @a value
+ */
+ void write_bson_object_entry(const string_t& name,
+ const typename BasicJsonType::object_t& value)
+ {
+ write_bson_entry_header(name, 0x03); // object
+ write_bson_object(value);
+ }
+
+ /*!
+ @return The size of the BSON-encoded array @a value
+ */
+ static std::size_t calc_bson_array_size(const typename BasicJsonType::array_t& value)
+ {
+ std::size_t array_index = 0ul;
+
+ const std::size_t embedded_document_size = std::accumulate(std::begin(value), std::end(value), static_cast<std::size_t>(0), [&array_index](std::size_t result, const typename BasicJsonType::array_t::value_type & el)
+ {
+ return result + calc_bson_element_size(std::to_string(array_index++), el);
+ });
+
+ return sizeof(std::int32_t) + embedded_document_size + 1ul;
+ }
+
+ /*!
+ @return The size of the BSON-encoded binary array @a value
+ */
+ static std::size_t calc_bson_binary_size(const typename BasicJsonType::binary_t& value)
+ {
+ return sizeof(std::int32_t) + value.size() + 1ul;
+ }
+
+ /*!
+ @brief Writes a BSON element with key @a name and array @a value
+ */
+ void write_bson_array(const string_t& name,
+ 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)));
+
+ std::size_t array_index = 0ul;
+
+ for (const auto& el : value)
+ {
+ write_bson_element(std::to_string(array_index++), el);
+ }
+
+ oa->write_character(to_char_type(0x00));
+ }
+
+ /*!
+ @brief Writes a BSON element with key @a name and binary value @a value
+ */
+ void write_bson_binary(const string_t& name,
+ const binary_t& value)
+ {
+ write_bson_entry_header(name, 0x05);
+
+ write_number<std::int32_t, true>(static_cast<std::int32_t>(value.size()));
+ 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());
+ }
+
+ /*!
+ @brief Calculates the size necessary to serialize the JSON value @a j with its @a name
+ @return The calculated size for the BSON document entry for @a j with the given @a name.
+ */
+ static std::size_t calc_bson_element_size(const string_t& name,
+ const BasicJsonType& j)
+ {
+ const auto header_size = calc_bson_entry_header_size(name, j);
+ switch (j.type())
+ {
+ case value_t::object:
+ return header_size + calc_bson_object_size(*j.m_value.object);
+
+ case value_t::array:
+ return header_size + calc_bson_array_size(*j.m_value.array);
+
+ case value_t::binary:
+ return header_size + calc_bson_binary_size(*j.m_value.binary);
+
+ case value_t::boolean:
+ return header_size + 1ul;
+
+ case value_t::number_float:
+ return header_size + 8ul;
+
+ case value_t::number_integer:
+ return header_size + calc_bson_integer_size(j.m_value.number_integer);
+
+ case value_t::number_unsigned:
+ return header_size + calc_bson_unsigned_size(j.m_value.number_unsigned);
+
+ case value_t::string:
+ return header_size + calc_bson_string_size(*j.m_value.string);
+
+ case value_t::null:
+ return header_size + 0ul;
+
+ // LCOV_EXCL_START
+ case value_t::discarded:
+ default:
+ JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert)
+ return 0ul;
+ // LCOV_EXCL_STOP
+ }
+ }
+
+ /*!
+ @brief Serializes the JSON value @a j to BSON and associates it with the
+ key @a name.
+ @param name The name to associate with the JSON entity @a j within the
+ current BSON document
+ */
+ void write_bson_element(const string_t& name,
+ const BasicJsonType& j)
+ {
+ switch (j.type())
+ {
+ case value_t::object:
+ return write_bson_object_entry(name, *j.m_value.object);
+
+ case value_t::array:
+ return write_bson_array(name, *j.m_value.array);
+
+ case value_t::binary:
+ return write_bson_binary(name, *j.m_value.binary);
+
+ case value_t::boolean:
+ return write_bson_boolean(name, j.m_value.boolean);
+
+ case value_t::number_float:
+ return write_bson_double(name, j.m_value.number_float);
+
+ case value_t::number_integer:
+ return write_bson_integer(name, j.m_value.number_integer);
+
+ case value_t::number_unsigned:
+ return write_bson_unsigned(name, j);
+
+ case value_t::string:
+ return write_bson_string(name, *j.m_value.string);
+
+ case value_t::null:
+ return write_bson_null(name);
+
+ // LCOV_EXCL_START
+ case value_t::discarded:
+ default:
+ JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert)
+ return;
+ // LCOV_EXCL_STOP
+ }
+ }
+
+ /*!
+ @brief Calculates the size of the BSON serialization of the given
+ JSON-object @a j.
+ @param[in] value JSON value to serialize
+ @pre value.type() == value_t::object
+ */
+ static std::size_t calc_bson_object_size(const typename BasicJsonType::object_t& value)
+ {
+ std::size_t document_size = std::accumulate(value.begin(), value.end(), static_cast<std::size_t>(0),
+ [](size_t result, const typename BasicJsonType::object_t::value_type & el)
+ {
+ return result += calc_bson_element_size(el.first, el.second);
+ });
+
+ return sizeof(std::int32_t) + document_size + 1ul;
+ }
+
+ /*!
+ @param[in] value JSON value to serialize
+ @pre value.type() == value_t::object
+ */
+ 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)));
+
+ for (const auto& el : value)
+ {
+ write_bson_element(el.first, el.second);
+ }
+
+ oa->write_character(to_char_type(0x00));
+ }
+
+ //////////
+ // CBOR //
+ //////////
+
+ static constexpr CharType get_cbor_float_prefix(float /*unused*/)
+ {
+ return to_char_type(0xFA); // Single-Precision Float
+ }
+
+ static constexpr CharType get_cbor_float_prefix(double /*unused*/)
+ {
+ return to_char_type(0xFB); // Double-Precision Float
+ }
+
+ /////////////
+ // MsgPack //
+ /////////////
+
+ static constexpr CharType get_msgpack_float_prefix(float /*unused*/)
+ {
+ return to_char_type(0xCA); // float 32
+ }
+
+ static constexpr CharType get_msgpack_float_prefix(double /*unused*/)
+ {
+ return to_char_type(0xCB); // float 64
+ }
+
+ ////////////
+ // UBJSON //
+ ////////////
+
+ // UBJSON: write number (floating point)
+ 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)
+ {
+ if (add_prefix)
+ {
+ oa->write_character(get_ubjson_float_prefix(n));
+ }
+ write_number(n);
+ }
+
+ // 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)
+ {
+ if (n <= static_cast<std::uint64_t>((std::numeric_limits<std::int8_t>::max)()))
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('i')); // int8
+ }
+ write_number(static_cast<std::uint8_t>(n));
+ }
+ else if (n <= (std::numeric_limits<std::uint8_t>::max)())
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('U')); // uint8
+ }
+ write_number(static_cast<std::uint8_t>(n));
+ }
+ else if (n <= static_cast<std::uint64_t>((std::numeric_limits<std::int16_t>::max)()))
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('I')); // int16
+ }
+ write_number(static_cast<std::int16_t>(n));
+ }
+ else if (n <= static_cast<std::uint64_t>((std::numeric_limits<std::int32_t>::max)()))
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('l')); // int32
+ }
+ write_number(static_cast<std::int32_t>(n));
+ }
+ else if (n <= static_cast<std::uint64_t>((std::numeric_limits<std::int64_t>::max)()))
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('L')); // int64
+ }
+ write_number(static_cast<std::int64_t>(n));
+ }
+ else
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('H')); // high-precision number
+ }
+
+ const auto number = BasicJsonType(n).dump();
+ write_number_with_ubjson_prefix(number.size(), true);
+ for (std::size_t i = 0; i < number.size(); ++i)
+ {
+ oa->write_character(to_char_type(static_cast<std::uint8_t>(number[i])));
+ }
+ }
+ }
+
+ // UBJSON: write number (signed integer)
+ template < typename NumberType, typename std::enable_if <
+ 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)
+ {
+ if ((std::numeric_limits<std::int8_t>::min)() <= n && n <= (std::numeric_limits<std::int8_t>::max)())
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('i')); // int8
+ }
+ write_number(static_cast<std::int8_t>(n));
+ }
+ 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)()))
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('U')); // uint8
+ }
+ write_number(static_cast<std::uint8_t>(n));
+ }
+ else if ((std::numeric_limits<std::int16_t>::min)() <= n && n <= (std::numeric_limits<std::int16_t>::max)())
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('I')); // int16
+ }
+ write_number(static_cast<std::int16_t>(n));
+ }
+ else if ((std::numeric_limits<std::int32_t>::min)() <= n && n <= (std::numeric_limits<std::int32_t>::max)())
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('l')); // int32
+ }
+ write_number(static_cast<std::int32_t>(n));
+ }
+ else if ((std::numeric_limits<std::int64_t>::min)() <= n && n <= (std::numeric_limits<std::int64_t>::max)())
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('L')); // int64
+ }
+ write_number(static_cast<std::int64_t>(n));
+ }
+ // LCOV_EXCL_START
+ else
+ {
+ if (add_prefix)
+ {
+ oa->write_character(to_char_type('H')); // high-precision number
+ }
+
+ const auto number = BasicJsonType(n).dump();
+ write_number_with_ubjson_prefix(number.size(), true);
+ for (std::size_t i = 0; i < number.size(); ++i)
+ {
+ oa->write_character(to_char_type(static_cast<std::uint8_t>(number[i])));
+ }
+ }
+ // LCOV_EXCL_STOP
+ }
+
+ /*!
+ @brief determine the type prefix of container values
+ */
+ CharType ubjson_prefix(const BasicJsonType& j) const noexcept
+ {
+ switch (j.type())
+ {
+ case value_t::null:
+ return 'Z';
+
+ case value_t::boolean:
+ return j.m_value.boolean ? 'T' : 'F';
+
+ case value_t::number_integer:
+ {
+ if ((std::numeric_limits<std::int8_t>::min)() <= j.m_value.number_integer && j.m_value.number_integer <= (std::numeric_limits<std::int8_t>::max)())
+ {
+ return 'i';
+ }
+ if ((std::numeric_limits<std::uint8_t>::min)() <= j.m_value.number_integer && j.m_value.number_integer <= (std::numeric_limits<std::uint8_t>::max)())
+ {
+ return 'U';
+ }
+ if ((std::numeric_limits<std::int16_t>::min)() <= j.m_value.number_integer && j.m_value.number_integer <= (std::numeric_limits<std::int16_t>::max)())
+ {
+ return 'I';
+ }
+ 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 ((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';
+ }
+ // anything else is treated as high-precision number
+ return 'H'; // LCOV_EXCL_LINE
+ }
+
+ case value_t::number_unsigned:
+ {
+ if (j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::int8_t>::max)()))
+ {
+ return 'i';
+ }
+ if (j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::uint8_t>::max)()))
+ {
+ return 'U';
+ }
+ if (j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::int16_t>::max)()))
+ {
+ return 'I';
+ }
+ if (j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::int32_t>::max)()))
+ {
+ return 'l';
+ }
+ if (j.m_value.number_unsigned <= static_cast<std::uint64_t>((std::numeric_limits<std::int64_t>::max)()))
+ {
+ return 'L';
+ }
+ // anything else is treated as high-precision number
+ return 'H'; // LCOV_EXCL_LINE
+ }
+
+ case value_t::number_float:
+ return get_ubjson_float_prefix(j.m_value.number_float);
+
+ case value_t::string:
+ return 'S';
+
+ case value_t::array: // fallthrough
+ case value_t::binary:
+ return '[';
+
+ case value_t::object:
+ return '{';
+
+ case value_t::discarded:
+ default: // discarded values
+ return 'N';
+ }
+ }
+
+ static constexpr CharType get_ubjson_float_prefix(float /*unused*/)
+ {
+ return 'd'; // float 32
+ }
+
+ static constexpr CharType get_ubjson_float_prefix(double /*unused*/)
+ {
+ return 'D'; // float 64
+ }
+
+ ///////////////////////
+ // Utility functions //
+ ///////////////////////
+
+ /*
+ @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
+ required to be little endian
+
+ @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.
+ */
+ template<typename NumberType, bool OutputIsLittleEndian = false>
+ void write_number(const NumberType n)
+ {
+ // step 1: write number to array of length NumberType
+ std::array<CharType, sizeof(NumberType)> vec{};
+ std::memcpy(vec.data(), &n, sizeof(NumberType));
+
+ // step 2: write array to output (with possible reordering)
+ if (is_little_endian != OutputIsLittleEndian)
+ {
+ // reverse byte order prior to conversion if necessary
+ std::reverse(vec.begin(), vec.end());
+ }
+
+ oa->write_characters(vec.data(), sizeof(NumberType));
+ }
+
+ void write_compact_float(const number_float_t n, detail::input_format_t format)
+ {
+#ifdef __GNUC__
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wfloat-equal"
+#endif
+ if (static_cast<double>(n) >= static_cast<double>(std::numeric_limits<float>::lowest()) &&
+ static_cast<double>(n) <= static_cast<double>((std::numeric_limits<float>::max)()) &&
+ static_cast<double>(static_cast<float>(n)) == static_cast<double>(n))
+ {
+ oa->write_character(format == detail::input_format_t::cbor
+ ? get_cbor_float_prefix(static_cast<float>(n))
+ : get_msgpack_float_prefix(static_cast<float>(n)));
+ write_number(static_cast<float>(n));
+ }
+ else
+ {
+ oa->write_character(format == detail::input_format_t::cbor
+ ? get_cbor_float_prefix(n)
+ : get_msgpack_float_prefix(n));
+ write_number(n);
+ }
+#ifdef __GNUC__
+#pragma GCC diagnostic pop
+#endif
+ }
+
+ public:
+ // The following to_char_type functions are implement the conversion
+ // between uint8_t and CharType. In case CharType is not unsigned,
+ // such a conversion is required to allow values greater than 128.
+ // See <https://github.com/nlohmann/json/issues/1286> for a discussion.
+ template < typename C = CharType,
+ enable_if_t < std::is_signed<C>::value && std::is_signed<char>::value > * = nullptr >
+ static constexpr CharType to_char_type(std::uint8_t x) noexcept
+ {
+ return *reinterpret_cast<char*>(&x);
+ }
+
+ template < typename C = CharType,
+ enable_if_t < std::is_signed<C>::value && std::is_unsigned<char>::value > * = nullptr >
+ static CharType to_char_type(std::uint8_t x) noexcept
+ {
+ static_assert(sizeof(std::uint8_t) == sizeof(CharType), "size of CharType must be equal to std::uint8_t");
+ static_assert(std::is_trivial<CharType>::value, "CharType must be trivial");
+ CharType result;
+ std::memcpy(&result, &x, sizeof(x));
+ return result;
+ }
+
+ template<typename C = CharType,
+ enable_if_t<std::is_unsigned<C>::value>* = nullptr>
+ static constexpr CharType to_char_type(std::uint8_t x) noexcept
+ {
+ return x;
+ }
+
+ template < typename InputCharType, typename C = CharType,
+ enable_if_t <
+ std::is_signed<C>::value &&
+ std::is_signed<char>::value &&
+ std::is_same<char, typename std::remove_cv<InputCharType>::type>::value
+ > * = nullptr >
+ static constexpr CharType to_char_type(InputCharType x) noexcept
+ {
+ return x;
+ }
+
+ private:
+ /// whether we can assume little endianness
+ const bool is_little_endian = little_endianness();
+
+ /// the output
+ output_adapter_t<CharType> oa = nullptr;
+};
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/output/output_adapters.hpp>
+
+// #include <nlohmann/detail/output/serializer.hpp>
+
+
+#include <algorithm> // reverse, remove, fill, find, none_of
+#include <array> // array
+#include <clocale> // localeconv, lconv
+#include <cmath> // labs, isfinite, isnan, signbit
+#include <cstddef> // size_t, ptrdiff_t
+#include <cstdint> // uint8_t
+#include <cstdio> // snprintf
+#include <limits> // numeric_limits
+#include <string> // string, char_traits
+#include <iomanip> // setfill, setw
+#include <sstream> // stringstream
+#include <type_traits> // is_same
+#include <utility> // move
+
+// #include <nlohmann/detail/conversions/to_chars.hpp>
+
+
+#include <array> // array
+#include <cmath> // signbit, isfinite
+#include <cstdint> // intN_t, uintN_t
+#include <cstring> // memcpy, memmove
+#include <limits> // numeric_limits
+#include <type_traits> // conditional
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+
+/*!
+@brief implements the Grisu2 algorithm for binary to decimal floating-point
+conversion.
+
+This implementation is a slightly modified version of the reference
+implementation which may be obtained from
+http://florian.loitsch.com/publications (bench.tar.gz).
+
+The code is distributed under the MIT license, Copyright (c) 2009 Florian Loitsch.
+
+For a detailed description of the algorithm see:
+
+[1] Loitsch, "Printing Floating-Point Numbers Quickly and Accurately with
+ Integers", Proceedings of the ACM SIGPLAN 2010 Conference on Programming
+ Language Design and Implementation, PLDI 2010
+[2] Burger, Dybvig, "Printing Floating-Point Numbers Quickly and Accurately",
+ Proceedings of the ACM SIGPLAN 1996 Conference on Programming Language
+ Design and Implementation, PLDI 1996
+*/
+namespace dtoa_impl
+{
+
+template<typename Target, typename Source>
+Target reinterpret_bits(const Source source)
+{
+ static_assert(sizeof(Target) == sizeof(Source), "size mismatch");
+
+ Target target;
+ std::memcpy(&target, &source, sizeof(Source));
+ return target;
+}
+
+struct diyfp // f * 2^e
+{
+ static constexpr int kPrecision = 64; // = q
+
+ std::uint64_t f = 0;
+ int e = 0;
+
+ constexpr diyfp(std::uint64_t f_, int e_) noexcept : f(f_), e(e_) {}
+
+ /*!
+ @brief returns x - y
+ @pre x.e == y.e and x.f >= y.f
+ */
+ static diyfp sub(const diyfp& x, const diyfp& y) noexcept
+ {
+ JSON_ASSERT(x.e == y.e);
+ JSON_ASSERT(x.f >= y.f);
+
+ return {x.f - y.f, x.e};
+ }
+
+ /*!
+ @brief returns x * y
+ @note The result is rounded. (Only the upper q bits are returned.)
+ */
+ static diyfp mul(const diyfp& x, const diyfp& y) noexcept
+ {
+ static_assert(kPrecision == 64, "internal error");
+
+ // Computes:
+ // f = round((x.f * y.f) / 2^q)
+ // e = x.e + y.e + q
+
+ // Emulate the 64-bit * 64-bit multiplication:
+ //
+ // p = u * v
+ // = (u_lo + 2^32 u_hi) (v_lo + 2^32 v_hi)
+ // = (u_lo v_lo ) + 2^32 ((u_lo v_hi ) + (u_hi v_lo )) + 2^64 (u_hi v_hi )
+ // = (p0 ) + 2^32 ((p1 ) + (p2 )) + 2^64 (p3 )
+ // = (p0_lo + 2^32 p0_hi) + 2^32 ((p1_lo + 2^32 p1_hi) + (p2_lo + 2^32 p2_hi)) + 2^64 (p3 )
+ // = (p0_lo ) + 2^32 (p0_hi + p1_lo + p2_lo ) + 2^64 (p1_hi + p2_hi + p3)
+ // = (p0_lo ) + 2^32 (Q ) + 2^64 (H )
+ // = (p0_lo ) + 2^32 (Q_lo + 2^32 Q_hi ) + 2^64 (H )
+ //
+ // (Since Q might be larger than 2^32 - 1)
+ //
+ // = (p0_lo + 2^32 Q_lo) + 2^64 (Q_hi + H)
+ //
+ // (Q_hi + H does not overflow a 64-bit int)
+ //
+ // = p_lo + 2^64 p_hi
+
+ const std::uint64_t u_lo = x.f & 0xFFFFFFFFu;
+ const std::uint64_t u_hi = x.f >> 32u;
+ const std::uint64_t v_lo = y.f & 0xFFFFFFFFu;
+ const std::uint64_t v_hi = y.f >> 32u;
+
+ const std::uint64_t p0 = u_lo * v_lo;
+ const std::uint64_t p1 = u_lo * v_hi;
+ const std::uint64_t p2 = u_hi * v_lo;
+ const std::uint64_t p3 = u_hi * v_hi;
+
+ const std::uint64_t p0_hi = p0 >> 32u;
+ const std::uint64_t p1_lo = p1 & 0xFFFFFFFFu;
+ const std::uint64_t p1_hi = p1 >> 32u;
+ const std::uint64_t p2_lo = p2 & 0xFFFFFFFFu;
+ const std::uint64_t p2_hi = p2 >> 32u;
+
+ std::uint64_t Q = p0_hi + p1_lo + p2_lo;
+
+ // The full product might now be computed as
+ //
+ // p_hi = p3 + p2_hi + p1_hi + (Q >> 32)
+ // p_lo = p0_lo + (Q << 32)
+ //
+ // But in this particular case here, the full p_lo is not required.
+ // Effectively we only need to add the highest bit in p_lo to p_hi (and
+ // Q_hi + 1 does not overflow).
+
+ Q += std::uint64_t{1} << (64u - 32u - 1u); // round, ties up
+
+ const std::uint64_t h = p3 + p2_hi + p1_hi + (Q >> 32u);
+
+ return {h, x.e + y.e + 64};
+ }
+
+ /*!
+ @brief normalize x such that the significand is >= 2^(q-1)
+ @pre x.f != 0
+ */
+ static diyfp normalize(diyfp x) noexcept
+ {
+ JSON_ASSERT(x.f != 0);
+
+ while ((x.f >> 63u) == 0)
+ {
+ x.f <<= 1u;
+ x.e--;
+ }
+
+ return x;
+ }
+
+ /*!
+ @brief normalize x such that the result has the exponent E
+ @pre e >= x.e and the upper e - x.e bits of x.f must be zero.
+ */
+ static diyfp normalize_to(const diyfp& x, const int target_exponent) noexcept
+ {
+ const int delta = x.e - target_exponent;
+
+ JSON_ASSERT(delta >= 0);
+ JSON_ASSERT(((x.f << delta) >> delta) == x.f);
+
+ return {x.f << delta, target_exponent};
+ }
+};
+
+struct boundaries
+{
+ diyfp w;
+ diyfp minus;
+ diyfp plus;
+};
+
+/*!
+Compute the (normalized) diyfp representing the input number 'value' and its
+boundaries.
+
+@pre value must be finite and positive
+*/
+template<typename FloatType>
+boundaries compute_boundaries(FloatType value)
+{
+ JSON_ASSERT(std::isfinite(value));
+ JSON_ASSERT(value > 0);
+
+ // Convert the IEEE representation into a diyfp.
+ //
+ // If v is denormal:
+ // value = 0.F * 2^(1 - bias) = ( F) * 2^(1 - bias - (p-1))
+ // If v is normalized:
+ // value = 1.F * 2^(E - bias) = (2^(p-1) + F) * 2^(E - bias - (p-1))
+
+ static_assert(std::numeric_limits<FloatType>::is_iec559,
+ "internal error: dtoa_short requires an IEEE-754 floating-point implementation");
+
+ constexpr int kPrecision = std::numeric_limits<FloatType>::digits; // = p (includes the hidden bit)
+ constexpr int kBias = std::numeric_limits<FloatType>::max_exponent - 1 + (kPrecision - 1);
+ constexpr int kMinExp = 1 - kBias;
+ constexpr std::uint64_t kHiddenBit = std::uint64_t{1} << (kPrecision - 1); // = 2^(p-1)
+
+ using bits_type = typename std::conditional<kPrecision == 24, std::uint32_t, std::uint64_t >::type;
+
+ const auto bits = static_cast<std::uint64_t>(reinterpret_bits<bits_type>(value));
+ const std::uint64_t E = bits >> (kPrecision - 1);
+ const std::uint64_t F = bits & (kHiddenBit - 1);
+
+ const bool is_denormal = E == 0;
+ const diyfp v = is_denormal
+ ? diyfp(F, kMinExp)
+ : diyfp(F + kHiddenBit, static_cast<int>(E) - kBias);
+
+ // Compute the boundaries m- and m+ of the floating-point value
+ // v = f * 2^e.
+ //
+ // Determine v- and v+, the floating-point predecessor and successor if v,
+ // respectively.
+ //
+ // v- = v - 2^e if f != 2^(p-1) or e == e_min (A)
+ // = v - 2^(e-1) if f == 2^(p-1) and e > e_min (B)
+ //
+ // v+ = v + 2^e
+ //
+ // Let m- = (v- + v) / 2 and m+ = (v + v+) / 2. All real numbers _strictly_
+ // between m- and m+ round to v, regardless of how the input rounding
+ // algorithm breaks ties.
+ //
+ // ---+-------------+-------------+-------------+-------------+--- (A)
+ // v- m- v m+ v+
+ //
+ // -----------------+------+------+-------------+-------------+--- (B)
+ // v- m- v m+ v+
+
+ const bool lower_boundary_is_closer = F == 0 && E > 1;
+ const diyfp m_plus = diyfp(2 * v.f + 1, v.e - 1);
+ const diyfp m_minus = lower_boundary_is_closer
+ ? diyfp(4 * v.f - 1, v.e - 2) // (B)
+ : diyfp(2 * v.f - 1, v.e - 1); // (A)
+
+ // Determine the normalized w+ = m+.
+ const diyfp w_plus = diyfp::normalize(m_plus);
+
+ // Determine w- = m- such that e_(w-) = e_(w+).
+ const diyfp w_minus = diyfp::normalize_to(m_minus, w_plus.e);
+
+ return {diyfp::normalize(v), w_minus, w_plus};
+}
+
+// Given normalized diyfp w, Grisu needs to find a (normalized) cached
+// power-of-ten c, such that the exponent of the product c * w = f * 2^e lies
+// within a certain range [alpha, gamma] (Definition 3.2 from [1])
+//
+// alpha <= e = e_c + e_w + q <= gamma
+//
+// or
+//
+// f_c * f_w * 2^alpha <= f_c 2^(e_c) * f_w 2^(e_w) * 2^q
+// <= f_c * f_w * 2^gamma
+//
+// Since c and w are normalized, i.e. 2^(q-1) <= f < 2^q, this implies
+//
+// 2^(q-1) * 2^(q-1) * 2^alpha <= c * w * 2^q < 2^q * 2^q * 2^gamma
+//
+// or
+//
+// 2^(q - 2 + alpha) <= c * w < 2^(q + gamma)
+//
+// The choice of (alpha,gamma) determines the size of the table and the form of
+// the digit generation procedure. Using (alpha,gamma)=(-60,-32) works out well
+// in practice:
+//
+// The idea is to cut the number c * w = f * 2^e into two parts, which can be
+// processed independently: An integral part p1, and a fractional part p2:
+//
+// f * 2^e = ( (f div 2^-e) * 2^-e + (f mod 2^-e) ) * 2^e
+// = (f div 2^-e) + (f mod 2^-e) * 2^e
+// = p1 + p2 * 2^e
+//
+// The conversion of p1 into decimal form requires a series of divisions and
+// modulos by (a power of) 10. These operations are faster for 32-bit than for
+// 64-bit integers, so p1 should ideally fit into a 32-bit integer. This can be
+// achieved by choosing
+//
+// -e >= 32 or e <= -32 := gamma
+//
+// In order to convert the fractional part
+//
+// p2 * 2^e = p2 / 2^-e = d[-1] / 10^1 + d[-2] / 10^2 + ...
+//
+// into decimal form, the fraction is repeatedly multiplied by 10 and the digits
+// d[-i] are extracted in order:
+//
+// (10 * p2) div 2^-e = d[-1]
+// (10 * p2) mod 2^-e = d[-2] / 10^1 + ...
+//
+// The multiplication by 10 must not overflow. It is sufficient to choose
+//
+// 10 * p2 < 16 * p2 = 2^4 * p2 <= 2^64.
+//
+// Since p2 = f mod 2^-e < 2^-e,
+//
+// -e <= 60 or e >= -60 := alpha
+
+constexpr int kAlpha = -60;
+constexpr int kGamma = -32;
+
+struct cached_power // c = f * 2^e ~= 10^k
+{
+ std::uint64_t f;
+ int e;
+ int k;
+};
+
+/*!
+For a normalized diyfp w = f * 2^e, this function returns a (normalized) cached
+power-of-ten c = f_c * 2^e_c, such that the exponent of the product w * c
+satisfies (Definition 3.2 from [1])
+
+ alpha <= e_c + e + q <= gamma.
+*/
+inline cached_power get_cached_power_for_binary_exponent(int e)
+{
+ // Now
+ //
+ // alpha <= e_c + e + q <= gamma (1)
+ // ==> f_c * 2^alpha <= c * 2^e * 2^q
+ //
+ // and since the c's are normalized, 2^(q-1) <= f_c,
+ //
+ // ==> 2^(q - 1 + alpha) <= c * 2^(e + q)
+ // ==> 2^(alpha - e - 1) <= c
+ //
+ // If c were an exact power of ten, i.e. c = 10^k, one may determine k as
+ //
+ // k = ceil( log_10( 2^(alpha - e - 1) ) )
+ // = ceil( (alpha - e - 1) * log_10(2) )
+ //
+ // From the paper:
+ // "In theory the result of the procedure could be wrong since c is rounded,
+ // and the computation itself is approximated [...]. In practice, however,
+ // this simple function is sufficient."
+ //
+ // For IEEE double precision floating-point numbers converted into
+ // normalized diyfp's w = f * 2^e, with q = 64,
+ //
+ // e >= -1022 (min IEEE exponent)
+ // -52 (p - 1)
+ // -52 (p - 1, possibly normalize denormal IEEE numbers)
+ // -11 (normalize the diyfp)
+ // = -1137
+ //
+ // and
+ //
+ // e <= +1023 (max IEEE exponent)
+ // -52 (p - 1)
+ // -11 (normalize the diyfp)
+ // = 960
+ //
+ // This binary exponent range [-1137,960] results in a decimal exponent
+ // range [-307,324]. One does not need to store a cached power for each
+ // k in this range. For each such k it suffices to find a cached power
+ // such that the exponent of the product lies in [alpha,gamma].
+ // This implies that the difference of the decimal exponents of adjacent
+ // table entries must be less than or equal to
+ //
+ // floor( (gamma - alpha) * log_10(2) ) = 8.
+ //
+ // (A smaller distance gamma-alpha would require a larger table.)
+
+ // NB:
+ // Actually this function returns c, such that -60 <= e_c + e + 64 <= -34.
+
+ constexpr int kCachedPowersMinDecExp = -300;
+ constexpr int kCachedPowersDecStep = 8;
+
+ static constexpr std::array<cached_power, 79> kCachedPowers =
+ {
+ {
+ { 0xAB70FE17C79AC6CA, -1060, -300 },
+ { 0xFF77B1FCBEBCDC4F, -1034, -292 },
+ { 0xBE5691EF416BD60C, -1007, -284 },
+ { 0x8DD01FAD907FFC3C, -980, -276 },
+ { 0xD3515C2831559A83, -954, -268 },
+ { 0x9D71AC8FADA6C9B5, -927, -260 },
+ { 0xEA9C227723EE8BCB, -901, -252 },
+ { 0xAECC49914078536D, -874, -244 },
+ { 0x823C12795DB6CE57, -847, -236 },
+ { 0xC21094364DFB5637, -821, -228 },
+ { 0x9096EA6F3848984F, -794, -220 },
+ { 0xD77485CB25823AC7, -768, -212 },
+ { 0xA086CFCD97BF97F4, -741, -204 },
+ { 0xEF340A98172AACE5, -715, -196 },
+ { 0xB23867FB2A35B28E, -688, -188 },
+ { 0x84C8D4DFD2C63F3B, -661, -180 },
+ { 0xC5DD44271AD3CDBA, -635, -172 },
+ { 0x936B9FCEBB25C996, -608, -164 },
+ { 0xDBAC6C247D62A584, -582, -156 },
+ { 0xA3AB66580D5FDAF6, -555, -148 },
+ { 0xF3E2F893DEC3F126, -529, -140 },
+ { 0xB5B5ADA8AAFF80B8, -502, -132 },
+ { 0x87625F056C7C4A8B, -475, -124 },
+ { 0xC9BCFF6034C13053, -449, -116 },
+ { 0x964E858C91BA2655, -422, -108 },
+ { 0xDFF9772470297EBD, -396, -100 },
+ { 0xA6DFBD9FB8E5B88F, -369, -92 },
+ { 0xF8A95FCF88747D94, -343, -84 },
+ { 0xB94470938FA89BCF, -316, -76 },
+ { 0x8A08F0F8BF0F156B, -289, -68 },
+ { 0xCDB02555653131B6, -263, -60 },
+ { 0x993FE2C6D07B7FAC, -236, -52 },
+ { 0xE45C10C42A2B3B06, -210, -44 },
+ { 0xAA242499697392D3, -183, -36 },
+ { 0xFD87B5F28300CA0E, -157, -28 },
+ { 0xBCE5086492111AEB, -130, -20 },
+ { 0x8CBCCC096F5088CC, -103, -12 },
+ { 0xD1B71758E219652C, -77, -4 },
+ { 0x9C40000000000000, -50, 4 },
+ { 0xE8D4A51000000000, -24, 12 },
+ { 0xAD78EBC5AC620000, 3, 20 },
+ { 0x813F3978F8940984, 30, 28 },
+ { 0xC097CE7BC90715B3, 56, 36 },
+ { 0x8F7E32CE7BEA5C70, 83, 44 },
+ { 0xD5D238A4ABE98068, 109, 52 },
+ { 0x9F4F2726179A2245, 136, 60 },
+ { 0xED63A231D4C4FB27, 162, 68 },
+ { 0xB0DE65388CC8ADA8, 189, 76 },
+ { 0x83C7088E1AAB65DB, 216, 84 },
+ { 0xC45D1DF942711D9A, 242, 92 },
+ { 0x924D692CA61BE758, 269, 100 },
+ { 0xDA01EE641A708DEA, 295, 108 },
+ { 0xA26DA3999AEF774A, 322, 116 },
+ { 0xF209787BB47D6B85, 348, 124 },
+ { 0xB454E4A179DD1877, 375, 132 },
+ { 0x865B86925B9BC5C2, 402, 140 },
+ { 0xC83553C5C8965D3D, 428, 148 },
+ { 0x952AB45CFA97A0B3, 455, 156 },
+ { 0xDE469FBD99A05FE3, 481, 164 },
+ { 0xA59BC234DB398C25, 508, 172 },
+ { 0xF6C69A72A3989F5C, 534, 180 },
+ { 0xB7DCBF5354E9BECE, 561, 188 },
+ { 0x88FCF317F22241E2, 588, 196 },
+ { 0xCC20CE9BD35C78A5, 614, 204 },
+ { 0x98165AF37B2153DF, 641, 212 },
+ { 0xE2A0B5DC971F303A, 667, 220 },
+ { 0xA8D9D1535CE3B396, 694, 228 },
+ { 0xFB9B7CD9A4A7443C, 720, 236 },
+ { 0xBB764C4CA7A44410, 747, 244 },
+ { 0x8BAB8EEFB6409C1A, 774, 252 },
+ { 0xD01FEF10A657842C, 800, 260 },
+ { 0x9B10A4E5E9913129, 827, 268 },
+ { 0xE7109BFBA19C0C9D, 853, 276 },
+ { 0xAC2820D9623BF429, 880, 284 },
+ { 0x80444B5E7AA7CF85, 907, 292 },
+ { 0xBF21E44003ACDD2D, 933, 300 },
+ { 0x8E679C2F5E44FF8F, 960, 308 },
+ { 0xD433179D9C8CB841, 986, 316 },
+ { 0x9E19DB92B4E31BA9, 1013, 324 },
+ }
+ };
+
+ // This computation gives exactly the same results for k as
+ // k = ceil((kAlpha - e - 1) * 0.30102999566398114)
+ // for |e| <= 1500, but doesn't require floating-point operations.
+ // NB: log_10(2) ~= 78913 / 2^18
+ JSON_ASSERT(e >= -1500);
+ JSON_ASSERT(e <= 1500);
+ const int f = kAlpha - e - 1;
+ const int k = (f * 78913) / (1 << 18) + static_cast<int>(f > 0);
+
+ const int index = (-kCachedPowersMinDecExp + k + (kCachedPowersDecStep - 1)) / kCachedPowersDecStep;
+ JSON_ASSERT(index >= 0);
+ JSON_ASSERT(static_cast<std::size_t>(index) < kCachedPowers.size());
+
+ const cached_power cached = kCachedPowers[static_cast<std::size_t>(index)];
+ JSON_ASSERT(kAlpha <= cached.e + e + 64);
+ JSON_ASSERT(kGamma >= cached.e + e + 64);
+
+ return cached;
+}
+
+/*!
+For n != 0, returns k, such that pow10 := 10^(k-1) <= n < 10^k.
+For n == 0, returns 1 and sets pow10 := 1.
+*/
+inline int find_largest_pow10(const std::uint32_t n, std::uint32_t& pow10)
+{
+ // LCOV_EXCL_START
+ if (n >= 1000000000)
+ {
+ pow10 = 1000000000;
+ return 10;
+ }
+ // LCOV_EXCL_STOP
+ if (n >= 100000000)
+ {
+ pow10 = 100000000;
+ return 9;
+ }
+ if (n >= 10000000)
+ {
+ pow10 = 10000000;
+ return 8;
+ }
+ if (n >= 1000000)
+ {
+ pow10 = 1000000;
+ return 7;
+ }
+ if (n >= 100000)
+ {
+ pow10 = 100000;
+ return 6;
+ }
+ if (n >= 10000)
+ {
+ pow10 = 10000;
+ return 5;
+ }
+ if (n >= 1000)
+ {
+ pow10 = 1000;
+ return 4;
+ }
+ if (n >= 100)
+ {
+ pow10 = 100;
+ return 3;
+ }
+ if (n >= 10)
+ {
+ pow10 = 10;
+ return 2;
+ }
+
+ pow10 = 1;
+ return 1;
+}
+
+inline void grisu2_round(char* buf, int len, std::uint64_t dist, std::uint64_t delta,
+ std::uint64_t rest, std::uint64_t ten_k)
+{
+ JSON_ASSERT(len >= 1);
+ JSON_ASSERT(dist <= delta);
+ JSON_ASSERT(rest <= delta);
+ JSON_ASSERT(ten_k > 0);
+
+ // <--------------------------- delta ---->
+ // <---- dist --------->
+ // --------------[------------------+-------------------]--------------
+ // M- w M+
+ //
+ // ten_k
+ // <------>
+ // <---- rest ---->
+ // --------------[------------------+----+--------------]--------------
+ // w V
+ // = buf * 10^k
+ //
+ // ten_k represents a unit-in-the-last-place in the decimal representation
+ // stored in buf.
+ // Decrement buf by ten_k while this takes buf closer to w.
+
+ // The tests are written in this order to avoid overflow in unsigned
+ // integer arithmetic.
+
+ while (rest < dist
+ && delta - rest >= ten_k
+ && (rest + ten_k < dist || dist - rest > rest + ten_k - dist))
+ {
+ JSON_ASSERT(buf[len - 1] != '0');
+ buf[len - 1]--;
+ rest += ten_k;
+ }
+}
+
+/*!
+Generates V = buffer * 10^decimal_exponent, such that M- <= V <= M+.
+M- and M+ must be normalized and share the same exponent -60 <= e <= -32.
+*/
+inline void grisu2_digit_gen(char* buffer, int& length, int& decimal_exponent,
+ diyfp M_minus, diyfp w, diyfp M_plus)
+{
+ static_assert(kAlpha >= -60, "internal error");
+ static_assert(kGamma <= -32, "internal error");
+
+ // Generates the digits (and the exponent) of a decimal floating-point
+ // number V = buffer * 10^decimal_exponent in the range [M-, M+]. The diyfp's
+ // w, M- and M+ share the same exponent e, which satisfies alpha <= e <= gamma.
+ //
+ // <--------------------------- delta ---->
+ // <---- dist --------->
+ // --------------[------------------+-------------------]--------------
+ // M- w M+
+ //
+ // Grisu2 generates the digits of M+ from left to right and stops as soon as
+ // V is in [M-,M+].
+
+ JSON_ASSERT(M_plus.e >= kAlpha);
+ JSON_ASSERT(M_plus.e <= kGamma);
+
+ std::uint64_t delta = diyfp::sub(M_plus, M_minus).f; // (significand of (M+ - M-), implicit exponent is e)
+ std::uint64_t dist = diyfp::sub(M_plus, w ).f; // (significand of (M+ - w ), implicit exponent is e)
+
+ // Split M+ = f * 2^e into two parts p1 and p2 (note: e < 0):
+ //
+ // M+ = f * 2^e
+ // = ((f div 2^-e) * 2^-e + (f mod 2^-e)) * 2^e
+ // = ((p1 ) * 2^-e + (p2 )) * 2^e
+ // = p1 + p2 * 2^e
+
+ const diyfp one(std::uint64_t{1} << -M_plus.e, M_plus.e);
+
+ auto p1 = static_cast<std::uint32_t>(M_plus.f >> -one.e); // p1 = f div 2^-e (Since -e >= 32, p1 fits into a 32-bit int.)
+ std::uint64_t p2 = M_plus.f & (one.f - 1); // p2 = f mod 2^-e
+
+ // 1)
+ //
+ // Generate the digits of the integral part p1 = d[n-1]...d[1]d[0]
+
+ JSON_ASSERT(p1 > 0);
+
+ std::uint32_t pow10{};
+ const int k = find_largest_pow10(p1, pow10);
+
+ // 10^(k-1) <= p1 < 10^k, pow10 = 10^(k-1)
+ //
+ // p1 = (p1 div 10^(k-1)) * 10^(k-1) + (p1 mod 10^(k-1))
+ // = (d[k-1] ) * 10^(k-1) + (p1 mod 10^(k-1))
+ //
+ // M+ = p1 + p2 * 2^e
+ // = d[k-1] * 10^(k-1) + (p1 mod 10^(k-1)) + p2 * 2^e
+ // = d[k-1] * 10^(k-1) + ((p1 mod 10^(k-1)) * 2^-e + p2) * 2^e
+ // = d[k-1] * 10^(k-1) + ( rest) * 2^e
+ //
+ // Now generate the digits d[n] of p1 from left to right (n = k-1,...,0)
+ //
+ // p1 = d[k-1]...d[n] * 10^n + d[n-1]...d[0]
+ //
+ // but stop as soon as
+ //
+ // rest * 2^e = (d[n-1]...d[0] * 2^-e + p2) * 2^e <= delta * 2^e
+
+ int n = k;
+ while (n > 0)
+ {
+ // Invariants:
+ // M+ = buffer * 10^n + (p1 + p2 * 2^e) (buffer = 0 for n = k)
+ // pow10 = 10^(n-1) <= p1 < 10^n
+ //
+ const std::uint32_t d = p1 / pow10; // d = p1 div 10^(n-1)
+ const std::uint32_t r = p1 % pow10; // r = p1 mod 10^(n-1)
+ //
+ // M+ = buffer * 10^n + (d * 10^(n-1) + r) + p2 * 2^e
+ // = (buffer * 10 + d) * 10^(n-1) + (r + p2 * 2^e)
+ //
+ JSON_ASSERT(d <= 9);
+ buffer[length++] = static_cast<char>('0' + d); // buffer := buffer * 10 + d
+ //
+ // M+ = buffer * 10^(n-1) + (r + p2 * 2^e)
+ //
+ p1 = r;
+ n--;
+ //
+ // M+ = buffer * 10^n + (p1 + p2 * 2^e)
+ // pow10 = 10^n
+ //
+
+ // Now check if enough digits have been generated.
+ // Compute
+ //
+ // p1 + p2 * 2^e = (p1 * 2^-e + p2) * 2^e = rest * 2^e
+ //
+ // Note:
+ // Since rest and delta share the same exponent e, it suffices to
+ // compare the significands.
+ const std::uint64_t rest = (std::uint64_t{p1} << -one.e) + p2;
+ if (rest <= delta)
+ {
+ // V = buffer * 10^n, with M- <= V <= M+.
+
+ decimal_exponent += n;
+
+ // We may now just stop. But instead look if the buffer could be
+ // decremented to bring V closer to w.
+ //
+ // pow10 = 10^n is now 1 ulp in the decimal representation V.
+ // The rounding procedure works with diyfp's with an implicit
+ // exponent of e.
+ //
+ // 10^n = (10^n * 2^-e) * 2^e = ulp * 2^e
+ //
+ const std::uint64_t ten_n = std::uint64_t{pow10} << -one.e;
+ grisu2_round(buffer, length, dist, delta, rest, ten_n);
+
+ return;
+ }
+
+ pow10 /= 10;
+ //
+ // pow10 = 10^(n-1) <= p1 < 10^n
+ // Invariants restored.
+ }
+
+ // 2)
+ //
+ // The digits of the integral part have been generated:
+ //
+ // M+ = d[k-1]...d[1]d[0] + p2 * 2^e
+ // = buffer + p2 * 2^e
+ //
+ // Now generate the digits of the fractional part p2 * 2^e.
+ //
+ // Note:
+ // No decimal point is generated: the exponent is adjusted instead.
+ //
+ // p2 actually represents the fraction
+ //
+ // p2 * 2^e
+ // = p2 / 2^-e
+ // = d[-1] / 10^1 + d[-2] / 10^2 + ...
+ //
+ // Now generate the digits d[-m] of p1 from left to right (m = 1,2,...)
+ //
+ // p2 * 2^e = d[-1]d[-2]...d[-m] * 10^-m
+ // + 10^-m * (d[-m-1] / 10^1 + d[-m-2] / 10^2 + ...)
+ //
+ // using
+ //
+ // 10^m * p2 = ((10^m * p2) div 2^-e) * 2^-e + ((10^m * p2) mod 2^-e)
+ // = ( d) * 2^-e + ( r)
+ //
+ // or
+ // 10^m * p2 * 2^e = d + r * 2^e
+ //
+ // i.e.
+ //
+ // M+ = buffer + p2 * 2^e
+ // = buffer + 10^-m * (d + r * 2^e)
+ // = (buffer * 10^m + d) * 10^-m + 10^-m * r * 2^e
+ //
+ // and stop as soon as 10^-m * r * 2^e <= delta * 2^e
+
+ JSON_ASSERT(p2 > delta);
+
+ int m = 0;
+ for (;;)
+ {
+ // Invariant:
+ // M+ = buffer * 10^-m + 10^-m * (d[-m-1] / 10 + d[-m-2] / 10^2 + ...) * 2^e
+ // = buffer * 10^-m + 10^-m * (p2 ) * 2^e
+ // = buffer * 10^-m + 10^-m * (1/10 * (10 * p2) ) * 2^e
+ // = buffer * 10^-m + 10^-m * (1/10 * ((10*p2 div 2^-e) * 2^-e + (10*p2 mod 2^-e)) * 2^e
+ //
+ JSON_ASSERT(p2 <= (std::numeric_limits<std::uint64_t>::max)() / 10);
+ p2 *= 10;
+ const std::uint64_t d = p2 >> -one.e; // d = (10 * p2) div 2^-e
+ const std::uint64_t r = p2 & (one.f - 1); // r = (10 * p2) mod 2^-e
+ //
+ // M+ = buffer * 10^-m + 10^-m * (1/10 * (d * 2^-e + r) * 2^e
+ // = buffer * 10^-m + 10^-m * (1/10 * (d + r * 2^e))
+ // = (buffer * 10 + d) * 10^(-m-1) + 10^(-m-1) * r * 2^e
+ //
+ JSON_ASSERT(d <= 9);
+ buffer[length++] = static_cast<char>('0' + d); // buffer := buffer * 10 + d
+ //
+ // M+ = buffer * 10^(-m-1) + 10^(-m-1) * r * 2^e
+ //
+ p2 = r;
+ m++;
+ //
+ // M+ = buffer * 10^-m + 10^-m * p2 * 2^e
+ // Invariant restored.
+
+ // Check if enough digits have been generated.
+ //
+ // 10^-m * p2 * 2^e <= delta * 2^e
+ // p2 * 2^e <= 10^m * delta * 2^e
+ // p2 <= 10^m * delta
+ delta *= 10;
+ dist *= 10;
+ if (p2 <= delta)
+ {
+ break;
+ }
+ }
+
+ // V = buffer * 10^-m, with M- <= V <= M+.
+
+ decimal_exponent -= m;
+
+ // 1 ulp in the decimal representation is now 10^-m.
+ // Since delta and dist are now scaled by 10^m, we need to do the
+ // same with ulp in order to keep the units in sync.
+ //
+ // 10^m * 10^-m = 1 = 2^-e * 2^e = ten_m * 2^e
+ //
+ const std::uint64_t ten_m = one.f;
+ grisu2_round(buffer, length, dist, delta, p2, ten_m);
+
+ // By construction this algorithm generates the shortest possible decimal
+ // number (Loitsch, Theorem 6.2) which rounds back to w.
+ // For an input number of precision p, at least
+ //
+ // N = 1 + ceil(p * log_10(2))
+ //
+ // decimal digits are sufficient to identify all binary floating-point
+ // numbers (Matula, "In-and-Out conversions").
+ // This implies that the algorithm does not produce more than N decimal
+ // digits.
+ //
+ // N = 17 for p = 53 (IEEE double precision)
+ // N = 9 for p = 24 (IEEE single precision)
+}
+
+/*!
+v = buf * 10^decimal_exponent
+len is the length of the buffer (number of decimal digits)
+The buffer must be large enough, i.e. >= max_digits10.
+*/
+JSON_HEDLEY_NON_NULL(1)
+inline void grisu2(char* buf, int& len, int& decimal_exponent,
+ diyfp m_minus, diyfp v, diyfp m_plus)
+{
+ JSON_ASSERT(m_plus.e == m_minus.e);
+ JSON_ASSERT(m_plus.e == v.e);
+
+ // --------(-----------------------+-----------------------)-------- (A)
+ // m- v m+
+ //
+ // --------------------(-----------+-----------------------)-------- (B)
+ // m- v m+
+ //
+ // First scale v (and m- and m+) such that the exponent is in the range
+ // [alpha, gamma].
+
+ const cached_power cached = get_cached_power_for_binary_exponent(m_plus.e);
+
+ const diyfp c_minus_k(cached.f, cached.e); // = c ~= 10^-k
+
+ // The exponent of the products is = v.e + c_minus_k.e + q and is in the range [alpha,gamma]
+ const diyfp w = diyfp::mul(v, c_minus_k);
+ const diyfp w_minus = diyfp::mul(m_minus, c_minus_k);
+ const diyfp w_plus = diyfp::mul(m_plus, c_minus_k);
+
+ // ----(---+---)---------------(---+---)---------------(---+---)----
+ // w- w w+
+ // = c*m- = c*v = c*m+
+ //
+ // diyfp::mul rounds its result and c_minus_k is approximated too. w, w- and
+ // w+ are now off by a small amount.
+ // In fact:
+ //
+ // w - v * 10^k < 1 ulp
+ //
+ // To account for this inaccuracy, add resp. subtract 1 ulp.
+ //
+ // --------+---[---------------(---+---)---------------]---+--------
+ // w- M- w M+ w+
+ //
+ // Now any number in [M-, M+] (bounds included) will round to w when input,
+ // regardless of how the input rounding algorithm breaks ties.
+ //
+ // And digit_gen generates the shortest possible such number in [M-, M+].
+ // Note that this does not mean that Grisu2 always generates the shortest
+ // possible number in the interval (m-, m+).
+ const diyfp M_minus(w_minus.f + 1, w_minus.e);
+ const diyfp M_plus (w_plus.f - 1, w_plus.e );
+
+ decimal_exponent = -cached.k; // = -(-k) = k
+
+ grisu2_digit_gen(buf, len, decimal_exponent, M_minus, w, M_plus);
+}
+
+/*!
+v = buf * 10^decimal_exponent
+len is the length of the buffer (number of decimal digits)
+The buffer must be large enough, i.e. >= max_digits10.
+*/
+template<typename FloatType>
+JSON_HEDLEY_NON_NULL(1)
+void grisu2(char* buf, int& len, int& decimal_exponent, FloatType value)
+{
+ static_assert(diyfp::kPrecision >= std::numeric_limits<FloatType>::digits + 3,
+ "internal error: not enough precision");
+
+ JSON_ASSERT(std::isfinite(value));
+ JSON_ASSERT(value > 0);
+
+ // If the neighbors (and boundaries) of 'value' are always computed for double-precision
+ // numbers, all float's can be recovered using strtod (and strtof). However, the resulting
+ // decimal representations are not exactly "short".
+ //
+ // The documentation for 'std::to_chars' (https://en.cppreference.com/w/cpp/utility/to_chars)
+ // says "value is converted to a string as if by std::sprintf in the default ("C") locale"
+ // and since sprintf promotes floats to doubles, I think this is exactly what 'std::to_chars'
+ // does.
+ // On the other hand, the documentation for 'std::to_chars' requires that "parsing the
+ // representation using the corresponding std::from_chars function recovers value exactly". That
+ // indicates that single precision floating-point numbers should be recovered using
+ // 'std::strtof'.
+ //
+ // NB: If the neighbors are computed for single-precision numbers, there is a single float
+ // (7.0385307e-26f) which can't be recovered using strtod. The resulting double precision
+ // value is off by 1 ulp.
+#if 0
+ const boundaries w = compute_boundaries(static_cast<double>(value));
+#else
+ const boundaries w = compute_boundaries(value);
+#endif
+
+ grisu2(buf, len, decimal_exponent, w.minus, w.w, w.plus);
+}
+
+/*!
+@brief appends a decimal representation of e to buf
+@return a pointer to the element following the exponent.
+@pre -1000 < e < 1000
+*/
+JSON_HEDLEY_NON_NULL(1)
+JSON_HEDLEY_RETURNS_NON_NULL
+inline char* append_exponent(char* buf, int e)
+{
+ JSON_ASSERT(e > -1000);
+ JSON_ASSERT(e < 1000);
+
+ if (e < 0)
+ {
+ e = -e;
+ *buf++ = '-';
+ }
+ else
+ {
+ *buf++ = '+';
+ }
+
+ auto k = static_cast<std::uint32_t>(e);
+ if (k < 10)
+ {
+ // Always print at least two digits in the exponent.
+ // This is for compatibility with printf("%g").
+ *buf++ = '0';
+ *buf++ = static_cast<char>('0' + k);
+ }
+ else if (k < 100)
+ {
+ *buf++ = static_cast<char>('0' + k / 10);
+ k %= 10;
+ *buf++ = static_cast<char>('0' + k);
+ }
+ else
+ {
+ *buf++ = static_cast<char>('0' + k / 100);
+ k %= 100;
+ *buf++ = static_cast<char>('0' + k / 10);
+ k %= 10;
+ *buf++ = static_cast<char>('0' + k);
+ }
+
+ return buf;
+}
+
+/*!
+@brief prettify v = buf * 10^decimal_exponent
+
+If v is in the range [10^min_exp, 10^max_exp) it will be printed in fixed-point
+notation. Otherwise it will be printed in exponential notation.
+
+@pre min_exp < 0
+@pre max_exp > 0
+*/
+JSON_HEDLEY_NON_NULL(1)
+JSON_HEDLEY_RETURNS_NON_NULL
+inline char* format_buffer(char* buf, int len, int decimal_exponent,
+ int min_exp, int max_exp)
+{
+ JSON_ASSERT(min_exp < 0);
+ JSON_ASSERT(max_exp > 0);
+
+ const int k = len;
+ const int n = len + decimal_exponent;
+
+ // v = buf * 10^(n-k)
+ // k is the length of the buffer (number of decimal digits)
+ // n is the position of the decimal point relative to the start of the buffer.
+
+ if (k <= n && n <= max_exp)
+ {
+ // digits[000]
+ // len <= max_exp + 2
+
+ std::memset(buf + k, '0', static_cast<size_t>(n) - static_cast<size_t>(k));
+ // Make it look like a floating-point number (#362, #378)
+ buf[n + 0] = '.';
+ buf[n + 1] = '0';
+ return buf + (static_cast<size_t>(n) + 2);
+ }
+
+ if (0 < n && n <= max_exp)
+ {
+ // dig.its
+ // len <= max_digits10 + 1
+
+ JSON_ASSERT(k > n);
+
+ std::memmove(buf + (static_cast<size_t>(n) + 1), buf + n, static_cast<size_t>(k) - static_cast<size_t>(n));
+ buf[n] = '.';
+ return buf + (static_cast<size_t>(k) + 1U);
+ }
+
+ if (min_exp < n && n <= 0)
+ {
+ // 0.[000]digits
+ // len <= 2 + (-min_exp - 1) + max_digits10
+
+ std::memmove(buf + (2 + static_cast<size_t>(-n)), buf, static_cast<size_t>(k));
+ buf[0] = '0';
+ buf[1] = '.';
+ std::memset(buf + 2, '0', static_cast<size_t>(-n));
+ return buf + (2U + static_cast<size_t>(-n) + static_cast<size_t>(k));
+ }
+
+ if (k == 1)
+ {
+ // dE+123
+ // len <= 1 + 5
+
+ buf += 1;
+ }
+ else
+ {
+ // d.igitsE+123
+ // len <= max_digits10 + 1 + 5
+
+ std::memmove(buf + 2, buf + 1, static_cast<size_t>(k) - 1);
+ buf[1] = '.';
+ buf += 1 + static_cast<size_t>(k);
+ }
+
+ *buf++ = 'e';
+ return append_exponent(buf, n - 1);
+}
+
+} // namespace dtoa_impl
+
+/*!
+@brief generates a decimal representation of the floating-point number value in [first, last).
+
+The format of the resulting decimal representation is similar to printf's %g
+format. Returns an iterator pointing past-the-end of the decimal representation.
+
+@note The input number must be finite, i.e. NaN's and Inf's are not supported.
+@note The buffer must be large enough.
+@note The result is NOT null-terminated.
+*/
+template<typename FloatType>
+JSON_HEDLEY_NON_NULL(1, 2)
+JSON_HEDLEY_RETURNS_NON_NULL
+char* to_chars(char* first, const char* last, FloatType value)
+{
+ static_cast<void>(last); // maybe unused - fix warning
+ JSON_ASSERT(std::isfinite(value));
+
+ // Use signbit(value) instead of (value < 0) since signbit works for -0.
+ if (std::signbit(value))
+ {
+ value = -value;
+ *first++ = '-';
+ }
+
+#ifdef __GNUC__
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wfloat-equal"
+#endif
+ if (value == 0) // +-0
+ {
+ *first++ = '0';
+ // Make it look like a floating-point number (#362, #378)
+ *first++ = '.';
+ *first++ = '0';
+ return first;
+ }
+#ifdef __GNUC__
+#pragma GCC diagnostic pop
+#endif
+
+ JSON_ASSERT(last - first >= std::numeric_limits<FloatType>::max_digits10);
+
+ // Compute v = buffer * 10^decimal_exponent.
+ // The decimal digits are stored in the buffer, which needs to be interpreted
+ // as an unsigned decimal integer.
+ // len is the length of the buffer, i.e. the number of decimal digits.
+ int len = 0;
+ int decimal_exponent = 0;
+ dtoa_impl::grisu2(first, len, decimal_exponent, value);
+
+ JSON_ASSERT(len <= std::numeric_limits<FloatType>::max_digits10);
+
+ // Format the buffer like printf("%.*g", prec, value)
+ constexpr int kMinExp = -4;
+ // Use digits10 here to increase compatibility with version 2.
+ constexpr int kMaxExp = std::numeric_limits<FloatType>::digits10;
+
+ JSON_ASSERT(last - first >= kMaxExp + 2);
+ JSON_ASSERT(last - first >= 2 + (-kMinExp - 1) + std::numeric_limits<FloatType>::max_digits10);
+ JSON_ASSERT(last - first >= std::numeric_limits<FloatType>::max_digits10 + 6);
+
+ return dtoa_impl::format_buffer(first, len, decimal_exponent, kMinExp, kMaxExp);
+}
+
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/exceptions.hpp>
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+// #include <nlohmann/detail/meta/cpp_future.hpp>
+
+// #include <nlohmann/detail/output/binary_writer.hpp>
+
+// #include <nlohmann/detail/output/output_adapters.hpp>
+
+// #include <nlohmann/detail/value_t.hpp>
+
+
+namespace nlohmann
+{
+namespace detail
+{
+///////////////////
+// serialization //
+///////////////////
+
+/// how to treat decoding errors
+enum class error_handler_t
+{
+ strict, ///< throw a type_error exception in case of invalid UTF-8
+ replace, ///< replace invalid UTF-8 sequences with U+FFFD
+ ignore ///< ignore invalid UTF-8 sequences
+};
+
+template<typename BasicJsonType>
+class serializer
+{
+ using string_t = typename BasicJsonType::string_t;
+ using number_float_t = typename BasicJsonType::number_float_t;
+ using number_integer_t = typename BasicJsonType::number_integer_t;
+ using number_unsigned_t = typename BasicJsonType::number_unsigned_t;
+ using binary_char_t = typename BasicJsonType::binary_t::value_type;
+ static constexpr std::uint8_t UTF8_ACCEPT = 0;
+ static constexpr std::uint8_t UTF8_REJECT = 1;
+
+ public:
+ /*!
+ @param[in] s output stream to serialize to
+ @param[in] ichar indentation character to use
+ @param[in] error_handler_ how to react on decoding errors
+ */
+ serializer(output_adapter_t<char> s, const char ichar,
+ error_handler_t error_handler_ = error_handler_t::strict)
+ : o(std::move(s))
+ , loc(std::localeconv())
+ , thousands_sep(loc->thousands_sep == nullptr ? '\0' : std::char_traits<char>::to_char_type(* (loc->thousands_sep)))
+ , decimal_point(loc->decimal_point == nullptr ? '\0' : std::char_traits<char>::to_char_type(* (loc->decimal_point)))
+ , indent_char(ichar)
+ , indent_string(512, indent_char)
+ , error_handler(error_handler_)
+ {}
+
+ // delete because of pointer members
+ serializer(const serializer&) = delete;
+ serializer& operator=(const serializer&) = delete;
+ serializer(serializer&&) = delete;
+ serializer& operator=(serializer&&) = delete;
+ ~serializer() = default;
+
+ /*!
+ @brief internal implementation of the serialization function
+
+ This function is called by the public member function dump and organizes
+ the serialization internally. The indentation level is propagated as
+ additional parameter. In case of arrays and objects, the function is
+ called recursively.
+
+ - strings and object keys are escaped using `escape_string()`
+ - integer numbers are converted implicitly via `operator<<`
+ - floating-point numbers are converted to a string using `"%g"` format
+ - binary values are serialized as objects containing the subtype and the
+ byte array
+
+ @param[in] val value to serialize
+ @param[in] pretty_print whether the output shall be pretty-printed
+ @param[in] ensure_ascii If @a ensure_ascii is true, all non-ASCII characters
+ in the output are escaped with `\uXXXX` sequences, and the result consists
+ of ASCII characters only.
+ @param[in] indent_step the indent level
+ @param[in] current_indent the current indent level (only used internally)
+ */
+ void dump(const BasicJsonType& val,
+ const bool pretty_print,
+ const bool ensure_ascii,
+ const unsigned int indent_step,
+ const unsigned int current_indent = 0)
+ {
+ switch (val.m_type)
+ {
+ case value_t::object:
+ {
+ if (val.m_value.object->empty())
+ {
+ o->write_characters("{}", 2);
+ return;
+ }
+
+ if (pretty_print)
+ {
+ o->write_characters("{\n", 2);
+
+ // variable to hold indentation for recursive calls
+ const auto new_indent = current_indent + indent_step;
+ if (JSON_HEDLEY_UNLIKELY(indent_string.size() < new_indent))
+ {
+ indent_string.resize(indent_string.size() * 2, ' ');
+ }
+
+ // first n-1 elements
+ auto i = val.m_value.object->cbegin();
+ for (std::size_t cnt = 0; cnt < val.m_value.object->size() - 1; ++cnt, ++i)
+ {
+ o->write_characters(indent_string.c_str(), new_indent);
+ o->write_character('\"');
+ dump_escaped(i->first, ensure_ascii);
+ o->write_characters("\": ", 3);
+ dump(i->second, true, ensure_ascii, indent_step, new_indent);
+ o->write_characters(",\n", 2);
+ }
+
+ // last element
+ JSON_ASSERT(i != val.m_value.object->cend());
+ JSON_ASSERT(std::next(i) == val.m_value.object->cend());
+ o->write_characters(indent_string.c_str(), new_indent);
+ o->write_character('\"');
+ dump_escaped(i->first, ensure_ascii);
+ o->write_characters("\": ", 3);
+ dump(i->second, true, ensure_ascii, indent_step, new_indent);
+
+ o->write_character('\n');
+ o->write_characters(indent_string.c_str(), current_indent);
+ o->write_character('}');
+ }
+ else
+ {
+ o->write_character('{');
+
+ // first n-1 elements
+ auto i = val.m_value.object->cbegin();
+ for (std::size_t cnt = 0; cnt < val.m_value.object->size() - 1; ++cnt, ++i)
+ {
+ o->write_character('\"');
+ dump_escaped(i->first, ensure_ascii);
+ o->write_characters("\":", 2);
+ dump(i->second, false, ensure_ascii, indent_step, current_indent);
+ o->write_character(',');
+ }
+
+ // last element
+ JSON_ASSERT(i != val.m_value.object->cend());
+ JSON_ASSERT(std::next(i) == val.m_value.object->cend());
+ o->write_character('\"');
+ dump_escaped(i->first, ensure_ascii);
+ o->write_characters("\":", 2);
+ dump(i->second, false, ensure_ascii, indent_step, current_indent);
+
+ o->write_character('}');
+ }
+
+ return;
+ }
+
+ case value_t::array:
+ {
+ if (val.m_value.array->empty())
+ {
+ o->write_characters("[]", 2);
+ return;
+ }
+
+ if (pretty_print)
+ {
+ o->write_characters("[\n", 2);
+
+ // variable to hold indentation for recursive calls
+ const auto new_indent = current_indent + indent_step;
+ if (JSON_HEDLEY_UNLIKELY(indent_string.size() < new_indent))
+ {
+ indent_string.resize(indent_string.size() * 2, ' ');
+ }
+
+ // first n-1 elements
+ for (auto i = val.m_value.array->cbegin();
+ i != val.m_value.array->cend() - 1; ++i)
+ {
+ o->write_characters(indent_string.c_str(), new_indent);
+ dump(*i, true, ensure_ascii, indent_step, new_indent);
+ o->write_characters(",\n", 2);
+ }
+
+ // last element
+ JSON_ASSERT(!val.m_value.array->empty());
+ o->write_characters(indent_string.c_str(), new_indent);
+ dump(val.m_value.array->back(), true, ensure_ascii, indent_step, new_indent);
+
+ o->write_character('\n');
+ o->write_characters(indent_string.c_str(), current_indent);
+ o->write_character(']');
+ }
+ else
+ {
+ o->write_character('[');
+
+ // first n-1 elements
+ for (auto i = val.m_value.array->cbegin();
+ i != val.m_value.array->cend() - 1; ++i)
+ {
+ dump(*i, false, ensure_ascii, indent_step, current_indent);
+ o->write_character(',');
+ }
+
+ // last element
+ JSON_ASSERT(!val.m_value.array->empty());
+ dump(val.m_value.array->back(), false, ensure_ascii, indent_step, current_indent);
+
+ o->write_character(']');
+ }
+
+ return;
+ }
+
+ case value_t::string:
+ {
+ o->write_character('\"');
+ dump_escaped(*val.m_value.string, ensure_ascii);
+ o->write_character('\"');
+ return;
+ }
+
+ case value_t::binary:
+ {
+ if (pretty_print)
+ {
+ o->write_characters("{\n", 2);
+
+ // variable to hold indentation for recursive calls
+ const auto new_indent = current_indent + indent_step;
+ if (JSON_HEDLEY_UNLIKELY(indent_string.size() < new_indent))
+ {
+ indent_string.resize(indent_string.size() * 2, ' ');
+ }
+
+ o->write_characters(indent_string.c_str(), new_indent);
+
+ o->write_characters("\"bytes\": [", 10);
+
+ if (!val.m_value.binary->empty())
+ {
+ for (auto i = val.m_value.binary->cbegin();
+ i != val.m_value.binary->cend() - 1; ++i)
+ {
+ dump_integer(*i);
+ o->write_characters(", ", 2);
+ }
+ dump_integer(val.m_value.binary->back());
+ }
+
+ o->write_characters("],\n", 3);
+ o->write_characters(indent_string.c_str(), new_indent);
+
+ o->write_characters("\"subtype\": ", 11);
+ if (val.m_value.binary->has_subtype())
+ {
+ dump_integer(val.m_value.binary->subtype());
+ }
+ else
+ {
+ o->write_characters("null", 4);
+ }
+ o->write_character('\n');
+ o->write_characters(indent_string.c_str(), current_indent);
+ o->write_character('}');
+ }
+ else
+ {
+ o->write_characters("{\"bytes\":[", 10);
+
+ if (!val.m_value.binary->empty())
+ {
+ for (auto i = val.m_value.binary->cbegin();
+ i != val.m_value.binary->cend() - 1; ++i)
+ {
+ dump_integer(*i);
+ o->write_character(',');
+ }
+ dump_integer(val.m_value.binary->back());
+ }
+
+ o->write_characters("],\"subtype\":", 12);
+ if (val.m_value.binary->has_subtype())
+ {
+ dump_integer(val.m_value.binary->subtype());
+ o->write_character('}');
+ }
+ else
+ {
+ o->write_characters("null}", 5);
+ }
+ }
+ return;
+ }
+
+ case value_t::boolean:
+ {
+ if (val.m_value.boolean)
+ {
+ o->write_characters("true", 4);
+ }
+ else
+ {
+ o->write_characters("false", 5);
+ }
+ return;
+ }
+
+ case value_t::number_integer:
+ {
+ dump_integer(val.m_value.number_integer);
+ return;
+ }
+
+ case value_t::number_unsigned:
+ {
+ dump_integer(val.m_value.number_unsigned);
+ return;
+ }
+
+ case value_t::number_float:
+ {
+ dump_float(val.m_value.number_float);
+ return;
+ }
+
+ case value_t::discarded:
+ {
+ o->write_characters("<discarded>", 11);
+ return;
+ }
+
+ case value_t::null:
+ {
+ o->write_characters("null", 4);
+ return;
+ }
+
+ default: // LCOV_EXCL_LINE
+ JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert) LCOV_EXCL_LINE
+ }
+ }
+
+ JSON_PRIVATE_UNLESS_TESTED:
+ /*!
+ @brief dump escaped string
+
+ Escape a string by replacing certain special characters by a sequence of an
+ escape character (backslash) and another character and other control
+ characters by a sequence of "\u" followed by a four-digit hex
+ representation. The escaped string is written to output stream @a o.
+
+ @param[in] s the string to escape
+ @param[in] ensure_ascii whether to escape non-ASCII characters with
+ \uXXXX sequences
+
+ @complexity Linear in the length of string @a s.
+ */
+ void dump_escaped(const string_t& s, const bool ensure_ascii)
+ {
+ std::uint32_t codepoint{};
+ std::uint8_t state = UTF8_ACCEPT;
+ std::size_t bytes = 0; // number of bytes written to string_buffer
+
+ // number of bytes written at the point of the last valid byte
+ std::size_t bytes_after_last_accept = 0;
+ std::size_t undumped_chars = 0;
+
+ for (std::size_t i = 0; i < s.size(); ++i)
+ {
+ const auto byte = static_cast<std::uint8_t>(s[i]);
+
+ switch (decode(state, codepoint, byte))
+ {
+ case UTF8_ACCEPT: // decode found a new code point
+ {
+ switch (codepoint)
+ {
+ case 0x08: // backspace
+ {
+ string_buffer[bytes++] = '\\';
+ string_buffer[bytes++] = 'b';
+ break;
+ }
+
+ case 0x09: // horizontal tab
+ {
+ string_buffer[bytes++] = '\\';
+ string_buffer[bytes++] = 't';
+ break;
+ }
+
+ case 0x0A: // newline
+ {
+ string_buffer[bytes++] = '\\';
+ string_buffer[bytes++] = 'n';
+ break;
+ }
+
+ case 0x0C: // formfeed
+ {
+ string_buffer[bytes++] = '\\';
+ string_buffer[bytes++] = 'f';
+ break;
+ }
+
+ case 0x0D: // carriage return
+ {
+ string_buffer[bytes++] = '\\';
+ string_buffer[bytes++] = 'r';
+ break;
+ }
+
+ case 0x22: // quotation mark
+ {
+ string_buffer[bytes++] = '\\';
+ string_buffer[bytes++] = '\"';
+ break;
+ }
+
+ case 0x5C: // reverse solidus
+ {
+ string_buffer[bytes++] = '\\';
+ string_buffer[bytes++] = '\\';
+ break;
+ }
+
+ default:
+ {
+ // escape control characters (0x00..0x1F) or, if
+ // ensure_ascii parameter is used, non-ASCII characters
+ if ((codepoint <= 0x1F) || (ensure_ascii && (codepoint >= 0x7F)))
+ {
+ if (codepoint <= 0xFFFF)
+ {
+ // NOLINTNEXTLINE(cppcoreguidelines-pro-type-vararg,hicpp-vararg)
+ static_cast<void>((std::snprintf)(string_buffer.data() + bytes, 7, "\\u%04x",
+ static_cast<std::uint16_t>(codepoint)));
+ bytes += 6;
+ }
+ else
+ {
+ // NOLINTNEXTLINE(cppcoreguidelines-pro-type-vararg,hicpp-vararg)
+ static_cast<void>((std::snprintf)(string_buffer.data() + bytes, 13, "\\u%04x\\u%04x",
+ static_cast<std::uint16_t>(0xD7C0u + (codepoint >> 10u)),
+ static_cast<std::uint16_t>(0xDC00u + (codepoint & 0x3FFu))));
+ bytes += 12;
+ }
+ }
+ else
+ {
+ // copy byte to buffer (all previous bytes
+ // been copied have in default case above)
+ string_buffer[bytes++] = s[i];
+ }
+ break;
+ }
+ }
+
+ // write buffer and reset index; there must be 13 bytes
+ // left, as this is the maximal number of bytes to be
+ // written ("\uxxxx\uxxxx\0") for one code point
+ if (string_buffer.size() - bytes < 13)
+ {
+ o->write_characters(string_buffer.data(), bytes);
+ bytes = 0;
+ }
+
+ // remember the byte position of this accept
+ bytes_after_last_accept = bytes;
+ undumped_chars = 0;
+ break;
+ }
+
+ case UTF8_REJECT: // decode found invalid UTF-8 byte
+ {
+ switch (error_handler)
+ {
+ case error_handler_t::strict:
+ {
+ std::stringstream ss;
+ ss << std::uppercase << std::setfill('0') << std::setw(2) << std::hex << (byte | 0);
+ JSON_THROW(type_error::create(316, "invalid UTF-8 byte at index " + std::to_string(i) + ": 0x" + ss.str(), BasicJsonType()));
+ }
+
+ case error_handler_t::ignore:
+ case error_handler_t::replace:
+ {
+ // in case we saw this character the first time, we
+ // would like to read it again, because the byte
+ // may be OK for itself, but just not OK for the
+ // previous sequence
+ if (undumped_chars > 0)
+ {
+ --i;
+ }
+
+ // reset length buffer to the last accepted index;
+ // thus removing/ignoring the invalid characters
+ bytes = bytes_after_last_accept;
+
+ if (error_handler == error_handler_t::replace)
+ {
+ // add a replacement character
+ if (ensure_ascii)
+ {
+ string_buffer[bytes++] = '\\';
+ string_buffer[bytes++] = 'u';
+ string_buffer[bytes++] = 'f';
+ string_buffer[bytes++] = 'f';
+ string_buffer[bytes++] = 'f';
+ string_buffer[bytes++] = 'd';
+ }
+ else
+ {
+ string_buffer[bytes++] = detail::binary_writer<BasicJsonType, char>::to_char_type('\xEF');
+ string_buffer[bytes++] = detail::binary_writer<BasicJsonType, char>::to_char_type('\xBF');
+ string_buffer[bytes++] = detail::binary_writer<BasicJsonType, char>::to_char_type('\xBD');
+ }
+
+ // write buffer and reset index; there must be 13 bytes
+ // left, as this is the maximal number of bytes to be
+ // written ("\uxxxx\uxxxx\0") for one code point
+ if (string_buffer.size() - bytes < 13)
+ {
+ o->write_characters(string_buffer.data(), bytes);
+ bytes = 0;
+ }
+
+ bytes_after_last_accept = bytes;
+ }
+
+ undumped_chars = 0;
+
+ // continue processing the string
+ state = UTF8_ACCEPT;
+ break;
+ }
+
+ default: // LCOV_EXCL_LINE
+ JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert) LCOV_EXCL_LINE
+ }
+ break;
+ }
+
+ default: // decode found yet incomplete multi-byte code point
+ {
+ if (!ensure_ascii)
+ {
+ // code point will not be escaped - copy byte to buffer
+ string_buffer[bytes++] = s[i];
+ }
+ ++undumped_chars;
+ break;
+ }
+ }
+ }
+
+ // we finished processing the string
+ if (JSON_HEDLEY_LIKELY(state == UTF8_ACCEPT))
+ {
+ // write buffer
+ if (bytes > 0)
+ {
+ o->write_characters(string_buffer.data(), bytes);
+ }
+ }
+ else
+ {
+ // we finish reading, but do not accept: string was incomplete
+ switch (error_handler)
+ {
+ case error_handler_t::strict:
+ {
+ std::stringstream ss;
+ ss << std::uppercase << std::setfill('0') << std::setw(2) << std::hex << (static_cast<std::uint8_t>(s.back()) | 0);
+ JSON_THROW(type_error::create(316, "incomplete UTF-8 string; last byte: 0x" + ss.str(), BasicJsonType()));
+ }
+
+ case error_handler_t::ignore:
+ {
+ // write all accepted bytes
+ o->write_characters(string_buffer.data(), bytes_after_last_accept);
+ break;
+ }
+
+ case error_handler_t::replace:
+ {
+ // write all accepted bytes
+ o->write_characters(string_buffer.data(), bytes_after_last_accept);
+ // add a replacement character
+ if (ensure_ascii)
+ {
+ o->write_characters("\\ufffd", 6);
+ }
+ else
+ {
+ o->write_characters("\xEF\xBF\xBD", 3);
+ }
+ break;
+ }
+
+ default: // LCOV_EXCL_LINE
+ JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert) LCOV_EXCL_LINE
+ }
+ }
+ }
+
+ private:
+ /*!
+ @brief count digits
+
+ Count the number of decimal (base 10) digits for an input unsigned integer.
+
+ @param[in] x unsigned integer number to count its digits
+ @return number of decimal digits
+ */
+ inline unsigned int count_digits(number_unsigned_t x) noexcept
+ {
+ unsigned int n_digits = 1;
+ for (;;)
+ {
+ if (x < 10)
+ {
+ return n_digits;
+ }
+ if (x < 100)
+ {
+ return n_digits + 1;
+ }
+ if (x < 1000)
+ {
+ return n_digits + 2;
+ }
+ if (x < 10000)
+ {
+ return n_digits + 3;
+ }
+ x = x / 10000u;
+ n_digits += 4;
+ }
+ }
+
+ // templates to avoid warnings about useless casts
+ template <typename NumberType, enable_if_t<std::is_signed<NumberType>::value, int> = 0>
+ bool is_negative_number(NumberType x)
+ {
+ return x < 0;
+ }
+
+ template < typename NumberType, enable_if_t <std::is_unsigned<NumberType>::value, int > = 0 >
+ bool is_negative_number(NumberType /*unused*/)
+ {
+ return false;
+ }
+
+ /*!
+ @brief dump an integer
+
+ Dump a given integer to output stream @a o. Works internally with
+ @a number_buffer.
+
+ @param[in] x integer number (signed or unsigned) to dump
+ @tparam NumberType either @a number_integer_t or @a number_unsigned_t
+ */
+ template < typename NumberType, detail::enable_if_t <
+ std::is_integral<NumberType>::value ||
+ std::is_same<NumberType, number_unsigned_t>::value ||
+ std::is_same<NumberType, number_integer_t>::value ||
+ std::is_same<NumberType, binary_char_t>::value,
+ int > = 0 >
+ void dump_integer(NumberType x)
+ {
+ static constexpr std::array<std::array<char, 2>, 100> digits_to_99
+ {
+ {
+ {{'0', '0'}}, {{'0', '1'}}, {{'0', '2'}}, {{'0', '3'}}, {{'0', '4'}}, {{'0', '5'}}, {{'0', '6'}}, {{'0', '7'}}, {{'0', '8'}}, {{'0', '9'}},
+ {{'1', '0'}}, {{'1', '1'}}, {{'1', '2'}}, {{'1', '3'}}, {{'1', '4'}}, {{'1', '5'}}, {{'1', '6'}}, {{'1', '7'}}, {{'1', '8'}}, {{'1', '9'}},
+ {{'2', '0'}}, {{'2', '1'}}, {{'2', '2'}}, {{'2', '3'}}, {{'2', '4'}}, {{'2', '5'}}, {{'2', '6'}}, {{'2', '7'}}, {{'2', '8'}}, {{'2', '9'}},
+ {{'3', '0'}}, {{'3', '1'}}, {{'3', '2'}}, {{'3', '3'}}, {{'3', '4'}}, {{'3', '5'}}, {{'3', '6'}}, {{'3', '7'}}, {{'3', '8'}}, {{'3', '9'}},
+ {{'4', '0'}}, {{'4', '1'}}, {{'4', '2'}}, {{'4', '3'}}, {{'4', '4'}}, {{'4', '5'}}, {{'4', '6'}}, {{'4', '7'}}, {{'4', '8'}}, {{'4', '9'}},
+ {{'5', '0'}}, {{'5', '1'}}, {{'5', '2'}}, {{'5', '3'}}, {{'5', '4'}}, {{'5', '5'}}, {{'5', '6'}}, {{'5', '7'}}, {{'5', '8'}}, {{'5', '9'}},
+ {{'6', '0'}}, {{'6', '1'}}, {{'6', '2'}}, {{'6', '3'}}, {{'6', '4'}}, {{'6', '5'}}, {{'6', '6'}}, {{'6', '7'}}, {{'6', '8'}}, {{'6', '9'}},
+ {{'7', '0'}}, {{'7', '1'}}, {{'7', '2'}}, {{'7', '3'}}, {{'7', '4'}}, {{'7', '5'}}, {{'7', '6'}}, {{'7', '7'}}, {{'7', '8'}}, {{'7', '9'}},
+ {{'8', '0'}}, {{'8', '1'}}, {{'8', '2'}}, {{'8', '3'}}, {{'8', '4'}}, {{'8', '5'}}, {{'8', '6'}}, {{'8', '7'}}, {{'8', '8'}}, {{'8', '9'}},
+ {{'9', '0'}}, {{'9', '1'}}, {{'9', '2'}}, {{'9', '3'}}, {{'9', '4'}}, {{'9', '5'}}, {{'9', '6'}}, {{'9', '7'}}, {{'9', '8'}}, {{'9', '9'}},
+ }
+ };
+
+ // special case for "0"
+ if (x == 0)
+ {
+ o->write_character('0');
+ return;
+ }
+
+ // use a pointer to fill the buffer
+ auto buffer_ptr = number_buffer.begin(); // NOLINT(llvm-qualified-auto,readability-qualified-auto,cppcoreguidelines-pro-type-vararg,hicpp-vararg)
+
+ number_unsigned_t abs_value;
+
+ unsigned int n_chars{};
+
+ if (is_negative_number(x))
+ {
+ *buffer_ptr = '-';
+ abs_value = remove_sign(static_cast<number_integer_t>(x));
+
+ // account one more byte for the minus sign
+ n_chars = 1 + count_digits(abs_value);
+ }
+ else
+ {
+ abs_value = static_cast<number_unsigned_t>(x);
+ n_chars = count_digits(abs_value);
+ }
+
+ // spare 1 byte for '\0'
+ JSON_ASSERT(n_chars < number_buffer.size() - 1);
+
+ // jump to the end to generate the string from backward,
+ // so we later avoid reversing the result
+ buffer_ptr += n_chars;
+
+ // Fast int2ascii implementation inspired by "Fastware" talk by Andrei Alexandrescu
+ // See: https://www.youtube.com/watch?v=o4-CwDo2zpg
+ while (abs_value >= 100)
+ {
+ const auto digits_index = static_cast<unsigned>((abs_value % 100));
+ abs_value /= 100;
+ *(--buffer_ptr) = digits_to_99[digits_index][1];
+ *(--buffer_ptr) = digits_to_99[digits_index][0];
+ }
+
+ if (abs_value >= 10)
+ {
+ const auto digits_index = static_cast<unsigned>(abs_value);
+ *(--buffer_ptr) = digits_to_99[digits_index][1];
+ *(--buffer_ptr) = digits_to_99[digits_index][0];
+ }
+ else
+ {
+ *(--buffer_ptr) = static_cast<char>('0' + abs_value);
+ }
+
+ o->write_characters(number_buffer.data(), n_chars);
+ }
+
+ /*!
+ @brief dump a floating-point number
+
+ Dump a given floating-point number to output stream @a o. Works internally
+ with @a number_buffer.
+
+ @param[in] x floating-point number to dump
+ */
+ void dump_float(number_float_t x)
+ {
+ // NaN / inf
+ if (!std::isfinite(x))
+ {
+ o->write_characters("null", 4);
+ return;
+ }
+
+ // If number_float_t is an IEEE-754 single or double precision number,
+ // use the Grisu2 algorithm to produce short numbers which are
+ // guaranteed to round-trip, using strtof and strtod, resp.
+ //
+ // NB: The test below works if <long double> == <double>.
+ static constexpr bool is_ieee_single_or_double
+ = (std::numeric_limits<number_float_t>::is_iec559 && std::numeric_limits<number_float_t>::digits == 24 && std::numeric_limits<number_float_t>::max_exponent == 128) ||
+ (std::numeric_limits<number_float_t>::is_iec559 && std::numeric_limits<number_float_t>::digits == 53 && std::numeric_limits<number_float_t>::max_exponent == 1024);
+
+ dump_float(x, std::integral_constant<bool, is_ieee_single_or_double>());
+ }
+
+ void dump_float(number_float_t x, std::true_type /*is_ieee_single_or_double*/)
+ {
+ auto* begin = number_buffer.data();
+ auto* end = ::nlohmann::detail::to_chars(begin, begin + number_buffer.size(), x);
+
+ o->write_characters(begin, static_cast<size_t>(end - begin));
+ }
+
+ void dump_float(number_float_t x, std::false_type /*is_ieee_single_or_double*/)
+ {
+ // get number of digits for a float -> text -> float round-trip
+ static constexpr auto d = std::numeric_limits<number_float_t>::max_digits10;
+
+ // the actual conversion
+ // NOLINTNEXTLINE(cppcoreguidelines-pro-type-vararg,hicpp-vararg)
+ std::ptrdiff_t len = (std::snprintf)(number_buffer.data(), number_buffer.size(), "%.*g", d, x);
+
+ // negative value indicates an error
+ JSON_ASSERT(len > 0);
+ // check if buffer was large enough
+ JSON_ASSERT(static_cast<std::size_t>(len) < number_buffer.size());
+
+ // erase thousands separator
+ if (thousands_sep != '\0')
+ {
+ // NOLINTNEXTLINE(readability-qualified-auto,llvm-qualified-auto): std::remove returns an iterator, see https://github.com/nlohmann/json/issues/3081
+ const auto end = std::remove(number_buffer.begin(), number_buffer.begin() + len, thousands_sep);
+ std::fill(end, number_buffer.end(), '\0');
+ JSON_ASSERT((end - number_buffer.begin()) <= len);
+ len = (end - number_buffer.begin());
+ }
+
+ // convert decimal point to '.'
+ if (decimal_point != '\0' && decimal_point != '.')
+ {
+ // NOLINTNEXTLINE(readability-qualified-auto,llvm-qualified-auto): std::find returns an iterator, see https://github.com/nlohmann/json/issues/3081
+ const auto dec_pos = std::find(number_buffer.begin(), number_buffer.end(), decimal_point);
+ if (dec_pos != number_buffer.end())
+ {
+ *dec_pos = '.';
+ }
+ }
+
+ o->write_characters(number_buffer.data(), static_cast<std::size_t>(len));
+
+ // determine if we need to append ".0"
+ const bool value_is_int_like =
+ std::none_of(number_buffer.begin(), number_buffer.begin() + len + 1,
+ [](char c)
+ {
+ return c == '.' || c == 'e';
+ });
+
+ if (value_is_int_like)
+ {
+ o->write_characters(".0", 2);
+ }
+ }
+
+ /*!
+ @brief check whether a string is UTF-8 encoded
+
+ The function checks each byte of a string whether it is UTF-8 encoded. The
+ result of the check is stored in the @a state parameter. The function must
+ be called initially with state 0 (accept). State 1 means the string must
+ be rejected, because the current byte is not allowed. If the string is
+ completely processed, but the state is non-zero, the string ended
+ prematurely; that is, the last byte indicated more bytes should have
+ followed.
+
+ @param[in,out] state the state of the decoding
+ @param[in,out] codep codepoint (valid only if resulting state is UTF8_ACCEPT)
+ @param[in] byte next byte to decode
+ @return new state
+
+ @note The function has been edited: a std::array is used.
+
+ @copyright Copyright (c) 2008-2009 Bjoern Hoehrmann <bjoern@hoehrmann.de>
+ @sa http://bjoern.hoehrmann.de/utf-8/decoder/dfa/
+ */
+ static std::uint8_t decode(std::uint8_t& state, std::uint32_t& codep, const std::uint8_t byte) noexcept
+ {
+ static const std::array<std::uint8_t, 400> utf8d =
+ {
+ {
+ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 00..1F
+ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 20..3F
+ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 40..5F
+ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 60..7F
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 9, 9, 9, 9, 9, 9, 9, 9, 9, 9, 9, 9, 9, 9, 9, 9, // 80..9F
+ 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, // A0..BF
+ 8, 8, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, // C0..DF
+ 0xA, 0x3, 0x3, 0x3, 0x3, 0x3, 0x3, 0x3, 0x3, 0x3, 0x3, 0x3, 0x3, 0x4, 0x3, 0x3, // E0..EF
+ 0xB, 0x6, 0x6, 0x6, 0x5, 0x8, 0x8, 0x8, 0x8, 0x8, 0x8, 0x8, 0x8, 0x8, 0x8, 0x8, // F0..FF
+ 0x0, 0x1, 0x2, 0x3, 0x5, 0x8, 0x7, 0x1, 0x1, 0x1, 0x4, 0x6, 0x1, 0x1, 0x1, 0x1, // s0..s0
+ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, 0, 1, 0, 1, 1, 1, 1, 1, 1, // s1..s2
+ 1, 2, 1, 1, 1, 1, 1, 2, 1, 2, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 2, 1, 1, 1, 1, 1, 1, 1, 1, // s3..s4
+ 1, 2, 1, 1, 1, 1, 1, 1, 1, 2, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 3, 1, 3, 1, 1, 1, 1, 1, 1, // s5..s6
+ 1, 3, 1, 1, 1, 1, 1, 3, 1, 3, 1, 1, 1, 1, 1, 1, 1, 3, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1 // s7..s8
+ }
+ };
+
+ JSON_ASSERT(byte < utf8d.size());
+ const std::uint8_t type = utf8d[byte];
+
+ codep = (state != UTF8_ACCEPT)
+ ? (byte & 0x3fu) | (codep << 6u)
+ : (0xFFu >> type) & (byte);
+
+ std::size_t index = 256u + static_cast<size_t>(state) * 16u + static_cast<size_t>(type);
+ JSON_ASSERT(index < 400);
+ state = utf8d[index];
+ return state;
+ }
+
+ /*
+ * Overload to make the compiler happy while it is instantiating
+ * dump_integer for number_unsigned_t.
+ * Must never be called.
+ */
+ number_unsigned_t remove_sign(number_unsigned_t x)
+ {
+ JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert) LCOV_EXCL_LINE
+ return x; // LCOV_EXCL_LINE
+ }
+
+ /*
+ * Helper function for dump_integer
+ *
+ * This function takes a negative signed integer and returns its absolute
+ * value as unsigned integer. The plus/minus shuffling is necessary as we can
+ * not directly remove the sign of an arbitrary signed integer as the
+ * absolute values of INT_MIN and INT_MAX are usually not the same. See
+ * #1708 for details.
+ */
+ inline number_unsigned_t remove_sign(number_integer_t x) noexcept
+ {
+ JSON_ASSERT(x < 0 && x < (std::numeric_limits<number_integer_t>::max)()); // NOLINT(misc-redundant-expression)
+ return static_cast<number_unsigned_t>(-(x + 1)) + 1;
+ }
+
+ private:
+ /// the output of the serializer
+ output_adapter_t<char> o = nullptr;
+
+ /// a (hopefully) large enough character buffer
+ std::array<char, 64> number_buffer{{}};
+
+ /// the locale
+ const std::lconv* loc = nullptr;
+ /// the locale's thousand separator character
+ const char thousands_sep = '\0';
+ /// the locale's decimal point character
+ const char decimal_point = '\0';
+
+ /// string buffer
+ std::array<char, 512> string_buffer{{}};
+
+ /// the indentation character
+ const char indent_char;
+ /// the indentation string
+ string_t indent_string;
+
+ /// error_handler how to react on decoding errors
+ const error_handler_t error_handler;
+};
+} // namespace detail
+} // namespace nlohmann
+
+// #include <nlohmann/detail/value_t.hpp>
+
+// #include <nlohmann/json_fwd.hpp>
+
+// #include <nlohmann/ordered_map.hpp>
+
+
+#include <functional> // less
+#include <initializer_list> // initializer_list
+#include <iterator> // input_iterator_tag, iterator_traits
+#include <memory> // allocator
+#include <stdexcept> // for out_of_range
+#include <type_traits> // enable_if, is_convertible
+#include <utility> // pair
+#include <vector> // vector
+
+// #include <nlohmann/detail/macro_scope.hpp>
+
+
+namespace nlohmann
+{
+
+/// ordered_map: a minimal map-like container that preserves insertion order
+/// for use within nlohmann::basic_json<ordered_map>
+template <class Key, class T, class IgnoredLess = std::less<Key>,
+ class Allocator = std::allocator<std::pair<const Key, T>>>
+ struct ordered_map : std::vector<std::pair<const Key, T>, Allocator>
+{
+ using key_type = Key;
+ using mapped_type = T;
+ using Container = std::vector<std::pair<const Key, T>, Allocator>;
+ using iterator = typename Container::iterator;
+ using const_iterator = typename Container::const_iterator;
+ using size_type = typename Container::size_type;
+ using value_type = typename Container::value_type;
+
+ // Explicit constructors instead of `using Container::Container`
+ // otherwise older compilers choke on it (GCC <= 5.5, xcode <= 9.4)
+ ordered_map(const Allocator& alloc = Allocator()) : Container{alloc} {}
+ template <class It>
+ ordered_map(It first, It last, const Allocator& alloc = Allocator())
+ : Container{first, last, alloc} {}
+ ordered_map(std::initializer_list<T> init, const Allocator& alloc = Allocator() )
+ : Container{init, alloc} {}
+
+ std::pair<iterator, bool> emplace(const key_type& key, T&& t)
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (it->first == key)
+ {
+ return {it, false};
+ }
+ }
+ Container::emplace_back(key, t);
+ return {--this->end(), true};
+ }
+
+ T& operator[](const Key& key)
+ {
+ return emplace(key, T{}).first->second;
+ }
+
+ const T& operator[](const Key& key) const
+ {
+ return at(key);
+ }
+
+ T& at(const Key& key)
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (it->first == key)
+ {
+ return it->second;
+ }
+ }
+
+ JSON_THROW(std::out_of_range("key not found"));
+ }
+
+ const T& at(const Key& key) const
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (it->first == key)
+ {
+ return it->second;
+ }
+ }
+
+ JSON_THROW(std::out_of_range("key not found"));
+ }
+
+ size_type erase(const Key& key)
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (it->first == key)
+ {
+ // Since we cannot move const Keys, re-construct them in place
+ for (auto next = it; ++next != this->end(); ++it)
+ {
+ it->~value_type(); // Destroy but keep allocation
+ new (&*it) value_type{std::move(*next)};
+ }
+ Container::pop_back();
+ return 1;
+ }
+ }
+ return 0;
+ }
+
+ iterator erase(iterator pos)
+ {
+ return erase(pos, std::next(pos));
+ }
+
+ iterator erase(iterator first, iterator last)
+ {
+ const auto elements_affected = std::distance(first, last);
+ const auto offset = std::distance(Container::begin(), first);
+
+ // This is the start situation. We need to delete elements_affected
+ // elements (3 in this example: e, f, g), and need to return an
+ // iterator past the last deleted element (h in this example).
+ // Note that offset is the distance from the start of the vector
+ // to first. We will need this later.
+
+ // [ a, b, c, d, e, f, g, h, i, j ]
+ // ^ ^
+ // first last
+
+ // Since we cannot move const Keys, we re-construct them in place.
+ // We start at first and re-construct (viz. copy) the elements from
+ // the back of the vector. Example for first iteration:
+
+ // ,--------.
+ // v | destroy e and re-construct with h
+ // [ a, b, c, d, e, f, g, h, i, j ]
+ // ^ ^
+ // it it + elements_affected
+
+ for (auto it = first; std::next(it, elements_affected) != Container::end(); ++it)
+ {
+ it->~value_type(); // destroy but keep allocation
+ new (&*it) value_type{std::move(*std::next(it, elements_affected))}; // "move" next element to it
+ }
+
+ // [ a, b, c, d, h, i, j, h, i, j ]
+ // ^ ^
+ // first last
+
+ // remove the unneeded elements at the end of the vector
+ Container::resize(this->size() - static_cast<size_type>(elements_affected));
+
+ // [ a, b, c, d, h, i, j ]
+ // ^ ^
+ // first last
+
+ // first is now pointing past the last deleted element, but we cannot
+ // use this iterator, because it may have been invalidated by the
+ // resize call. Instead, we can return begin() + offset.
+ return Container::begin() + offset;
+ }
+
+ size_type count(const Key& key) const
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (it->first == key)
+ {
+ return 1;
+ }
+ }
+ return 0;
+ }
+
+ iterator find(const Key& key)
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (it->first == key)
+ {
+ return it;
+ }
+ }
+ return Container::end();
+ }
+
+ const_iterator find(const Key& key) const
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (it->first == key)
+ {
+ return it;
+ }
+ }
+ return Container::end();
+ }
+
+ std::pair<iterator, bool> insert( value_type&& value )
+ {
+ return emplace(value.first, std::move(value.second));
+ }
+
+ std::pair<iterator, bool> insert( const value_type& value )
+ {
+ for (auto it = this->begin(); it != this->end(); ++it)
+ {
+ if (it->first == value.first)
+ {
+ return {it, false};
+ }
+ }
+ Container::push_back(value);
+ return {--this->end(), true};
+ }
+
+ template<typename InputIt>
+ using require_input_iter = typename std::enable_if<std::is_convertible<typename std::iterator_traits<InputIt>::iterator_category,
+ std::input_iterator_tag>::value>::type;
+
+ template<typename InputIt, typename = require_input_iter<InputIt>>
+ void insert(InputIt first, InputIt last)
+ {
+ for (auto it = first; it != last; ++it)
+ {
+ insert(*it);
+ }
+ }
+};
+
+} // namespace nlohmann
+
+
+#if defined(JSON_HAS_CPP_17)
+ #include <string_view>
+#endif
+
+/*!
+@brief namespace for Niels Lohmann
+@see https://github.com/nlohmann
+@since version 1.0.0
+*/
+namespace nlohmann
+{
+
+/*!
+@brief a class to store JSON values
+
+@internal
+@invariant The member variables @a m_value and @a m_type have the following
+relationship:
+- If `m_type == value_t::object`, then `m_value.object != nullptr`.
+- If `m_type == value_t::array`, then `m_value.array != nullptr`.
+- If `m_type == value_t::string`, then `m_value.string != nullptr`.
+The invariants are checked by member function assert_invariant().
+
+@note ObjectType trick from https://stackoverflow.com/a/9860911
+@endinternal
+
+@since version 1.0.0
+
+@nosubgrouping
+*/
+NLOHMANN_BASIC_JSON_TPL_DECLARATION
+class basic_json // NOLINT(cppcoreguidelines-special-member-functions,hicpp-special-member-functions)
+{
+ private:
+ template<detail::value_t> friend struct detail::external_constructor;
+ friend ::nlohmann::json_pointer<basic_json>;
+
+ template<typename BasicJsonType, typename InputType>
+ friend class ::nlohmann::detail::parser;
+ friend ::nlohmann::detail::serializer<basic_json>;
+ template<typename BasicJsonType>
+ friend class ::nlohmann::detail::iter_impl;
+ template<typename BasicJsonType, typename CharType>
+ friend class ::nlohmann::detail::binary_writer;
+ template<typename BasicJsonType, typename InputType, typename SAX>
+ friend class ::nlohmann::detail::binary_reader;
+ template<typename BasicJsonType>
+ friend class ::nlohmann::detail::json_sax_dom_parser;
+ template<typename BasicJsonType>
+ friend class ::nlohmann::detail::json_sax_dom_callback_parser;
+ friend class ::nlohmann::detail::exception;
+
+ /// workaround type for MSVC
+ using basic_json_t = NLOHMANN_BASIC_JSON_TPL;
+
+ JSON_PRIVATE_UNLESS_TESTED:
+ // convenience aliases for types residing in namespace detail;
+ using lexer = ::nlohmann::detail::lexer_base<basic_json>;
+
+ template<typename InputAdapterType>
+ static ::nlohmann::detail::parser<basic_json, InputAdapterType> parser(
+ InputAdapterType adapter,
+ detail::parser_callback_t<basic_json>cb = nullptr,
+ const bool allow_exceptions = true,
+ const bool ignore_comments = false
+ )
+ {
+ return ::nlohmann::detail::parser<basic_json, InputAdapterType>(std::move(adapter),
+ std::move(cb), allow_exceptions, ignore_comments);
+ }
+
+ private:
+ using primitive_iterator_t = ::nlohmann::detail::primitive_iterator_t;
+ template<typename BasicJsonType>
+ using internal_iterator = ::nlohmann::detail::internal_iterator<BasicJsonType>;
+ template<typename BasicJsonType>
+ using iter_impl = ::nlohmann::detail::iter_impl<BasicJsonType>;
+ template<typename Iterator>
+ using iteration_proxy = ::nlohmann::detail::iteration_proxy<Iterator>;
+ template<typename Base> using json_reverse_iterator = ::nlohmann::detail::json_reverse_iterator<Base>;
+
+ template<typename CharType>
+ using output_adapter_t = ::nlohmann::detail::output_adapter_t<CharType>;
+
+ template<typename InputType>
+ using binary_reader = ::nlohmann::detail::binary_reader<basic_json, InputType>;
+ template<typename CharType> using binary_writer = ::nlohmann::detail::binary_writer<basic_json, CharType>;
+
+ JSON_PRIVATE_UNLESS_TESTED:
+ using serializer = ::nlohmann::detail::serializer<basic_json>;
+
+ public:
+ using value_t = detail::value_t;
+ /// JSON Pointer, see @ref nlohmann::json_pointer
+ using json_pointer = ::nlohmann::json_pointer<basic_json>;
+ template<typename T, typename SFINAE>
+ using json_serializer = JSONSerializer<T, SFINAE>;
+ /// how to treat decoding errors
+ using error_handler_t = detail::error_handler_t;
+ /// how to treat CBOR tags
+ using cbor_tag_handler_t = detail::cbor_tag_handler_t;
+ /// helper type for initializer lists of basic_json values
+ using initializer_list_t = std::initializer_list<detail::json_ref<basic_json>>;
+
+ using input_format_t = detail::input_format_t;
+ /// SAX interface type, see @ref nlohmann::json_sax
+ using json_sax_t = json_sax<basic_json>;
+
+ ////////////////
+ // exceptions //
+ ////////////////
+
+ /// @name exceptions
+ /// Classes to implement user-defined exceptions.
+ /// @{
+
+ using exception = detail::exception;
+ using parse_error = detail::parse_error;
+ using invalid_iterator = detail::invalid_iterator;
+ using type_error = detail::type_error;
+ using out_of_range = detail::out_of_range;
+ using other_error = detail::other_error;
+
+ /// @}
+
+
+ /////////////////////
+ // container types //
+ /////////////////////
+
+ /// @name container types
+ /// The canonic container types to use @ref basic_json like any other STL
+ /// container.
+ /// @{
+
+ /// the type of elements in a basic_json container
+ using value_type = basic_json;
+
+ /// the type of an element reference
+ using reference = value_type&;
+ /// the type of an element const reference
+ using const_reference = const value_type&;
+
+ /// a type to represent differences between iterators
+ using difference_type = std::ptrdiff_t;
+ /// a type to represent container sizes
+ using size_type = std::size_t;
+
+ /// the allocator type
+ using allocator_type = AllocatorType<basic_json>;
+
+ /// the type of an element pointer
+ using pointer = typename std::allocator_traits<allocator_type>::pointer;
+ /// the type of an element const pointer
+ using const_pointer = typename std::allocator_traits<allocator_type>::const_pointer;
+
+ /// an iterator for a basic_json container
+ using iterator = iter_impl<basic_json>;
+ /// a const iterator for a basic_json container
+ using const_iterator = iter_impl<const basic_json>;
+ /// a reverse iterator for a basic_json container
+ using reverse_iterator = json_reverse_iterator<typename basic_json::iterator>;
+ /// a const reverse iterator for a basic_json container
+ using const_reverse_iterator = json_reverse_iterator<typename basic_json::const_iterator>;
+
+ /// @}
+
+
+ /// @brief returns the allocator associated with the container
+ /// @sa https://json.nlohmann.me/api/basic_json/get_allocator/
+ static allocator_type get_allocator()
+ {
+ return allocator_type();
+ }
+
+ /// @brief returns version information on the library
+ /// @sa https://json.nlohmann.me/api/basic_json/meta/
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json meta()
+ {
+ basic_json result;
+
+ result["copyright"] = "(C) 2013-2022 Niels Lohmann";
+ result["name"] = "JSON for Modern C++";
+ result["url"] = "https://github.com/nlohmann/json";
+ result["version"]["string"] =
+ std::to_string(NLOHMANN_JSON_VERSION_MAJOR) + "." +
+ std::to_string(NLOHMANN_JSON_VERSION_MINOR) + "." +
+ std::to_string(NLOHMANN_JSON_VERSION_PATCH);
+ result["version"]["major"] = NLOHMANN_JSON_VERSION_MAJOR;
+ result["version"]["minor"] = NLOHMANN_JSON_VERSION_MINOR;
+ result["version"]["patch"] = NLOHMANN_JSON_VERSION_PATCH;
+
+#ifdef _WIN32
+ result["platform"] = "win32";
+#elif defined __linux__
+ result["platform"] = "linux";
+#elif defined __APPLE__
+ result["platform"] = "apple";
+#elif defined __unix__
+ result["platform"] = "unix";
+#else
+ result["platform"] = "unknown";
+#endif
+
+#if defined(__ICC) || defined(__INTEL_COMPILER)
+ result["compiler"] = {{"family", "icc"}, {"version", __INTEL_COMPILER}};
+#elif defined(__clang__)
+ result["compiler"] = {{"family", "clang"}, {"version", __clang_version__}};
+#elif defined(__GNUC__) || defined(__GNUG__)
+ result["compiler"] = {{"family", "gcc"}, {"version", std::to_string(__GNUC__) + "." + std::to_string(__GNUC_MINOR__) + "." + std::to_string(__GNUC_PATCHLEVEL__)}};
+#elif defined(__HP_cc) || defined(__HP_aCC)
+ result["compiler"] = "hp"
+#elif defined(__IBMCPP__)
+ result["compiler"] = {{"family", "ilecpp"}, {"version", __IBMCPP__}};
+#elif defined(_MSC_VER)
+ result["compiler"] = {{"family", "msvc"}, {"version", _MSC_VER}};
+#elif defined(__PGI)
+ result["compiler"] = {{"family", "pgcpp"}, {"version", __PGI}};
+#elif defined(__SUNPRO_CC)
+ result["compiler"] = {{"family", "sunpro"}, {"version", __SUNPRO_CC}};
+#else
+ result["compiler"] = {{"family", "unknown"}, {"version", "unknown"}};
+#endif
+
+#ifdef __cplusplus
+ result["compiler"]["c++"] = std::to_string(__cplusplus);
+#else
+ result["compiler"]["c++"] = "unknown";
+#endif
+ return result;
+ }
+
+
+ ///////////////////////////
+ // JSON value data types //
+ ///////////////////////////
+
+ /// @name JSON value data types
+ /// The data types to store a JSON value. These types are derived from
+ /// 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/
+#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<>;
+#else
+ using 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,
+ AllocatorType<std::pair<const StringType,
+ basic_json>>>;
+
+ /// @brief a type for an array
+ /// @sa https://json.nlohmann.me/api/basic_json/array_t/
+ using array_t = ArrayType<basic_json, AllocatorType<basic_json>>;
+
+ /// @brief a type for a string
+ /// @sa https://json.nlohmann.me/api/basic_json/string_t/
+ using string_t = StringType;
+
+ /// @brief a type for a boolean
+ /// @sa https://json.nlohmann.me/api/basic_json/boolean_t/
+ using boolean_t = BooleanType;
+
+ /// @brief a type for a number (integer)
+ /// @sa https://json.nlohmann.me/api/basic_json/number_integer_t/
+ using number_integer_t = NumberIntegerType;
+
+ /// @brief a type for a number (unsigned)
+ /// @sa https://json.nlohmann.me/api/basic_json/number_unsigned_t/
+ using number_unsigned_t = NumberUnsignedType;
+
+ /// @brief a type for a number (floating-point)
+ /// @sa https://json.nlohmann.me/api/basic_json/number_float_t/
+ using number_float_t = NumberFloatType;
+
+ /// @brief a type for a packed binary type
+ /// @sa https://json.nlohmann.me/api/basic_json/binary_t/
+ using binary_t = nlohmann::byte_container_with_subtype<BinaryType>;
+
+ /// @}
+
+ private:
+
+ /// helper for exception-safe object creation
+ template<typename T, typename... Args>
+ JSON_HEDLEY_RETURNS_NON_NULL
+ static T* create(Args&& ... args)
+ {
+ AllocatorType<T> alloc;
+ using AllocatorTraits = std::allocator_traits<AllocatorType<T>>;
+
+ auto deleter = [&](T * obj)
+ {
+ AllocatorTraits::deallocate(alloc, obj, 1);
+ };
+ std::unique_ptr<T, decltype(deleter)> obj(AllocatorTraits::allocate(alloc, 1), deleter);
+ AllocatorTraits::construct(alloc, obj.get(), std::forward<Args>(args)...);
+ JSON_ASSERT(obj != nullptr);
+ return obj.release();
+ }
+
+ ////////////////////////
+ // JSON value storage //
+ ////////////////////////
+
+ JSON_PRIVATE_UNLESS_TESTED:
+ /*!
+ @brief a JSON value
+
+ The actual storage for a JSON value of the @ref basic_json class. This
+ union combines the different storage types for the JSON value types
+ defined in @ref value_t.
+
+ JSON type | value_t type | used type
+ --------- | --------------- | ------------------------
+ object | object | pointer to @ref object_t
+ array | array | pointer to @ref array_t
+ string | string | pointer to @ref string_t
+ boolean | boolean | @ref boolean_t
+ number | number_integer | @ref number_integer_t
+ number | number_unsigned | @ref number_unsigned_t
+ number | number_float | @ref number_float_t
+ binary | binary | pointer to @ref binary_t
+ null | null | *no value is stored*
+
+ @note Variable-length types (objects, arrays, and strings) are stored as
+ pointers. The size of the union should not exceed 64 bits if the default
+ value types are used.
+
+ @since version 1.0.0
+ */
+ union json_value
+ {
+ /// object (stored with pointer to save storage)
+ object_t* object;
+ /// array (stored with pointer to save storage)
+ array_t* array;
+ /// string (stored with pointer to save storage)
+ string_t* string;
+ /// binary (stored with pointer to save storage)
+ binary_t* binary;
+ /// boolean
+ boolean_t boolean;
+ /// number (integer)
+ number_integer_t number_integer;
+ /// number (unsigned integer)
+ number_unsigned_t number_unsigned;
+ /// number (floating-point)
+ number_float_t number_float;
+
+ /// default constructor (for null values)
+ json_value() = default;
+ /// constructor for booleans
+ json_value(boolean_t v) noexcept : boolean(v) {}
+ /// constructor for numbers (integer)
+ json_value(number_integer_t v) noexcept : number_integer(v) {}
+ /// constructor for numbers (unsigned)
+ json_value(number_unsigned_t v) noexcept : number_unsigned(v) {}
+ /// constructor for numbers (floating-point)
+ json_value(number_float_t v) noexcept : number_float(v) {}
+ /// constructor for empty values of a given type
+ json_value(value_t t)
+ {
+ switch (t)
+ {
+ case value_t::object:
+ {
+ object = create<object_t>();
+ break;
+ }
+
+ case value_t::array:
+ {
+ array = create<array_t>();
+ break;
+ }
+
+ case value_t::string:
+ {
+ string = create<string_t>("");
+ break;
+ }
+
+ case value_t::binary:
+ {
+ binary = create<binary_t>();
+ break;
+ }
+
+ case value_t::boolean:
+ {
+ boolean = static_cast<boolean_t>(false);
+ break;
+ }
+
+ case value_t::number_integer:
+ {
+ number_integer = static_cast<number_integer_t>(0);
+ break;
+ }
+
+ case value_t::number_unsigned:
+ {
+ number_unsigned = static_cast<number_unsigned_t>(0);
+ break;
+ }
+
+ case value_t::number_float:
+ {
+ number_float = static_cast<number_float_t>(0.0);
+ break;
+ }
+
+ case value_t::null:
+ {
+ object = nullptr; // silence warning, see #821
+ break;
+ }
+
+ case value_t::discarded:
+ default:
+ {
+ object = nullptr; // silence warning, see #821
+ if (JSON_HEDLEY_UNLIKELY(t == value_t::null))
+ {
+ JSON_THROW(other_error::create(500, "961c151d2e87f2686a955a9be24d316f1362bf21 3.10.5", basic_json())); // LCOV_EXCL_LINE
+ }
+ break;
+ }
+ }
+ }
+
+ /// constructor for strings
+ json_value(const string_t& value) : string(create<string_t>(value)) {}
+
+ /// constructor for rvalue strings
+ json_value(string_t&& value) : string(create<string_t>(std::move(value))) {}
+
+ /// constructor for objects
+ json_value(const object_t& value) : object(create<object_t>(value)) {}
+
+ /// constructor for rvalue objects
+ json_value(object_t&& value) : object(create<object_t>(std::move(value))) {}
+
+ /// constructor for arrays
+ json_value(const array_t& value) : array(create<array_t>(value)) {}
+
+ /// constructor for rvalue arrays
+ json_value(array_t&& value) : array(create<array_t>(std::move(value))) {}
+
+ /// constructor for binary arrays
+ json_value(const typename binary_t::container_type& value) : binary(create<binary_t>(value)) {}
+
+ /// constructor for rvalue binary arrays
+ json_value(typename binary_t::container_type&& value) : binary(create<binary_t>(std::move(value))) {}
+
+ /// constructor for binary arrays (internal type)
+ json_value(const binary_t& value) : binary(create<binary_t>(value)) {}
+
+ /// constructor for rvalue binary arrays (internal type)
+ json_value(binary_t&& value) : binary(create<binary_t>(std::move(value))) {}
+
+ void destroy(value_t t)
+ {
+ if (t == value_t::array || t == value_t::object)
+ {
+ // flatten the current json_value to a heap-allocated stack
+ std::vector<basic_json> stack;
+
+ // move the top-level items to stack
+ if (t == value_t::array)
+ {
+ stack.reserve(array->size());
+ std::move(array->begin(), array->end(), std::back_inserter(stack));
+ }
+ else
+ {
+ stack.reserve(object->size());
+ for (auto&& it : *object)
+ {
+ stack.push_back(std::move(it.second));
+ }
+ }
+
+ while (!stack.empty())
+ {
+ // move the last item to local variable to be processed
+ basic_json current_item(std::move(stack.back()));
+ stack.pop_back();
+
+ // if current_item is array/object, move
+ // its children to the stack to be processed later
+ if (current_item.is_array())
+ {
+ std::move(current_item.m_value.array->begin(), current_item.m_value.array->end(), std::back_inserter(stack));
+
+ current_item.m_value.array->clear();
+ }
+ else if (current_item.is_object())
+ {
+ for (auto&& it : *current_item.m_value.object)
+ {
+ stack.push_back(std::move(it.second));
+ }
+
+ current_item.m_value.object->clear();
+ }
+
+ // it's now safe that current_item get destructed
+ // since it doesn't have any children
+ }
+ }
+
+ switch (t)
+ {
+ case value_t::object:
+ {
+ AllocatorType<object_t> alloc;
+ std::allocator_traits<decltype(alloc)>::destroy(alloc, object);
+ std::allocator_traits<decltype(alloc)>::deallocate(alloc, object, 1);
+ break;
+ }
+
+ case value_t::array:
+ {
+ AllocatorType<array_t> alloc;
+ std::allocator_traits<decltype(alloc)>::destroy(alloc, array);
+ std::allocator_traits<decltype(alloc)>::deallocate(alloc, array, 1);
+ break;
+ }
+
+ case value_t::string:
+ {
+ AllocatorType<string_t> alloc;
+ std::allocator_traits<decltype(alloc)>::destroy(alloc, string);
+ std::allocator_traits<decltype(alloc)>::deallocate(alloc, string, 1);
+ break;
+ }
+
+ case value_t::binary:
+ {
+ AllocatorType<binary_t> alloc;
+ std::allocator_traits<decltype(alloc)>::destroy(alloc, binary);
+ std::allocator_traits<decltype(alloc)>::deallocate(alloc, binary, 1);
+ break;
+ }
+
+ case value_t::null:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::discarded:
+ default:
+ {
+ break;
+ }
+ }
+ }
+ };
+
+ private:
+ /*!
+ @brief checks the class invariants
+
+ This function asserts the class invariants. It needs to be called at the
+ end of every constructor to make sure that created objects respect the
+ invariant. Furthermore, it has to be called each time the type of a JSON
+ value is changed, because the invariant expresses a relationship between
+ @a m_type and @a m_value.
+
+ Furthermore, the parent relation is checked for arrays and objects: If
+ @a check_parents true and the value is an array or object, then the
+ container's elements must have the current value as parent.
+
+ @param[in] check_parents whether the parent relation should be checked.
+ The value is true by default and should only be set to false
+ during destruction of objects when the invariant does not
+ need to hold.
+ */
+ void assert_invariant(bool check_parents = true) const noexcept
+ {
+ JSON_ASSERT(m_type != value_t::object || m_value.object != nullptr);
+ JSON_ASSERT(m_type != value_t::array || m_value.array != nullptr);
+ JSON_ASSERT(m_type != value_t::string || m_value.string != nullptr);
+ JSON_ASSERT(m_type != value_t::binary || m_value.binary != nullptr);
+
+#if JSON_DIAGNOSTICS
+ JSON_TRY
+ {
+ // cppcheck-suppress assertWithSideEffect
+ JSON_ASSERT(!check_parents || !is_structured() || std::all_of(begin(), end(), [this](const basic_json & j)
+ {
+ return j.m_parent == this;
+ }));
+ }
+ JSON_CATCH(...) {} // LCOV_EXCL_LINE
+#endif
+ static_cast<void>(check_parents);
+ }
+
+ void set_parents()
+ {
+#if JSON_DIAGNOSTICS
+ switch (m_type)
+ {
+ case value_t::array:
+ {
+ for (auto& element : *m_value.array)
+ {
+ element.m_parent = this;
+ }
+ break;
+ }
+
+ case value_t::object:
+ {
+ for (auto& element : *m_value.object)
+ {
+ element.second.m_parent = this;
+ }
+ break;
+ }
+
+ case value_t::null:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ break;
+ }
+#endif
+ }
+
+ iterator set_parents(iterator it, typename iterator::difference_type count_set_parents)
+ {
+#if JSON_DIAGNOSTICS
+ for (typename iterator::difference_type i = 0; i < count_set_parents; ++i)
+ {
+ (it + i)->m_parent = this;
+ }
+#else
+ static_cast<void>(count_set_parents);
+#endif
+ return it;
+ }
+
+ reference set_parent(reference j, std::size_t old_capacity = static_cast<std::size_t>(-1))
+ {
+#if JSON_DIAGNOSTICS
+ if (old_capacity != static_cast<std::size_t>(-1))
+ {
+ // see https://github.com/nlohmann/json/issues/2838
+ JSON_ASSERT(type() == value_t::array);
+ if (JSON_HEDLEY_UNLIKELY(m_value.array->capacity() != old_capacity))
+ {
+ // capacity has changed: update all parents
+ set_parents();
+ return j;
+ }
+ }
+
+ // ordered_json uses a vector internally, so pointers could have
+ // been invalidated; see https://github.com/nlohmann/json/issues/2962
+#ifdef JSON_HEDLEY_MSVC_VERSION
+#pragma warning(push )
+#pragma warning(disable : 4127) // ignore warning to replace if with if constexpr
+#endif
+ if (detail::is_ordered_map<object_t>::value)
+ {
+ set_parents();
+ return j;
+ }
+#ifdef JSON_HEDLEY_MSVC_VERSION
+#pragma warning( pop )
+#endif
+
+ j.m_parent = this;
+#else
+ static_cast<void>(j);
+ static_cast<void>(old_capacity);
+#endif
+ return j;
+ }
+
+ public:
+ //////////////////////////
+ // JSON parser callback //
+ //////////////////////////
+
+ /// @brief parser event types
+ /// @sa https://json.nlohmann.me/api/basic_json/parse_event_t/
+ using parse_event_t = detail::parse_event_t;
+
+ /// @brief per-element parser callback type
+ /// @sa https://json.nlohmann.me/api/basic_json/parser_callback_t/
+ using parser_callback_t = detail::parser_callback_t<basic_json>;
+
+ //////////////////
+ // constructors //
+ //////////////////
+
+ /// @name constructors and destructors
+ /// Constructors of class @ref basic_json, copy/move constructor, copy
+ /// assignment, static functions creating objects, and the destructor.
+ /// @{
+
+ /// @brief create an empty value with a given type
+ /// @sa https://json.nlohmann.me/api/basic_json/basic_json/
+ basic_json(const value_t v)
+ : m_type(v), m_value(v)
+ {
+ assert_invariant();
+ }
+
+ /// @brief create a null object
+ /// @sa https://json.nlohmann.me/api/basic_json/basic_json/
+ basic_json(std::nullptr_t = nullptr) noexcept
+ : basic_json(value_t::null)
+ {
+ assert_invariant();
+ }
+
+ /// @brief create a JSON value from compatible types
+ /// @sa https://json.nlohmann.me/api/basic_json/basic_json/
+ template < typename CompatibleType,
+ typename U = detail::uncvref_t<CompatibleType>,
+ detail::enable_if_t <
+ !detail::is_basic_json<U>::value && detail::is_compatible_type<basic_json_t, U>::value, int > = 0 >
+ basic_json(CompatibleType && val) noexcept(noexcept( // NOLINT(bugprone-forwarding-reference-overload,bugprone-exception-escape)
+ JSONSerializer<U>::to_json(std::declval<basic_json_t&>(),
+ std::forward<CompatibleType>(val))))
+ {
+ JSONSerializer<U>::to_json(*this, std::forward<CompatibleType>(val));
+ set_parents();
+ assert_invariant();
+ }
+
+ /// @brief create a JSON value from an existing one
+ /// @sa https://json.nlohmann.me/api/basic_json/basic_json/
+ template < typename BasicJsonType,
+ detail::enable_if_t <
+ detail::is_basic_json<BasicJsonType>::value&& !std::is_same<basic_json, BasicJsonType>::value, int > = 0 >
+ basic_json(const BasicJsonType& val)
+ {
+ using other_boolean_t = typename BasicJsonType::boolean_t;
+ using other_number_float_t = typename BasicJsonType::number_float_t;
+ using other_number_integer_t = typename BasicJsonType::number_integer_t;
+ using other_number_unsigned_t = typename BasicJsonType::number_unsigned_t;
+ using other_string_t = typename BasicJsonType::string_t;
+ using other_object_t = typename BasicJsonType::object_t;
+ using other_array_t = typename BasicJsonType::array_t;
+ using other_binary_t = typename BasicJsonType::binary_t;
+
+ switch (val.type())
+ {
+ case value_t::boolean:
+ JSONSerializer<other_boolean_t>::to_json(*this, val.template get<other_boolean_t>());
+ break;
+ case value_t::number_float:
+ JSONSerializer<other_number_float_t>::to_json(*this, val.template get<other_number_float_t>());
+ break;
+ case value_t::number_integer:
+ JSONSerializer<other_number_integer_t>::to_json(*this, val.template get<other_number_integer_t>());
+ break;
+ case value_t::number_unsigned:
+ JSONSerializer<other_number_unsigned_t>::to_json(*this, val.template get<other_number_unsigned_t>());
+ break;
+ case value_t::string:
+ JSONSerializer<other_string_t>::to_json(*this, val.template get_ref<const other_string_t&>());
+ break;
+ case value_t::object:
+ JSONSerializer<other_object_t>::to_json(*this, val.template get_ref<const other_object_t&>());
+ break;
+ case value_t::array:
+ JSONSerializer<other_array_t>::to_json(*this, val.template get_ref<const other_array_t&>());
+ break;
+ case value_t::binary:
+ JSONSerializer<other_binary_t>::to_json(*this, val.template get_ref<const other_binary_t&>());
+ break;
+ case value_t::null:
+ *this = nullptr;
+ break;
+ case value_t::discarded:
+ m_type = value_t::discarded;
+ break;
+ default: // LCOV_EXCL_LINE
+ JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert) LCOV_EXCL_LINE
+ }
+ set_parents();
+ assert_invariant();
+ }
+
+ /// @brief create a container (array or object) from an initializer list
+ /// @sa https://json.nlohmann.me/api/basic_json/basic_json/
+ basic_json(initializer_list_t init,
+ bool type_deduction = true,
+ value_t manual_type = value_t::array)
+ {
+ // check if each element is an array with two elements whose first
+ // element is a string
+ bool is_an_object = std::all_of(init.begin(), init.end(),
+ [](const detail::json_ref<basic_json>& element_ref)
+ {
+ return element_ref->is_array() && element_ref->size() == 2 && (*element_ref)[0].is_string();
+ });
+
+ // adjust type if type deduction is not wanted
+ if (!type_deduction)
+ {
+ // if array is wanted, do not create an object though possible
+ if (manual_type == value_t::array)
+ {
+ is_an_object = false;
+ }
+
+ // if object is wanted but impossible, throw an exception
+ if (JSON_HEDLEY_UNLIKELY(manual_type == value_t::object && !is_an_object))
+ {
+ JSON_THROW(type_error::create(301, "cannot create object from initializer list", basic_json()));
+ }
+ }
+
+ if (is_an_object)
+ {
+ // the initializer list is a list of pairs -> create object
+ m_type = value_t::object;
+ m_value = value_t::object;
+
+ for (auto& element_ref : init)
+ {
+ auto element = element_ref.moved_or_copied();
+ m_value.object->emplace(
+ std::move(*((*element.m_value.array)[0].m_value.string)),
+ std::move((*element.m_value.array)[1]));
+ }
+ }
+ else
+ {
+ // the initializer list describes an array -> create array
+ m_type = value_t::array;
+ m_value.array = create<array_t>(init.begin(), init.end());
+ }
+
+ set_parents();
+ assert_invariant();
+ }
+
+ /// @brief explicitly create a binary array (without subtype)
+ /// @sa https://json.nlohmann.me/api/basic_json/binary/
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json binary(const typename binary_t::container_type& init)
+ {
+ auto res = basic_json();
+ res.m_type = value_t::binary;
+ res.m_value = init;
+ return res;
+ }
+
+ /// @brief explicitly create a binary array (with subtype)
+ /// @sa https://json.nlohmann.me/api/basic_json/binary/
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json binary(const typename binary_t::container_type& init, typename binary_t::subtype_type subtype)
+ {
+ auto res = basic_json();
+ res.m_type = value_t::binary;
+ res.m_value = binary_t(init, subtype);
+ return res;
+ }
+
+ /// @brief explicitly create a binary array
+ /// @sa https://json.nlohmann.me/api/basic_json/binary/
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json binary(typename binary_t::container_type&& init)
+ {
+ auto res = basic_json();
+ res.m_type = value_t::binary;
+ res.m_value = std::move(init);
+ return res;
+ }
+
+ /// @brief explicitly create a binary array (with subtype)
+ /// @sa https://json.nlohmann.me/api/basic_json/binary/
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json binary(typename binary_t::container_type&& init, typename binary_t::subtype_type subtype)
+ {
+ auto res = basic_json();
+ res.m_type = value_t::binary;
+ res.m_value = binary_t(std::move(init), subtype);
+ return res;
+ }
+
+ /// @brief explicitly create an array from an initializer list
+ /// @sa https://json.nlohmann.me/api/basic_json/array/
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json array(initializer_list_t init = {})
+ {
+ return basic_json(init, false, value_t::array);
+ }
+
+ /// @brief explicitly create an object from an initializer list
+ /// @sa https://json.nlohmann.me/api/basic_json/object/
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json object(initializer_list_t init = {})
+ {
+ return basic_json(init, false, value_t::object);
+ }
+
+ /// @brief construct an array with count copies of given value
+ /// @sa https://json.nlohmann.me/api/basic_json/basic_json/
+ basic_json(size_type cnt, const basic_json& val)
+ : m_type(value_t::array)
+ {
+ m_value.array = create<array_t>(cnt, val);
+ set_parents();
+ assert_invariant();
+ }
+
+ /// @brief construct a JSON container given an iterator range
+ /// @sa https://json.nlohmann.me/api/basic_json/basic_json/
+ template < class InputIT, typename std::enable_if <
+ std::is_same<InputIT, typename basic_json_t::iterator>::value ||
+ std::is_same<InputIT, typename basic_json_t::const_iterator>::value, int >::type = 0 >
+ basic_json(InputIT first, InputIT last)
+ {
+ JSON_ASSERT(first.m_object != nullptr);
+ JSON_ASSERT(last.m_object != nullptr);
+
+ // make sure iterator fits the current value
+ if (JSON_HEDLEY_UNLIKELY(first.m_object != last.m_object))
+ {
+ JSON_THROW(invalid_iterator::create(201, "iterators are not compatible", basic_json()));
+ }
+
+ // copy type from first iterator
+ m_type = first.m_object->m_type;
+
+ // check if iterator range is complete for primitive values
+ switch (m_type)
+ {
+ case value_t::boolean:
+ case value_t::number_float:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::string:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!first.m_it.primitive_iterator.is_begin()
+ || !last.m_it.primitive_iterator.is_end()))
+ {
+ JSON_THROW(invalid_iterator::create(204, "iterators out of range", *first.m_object));
+ }
+ break;
+ }
+
+ case value_t::null:
+ case value_t::object:
+ case value_t::array:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ break;
+ }
+
+ switch (m_type)
+ {
+ case value_t::number_integer:
+ {
+ m_value.number_integer = first.m_object->m_value.number_integer;
+ break;
+ }
+
+ case value_t::number_unsigned:
+ {
+ m_value.number_unsigned = first.m_object->m_value.number_unsigned;
+ break;
+ }
+
+ case value_t::number_float:
+ {
+ m_value.number_float = first.m_object->m_value.number_float;
+ break;
+ }
+
+ case value_t::boolean:
+ {
+ m_value.boolean = first.m_object->m_value.boolean;
+ break;
+ }
+
+ case value_t::string:
+ {
+ m_value = *first.m_object->m_value.string;
+ break;
+ }
+
+ case value_t::object:
+ {
+ m_value.object = create<object_t>(first.m_it.object_iterator,
+ last.m_it.object_iterator);
+ break;
+ }
+
+ case value_t::array:
+ {
+ m_value.array = create<array_t>(first.m_it.array_iterator,
+ last.m_it.array_iterator);
+ break;
+ }
+
+ case value_t::binary:
+ {
+ m_value = *first.m_object->m_value.binary;
+ break;
+ }
+
+ case value_t::null:
+ case value_t::discarded:
+ default:
+ JSON_THROW(invalid_iterator::create(206, "cannot construct with iterators from " + std::string(first.m_object->type_name()), *first.m_object));
+ }
+
+ set_parents();
+ assert_invariant();
+ }
+
+
+ ///////////////////////////////////////
+ // other constructors and destructor //
+ ///////////////////////////////////////
+
+ template<typename JsonRef,
+ detail::enable_if_t<detail::conjunction<detail::is_json_ref<JsonRef>,
+ std::is_same<typename JsonRef::value_type, basic_json>>::value, int> = 0 >
+ basic_json(const JsonRef& ref) : basic_json(ref.moved_or_copied()) {}
+
+ /// @brief copy constructor
+ /// @sa https://json.nlohmann.me/api/basic_json/basic_json/
+ basic_json(const basic_json& other)
+ : m_type(other.m_type)
+ {
+ // check of passed value is valid
+ other.assert_invariant();
+
+ switch (m_type)
+ {
+ case value_t::object:
+ {
+ m_value = *other.m_value.object;
+ break;
+ }
+
+ case value_t::array:
+ {
+ m_value = *other.m_value.array;
+ break;
+ }
+
+ case value_t::string:
+ {
+ m_value = *other.m_value.string;
+ break;
+ }
+
+ case value_t::boolean:
+ {
+ m_value = other.m_value.boolean;
+ break;
+ }
+
+ case value_t::number_integer:
+ {
+ m_value = other.m_value.number_integer;
+ break;
+ }
+
+ case value_t::number_unsigned:
+ {
+ m_value = other.m_value.number_unsigned;
+ break;
+ }
+
+ case value_t::number_float:
+ {
+ m_value = other.m_value.number_float;
+ break;
+ }
+
+ case value_t::binary:
+ {
+ m_value = *other.m_value.binary;
+ break;
+ }
+
+ case value_t::null:
+ case value_t::discarded:
+ default:
+ break;
+ }
+
+ set_parents();
+ assert_invariant();
+ }
+
+ /// @brief move constructor
+ /// @sa https://json.nlohmann.me/api/basic_json/basic_json/
+ basic_json(basic_json&& other) noexcept
+ : m_type(std::move(other.m_type)),
+ m_value(std::move(other.m_value))
+ {
+ // check that passed value is valid
+ other.assert_invariant(false);
+
+ // invalidate payload
+ other.m_type = value_t::null;
+ other.m_value = {};
+
+ set_parents();
+ assert_invariant();
+ }
+
+ /// @brief copy assignment
+ /// @sa https://json.nlohmann.me/api/basic_json/operator=/
+ basic_json& operator=(basic_json other) noexcept (
+ std::is_nothrow_move_constructible<value_t>::value&&
+ std::is_nothrow_move_assignable<value_t>::value&&
+ std::is_nothrow_move_constructible<json_value>::value&&
+ std::is_nothrow_move_assignable<json_value>::value
+ )
+ {
+ // check that passed value is valid
+ other.assert_invariant();
+
+ using std::swap;
+ swap(m_type, other.m_type);
+ swap(m_value, other.m_value);
+
+ set_parents();
+ assert_invariant();
+ return *this;
+ }
+
+ /// @brief destructor
+ /// @sa https://json.nlohmann.me/api/basic_json/~basic_json/
+ ~basic_json() noexcept
+ {
+ assert_invariant(false);
+ m_value.destroy(m_type);
+ }
+
+ /// @}
+
+ public:
+ ///////////////////////
+ // object inspection //
+ ///////////////////////
+
+ /// @name object inspection
+ /// Functions to inspect the type of a JSON value.
+ /// @{
+
+ /// @brief serialization
+ /// @sa https://json.nlohmann.me/api/basic_json/dump/
+ string_t dump(const int indent = -1,
+ const char indent_char = ' ',
+ const bool ensure_ascii = false,
+ const error_handler_t error_handler = error_handler_t::strict) const
+ {
+ string_t result;
+ serializer s(detail::output_adapter<char, string_t>(result), indent_char, error_handler);
+
+ if (indent >= 0)
+ {
+ s.dump(*this, true, ensure_ascii, static_cast<unsigned int>(indent));
+ }
+ else
+ {
+ s.dump(*this, false, ensure_ascii, 0);
+ }
+
+ return result;
+ }
+
+ /// @brief return the type of the JSON value (explicit)
+ /// @sa https://json.nlohmann.me/api/basic_json/type/
+ constexpr value_t type() const noexcept
+ {
+ return m_type;
+ }
+
+ /// @brief return whether type is primitive
+ /// @sa https://json.nlohmann.me/api/basic_json/is_primitive/
+ constexpr bool is_primitive() const noexcept
+ {
+ return is_null() || is_string() || is_boolean() || is_number() || is_binary();
+ }
+
+ /// @brief return whether type is structured
+ /// @sa https://json.nlohmann.me/api/basic_json/is_structured/
+ constexpr bool is_structured() const noexcept
+ {
+ return is_array() || is_object();
+ }
+
+ /// @brief return whether value is null
+ /// @sa https://json.nlohmann.me/api/basic_json/is_null/
+ constexpr bool is_null() const noexcept
+ {
+ return m_type == value_t::null;
+ }
+
+ /// @brief return whether value is a boolean
+ /// @sa https://json.nlohmann.me/api/basic_json/is_boolean/
+ constexpr bool is_boolean() const noexcept
+ {
+ return m_type == value_t::boolean;
+ }
+
+ /// @brief return whether value is a number
+ /// @sa https://json.nlohmann.me/api/basic_json/is_number/
+ constexpr bool is_number() const noexcept
+ {
+ return is_number_integer() || is_number_float();
+ }
+
+ /// @brief return whether value is an integer number
+ /// @sa https://json.nlohmann.me/api/basic_json/is_number_integer/
+ constexpr bool is_number_integer() const noexcept
+ {
+ return m_type == value_t::number_integer || m_type == value_t::number_unsigned;
+ }
+
+ /// @brief return whether value is an unsigned integer number
+ /// @sa https://json.nlohmann.me/api/basic_json/is_number_unsigned/
+ constexpr bool is_number_unsigned() const noexcept
+ {
+ return m_type == value_t::number_unsigned;
+ }
+
+ /// @brief return whether value is a floating-point number
+ /// @sa https://json.nlohmann.me/api/basic_json/is_number_float/
+ constexpr bool is_number_float() const noexcept
+ {
+ return m_type == value_t::number_float;
+ }
+
+ /// @brief return whether value is an object
+ /// @sa https://json.nlohmann.me/api/basic_json/is_object/
+ constexpr bool is_object() const noexcept
+ {
+ return m_type == value_t::object;
+ }
+
+ /// @brief return whether value is an array
+ /// @sa https://json.nlohmann.me/api/basic_json/is_array/
+ constexpr bool is_array() const noexcept
+ {
+ return m_type == value_t::array;
+ }
+
+ /// @brief return whether value is a string
+ /// @sa https://json.nlohmann.me/api/basic_json/is_string/
+ constexpr bool is_string() const noexcept
+ {
+ return m_type == value_t::string;
+ }
+
+ /// @brief return whether value is a binary array
+ /// @sa https://json.nlohmann.me/api/basic_json/is_binary/
+ constexpr bool is_binary() const noexcept
+ {
+ return m_type == value_t::binary;
+ }
+
+ /// @brief return whether value is discarded
+ /// @sa https://json.nlohmann.me/api/basic_json/is_discarded/
+ constexpr bool is_discarded() const noexcept
+ {
+ return m_type == value_t::discarded;
+ }
+
+ /// @brief return the type of the JSON value (implicit)
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_value_t/
+ constexpr operator value_t() const noexcept
+ {
+ return m_type;
+ }
+
+ /// @}
+
+ private:
+ //////////////////
+ // value access //
+ //////////////////
+
+ /// get a boolean (explicit)
+ boolean_t get_impl(boolean_t* /*unused*/) const
+ {
+ if (JSON_HEDLEY_LIKELY(is_boolean()))
+ {
+ return m_value.boolean;
+ }
+
+ JSON_THROW(type_error::create(302, "type must be boolean, but is " + std::string(type_name()), *this));
+ }
+
+ /// get a pointer to the value (object)
+ object_t* get_impl_ptr(object_t* /*unused*/) noexcept
+ {
+ return is_object() ? m_value.object : nullptr;
+ }
+
+ /// get a pointer to the value (object)
+ constexpr const object_t* get_impl_ptr(const object_t* /*unused*/) const noexcept
+ {
+ return is_object() ? m_value.object : nullptr;
+ }
+
+ /// get a pointer to the value (array)
+ array_t* get_impl_ptr(array_t* /*unused*/) noexcept
+ {
+ return is_array() ? m_value.array : nullptr;
+ }
+
+ /// get a pointer to the value (array)
+ constexpr const array_t* get_impl_ptr(const array_t* /*unused*/) const noexcept
+ {
+ return is_array() ? m_value.array : nullptr;
+ }
+
+ /// get a pointer to the value (string)
+ string_t* get_impl_ptr(string_t* /*unused*/) noexcept
+ {
+ return is_string() ? m_value.string : nullptr;
+ }
+
+ /// get a pointer to the value (string)
+ constexpr const string_t* get_impl_ptr(const string_t* /*unused*/) const noexcept
+ {
+ return is_string() ? m_value.string : nullptr;
+ }
+
+ /// get a pointer to the value (boolean)
+ boolean_t* get_impl_ptr(boolean_t* /*unused*/) noexcept
+ {
+ return is_boolean() ? &m_value.boolean : nullptr;
+ }
+
+ /// get a pointer to the value (boolean)
+ constexpr const boolean_t* get_impl_ptr(const boolean_t* /*unused*/) const noexcept
+ {
+ return is_boolean() ? &m_value.boolean : nullptr;
+ }
+
+ /// get a pointer to the value (integer number)
+ number_integer_t* get_impl_ptr(number_integer_t* /*unused*/) noexcept
+ {
+ return is_number_integer() ? &m_value.number_integer : nullptr;
+ }
+
+ /// get a pointer to the value (integer number)
+ constexpr const number_integer_t* get_impl_ptr(const number_integer_t* /*unused*/) const noexcept
+ {
+ return is_number_integer() ? &m_value.number_integer : nullptr;
+ }
+
+ /// get a pointer to the value (unsigned number)
+ number_unsigned_t* get_impl_ptr(number_unsigned_t* /*unused*/) noexcept
+ {
+ return is_number_unsigned() ? &m_value.number_unsigned : nullptr;
+ }
+
+ /// get a pointer to the value (unsigned number)
+ constexpr const number_unsigned_t* get_impl_ptr(const number_unsigned_t* /*unused*/) const noexcept
+ {
+ return is_number_unsigned() ? &m_value.number_unsigned : nullptr;
+ }
+
+ /// get a pointer to the value (floating-point number)
+ number_float_t* get_impl_ptr(number_float_t* /*unused*/) noexcept
+ {
+ return is_number_float() ? &m_value.number_float : nullptr;
+ }
+
+ /// get a pointer to the value (floating-point number)
+ constexpr const number_float_t* get_impl_ptr(const number_float_t* /*unused*/) const noexcept
+ {
+ return is_number_float() ? &m_value.number_float : nullptr;
+ }
+
+ /// get a pointer to the value (binary)
+ binary_t* get_impl_ptr(binary_t* /*unused*/) noexcept
+ {
+ return is_binary() ? m_value.binary : nullptr;
+ }
+
+ /// get a pointer to the value (binary)
+ constexpr const binary_t* get_impl_ptr(const binary_t* /*unused*/) const noexcept
+ {
+ return is_binary() ? m_value.binary : nullptr;
+ }
+
+ /*!
+ @brief helper function to implement get_ref()
+
+ This function helps to implement get_ref() without code duplication for
+ const and non-const overloads
+
+ @tparam ThisType will be deduced as `basic_json` or `const basic_json`
+
+ @throw type_error.303 if ReferenceType does not match underlying value
+ type of the current JSON
+ */
+ template<typename ReferenceType, typename ThisType>
+ static ReferenceType get_ref_impl(ThisType& obj)
+ {
+ // delegate the call to get_ptr<>()
+ auto* ptr = obj.template get_ptr<typename std::add_pointer<ReferenceType>::type>();
+
+ if (JSON_HEDLEY_LIKELY(ptr != nullptr))
+ {
+ return *ptr;
+ }
+
+ JSON_THROW(type_error::create(303, "incompatible ReferenceType for get_ref, actual type is " + std::string(obj.type_name()), obj));
+ }
+
+ public:
+ /// @name value access
+ /// Direct access to the stored value of a JSON value.
+ /// @{
+
+ /// @brief get a pointer value (implicit)
+ /// @sa https://json.nlohmann.me/api/basic_json/get_ptr/
+ template<typename PointerType, typename std::enable_if<
+ std::is_pointer<PointerType>::value, int>::type = 0>
+ auto get_ptr() noexcept -> decltype(std::declval<basic_json_t&>().get_impl_ptr(std::declval<PointerType>()))
+ {
+ // delegate the call to get_impl_ptr<>()
+ return get_impl_ptr(static_cast<PointerType>(nullptr));
+ }
+
+ /// @brief get a pointer value (implicit)
+ /// @sa https://json.nlohmann.me/api/basic_json/get_ptr/
+ template < typename PointerType, typename std::enable_if <
+ std::is_pointer<PointerType>::value&&
+ std::is_const<typename std::remove_pointer<PointerType>::type>::value, int >::type = 0 >
+ constexpr auto get_ptr() const noexcept -> decltype(std::declval<const basic_json_t&>().get_impl_ptr(std::declval<PointerType>()))
+ {
+ // delegate the call to get_impl_ptr<>() const
+ return get_impl_ptr(static_cast<PointerType>(nullptr));
+ }
+
+ private:
+ /*!
+ @brief get a value (explicit)
+
+ Explicit type conversion between the JSON value and a compatible value
+ which is [CopyConstructible](https://en.cppreference.com/w/cpp/named_req/CopyConstructible)
+ and [DefaultConstructible](https://en.cppreference.com/w/cpp/named_req/DefaultConstructible).
+ The value is converted by calling the @ref json_serializer<ValueType>
+ `from_json()` method.
+
+ The function is equivalent to executing
+ @code {.cpp}
+ ValueType ret;
+ JSONSerializer<ValueType>::from_json(*this, ret);
+ return ret;
+ @endcode
+
+ This overloads is chosen if:
+ - @a ValueType is not @ref basic_json,
+ - @ref json_serializer<ValueType> has a `from_json()` method of the form
+ `void from_json(const basic_json&, ValueType&)`, and
+ - @ref json_serializer<ValueType> does not have a `from_json()` method of
+ the form `ValueType from_json(const basic_json&)`
+
+ @tparam ValueType the returned value type
+
+ @return copy of the JSON value, converted to @a ValueType
+
+ @throw what @ref json_serializer<ValueType> `from_json()` method throws
+
+ @liveexample{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>`.,get__ValueType_const}
+
+ @since version 2.1.0
+ */
+ template < typename ValueType,
+ detail::enable_if_t <
+ detail::is_default_constructible<ValueType>::value&&
+ detail::has_from_json<basic_json_t, ValueType>::value,
+ int > = 0 >
+ ValueType get_impl(detail::priority_tag<0> /*unused*/) const noexcept(noexcept(
+ JSONSerializer<ValueType>::from_json(std::declval<const basic_json_t&>(), std::declval<ValueType&>())))
+ {
+ auto ret = ValueType();
+ JSONSerializer<ValueType>::from_json(*this, ret);
+ return ret;
+ }
+
+ /*!
+ @brief get a value (explicit); special case
+
+ Explicit type conversion between the JSON value and a compatible value
+ which is **not** [CopyConstructible](https://en.cppreference.com/w/cpp/named_req/CopyConstructible)
+ and **not** [DefaultConstructible](https://en.cppreference.com/w/cpp/named_req/DefaultConstructible).
+ The value is converted by calling the @ref json_serializer<ValueType>
+ `from_json()` method.
+
+ The function is equivalent to executing
+ @code {.cpp}
+ return JSONSerializer<ValueType>::from_json(*this);
+ @endcode
+
+ This overloads is chosen if:
+ - @a ValueType is not @ref basic_json and
+ - @ref json_serializer<ValueType> has a `from_json()` method of the form
+ `ValueType from_json(const basic_json&)`
+
+ @note If @ref json_serializer<ValueType> has both overloads of
+ `from_json()`, this one is chosen.
+
+ @tparam ValueType the returned value type
+
+ @return copy of the JSON value, converted to @a ValueType
+
+ @throw what @ref json_serializer<ValueType> `from_json()` method throws
+
+ @since version 2.1.0
+ */
+ template < typename ValueType,
+ detail::enable_if_t <
+ detail::has_non_default_from_json<basic_json_t, ValueType>::value,
+ int > = 0 >
+ ValueType get_impl(detail::priority_tag<1> /*unused*/) const noexcept(noexcept(
+ JSONSerializer<ValueType>::from_json(std::declval<const basic_json_t&>())))
+ {
+ return JSONSerializer<ValueType>::from_json(*this);
+ }
+
+ /*!
+ @brief get special-case overload
+
+ This overloads converts the current @ref basic_json in a different
+ @ref basic_json type
+
+ @tparam BasicJsonType == @ref basic_json
+
+ @return a copy of *this, converted into @a BasicJsonType
+
+ @complexity Depending on the implementation of the called `from_json()`
+ method.
+
+ @since version 3.2.0
+ */
+ template < typename BasicJsonType,
+ detail::enable_if_t <
+ detail::is_basic_json<BasicJsonType>::value,
+ int > = 0 >
+ BasicJsonType get_impl(detail::priority_tag<2> /*unused*/) const
+ {
+ return *this;
+ }
+
+ /*!
+ @brief get special-case overload
+
+ This overloads avoids a lot of template boilerplate, it can be seen as the
+ identity method
+
+ @tparam BasicJsonType == @ref basic_json
+
+ @return a copy of *this
+
+ @complexity Constant.
+
+ @since version 2.1.0
+ */
+ template<typename BasicJsonType,
+ detail::enable_if_t<
+ std::is_same<BasicJsonType, basic_json_t>::value,
+ int> = 0>
+ basic_json get_impl(detail::priority_tag<3> /*unused*/) const
+ {
+ return *this;
+ }
+
+ /*!
+ @brief get a pointer value (explicit)
+ @copydoc get()
+ */
+ template<typename PointerType,
+ detail::enable_if_t<
+ std::is_pointer<PointerType>::value,
+ int> = 0>
+ constexpr auto get_impl(detail::priority_tag<4> /*unused*/) const noexcept
+ -> decltype(std::declval<const basic_json_t&>().template get_ptr<PointerType>())
+ {
+ // delegate the call to get_ptr
+ return get_ptr<PointerType>();
+ }
+
+ public:
+ /*!
+ @brief get a (pointer) value (explicit)
+
+ Performs explicit type conversion between the JSON value and a compatible value if required.
+
+ - If the requested type is a pointer to the internally stored JSON value that pointer is returned.
+ No copies are made.
+
+ - If the requested type is the current @ref basic_json, or a different @ref basic_json convertible
+ from the current @ref basic_json.
+
+ - Otherwise the value is converted by calling the @ref json_serializer<ValueType> `from_json()`
+ method.
+
+ @tparam ValueTypeCV the provided value type
+ @tparam ValueType the returned value type
+
+ @return copy of the JSON value, converted to @tparam ValueType if necessary
+
+ @throw what @ref json_serializer<ValueType> `from_json()` method throws if conversion is required
+
+ @since version 2.1.0
+ */
+ template < typename ValueTypeCV, typename ValueType = detail::uncvref_t<ValueTypeCV>>
+#if defined(JSON_HAS_CPP_14)
+ constexpr
+#endif
+ auto get() const noexcept(
+ noexcept(std::declval<const basic_json_t&>().template get_impl<ValueType>(detail::priority_tag<4> {})))
+ -> decltype(std::declval<const basic_json_t&>().template get_impl<ValueType>(detail::priority_tag<4> {}))
+ {
+ // we cannot static_assert on ValueTypeCV being non-const, because
+ // there is support for get<const basic_json_t>(), which is why we
+ // still need the uncvref
+ static_assert(!std::is_reference<ValueTypeCV>::value,
+ "get() cannot be used with reference types, you might want to use get_ref()");
+ return get_impl<ValueType>(detail::priority_tag<4> {});
+ }
+
+ /*!
+ @brief get a pointer value (explicit)
+
+ Explicit pointer access to the internally stored JSON value. No copies are
+ made.
+
+ @warning The pointer becomes invalid if the underlying JSON object
+ changes.
+
+ @tparam PointerType pointer type; must be a pointer to @ref array_t, @ref
+ object_t, @ref string_t, @ref boolean_t, @ref number_integer_t,
+ @ref number_unsigned_t, or @ref number_float_t.
+
+ @return pointer to the internally stored JSON value if the requested
+ pointer type @a PointerType fits to the JSON value; `nullptr` otherwise
+
+ @complexity Constant.
+
+ @liveexample{The example below shows how pointers to internal values of a
+ JSON value can be requested. Note that no type conversions are made and a
+ `nullptr` is returned if the value and the requested pointer type does not
+ match.,get__PointerType}
+
+ @sa see @ref get_ptr() for explicit pointer-member access
+
+ @since version 1.0.0
+ */
+ template<typename PointerType, typename std::enable_if<
+ std::is_pointer<PointerType>::value, int>::type = 0>
+ auto get() noexcept -> decltype(std::declval<basic_json_t&>().template get_ptr<PointerType>())
+ {
+ // delegate the call to get_ptr
+ return get_ptr<PointerType>();
+ }
+
+ /// @brief get a value (explicit)
+ /// @sa https://json.nlohmann.me/api/basic_json/get_to/
+ template < typename ValueType,
+ detail::enable_if_t <
+ !detail::is_basic_json<ValueType>::value&&
+ detail::has_from_json<basic_json_t, ValueType>::value,
+ int > = 0 >
+ ValueType & get_to(ValueType& v) const noexcept(noexcept(
+ JSONSerializer<ValueType>::from_json(std::declval<const basic_json_t&>(), v)))
+ {
+ JSONSerializer<ValueType>::from_json(*this, v);
+ return v;
+ }
+
+ // specialization to allow calling get_to with a basic_json value
+ // see https://github.com/nlohmann/json/issues/2175
+ template<typename ValueType,
+ detail::enable_if_t <
+ detail::is_basic_json<ValueType>::value,
+ int> = 0>
+ ValueType & get_to(ValueType& v) const
+ {
+ v = *this;
+ return v;
+ }
+
+ template <
+ typename T, std::size_t N,
+ typename Array = T (&)[N], // NOLINT(cppcoreguidelines-avoid-c-arrays,hicpp-avoid-c-arrays,modernize-avoid-c-arrays)
+ detail::enable_if_t <
+ detail::has_from_json<basic_json_t, Array>::value, int > = 0 >
+ Array get_to(T (&v)[N]) const // NOLINT(cppcoreguidelines-avoid-c-arrays,hicpp-avoid-c-arrays,modernize-avoid-c-arrays)
+ noexcept(noexcept(JSONSerializer<Array>::from_json(
+ std::declval<const basic_json_t&>(), v)))
+ {
+ JSONSerializer<Array>::from_json(*this, v);
+ return v;
+ }
+
+ /// @brief get a reference value (implicit)
+ /// @sa https://json.nlohmann.me/api/basic_json/get_ref/
+ template<typename ReferenceType, typename std::enable_if<
+ std::is_reference<ReferenceType>::value, int>::type = 0>
+ ReferenceType get_ref()
+ {
+ // delegate call to get_ref_impl
+ return get_ref_impl<ReferenceType>(*this);
+ }
+
+ /// @brief get a reference value (implicit)
+ /// @sa https://json.nlohmann.me/api/basic_json/get_ref/
+ template < typename ReferenceType, typename std::enable_if <
+ std::is_reference<ReferenceType>::value&&
+ std::is_const<typename std::remove_reference<ReferenceType>::type>::value, int >::type = 0 >
+ ReferenceType get_ref() const
+ {
+ // delegate call to get_ref_impl
+ return get_ref_impl<ReferenceType>(*this);
+ }
+
+ /*!
+ @brief get a value (implicit)
+
+ Implicit type conversion between the JSON value and a compatible value.
+ The call is realized by calling @ref get() const.
+
+ @tparam ValueType non-pointer type compatible to the JSON value, for
+ instance `int` for JSON integer numbers, `bool` for JSON booleans, or
+ `std::vector` types for JSON arrays. The character type of @ref string_t
+ as well as an initializer list of this type is excluded to avoid
+ ambiguities as these types implicitly convert to `std::string`.
+
+ @return copy of the JSON value, converted to type @a ValueType
+
+ @throw type_error.302 in case passed type @a ValueType is incompatible
+ to the JSON value type (e.g., the JSON value is of type boolean, but a
+ string is requested); see example below
+
+ @complexity Linear in the size of the JSON value.
+
+ @liveexample{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>`.,operator__ValueType}
+
+ @since version 1.0.0
+ */
+ template < typename ValueType, typename std::enable_if <
+ detail::conjunction <
+ detail::negation<std::is_pointer<ValueType>>,
+ detail::negation<std::is_same<ValueType, detail::json_ref<basic_json>>>,
+ 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
+ detail::is_detected_lazy<detail::get_template_function, const basic_json_t&, ValueType>
+ >::value, int >::type = 0 >
+ JSON_EXPLICIT operator ValueType() const
+ {
+ // delegate the call to get<>() const
+ return get<ValueType>();
+ }
+
+ /// @brief get a binary value
+ /// @sa https://json.nlohmann.me/api/basic_json/get_binary/
+ binary_t& get_binary()
+ {
+ if (!is_binary())
+ {
+ JSON_THROW(type_error::create(302, "type must be binary, but is " + std::string(type_name()), *this));
+ }
+
+ return *get_ptr<binary_t*>();
+ }
+
+ /// @brief get a binary value
+ /// @sa https://json.nlohmann.me/api/basic_json/get_binary/
+ const binary_t& get_binary() const
+ {
+ if (!is_binary())
+ {
+ JSON_THROW(type_error::create(302, "type must be binary, but is " + std::string(type_name()), *this));
+ }
+
+ return *get_ptr<const binary_t*>();
+ }
+
+ /// @}
+
+
+ ////////////////////
+ // element access //
+ ////////////////////
+
+ /// @name element access
+ /// Access to the JSON value.
+ /// @{
+
+ /// @brief access specified array element with bounds checking
+ /// @sa https://json.nlohmann.me/api/basic_json/at/
+ reference at(size_type idx)
+ {
+ // at only works for arrays
+ if (JSON_HEDLEY_LIKELY(is_array()))
+ {
+ JSON_TRY
+ {
+ return set_parent(m_value.array->at(idx));
+ }
+ JSON_CATCH (std::out_of_range&)
+ {
+ // create better exception explanation
+ JSON_THROW(out_of_range::create(401, "array index " + std::to_string(idx) + " is out of range", *this));
+ }
+ }
+ else
+ {
+ JSON_THROW(type_error::create(304, "cannot use at() with " + std::string(type_name()), *this));
+ }
+ }
+
+ /// @brief access specified array element with bounds checking
+ /// @sa https://json.nlohmann.me/api/basic_json/at/
+ const_reference at(size_type idx) const
+ {
+ // at only works for arrays
+ if (JSON_HEDLEY_LIKELY(is_array()))
+ {
+ JSON_TRY
+ {
+ return m_value.array->at(idx);
+ }
+ JSON_CATCH (std::out_of_range&)
+ {
+ // create better exception explanation
+ JSON_THROW(out_of_range::create(401, "array index " + std::to_string(idx) + " is out of range", *this));
+ }
+ }
+ else
+ {
+ JSON_THROW(type_error::create(304, "cannot use at() with " + std::string(type_name()), *this));
+ }
+ }
+
+ /// @brief access specified object element with bounds checking
+ /// @sa https://json.nlohmann.me/api/basic_json/at/
+ 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, "key '" + key + "' not found", *this));
+ }
+ }
+ else
+ {
+ JSON_THROW(type_error::create(304, "cannot use at() with " + std::string(type_name()), *this));
+ }
+ }
+
+ /// @brief access specified object element with bounds checking
+ /// @sa https://json.nlohmann.me/api/basic_json/at/
+ 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, "key '" + key + "' not found", *this));
+ }
+ }
+ else
+ {
+ JSON_THROW(type_error::create(304, "cannot use at() with " + std::string(type_name()), *this));
+ }
+ }
+
+ /// @brief access specified array element
+ /// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
+ reference operator[](size_type idx)
+ {
+ // implicitly convert null value to an empty array
+ if (is_null())
+ {
+ m_type = value_t::array;
+ m_value.array = create<array_t>();
+ assert_invariant();
+ }
+
+ // operator[] only works for arrays
+ if (JSON_HEDLEY_LIKELY(is_array()))
+ {
+ // fill up array with null values if given idx is outside range
+ if (idx >= m_value.array->size())
+ {
+#if JSON_DIAGNOSTICS
+ // remember array size & capacity before resizing
+ const auto old_size = m_value.array->size();
+ const auto old_capacity = m_value.array->capacity();
+#endif
+ m_value.array->resize(idx + 1);
+
+#if JSON_DIAGNOSTICS
+ if (JSON_HEDLEY_UNLIKELY(m_value.array->capacity() != old_capacity))
+ {
+ // capacity has changed: update all parents
+ set_parents();
+ }
+ else
+ {
+ // set parent for values added above
+ set_parents(begin() + static_cast<typename iterator::difference_type>(old_size), static_cast<typename iterator::difference_type>(idx + 1 - old_size));
+ }
+#endif
+ assert_invariant();
+ }
+
+ return m_value.array->operator[](idx);
+ }
+
+ JSON_THROW(type_error::create(305, "cannot use operator[] with a numeric argument with " + std::string(type_name()), *this));
+ }
+
+ /// @brief access specified array element
+ /// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
+ const_reference operator[](size_type idx) const
+ {
+ // const operator[] only works for arrays
+ if (JSON_HEDLEY_LIKELY(is_array()))
+ {
+ return m_value.array->operator[](idx);
+ }
+
+ JSON_THROW(type_error::create(305, "cannot use operator[] with a numeric argument with " + std::string(type_name()), *this));
+ }
+
+ /// @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)
+ {
+ // implicitly convert null value to an empty object
+ if (is_null())
+ {
+ m_type = value_t::object;
+ m_value.object = create<object_t>();
+ assert_invariant();
+ }
+
+ // operator[] only works for objects
+ if (JSON_HEDLEY_LIKELY(is_object()))
+ {
+ return set_parent(m_value.object->operator[](key));
+ }
+
+ JSON_THROW(type_error::create(305, "cannot use operator[] with a string argument with " + std::string(type_name()), *this));
+ }
+
+ /// @brief access specified object element
+ /// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
+ const_reference operator[](const typename object_t::key_type& key) const
+ {
+ // 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;
+ }
+
+ JSON_THROW(type_error::create(305, "cannot use operator[] with a string argument with " + std::string(type_name()), *this));
+ }
+
+ /// @brief access specified object element
+ /// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
+ template<typename T>
+ JSON_HEDLEY_NON_NULL(2)
+ reference operator[](T* key)
+ {
+ // implicitly convert null to object
+ if (is_null())
+ {
+ m_type = value_t::object;
+ m_value = value_t::object;
+ assert_invariant();
+ }
+
+ // at only works for objects
+ if (JSON_HEDLEY_LIKELY(is_object()))
+ {
+ return set_parent(m_value.object->operator[](key));
+ }
+
+ JSON_THROW(type_error::create(305, "cannot use operator[] with a string argument with " + std::string(type_name()), *this));
+ }
+
+ /// @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
+ {
+ // at 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;
+ }
+
+ JSON_THROW(type_error::create(305, "cannot use operator[] with a string argument with " + std::string(type_name()), *this));
+ }
+
+ /// @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
+ {
+ // at 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 default_value;
+ }
+
+ JSON_THROW(type_error::create(306, "cannot use value() with " + std::string(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*
+ string_t value(const typename object_t::key_type& key, const char* default_value) const
+ {
+ return value(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>
+ ValueType value(const json_pointer& ptr, const ValueType& default_value) const
+ {
+ // at only works for objects
+ if (JSON_HEDLEY_LIKELY(is_object()))
+ {
+ // if pointer resolves a value, return it or use default value
+ JSON_TRY
+ {
+ return ptr.get_checked(this).template get<ValueType>();
+ }
+ JSON_INTERNAL_CATCH (out_of_range&)
+ {
+ return default_value;
+ }
+ }
+
+ JSON_THROW(type_error::create(306, "cannot use value() with " + std::string(type_name()), *this));
+ }
+
+ /// @brief access specified object element via JSON Pointer with default value
+ /// @sa https://json.nlohmann.me/api/basic_json/value/
+ /// overload for a default value of type const char*
+ JSON_HEDLEY_NON_NULL(3)
+ string_t value(const json_pointer& ptr, const char* default_value) const
+ {
+ return value(ptr, string_t(default_value));
+ }
+
+ /// @brief access the first element
+ /// @sa https://json.nlohmann.me/api/basic_json/front/
+ reference front()
+ {
+ return *begin();
+ }
+
+ /// @brief access the first element
+ /// @sa https://json.nlohmann.me/api/basic_json/front/
+ const_reference front() const
+ {
+ return *cbegin();
+ }
+
+ /// @brief access the last element
+ /// @sa https://json.nlohmann.me/api/basic_json/back/
+ reference back()
+ {
+ auto tmp = end();
+ --tmp;
+ return *tmp;
+ }
+
+ /// @brief access the last element
+ /// @sa https://json.nlohmann.me/api/basic_json/back/
+ const_reference back() const
+ {
+ auto tmp = cend();
+ --tmp;
+ return *tmp;
+ }
+
+ /// @brief remove element given an iterator
+ /// @sa https://json.nlohmann.me/api/basic_json/erase/
+ template < class IteratorType, typename std::enable_if <
+ std::is_same<IteratorType, typename basic_json_t::iterator>::value ||
+ std::is_same<IteratorType, typename basic_json_t::const_iterator>::value, int >::type
+ = 0 >
+ IteratorType erase(IteratorType pos)
+ {
+ // make sure iterator fits the current value
+ if (JSON_HEDLEY_UNLIKELY(this != pos.m_object))
+ {
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ }
+
+ IteratorType result = end();
+
+ switch (m_type)
+ {
+ case value_t::boolean:
+ case value_t::number_float:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::string:
+ case value_t::binary:
+ {
+ if (JSON_HEDLEY_UNLIKELY(!pos.m_it.primitive_iterator.is_begin()))
+ {
+ JSON_THROW(invalid_iterator::create(205, "iterator out of range", *this));
+ }
+
+ if (is_string())
+ {
+ AllocatorType<string_t> alloc;
+ std::allocator_traits<decltype(alloc)>::destroy(alloc, m_value.string);
+ std::allocator_traits<decltype(alloc)>::deallocate(alloc, m_value.string, 1);
+ m_value.string = nullptr;
+ }
+ else if (is_binary())
+ {
+ AllocatorType<binary_t> alloc;
+ std::allocator_traits<decltype(alloc)>::destroy(alloc, m_value.binary);
+ std::allocator_traits<decltype(alloc)>::deallocate(alloc, m_value.binary, 1);
+ m_value.binary = nullptr;
+ }
+
+ m_type = value_t::null;
+ assert_invariant();
+ break;
+ }
+
+ case value_t::object:
+ {
+ result.m_it.object_iterator = m_value.object->erase(pos.m_it.object_iterator);
+ break;
+ }
+
+ case value_t::array:
+ {
+ result.m_it.array_iterator = m_value.array->erase(pos.m_it.array_iterator);
+ break;
+ }
+
+ case value_t::null:
+ case value_t::discarded:
+ default:
+ JSON_THROW(type_error::create(307, "cannot use erase() with " + std::string(type_name()), *this));
+ }
+
+ return result;
+ }
+
+ /// @brief remove elements given an iterator range
+ /// @sa https://json.nlohmann.me/api/basic_json/erase/
+ template < class IteratorType, typename std::enable_if <
+ std::is_same<IteratorType, typename basic_json_t::iterator>::value ||
+ std::is_same<IteratorType, typename basic_json_t::const_iterator>::value, int >::type
+ = 0 >
+ IteratorType erase(IteratorType first, IteratorType last)
+ {
+ // make sure iterator fits the current value
+ if (JSON_HEDLEY_UNLIKELY(this != first.m_object || this != last.m_object))
+ {
+ JSON_THROW(invalid_iterator::create(203, "iterators do not fit current value", *this));
+ }
+
+ IteratorType result = end();
+
+ switch (m_type)
+ {
+ case value_t::boolean:
+ case value_t::number_float:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::string:
+ case value_t::binary:
+ {
+ if (JSON_HEDLEY_LIKELY(!first.m_it.primitive_iterator.is_begin()
+ || !last.m_it.primitive_iterator.is_end()))
+ {
+ JSON_THROW(invalid_iterator::create(204, "iterators out of range", *this));
+ }
+
+ if (is_string())
+ {
+ AllocatorType<string_t> alloc;
+ std::allocator_traits<decltype(alloc)>::destroy(alloc, m_value.string);
+ std::allocator_traits<decltype(alloc)>::deallocate(alloc, m_value.string, 1);
+ m_value.string = nullptr;
+ }
+ else if (is_binary())
+ {
+ AllocatorType<binary_t> alloc;
+ std::allocator_traits<decltype(alloc)>::destroy(alloc, m_value.binary);
+ std::allocator_traits<decltype(alloc)>::deallocate(alloc, m_value.binary, 1);
+ m_value.binary = nullptr;
+ }
+
+ m_type = value_t::null;
+ assert_invariant();
+ break;
+ }
+
+ case value_t::object:
+ {
+ result.m_it.object_iterator = m_value.object->erase(first.m_it.object_iterator,
+ last.m_it.object_iterator);
+ break;
+ }
+
+ case value_t::array:
+ {
+ result.m_it.array_iterator = m_value.array->erase(first.m_it.array_iterator,
+ last.m_it.array_iterator);
+ break;
+ }
+
+ case value_t::null:
+ case value_t::discarded:
+ default:
+ JSON_THROW(type_error::create(307, "cannot use erase() with " + std::string(type_name()), *this));
+ }
+
+ return result;
+ }
+
+ /// @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);
+ }
+
+ JSON_THROW(type_error::create(307, "cannot use erase() with " + std::string(type_name()), *this));
+ }
+
+ /// @brief remove element from a JSON array given an index
+ /// @sa https://json.nlohmann.me/api/basic_json/erase/
+ void erase(const size_type idx)
+ {
+ // this erase only works for arrays
+ if (JSON_HEDLEY_LIKELY(is_array()))
+ {
+ if (JSON_HEDLEY_UNLIKELY(idx >= size()))
+ {
+ JSON_THROW(out_of_range::create(401, "array index " + std::to_string(idx) + " is out of range", *this));
+ }
+
+ m_value.array->erase(m_value.array->begin() + static_cast<difference_type>(idx));
+ }
+ else
+ {
+ JSON_THROW(type_error::create(307, "cannot use erase() with " + std::string(type_name()), *this));
+ }
+ }
+
+ /// @}
+
+
+ ////////////
+ // lookup //
+ ////////////
+
+ /// @name lookup
+ /// @{
+
+ /// @brief find an element in a JSON object
+ /// @sa https://json.nlohmann.me/api/basic_json/find/
+ template<typename KeyT>
+ iterator find(KeyT&& key)
+ {
+ auto result = end();
+
+ if (is_object())
+ {
+ result.m_it.object_iterator = m_value.object->find(std::forward<KeyT>(key));
+ }
+
+ return result;
+ }
+
+ /// @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
+ {
+ auto result = cend();
+
+ if (is_object())
+ {
+ result.m_it.object_iterator = m_value.object->find(std::forward<KeyT>(key));
+ }
+
+ return result;
+ }
+
+ /// @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
+ {
+ // return 0 for all nonobject types
+ return is_object() ? m_value.object->count(std::forward<KeyT>(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 <
+ !std::is_same<typename std::decay<KeyT>::type, json_pointer>::value, int >::type = 0 >
+ bool contains(KeyT && key) const
+ {
+ return is_object() && m_value.object->find(std::forward<KeyT>(key)) != m_value.object->end();
+ }
+
+ /// @brief check the existence of an element in a JSON object given a JSON pointer
+ /// @sa https://json.nlohmann.me/api/basic_json/contains/
+ bool contains(const json_pointer& ptr) const
+ {
+ return ptr.contains(this);
+ }
+
+ /// @}
+
+
+ ///////////////
+ // iterators //
+ ///////////////
+
+ /// @name iterators
+ /// @{
+
+ /// @brief returns an iterator to the first element
+ /// @sa https://json.nlohmann.me/api/basic_json/begin/
+ iterator begin() noexcept
+ {
+ iterator result(this);
+ result.set_begin();
+ return result;
+ }
+
+ /// @brief returns an iterator to the first element
+ /// @sa https://json.nlohmann.me/api/basic_json/begin/
+ const_iterator begin() const noexcept
+ {
+ return cbegin();
+ }
+
+ /// @brief returns a const iterator to the first element
+ /// @sa https://json.nlohmann.me/api/basic_json/cbegin/
+ const_iterator cbegin() const noexcept
+ {
+ const_iterator result(this);
+ result.set_begin();
+ return result;
+ }
+
+ /// @brief returns an iterator to one past the last element
+ /// @sa https://json.nlohmann.me/api/basic_json/end/
+ iterator end() noexcept
+ {
+ iterator result(this);
+ result.set_end();
+ return result;
+ }
+
+ /// @brief returns an iterator to one past the last element
+ /// @sa https://json.nlohmann.me/api/basic_json/end/
+ const_iterator end() const noexcept
+ {
+ return cend();
+ }
+
+ /// @brief returns an iterator to one past the last element
+ /// @sa https://json.nlohmann.me/api/basic_json/cend/
+ const_iterator cend() const noexcept
+ {
+ const_iterator result(this);
+ result.set_end();
+ return result;
+ }
+
+ /// @brief returns an iterator to the reverse-beginning
+ /// @sa https://json.nlohmann.me/api/basic_json/rbegin/
+ reverse_iterator rbegin() noexcept
+ {
+ return reverse_iterator(end());
+ }
+
+ /// @brief returns an iterator to the reverse-beginning
+ /// @sa https://json.nlohmann.me/api/basic_json/rbegin/
+ const_reverse_iterator rbegin() const noexcept
+ {
+ return crbegin();
+ }
+
+ /// @brief returns an iterator to the reverse-end
+ /// @sa https://json.nlohmann.me/api/basic_json/rend/
+ reverse_iterator rend() noexcept
+ {
+ return reverse_iterator(begin());
+ }
+
+ /// @brief returns an iterator to the reverse-end
+ /// @sa https://json.nlohmann.me/api/basic_json/rend/
+ const_reverse_iterator rend() const noexcept
+ {
+ return crend();
+ }
+
+ /// @brief returns a const reverse iterator to the last element
+ /// @sa https://json.nlohmann.me/api/basic_json/crbegin/
+ const_reverse_iterator crbegin() const noexcept
+ {
+ return const_reverse_iterator(cend());
+ }
+
+ /// @brief returns a const reverse iterator to one before the first
+ /// @sa https://json.nlohmann.me/api/basic_json/crend/
+ const_reverse_iterator crend() const noexcept
+ {
+ return const_reverse_iterator(cbegin());
+ }
+
+ public:
+ /// @brief wrapper to access iterator member functions in range-based for
+ /// @sa https://json.nlohmann.me/api/basic_json/items/
+ /// @deprecated This function is deprecated since 3.1.0 and will be removed in
+ /// version 4.0.0 of the library. Please use @ref items() instead;
+ /// that is, replace `json::iterator_wrapper(j)` with `j.items()`.
+ JSON_HEDLEY_DEPRECATED_FOR(3.1.0, items())
+ static iteration_proxy<iterator> iterator_wrapper(reference ref) noexcept
+ {
+ return ref.items();
+ }
+
+ /// @brief wrapper to access iterator member functions in range-based for
+ /// @sa https://json.nlohmann.me/api/basic_json/items/
+ /// @deprecated This function is deprecated since 3.1.0 and will be removed in
+ /// version 4.0.0 of the library. Please use @ref items() instead;
+ /// that is, replace `json::iterator_wrapper(j)` with `j.items()`.
+ JSON_HEDLEY_DEPRECATED_FOR(3.1.0, items())
+ static iteration_proxy<const_iterator> iterator_wrapper(const_reference ref) noexcept
+ {
+ return ref.items();
+ }
+
+ /// @brief helper to access iterator member functions in range-based for
+ /// @sa https://json.nlohmann.me/api/basic_json/items/
+ iteration_proxy<iterator> items() noexcept
+ {
+ return iteration_proxy<iterator>(*this);
+ }
+
+ /// @brief helper to access iterator member functions in range-based for
+ /// @sa https://json.nlohmann.me/api/basic_json/items/
+ iteration_proxy<const_iterator> items() const noexcept
+ {
+ return iteration_proxy<const_iterator>(*this);
+ }
+
+ /// @}
+
+
+ //////////////
+ // capacity //
+ //////////////
+
+ /// @name capacity
+ /// @{
+
+ /// @brief checks whether the container is empty.
+ /// @sa https://json.nlohmann.me/api/basic_json/empty/
+ bool empty() const noexcept
+ {
+ switch (m_type)
+ {
+ case value_t::null:
+ {
+ // null values are empty
+ return true;
+ }
+
+ case value_t::array:
+ {
+ // delegate call to array_t::empty()
+ return m_value.array->empty();
+ }
+
+ case value_t::object:
+ {
+ // delegate call to object_t::empty()
+ return m_value.object->empty();
+ }
+
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ {
+ // all other types are nonempty
+ return false;
+ }
+ }
+ }
+
+ /// @brief returns the number of elements
+ /// @sa https://json.nlohmann.me/api/basic_json/size/
+ size_type size() const noexcept
+ {
+ switch (m_type)
+ {
+ case value_t::null:
+ {
+ // null values are empty
+ return 0;
+ }
+
+ case value_t::array:
+ {
+ // delegate call to array_t::size()
+ return m_value.array->size();
+ }
+
+ case value_t::object:
+ {
+ // delegate call to object_t::size()
+ return m_value.object->size();
+ }
+
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ {
+ // all other types have size 1
+ return 1;
+ }
+ }
+ }
+
+ /// @brief returns the maximum possible number of elements
+ /// @sa https://json.nlohmann.me/api/basic_json/max_size/
+ size_type max_size() const noexcept
+ {
+ switch (m_type)
+ {
+ case value_t::array:
+ {
+ // delegate call to array_t::max_size()
+ return m_value.array->max_size();
+ }
+
+ case value_t::object:
+ {
+ // delegate call to object_t::max_size()
+ return m_value.object->max_size();
+ }
+
+ case value_t::null:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ {
+ // all other types have max_size() == size()
+ return size();
+ }
+ }
+ }
+
+ /// @}
+
+
+ ///////////////
+ // modifiers //
+ ///////////////
+
+ /// @name modifiers
+ /// @{
+
+ /// @brief clears the contents
+ /// @sa https://json.nlohmann.me/api/basic_json/clear/
+ void clear() noexcept
+ {
+ switch (m_type)
+ {
+ case value_t::number_integer:
+ {
+ m_value.number_integer = 0;
+ break;
+ }
+
+ case value_t::number_unsigned:
+ {
+ m_value.number_unsigned = 0;
+ break;
+ }
+
+ case value_t::number_float:
+ {
+ m_value.number_float = 0.0;
+ break;
+ }
+
+ case value_t::boolean:
+ {
+ m_value.boolean = false;
+ break;
+ }
+
+ case value_t::string:
+ {
+ m_value.string->clear();
+ break;
+ }
+
+ case value_t::binary:
+ {
+ m_value.binary->clear();
+ break;
+ }
+
+ case value_t::array:
+ {
+ m_value.array->clear();
+ break;
+ }
+
+ case value_t::object:
+ {
+ m_value.object->clear();
+ break;
+ }
+
+ case value_t::null:
+ case value_t::discarded:
+ default:
+ break;
+ }
+ }
+
+ /// @brief add an object to an array
+ /// @sa https://json.nlohmann.me/api/basic_json/push_back/
+ void push_back(basic_json&& val)
+ {
+ // push_back only works for null objects or arrays
+ if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_array())))
+ {
+ JSON_THROW(type_error::create(308, "cannot use push_back() with " + std::string(type_name()), *this));
+ }
+
+ // transform null object into an array
+ if (is_null())
+ {
+ m_type = value_t::array;
+ m_value = value_t::array;
+ assert_invariant();
+ }
+
+ // add element to array (move semantics)
+ const auto old_capacity = m_value.array->capacity();
+ m_value.array->push_back(std::move(val));
+ set_parent(m_value.array->back(), old_capacity);
+ // if val is moved from, basic_json move constructor marks it null, so we do not call the destructor
+ }
+
+ /// @brief add an object to an array
+ /// @sa https://json.nlohmann.me/api/basic_json/operator+=/
+ reference operator+=(basic_json&& val)
+ {
+ push_back(std::move(val));
+ return *this;
+ }
+
+ /// @brief add an object to an array
+ /// @sa https://json.nlohmann.me/api/basic_json/push_back/
+ void push_back(const basic_json& val)
+ {
+ // push_back only works for null objects or arrays
+ if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_array())))
+ {
+ JSON_THROW(type_error::create(308, "cannot use push_back() with " + std::string(type_name()), *this));
+ }
+
+ // transform null object into an array
+ if (is_null())
+ {
+ m_type = value_t::array;
+ m_value = value_t::array;
+ assert_invariant();
+ }
+
+ // add element to array
+ const auto old_capacity = m_value.array->capacity();
+ m_value.array->push_back(val);
+ set_parent(m_value.array->back(), old_capacity);
+ }
+
+ /// @brief add an object to an array
+ /// @sa https://json.nlohmann.me/api/basic_json/operator+=/
+ reference operator+=(const basic_json& val)
+ {
+ push_back(val);
+ return *this;
+ }
+
+ /// @brief add an object to an object
+ /// @sa https://json.nlohmann.me/api/basic_json/push_back/
+ void push_back(const typename object_t::value_type& val)
+ {
+ // push_back only works for null objects or objects
+ if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_object())))
+ {
+ JSON_THROW(type_error::create(308, "cannot use push_back() with " + std::string(type_name()), *this));
+ }
+
+ // transform null object into an object
+ if (is_null())
+ {
+ m_type = value_t::object;
+ m_value = value_t::object;
+ assert_invariant();
+ }
+
+ // add element to object
+ auto res = m_value.object->insert(val);
+ set_parent(res.first->second);
+ }
+
+ /// @brief add an object to an object
+ /// @sa https://json.nlohmann.me/api/basic_json/operator+=/
+ reference operator+=(const typename object_t::value_type& val)
+ {
+ push_back(val);
+ return *this;
+ }
+
+ /// @brief add an object to an object
+ /// @sa https://json.nlohmann.me/api/basic_json/push_back/
+ void push_back(initializer_list_t init)
+ {
+ if (is_object() && init.size() == 2 && (*init.begin())->is_string())
+ {
+ basic_json&& key = init.begin()->moved_or_copied();
+ push_back(typename object_t::value_type(
+ std::move(key.get_ref<string_t&>()), (init.begin() + 1)->moved_or_copied()));
+ }
+ else
+ {
+ push_back(basic_json(init));
+ }
+ }
+
+ /// @brief add an object to an object
+ /// @sa https://json.nlohmann.me/api/basic_json/operator+=/
+ reference operator+=(initializer_list_t init)
+ {
+ push_back(init);
+ return *this;
+ }
+
+ /// @brief add an object to an array
+ /// @sa https://json.nlohmann.me/api/basic_json/emplace_back/
+ template<class... Args>
+ reference emplace_back(Args&& ... args)
+ {
+ // emplace_back only works for null objects or arrays
+ if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_array())))
+ {
+ JSON_THROW(type_error::create(311, "cannot use emplace_back() with " + std::string(type_name()), *this));
+ }
+
+ // transform null object into an array
+ if (is_null())
+ {
+ m_type = value_t::array;
+ m_value = value_t::array;
+ assert_invariant();
+ }
+
+ // add element to array (perfect forwarding)
+ const auto old_capacity = m_value.array->capacity();
+ m_value.array->emplace_back(std::forward<Args>(args)...);
+ return set_parent(m_value.array->back(), old_capacity);
+ }
+
+ /// @brief add an object to an object if key does not exist
+ /// @sa https://json.nlohmann.me/api/basic_json/emplace/
+ template<class... Args>
+ std::pair<iterator, bool> emplace(Args&& ... args)
+ {
+ // emplace only works for null objects or arrays
+ if (JSON_HEDLEY_UNLIKELY(!(is_null() || is_object())))
+ {
+ JSON_THROW(type_error::create(311, "cannot use emplace() with " + std::string(type_name()), *this));
+ }
+
+ // transform null object into an object
+ if (is_null())
+ {
+ m_type = value_t::object;
+ m_value = value_t::object;
+ assert_invariant();
+ }
+
+ // add element to array (perfect forwarding)
+ auto res = m_value.object->emplace(std::forward<Args>(args)...);
+ set_parent(res.first->second);
+
+ // create result iterator and set iterator to the result of emplace
+ auto it = begin();
+ it.m_it.object_iterator = res.first;
+
+ // return pair of iterator and boolean
+ return {it, res.second};
+ }
+
+ /// Helper for insertion of an iterator
+ /// @note: This uses std::distance to support GCC 4.8,
+ /// see https://github.com/nlohmann/json/pull/1257
+ template<typename... Args>
+ iterator insert_iterator(const_iterator pos, Args&& ... args)
+ {
+ iterator result(this);
+ JSON_ASSERT(m_value.array != nullptr);
+
+ auto insert_pos = std::distance(m_value.array->begin(), pos.m_it.array_iterator);
+ m_value.array->insert(pos.m_it.array_iterator, std::forward<Args>(args)...);
+ result.m_it.array_iterator = m_value.array->begin() + insert_pos;
+
+ // This could have been written as:
+ // result.m_it.array_iterator = m_value.array->insert(pos.m_it.array_iterator, cnt, val);
+ // but the return value of insert is missing in GCC 4.8, so it is written this way instead.
+
+ set_parents();
+ return result;
+ }
+
+ /// @brief inserts element into array
+ /// @sa https://json.nlohmann.me/api/basic_json/insert/
+ iterator insert(const_iterator pos, const basic_json& val)
+ {
+ // insert only works for arrays
+ if (JSON_HEDLEY_LIKELY(is_array()))
+ {
+ // check if iterator pos fits to this JSON value
+ if (JSON_HEDLEY_UNLIKELY(pos.m_object != this))
+ {
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ }
+
+ // insert to array and return iterator
+ return insert_iterator(pos, val);
+ }
+
+ JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ }
+
+ /// @brief inserts element into array
+ /// @sa https://json.nlohmann.me/api/basic_json/insert/
+ iterator insert(const_iterator pos, basic_json&& val)
+ {
+ return insert(pos, val);
+ }
+
+ /// @brief inserts copies of element into array
+ /// @sa https://json.nlohmann.me/api/basic_json/insert/
+ iterator insert(const_iterator pos, size_type cnt, const basic_json& val)
+ {
+ // insert only works for arrays
+ if (JSON_HEDLEY_LIKELY(is_array()))
+ {
+ // check if iterator pos fits to this JSON value
+ if (JSON_HEDLEY_UNLIKELY(pos.m_object != this))
+ {
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ }
+
+ // insert to array and return iterator
+ return insert_iterator(pos, cnt, val);
+ }
+
+ JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ }
+
+ /// @brief inserts range of elements into array
+ /// @sa https://json.nlohmann.me/api/basic_json/insert/
+ iterator insert(const_iterator pos, const_iterator first, const_iterator last)
+ {
+ // insert only works for arrays
+ if (JSON_HEDLEY_UNLIKELY(!is_array()))
+ {
+ JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ }
+
+ // check if iterator pos fits to this JSON value
+ if (JSON_HEDLEY_UNLIKELY(pos.m_object != this))
+ {
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ }
+
+ // check if range iterators belong to the same JSON object
+ if (JSON_HEDLEY_UNLIKELY(first.m_object != last.m_object))
+ {
+ JSON_THROW(invalid_iterator::create(210, "iterators do not fit", *this));
+ }
+
+ if (JSON_HEDLEY_UNLIKELY(first.m_object == this))
+ {
+ JSON_THROW(invalid_iterator::create(211, "passed iterators may not belong to container", *this));
+ }
+
+ // insert to array and return iterator
+ return insert_iterator(pos, first.m_it.array_iterator, last.m_it.array_iterator);
+ }
+
+ /// @brief inserts elements from initializer list into array
+ /// @sa https://json.nlohmann.me/api/basic_json/insert/
+ iterator insert(const_iterator pos, initializer_list_t ilist)
+ {
+ // insert only works for arrays
+ if (JSON_HEDLEY_UNLIKELY(!is_array()))
+ {
+ JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ }
+
+ // check if iterator pos fits to this JSON value
+ if (JSON_HEDLEY_UNLIKELY(pos.m_object != this))
+ {
+ JSON_THROW(invalid_iterator::create(202, "iterator does not fit current value", *this));
+ }
+
+ // insert to array and return iterator
+ return insert_iterator(pos, ilist.begin(), ilist.end());
+ }
+
+ /// @brief inserts range of elements into object
+ /// @sa https://json.nlohmann.me/api/basic_json/insert/
+ void insert(const_iterator first, const_iterator last)
+ {
+ // insert only works for objects
+ if (JSON_HEDLEY_UNLIKELY(!is_object()))
+ {
+ JSON_THROW(type_error::create(309, "cannot use insert() with " + std::string(type_name()), *this));
+ }
+
+ // check if range iterators belong to the same JSON object
+ if (JSON_HEDLEY_UNLIKELY(first.m_object != last.m_object))
+ {
+ JSON_THROW(invalid_iterator::create(210, "iterators do not fit", *this));
+ }
+
+ // passed iterators must belong to objects
+ if (JSON_HEDLEY_UNLIKELY(!first.m_object->is_object()))
+ {
+ JSON_THROW(invalid_iterator::create(202, "iterators first and last must point to objects", *this));
+ }
+
+ m_value.object->insert(first.m_it.object_iterator, last.m_it.object_iterator);
+ }
+
+ /// @brief updates a JSON object from another object, overwriting existing keys
+ /// @sa https://json.nlohmann.me/api/basic_json/update/
+ void update(const_reference j, bool merge_objects = false)
+ {
+ update(j.begin(), j.end(), merge_objects);
+ }
+
+ /// @brief updates a JSON object from another object, overwriting existing keys
+ /// @sa https://json.nlohmann.me/api/basic_json/update/
+ void update(const_iterator first, const_iterator last, bool merge_objects = false)
+ {
+ // implicitly convert null value to an empty object
+ if (is_null())
+ {
+ m_type = value_t::object;
+ m_value.object = create<object_t>();
+ assert_invariant();
+ }
+
+ if (JSON_HEDLEY_UNLIKELY(!is_object()))
+ {
+ JSON_THROW(type_error::create(312, "cannot use update() with " + std::string(type_name()), *this));
+ }
+
+ // check if range iterators belong to the same JSON object
+ if (JSON_HEDLEY_UNLIKELY(first.m_object != last.m_object))
+ {
+ JSON_THROW(invalid_iterator::create(210, "iterators do not fit", *this));
+ }
+
+ // passed iterators must belong to objects
+ if (JSON_HEDLEY_UNLIKELY(!first.m_object->is_object()))
+ {
+ JSON_THROW(type_error::create(312, "cannot use update() with " + std::string(first.m_object->type_name()), *first.m_object));
+ }
+
+ for (auto it = first; it != last; ++it)
+ {
+ if (merge_objects && it.value().is_object())
+ {
+ auto it2 = m_value.object->find(it.key());
+ if (it2 != m_value.object->end())
+ {
+ it2->second.update(it.value(), true);
+ continue;
+ }
+ }
+ m_value.object->operator[](it.key()) = it.value();
+#if JSON_DIAGNOSTICS
+ m_value.object->operator[](it.key()).m_parent = this;
+#endif
+ }
+ }
+
+ /// @brief exchanges the values
+ /// @sa https://json.nlohmann.me/api/basic_json/swap/
+ void swap(reference other) noexcept (
+ std::is_nothrow_move_constructible<value_t>::value&&
+ std::is_nothrow_move_assignable<value_t>::value&&
+ std::is_nothrow_move_constructible<json_value>::value&&
+ std::is_nothrow_move_assignable<json_value>::value
+ )
+ {
+ std::swap(m_type, other.m_type);
+ std::swap(m_value, other.m_value);
+
+ set_parents();
+ other.set_parents();
+ assert_invariant();
+ }
+
+ /// @brief exchanges the values
+ /// @sa https://json.nlohmann.me/api/basic_json/swap/
+ friend void swap(reference left, reference right) noexcept (
+ std::is_nothrow_move_constructible<value_t>::value&&
+ std::is_nothrow_move_assignable<value_t>::value&&
+ std::is_nothrow_move_constructible<json_value>::value&&
+ std::is_nothrow_move_assignable<json_value>::value
+ )
+ {
+ left.swap(right);
+ }
+
+ /// @brief exchanges the values
+ /// @sa https://json.nlohmann.me/api/basic_json/swap/
+ void swap(array_t& other) // NOLINT(bugprone-exception-escape)
+ {
+ // swap only works for arrays
+ if (JSON_HEDLEY_LIKELY(is_array()))
+ {
+ std::swap(*(m_value.array), other);
+ }
+ else
+ {
+ JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ }
+ }
+
+ /// @brief exchanges the values
+ /// @sa https://json.nlohmann.me/api/basic_json/swap/
+ void swap(object_t& other) // NOLINT(bugprone-exception-escape)
+ {
+ // swap only works for objects
+ if (JSON_HEDLEY_LIKELY(is_object()))
+ {
+ std::swap(*(m_value.object), other);
+ }
+ else
+ {
+ JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ }
+ }
+
+ /// @brief exchanges the values
+ /// @sa https://json.nlohmann.me/api/basic_json/swap/
+ void swap(string_t& other) // NOLINT(bugprone-exception-escape)
+ {
+ // swap only works for strings
+ if (JSON_HEDLEY_LIKELY(is_string()))
+ {
+ std::swap(*(m_value.string), other);
+ }
+ else
+ {
+ JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ }
+ }
+
+ /// @brief exchanges the values
+ /// @sa https://json.nlohmann.me/api/basic_json/swap/
+ void swap(binary_t& other) // NOLINT(bugprone-exception-escape)
+ {
+ // swap only works for strings
+ if (JSON_HEDLEY_LIKELY(is_binary()))
+ {
+ std::swap(*(m_value.binary), other);
+ }
+ else
+ {
+ JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ }
+ }
+
+ /// @brief exchanges the values
+ /// @sa https://json.nlohmann.me/api/basic_json/swap/
+ void swap(typename binary_t::container_type& other) // NOLINT(bugprone-exception-escape)
+ {
+ // swap only works for strings
+ if (JSON_HEDLEY_LIKELY(is_binary()))
+ {
+ std::swap(*(m_value.binary), other);
+ }
+ else
+ {
+ JSON_THROW(type_error::create(310, "cannot use swap() with " + std::string(type_name()), *this));
+ }
+ }
+
+ /// @}
+
+ public:
+ //////////////////////////////////////////
+ // lexicographical comparison operators //
+ //////////////////////////////////////////
+
+ /// @name lexicographical comparison operators
+ /// @{
+
+ /// @brief comparison: equal
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_eq/
+ friend bool operator==(const_reference lhs, const_reference rhs) noexcept
+ {
+#ifdef __GNUC__
+#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;
+#ifdef __GNUC__
+#pragma GCC diagnostic pop
+#endif
+ }
+
+ /// @brief comparison: equal
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_eq/
+ template<typename ScalarType, typename std::enable_if<
+ std::is_scalar<ScalarType>::value, int>::type = 0>
+ friend bool operator==(const_reference lhs, ScalarType rhs) noexcept
+ {
+ return lhs == basic_json(rhs);
+ }
+
+ /// @brief comparison: equal
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_eq/
+ template<typename ScalarType, typename std::enable_if<
+ std::is_scalar<ScalarType>::value, int>::type = 0>
+ friend bool operator==(ScalarType lhs, const_reference rhs) noexcept
+ {
+ return basic_json(lhs) == rhs;
+ }
+
+ /// @brief comparison: not equal
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_ne/
+ friend bool operator!=(const_reference lhs, const_reference rhs) noexcept
+ {
+ return !(lhs == rhs);
+ }
+
+ /// @brief comparison: not equal
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_ne/
+ template<typename ScalarType, typename std::enable_if<
+ std::is_scalar<ScalarType>::value, int>::type = 0>
+ friend bool operator!=(const_reference lhs, ScalarType rhs) noexcept
+ {
+ return lhs != basic_json(rhs);
+ }
+
+ /// @brief comparison: not equal
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_ne/
+ template<typename ScalarType, typename std::enable_if<
+ std::is_scalar<ScalarType>::value, int>::type = 0>
+ friend bool operator!=(ScalarType lhs, const_reference rhs) noexcept
+ {
+ return basic_json(lhs) != rhs;
+ }
+
+ /// @brief comparison: less than
+ /// @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,
+ // we compare types. Note we have to call the operator explicitly,
+ // because MSVC has problems otherwise.
+ return operator<(lhs_type, rhs_type);
+ }
+
+ /// @brief comparison: less than
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_lt/
+ template<typename ScalarType, typename std::enable_if<
+ std::is_scalar<ScalarType>::value, int>::type = 0>
+ friend bool operator<(const_reference lhs, ScalarType rhs) noexcept
+ {
+ return lhs < basic_json(rhs);
+ }
+
+ /// @brief comparison: less than
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_lt/
+ template<typename ScalarType, typename std::enable_if<
+ std::is_scalar<ScalarType>::value, int>::type = 0>
+ friend bool operator<(ScalarType lhs, const_reference rhs) noexcept
+ {
+ return basic_json(lhs) < rhs;
+ }
+
+ /// @brief comparison: less than or equal
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_le/
+ friend bool operator<=(const_reference lhs, const_reference rhs) noexcept
+ {
+ return !(rhs < lhs);
+ }
+
+ /// @brief comparison: less than or equal
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_le/
+ template<typename ScalarType, typename std::enable_if<
+ std::is_scalar<ScalarType>::value, int>::type = 0>
+ friend bool operator<=(const_reference lhs, ScalarType rhs) noexcept
+ {
+ return lhs <= basic_json(rhs);
+ }
+
+ /// @brief comparison: less than or equal
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_le/
+ template<typename ScalarType, typename std::enable_if<
+ std::is_scalar<ScalarType>::value, int>::type = 0>
+ friend bool operator<=(ScalarType lhs, const_reference rhs) noexcept
+ {
+ return basic_json(lhs) <= rhs;
+ }
+
+ /// @brief comparison: greater than
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_gt/
+ friend bool operator>(const_reference lhs, const_reference rhs) noexcept
+ {
+ return !(lhs <= rhs);
+ }
+
+ /// @brief comparison: greater than
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_gt/
+ template<typename ScalarType, typename std::enable_if<
+ std::is_scalar<ScalarType>::value, int>::type = 0>
+ friend bool operator>(const_reference lhs, ScalarType rhs) noexcept
+ {
+ return lhs > basic_json(rhs);
+ }
+
+ /// @brief comparison: greater than
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_gt/
+ template<typename ScalarType, typename std::enable_if<
+ std::is_scalar<ScalarType>::value, int>::type = 0>
+ friend bool operator>(ScalarType lhs, const_reference rhs) noexcept
+ {
+ return basic_json(lhs) > rhs;
+ }
+
+ /// @brief comparison: greater than or equal
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_ge/
+ friend bool operator>=(const_reference lhs, const_reference rhs) noexcept
+ {
+ return !(lhs < rhs);
+ }
+
+ /// @brief comparison: greater than or equal
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_ge/
+ template<typename ScalarType, typename std::enable_if<
+ std::is_scalar<ScalarType>::value, int>::type = 0>
+ friend bool operator>=(const_reference lhs, ScalarType rhs) noexcept
+ {
+ return lhs >= basic_json(rhs);
+ }
+
+ /// @brief comparison: greater than or equal
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_ge/
+ template<typename ScalarType, typename std::enable_if<
+ std::is_scalar<ScalarType>::value, int>::type = 0>
+ friend bool operator>=(ScalarType lhs, const_reference rhs) noexcept
+ {
+ return basic_json(lhs) >= rhs;
+ }
+
+ /// @}
+
+ ///////////////////
+ // serialization //
+ ///////////////////
+
+ /// @name serialization
+ /// @{
+#ifndef JSON_NO_IO
+ /// @brief serialize to stream
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_ltlt/
+ friend std::ostream& operator<<(std::ostream& o, const basic_json& j)
+ {
+ // read width member and use it as indentation parameter if nonzero
+ const bool pretty_print = o.width() > 0;
+ const auto indentation = pretty_print ? o.width() : 0;
+
+ // reset width to 0 for subsequent calls to this stream
+ o.width(0);
+
+ // do the actual serialization
+ serializer s(detail::output_adapter<char>(o), o.fill());
+ s.dump(j, pretty_print, false, static_cast<unsigned int>(indentation));
+ return o;
+ }
+
+ /// @brief serialize to stream
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_ltlt/
+ /// @deprecated This function is deprecated since 3.0.0 and will be removed in
+ /// version 4.0.0 of the library. Please use
+ /// operator<<(std::ostream&, const basic_json&) instead; that is,
+ /// replace calls like `j >> o;` with `o << j;`.
+ JSON_HEDLEY_DEPRECATED_FOR(3.0.0, operator<<(std::ostream&, const basic_json&))
+ friend std::ostream& operator>>(const basic_json& j, std::ostream& o)
+ {
+ return o << j;
+ }
+#endif // JSON_NO_IO
+ /// @}
+
+
+ /////////////////////
+ // deserialization //
+ /////////////////////
+
+ /// @name deserialization
+ /// @{
+
+ /// @brief deserialize from a compatible input
+ /// @sa https://json.nlohmann.me/api/basic_json/parse/
+ template<typename InputType>
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json parse(InputType&& i,
+ const parser_callback_t cb = nullptr,
+ const bool allow_exceptions = true,
+ const bool ignore_comments = false)
+ {
+ basic_json result;
+ parser(detail::input_adapter(std::forward<InputType>(i)), cb, allow_exceptions, ignore_comments).parse(true, result);
+ return result;
+ }
+
+ /// @brief deserialize from a pair of character iterators
+ /// @sa https://json.nlohmann.me/api/basic_json/parse/
+ template<typename IteratorType>
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json parse(IteratorType first,
+ IteratorType last,
+ const parser_callback_t cb = nullptr,
+ const bool allow_exceptions = true,
+ const bool ignore_comments = false)
+ {
+ basic_json result;
+ parser(detail::input_adapter(std::move(first), std::move(last)), cb, allow_exceptions, ignore_comments).parse(true, result);
+ return result;
+ }
+
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ JSON_HEDLEY_DEPRECATED_FOR(3.8.0, parse(ptr, ptr + len))
+ static basic_json parse(detail::span_input_adapter&& i,
+ const parser_callback_t cb = nullptr,
+ const bool allow_exceptions = true,
+ const bool ignore_comments = false)
+ {
+ basic_json result;
+ parser(i.get(), cb, allow_exceptions, ignore_comments).parse(true, result);
+ return result;
+ }
+
+ /// @brief check if the input is valid JSON
+ /// @sa https://json.nlohmann.me/api/basic_json/accept/
+ template<typename InputType>
+ static bool accept(InputType&& i,
+ const bool ignore_comments = false)
+ {
+ return parser(detail::input_adapter(std::forward<InputType>(i)), nullptr, false, ignore_comments).accept(true);
+ }
+
+ /// @brief check if the input is valid JSON
+ /// @sa https://json.nlohmann.me/api/basic_json/accept/
+ template<typename IteratorType>
+ static bool accept(IteratorType first, IteratorType last,
+ const bool ignore_comments = false)
+ {
+ return parser(detail::input_adapter(std::move(first), std::move(last)), nullptr, false, ignore_comments).accept(true);
+ }
+
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ JSON_HEDLEY_DEPRECATED_FOR(3.8.0, accept(ptr, ptr + len))
+ static bool accept(detail::span_input_adapter&& i,
+ const bool ignore_comments = false)
+ {
+ return parser(i.get(), nullptr, false, ignore_comments).accept(true);
+ }
+
+ /// @brief generate SAX events
+ /// @sa https://json.nlohmann.me/api/basic_json/sax_parse/
+ template <typename InputType, typename SAX>
+ JSON_HEDLEY_NON_NULL(2)
+ static bool sax_parse(InputType&& i, SAX* sax,
+ input_format_t format = input_format_t::json,
+ const bool strict = true,
+ const bool ignore_comments = false)
+ {
+ 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);
+ }
+
+ /// @brief generate SAX events
+ /// @sa https://json.nlohmann.me/api/basic_json/sax_parse/
+ template<class IteratorType, class SAX>
+ JSON_HEDLEY_NON_NULL(3)
+ static bool sax_parse(IteratorType first, IteratorType last, SAX* sax,
+ input_format_t format = input_format_t::json,
+ const bool strict = true,
+ const bool ignore_comments = false)
+ {
+ 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);
+ }
+
+ /// @brief generate SAX events
+ /// @sa https://json.nlohmann.me/api/basic_json/sax_parse/
+ /// @deprecated This function is deprecated since 3.8.0 and will be removed in
+ /// version 4.0.0 of the library. Please use
+ /// sax_parse(ptr, ptr + len) instead.
+ template <typename SAX>
+ JSON_HEDLEY_DEPRECATED_FOR(3.8.0, sax_parse(ptr, ptr + len, ...))
+ JSON_HEDLEY_NON_NULL(2)
+ static bool sax_parse(detail::span_input_adapter&& i, SAX* sax,
+ input_format_t format = input_format_t::json,
+ const bool strict = true,
+ const bool ignore_comments = false)
+ {
+ auto ia = i.get();
+ return format == input_format_t::json
+ // 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);
+ }
+#ifndef JSON_NO_IO
+ /// @brief deserialize from stream
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_gtgt/
+ /// @deprecated This stream operator is deprecated since 3.0.0 and will be removed in
+ /// version 4.0.0 of the library. Please use
+ /// operator>>(std::istream&, basic_json&) instead; that is,
+ /// replace calls like `j << i;` with `i >> j;`.
+ JSON_HEDLEY_DEPRECATED_FOR(3.0.0, operator>>(std::istream&, basic_json&))
+ friend std::istream& operator<<(basic_json& j, std::istream& i)
+ {
+ return operator>>(i, j);
+ }
+
+ /// @brief deserialize from stream
+ /// @sa https://json.nlohmann.me/api/basic_json/operator_gtgt/
+ friend std::istream& operator>>(std::istream& i, basic_json& j)
+ {
+ parser(detail::input_adapter(i)).parse(false, j);
+ return i;
+ }
+#endif // JSON_NO_IO
+ /// @}
+
+ ///////////////////////////
+ // convenience functions //
+ ///////////////////////////
+
+ /// @brief return the type as string
+ /// @sa https://json.nlohmann.me/api/basic_json/type_name/
+ JSON_HEDLEY_RETURNS_NON_NULL
+ const char* type_name() const noexcept
+ {
+ switch (m_type)
+ {
+ case value_t::null:
+ return "null";
+ case value_t::object:
+ return "object";
+ case value_t::array:
+ return "array";
+ case value_t::string:
+ return "string";
+ case value_t::boolean:
+ return "boolean";
+ case value_t::binary:
+ return "binary";
+ case value_t::discarded:
+ return "discarded";
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ default:
+ return "number";
+ }
+ }
+
+
+ JSON_PRIVATE_UNLESS_TESTED:
+ //////////////////////
+ // member variables //
+ //////////////////////
+
+ /// the type of the current element
+ value_t m_type = value_t::null;
+
+ /// the value of the current element
+ json_value m_value = {};
+
+#if JSON_DIAGNOSTICS
+ /// a pointer to a parent value (for debugging purposes)
+ basic_json* m_parent = nullptr;
+#endif
+
+ //////////////////////////////////////////
+ // binary serialization/deserialization //
+ //////////////////////////////////////////
+
+ /// @name binary serialization/deserialization support
+ /// @{
+
+ public:
+ /// @brief create a CBOR serialization of a given JSON value
+ /// @sa https://json.nlohmann.me/api/basic_json/to_cbor/
+ static std::vector<std::uint8_t> to_cbor(const basic_json& j)
+ {
+ std::vector<std::uint8_t> result;
+ to_cbor(j, result);
+ return result;
+ }
+
+ /// @brief create a CBOR serialization of a given JSON value
+ /// @sa https://json.nlohmann.me/api/basic_json/to_cbor/
+ static void to_cbor(const basic_json& j, detail::output_adapter<std::uint8_t> o)
+ {
+ binary_writer<std::uint8_t>(o).write_cbor(j);
+ }
+
+ /// @brief create a CBOR serialization of a given JSON value
+ /// @sa https://json.nlohmann.me/api/basic_json/to_cbor/
+ static void to_cbor(const basic_json& j, detail::output_adapter<char> o)
+ {
+ binary_writer<char>(o).write_cbor(j);
+ }
+
+ /// @brief create a MessagePack serialization of a given JSON value
+ /// @sa https://json.nlohmann.me/api/basic_json/to_msgpack/
+ static std::vector<std::uint8_t> to_msgpack(const basic_json& j)
+ {
+ std::vector<std::uint8_t> result;
+ to_msgpack(j, result);
+ return result;
+ }
+
+ /// @brief create a MessagePack serialization of a given JSON value
+ /// @sa https://json.nlohmann.me/api/basic_json/to_msgpack/
+ static void to_msgpack(const basic_json& j, detail::output_adapter<std::uint8_t> o)
+ {
+ binary_writer<std::uint8_t>(o).write_msgpack(j);
+ }
+
+ /// @brief create a MessagePack serialization of a given JSON value
+ /// @sa https://json.nlohmann.me/api/basic_json/to_msgpack/
+ static void to_msgpack(const basic_json& j, detail::output_adapter<char> o)
+ {
+ binary_writer<char>(o).write_msgpack(j);
+ }
+
+ /// @brief create a UBJSON serialization of a given JSON value
+ /// @sa https://json.nlohmann.me/api/basic_json/to_ubjson/
+ static std::vector<std::uint8_t> to_ubjson(const basic_json& j,
+ const bool use_size = false,
+ const bool use_type = false)
+ {
+ std::vector<std::uint8_t> result;
+ to_ubjson(j, result, use_size, use_type);
+ return result;
+ }
+
+ /// @brief create a UBJSON serialization of a given JSON value
+ /// @sa https://json.nlohmann.me/api/basic_json/to_ubjson/
+ static void to_ubjson(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);
+ }
+
+ /// @brief create a UBJSON serialization of a given JSON value
+ /// @sa https://json.nlohmann.me/api/basic_json/to_ubjson/
+ static void to_ubjson(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);
+ }
+
+ /// @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)
+ {
+ std::vector<std::uint8_t> result;
+ to_bson(j, result);
+ return result;
+ }
+
+ /// @brief create a BSON serialization of a given JSON value
+ /// @sa https://json.nlohmann.me/api/basic_json/to_bson/
+ static void to_bson(const basic_json& j, detail::output_adapter<std::uint8_t> o)
+ {
+ binary_writer<std::uint8_t>(o).write_bson(j);
+ }
+
+ /// @brief create a BSON serialization of a given JSON value
+ /// @sa https://json.nlohmann.me/api/basic_json/to_bson/
+ static void to_bson(const basic_json& j, detail::output_adapter<char> o)
+ {
+ binary_writer<char>(o).write_bson(j);
+ }
+
+ /// @brief create a JSON value from an input in CBOR format
+ /// @sa https://json.nlohmann.me/api/basic_json/from_cbor/
+ template<typename InputType>
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json from_cbor(InputType&& i,
+ const bool strict = true,
+ const bool allow_exceptions = true,
+ const cbor_tag_handler_t tag_handler = cbor_tag_handler_t::error)
+ {
+ 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);
+ return res ? result : basic_json(value_t::discarded);
+ }
+
+ /// @brief create a JSON value from an input in CBOR format
+ /// @sa https://json.nlohmann.me/api/basic_json/from_cbor/
+ template<typename IteratorType>
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json from_cbor(IteratorType first, IteratorType last,
+ const bool strict = true,
+ const bool allow_exceptions = true,
+ const cbor_tag_handler_t tag_handler = cbor_tag_handler_t::error)
+ {
+ 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);
+ return res ? result : basic_json(value_t::discarded);
+ }
+
+ template<typename T>
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ JSON_HEDLEY_DEPRECATED_FOR(3.8.0, from_cbor(ptr, ptr + len))
+ static basic_json from_cbor(const T* ptr, std::size_t len,
+ const bool strict = true,
+ const bool allow_exceptions = true,
+ const cbor_tag_handler_t tag_handler = cbor_tag_handler_t::error)
+ {
+ return from_cbor(ptr, ptr + len, strict, allow_exceptions, tag_handler);
+ }
+
+
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ JSON_HEDLEY_DEPRECATED_FOR(3.8.0, from_cbor(ptr, ptr + len))
+ static basic_json from_cbor(detail::span_input_adapter&& i,
+ const bool strict = true,
+ const bool allow_exceptions = true,
+ const cbor_tag_handler_t tag_handler = cbor_tag_handler_t::error)
+ {
+ 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)).sax_parse(input_format_t::cbor, &sdp, strict, tag_handler);
+ return res ? result : basic_json(value_t::discarded);
+ }
+
+ /// @brief create a JSON value from an input in MessagePack format
+ /// @sa https://json.nlohmann.me/api/basic_json/from_msgpack/
+ template<typename InputType>
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json from_msgpack(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)).sax_parse(input_format_t::msgpack, &sdp, strict);
+ return res ? result : basic_json(value_t::discarded);
+ }
+
+ /// @brief create a JSON value from an input in MessagePack format
+ /// @sa https://json.nlohmann.me/api/basic_json/from_msgpack/
+ template<typename IteratorType>
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json from_msgpack(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)).sax_parse(input_format_t::msgpack, &sdp, strict);
+ return res ? result : basic_json(value_t::discarded);
+ }
+
+ template<typename T>
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ JSON_HEDLEY_DEPRECATED_FOR(3.8.0, from_msgpack(ptr, ptr + len))
+ static basic_json from_msgpack(const T* ptr, std::size_t len,
+ const bool strict = true,
+ const bool allow_exceptions = true)
+ {
+ return from_msgpack(ptr, ptr + len, strict, allow_exceptions);
+ }
+
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ JSON_HEDLEY_DEPRECATED_FOR(3.8.0, from_msgpack(ptr, ptr + len))
+ static basic_json from_msgpack(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)).sax_parse(input_format_t::msgpack, &sdp, strict);
+ return res ? result : basic_json(value_t::discarded);
+ }
+
+ /// @brief create a JSON value from an input in UBJSON format
+ /// @sa https://json.nlohmann.me/api/basic_json/from_ubjson/
+ template<typename InputType>
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json from_ubjson(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)).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 UBJSON format
+ /// @sa https://json.nlohmann.me/api/basic_json/from_ubjson/
+ template<typename IteratorType>
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json from_ubjson(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)).sax_parse(input_format_t::ubjson, &sdp, strict);
+ return res ? result : basic_json(value_t::discarded);
+ }
+
+ template<typename T>
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ JSON_HEDLEY_DEPRECATED_FOR(3.8.0, from_ubjson(ptr, ptr + len))
+ static basic_json from_ubjson(const T* ptr, std::size_t len,
+ const bool strict = true,
+ const bool allow_exceptions = true)
+ {
+ return from_ubjson(ptr, ptr + len, strict, allow_exceptions);
+ }
+
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ JSON_HEDLEY_DEPRECATED_FOR(3.8.0, from_ubjson(ptr, ptr + len))
+ static basic_json from_ubjson(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)).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 BSON format
+ /// @sa https://json.nlohmann.me/api/basic_json/from_bson/
+ template<typename InputType>
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json from_bson(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)).sax_parse(input_format_t::bson, &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 IteratorType>
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json from_bson(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)).sax_parse(input_format_t::bson, &sdp, strict);
+ return res ? result : basic_json(value_t::discarded);
+ }
+
+ template<typename T>
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ JSON_HEDLEY_DEPRECATED_FOR(3.8.0, from_bson(ptr, ptr + len))
+ static basic_json from_bson(const T* ptr, std::size_t len,
+ const bool strict = true,
+ const bool allow_exceptions = true)
+ {
+ return from_bson(ptr, ptr + len, strict, allow_exceptions);
+ }
+
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ JSON_HEDLEY_DEPRECATED_FOR(3.8.0, from_bson(ptr, ptr + len))
+ static basic_json from_bson(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)).sax_parse(input_format_t::bson, &sdp, strict);
+ return res ? result : basic_json(value_t::discarded);
+ }
+ /// @}
+
+ //////////////////////////
+ // JSON Pointer support //
+ //////////////////////////
+
+ /// @name JSON Pointer functions
+ /// @{
+
+ /// @brief access specified element via JSON Pointer
+ /// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
+ reference operator[](const json_pointer& ptr)
+ {
+ return ptr.get_unchecked(this);
+ }
+
+ /// @brief access specified element via JSON Pointer
+ /// @sa https://json.nlohmann.me/api/basic_json/operator%5B%5D/
+ const_reference operator[](const json_pointer& ptr) const
+ {
+ return ptr.get_unchecked(this);
+ }
+
+ /// @brief access specified element via JSON Pointer
+ /// @sa https://json.nlohmann.me/api/basic_json/at/
+ reference at(const json_pointer& ptr)
+ {
+ return ptr.get_checked(this);
+ }
+
+ /// @brief access specified element via JSON Pointer
+ /// @sa https://json.nlohmann.me/api/basic_json/at/
+ const_reference at(const json_pointer& ptr) const
+ {
+ return ptr.get_checked(this);
+ }
+
+ /// @brief return flattened JSON value
+ /// @sa https://json.nlohmann.me/api/basic_json/flatten/
+ basic_json flatten() const
+ {
+ basic_json result(value_t::object);
+ json_pointer::flatten("", *this, result);
+ return result;
+ }
+
+ /// @brief unflatten a previously flattened JSON value
+ /// @sa https://json.nlohmann.me/api/basic_json/unflatten/
+ basic_json unflatten() const
+ {
+ return json_pointer::unflatten(*this);
+ }
+
+ /// @}
+
+ //////////////////////////
+ // JSON Patch functions //
+ //////////////////////////
+
+ /// @name JSON Patch functions
+ /// @{
+
+ /// @brief applies a JSON patch
+ /// @sa https://json.nlohmann.me/api/basic_json/patch/
+ basic_json patch(const basic_json& json_patch) const
+ {
+ // make a working copy to apply the patch to
+ basic_json result = *this;
+
+ // the valid JSON Patch operations
+ enum class patch_operations {add, remove, replace, move, copy, test, invalid};
+
+ const auto get_op = [](const std::string & op)
+ {
+ if (op == "add")
+ {
+ return patch_operations::add;
+ }
+ if (op == "remove")
+ {
+ return patch_operations::remove;
+ }
+ if (op == "replace")
+ {
+ return patch_operations::replace;
+ }
+ if (op == "move")
+ {
+ return patch_operations::move;
+ }
+ if (op == "copy")
+ {
+ return patch_operations::copy;
+ }
+ if (op == "test")
+ {
+ return patch_operations::test;
+ }
+
+ return patch_operations::invalid;
+ };
+
+ // wrapper for "add" operation; add value at ptr
+ const auto operation_add = [&result](json_pointer & ptr, basic_json val)
+ {
+ // adding to the root of the target document means replacing it
+ if (ptr.empty())
+ {
+ result = val;
+ return;
+ }
+
+ // make sure the top element of the pointer exists
+ json_pointer top_pointer = ptr.top();
+ if (top_pointer != ptr)
+ {
+ result.at(top_pointer);
+ }
+
+ // get reference to parent of JSON pointer ptr
+ const auto last_path = ptr.back();
+ ptr.pop_back();
+ basic_json& parent = result[ptr];
+
+ switch (parent.m_type)
+ {
+ case value_t::null:
+ case value_t::object:
+ {
+ // use operator[] to add value
+ parent[last_path] = val;
+ break;
+ }
+
+ case value_t::array:
+ {
+ if (last_path == "-")
+ {
+ // special case: append to back
+ parent.push_back(val);
+ }
+ else
+ {
+ const auto idx = json_pointer::array_index(last_path);
+ if (JSON_HEDLEY_UNLIKELY(idx > parent.size()))
+ {
+ // avoid undefined behavior
+ JSON_THROW(out_of_range::create(401, "array index " + std::to_string(idx) + " is out of range", parent));
+ }
+
+ // default case: insert add offset
+ parent.insert(parent.begin() + static_cast<difference_type>(idx), val);
+ }
+ break;
+ }
+
+ // if there exists a parent it cannot be primitive
+ case value_t::string: // LCOV_EXCL_LINE
+ case value_t::boolean: // LCOV_EXCL_LINE
+ case value_t::number_integer: // LCOV_EXCL_LINE
+ case value_t::number_unsigned: // LCOV_EXCL_LINE
+ case value_t::number_float: // LCOV_EXCL_LINE
+ case value_t::binary: // LCOV_EXCL_LINE
+ case value_t::discarded: // LCOV_EXCL_LINE
+ default: // LCOV_EXCL_LINE
+ JSON_ASSERT(false); // NOLINT(cert-dcl03-c,hicpp-static-assert,misc-static-assert) LCOV_EXCL_LINE
+ }
+ };
+
+ // wrapper for "remove" operation; remove value at ptr
+ const auto operation_remove = [this, &result](json_pointer & ptr)
+ {
+ // get reference to parent of JSON pointer ptr
+ const auto last_path = ptr.back();
+ ptr.pop_back();
+ basic_json& parent = result.at(ptr);
+
+ // remove child
+ if (parent.is_object())
+ {
+ // perform range check
+ auto it = parent.find(last_path);
+ if (JSON_HEDLEY_LIKELY(it != parent.end()))
+ {
+ parent.erase(it);
+ }
+ else
+ {
+ JSON_THROW(out_of_range::create(403, "key '" + last_path + "' not found", *this));
+ }
+ }
+ else if (parent.is_array())
+ {
+ // note erase performs range check
+ parent.erase(json_pointer::array_index(last_path));
+ }
+ };
+
+ // type check: top level value must be an array
+ if (JSON_HEDLEY_UNLIKELY(!json_patch.is_array()))
+ {
+ JSON_THROW(parse_error::create(104, 0, "JSON patch must be an array of objects", json_patch));
+ }
+
+ // iterate and apply the operations
+ for (const auto& val : json_patch)
+ {
+ // wrapper to get a value for an operation
+ const auto get_value = [&val](const std::string & op,
+ const std::string & member,
+ bool string_type) -> basic_json &
+ {
+ // find value
+ auto it = val.m_value.object->find(member);
+
+ // context-sensitive error message
+ const auto error_msg = (op == "op") ? "operation" : "operation '" + op + "'";
+
+ // check if desired value is present
+ if (JSON_HEDLEY_UNLIKELY(it == val.m_value.object->end()))
+ {
+ // NOLINTNEXTLINE(performance-inefficient-string-concatenation)
+ JSON_THROW(parse_error::create(105, 0, error_msg + " must have member '" + member + "'", val));
+ }
+
+ // check if result is of type string
+ if (JSON_HEDLEY_UNLIKELY(string_type && !it->second.is_string()))
+ {
+ // NOLINTNEXTLINE(performance-inefficient-string-concatenation)
+ JSON_THROW(parse_error::create(105, 0, error_msg + " must have string member '" + member + "'", val));
+ }
+
+ // no error: return value
+ return it->second;
+ };
+
+ // type check: every element of the array must be an object
+ if (JSON_HEDLEY_UNLIKELY(!val.is_object()))
+ {
+ JSON_THROW(parse_error::create(104, 0, "JSON patch must be an array of objects", val));
+ }
+
+ // collect mandatory members
+ const auto op = get_value("op", "op", true).template get<std::string>();
+ const auto path = get_value(op, "path", true).template get<std::string>();
+ json_pointer ptr(path);
+
+ switch (get_op(op))
+ {
+ case patch_operations::add:
+ {
+ operation_add(ptr, get_value("add", "value", false));
+ break;
+ }
+
+ case patch_operations::remove:
+ {
+ operation_remove(ptr);
+ break;
+ }
+
+ case patch_operations::replace:
+ {
+ // the "path" location must exist - use at()
+ result.at(ptr) = get_value("replace", "value", false);
+ break;
+ }
+
+ case patch_operations::move:
+ {
+ const auto from_path = get_value("move", "from", true).template get<std::string>();
+ json_pointer from_ptr(from_path);
+
+ // the "from" location must exist - use at()
+ basic_json v = result.at(from_ptr);
+
+ // The move operation is functionally identical to a
+ // "remove" operation on the "from" location, followed
+ // immediately by an "add" operation at the target
+ // location with the value that was just removed.
+ operation_remove(from_ptr);
+ operation_add(ptr, v);
+ break;
+ }
+
+ case patch_operations::copy:
+ {
+ const auto from_path = get_value("copy", "from", true).template get<std::string>();
+ const json_pointer from_ptr(from_path);
+
+ // the "from" location must exist - use at()
+ basic_json v = result.at(from_ptr);
+
+ // The copy is functionally identical to an "add"
+ // operation at the target location using the value
+ // specified in the "from" member.
+ operation_add(ptr, v);
+ break;
+ }
+
+ case patch_operations::test:
+ {
+ bool success = false;
+ JSON_TRY
+ {
+ // check if "value" matches the one at "path"
+ // the "path" location must exist - use at()
+ success = (result.at(ptr) == get_value("test", "value", false));
+ }
+ JSON_INTERNAL_CATCH (out_of_range&)
+ {
+ // ignore out of range errors: success remains false
+ }
+
+ // throw an exception if test fails
+ if (JSON_HEDLEY_UNLIKELY(!success))
+ {
+ JSON_THROW(other_error::create(501, "unsuccessful: " + val.dump(), val));
+ }
+
+ break;
+ }
+
+ case patch_operations::invalid:
+ default:
+ {
+ // op must be "add", "remove", "replace", "move", "copy", or
+ // "test"
+ JSON_THROW(parse_error::create(105, 0, "operation value '" + op + "' is invalid", val));
+ }
+ }
+ }
+
+ return result;
+ }
+
+ /// @brief creates a diff as a JSON patch
+ /// @sa https://json.nlohmann.me/api/basic_json/diff/
+ JSON_HEDLEY_WARN_UNUSED_RESULT
+ static basic_json diff(const basic_json& source, const basic_json& target,
+ const std::string& path = "")
+ {
+ // the patch
+ basic_json result(value_t::array);
+
+ // if the values are the same, return empty patch
+ if (source == target)
+ {
+ return result;
+ }
+
+ if (source.type() != target.type())
+ {
+ // different types: replace value
+ result.push_back(
+ {
+ {"op", "replace"}, {"path", path}, {"value", target}
+ });
+ return result;
+ }
+
+ switch (source.type())
+ {
+ case value_t::array:
+ {
+ // first pass: traverse common elements
+ std::size_t i = 0;
+ while (i < source.size() && i < target.size())
+ {
+ // recursive call to compare array values at index i
+ auto temp_diff = diff(source[i], target[i], path + "/" + std::to_string(i));
+ result.insert(result.end(), temp_diff.begin(), temp_diff.end());
+ ++i;
+ }
+
+ // We now reached the end of at least one array
+ // in a second pass, traverse the remaining elements
+
+ // remove my remaining elements
+ const auto end_index = static_cast<difference_type>(result.size());
+ while (i < source.size())
+ {
+ // add operations in reverse order to avoid invalid
+ // indices
+ result.insert(result.begin() + end_index, object(
+ {
+ {"op", "remove"},
+ {"path", path + "/" + std::to_string(i)}
+ }));
+ ++i;
+ }
+
+ // add other remaining elements
+ while (i < target.size())
+ {
+ result.push_back(
+ {
+ {"op", "add"},
+ {"path", path + "/-"},
+ {"value", target[i]}
+ });
+ ++i;
+ }
+
+ break;
+ }
+
+ case value_t::object:
+ {
+ // first pass: traverse this object's elements
+ for (auto it = source.cbegin(); it != source.cend(); ++it)
+ {
+ // escape the key name to be used in a JSON patch
+ const auto path_key = path + "/" + detail::escape(it.key());
+
+ if (target.find(it.key()) != target.end())
+ {
+ // recursive call to compare object values at key it
+ auto temp_diff = diff(it.value(), target[it.key()], path_key);
+ result.insert(result.end(), temp_diff.begin(), temp_diff.end());
+ }
+ else
+ {
+ // found a key that is not in o -> remove it
+ result.push_back(object(
+ {
+ {"op", "remove"}, {"path", path_key}
+ }));
+ }
+ }
+
+ // second pass: traverse other object's elements
+ for (auto it = target.cbegin(); it != target.cend(); ++it)
+ {
+ if (source.find(it.key()) == source.end())
+ {
+ // found a key that is not in this -> add it
+ const auto path_key = path + "/" + detail::escape(it.key());
+ result.push_back(
+ {
+ {"op", "add"}, {"path", path_key},
+ {"value", it.value()}
+ });
+ }
+ }
+
+ break;
+ }
+
+ case value_t::null:
+ case value_t::string:
+ case value_t::boolean:
+ case value_t::number_integer:
+ case value_t::number_unsigned:
+ case value_t::number_float:
+ case value_t::binary:
+ case value_t::discarded:
+ default:
+ {
+ // both primitive type: replace value
+ result.push_back(
+ {
+ {"op", "replace"}, {"path", path}, {"value", target}
+ });
+ break;
+ }
+ }
+
+ return result;
+ }
+
+ /// @}
+
+ ////////////////////////////////
+ // JSON Merge Patch functions //
+ ////////////////////////////////
+
+ /// @name JSON Merge Patch functions
+ /// @{
+
+ /// @brief applies a JSON Merge Patch
+ /// @sa https://json.nlohmann.me/api/basic_json/merge_patch/
+ void merge_patch(const basic_json& apply_patch)
+ {
+ if (apply_patch.is_object())
+ {
+ if (!is_object())
+ {
+ *this = object();
+ }
+ for (auto it = apply_patch.begin(); it != apply_patch.end(); ++it)
+ {
+ if (it.value().is_null())
+ {
+ erase(it.key());
+ }
+ else
+ {
+ operator[](it.key()).merge_patch(it.value());
+ }
+ }
+ }
+ else
+ {
+ *this = apply_patch;
+ }
+ }
+
+ /// @}
+};
+
+/// @brief user-defined to_string function for JSON values
+/// @sa https://json.nlohmann.me/api/basic_json/to_string/
+NLOHMANN_BASIC_JSON_TPL_DECLARATION
+std::string to_string(const NLOHMANN_BASIC_JSON_TPL& j)
+{
+ return j.dump();
+}
+
+} // namespace nlohmann
+
+///////////////////////
+// nonmember support //
+///////////////////////
+
+namespace std // NOLINT(cert-dcl58-cpp)
+{
+
+/// @brief hash value for JSON objects
+/// @sa https://json.nlohmann.me/api/basic_json/std_hash/
+NLOHMANN_BASIC_JSON_TPL_DECLARATION
+struct hash<nlohmann::NLOHMANN_BASIC_JSON_TPL>
+{
+ std::size_t operator()(const nlohmann::NLOHMANN_BASIC_JSON_TPL& j) const
+ {
+ return nlohmann::detail::hash(j);
+ }
+};
+
+// specialization for std::less<value_t>
+template<>
+struct less< ::nlohmann::detail::value_t> // do not remove the space after '<', see https://github.com/nlohmann/json/pull/679
+{
+ /*!
+ @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
+ {
+ return nlohmann::detail::operator<(lhs, rhs);
+ }
+};
+
+// C++20 prohibit function specialization in the std namespace.
+#ifndef JSON_HAS_CPP_20
+
+/// @brief exchanges the values of two JSON objects
+/// @sa https://json.nlohmann.me/api/basic_json/std_swap/
+NLOHMANN_BASIC_JSON_TPL_DECLARATION
+inline void swap(nlohmann::NLOHMANN_BASIC_JSON_TPL& j1, nlohmann::NLOHMANN_BASIC_JSON_TPL& j2) noexcept( // NOLINT(readability-inconsistent-declaration-parameter-name)
+ is_nothrow_move_constructible<nlohmann::NLOHMANN_BASIC_JSON_TPL>::value&& // NOLINT(misc-redundant-expression)
+ is_nothrow_move_assignable<nlohmann::NLOHMANN_BASIC_JSON_TPL>::value)
+{
+ j1.swap(j2);
+}
+
+#endif
+
+} // namespace std
+
+/// @brief user-defined string literal for JSON values
+/// @sa https://json.nlohmann.me/api/basic_json/operator_literal_json/
+JSON_HEDLEY_NON_NULL(1)
+inline nlohmann::json operator "" _json(const char* s, std::size_t n)
+{
+ return nlohmann::json::parse(s, s + n);
+}
+
+/// @brief user-defined string literal for JSON pointer
+/// @sa https://json.nlohmann.me/api/basic_json/operator_literal_json_pointer/
+JSON_HEDLEY_NON_NULL(1)
+inline nlohmann::json::json_pointer operator "" _json_pointer(const char* s, std::size_t n)
+{
+ return nlohmann::json::json_pointer(std::string(s, n));
+}
+
+// #include <nlohmann/detail/macro_unscope.hpp>
+
+
+// restore clang diagnostic settings
+#if defined(__clang__)
+ #pragma clang diagnostic pop
+#endif
+
+// clean up
+#undef JSON_ASSERT
+#undef JSON_INTERNAL_CATCH
+#undef JSON_CATCH
+#undef JSON_THROW
+#undef JSON_TRY
+#undef JSON_PRIVATE_UNLESS_TESTED
+#undef JSON_HAS_CPP_11
+#undef JSON_HAS_CPP_14
+#undef JSON_HAS_CPP_17
+#undef JSON_HAS_CPP_20
+#undef JSON_HAS_FILESYSTEM
+#undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
+#undef NLOHMANN_BASIC_JSON_TPL_DECLARATION
+#undef NLOHMANN_BASIC_JSON_TPL
+#undef JSON_EXPLICIT
+#undef NLOHMANN_CAN_CALL_STD_FUNC_IMPL
+
+// #include <nlohmann/thirdparty/hedley/hedley_undef.hpp>
+
+
+#undef JSON_HEDLEY_ALWAYS_INLINE
+#undef JSON_HEDLEY_ARM_VERSION
+#undef JSON_HEDLEY_ARM_VERSION_CHECK
+#undef JSON_HEDLEY_ARRAY_PARAM
+#undef JSON_HEDLEY_ASSUME
+#undef JSON_HEDLEY_BEGIN_C_DECLS
+#undef JSON_HEDLEY_CLANG_HAS_ATTRIBUTE
+#undef JSON_HEDLEY_CLANG_HAS_BUILTIN
+#undef JSON_HEDLEY_CLANG_HAS_CPP_ATTRIBUTE
+#undef JSON_HEDLEY_CLANG_HAS_DECLSPEC_DECLSPEC_ATTRIBUTE
+#undef JSON_HEDLEY_CLANG_HAS_EXTENSION
+#undef JSON_HEDLEY_CLANG_HAS_FEATURE
+#undef JSON_HEDLEY_CLANG_HAS_WARNING
+#undef JSON_HEDLEY_COMPCERT_VERSION
+#undef JSON_HEDLEY_COMPCERT_VERSION_CHECK
+#undef JSON_HEDLEY_CONCAT
+#undef JSON_HEDLEY_CONCAT3
+#undef JSON_HEDLEY_CONCAT3_EX
+#undef JSON_HEDLEY_CONCAT_EX
+#undef JSON_HEDLEY_CONST
+#undef JSON_HEDLEY_CONSTEXPR
+#undef JSON_HEDLEY_CONST_CAST
+#undef JSON_HEDLEY_CPP_CAST
+#undef JSON_HEDLEY_CRAY_VERSION
+#undef JSON_HEDLEY_CRAY_VERSION_CHECK
+#undef JSON_HEDLEY_C_DECL
+#undef JSON_HEDLEY_DEPRECATED
+#undef JSON_HEDLEY_DEPRECATED_FOR
+#undef JSON_HEDLEY_DIAGNOSTIC_DISABLE_CAST_QUAL
+#undef JSON_HEDLEY_DIAGNOSTIC_DISABLE_CPP98_COMPAT_WRAP_
+#undef JSON_HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED
+#undef JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_CPP_ATTRIBUTES
+#undef JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNKNOWN_PRAGMAS
+#undef JSON_HEDLEY_DIAGNOSTIC_DISABLE_UNUSED_FUNCTION
+#undef JSON_HEDLEY_DIAGNOSTIC_POP
+#undef JSON_HEDLEY_DIAGNOSTIC_PUSH
+#undef JSON_HEDLEY_DMC_VERSION
+#undef JSON_HEDLEY_DMC_VERSION_CHECK
+#undef JSON_HEDLEY_EMPTY_BASES
+#undef JSON_HEDLEY_EMSCRIPTEN_VERSION
+#undef JSON_HEDLEY_EMSCRIPTEN_VERSION_CHECK
+#undef JSON_HEDLEY_END_C_DECLS
+#undef JSON_HEDLEY_FLAGS
+#undef JSON_HEDLEY_FLAGS_CAST
+#undef JSON_HEDLEY_GCC_HAS_ATTRIBUTE
+#undef JSON_HEDLEY_GCC_HAS_BUILTIN
+#undef JSON_HEDLEY_GCC_HAS_CPP_ATTRIBUTE
+#undef JSON_HEDLEY_GCC_HAS_DECLSPEC_ATTRIBUTE
+#undef JSON_HEDLEY_GCC_HAS_EXTENSION
+#undef JSON_HEDLEY_GCC_HAS_FEATURE
+#undef JSON_HEDLEY_GCC_HAS_WARNING
+#undef JSON_HEDLEY_GCC_NOT_CLANG_VERSION_CHECK
+#undef JSON_HEDLEY_GCC_VERSION
+#undef JSON_HEDLEY_GCC_VERSION_CHECK
+#undef JSON_HEDLEY_GNUC_HAS_ATTRIBUTE
+#undef JSON_HEDLEY_GNUC_HAS_BUILTIN
+#undef JSON_HEDLEY_GNUC_HAS_CPP_ATTRIBUTE
+#undef JSON_HEDLEY_GNUC_HAS_DECLSPEC_ATTRIBUTE
+#undef JSON_HEDLEY_GNUC_HAS_EXTENSION
+#undef JSON_HEDLEY_GNUC_HAS_FEATURE
+#undef JSON_HEDLEY_GNUC_HAS_WARNING
+#undef JSON_HEDLEY_GNUC_VERSION
+#undef JSON_HEDLEY_GNUC_VERSION_CHECK
+#undef JSON_HEDLEY_HAS_ATTRIBUTE
+#undef JSON_HEDLEY_HAS_BUILTIN
+#undef JSON_HEDLEY_HAS_CPP_ATTRIBUTE
+#undef JSON_HEDLEY_HAS_CPP_ATTRIBUTE_NS
+#undef JSON_HEDLEY_HAS_DECLSPEC_ATTRIBUTE
+#undef JSON_HEDLEY_HAS_EXTENSION
+#undef JSON_HEDLEY_HAS_FEATURE
+#undef JSON_HEDLEY_HAS_WARNING
+#undef JSON_HEDLEY_IAR_VERSION
+#undef JSON_HEDLEY_IAR_VERSION_CHECK
+#undef JSON_HEDLEY_IBM_VERSION
+#undef JSON_HEDLEY_IBM_VERSION_CHECK
+#undef JSON_HEDLEY_IMPORT
+#undef JSON_HEDLEY_INLINE
+#undef JSON_HEDLEY_INTEL_CL_VERSION
+#undef JSON_HEDLEY_INTEL_CL_VERSION_CHECK
+#undef JSON_HEDLEY_INTEL_VERSION
+#undef JSON_HEDLEY_INTEL_VERSION_CHECK
+#undef JSON_HEDLEY_IS_CONSTANT
+#undef JSON_HEDLEY_IS_CONSTEXPR_
+#undef JSON_HEDLEY_LIKELY
+#undef JSON_HEDLEY_MALLOC
+#undef JSON_HEDLEY_MCST_LCC_VERSION
+#undef JSON_HEDLEY_MCST_LCC_VERSION_CHECK
+#undef JSON_HEDLEY_MESSAGE
+#undef JSON_HEDLEY_MSVC_VERSION
+#undef JSON_HEDLEY_MSVC_VERSION_CHECK
+#undef JSON_HEDLEY_NEVER_INLINE
+#undef JSON_HEDLEY_NON_NULL
+#undef JSON_HEDLEY_NO_ESCAPE
+#undef JSON_HEDLEY_NO_RETURN
+#undef JSON_HEDLEY_NO_THROW
+#undef JSON_HEDLEY_NULL
+#undef JSON_HEDLEY_PELLES_VERSION
+#undef JSON_HEDLEY_PELLES_VERSION_CHECK
+#undef JSON_HEDLEY_PGI_VERSION
+#undef JSON_HEDLEY_PGI_VERSION_CHECK
+#undef JSON_HEDLEY_PREDICT
+#undef JSON_HEDLEY_PRINTF_FORMAT
+#undef JSON_HEDLEY_PRIVATE
+#undef JSON_HEDLEY_PUBLIC
+#undef JSON_HEDLEY_PURE
+#undef JSON_HEDLEY_REINTERPRET_CAST
+#undef JSON_HEDLEY_REQUIRE
+#undef JSON_HEDLEY_REQUIRE_CONSTEXPR
+#undef JSON_HEDLEY_REQUIRE_MSG
+#undef JSON_HEDLEY_RESTRICT
+#undef JSON_HEDLEY_RETURNS_NON_NULL
+#undef JSON_HEDLEY_SENTINEL
+#undef JSON_HEDLEY_STATIC_ASSERT
+#undef JSON_HEDLEY_STATIC_CAST
+#undef JSON_HEDLEY_STRINGIFY
+#undef JSON_HEDLEY_STRINGIFY_EX
+#undef JSON_HEDLEY_SUNPRO_VERSION
+#undef JSON_HEDLEY_SUNPRO_VERSION_CHECK
+#undef JSON_HEDLEY_TINYC_VERSION
+#undef JSON_HEDLEY_TINYC_VERSION_CHECK
+#undef JSON_HEDLEY_TI_ARMCL_VERSION
+#undef JSON_HEDLEY_TI_ARMCL_VERSION_CHECK
+#undef JSON_HEDLEY_TI_CL2000_VERSION
+#undef JSON_HEDLEY_TI_CL2000_VERSION_CHECK
+#undef JSON_HEDLEY_TI_CL430_VERSION
+#undef JSON_HEDLEY_TI_CL430_VERSION_CHECK
+#undef JSON_HEDLEY_TI_CL6X_VERSION
+#undef JSON_HEDLEY_TI_CL6X_VERSION_CHECK
+#undef JSON_HEDLEY_TI_CL7X_VERSION
+#undef JSON_HEDLEY_TI_CL7X_VERSION_CHECK
+#undef JSON_HEDLEY_TI_CLPRU_VERSION
+#undef JSON_HEDLEY_TI_CLPRU_VERSION_CHECK
+#undef JSON_HEDLEY_TI_VERSION
+#undef JSON_HEDLEY_TI_VERSION_CHECK
+#undef JSON_HEDLEY_UNAVAILABLE
+#undef JSON_HEDLEY_UNLIKELY
+#undef JSON_HEDLEY_UNPREDICTABLE
+#undef JSON_HEDLEY_UNREACHABLE
+#undef JSON_HEDLEY_UNREACHABLE_RETURN
+#undef JSON_HEDLEY_VERSION
+#undef JSON_HEDLEY_VERSION_DECODE_MAJOR
+#undef JSON_HEDLEY_VERSION_DECODE_MINOR
+#undef JSON_HEDLEY_VERSION_DECODE_REVISION
+#undef JSON_HEDLEY_VERSION_ENCODE
+#undef JSON_HEDLEY_WARNING
+#undef JSON_HEDLEY_WARN_UNUSED_RESULT
+#undef JSON_HEDLEY_WARN_UNUSED_RESULT_MSG
+#undef JSON_HEDLEY_FALL_THROUGH
+
+
+
+#endif // INCLUDE_NLOHMANN_JSON_HPP_
diff --git a/tests/abi/inline_ns/CMakeLists.txt b/tests/abi/inline_ns/CMakeLists.txt
new file mode 100644
index 0000000..c1a0817
--- /dev/null
+++ b/tests/abi/inline_ns/CMakeLists.txt
@@ -0,0 +1,12 @@
+# test linking an old library version without an inline namespace
+# with the current library using an inline namespace into the same executable
+
+# build test executable and add test
+add_executable(abi_compat_inline_ns
+ use_v3_10_5.cpp
+ use_current.cpp)
+target_link_libraries(abi_compat_inline_ns PRIVATE abi_compat_main)
+
+add_test(
+ NAME test-abi_compat_inline_ns
+ COMMAND abi_compat_inline_ns ${DOCTEST_TEST_FILTER})
diff --git a/tests/abi/inline_ns/use_current.cpp b/tests/abi/inline_ns/use_current.cpp
new file mode 100644
index 0000000..e93dad6
--- /dev/null
+++ b/tests/abi/inline_ns/use_current.cpp
@@ -0,0 +1,36 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#include <nlohmann/json.hpp>
+
+TEST_CASE("use current library with inline namespace")
+{
+ SECTION("implicitly")
+ {
+ using nlohmann::json;
+ using nlohmann::ordered_json;
+
+ json j;
+ // In v3.10.5 mixing json_pointers of different basic_json types
+ // results in implicit string conversion
+ j[ordered_json::json_pointer("/root")] = json::object();
+ CHECK(j.dump() == "{\"root\":{}}");
+ }
+
+ SECTION("explicitly")
+ {
+ using NLOHMANN_JSON_NAMESPACE::json;
+ using NLOHMANN_JSON_NAMESPACE::ordered_json;
+
+ json j;
+ j[ordered_json::json_pointer("/root")] = json::object();
+ CHECK(j.dump() == "{\"root\":{}}");
+ }
+}
diff --git a/tests/abi/inline_ns/use_v3_10_5.cpp b/tests/abi/inline_ns/use_v3_10_5.cpp
new file mode 100644
index 0000000..e946935
--- /dev/null
+++ b/tests/abi/inline_ns/use_v3_10_5.cpp
@@ -0,0 +1,22 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#include <nlohmann/json_v3_10_5.hpp>
+using nlohmann::json;
+using nlohmann::ordered_json;
+
+TEST_CASE("use library v3.10.5 without inline namespace")
+{
+ json j;
+ j[ordered_json::json_pointer("/root")] = json::object();
+ // In v3.10.5 mixing json_pointers of different basic_json types
+ // results in implicit string conversion
+ CHECK(j.dump() == "{\"/root\":{}}");
+}
diff --git a/tests/abi/main.cpp b/tests/abi/main.cpp
new file mode 100644
index 0000000..008993a
--- /dev/null
+++ b/tests/abi/main.cpp
@@ -0,0 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// Copyright (c) 2013-2022 Niels Lohmann <http://nlohmann.me>.
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#define DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
+#include "doctest_compatibility.h"
diff --git a/benchmarks/CMakeLists.txt b/tests/benchmarks/CMakeLists.txt
similarity index 85%
rename from benchmarks/CMakeLists.txt
rename to tests/benchmarks/CMakeLists.txt
index 1243f54..92ff0ea 100644
--- a/benchmarks/CMakeLists.txt
+++ b/tests/benchmarks/CMakeLists.txt
@@ -23,11 +23,12 @@
endif()
# download test data
-include(${CMAKE_SOURCE_DIR}/../cmake/download_test_data.cmake)
+set(CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/../../cmake ${CMAKE_MODULE_PATH})
+include(download_test_data)
# benchmark binary
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 68%
rename from benchmarks/src/benchmarks.cpp
rename to tests/benchmarks/src/benchmarks.cpp
index 4f32a61..7ab47dd 100644
--- a/benchmarks/src/benchmarks.cpp
+++ b/tests/benchmarks/src/benchmarks.cpp
@@ -1,6 +1,16 @@
-#include "benchmark/benchmark.h"
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include <benchmark/benchmark.h>
#include <nlohmann/json.hpp>
#include <fstream>
+#include <numeric>
+#include <vector>
#include <test_data.hpp>
using json = nlohmann::json;
@@ -107,4 +117,63 @@
BENCHMARK_CAPTURE(Dump, small_signed_ints / 4, TEST_DATA_DIRECTORY "/regression/small_signed_ints.json", 4);
+//////////////////////////////////////////////////////////////////////////////
+// serialize CBOR
+//////////////////////////////////////////////////////////////////////////////
+static void ToCbor(benchmark::State& state, const char* filename)
+{
+ std::ifstream f(filename);
+ std::string str((std::istreambuf_iterator<char>(f)), std::istreambuf_iterator<char>());
+ json j = json::parse(str);
+
+ while (state.KeepRunning())
+ {
+ json::to_cbor(j);
+ }
+
+ state.SetBytesProcessed(state.iterations() * json::to_cbor(j).size());
+}
+BENCHMARK_CAPTURE(ToCbor, jeopardy, TEST_DATA_DIRECTORY "/jeopardy/jeopardy.json");
+BENCHMARK_CAPTURE(ToCbor, canada, TEST_DATA_DIRECTORY "/nativejson-benchmark/canada.json");
+BENCHMARK_CAPTURE(ToCbor, citm_catalog, TEST_DATA_DIRECTORY "/nativejson-benchmark/citm_catalog.json");
+BENCHMARK_CAPTURE(ToCbor, twitter, TEST_DATA_DIRECTORY "/nativejson-benchmark/twitter.json");
+BENCHMARK_CAPTURE(ToCbor, floats, TEST_DATA_DIRECTORY "/regression/floats.json");
+BENCHMARK_CAPTURE(ToCbor, signed_ints, TEST_DATA_DIRECTORY "/regression/signed_ints.json");
+BENCHMARK_CAPTURE(ToCbor, unsigned_ints, TEST_DATA_DIRECTORY "/regression/unsigned_ints.json");
+BENCHMARK_CAPTURE(ToCbor, small_signed_ints, TEST_DATA_DIRECTORY "/regression/small_signed_ints.json");
+
+//////////////////////////////////////////////////////////////////////////////
+// serialize binary CBOR
+//////////////////////////////////////////////////////////////////////////////
+static void BinaryToCbor(benchmark::State& state)
+{
+ std::vector<uint8_t> data(256);
+ std::iota(data.begin(), data.end(), 0);
+
+ auto it = data.begin();
+ std::vector<uint8_t> in;
+ in.reserve(state.range(0));
+ for (int i = 0; i < state.range(0); ++i)
+ {
+ if (it == data.end())
+ {
+ it = data.begin();
+ }
+
+ in.push_back(*it);
+ ++it;
+ }
+
+ json::binary_t bin{in};
+ json j{{"type", "binary"}, {"data", bin}};
+
+ while (state.KeepRunning())
+ {
+ json::to_cbor(j);
+ }
+
+ state.SetBytesProcessed(state.iterations() * json::to_cbor(j).size());
+}
+BENCHMARK(BinaryToCbor)->RangeMultiplier(2)->Range(8, 8 << 12);
+
BENCHMARK_MAIN();
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/tests/cmake_add_subdirectory/project/main.cpp b/tests/cmake_add_subdirectory/project/main.cpp
new file mode 100644
index 0000000..9f1d56b
--- /dev/null
+++ b/tests/cmake_add_subdirectory/project/main.cpp
@@ -0,0 +1,16 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include <nlohmann/json.hpp>
+
+int main(int argc, char** argv)
+{
+ nlohmann::json j;
+
+ return 0;
+}
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/tests/cmake_fetch_content/project/main.cpp b/tests/cmake_fetch_content/project/main.cpp
new file mode 100644
index 0000000..9f1d56b
--- /dev/null
+++ b/tests/cmake_fetch_content/project/main.cpp
@@ -0,0 +1,16 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include <nlohmann/json.hpp>
+
+int main(int argc, char** argv)
+{
+ nlohmann::json j;
+
+ return 0;
+}
diff --git a/tests/cmake_fetch_content2/CMakeLists.txt b/tests/cmake_fetch_content2/CMakeLists.txt
new file mode 100644
index 0000000..40e75e8
--- /dev/null
+++ b/tests/cmake_fetch_content2/CMakeLists.txt
@@ -0,0 +1,20 @@
+if (${CMAKE_VERSION} VERSION_GREATER "3.14.0")
+ add_test(NAME cmake_fetch_content2_configure
+ COMMAND ${CMAKE_COMMAND}
+ -G "${CMAKE_GENERATOR}"
+ -DCMAKE_CXX_COMPILER=${CMAKE_CXX_COMPILER}
+ -Dnlohmann_json_source=${PROJECT_SOURCE_DIR}
+ ${CMAKE_CURRENT_SOURCE_DIR}/project
+ )
+ add_test(NAME cmake_fetch_content2_build
+ COMMAND ${CMAKE_COMMAND} --build .
+ )
+ set_tests_properties(cmake_fetch_content2_configure PROPERTIES
+ FIXTURES_SETUP cmake_fetch_content2
+ LABELS "git_required;not_reproducible"
+ )
+ set_tests_properties(cmake_fetch_content2_build PROPERTIES
+ FIXTURES_REQUIRED cmake_fetch_content2
+ LABELS "git_required;not_reproducible"
+ )
+endif()
diff --git a/tests/cmake_fetch_content2/project/CMakeLists.txt b/tests/cmake_fetch_content2/project/CMakeLists.txt
new file mode 100644
index 0000000..734b9cc
--- /dev/null
+++ b/tests/cmake_fetch_content2/project/CMakeLists.txt
@@ -0,0 +1,15 @@
+cmake_minimum_required(VERSION 3.14)
+
+project(DummyImport CXX)
+
+include(FetchContent)
+
+get_filename_component(GIT_REPOSITORY_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/../../.. ABSOLUTE)
+FetchContent_Declare(json GIT_REPOSITORY ${GIT_REPOSITORY_DIRECTORY} GIT_TAG HEAD)
+FetchContent_MakeAvailable(json)
+
+add_executable(with_namespace_target main.cpp)
+target_link_libraries(with_namespace_target nlohmann_json::nlohmann_json)
+
+add_executable(without_namespace_target main.cpp)
+target_link_libraries(without_namespace_target nlohmann_json)
diff --git a/tests/cmake_fetch_content2/project/main.cpp b/tests/cmake_fetch_content2/project/main.cpp
new file mode 100644
index 0000000..9f1d56b
--- /dev/null
+++ b/tests/cmake_fetch_content2/project/main.cpp
@@ -0,0 +1,16 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include <nlohmann/json.hpp>
+
+int main(int argc, char** argv)
+{
+ nlohmann::json j;
+
+ return 0;
+}
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/tests/cmake_import/project/main.cpp b/tests/cmake_import/project/main.cpp
new file mode 100644
index 0000000..9f1d56b
--- /dev/null
+++ b/tests/cmake_import/project/main.cpp
@@ -0,0 +1,16 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include <nlohmann/json.hpp>
+
+int main(int argc, char** argv)
+{
+ nlohmann::json j;
+
+ return 0;
+}
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/tests/cmake_import_minver/project/main.cpp b/tests/cmake_import_minver/project/main.cpp
new file mode 100644
index 0000000..9f1d56b
--- /dev/null
+++ b/tests/cmake_import_minver/project/main.cpp
@@ -0,0 +1,16 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include <nlohmann/json.hpp>
+
+int main(int argc, char** argv)
+{
+ nlohmann::json j;
+
+ return 0;
+}
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/tests/cmake_target_include_directories/project/Bar.cpp b/tests/cmake_target_include_directories/project/Bar.cpp
new file mode 100644
index 0000000..63ae3a0
--- /dev/null
+++ b/tests/cmake_target_include_directories/project/Bar.cpp
@@ -0,0 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "Bar.hpp"
+
+class Bar;
diff --git a/tests/cmake_target_include_directories/project/Bar.hpp b/tests/cmake_target_include_directories/project/Bar.hpp
new file mode 100644
index 0000000..411324d
--- /dev/null
+++ b/tests/cmake_target_include_directories/project/Bar.hpp
@@ -0,0 +1,12 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include <nlohmann/json.hpp>
+#include "Foo.hpp"
+
+class Bar : public Foo {};
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/tests/cmake_target_include_directories/project/Foo.cpp b/tests/cmake_target_include_directories/project/Foo.cpp
new file mode 100644
index 0000000..970f416
--- /dev/null
+++ b/tests/cmake_target_include_directories/project/Foo.cpp
@@ -0,0 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "Foo.hpp"
+
+class Foo;
diff --git a/tests/cmake_target_include_directories/project/Foo.hpp b/tests/cmake_target_include_directories/project/Foo.hpp
new file mode 100644
index 0000000..cdee354
--- /dev/null
+++ b/tests/cmake_target_include_directories/project/Foo.hpp
@@ -0,0 +1,12 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#pragma once
+#include <nlohmann/json.hpp>
+
+class Foo {};
diff --git a/tests/cmake_target_include_directories/project/main.cpp b/tests/cmake_target_include_directories/project/main.cpp
new file mode 100644
index 0000000..9f1d56b
--- /dev/null
+++ b/tests/cmake_target_include_directories/project/main.cpp
@@ -0,0 +1,16 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include <nlohmann/json.hpp>
+
+int main(int argc, char** argv)
+{
+ nlohmann::json j;
+
+ return 0;
+}
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/tests/cuda_example/json_cuda.cu b/tests/cuda_example/json_cuda.cu
new file mode 100644
index 0000000..35b61f1
--- /dev/null
+++ b/tests/cuda_example/json_cuda.cu
@@ -0,0 +1,19 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include <nlohmann/json.hpp>
+
+int main()
+{
+ nlohmann::ordered_json json = {"Test"};
+ json.dump();
+
+ // regression for #3013 (ordered_json::reset() compile error with nvcc)
+ nlohmann::ordered_json metadata;
+ metadata.erase("key");
+}
diff --git a/tests/fuzzing.md b/tests/fuzzing.md
new file mode 100644
index 0000000..cfbf4f2
--- /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.
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
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 \050C++11\051.md" "b/tests/reports/2016-09-09-nativejson_benchmark/conformance_Nlohmann \050C++11\051.md"
similarity index 100%
rename from "test/reports/2016-09-09-nativejson_benchmark/conformance_Nlohmann \050C++11\051.md"
rename to "tests/reports/2016-09-09-nativejson_benchmark/conformance_Nlohmann \050C++11\051.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
Binary files differ
diff --git "a/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Memory_\050byte\051.png" "b/tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Memory_\050byte\051.png"
similarity index 100%
rename from "test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Memory_\050byte\051.png"
rename to "tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Memory_\050byte\051.png"
Binary files differ
diff --git "a/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Time_\050ms\051.png" "b/tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Time_\050ms\051.png"
similarity index 100%
rename from "test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Time_\050ms\051.png"
rename to "tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Time_\050ms\051.png"
Binary files differ
diff --git "a/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_2._Stringify_Time_\050ms\051.png" "b/tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_2._Stringify_Time_\050ms\051.png"
similarity index 100%
rename from "test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_2._Stringify_Time_\050ms\051.png"
rename to "tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_2._Stringify_Time_\050ms\051.png"
Binary files differ
diff --git "a/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_3._Prettify_Time_\050ms\051.png" "b/tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_3._Prettify_Time_\050ms\051.png"
similarity index 100%
rename from "test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_3._Prettify_Time_\050ms\051.png"
rename to "tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_3._Prettify_Time_\050ms\051.png"
Binary files differ
diff --git "a/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_7._Code_size_FileSize_\050byte\051.png" "b/tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_7._Code_size_FileSize_\050byte\051.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_\050byte\051.png"
rename to "tests/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_7._Code_size_FileSize_\050byte\051.png"
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
diff --git a/test/src/fuzzer-driver_afl.cpp b/tests/src/fuzzer-driver_afl.cpp
similarity index 70%
rename from test/src/fuzzer-driver_afl.cpp
rename to tests/src/fuzzer-driver_afl.cpp
index 840f589..61cbe7b 100644
--- a/test/src/fuzzer-driver_afl.cpp
+++ b/tests/src/fuzzer-driver_afl.cpp
@@ -1,14 +1,15 @@
-/*
- __ _____ _____ _____
- __| | __| | | | JSON for Modern C++ (fuzz test support)
-| | |__ | | | | | | version 3.10.5
-|_____|_____|_____|_|___| https://github.com/nlohmann/json
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+/*
This file implements a driver for American Fuzzy Lop (afl-fuzz). It relies on
an implementation of the `LLVMFuzzerTestOneInput` function which processes a
passed byte array.
-
-Licensed under the MIT License <http://opensource.org/licenses/MIT>.
*/
#include <vector> // for vector
diff --git a/tests/src/fuzzer-parse_bjdata.cpp b/tests/src/fuzzer-parse_bjdata.cpp
new file mode 100644
index 0000000..0ead375
--- /dev/null
+++ b/tests/src/fuzzer-parse_bjdata.cpp
@@ -0,0 +1,85 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+/*
+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.
+*/
+
+#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/fuzzer-parse_bson.cpp b/tests/src/fuzzer-parse_bson.cpp
similarity index 83%
rename from test/src/fuzzer-parse_bson.cpp
rename to tests/src/fuzzer-parse_bson.cpp
index 79287ce..b74c395 100644
--- a/test/src/fuzzer-parse_bson.cpp
+++ b/tests/src/fuzzer-parse_bson.cpp
@@ -1,9 +1,12 @@
-/*
- __ _____ _____ _____
- __| | __| | | | JSON for Modern C++ (fuzz test support)
-| | |__ | | | | | | version 3.10.5
-|_____|_____|_____|_|___| https://github.com/nlohmann/json
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+/*
This file implements a parser test suitable for fuzz testing. Given a byte
array data, it performs the following steps:
@@ -14,8 +17,6 @@
The provided function `LLVMFuzzerTestOneInput` can be used in different fuzzer
drivers.
-
-Licensed under the MIT License <http://opensource.org/licenses/MIT>.
*/
#include <iostream>
diff --git a/test/src/fuzzer-parse_cbor.cpp b/tests/src/fuzzer-parse_cbor.cpp
similarity index 82%
rename from test/src/fuzzer-parse_cbor.cpp
rename to tests/src/fuzzer-parse_cbor.cpp
index 88e7b43..187cdef 100644
--- a/test/src/fuzzer-parse_cbor.cpp
+++ b/tests/src/fuzzer-parse_cbor.cpp
@@ -1,9 +1,12 @@
-/*
- __ _____ _____ _____
- __| | __| | | | JSON for Modern C++ (fuzz test support)
-| | |__ | | | | | | version 3.10.5
-|_____|_____|_____|_|___| https://github.com/nlohmann/json
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+/*
This file implements a parser test suitable for fuzz testing. Given a byte
array data, it performs the following steps:
@@ -14,8 +17,6 @@
The provided function `LLVMFuzzerTestOneInput` can be used in different fuzzer
drivers.
-
-Licensed under the MIT License <http://opensource.org/licenses/MIT>.
*/
#include <iostream>
diff --git a/test/src/fuzzer-parse_json.cpp b/tests/src/fuzzer-parse_json.cpp
similarity index 82%
rename from test/src/fuzzer-parse_json.cpp
rename to tests/src/fuzzer-parse_json.cpp
index 9f63628..9955ee1 100644
--- a/test/src/fuzzer-parse_json.cpp
+++ b/tests/src/fuzzer-parse_json.cpp
@@ -1,9 +1,12 @@
-/*
- __ _____ _____ _____
- __| | __| | | | JSON for Modern C++ (fuzz test support)
-| | |__ | | | | | | version 3.10.5
-|_____|_____|_____|_|___| https://github.com/nlohmann/json
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+/*
This file implements a parser test suitable for fuzz testing. Given a byte
array data, it performs the following steps:
@@ -15,8 +18,6 @@
The provided function `LLVMFuzzerTestOneInput` can be used in different fuzzer
drivers.
-
-Licensed under the MIT License <http://opensource.org/licenses/MIT>.
*/
#include <iostream>
diff --git a/test/src/fuzzer-parse_msgpack.cpp b/tests/src/fuzzer-parse_msgpack.cpp
similarity index 83%
rename from test/src/fuzzer-parse_msgpack.cpp
rename to tests/src/fuzzer-parse_msgpack.cpp
index b58498c..9d7c0e3 100644
--- a/test/src/fuzzer-parse_msgpack.cpp
+++ b/tests/src/fuzzer-parse_msgpack.cpp
@@ -1,9 +1,12 @@
-/*
- __ _____ _____ _____
- __| | __| | | | JSON for Modern C++ (fuzz test support)
-| | |__ | | | | | | version 3.10.5
-|_____|_____|_____|_|___| https://github.com/nlohmann/json
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+/*
This file implements a parser test suitable for fuzz testing. Given a byte
array data, it performs the following steps:
@@ -14,8 +17,6 @@
The provided function `LLVMFuzzerTestOneInput` can be used in different fuzzer
drivers.
-
-Licensed under the MIT License <http://opensource.org/licenses/MIT>.
*/
#include <iostream>
diff --git a/test/src/fuzzer-parse_ubjson.cpp b/tests/src/fuzzer-parse_ubjson.cpp
similarity index 88%
rename from test/src/fuzzer-parse_ubjson.cpp
rename to tests/src/fuzzer-parse_ubjson.cpp
index 7774b4b..b403001 100644
--- a/test/src/fuzzer-parse_ubjson.cpp
+++ b/tests/src/fuzzer-parse_ubjson.cpp
@@ -1,9 +1,12 @@
-/*
- __ _____ _____ _____
- __| | __| | | | JSON for Modern C++ (fuzz test support)
-| | |__ | | | | | | version 3.10.5
-|_____|_____|_____|_|___| https://github.com/nlohmann/json
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+/*
This file implements a parser test suitable for fuzz testing. Given a byte
array data, it performs the following steps:
@@ -20,8 +23,6 @@
The provided function `LLVMFuzzerTestOneInput` can be used in different fuzzer
drivers.
-
-Licensed under the MIT License <http://opensource.org/licenses/MIT>.
*/
#include <iostream>
diff --git a/tests/src/make_test_data_available.hpp b/tests/src/make_test_data_available.hpp
new file mode 100644
index 0000000..f5f613e
--- /dev/null
+++ b/tests/src/make_test_data_available.hpp
@@ -0,0 +1,30 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include <cstdio> // fopen, fclose, FILE
+#include <memory> // unique_ptr
+#include <test_data.hpp>
+#include <doctest.h>
+
+namespace utils
+{
+
+inline bool check_testsuite_downloaded()
+{
+ std::unique_ptr<std::FILE, decltype(&std::fclose)> file(std::fopen(TEST_DATA_DIRECTORY "/README.md", "r"), &std::fclose);
+ return file != nullptr;
+}
+
+TEST_CASE("check test suite is downloaded")
+{
+ REQUIRE_MESSAGE(utils::check_testsuite_downloaded(), "Test data not found in '" TEST_DATA_DIRECTORY "'. Please execute target 'download_test_data' before running this test suite. See <https://github.com/nlohmann/json#execute-unit-tests> for more information.");
+}
+
+} // namespace utils
diff --git a/test/src/test_utils.hpp b/tests/src/test_utils.hpp
similarity index 69%
rename from test/src/test_utils.hpp
rename to tests/src/test_utils.hpp
index 12c260e..4ef2308 100644
--- a/test/src/test_utils.hpp
+++ b/tests/src/test_utils.hpp
@@ -1,3 +1,11 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
#pragma once
#include <cstdint> // uint8_t
diff --git a/tests/src/unit-32bit.cpp b/tests/src/unit-32bit.cpp
new file mode 100644
index 0000000..729ad79
--- /dev/null
+++ b/tests/src/unit-32bit.cpp
@@ -0,0 +1,136 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#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: 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};
+ 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(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/test/src/unit-algorithms.cpp b/tests/src/unit-algorithms.cpp
similarity index 84%
rename from test/src/unit-algorithms.cpp
rename to tests/src/unit-algorithms.cpp
index 36f02e1..98b3f99 100644
--- a/test/src/unit-algorithms.cpp
+++ b/tests/src/unit-algorithms.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -241,9 +220,7 @@
SECTION("sorting an object")
{
json j({{"one", 1}, {"two", 2}});
- CHECK_THROWS_AS(std::sort(j.begin(), j.end()), json::invalid_iterator&);
- CHECK_THROWS_WITH(std::sort(j.begin(), j.end()),
- "[json.exception.invalid_iterator.209] cannot use offsets with object iterators");
+ CHECK_THROWS_WITH_AS(std::sort(j.begin(), j.end()), "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
}
}
diff --git a/test/src/unit-allocator.cpp b/tests/src/unit-allocator.cpp
similarity index 82%
rename from test/src/unit-allocator.cpp
rename to tests/src/unit-allocator.cpp
index 2671212..99d83b0 100644
--- a/test/src/unit-allocator.cpp
+++ b/tests/src/unit-allocator.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -39,6 +18,8 @@
template<class T>
struct bad_allocator : std::allocator<T>
{
+ using std::allocator<T>::allocator;
+
template<class... Args>
void construct(T* /*unused*/, Args&& ... /*unused*/)
{
diff --git a/test/src/unit-alt-string.cpp b/tests/src/unit-alt-string.cpp
similarity index 74%
rename from test/src/unit-alt-string.cpp
rename to tests/src/unit-alt-string.cpp
index 2c599a4..fa75aa2 100644
--- a/test/src/unit-alt-string.cpp
+++ b/tests/src/unit-alt-string.cpp
@@ -1,31 +1,11 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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) 2018 Vitaliy Manushkin <agri@akamo.info>.
-
-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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-FileCopyrightText: 2018 Vitaliy Manushkin <agri@akamo.info>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -37,7 +17,7 @@
/* forward declarations */
class alt_string;
-bool operator<(const char* op1, const alt_string& op2);
+bool operator<(const char* op1, const alt_string& op2) noexcept;
void int_to_string(alt_string& target, std::size_t value);
/*
@@ -49,6 +29,8 @@
public:
using value_type = std::string::value_type;
+ static constexpr auto npos = static_cast<std::size_t>(-1);
+
alt_string(const char* str): str_impl(str) {}
alt_string(const char* str, std::size_t count): str_impl(str, count) {}
alt_string(size_t count, char chr): str_impl(count, chr) {}
@@ -104,12 +86,12 @@
}
template <typename op_type>
- bool operator<(const op_type& op) const
+ bool operator<(const op_type& op) const noexcept
{
return str_impl < op;
}
- bool operator<(const alt_string& op) const
+ bool operator<(const alt_string& op) const noexcept
{
return str_impl < op.str_impl;
}
@@ -144,15 +126,42 @@
str_impl.clear();
}
- const value_type* data()
+ const value_type* data() const
{
return str_impl.data();
}
+ bool empty() const
+ {
+ return str_impl.empty();
+ }
+
+ std::size_t find(const alt_string& str, std::size_t pos = 0) const
+ {
+ return str_impl.find(str.str_impl, pos);
+ }
+
+ std::size_t find_first_of(char c, std::size_t pos = 0) const
+ {
+ return str_impl.find_first_of(c, pos);
+ }
+
+ alt_string substr(std::size_t pos = 0, std::size_t count = npos) const
+ {
+ std::string s = str_impl.substr(pos, count);
+ return {s.data(), s.size()};
+ }
+
+ alt_string& replace(std::size_t pos, std::size_t count, const alt_string& str)
+ {
+ str_impl.replace(pos, count, str.str_impl);
+ return *this;
+ }
+
private:
std::string str_impl {};
- friend bool ::operator<(const char* /*op1*/, const alt_string& /*op2*/);
+ friend bool operator<(const char* /*op1*/, const alt_string& /*op2*/) noexcept;
};
void int_to_string(alt_string& target, std::size_t value)
@@ -172,7 +181,7 @@
nlohmann::adl_serializer >;
-bool operator<(const char* op1, const alt_string& op2)
+bool operator<(const char* op1, const alt_string& op2) noexcept
{
return op1 < op2.str_impl;
}
@@ -296,4 +305,20 @@
CHECK_FALSE(const_doc["Who are you?"] == "I'm Bruce Wayne");
}
}
+
+ SECTION("JSON pointer")
+ {
+ // conversion from json to alt_json fails to compile (see #3425);
+ // attempted fix(*) produces: [[['b','a','r'],['b','a','z']]] (with each char being an integer)
+ // (*) disable implicit conversion for json_refs of any basic_json type
+ // alt_json j = R"(
+ // {
+ // "foo": ["bar", "baz"]
+ // }
+ // )"_json;
+ auto j = alt_json::parse(R"({"foo": ["bar", "baz"]})");
+
+ CHECK(j.at(alt_json::json_pointer("/foo/0")) == j["foo"][0]);
+ CHECK(j.at(alt_json::json_pointer("/foo/1")) == j["foo"][1]);
+ }
}
diff --git a/tests/src/unit-assert_macro.cpp b/tests/src/unit-assert_macro.cpp
new file mode 100644
index 0000000..6e84e26
--- /dev/null
+++ b/tests/src/unit-assert_macro.cpp
@@ -0,0 +1,48 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+// avoid warning when assert does not abort
+DOCTEST_GCC_SUPPRESS_WARNING_PUSH
+DOCTEST_GCC_SUPPRESS_WARNING("-Wstrict-overflow")
+DOCTEST_CLANG_SUPPRESS_WARNING_PUSH
+DOCTEST_CLANG_SUPPRESS_WARNING("-Wstrict-overflow")
+
+/// global variable to record side effect of assert calls
+static int assert_counter;
+
+/// set failure variable to true instead of calling assert(x)
+#define JSON_ASSERT(x) {if (!(x)) ++assert_counter; }
+
+#include <nlohmann/json.hpp>
+using nlohmann::json;
+
+// the test assumes exceptions to work
+#if !defined(JSON_NOEXCEPTION)
+TEST_CASE("JSON_ASSERT(x)")
+{
+ SECTION("basic_json(first, second)")
+ {
+ assert_counter = 0;
+ CHECK(assert_counter == 0);
+
+ json::iterator it;
+ json j;
+
+ // in case assertions do not abort execution, an exception is thrown
+ CHECK_THROWS_WITH_AS(json(it, j.end()), "[json.exception.invalid_iterator.201] iterators are not compatible", json::invalid_iterator);
+
+ // check that assertion actually happened
+ CHECK(assert_counter == 1);
+ }
+}
+#endif
+
+DOCTEST_GCC_SUPPRESS_WARNING_POP
+DOCTEST_CLANG_SUPPRESS_WARNING_POP
diff --git a/tests/src/unit-binary_formats.cpp b/tests/src/unit-binary_formats.cpp
new file mode 100644
index 0000000..0c61ecd
--- /dev/null
+++ b/tests/src/unit-binary_formats.cpp
@@ -0,0 +1,211 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#include <nlohmann/json.hpp>
+using nlohmann::json;
+
+#include <fstream>
+#include "make_test_data_available.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
new file mode 100644
index 0000000..87532c3
--- /dev/null
+++ b/tests/src/unit-bjdata.cpp
@@ -0,0 +1,3536 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#include <climits>
+#include <limits>
+#include <nlohmann/json.hpp>
+using nlohmann::json;
+
+#include <iostream>
+#include <fstream>
+#include <set>
+#include "make_test_data_available.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
+
+// 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")
+ {
+ 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_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());
+ }
+
+ SECTION("only one byte follows")
+ {
+ json _;
+ std::vector<uint8_t> vec1 = {'h', 0x00};
+ 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());
+ }
+ }
+ }
+
+ 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_FALSE(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_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&);
+ }
+ }
+ }
+
+ SECTION("SAX aborts")
+ {
+ SECTION("start_array()")
+ {
+ std::vector<uint8_t> v = {'[', 'T', 'F', ']'};
+ SaxCountdown scp(0);
+ 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_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_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_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_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_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_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_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_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_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_FALSE(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_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};
+ 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'};
+ 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());
+ 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}));
+ 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"}));
+ CHECK(json::from_bjdata(v_R) == json({6, 7}));
+ }
+
+ 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("parse errors")
+ {
+ SECTION("empty byte vector")
+ {
+ json _;
+ 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")
+ {
+ SECTION("eof after C byte")
+ {
+ std::vector<uint8_t> v = {'C'};
+ json _;
+ 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_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_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_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")
+ {
+ // 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_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&);
+ }
+ }
+
+ 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> 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, ']'};
+
+ 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, ']'};
+ 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&);
+ CHECK(json::from_bjdata(v1, true, false).is_discarded());
+
+ 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(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(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: 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")
+ {
+ 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&);
+ 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
+ }
+
+ 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};
+ 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_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_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_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_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());
+ }
+
+ SECTION("do not accept NTFZ markers in ndarray optimized type (without count)")
+ {
+ 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_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_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_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_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());
+ }
+ }
+
+ SECTION("strings")
+ {
+ std::vector<uint8_t> vS = {'S'};
+ json _;
+ 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_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_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());
+ }
+
+ SECTION("sizes")
+ {
+ std::vector<uint8_t> vU = {'[', '#', 'U'};
+ json _;
+ 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_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_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_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_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_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_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_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_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_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_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_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_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());
+ }
+
+ SECTION("types")
+ {
+ std::vector<uint8_t> v0 = {'[', '$'};
+ json _;
+ 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_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_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_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());
+ }
+
+ SECTION("arrays")
+ {
+ std::vector<uint8_t> vST = {'[', '$', 'i', '#', 'i', 2, 1};
+ json _;
+ 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_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_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());
+ }
+
+ SECTION("ndarrays")
+ {
+ std::vector<uint8_t> vST = {'[', '$', 'i', '#', '[', '$', 'i', '#'};
+ json _;
+ 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_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_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_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_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_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_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_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_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_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};
+ 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());
+
+ 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 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};
+ 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 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};
+ 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 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")
+ {
+ std::vector<uint8_t> vST = {'{', '$', 'i', '#', 'i', 2, 'i', 1, 'a', 1};
+ json _;
+ 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_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_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_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_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_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_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_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};
+ 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());
+ }
+ }
+
+ 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")
+ {
+ json _;
+ std::vector<uint8_t> v = {'[', '$', 'N', '#', 'I', 0x00, 0x02};
+ 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());
+ }
+
+ 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_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());
+ }
+ }
+ }
+}
+
+#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 + ": 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);
+ }
+ }
+ }
+ }
+}
diff --git a/test/src/unit-bson.cpp b/tests/src/unit-bson.cpp
similarity index 88%
rename from test/src/unit-bson.cpp
rename to tests/src/unit-bson.cpp
index 64c3607..aaea855 100644
--- a/test/src/unit-bson.cpp
+++ b/tests/src/unit-bson.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -34,7 +13,7 @@
#include <fstream>
#include <sstream>
-#include <test_data.hpp>
+#include "make_test_data_available.hpp"
#include "test_utils.hpp"
TEST_CASE("BSON")
@@ -44,8 +23,7 @@
SECTION("null")
{
json j = nullptr;
- CHECK_THROWS_AS(json::to_bson(j), json::type_error&);
- CHECK_THROWS_WITH(json::to_bson(j), "[json.exception.type_error.317] to serialize to BSON, top-level type must be object, but is null");
+ CHECK_THROWS_WITH_AS(json::to_bson(j), "[json.exception.type_error.317] to serialize to BSON, top-level type must be object, but is null", json::type_error&);
}
SECTION("boolean")
@@ -53,44 +31,38 @@
SECTION("true")
{
json j = true;
- CHECK_THROWS_AS(json::to_bson(j), json::type_error&);
- CHECK_THROWS_WITH(json::to_bson(j), "[json.exception.type_error.317] to serialize to BSON, top-level type must be object, but is boolean");
+ CHECK_THROWS_WITH_AS(json::to_bson(j), "[json.exception.type_error.317] to serialize to BSON, top-level type must be object, but is boolean", json::type_error&);
}
SECTION("false")
{
json j = false;
- CHECK_THROWS_AS(json::to_bson(j), json::type_error&);
- CHECK_THROWS_WITH(json::to_bson(j), "[json.exception.type_error.317] to serialize to BSON, top-level type must be object, but is boolean");
+ CHECK_THROWS_WITH_AS(json::to_bson(j), "[json.exception.type_error.317] to serialize to BSON, top-level type must be object, but is boolean", json::type_error&);
}
}
SECTION("number")
{
json j = 42;
- CHECK_THROWS_AS(json::to_bson(j), json::type_error&);
- CHECK_THROWS_WITH(json::to_bson(j), "[json.exception.type_error.317] to serialize to BSON, top-level type must be object, but is number");
+ CHECK_THROWS_WITH_AS(json::to_bson(j), "[json.exception.type_error.317] to serialize to BSON, top-level type must be object, but is number", json::type_error&);
}
SECTION("float")
{
json j = 4.2;
- CHECK_THROWS_AS(json::to_bson(j), json::type_error&);
- CHECK_THROWS_WITH(json::to_bson(j), "[json.exception.type_error.317] to serialize to BSON, top-level type must be object, but is number");
+ CHECK_THROWS_WITH_AS(json::to_bson(j), "[json.exception.type_error.317] to serialize to BSON, top-level type must be object, but is number", json::type_error&);
}
SECTION("string")
{
json j = "not supported";
- CHECK_THROWS_AS(json::to_bson(j), json::type_error&);
- CHECK_THROWS_WITH(json::to_bson(j), "[json.exception.type_error.317] to serialize to BSON, top-level type must be object, but is string");
+ CHECK_THROWS_WITH_AS(json::to_bson(j), "[json.exception.type_error.317] to serialize to BSON, top-level type must be object, but is string", json::type_error&);
}
SECTION("array")
{
json j = std::vector<int> {1, 2, 3, 4, 5, 6, 7};
- CHECK_THROWS_AS(json::to_bson(j), json::type_error&);
- CHECK_THROWS_WITH(json::to_bson(j), "[json.exception.type_error.317] to serialize to BSON, top-level type must be object, but is array");
+ CHECK_THROWS_WITH_AS(json::to_bson(j), "[json.exception.type_error.317] to serialize to BSON, top-level type must be object, but is array", json::type_error&);
}
}
@@ -100,11 +72,10 @@
{
{ std::string("en\0try", 6), true }
};
- CHECK_THROWS_AS(json::to_bson(j), json::out_of_range&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(json::to_bson(j), "[json.exception.out_of_range.409] (/en) BSON key cannot contain code point U+0000 (at byte 2)");
+ CHECK_THROWS_WITH_AS(json::to_bson(j), "[json.exception.out_of_range.409] (/en) BSON key cannot contain code point U+0000 (at byte 2)", json::out_of_range&);
#else
- CHECK_THROWS_WITH(json::to_bson(j), "[json.exception.out_of_range.409] BSON key cannot contain code point U+0000 (at byte 2)");
+ CHECK_THROWS_WITH_AS(json::to_bson(j), "[json.exception.out_of_range.409] BSON key cannot contain code point U+0000 (at byte 2)", json::out_of_range&);
#endif
}
@@ -119,8 +90,7 @@
0x00, 0x00, 0x00, 0x80
};
json _;
- CHECK_THROWS_AS(_ = json::from_bson(v), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_bson(v), "[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");
+ CHECK_THROWS_WITH_AS(_ = json::from_bson(v), "[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::parse_error&);
}
SECTION("objects")
@@ -764,9 +734,7 @@
};
json _;
- CHECK_THROWS_AS(_ = json::from_bson(incomplete_bson), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_bson(incomplete_bson),
- "[json.exception.parse_error.110] parse error at byte 9: syntax error while parsing BSON cstring: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_bson(incomplete_bson), "[json.exception.parse_error.110] parse error at byte 9: syntax error while parsing BSON cstring: unexpected end of input", json::parse_error&);
CHECK(json::from_bson(incomplete_bson, true, false).is_discarded());
@@ -783,9 +751,7 @@
};
json _;
- CHECK_THROWS_AS(_ = json::from_bson(incomplete_bson), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_bson(incomplete_bson),
- "[json.exception.parse_error.110] parse error at byte 6: syntax error while parsing BSON cstring: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_bson(incomplete_bson), "[json.exception.parse_error.110] parse error at byte 6: syntax error while parsing BSON cstring: unexpected end of input", json::parse_error&);
CHECK(json::from_bson(incomplete_bson, true, false).is_discarded());
SaxCountdown scp(0);
@@ -807,9 +773,7 @@
};
json _;
- CHECK_THROWS_AS(_ = json::from_bson(incomplete_bson), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_bson(incomplete_bson),
- "[json.exception.parse_error.110] parse error at byte 28: syntax error while parsing BSON element list: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_bson(incomplete_bson), "[json.exception.parse_error.110] parse error at byte 28: syntax error while parsing BSON element list: unexpected end of input", json::parse_error&);
CHECK(json::from_bson(incomplete_bson, true, false).is_discarded());
SaxCountdown scp(1);
@@ -824,9 +788,7 @@
};
json _;
- CHECK_THROWS_AS(_ = json::from_bson(incomplete_bson), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_bson(incomplete_bson),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing BSON number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_bson(incomplete_bson), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing BSON number: unexpected end of input", json::parse_error&);
CHECK(json::from_bson(incomplete_bson, true, false).is_discarded());
SaxCountdown scp(0);
@@ -872,8 +834,7 @@
0x00 // end marker
};
json _;
- CHECK_THROWS_AS(_ = json::from_bson(input), json::parse_error);
- CHECK_THROWS_WITH(_ = json::from_bson(input), "[json.exception.parse_error.112] parse error at byte 15: syntax error while parsing BSON binary: byte array length cannot be negative, is -1");
+ CHECK_THROWS_WITH_AS(_ = json::from_bson(input), "[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::parse_error);
}
TEST_CASE("Unsupported BSON input")
@@ -887,9 +848,7 @@
};
json _;
- CHECK_THROWS_AS(_ = json::from_bson(bson), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_bson(bson),
- "[json.exception.parse_error.114] parse error at byte 5: Unsupported BSON record type 0xFF");
+ CHECK_THROWS_WITH_AS(_ = json::from_bson(bson), "[json.exception.parse_error.114] parse error at byte 5: Unsupported BSON record type 0xFF", json::parse_error&);
CHECK(json::from_bson(bson, true, false).is_discarded());
SaxCountdown scp(0);
diff --git a/test/src/unit-byte_container_with_subtype.cpp b/tests/src/unit-byte_container_with_subtype.cpp
similarity index 62%
rename from test/src/unit-byte_container_with_subtype.cpp
rename to tests/src/unit-byte_container_with_subtype.cpp
index 3f39749..c7e9182 100644
--- a/test/src/unit-byte_container_with_subtype.cpp
+++ b/tests/src/unit-byte_container_with_subtype.cpp
@@ -1,31 +1,11 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// Copyright (c) 2013-2022 Niels Lohmann <http://nlohmann.me>.
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
diff --git a/test/src/unit-capacity.cpp b/tests/src/unit-capacity.cpp
similarity index 91%
rename from test/src/unit-capacity.cpp
rename to tests/src/unit-capacity.cpp
index c8362d4..70ea0e3 100644
--- a/test/src/unit-capacity.cpp
+++ b/tests/src/unit-capacity.cpp
@@ -1,31 +1,11 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// Copyright (c) 2013-2022 Niels Lohmann <http://nlohmann.me>.
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
diff --git a/test/src/unit-cbor.cpp b/tests/src/unit-cbor.cpp
similarity index 89%
rename from test/src/unit-cbor.cpp
rename to tests/src/unit-cbor.cpp
index 59ff2af..b7ed22e 100644
--- a/test/src/unit-cbor.cpp
+++ b/tests/src/unit-cbor.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -37,7 +16,7 @@
#include <iomanip>
#include <iostream>
#include <set>
-#include <test_data.hpp>
+#include "make_test_data_available.hpp"
#include "test_utils.hpp"
namespace
@@ -991,17 +970,13 @@
SECTION("no byte follows")
{
json _;
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0xf9})), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0xf9})),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0xf9})), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
CHECK(json::from_cbor(std::vector<uint8_t>({0xf9}), true, false).is_discarded());
}
SECTION("only one byte follows")
{
json _;
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0xf9, 0x7c})), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0xf9, 0x7c})),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0xf9, 0x7c})), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
CHECK(json::from_cbor(std::vector<uint8_t>({0xf9, 0x7c}), true, false).is_discarded());
}
}
@@ -1609,7 +1584,7 @@
// callback to set binary_seen to true if a binary value was seen
bool binary_seen = false;
- auto callback = [&binary_seen](int /*depth*/, json::parse_event_t /*event*/, json & parsed)
+ auto callback = [&binary_seen](int /*depth*/, json::parse_event_t /*event*/, json & parsed) noexcept
{
if (parsed.is_binary())
{
@@ -1671,97 +1646,40 @@
SECTION("empty byte vector")
{
json _;
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>()), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>()),
- "[json.exception.parse_error.110] parse error at byte 1: syntax error while parsing CBOR value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>()), "[json.exception.parse_error.110] parse error at byte 1: syntax error while parsing CBOR value: unexpected end of input", json::parse_error&);
CHECK(json::from_cbor(std::vector<uint8_t>(), true, false).is_discarded());
}
SECTION("too short byte vector")
{
json _;
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x18})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x19})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x19, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1a})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1a, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1a, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1a, 0x00, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x62})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x62, 0x60})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x7F})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x7F, 0x60})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x82, 0x01})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x9F, 0x01})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0xBF, 0x61, 0x61, 0xF5})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0xA1, 0x61, 0X61})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0xBF, 0x61, 0X61})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x5F})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x5F, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x41})), json::parse_error&);
-
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x18})),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x19})),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x19, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x1a})),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x1a, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x1a, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x1a, 0x00, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x1b})),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 6: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 9: syntax error while parsing CBOR number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x62})),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR string: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x62, 0x60})),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR string: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x7F})),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR string: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x7F, 0x60})),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR string: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x82, 0x01})),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR value: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x9F, 0x01})),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR value: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0xBF, 0x61, 0x61, 0xF5})),
- "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing CBOR string: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0xA1, 0x61, 0x61})),
- "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing CBOR value: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0xBF, 0x61, 0x61})),
- "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing CBOR value: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x5F})),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR binary: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x5F, 0x00})),
- "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing CBOR binary: expected length specification (0x40-0x5B) or indefinite binary array type (0x5F); last byte: 0x00");
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x41})),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR binary: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x18})), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x19})), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x19, 0x00})), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1a})), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1a, 0x00})), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1a, 0x00, 0x00})), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1a, 0x00, 0x00, 0x00})), "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b})), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00})), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00})), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00})), "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00, 0x00})), "[json.exception.parse_error.110] parse error at byte 6: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00, 0x00, 0x00})), "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00})), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1b, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00})), "[json.exception.parse_error.110] parse error at byte 9: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x62})), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR string: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x62, 0x60})), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR string: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x7F})), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR string: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x7F, 0x60})), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR string: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x82, 0x01})), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR value: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x9F, 0x01})), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR value: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0xBF, 0x61, 0x61, 0xF5})), "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing CBOR string: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0xA1, 0x61, 0X61})), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing CBOR value: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0xBF, 0x61, 0X61})), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing CBOR value: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x5F})), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR binary: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x5F, 0x00})), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing CBOR binary: expected length specification (0x40-0x5B) or indefinite binary array type (0x5F); last byte: 0x00", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x41})), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR binary: unexpected end of input", json::parse_error&);
CHECK(json::from_cbor(std::vector<uint8_t>({0x18}), true, false).is_discarded());
CHECK(json::from_cbor(std::vector<uint8_t>({0x19}), true, false).is_discarded());
@@ -1797,14 +1715,10 @@
SECTION("concrete examples")
{
json _;
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1c})), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0x1c})),
- "[json.exception.parse_error.112] parse error at byte 1: syntax error while parsing CBOR value: invalid byte: 0x1C");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0x1c})), "[json.exception.parse_error.112] parse error at byte 1: syntax error while parsing CBOR value: invalid byte: 0x1C", json::parse_error&);
CHECK(json::from_cbor(std::vector<uint8_t>({0x1c}), true, false).is_discarded());
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0xf8})), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0xf8})),
- "[json.exception.parse_error.112] parse error at byte 1: syntax error while parsing CBOR value: invalid byte: 0xF8");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0xf8})), "[json.exception.parse_error.112] parse error at byte 1: syntax error while parsing CBOR value: invalid byte: 0xF8", json::parse_error&);
CHECK(json::from_cbor(std::vector<uint8_t>({0xf8}), true, false).is_discarded());
}
@@ -1858,9 +1772,7 @@
SECTION("invalid string in map")
{
json _;
- CHECK_THROWS_AS(_ = json::from_cbor(std::vector<uint8_t>({0xa1, 0xff, 0x01})), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(std::vector<uint8_t>({0xa1, 0xff, 0x01})),
- "[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");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(std::vector<uint8_t>({0xa1, 0xff, 0x01})), "[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", json::parse_error&);
CHECK(json::from_cbor(std::vector<uint8_t>({0xa1, 0xff, 0x01}), true, false).is_discarded());
}
@@ -1877,9 +1789,7 @@
SECTION("strict mode")
{
json _;
- CHECK_THROWS_AS(_ = json::from_cbor(vec), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR value: expected end of input; last byte: 0xF6");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR value: expected end of input; last byte: 0xF6", json::parse_error&);
CHECK(json::from_cbor(vec, true, false).is_discarded());
}
}
@@ -2746,8 +2656,7 @@
// parse error when parsing tagged value
json _;
- CHECK_THROWS_AS(_ = json::from_cbor(vec), json::parse_error);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec), "[json.exception.parse_error.112] parse error at byte 9: syntax error while parsing CBOR value: invalid byte: 0xD8");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec), "[json.exception.parse_error.112] parse error at byte 9: syntax error while parsing CBOR value: invalid byte: 0xD8", json::parse_error);
// binary without subtype when tags are ignored
json jb = json::from_cbor(vec, true, true, json::cbor_tag_handler_t::ignore);
diff --git a/test/src/unit-class_const_iterator.cpp b/tests/src/unit-class_const_iterator.cpp
similarity index 85%
rename from test/src/unit-class_const_iterator.cpp
rename to tests/src/unit-class_const_iterator.cpp
index 33ec857..d5f8b7a 100644
--- a/test/src/unit-class_const_iterator.cpp
+++ b/tests/src/unit-class_const_iterator.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -148,8 +127,7 @@
{
json j(json::value_t::null);
json::const_iterator it = j.cbegin();
- CHECK_THROWS_AS(*it, json::invalid_iterator&);
- CHECK_THROWS_WITH(*it, "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(*it, "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
}
SECTION("number")
@@ -158,8 +136,7 @@
json::const_iterator it = j.cbegin();
CHECK(*it == json(17));
it = j.cend();
- CHECK_THROWS_AS(*it, json::invalid_iterator&);
- CHECK_THROWS_WITH(*it, "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(*it, "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
}
SECTION("object")
@@ -183,8 +160,7 @@
{
json j(json::value_t::null);
json::const_iterator it = j.cbegin();
- CHECK_THROWS_AS(std::string(it->type_name()), json::invalid_iterator&);
- CHECK_THROWS_WITH(std::string(it->type_name()), "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(std::string(it->type_name()), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
}
SECTION("number")
@@ -193,8 +169,7 @@
json::const_iterator it = j.cbegin();
CHECK(std::string(it->type_name()) == "number");
it = j.cend();
- CHECK_THROWS_AS(std::string(it->type_name()), json::invalid_iterator&);
- CHECK_THROWS_WITH(std::string(it->type_name()), "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(std::string(it->type_name()), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
}
SECTION("object")
diff --git a/test/src/unit-class_iterator.cpp b/tests/src/unit-class_iterator.cpp
similarity index 73%
rename from test/src/unit-class_iterator.cpp
rename to tests/src/unit-class_iterator.cpp
index 0e159fc..9cb4ed7 100644
--- a/test/src/unit-class_iterator.cpp
+++ b/tests/src/unit-class_iterator.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -33,6 +12,12 @@
#include <nlohmann/json.hpp>
using nlohmann::json;
+template<typename Iter>
+using can_post_increment_temporary = decltype((std::declval<Iter>()++)++);
+
+template<typename Iter>
+using can_post_decrement_temporary = decltype((std::declval<Iter>()--)--);
+
TEST_CASE("iterator class")
{
SECTION("construction")
@@ -132,8 +117,7 @@
{
json j(json::value_t::null);
json::iterator it = j.begin();
- CHECK_THROWS_AS(*it, json::invalid_iterator&);
- CHECK_THROWS_WITH(*it, "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(*it, "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
}
SECTION("number")
@@ -142,8 +126,7 @@
json::iterator it = j.begin();
CHECK(*it == json(17));
it = j.end();
- CHECK_THROWS_AS(*it, json::invalid_iterator&);
- CHECK_THROWS_WITH(*it, "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(*it, "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
}
SECTION("object")
@@ -167,8 +150,7 @@
{
json j(json::value_t::null);
json::iterator it = j.begin();
- CHECK_THROWS_AS(std::string(it->type_name()), json::invalid_iterator&);
- CHECK_THROWS_WITH(std::string(it->type_name()), "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(std::string(it->type_name()), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
}
SECTION("number")
@@ -177,8 +159,7 @@
json::iterator it = j.begin();
CHECK(std::string(it->type_name()) == "number");
it = j.end();
- CHECK_THROWS_AS(std::string(it->type_name()), json::invalid_iterator&);
- CHECK_THROWS_WITH(std::string(it->type_name()), "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(std::string(it->type_name()), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
}
SECTION("object")
@@ -399,4 +380,89 @@
}
}
}
+ SECTION("equality-preserving")
+ {
+ SECTION("post-increment")
+ {
+ SECTION("primitive_iterator_t")
+ {
+ using Iter = nlohmann::detail::primitive_iterator_t;
+ CHECK(std::is_same < decltype(std::declval<Iter&>()++), Iter >::value);
+ }
+ SECTION("iter_impl")
+ {
+ using Iter = nlohmann::detail::iter_impl<json>;
+ CHECK(std::is_same < decltype(std::declval<Iter&>()++), Iter >::value);
+ }
+ SECTION("json_reverse_iterator")
+ {
+ using Base = nlohmann::detail::iter_impl<json>;
+ using Iter = nlohmann::detail::json_reverse_iterator<Base>;
+ CHECK(std::is_same < decltype(std::declval<Iter&>()++), Iter >::value);
+ }
+ }
+ SECTION("post-decrement")
+ {
+ SECTION("primitive_iterator_t")
+ {
+ using Iter = nlohmann::detail::primitive_iterator_t;
+ CHECK(std::is_same < decltype(std::declval<Iter&>()--), Iter >::value);
+ }
+ SECTION("iter_impl")
+ {
+ using Iter = nlohmann::detail::iter_impl<json>;
+ CHECK(std::is_same < decltype(std::declval<Iter&>()--), Iter >::value );
+ }
+ SECTION("json_reverse_iterator")
+ {
+ using Base = nlohmann::detail::iter_impl<json>;
+ using Iter = nlohmann::detail::json_reverse_iterator<Base>;
+ CHECK(std::is_same < decltype(std::declval<Iter&>()--), Iter >::value );
+ }
+ }
+ }
+ // prevent "accidental mutation of a temporary object"
+ SECTION("cert-dcl21-cpp")
+ {
+ using nlohmann::detail::is_detected;
+ SECTION("post-increment")
+ {
+ SECTION("primitive_iterator_t")
+ {
+ using Iter = nlohmann::detail::primitive_iterator_t;
+ CHECK_FALSE(is_detected<can_post_increment_temporary, Iter&>::value);
+ }
+ SECTION("iter_impl")
+ {
+ using Iter = nlohmann::detail::iter_impl<json>;
+ CHECK_FALSE(is_detected<can_post_increment_temporary, Iter&>::value);
+ }
+ SECTION("json_reverse_iterator")
+ {
+ using Base = nlohmann::detail::iter_impl<json>;
+ using Iter = nlohmann::detail::json_reverse_iterator<Base>;
+ CHECK_FALSE(is_detected<can_post_increment_temporary, Iter&>::value);
+ }
+ }
+ SECTION("post-decrement")
+ {
+ SECTION("primitive_iterator_t")
+ {
+ using Iter = nlohmann::detail::primitive_iterator_t;
+ CHECK_FALSE(is_detected<can_post_decrement_temporary, Iter&>::value);
+ }
+ SECTION("iter_impl")
+ {
+ using Iter = nlohmann::detail::iter_impl<json>;
+ CHECK_FALSE(is_detected<can_post_decrement_temporary, Iter&>::value);
+ }
+ SECTION("json_reverse_iterator")
+ {
+ using Base = nlohmann::detail::iter_impl<json>;
+ using Iter = nlohmann::detail::json_reverse_iterator<Base>;
+ CHECK_FALSE(is_detected<can_post_decrement_temporary, Iter&>::value);
+ }
+
+ }
+ }
}
diff --git a/test/src/unit-class_lexer.cpp b/tests/src/unit-class_lexer.cpp
similarity index 88%
rename from test/src/unit-class_lexer.cpp
rename to tests/src/unit-class_lexer.cpp
index 42050b2..9da0fb6 100644
--- a/test/src/unit-class_lexer.cpp
+++ b/tests/src/unit-class_lexer.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
diff --git a/tests/src/unit-class_parser.cpp b/tests/src/unit-class_parser.cpp
new file mode 100644
index 0000000..df821be
--- /dev/null
+++ b/tests/src/unit-class_parser.cpp
@@ -0,0 +1,1689 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#define JSON_TESTS_PRIVATE
+#include <nlohmann/json.hpp>
+using nlohmann::json;
+using namespace nlohmann::literals; // NOLINT(google-build-using-namespace)
+
+#include <valarray>
+
+namespace
+{
+class SaxEventLogger
+{
+ public:
+ bool null()
+ {
+ events.emplace_back("null()");
+ return true;
+ }
+
+ bool boolean(bool val)
+ {
+ events.emplace_back(val ? "boolean(true)" : "boolean(false)");
+ return true;
+ }
+
+ bool number_integer(json::number_integer_t val)
+ {
+ events.push_back("number_integer(" + std::to_string(val) + ")");
+ return true;
+ }
+
+ bool number_unsigned(json::number_unsigned_t val)
+ {
+ events.push_back("number_unsigned(" + std::to_string(val) + ")");
+ return true;
+ }
+
+ bool number_float(json::number_float_t /*unused*/, const std::string& s)
+ {
+ events.push_back("number_float(" + s + ")");
+ return true;
+ }
+
+ bool string(std::string& val)
+ {
+ events.push_back("string(" + val + ")");
+ return true;
+ }
+
+ bool binary(json::binary_t& val)
+ {
+ std::string binary_contents = "binary(";
+ std::string comma_space;
+ for (auto b : val)
+ {
+ binary_contents.append(comma_space);
+ binary_contents.append(std::to_string(static_cast<int>(b)));
+ comma_space = ", ";
+ }
+ binary_contents.append(")");
+ events.push_back(binary_contents);
+ return true;
+ }
+
+ bool start_object(std::size_t elements)
+ {
+ if (elements == static_cast<std::size_t>(-1))
+ {
+ events.emplace_back("start_object()");
+ }
+ else
+ {
+ events.push_back("start_object(" + std::to_string(elements) + ")");
+ }
+ return true;
+ }
+
+ bool key(std::string& val)
+ {
+ events.push_back("key(" + val + ")");
+ return true;
+ }
+
+ bool end_object()
+ {
+ events.emplace_back("end_object()");
+ return true;
+ }
+
+ bool start_array(std::size_t elements)
+ {
+ if (elements == static_cast<std::size_t>(-1))
+ {
+ events.emplace_back("start_array()");
+ }
+ else
+ {
+ events.push_back("start_array(" + std::to_string(elements) + ")");
+ }
+ return true;
+ }
+
+ bool end_array()
+ {
+ events.emplace_back("end_array()");
+ return true;
+ }
+
+ bool parse_error(std::size_t position, const std::string& /*unused*/, const json::exception& /*unused*/)
+ {
+ errored = true;
+ events.push_back("parse_error(" + std::to_string(position) + ")");
+ return false;
+ }
+
+ std::vector<std::string> events {};
+ bool errored = false;
+};
+
+class SaxCountdown : public nlohmann::json::json_sax_t
+{
+ public:
+ explicit SaxCountdown(const int count) : events_left(count)
+ {}
+
+ bool null() override
+ {
+ return events_left-- > 0;
+ }
+
+ bool boolean(bool /*val*/) override
+ {
+ return events_left-- > 0;
+ }
+
+ bool number_integer(json::number_integer_t /*val*/) override
+ {
+ return events_left-- > 0;
+ }
+
+ bool number_unsigned(json::number_unsigned_t /*val*/) override
+ {
+ return events_left-- > 0;
+ }
+
+ bool number_float(json::number_float_t /*val*/, const std::string& /*s*/) override
+ {
+ return events_left-- > 0;
+ }
+
+ bool string(std::string& /*val*/) override
+ {
+ return events_left-- > 0;
+ }
+
+ bool binary(json::binary_t& /*val*/) override
+ {
+ return events_left-- > 0;
+ }
+
+ bool start_object(std::size_t /*elements*/) override
+ {
+ return events_left-- > 0;
+ }
+
+ bool key(std::string& /*val*/) override
+ {
+ return events_left-- > 0;
+ }
+
+ bool end_object() override
+ {
+ return events_left-- > 0;
+ }
+
+ bool start_array(std::size_t /*elements*/) override
+ {
+ return events_left-- > 0;
+ }
+
+ bool end_array() override
+ {
+ return events_left-- > 0;
+ }
+
+ bool parse_error(std::size_t /*position*/, const std::string& /*last_token*/, const json::exception& /*ex*/) override
+ {
+ return false;
+ }
+
+ private:
+ int events_left = 0;
+};
+
+json parser_helper(const std::string& s);
+bool accept_helper(const std::string& s);
+void comments_helper(const std::string& s);
+
+json parser_helper(const std::string& s)
+{
+ json j;
+ json::parser(nlohmann::detail::input_adapter(s)).parse(true, j);
+
+ // if this line was reached, no exception occurred
+ // -> check if result is the same without exceptions
+ json j_nothrow;
+ CHECK_NOTHROW(json::parser(nlohmann::detail::input_adapter(s), nullptr, false).parse(true, j_nothrow));
+ CHECK(j_nothrow == j);
+
+ json j_sax;
+ nlohmann::detail::json_sax_dom_parser<json> sdp(j_sax);
+ json::sax_parse(s, &sdp);
+ CHECK(j_sax == j);
+
+ comments_helper(s);
+
+ return j;
+}
+
+bool accept_helper(const std::string& s)
+{
+ CAPTURE(s)
+
+ // 1. parse s without exceptions
+ json j;
+ CHECK_NOTHROW(json::parser(nlohmann::detail::input_adapter(s), nullptr, false).parse(true, j));
+ const bool ok_noexcept = !j.is_discarded();
+
+ // 2. accept s
+ const bool ok_accept = json::parser(nlohmann::detail::input_adapter(s)).accept(true);
+
+ // 3. check if both approaches come to the same result
+ CHECK(ok_noexcept == ok_accept);
+
+ // 4. parse with SAX (compare with relaxed accept result)
+ SaxEventLogger el;
+ CHECK_NOTHROW(json::sax_parse(s, &el, json::input_format_t::json, false));
+ CHECK(json::parser(nlohmann::detail::input_adapter(s)).accept(false) == !el.errored);
+
+ // 5. parse with simple callback
+ json::parser_callback_t cb = [](int /*unused*/, json::parse_event_t /*unused*/, json& /*unused*/) noexcept
+ {
+ return true;
+ };
+ json j_cb = json::parse(s, cb, false);
+ const bool ok_noexcept_cb = !j_cb.is_discarded();
+
+ // 6. check if this approach came to the same result
+ CHECK(ok_noexcept == ok_noexcept_cb);
+
+ // 7. check if comments are properly ignored
+ if (ok_accept)
+ {
+ comments_helper(s);
+ }
+
+ // 8. return result
+ return ok_accept;
+}
+
+void comments_helper(const std::string& s)
+{
+ json _;
+
+ // parse/accept with default parser
+ CHECK_NOTHROW(_ = json::parse(s));
+ CHECK(json::accept(s));
+
+ // parse/accept while skipping comments
+ CHECK_NOTHROW(_ = json::parse(s, nullptr, false, true));
+ CHECK(json::accept(s, true));
+
+ std::vector<std::string> json_with_comments;
+
+ // start with a comment
+ json_with_comments.push_back(std::string("// this is a comment\n") + s);
+ json_with_comments.push_back(std::string("/* this is a comment */") + s);
+ // end with a comment
+ json_with_comments.push_back(s + "// this is a comment");
+ json_with_comments.push_back(s + "/* this is a comment */");
+
+ // check all strings
+ for (const auto& json_with_comment : json_with_comments)
+ {
+ CAPTURE(json_with_comment)
+ CHECK_THROWS_AS(_ = json::parse(json_with_comment), json::parse_error);
+ CHECK(!json::accept(json_with_comment));
+
+ CHECK_NOTHROW(_ = json::parse(json_with_comment, nullptr, true, true));
+ CHECK(json::accept(json_with_comment, true));
+ }
+}
+
+} // namespace
+
+TEST_CASE("parser class")
+{
+ SECTION("parse")
+ {
+ SECTION("null")
+ {
+ CHECK(parser_helper("null") == json(nullptr));
+ }
+
+ SECTION("true")
+ {
+ CHECK(parser_helper("true") == json(true));
+ }
+
+ SECTION("false")
+ {
+ CHECK(parser_helper("false") == json(false));
+ }
+
+ SECTION("array")
+ {
+ SECTION("empty array")
+ {
+ CHECK(parser_helper("[]") == json(json::value_t::array));
+ CHECK(parser_helper("[ ]") == json(json::value_t::array));
+ }
+
+ SECTION("nonempty array")
+ {
+ CHECK(parser_helper("[true, false, null]") == json({true, false, nullptr}));
+ }
+ }
+
+ SECTION("object")
+ {
+ SECTION("empty object")
+ {
+ CHECK(parser_helper("{}") == json(json::value_t::object));
+ CHECK(parser_helper("{ }") == json(json::value_t::object));
+ }
+
+ SECTION("nonempty object")
+ {
+ CHECK(parser_helper("{\"\": true, \"one\": 1, \"two\": null}") == json({{"", true}, {"one", 1}, {"two", nullptr}}));
+ }
+ }
+
+ SECTION("string")
+ {
+ // empty string
+ CHECK(parser_helper("\"\"") == json(json::value_t::string));
+
+ SECTION("errors")
+ {
+ // error: tab in string
+ CHECK_THROWS_WITH_AS(parser_helper("\"\t\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0009 (HT) must be escaped to \\u0009 or \\t; last read: '\"<U+0009>'", json::parse_error&);
+ // error: newline in string
+ CHECK_THROWS_WITH_AS(parser_helper("\"\n\""), "[json.exception.parse_error.101] parse error at line 2, column 0: syntax error while parsing value - invalid string: control character U+000A (LF) must be escaped to \\u000A or \\n; last read: '\"<U+000A>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\r\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+000D (CR) must be escaped to \\u000D or \\r; last read: '\"<U+000D>'", json::parse_error&);
+ // error: backspace in string
+ CHECK_THROWS_WITH_AS(parser_helper("\"\b\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0008 (BS) must be escaped to \\u0008 or \\b; last read: '\"<U+0008>'", json::parse_error&);
+ // improve code coverage
+ CHECK_THROWS_AS(parser_helper("\uFF01"), json::parse_error&);
+ CHECK_THROWS_AS(parser_helper("[-4:1,]"), json::parse_error&);
+ // unescaped control characters
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x00\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: missing closing quote; last read: '\"'", json::parse_error&); // NOLINT(bugprone-string-literal-with-embedded-nul)
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x01\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0001 (SOH) must be escaped to \\u0001; last read: '\"<U+0001>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x02\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0002 (STX) must be escaped to \\u0002; last read: '\"<U+0002>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x03\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0003 (ETX) must be escaped to \\u0003; last read: '\"<U+0003>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x04\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0004 (EOT) must be escaped to \\u0004; last read: '\"<U+0004>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x05\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0005 (ENQ) must be escaped to \\u0005; last read: '\"<U+0005>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x06\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0006 (ACK) must be escaped to \\u0006; last read: '\"<U+0006>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x07\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0007 (BEL) must be escaped to \\u0007; last read: '\"<U+0007>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x08\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0008 (BS) must be escaped to \\u0008 or \\b; last read: '\"<U+0008>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x09\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0009 (HT) must be escaped to \\u0009 or \\t; last read: '\"<U+0009>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x0a\""), "[json.exception.parse_error.101] parse error at line 2, column 0: syntax error while parsing value - invalid string: control character U+000A (LF) must be escaped to \\u000A or \\n; last read: '\"<U+000A>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x0b\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+000B (VT) must be escaped to \\u000B; last read: '\"<U+000B>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x0c\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+000C (FF) must be escaped to \\u000C or \\f; last read: '\"<U+000C>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x0d\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+000D (CR) must be escaped to \\u000D or \\r; last read: '\"<U+000D>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x0e\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+000E (SO) must be escaped to \\u000E; last read: '\"<U+000E>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x0f\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+000F (SI) must be escaped to \\u000F; last read: '\"<U+000F>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x10\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0010 (DLE) must be escaped to \\u0010; last read: '\"<U+0010>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x11\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0011 (DC1) must be escaped to \\u0011; last read: '\"<U+0011>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x12\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0012 (DC2) must be escaped to \\u0012; last read: '\"<U+0012>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x13\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0013 (DC3) must be escaped to \\u0013; last read: '\"<U+0013>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x14\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0014 (DC4) must be escaped to \\u0014; last read: '\"<U+0014>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x15\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0015 (NAK) must be escaped to \\u0015; last read: '\"<U+0015>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x16\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0016 (SYN) must be escaped to \\u0016; last read: '\"<U+0016>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x17\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0017 (ETB) must be escaped to \\u0017; last read: '\"<U+0017>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x18\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0018 (CAN) must be escaped to \\u0018; last read: '\"<U+0018>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x19\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0019 (EM) must be escaped to \\u0019; last read: '\"<U+0019>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x1a\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+001A (SUB) must be escaped to \\u001A; last read: '\"<U+001A>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x1b\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+001B (ESC) must be escaped to \\u001B; last read: '\"<U+001B>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x1c\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+001C (FS) must be escaped to \\u001C; last read: '\"<U+001C>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x1d\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+001D (GS) must be escaped to \\u001D; last read: '\"<U+001D>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x1e\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+001E (RS) must be escaped to \\u001E; last read: '\"<U+001E>'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\x1f\""), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+001F (US) must be escaped to \\u001F; last read: '\"<U+001F>'", json::parse_error&);
+
+ SECTION("additional test for null byte")
+ {
+ // The test above for the null byte is wrong, because passing
+ // a string to the parser only reads int until it encounters
+ // a null byte. This test inserts the null byte later on and
+ // uses an iterator range.
+ std::string s = "\"1\"";
+ s[1] = '\0';
+ json _;
+ CHECK_THROWS_WITH_AS(_ = json::parse(s.begin(), s.end()), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: control character U+0000 (NUL) must be escaped to \\u0000; last read: '\"<U+0000>'", json::parse_error&);
+ }
+ }
+
+ SECTION("escaped")
+ {
+ // quotation mark "\""
+ auto r1 = R"("\"")"_json;
+ CHECK(parser_helper("\"\\\"\"") == r1);
+ // reverse solidus "\\"
+ auto r2 = R"("\\")"_json;
+ CHECK(parser_helper("\"\\\\\"") == r2);
+ // solidus
+ CHECK(parser_helper("\"\\/\"") == R"("/")"_json);
+ // backspace
+ CHECK(parser_helper("\"\\b\"") == json("\b"));
+ // formfeed
+ CHECK(parser_helper("\"\\f\"") == json("\f"));
+ // newline
+ CHECK(parser_helper("\"\\n\"") == json("\n"));
+ // carriage return
+ CHECK(parser_helper("\"\\r\"") == json("\r"));
+ // horizontal tab
+ CHECK(parser_helper("\"\\t\"") == json("\t"));
+
+ CHECK(parser_helper("\"\\u0001\"").get<json::string_t>() == "\x01");
+ CHECK(parser_helper("\"\\u000a\"").get<json::string_t>() == "\n");
+ CHECK(parser_helper("\"\\u00b0\"").get<json::string_t>() == "°");
+ CHECK(parser_helper("\"\\u0c00\"").get<json::string_t>() == "ā°");
+ CHECK(parser_helper("\"\\ud000\"").get<json::string_t>() == "í");
+ CHECK(parser_helper("\"\\u000E\"").get<json::string_t>() == "\x0E");
+ CHECK(parser_helper("\"\\u00F0\"").get<json::string_t>() == "ð");
+ CHECK(parser_helper("\"\\u0100\"").get<json::string_t>() == "Ä");
+ CHECK(parser_helper("\"\\u2000\"").get<json::string_t>() == "â");
+ CHECK(parser_helper("\"\\uFFFF\"").get<json::string_t>() == "īŋŋ");
+ CHECK(parser_helper("\"\\u20AC\"").get<json::string_t>() == "€");
+ CHECK(parser_helper("\"€\"").get<json::string_t>() == "€");
+ CHECK(parser_helper("\"đ\"").get<json::string_t>() == "đ");
+
+ CHECK(parser_helper("\"\\ud80c\\udc60\"").get<json::string_t>() == "\xf0\x93\x81\xa0");
+ CHECK(parser_helper("\"\\ud83c\\udf1e\"").get<json::string_t>() == "đ");
+ }
+ }
+
+ SECTION("number")
+ {
+ SECTION("integers")
+ {
+ SECTION("without exponent")
+ {
+ CHECK(parser_helper("-128") == json(-128));
+ CHECK(parser_helper("-0") == json(-0));
+ CHECK(parser_helper("0") == json(0));
+ CHECK(parser_helper("128") == json(128));
+ }
+
+ SECTION("with exponent")
+ {
+ CHECK(parser_helper("0e1") == json(0e1));
+ CHECK(parser_helper("0E1") == json(0e1));
+
+ CHECK(parser_helper("10000E-4") == json(10000e-4));
+ CHECK(parser_helper("10000E-3") == json(10000e-3));
+ CHECK(parser_helper("10000E-2") == json(10000e-2));
+ CHECK(parser_helper("10000E-1") == json(10000e-1));
+ CHECK(parser_helper("10000E0") == json(10000e0));
+ CHECK(parser_helper("10000E1") == json(10000e1));
+ CHECK(parser_helper("10000E2") == json(10000e2));
+ CHECK(parser_helper("10000E3") == json(10000e3));
+ CHECK(parser_helper("10000E4") == json(10000e4));
+
+ CHECK(parser_helper("10000e-4") == json(10000e-4));
+ CHECK(parser_helper("10000e-3") == json(10000e-3));
+ CHECK(parser_helper("10000e-2") == json(10000e-2));
+ CHECK(parser_helper("10000e-1") == json(10000e-1));
+ CHECK(parser_helper("10000e0") == json(10000e0));
+ CHECK(parser_helper("10000e1") == json(10000e1));
+ CHECK(parser_helper("10000e2") == json(10000e2));
+ CHECK(parser_helper("10000e3") == json(10000e3));
+ CHECK(parser_helper("10000e4") == json(10000e4));
+
+ CHECK(parser_helper("-0e1") == json(-0e1));
+ CHECK(parser_helper("-0E1") == json(-0e1));
+ CHECK(parser_helper("-0E123") == json(-0e123));
+
+ // numbers after exponent
+ CHECK(parser_helper("10E0") == json(10e0));
+ CHECK(parser_helper("10E1") == json(10e1));
+ CHECK(parser_helper("10E2") == json(10e2));
+ CHECK(parser_helper("10E3") == json(10e3));
+ CHECK(parser_helper("10E4") == json(10e4));
+ CHECK(parser_helper("10E5") == json(10e5));
+ CHECK(parser_helper("10E6") == json(10e6));
+ CHECK(parser_helper("10E7") == json(10e7));
+ CHECK(parser_helper("10E8") == json(10e8));
+ CHECK(parser_helper("10E9") == json(10e9));
+ CHECK(parser_helper("10E+0") == json(10e0));
+ CHECK(parser_helper("10E+1") == json(10e1));
+ CHECK(parser_helper("10E+2") == json(10e2));
+ CHECK(parser_helper("10E+3") == json(10e3));
+ CHECK(parser_helper("10E+4") == json(10e4));
+ CHECK(parser_helper("10E+5") == json(10e5));
+ CHECK(parser_helper("10E+6") == json(10e6));
+ CHECK(parser_helper("10E+7") == json(10e7));
+ CHECK(parser_helper("10E+8") == json(10e8));
+ CHECK(parser_helper("10E+9") == json(10e9));
+ CHECK(parser_helper("10E-1") == json(10e-1));
+ CHECK(parser_helper("10E-2") == json(10e-2));
+ CHECK(parser_helper("10E-3") == json(10e-3));
+ CHECK(parser_helper("10E-4") == json(10e-4));
+ CHECK(parser_helper("10E-5") == json(10e-5));
+ CHECK(parser_helper("10E-6") == json(10e-6));
+ CHECK(parser_helper("10E-7") == json(10e-7));
+ CHECK(parser_helper("10E-8") == json(10e-8));
+ CHECK(parser_helper("10E-9") == json(10e-9));
+ }
+
+ SECTION("edge cases")
+ {
+ // From RFC8259, Section 6:
+ // Note that when such software is used, numbers that are
+ // integers and are in the range [-(2**53)+1, (2**53)-1]
+ // are interoperable in the sense that implementations will
+ // agree exactly on their numeric values.
+
+ // -(2**53)+1
+ CHECK(parser_helper("-9007199254740991").get<int64_t>() == -9007199254740991);
+ // (2**53)-1
+ CHECK(parser_helper("9007199254740991").get<int64_t>() == 9007199254740991);
+ }
+
+ SECTION("over the edge cases") // issue #178 - Integer conversion to unsigned (incorrect handling of 64 bit integers)
+ {
+ // While RFC8259, Section 6 specifies a preference for support
+ // for ranges in range of IEEE 754-2008 binary64 (double precision)
+ // this does not accommodate 64 bit integers without loss of accuracy.
+ // As 64 bit integers are now widely used in software, it is desirable
+ // to expand support to to the full 64 bit (signed and unsigned) range
+ // i.e. -(2**63) -> (2**64)-1.
+
+ // -(2**63) ** Note: compilers see negative literals as negated positive numbers (hence the -1))
+ CHECK(parser_helper("-9223372036854775808").get<int64_t>() == -9223372036854775807 - 1);
+ // (2**63)-1
+ CHECK(parser_helper("9223372036854775807").get<int64_t>() == 9223372036854775807);
+ // (2**64)-1
+ CHECK(parser_helper("18446744073709551615").get<uint64_t>() == 18446744073709551615u);
+ }
+ }
+
+ SECTION("floating-point")
+ {
+ SECTION("without exponent")
+ {
+ CHECK(parser_helper("-128.5") == json(-128.5));
+ CHECK(parser_helper("0.999") == json(0.999));
+ CHECK(parser_helper("128.5") == json(128.5));
+ CHECK(parser_helper("-0.0") == json(-0.0));
+ }
+
+ SECTION("with exponent")
+ {
+ CHECK(parser_helper("-128.5E3") == json(-128.5E3));
+ CHECK(parser_helper("-128.5E-3") == json(-128.5E-3));
+ CHECK(parser_helper("-0.0e1") == json(-0.0e1));
+ CHECK(parser_helper("-0.0E1") == json(-0.0e1));
+ }
+ }
+
+ SECTION("overflow")
+ {
+ // overflows during parsing yield an exception
+ CHECK_THROWS_WITH_AS(parser_helper("1.18973e+4932").empty(), "[json.exception.out_of_range.406] number overflow parsing '1.18973e+4932'", json::out_of_range&);
+ }
+
+ SECTION("invalid numbers")
+ {
+ // numbers must not begin with "+"
+ CHECK_THROWS_AS(parser_helper("+1"), json::parse_error&);
+ CHECK_THROWS_AS(parser_helper("+0"), json::parse_error&);
+
+ CHECK_THROWS_WITH_AS(parser_helper("01"),
+ "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - unexpected number literal; expected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-01"),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - unexpected number literal; expected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("--1"),
+ "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid number; expected digit after '-'; last read: '--'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("1."),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected digit after '.'; last read: '1.'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("1E"),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '1E'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("1E-"),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid number; expected digit after exponent sign; last read: '1E-'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("1.E1"),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected digit after '.'; last read: '1.E'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-1E"),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '-1E'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-0E#"),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '-0E#'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-0E-#"),
+ "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid number; expected digit after exponent sign; last read: '-0E-#'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-0#"),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid literal; last read: '-0#'; expected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-0.0:"),
+ "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - unexpected ':'; expected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-0.0Z"),
+ "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid literal; last read: '-0.0Z'; expected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-0E123:"),
+ "[json.exception.parse_error.101] parse error at line 1, column 7: syntax error while parsing value - unexpected ':'; expected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-0e0-:"),
+ "[json.exception.parse_error.101] parse error at line 1, column 6: syntax error while parsing value - invalid number; expected digit after '-'; last read: '-:'; expected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-0e-:"),
+ "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid number; expected digit after exponent sign; last read: '-0e-:'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-0f"),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: '-0f'; expected end of input", json::parse_error&);
+ }
+ }
+ }
+
+ SECTION("accept")
+ {
+ SECTION("null")
+ {
+ CHECK(accept_helper("null"));
+ }
+
+ SECTION("true")
+ {
+ CHECK(accept_helper("true"));
+ }
+
+ SECTION("false")
+ {
+ CHECK(accept_helper("false"));
+ }
+
+ SECTION("array")
+ {
+ SECTION("empty array")
+ {
+ CHECK(accept_helper("[]"));
+ CHECK(accept_helper("[ ]"));
+ }
+
+ SECTION("nonempty array")
+ {
+ CHECK(accept_helper("[true, false, null]"));
+ }
+ }
+
+ SECTION("object")
+ {
+ SECTION("empty object")
+ {
+ CHECK(accept_helper("{}"));
+ CHECK(accept_helper("{ }"));
+ }
+
+ SECTION("nonempty object")
+ {
+ CHECK(accept_helper("{\"\": true, \"one\": 1, \"two\": null}"));
+ }
+ }
+
+ SECTION("string")
+ {
+ // empty string
+ CHECK(accept_helper("\"\""));
+
+ SECTION("errors")
+ {
+ // error: tab in string
+ CHECK(accept_helper("\"\t\"") == false);
+ // error: newline in string
+ CHECK(accept_helper("\"\n\"") == false);
+ CHECK(accept_helper("\"\r\"") == false);
+ // error: backspace in string
+ CHECK(accept_helper("\"\b\"") == false);
+ // improve code coverage
+ CHECK(accept_helper("\uFF01") == false);
+ CHECK(accept_helper("[-4:1,]") == false);
+ // unescaped control characters
+ CHECK(accept_helper("\"\x00\"") == false); // NOLINT(bugprone-string-literal-with-embedded-nul)
+ CHECK(accept_helper("\"\x01\"") == false);
+ CHECK(accept_helper("\"\x02\"") == false);
+ CHECK(accept_helper("\"\x03\"") == false);
+ CHECK(accept_helper("\"\x04\"") == false);
+ CHECK(accept_helper("\"\x05\"") == false);
+ CHECK(accept_helper("\"\x06\"") == false);
+ CHECK(accept_helper("\"\x07\"") == false);
+ CHECK(accept_helper("\"\x08\"") == false);
+ CHECK(accept_helper("\"\x09\"") == false);
+ CHECK(accept_helper("\"\x0a\"") == false);
+ CHECK(accept_helper("\"\x0b\"") == false);
+ CHECK(accept_helper("\"\x0c\"") == false);
+ CHECK(accept_helper("\"\x0d\"") == false);
+ CHECK(accept_helper("\"\x0e\"") == false);
+ CHECK(accept_helper("\"\x0f\"") == false);
+ CHECK(accept_helper("\"\x10\"") == false);
+ CHECK(accept_helper("\"\x11\"") == false);
+ CHECK(accept_helper("\"\x12\"") == false);
+ CHECK(accept_helper("\"\x13\"") == false);
+ CHECK(accept_helper("\"\x14\"") == false);
+ CHECK(accept_helper("\"\x15\"") == false);
+ CHECK(accept_helper("\"\x16\"") == false);
+ CHECK(accept_helper("\"\x17\"") == false);
+ CHECK(accept_helper("\"\x18\"") == false);
+ CHECK(accept_helper("\"\x19\"") == false);
+ CHECK(accept_helper("\"\x1a\"") == false);
+ CHECK(accept_helper("\"\x1b\"") == false);
+ CHECK(accept_helper("\"\x1c\"") == false);
+ CHECK(accept_helper("\"\x1d\"") == false);
+ CHECK(accept_helper("\"\x1e\"") == false);
+ CHECK(accept_helper("\"\x1f\"") == false);
+ }
+
+ SECTION("escaped")
+ {
+ // quotation mark "\""
+ auto r1 = R"("\"")"_json;
+ CHECK(accept_helper("\"\\\"\""));
+ // reverse solidus "\\"
+ auto r2 = R"("\\")"_json;
+ CHECK(accept_helper("\"\\\\\""));
+ // solidus
+ CHECK(accept_helper("\"\\/\""));
+ // backspace
+ CHECK(accept_helper("\"\\b\""));
+ // formfeed
+ CHECK(accept_helper("\"\\f\""));
+ // newline
+ CHECK(accept_helper("\"\\n\""));
+ // carriage return
+ CHECK(accept_helper("\"\\r\""));
+ // horizontal tab
+ CHECK(accept_helper("\"\\t\""));
+
+ CHECK(accept_helper("\"\\u0001\""));
+ CHECK(accept_helper("\"\\u000a\""));
+ CHECK(accept_helper("\"\\u00b0\""));
+ CHECK(accept_helper("\"\\u0c00\""));
+ CHECK(accept_helper("\"\\ud000\""));
+ CHECK(accept_helper("\"\\u000E\""));
+ CHECK(accept_helper("\"\\u00F0\""));
+ CHECK(accept_helper("\"\\u0100\""));
+ CHECK(accept_helper("\"\\u2000\""));
+ CHECK(accept_helper("\"\\uFFFF\""));
+ CHECK(accept_helper("\"\\u20AC\""));
+ CHECK(accept_helper("\"€\""));
+ CHECK(accept_helper("\"đ\""));
+
+ CHECK(accept_helper("\"\\ud80c\\udc60\""));
+ CHECK(accept_helper("\"\\ud83c\\udf1e\""));
+ }
+ }
+
+ SECTION("number")
+ {
+ SECTION("integers")
+ {
+ SECTION("without exponent")
+ {
+ CHECK(accept_helper("-128"));
+ CHECK(accept_helper("-0"));
+ CHECK(accept_helper("0"));
+ CHECK(accept_helper("128"));
+ }
+
+ SECTION("with exponent")
+ {
+ CHECK(accept_helper("0e1"));
+ CHECK(accept_helper("0E1"));
+
+ CHECK(accept_helper("10000E-4"));
+ CHECK(accept_helper("10000E-3"));
+ CHECK(accept_helper("10000E-2"));
+ CHECK(accept_helper("10000E-1"));
+ CHECK(accept_helper("10000E0"));
+ CHECK(accept_helper("10000E1"));
+ CHECK(accept_helper("10000E2"));
+ CHECK(accept_helper("10000E3"));
+ CHECK(accept_helper("10000E4"));
+
+ CHECK(accept_helper("10000e-4"));
+ CHECK(accept_helper("10000e-3"));
+ CHECK(accept_helper("10000e-2"));
+ CHECK(accept_helper("10000e-1"));
+ CHECK(accept_helper("10000e0"));
+ CHECK(accept_helper("10000e1"));
+ CHECK(accept_helper("10000e2"));
+ CHECK(accept_helper("10000e3"));
+ CHECK(accept_helper("10000e4"));
+
+ CHECK(accept_helper("-0e1"));
+ CHECK(accept_helper("-0E1"));
+ CHECK(accept_helper("-0E123"));
+ }
+
+ SECTION("edge cases")
+ {
+ // From RFC8259, Section 6:
+ // Note that when such software is used, numbers that are
+ // integers and are in the range [-(2**53)+1, (2**53)-1]
+ // are interoperable in the sense that implementations will
+ // agree exactly on their numeric values.
+
+ // -(2**53)+1
+ CHECK(accept_helper("-9007199254740991"));
+ // (2**53)-1
+ CHECK(accept_helper("9007199254740991"));
+ }
+
+ SECTION("over the edge cases") // issue #178 - Integer conversion to unsigned (incorrect handling of 64 bit integers)
+ {
+ // While RFC8259, Section 6 specifies a preference for support
+ // for ranges in range of IEEE 754-2008 binary64 (double precision)
+ // this does not accommodate 64 bit integers without loss of accuracy.
+ // As 64 bit integers are now widely used in software, it is desirable
+ // to expand support to to the full 64 bit (signed and unsigned) range
+ // i.e. -(2**63) -> (2**64)-1.
+
+ // -(2**63) ** Note: compilers see negative literals as negated positive numbers (hence the -1))
+ CHECK(accept_helper("-9223372036854775808"));
+ // (2**63)-1
+ CHECK(accept_helper("9223372036854775807"));
+ // (2**64)-1
+ CHECK(accept_helper("18446744073709551615"));
+ }
+ }
+
+ SECTION("floating-point")
+ {
+ SECTION("without exponent")
+ {
+ CHECK(accept_helper("-128.5"));
+ CHECK(accept_helper("0.999"));
+ CHECK(accept_helper("128.5"));
+ CHECK(accept_helper("-0.0"));
+ }
+
+ SECTION("with exponent")
+ {
+ CHECK(accept_helper("-128.5E3"));
+ CHECK(accept_helper("-128.5E-3"));
+ CHECK(accept_helper("-0.0e1"));
+ CHECK(accept_helper("-0.0E1"));
+ }
+ }
+
+ SECTION("overflow")
+ {
+ // overflows during parsing
+ CHECK(!accept_helper("1.18973e+4932"));
+ }
+
+ SECTION("invalid numbers")
+ {
+ CHECK(accept_helper("01") == false);
+ CHECK(accept_helper("--1") == false);
+ CHECK(accept_helper("1.") == false);
+ CHECK(accept_helper("1E") == false);
+ CHECK(accept_helper("1E-") == false);
+ CHECK(accept_helper("1.E1") == false);
+ CHECK(accept_helper("-1E") == false);
+ CHECK(accept_helper("-0E#") == false);
+ CHECK(accept_helper("-0E-#") == false);
+ CHECK(accept_helper("-0#") == false);
+ CHECK(accept_helper("-0.0:") == false);
+ CHECK(accept_helper("-0.0Z") == false);
+ CHECK(accept_helper("-0E123:") == false);
+ CHECK(accept_helper("-0e0-:") == false);
+ CHECK(accept_helper("-0e-:") == false);
+ CHECK(accept_helper("-0f") == false);
+
+ // numbers must not begin with "+"
+ CHECK(accept_helper("+1") == false);
+ CHECK(accept_helper("+0") == false);
+ }
+ }
+ }
+
+ SECTION("parse errors")
+ {
+ // unexpected end of number
+ CHECK_THROWS_WITH_AS(parser_helper("0."),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected digit after '.'; last read: '0.'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-"),
+ "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid number; expected digit after '-'; last read: '-'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("--"),
+ "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid number; expected digit after '-'; last read: '--'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-0."),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid number; expected digit after '.'; last read: '-0.'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-."),
+ "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid number; expected digit after '-'; last read: '-.'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("-:"),
+ "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid number; expected digit after '-'; last read: '-:'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("0.:"),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected digit after '.'; last read: '0.:'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("e."),
+ "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - invalid literal; last read: 'e'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("1e."),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '1e.'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("1e/"),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '1e/'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("1e:"),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '1e:'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("1E."),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '1E.'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("1E/"),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '1E/'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("1E:"),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid number; expected '+', '-', or digit after exponent; last read: '1E:'", json::parse_error&);
+
+ // unexpected end of null
+ CHECK_THROWS_WITH_AS(parser_helper("n"),
+ "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid literal; last read: 'n'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("nu"),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid literal; last read: 'nu'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("nul"),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: 'nul'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("nulk"),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: 'nulk'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("nulm"),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: 'nulm'", json::parse_error&);
+
+ // unexpected end of true
+ CHECK_THROWS_WITH_AS(parser_helper("t"),
+ "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid literal; last read: 't'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("tr"),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid literal; last read: 'tr'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("tru"),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: 'tru'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("trud"),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: 'trud'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("truf"),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: 'truf'", json::parse_error&);
+
+ // unexpected end of false
+ CHECK_THROWS_WITH_AS(parser_helper("f"),
+ "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid literal; last read: 'f'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("fa"),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid literal; last read: 'fa'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("fal"),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid literal; last read: 'fal'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("fals"),
+ "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid literal; last read: 'fals'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("falsd"),
+ "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid literal; last read: 'falsd'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("falsf"),
+ "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid literal; last read: 'falsf'", json::parse_error&);
+
+ // missing/unexpected end of array
+ CHECK_THROWS_WITH_AS(parser_helper("["),
+ "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("[1"),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing array - unexpected end of input; expected ']'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("[1,"),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("[1,]"),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - unexpected ']'; expected '[', '{', or a literal", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("]"),
+ "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected ']'; expected '[', '{', or a literal", json::parse_error&);
+
+ // missing/unexpected end of object
+ CHECK_THROWS_WITH_AS(parser_helper("{"),
+ "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing object key - unexpected end of input; expected string literal", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("{\"foo\""),
+ "[json.exception.parse_error.101] parse error at line 1, column 7: syntax error while parsing object separator - unexpected end of input; expected ':'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("{\"foo\":"),
+ "[json.exception.parse_error.101] parse error at line 1, column 8: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("{\"foo\":}"),
+ "[json.exception.parse_error.101] parse error at line 1, column 8: syntax error while parsing value - unexpected '}'; expected '[', '{', or a literal", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("{\"foo\":1,}"),
+ "[json.exception.parse_error.101] parse error at line 1, column 10: syntax error while parsing object key - unexpected '}'; expected string literal", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("}"),
+ "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected '}'; expected '[', '{', or a literal", json::parse_error&);
+
+ // missing/unexpected end of string
+ CHECK_THROWS_WITH_AS(parser_helper("\""),
+ "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid string: missing closing quote; last read: '\"'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\\\""),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid string: missing closing quote; last read: '\"\\\"'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\\u\""),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u\"'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\\u0\""),
+ "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u0\"'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\\u01\""),
+ "[json.exception.parse_error.101] parse error at line 1, column 6: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u01\"'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\\u012\""),
+ "[json.exception.parse_error.101] parse error at line 1, column 7: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u012\"'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\\u"),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\\u0"),
+ "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u0'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\\u01"),
+ "[json.exception.parse_error.101] parse error at line 1, column 6: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u01'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(parser_helper("\"\\u012"),
+ "[json.exception.parse_error.101] parse error at line 1, column 7: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\u012'", json::parse_error&);
+
+ // invalid escapes
+ for (int c = 1; c < 128; ++c)
+ {
+ auto s = std::string("\"\\") + std::string(1, static_cast<char>(c)) + "\"";
+
+ switch (c)
+ {
+ // valid escapes
+ case ('"'):
+ case ('\\'):
+ case ('/'):
+ case ('b'):
+ case ('f'):
+ case ('n'):
+ case ('r'):
+ case ('t'):
+ {
+ CHECK_NOTHROW(parser_helper(s));
+ break;
+ }
+
+ // \u must be followed with four numbers, so we skip it here
+ case ('u'):
+ {
+ break;
+ }
+
+ // any other combination of backslash and character is invalid
+ default:
+ {
+ CHECK_THROWS_AS(parser_helper(s), json::parse_error&);
+ // only check error message if c is not a control character
+ if (c > 0x1f)
+ {
+ CHECK_THROWS_WITH_STD_STR(parser_helper(s),
+ "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid string: forbidden character after backslash; last read: '\"\\" + std::string(1, static_cast<char>(c)) + "'");
+ }
+ break;
+ }
+ }
+ }
+
+ // invalid \uxxxx escapes
+ {
+ // check whether character is a valid hex character
+ const auto valid = [](int c)
+ {
+ switch (c)
+ {
+ case ('0'):
+ case ('1'):
+ case ('2'):
+ case ('3'):
+ case ('4'):
+ case ('5'):
+ case ('6'):
+ case ('7'):
+ case ('8'):
+ case ('9'):
+ case ('a'):
+ case ('b'):
+ case ('c'):
+ case ('d'):
+ case ('e'):
+ case ('f'):
+ case ('A'):
+ case ('B'):
+ case ('C'):
+ case ('D'):
+ case ('E'):
+ case ('F'):
+ {
+ return true;
+ }
+
+ default:
+ {
+ return false;
+ }
+ }
+ };
+
+ for (int c = 1; c < 128; ++c)
+ {
+ std::string s = "\"\\u";
+
+ // create a string with the iterated character at each position
+ auto s1 = s + "000" + std::string(1, static_cast<char>(c)) + "\"";
+ auto s2 = s + "00" + std::string(1, static_cast<char>(c)) + "0\"";
+ auto s3 = s + "0" + std::string(1, static_cast<char>(c)) + "00\"";
+ auto s4 = s + std::string(1, static_cast<char>(c)) + "000\"";
+
+ if (valid(c))
+ {
+ CAPTURE(s1)
+ CHECK_NOTHROW(parser_helper(s1));
+ CAPTURE(s2)
+ CHECK_NOTHROW(parser_helper(s2));
+ CAPTURE(s3)
+ CHECK_NOTHROW(parser_helper(s3));
+ CAPTURE(s4)
+ CHECK_NOTHROW(parser_helper(s4));
+ }
+ else
+ {
+ CAPTURE(s1)
+ CHECK_THROWS_AS(parser_helper(s1), json::parse_error&);
+ // only check error message if c is not a control character
+ if (c > 0x1f)
+ {
+ CHECK_THROWS_WITH_STD_STR(parser_helper(s1),
+ "[json.exception.parse_error.101] parse error at line 1, column 7: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '" + s1.substr(0, 7) + "'");
+ }
+
+ CAPTURE(s2)
+ CHECK_THROWS_AS(parser_helper(s2), json::parse_error&);
+ // only check error message if c is not a control character
+ if (c > 0x1f)
+ {
+ CHECK_THROWS_WITH_STD_STR(parser_helper(s2),
+ "[json.exception.parse_error.101] parse error at line 1, column 6: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '" + s2.substr(0, 6) + "'");
+ }
+
+ CAPTURE(s3)
+ CHECK_THROWS_AS(parser_helper(s3), json::parse_error&);
+ // only check error message if c is not a control character
+ if (c > 0x1f)
+ {
+ CHECK_THROWS_WITH_STD_STR(parser_helper(s3),
+ "[json.exception.parse_error.101] parse error at line 1, column 5: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '" + s3.substr(0, 5) + "'");
+ }
+
+ CAPTURE(s4)
+ CHECK_THROWS_AS(parser_helper(s4), json::parse_error&);
+ // only check error message if c is not a control character
+ if (c > 0x1f)
+ {
+ CHECK_THROWS_WITH_STD_STR(parser_helper(s4),
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '" + s4.substr(0, 4) + "'");
+ }
+ }
+ }
+ }
+
+ json _;
+
+ // missing part of a surrogate pair
+ CHECK_THROWS_WITH_AS(_ = json::parse("\"\\uD80C\""), "[json.exception.parse_error.101] parse error at line 1, column 8: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD80C\"'", json::parse_error&);
+ // invalid surrogate pair
+ CHECK_THROWS_WITH_AS(_ = json::parse("\"\\uD80C\\uD80C\""),
+ "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD80C\\uD80C'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::parse("\"\\uD80C\\u0000\""),
+ "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD80C\\u0000'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::parse("\"\\uD80C\\uFFFF\""),
+ "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD80C\\uFFFF'", json::parse_error&);
+ }
+
+ SECTION("parse errors (accept)")
+ {
+ // unexpected end of number
+ CHECK(accept_helper("0.") == false);
+ CHECK(accept_helper("-") == false);
+ CHECK(accept_helper("--") == false);
+ CHECK(accept_helper("-0.") == false);
+ CHECK(accept_helper("-.") == false);
+ CHECK(accept_helper("-:") == false);
+ CHECK(accept_helper("0.:") == false);
+ CHECK(accept_helper("e.") == false);
+ CHECK(accept_helper("1e.") == false);
+ CHECK(accept_helper("1e/") == false);
+ CHECK(accept_helper("1e:") == false);
+ CHECK(accept_helper("1E.") == false);
+ CHECK(accept_helper("1E/") == false);
+ CHECK(accept_helper("1E:") == false);
+
+ // unexpected end of null
+ CHECK(accept_helper("n") == false);
+ CHECK(accept_helper("nu") == false);
+ CHECK(accept_helper("nul") == false);
+
+ // unexpected end of true
+ CHECK(accept_helper("t") == false);
+ CHECK(accept_helper("tr") == false);
+ CHECK(accept_helper("tru") == false);
+
+ // unexpected end of false
+ CHECK(accept_helper("f") == false);
+ CHECK(accept_helper("fa") == false);
+ CHECK(accept_helper("fal") == false);
+ CHECK(accept_helper("fals") == false);
+
+ // missing/unexpected end of array
+ CHECK(accept_helper("[") == false);
+ CHECK(accept_helper("[1") == false);
+ CHECK(accept_helper("[1,") == false);
+ CHECK(accept_helper("[1,]") == false);
+ CHECK(accept_helper("]") == false);
+
+ // missing/unexpected end of object
+ CHECK(accept_helper("{") == false);
+ CHECK(accept_helper("{\"foo\"") == false);
+ CHECK(accept_helper("{\"foo\":") == false);
+ CHECK(accept_helper("{\"foo\":}") == false);
+ CHECK(accept_helper("{\"foo\":1,}") == false);
+ CHECK(accept_helper("}") == false);
+
+ // missing/unexpected end of string
+ CHECK(accept_helper("\"") == false);
+ CHECK(accept_helper("\"\\\"") == false);
+ CHECK(accept_helper("\"\\u\"") == false);
+ CHECK(accept_helper("\"\\u0\"") == false);
+ CHECK(accept_helper("\"\\u01\"") == false);
+ CHECK(accept_helper("\"\\u012\"") == false);
+ CHECK(accept_helper("\"\\u") == false);
+ CHECK(accept_helper("\"\\u0") == false);
+ CHECK(accept_helper("\"\\u01") == false);
+ CHECK(accept_helper("\"\\u012") == false);
+
+ // unget of newline
+ CHECK(parser_helper("\n123\n") == 123);
+
+ // invalid escapes
+ for (int c = 1; c < 128; ++c)
+ {
+ auto s = std::string("\"\\") + std::string(1, static_cast<char>(c)) + "\"";
+
+ switch (c)
+ {
+ // valid escapes
+ case ('"'):
+ case ('\\'):
+ case ('/'):
+ case ('b'):
+ case ('f'):
+ case ('n'):
+ case ('r'):
+ case ('t'):
+ {
+ CHECK(json::parser(nlohmann::detail::input_adapter(s)).accept());
+ break;
+ }
+
+ // \u must be followed with four numbers, so we skip it here
+ case ('u'):
+ {
+ break;
+ }
+
+ // any other combination of backslash and character is invalid
+ default:
+ {
+ CHECK(json::parser(nlohmann::detail::input_adapter(s)).accept() == false);
+ break;
+ }
+ }
+ }
+
+ // invalid \uxxxx escapes
+ {
+ // check whether character is a valid hex character
+ const auto valid = [](int c)
+ {
+ switch (c)
+ {
+ case ('0'):
+ case ('1'):
+ case ('2'):
+ case ('3'):
+ case ('4'):
+ case ('5'):
+ case ('6'):
+ case ('7'):
+ case ('8'):
+ case ('9'):
+ case ('a'):
+ case ('b'):
+ case ('c'):
+ case ('d'):
+ case ('e'):
+ case ('f'):
+ case ('A'):
+ case ('B'):
+ case ('C'):
+ case ('D'):
+ case ('E'):
+ case ('F'):
+ {
+ return true;
+ }
+
+ default:
+ {
+ return false;
+ }
+ }
+ };
+
+ for (int c = 1; c < 128; ++c)
+ {
+ std::string s = "\"\\u";
+
+ // create a string with the iterated character at each position
+ const auto s1 = s + "000" + std::string(1, static_cast<char>(c)) + "\"";
+ const auto s2 = s + "00" + std::string(1, static_cast<char>(c)) + "0\"";
+ const auto s3 = s + "0" + std::string(1, static_cast<char>(c)) + "00\"";
+ const auto s4 = s + std::string(1, static_cast<char>(c)) + "000\"";
+
+ if (valid(c))
+ {
+ CAPTURE(s1)
+ CHECK(json::parser(nlohmann::detail::input_adapter(s1)).accept());
+ CAPTURE(s2)
+ CHECK(json::parser(nlohmann::detail::input_adapter(s2)).accept());
+ CAPTURE(s3)
+ CHECK(json::parser(nlohmann::detail::input_adapter(s3)).accept());
+ CAPTURE(s4)
+ CHECK(json::parser(nlohmann::detail::input_adapter(s4)).accept());
+ }
+ else
+ {
+ CAPTURE(s1)
+ CHECK(json::parser(nlohmann::detail::input_adapter(s1)).accept() == false);
+
+ CAPTURE(s2)
+ CHECK(json::parser(nlohmann::detail::input_adapter(s2)).accept() == false);
+
+ CAPTURE(s3)
+ CHECK(json::parser(nlohmann::detail::input_adapter(s3)).accept() == false);
+
+ CAPTURE(s4)
+ CHECK(json::parser(nlohmann::detail::input_adapter(s4)).accept() == false);
+ }
+ }
+ }
+
+ // missing part of a surrogate pair
+ CHECK(accept_helper("\"\\uD80C\"") == false);
+ // invalid surrogate pair
+ CHECK(accept_helper("\"\\uD80C\\uD80C\"") == false);
+ CHECK(accept_helper("\"\\uD80C\\u0000\"") == false);
+ CHECK(accept_helper("\"\\uD80C\\uFFFF\"") == false);
+ }
+
+ SECTION("tests found by mutate++")
+ {
+ // test case to make sure no comma precedes the first key
+ CHECK_THROWS_WITH_AS(parser_helper("{,\"key\": false}"), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing object key - unexpected ','; expected string literal", json::parse_error&);
+ // test case to make sure an object is properly closed
+ CHECK_THROWS_WITH_AS(parser_helper("[{\"key\": false true]"), "[json.exception.parse_error.101] parse error at line 1, column 19: syntax error while parsing object - unexpected true literal; expected '}'", json::parse_error&);
+
+ // test case to make sure the callback is properly evaluated after reading a key
+ {
+ json::parser_callback_t cb = [](int /*unused*/, json::parse_event_t event, json& /*unused*/) noexcept
+ {
+ return event != json::parse_event_t::key;
+ };
+
+ json x = json::parse("{\"key\": false}", cb);
+ CHECK(x == json::object());
+ }
+ }
+
+ SECTION("callback function")
+ {
+ const auto* s_object = R"(
+ {
+ "foo": 2,
+ "bar": {
+ "baz": 1
+ }
+ }
+ )";
+
+ const auto* s_array = R"(
+ [1,2,[3,4,5],4,5]
+ )";
+
+ const auto* structured_array = R"(
+ [
+ 1,
+ {
+ "foo": "bar"
+ },
+ {
+ "qux": "baz"
+ }
+ ]
+ )";
+
+ SECTION("filter nothing")
+ {
+ json j_object = json::parse(s_object, [](int /*unused*/, json::parse_event_t /*unused*/, const json& /*unused*/) noexcept
+ {
+ return true;
+ });
+
+ CHECK (j_object == json({{"foo", 2}, {"bar", {{"baz", 1}}}}));
+
+ json j_array = json::parse(s_array, [](int /*unused*/, json::parse_event_t /*unused*/, const json& /*unused*/) noexcept
+ {
+ return true;
+ });
+
+ CHECK (j_array == json({1, 2, {3, 4, 5}, 4, 5}));
+ }
+
+ SECTION("filter everything")
+ {
+ json j_object = json::parse(s_object, [](int /*unused*/, json::parse_event_t /*unused*/, const json& /*unused*/) noexcept
+ {
+ return false;
+ });
+
+ // the top-level object will be discarded, leaving a null
+ CHECK (j_object.is_null());
+
+ json j_array = json::parse(s_array, [](int /*unused*/, json::parse_event_t /*unused*/, const json& /*unused*/) noexcept
+ {
+ return false;
+ });
+
+ // the top-level array will be discarded, leaving a null
+ CHECK (j_array.is_null());
+ }
+
+ SECTION("filter specific element")
+ {
+ json j_object = json::parse(s_object, [](int /*unused*/, json::parse_event_t event, const json & j) noexcept
+ {
+ // filter all number(2) elements
+ 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 event, const json & j) noexcept
+ {
+ return event != json::parse_event_t::value || j != json(2);
+ });
+
+ CHECK (j_array == json({1, {3, 4, 5}, 4, 5}));
+ }
+
+ SECTION("filter object in array")
+ {
+ json j_filtered1 = json::parse(structured_array, [](int /*unused*/, json::parse_event_t e, const json & parsed)
+ {
+ return !(e == json::parse_event_t::object_end && parsed.contains("foo"));
+ });
+
+ // the specified object will be discarded, and removed.
+ CHECK (j_filtered1.size() == 2);
+ CHECK (j_filtered1 == json({1, {{"qux", "baz"}}}));
+
+ json j_filtered2 = json::parse(structured_array, [](int /*unused*/, json::parse_event_t e, const json& /*parsed*/) noexcept
+ {
+ return e != json::parse_event_t::object_end;
+ });
+
+ // removed all objects in array.
+ CHECK (j_filtered2.size() == 1);
+ CHECK (j_filtered2 == json({1}));
+ }
+
+ SECTION("filter specific events")
+ {
+ SECTION("first closing event")
+ {
+ {
+ json j_object = json::parse(s_object, [](int /*unused*/, json::parse_event_t e, const json& /*unused*/) noexcept
+ {
+ static bool first = true;
+ if (e == json::parse_event_t::object_end && first)
+ {
+ first = false;
+ return false;
+ }
+
+ return true;
+ });
+
+ // the first completed object will be discarded
+ CHECK (j_object == json({{"foo", 2}}));
+ }
+
+ {
+ json j_array = json::parse(s_array, [](int /*unused*/, json::parse_event_t e, const json& /*unused*/) noexcept
+ {
+ static bool first = true;
+ if (e == json::parse_event_t::array_end && first)
+ {
+ first = false;
+ return false;
+ }
+
+ return true;
+ });
+
+ // the first completed array will be discarded
+ CHECK (j_array == json({1, 2, 4, 5}));
+ }
+ }
+ }
+
+ SECTION("special cases")
+ {
+ // the following test cases cover the situation in which an empty
+ // object and array is discarded only after the closing character
+ // has been read
+
+ json j_empty_object = json::parse("{}", [](int /*unused*/, json::parse_event_t e, const json& /*unused*/) noexcept
+ {
+ return e != json::parse_event_t::object_end;
+ });
+ CHECK(j_empty_object == json());
+
+ json j_empty_array = json::parse("[]", [](int /*unused*/, json::parse_event_t e, const json& /*unused*/) noexcept
+ {
+ return e != json::parse_event_t::array_end;
+ });
+ CHECK(j_empty_array == json());
+ }
+ }
+
+ SECTION("constructing from contiguous containers")
+ {
+ SECTION("from std::vector")
+ {
+ std::vector<uint8_t> v = {'t', 'r', 'u', 'e'};
+ json j;
+ json::parser(nlohmann::detail::input_adapter(std::begin(v), std::end(v))).parse(true, j);
+ CHECK(j == json(true));
+ }
+
+ SECTION("from std::array")
+ {
+ std::array<uint8_t, 5> v { {'t', 'r', 'u', 'e'} };
+ json j;
+ json::parser(nlohmann::detail::input_adapter(std::begin(v), std::end(v))).parse(true, j);
+ CHECK(j == json(true));
+ }
+
+ SECTION("from array")
+ {
+ uint8_t v[] = {'t', 'r', 'u', 'e'}; // NOLINT(cppcoreguidelines-avoid-c-arrays,hicpp-avoid-c-arrays,modernize-avoid-c-arrays)
+ json j;
+ json::parser(nlohmann::detail::input_adapter(std::begin(v), std::end(v))).parse(true, j);
+ CHECK(j == json(true));
+ }
+
+ SECTION("from char literal")
+ {
+ CHECK(parser_helper("true") == json(true));
+ }
+
+ SECTION("from std::string")
+ {
+ std::string v = {'t', 'r', 'u', 'e'};
+ json j;
+ json::parser(nlohmann::detail::input_adapter(std::begin(v), std::end(v))).parse(true, j);
+ CHECK(j == json(true));
+ }
+
+ SECTION("from std::initializer_list")
+ {
+ std::initializer_list<uint8_t> v = {'t', 'r', 'u', 'e'};
+ json j;
+ json::parser(nlohmann::detail::input_adapter(std::begin(v), std::end(v))).parse(true, j);
+ CHECK(j == json(true));
+ }
+
+ SECTION("from std::valarray")
+ {
+ std::valarray<uint8_t> v = {'t', 'r', 'u', 'e'};
+ json j;
+ json::parser(nlohmann::detail::input_adapter(std::begin(v), std::end(v))).parse(true, j);
+ CHECK(j == json(true));
+ }
+ }
+
+ SECTION("improve test coverage")
+ {
+ SECTION("parser with callback")
+ {
+ json::parser_callback_t cb = [](int /*unused*/, json::parse_event_t /*unused*/, json& /*unused*/) noexcept
+ {
+ return true;
+ };
+
+ CHECK(json::parse("{\"foo\": true:", cb, false).is_discarded());
+
+ json _;
+ CHECK_THROWS_WITH_AS(_ = json::parse("{\"foo\": true:", cb), "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing object - unexpected ':'; expected '}'", json::parse_error&);
+
+ CHECK_THROWS_WITH_AS(_ = json::parse("1.18973e+4932", cb), "[json.exception.out_of_range.406] number overflow parsing '1.18973e+4932'", json::out_of_range&);
+ }
+
+ SECTION("SAX parser")
+ {
+ SECTION("} without value")
+ {
+ SaxCountdown s(1);
+ CHECK(json::sax_parse("{}", &s) == false);
+ }
+
+ SECTION("} with value")
+ {
+ SaxCountdown s(3);
+ CHECK(json::sax_parse("{\"k1\": true}", &s) == false);
+ }
+
+ SECTION("second key")
+ {
+ SaxCountdown s(3);
+ CHECK(json::sax_parse("{\"k1\": true, \"k2\": false}", &s) == false);
+ }
+
+ SECTION("] without value")
+ {
+ SaxCountdown s(1);
+ CHECK(json::sax_parse("[]", &s) == false);
+ }
+
+ SECTION("] with value")
+ {
+ SaxCountdown s(2);
+ CHECK(json::sax_parse("[1]", &s) == false);
+ }
+
+ SECTION("float")
+ {
+ SaxCountdown s(0);
+ CHECK(json::sax_parse("3.14", &s) == false);
+ }
+
+ SECTION("false")
+ {
+ SaxCountdown s(0);
+ CHECK(json::sax_parse("false", &s) == false);
+ }
+
+ SECTION("null")
+ {
+ SaxCountdown s(0);
+ CHECK(json::sax_parse("null", &s) == false);
+ }
+
+ SECTION("true")
+ {
+ SaxCountdown s(0);
+ CHECK(json::sax_parse("true", &s) == false);
+ }
+
+ SECTION("unsigned")
+ {
+ SaxCountdown s(0);
+ CHECK(json::sax_parse("12", &s) == false);
+ }
+
+ SECTION("integer")
+ {
+ SaxCountdown s(0);
+ CHECK(json::sax_parse("-12", &s) == false);
+ }
+
+ SECTION("string")
+ {
+ SaxCountdown s(0);
+ CHECK(json::sax_parse("\"foo\"", &s) == false);
+ }
+ }
+ }
+
+ SECTION("error messages for comments")
+ {
+ json _;
+ CHECK_THROWS_WITH_AS(_ = json::parse("/a", nullptr, true, true), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid comment; expecting '/' or '*' after '/'; last read: '/a'", json::parse_error);
+ CHECK_THROWS_WITH_AS(_ = json::parse("/*", nullptr, true, true), "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid comment; missing closing '*/'; last read: '/*<U+0000>'", json::parse_error);
+ }
+}
diff --git a/tests/src/unit-comparison.cpp b/tests/src/unit-comparison.cpp
new file mode 100644
index 0000000..896cc77
--- /dev/null
+++ b/tests/src/unit-comparison.cpp
@@ -0,0 +1,595 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+// 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>
+// see https://en.cppreference.com/w/cpp/utility/functional/less
+template <typename A, typename B, typename U = std::less<json::value_t>>
+bool f(A a, B b, U u = U())
+{
+ return u(a, b);
+}
+} // namespace
+
+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 =
+ {
+ json::value_t::null,
+ json::value_t::boolean,
+ json::value_t::number_integer,
+ json::value_t::number_unsigned,
+ json::value_t::number_float,
+ json::value_t::object,
+ json::value_t::array,
+ json::value_t::string,
+ 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")
+ {
+ 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
+#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, // 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
+ };
+
+ 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 =
+ {
+ //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(json::compares_unordered(j_values[i], j_values[j], true) == expected[i][j]);
+ }
+ }
+ }
+#endif
+
+ 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)
+ {
+ 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
+ json j_null;
+ CHECK(j_null == nullptr);
+ CHECK(nullptr == j_null);
+ }
+
+ 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)
+
+ 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));
+ }
+
+ SECTION("comparison: less")
+ {
+ // 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)
+ {
+ CAPTURE(i)
+ CAPTURE(j)
+ CHECK((j_values[i] < j_values[j]) == expected_lt[i][j]);
+ }
+ }
+ }
+
+ 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)
+ 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)
+ 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)
+ 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/test/src/unit-concepts.cpp b/tests/src/unit-concepts.cpp
similarity index 77%
rename from test/src/unit-concepts.cpp
rename to tests/src/unit-concepts.cpp
index 389c7f3..e9204fa 100644
--- a/test/src/unit-concepts.cpp
+++ b/tests/src/unit-concepts.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
diff --git a/test/src/unit-constructor1.cpp b/tests/src/unit-constructor1.cpp
similarity index 82%
rename from test/src/unit-constructor1.cpp
rename to tests/src/unit-constructor1.cpp
index 03ad689..7addce0 100644
--- a/test/src/unit-constructor1.cpp
+++ b/tests/src/unit-constructor1.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -305,12 +284,9 @@
{
json j{1};
- CHECK_THROWS_AS((j.get<std::pair<int, int>>()), json::out_of_range&);
- CHECK_THROWS_WITH((j.get<std::pair<int, int>>()), "[json.exception.out_of_range.401] array index 1 is out of range");
- CHECK_THROWS_AS((j.get<std::tuple<int, int>>()), json::out_of_range&);
- CHECK_THROWS_WITH((j.get<std::tuple<int, int>>()), "[json.exception.out_of_range.401] array index 1 is out of range");
- CHECK_THROWS_AS((j.get<std::array<int, 3>>()), json::out_of_range&);
- CHECK_THROWS_WITH((j.get<std::array<int, 3>>()), "[json.exception.out_of_range.401] array index 1 is out of range");
+ CHECK_THROWS_WITH_AS((j.get<std::pair<int, int>>()), "[json.exception.out_of_range.401] array index 1 is out of range", json::out_of_range&);
+ CHECK_THROWS_WITH_AS((j.get<std::tuple<int, int>>()), "[json.exception.out_of_range.401] array index 1 is out of range", json::out_of_range&);
+ CHECK_THROWS_WITH_AS((j.get<std::array<int, 3>>()), "[json.exception.out_of_range.401] array index 1 is out of range", json::out_of_range&);
}
SECTION("std::forward_list<json>")
@@ -477,6 +453,13 @@
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)")
@@ -1091,10 +1074,7 @@
SECTION("object with error")
{
json _;
- CHECK_THROWS_AS(_ = json::object({ {"one", 1}, {"two", 1u}, {"three", 2.2}, {"four", false}, 13 }),
- json::type_error&);
- CHECK_THROWS_WITH(_ = json::object({ {"one", 1}, {"two", 1u}, {"three", 2.2}, {"four", false}, 13 }),
- "[json.exception.type_error.301] cannot create object from initializer list");
+ CHECK_THROWS_WITH_AS(_ = json::object({ {"one", 1}, {"two", 1u}, {"three", 2.2}, {"four", false}, 13 }), "[json.exception.type_error.301] cannot create object from initializer list", json::type_error&);
}
SECTION("empty array")
@@ -1340,18 +1320,14 @@
{
json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}, {"d", false}, {"e", true}};
json jobject2 = {{"a", "a"}, {"b", 1}, {"c", 17u}};
- CHECK_THROWS_AS(json(jobject.begin(), jobject2.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(json(jobject2.begin(), jobject.end()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(jobject.begin(), jobject2.end()), "[json.exception.invalid_iterator.201] iterators are not compatible");
- CHECK_THROWS_WITH(json(jobject2.begin(), jobject.end()), "[json.exception.invalid_iterator.201] iterators are not compatible");
+ CHECK_THROWS_WITH_AS(json(jobject.begin(), jobject2.end()), "[json.exception.invalid_iterator.201] iterators are not compatible", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(json(jobject2.begin(), jobject.end()), "[json.exception.invalid_iterator.201] iterators are not compatible", json::invalid_iterator&);
}
{
json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}, {"d", false}, {"e", true}};
json jobject2 = {{"a", "a"}, {"b", 1}, {"c", 17u}};
- CHECK_THROWS_AS(json(jobject.cbegin(), jobject2.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(json(jobject2.cbegin(), jobject.cend()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(jobject.cbegin(), jobject2.cend()), "[json.exception.invalid_iterator.201] iterators are not compatible");
- CHECK_THROWS_WITH(json(jobject2.cbegin(), jobject.cend()), "[json.exception.invalid_iterator.201] iterators are not compatible");
+ CHECK_THROWS_WITH_AS(json(jobject.cbegin(), jobject2.cend()), "[json.exception.invalid_iterator.201] iterators are not compatible", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(json(jobject2.cbegin(), jobject.cend()), "[json.exception.invalid_iterator.201] iterators are not compatible", json::invalid_iterator&);
}
}
}
@@ -1405,18 +1381,14 @@
{
json jarray = {1, 2, 3, 4};
json jarray2 = {2, 3, 4, 5};
- CHECK_THROWS_AS(json(jarray.begin(), jarray2.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(json(jarray2.begin(), jarray.end()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(jarray.begin(), jarray2.end()), "[json.exception.invalid_iterator.201] iterators are not compatible");
- CHECK_THROWS_WITH(json(jarray2.begin(), jarray.end()), "[json.exception.invalid_iterator.201] iterators are not compatible");
+ CHECK_THROWS_WITH_AS(json(jarray.begin(), jarray2.end()), "[json.exception.invalid_iterator.201] iterators are not compatible", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(json(jarray2.begin(), jarray.end()), "[json.exception.invalid_iterator.201] iterators are not compatible", json::invalid_iterator&);
}
{
json jarray = {1, 2, 3, 4};
json jarray2 = {2, 3, 4, 5};
- CHECK_THROWS_AS(json(jarray.cbegin(), jarray2.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(json(jarray2.cbegin(), jarray.cend()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(jarray.cbegin(), jarray2.cend()), "[json.exception.invalid_iterator.201] iterators are not compatible");
- CHECK_THROWS_WITH(json(jarray2.cbegin(), jarray.cend()), "[json.exception.invalid_iterator.201] iterators are not compatible");
+ CHECK_THROWS_WITH_AS(json(jarray.cbegin(), jarray2.cend()), "[json.exception.invalid_iterator.201] iterators are not compatible", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(json(jarray2.cbegin(), jarray.cend()), "[json.exception.invalid_iterator.201] iterators are not compatible", json::invalid_iterator&);
}
}
}
@@ -1429,15 +1401,11 @@
{
{
json j;
- CHECK_THROWS_AS(json(j.begin(), j.end()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(j.begin(), j.end()),
- "[json.exception.invalid_iterator.206] cannot construct with iterators from null");
+ CHECK_THROWS_WITH_AS(json(j.begin(), j.end()), "[json.exception.invalid_iterator.206] cannot construct with iterators from null", json::invalid_iterator&);
}
{
json j;
- CHECK_THROWS_AS(json(j.cbegin(), j.cend()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(j.cbegin(), j.cend()),
- "[json.exception.invalid_iterator.206] cannot construct with iterators from null");
+ CHECK_THROWS_WITH_AS(json(j.cbegin(), j.cend()), "[json.exception.invalid_iterator.206] cannot construct with iterators from null", json::invalid_iterator&);
}
}
@@ -1532,17 +1500,13 @@
{
{
json j = "foo";
- CHECK_THROWS_AS(json(j.end(), j.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(json(j.begin(), j.begin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(json(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range");
+ CHECK_THROWS_WITH_AS(json(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(json(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
}
{
json j = "bar";
- CHECK_THROWS_AS(json(j.cend(), j.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(json(j.cbegin(), j.cbegin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(json(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range");
+ CHECK_THROWS_WITH_AS(json(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(json(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
}
}
@@ -1550,17 +1514,13 @@
{
{
json j = false;
- CHECK_THROWS_AS(json(j.end(), j.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(json(j.begin(), j.begin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(json(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range");
+ CHECK_THROWS_WITH_AS(json(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(json(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
}
{
json j = true;
- CHECK_THROWS_AS(json(j.cend(), j.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(json(j.cbegin(), j.cbegin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(json(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range");
+ CHECK_THROWS_WITH_AS(json(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(json(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
}
}
@@ -1568,17 +1528,13 @@
{
{
json j = 17;
- CHECK_THROWS_AS(json(j.end(), j.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(json(j.begin(), j.begin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(json(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range");
+ CHECK_THROWS_WITH_AS(json(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(json(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
}
{
json j = 17;
- CHECK_THROWS_AS(json(j.cend(), j.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(json(j.cbegin(), j.cbegin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(json(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range");
+ CHECK_THROWS_WITH_AS(json(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(json(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
}
}
@@ -1586,17 +1542,13 @@
{
{
json j = 17u;
- CHECK_THROWS_AS(json(j.end(), j.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(json(j.begin(), j.begin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(json(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range");
+ CHECK_THROWS_WITH_AS(json(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(json(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
}
{
json j = 17u;
- CHECK_THROWS_AS(json(j.cend(), j.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(json(j.cbegin(), j.cbegin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(json(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range");
+ CHECK_THROWS_WITH_AS(json(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(json(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
}
}
@@ -1604,17 +1556,13 @@
{
{
json j = 23.42;
- CHECK_THROWS_AS(json(j.end(), j.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(json(j.begin(), j.begin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(json(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range");
+ CHECK_THROWS_WITH_AS(json(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(json(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
}
{
json j = 23.42;
- CHECK_THROWS_AS(json(j.cend(), j.cend()), json::invalid_iterator&);
- CHECK_THROWS_AS(json(j.cbegin(), j.cbegin()), json::invalid_iterator&);
- CHECK_THROWS_WITH(json(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range");
- CHECK_THROWS_WITH(json(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range");
+ CHECK_THROWS_WITH_AS(json(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(json(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
}
}
}
diff --git a/test/src/unit-constructor2.cpp b/tests/src/unit-constructor2.cpp
similarity index 75%
rename from test/src/unit-constructor2.cpp
rename to tests/src/unit-constructor2.cpp
index 1627ded..c76b7d5 100644
--- a/test/src/unit-constructor2.cpp
+++ b/tests/src/unit-constructor2.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
diff --git a/tests/src/unit-convenience.cpp b/tests/src/unit-convenience.cpp
new file mode 100644
index 0000000..1b536ed
--- /dev/null
+++ b/tests/src/unit-convenience.cpp
@@ -0,0 +1,205 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#define JSON_TESTS_PRIVATE
+#include <nlohmann/json.hpp>
+using nlohmann::json;
+
+#include <sstream>
+
+namespace
+{
+struct alt_string_iter
+{
+ alt_string_iter() = default;
+ alt_string_iter(const char* cstr)
+ : impl(cstr)
+ {}
+
+ void reserve(std::size_t s)
+ {
+ impl.reserve(s);
+ }
+
+ template<typename Iter>
+ void append(Iter first, Iter last)
+ {
+ impl.append(first, last);
+ }
+
+ std::string::const_iterator begin() const
+ {
+ return impl.begin();
+ }
+
+ std::string::const_iterator end() const
+ {
+ return impl.end();
+ }
+
+ std::size_t size() const
+ {
+ return impl.size();
+ }
+
+ alt_string_iter& operator+=(const char c)
+ {
+ impl += c;
+ return *this;
+ }
+
+ std::string impl{};
+};
+
+struct alt_string_data
+{
+ alt_string_data() = default;
+ alt_string_data(const char* cstr)
+ : impl(cstr)
+ {}
+
+ void reserve(std::size_t s)
+ {
+ impl.reserve(s);
+ }
+
+ void append(const char* p, std::size_t s)
+ {
+ impl.append(p, s);
+ }
+
+ const char* data() const
+ {
+ return impl.data();
+ }
+
+ std::size_t size() const
+ {
+ return impl.size();
+ }
+
+ alt_string_data& operator+=(const char c)
+ {
+ impl += c;
+ return *this;
+ }
+
+ std::string impl{};
+};
+
+void check_escaped(const char* original, const char* escaped = "", bool ensure_ascii = false);
+void check_escaped(const char* original, const char* escaped, const bool ensure_ascii)
+{
+ std::stringstream ss;
+ json::serializer s(nlohmann::detail::output_adapter<char>(ss), ' ');
+ s.dump_escaped(original, ensure_ascii);
+ CHECK(ss.str() == escaped);
+}
+} // namespace
+
+TEST_CASE("convenience functions")
+{
+ SECTION("type name as string")
+ {
+ CHECK(std::string(json(json::value_t::null).type_name()) == "null");
+ CHECK(std::string(json(json::value_t::object).type_name()) == "object");
+ CHECK(std::string(json(json::value_t::array).type_name()) == "array");
+ CHECK(std::string(json(json::value_t::number_integer).type_name()) == "number");
+ CHECK(std::string(json(json::value_t::number_unsigned).type_name()) == "number");
+ CHECK(std::string(json(json::value_t::number_float).type_name()) == "number");
+ CHECK(std::string(json(json::value_t::binary).type_name()) == "binary");
+ CHECK(std::string(json(json::value_t::boolean).type_name()) == "boolean");
+ CHECK(std::string(json(json::value_t::string).type_name()) == "string");
+ CHECK(std::string(json(json::value_t::discarded).type_name()) == "discarded");
+ }
+
+ SECTION("string escape")
+ {
+ check_escaped("\"", "\\\"");
+ check_escaped("\\", "\\\\");
+ check_escaped("\b", "\\b");
+ check_escaped("\f", "\\f");
+ check_escaped("\n", "\\n");
+ check_escaped("\r", "\\r");
+ check_escaped("\t", "\\t");
+
+ check_escaped("\x01", "\\u0001");
+ check_escaped("\x02", "\\u0002");
+ check_escaped("\x03", "\\u0003");
+ check_escaped("\x04", "\\u0004");
+ check_escaped("\x05", "\\u0005");
+ check_escaped("\x06", "\\u0006");
+ check_escaped("\x07", "\\u0007");
+ check_escaped("\x08", "\\b");
+ check_escaped("\x09", "\\t");
+ check_escaped("\x0a", "\\n");
+ check_escaped("\x0b", "\\u000b");
+ check_escaped("\x0c", "\\f");
+ check_escaped("\x0d", "\\r");
+ check_escaped("\x0e", "\\u000e");
+ check_escaped("\x0f", "\\u000f");
+ check_escaped("\x10", "\\u0010");
+ check_escaped("\x11", "\\u0011");
+ check_escaped("\x12", "\\u0012");
+ check_escaped("\x13", "\\u0013");
+ check_escaped("\x14", "\\u0014");
+ check_escaped("\x15", "\\u0015");
+ check_escaped("\x16", "\\u0016");
+ check_escaped("\x17", "\\u0017");
+ check_escaped("\x18", "\\u0018");
+ check_escaped("\x19", "\\u0019");
+ check_escaped("\x1a", "\\u001a");
+ check_escaped("\x1b", "\\u001b");
+ check_escaped("\x1c", "\\u001c");
+ check_escaped("\x1d", "\\u001d");
+ check_escaped("\x1e", "\\u001e");
+ check_escaped("\x1f", "\\u001f");
+
+ // invalid UTF-8 characters
+ CHECK_THROWS_WITH_AS(check_escaped("ä\xA9ü"), "[json.exception.type_error.316] invalid UTF-8 byte at index 2: 0xA9", json::type_error&);
+
+ CHECK_THROWS_WITH_AS(check_escaped("\xC2"), "[json.exception.type_error.316] incomplete UTF-8 string; last byte: 0xC2", json::type_error&);
+ }
+
+ SECTION("string concat")
+ {
+ using nlohmann::detail::concat;
+
+ const char* expected = "Hello, world!";
+ alt_string_iter hello_iter{"Hello, "};
+ alt_string_data hello_data{"Hello, "};
+ std::string world = "world";
+
+ SECTION("std::string")
+ {
+ std::string str1 = concat(hello_iter, world, '!');
+ std::string str2 = concat(hello_data, world, '!');
+ std::string str3 = concat("Hello, ", world, '!');
+
+ CHECK(str1 == expected);
+ CHECK(str2 == expected);
+ CHECK(str3 == expected);
+ }
+
+ SECTION("alt_string_iter")
+ {
+ alt_string_iter str = concat<alt_string_iter>(hello_iter, world, '!');
+
+ CHECK(str.impl == expected);
+ }
+
+ SECTION("alt_string_data")
+ {
+ alt_string_data str = concat<alt_string_data>(hello_data, world, '!');
+
+ CHECK(str.impl == expected);
+ }
+ }
+}
diff --git a/test/src/unit-conversions.cpp b/tests/src/unit-conversions.cpp
similarity index 73%
rename from test/src/unit-conversions.cpp
rename to tests/src/unit-conversions.cpp
index 092d5b8..df1b92f 100644
--- a/test/src/unit-conversions.cpp
+++ b/tests/src/unit-conversions.cpp
@@ -1,31 +1,18 @@
-/*
- __ _____ _____ _____
- __| | __| | | | JSON for Modern C++ (test suite)
-| | |__ | | | | | | version 3.10.5
-|_____|_____|_____|_|___| https://github.com/nlohmann/json
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// Copyright (c) 2013-2022 Niels Lohmann <http://nlohmann.me>.
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
-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.
-*/
+// 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"
@@ -41,13 +28,6 @@
#include <unordered_set>
#include <valarray>
-#if (defined(__cplusplus) && __cplusplus >= 201703L) || (defined(_HAS_CXX17) && _HAS_CXX17 == 1) // fix for issue #464
- #define JSON_HAS_CPP_17
- #define JSON_HAS_CPP_14
-#elif (defined(__cplusplus) && __cplusplus >= 201402L) || (defined(_HAS_CXX14) && _HAS_CXX14 == 1)
- #define JSON_HAS_CPP_14
-#endif
-
// NLOHMANN_JSON_SERIALIZE_ENUM uses a static std::pair
DOCTEST_CLANG_SUPPRESS_WARNING_PUSH
DOCTEST_CLANG_SUPPRESS_WARNING("-Wexit-time-destructors")
@@ -101,43 +81,27 @@
SECTION("exception in case of a non-object type")
{
- CHECK_THROWS_AS(json(json::value_t::null).get<json::object_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::array).get<json::object_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::string).get<json::object_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::boolean).get<json::object_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::number_integer).get<json::object_t>(),
- json::type_error&);
- CHECK_THROWS_AS(
- json(json::value_t::number_unsigned).get<json::object_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::number_float).get<json::object_t>(),
- json::type_error&);
-
- CHECK_THROWS_WITH(
+ CHECK_THROWS_WITH_AS(
json(json::value_t::null).get<json::object_t>(),
- "[json.exception.type_error.302] type must be object, but is null");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be object, but is null", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::array).get<json::object_t>(),
- "[json.exception.type_error.302] type must be object, but is array");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be object, but is array", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::string).get<json::object_t>(),
- "[json.exception.type_error.302] type must be object, but is string");
- CHECK_THROWS_WITH(json(json::value_t::boolean).get<json::object_t>(),
- "[json.exception.type_error.302] type must be object, "
- "but is boolean");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be object, but is string", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::boolean).get<json::object_t>(),
+ "[json.exception.type_error.302] type must be object, "
+ "but is boolean", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::number_integer).get<json::object_t>(),
- "[json.exception.type_error.302] type must be object, but is number");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be object, but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::number_unsigned).get<json::object_t>(),
- "[json.exception.type_error.302] type must be object, but is number");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be object, but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::number_float).get<json::object_t>(),
- "[json.exception.type_error.302] type must be object, but is number");
+ "[json.exception.type_error.302] type must be object, but is number", json::type_error&);
}
}
@@ -255,11 +219,9 @@
std::forward_list<json> a = j.get<std::forward_list<json>>();
CHECK(json(a) == j);
- CHECK_THROWS_AS(json(json::value_t::null).get<std::forward_list<json>>(),
- json::type_error&);
- CHECK_THROWS_WITH(
+ CHECK_THROWS_WITH_AS(
json(json::value_t::null).get<std::forward_list<json>>(),
- "[json.exception.type_error.302] type must be array, but is null");
+ "[json.exception.type_error.302] type must be array, but is null", json::type_error&);
}
SECTION("std::vector<json>")
@@ -267,11 +229,9 @@
std::vector<json> a = j.get<std::vector<json>>();
CHECK(json(a) == j);
- CHECK_THROWS_AS(json(json::value_t::null).get<std::vector<json>>(),
- json::type_error&);
- CHECK_THROWS_WITH(
+ CHECK_THROWS_WITH_AS(
json(json::value_t::null).get<std::vector<json>>(),
- "[json.exception.type_error.302] type must be array, but is null");
+ "[json.exception.type_error.302] type must be array, but is null", json::type_error&);
#if !defined(JSON_NOEXCEPTION)
SECTION("reserve is called on containers that supports it")
@@ -306,45 +266,30 @@
SECTION("exception in case of a non-array type")
{
- CHECK_THROWS_AS(json(json::value_t::null).get<json::array_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::object).get<json::array_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::string).get<json::array_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::boolean).get<json::array_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::number_integer).get<json::array_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::number_unsigned).get<json::array_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::number_float).get<json::array_t>(),
- json::type_error&);
-
- CHECK_THROWS_WITH(
+ CHECK_THROWS_WITH_AS(
json(json::value_t::object).get<std::vector<int>>(),
- "[json.exception.type_error.302] type must be array, but is object");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be array, but is object", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::null).get<json::array_t>(),
- "[json.exception.type_error.302] type must be array, but is null");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be array, but is null", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::object).get<json::array_t>(),
- "[json.exception.type_error.302] type must be array, but is object");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be array, but is object", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::string).get<json::array_t>(),
- "[json.exception.type_error.302] type must be array, but is string");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be array, but is string", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::boolean).get<json::array_t>(),
- "[json.exception.type_error.302] type must be array, but is boolean");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be array, but is boolean", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::number_integer).get<json::array_t>(),
- "[json.exception.type_error.302] type must be array, but is number");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be array, but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::number_unsigned).get<json::array_t>(),
- "[json.exception.type_error.302] type must be array, but is number");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be array, but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::number_float).get<json::array_t>(),
- "[json.exception.type_error.302] type must be array, but is number");
+ "[json.exception.type_error.302] type must be array, but is number", json::type_error&);
}
}
@@ -472,70 +417,46 @@
SECTION("exception in case of a non-string type")
{
- CHECK_THROWS_AS(json(json::value_t::null).get<json::string_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::object).get<json::string_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::array).get<json::string_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::boolean).get<json::string_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::number_integer).get<json::string_t>(),
- json::type_error&);
- CHECK_THROWS_AS(
- json(json::value_t::number_unsigned).get<json::string_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::number_float).get<json::string_t>(),
- json::type_error&);
-
- CHECK_THROWS_WITH(
+ CHECK_THROWS_WITH_AS(
json(json::value_t::null).get<json::string_t>(),
- "[json.exception.type_error.302] type must be string, but is null");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be string, but is null", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::object).get<json::string_t>(),
- "[json.exception.type_error.302] type must be string, but is object");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be string, but is object", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::array).get<json::string_t>(),
- "[json.exception.type_error.302] type must be string, but is array");
- CHECK_THROWS_WITH(json(json::value_t::boolean).get<json::string_t>(),
- "[json.exception.type_error.302] type must be string, "
- "but is boolean");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be string, but is array", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::boolean).get<json::string_t>(),
+ "[json.exception.type_error.302] type must be string, "
+ "but is boolean", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::number_integer).get<json::string_t>(),
- "[json.exception.type_error.302] type must be string, but is number");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be string, but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::number_unsigned).get<json::string_t>(),
- "[json.exception.type_error.302] type must be string, but is number");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be string, but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::number_float).get<json::string_t>(),
- "[json.exception.type_error.302] type must be string, but is number");
+ "[json.exception.type_error.302] type must be string, but is number", json::type_error&);
}
#if defined(JSON_HAS_CPP_17)
SECTION("exception in case of a non-string type using string_view")
{
- CHECK_THROWS_AS(json(json::value_t::null).get<std::string_view>(), json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::object).get<std::string_view>(), json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::array).get<std::string_view>(), json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::boolean).get<std::string_view>(), json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::number_integer).get<std::string_view>(), json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::number_unsigned).get<std::string_view>(), json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::number_float).get<std::string_view>(), json::type_error&);
-
- CHECK_THROWS_WITH(json(json::value_t::null).get<std::string_view>(),
- "[json.exception.type_error.302] type must be string, but is null");
- CHECK_THROWS_WITH(json(json::value_t::object).get<std::string_view>(),
- "[json.exception.type_error.302] type must be string, but is object");
- CHECK_THROWS_WITH(json(json::value_t::array).get<std::string_view>(),
- "[json.exception.type_error.302] type must be string, but is array");
- CHECK_THROWS_WITH(json(json::value_t::boolean).get<std::string_view>(),
- "[json.exception.type_error.302] type must be string, but is boolean");
- CHECK_THROWS_WITH(json(json::value_t::number_integer).get<std::string_view>(),
- "[json.exception.type_error.302] type must be string, but is number");
- CHECK_THROWS_WITH(json(json::value_t::number_unsigned).get<std::string_view>(),
- "[json.exception.type_error.302] type must be string, but is number");
- CHECK_THROWS_WITH(json(json::value_t::number_float).get<std::string_view>(),
- "[json.exception.type_error.302] type must be string, but is number");
+ CHECK_THROWS_WITH_AS(json(json::value_t::null).get<std::string_view>(),
+ "[json.exception.type_error.302] type must be string, but is null", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::object).get<std::string_view>(),
+ "[json.exception.type_error.302] type must be string, but is object", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::array).get<std::string_view>(),
+ "[json.exception.type_error.302] type must be string, but is array", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::boolean).get<std::string_view>(),
+ "[json.exception.type_error.302] type must be string, but is boolean", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::number_integer).get<std::string_view>(),
+ "[json.exception.type_error.302] type must be string, but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::number_unsigned).get<std::string_view>(),
+ "[json.exception.type_error.302] type must be string, but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::number_float).get<std::string_view>(),
+ "[json.exception.type_error.302] type must be string, but is number", json::type_error&);
}
#endif
}
@@ -577,29 +498,20 @@
auto n2 = j.get<std::nullptr_t>();
CHECK(n2 == n);
- CHECK_THROWS_AS(json(json::value_t::string).get<std::nullptr_t>(), json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::object).get<std::nullptr_t>(), json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::array).get<std::nullptr_t>(), json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::boolean).get<std::nullptr_t>(), json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::number_integer).get<std::nullptr_t>(), json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::number_unsigned).get<std::nullptr_t>(), json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::number_float).get<std::nullptr_t>(), json::type_error&);
-
- CHECK_THROWS_WITH(json(json::value_t::string).get<std::nullptr_t>(),
- "[json.exception.type_error.302] type must be null, but is string");
- CHECK_THROWS_WITH(json(json::value_t::object).get<std::nullptr_t>(),
- "[json.exception.type_error.302] type must be null, but is object");
- CHECK_THROWS_WITH(json(json::value_t::array).get<std::nullptr_t>(),
- "[json.exception.type_error.302] type must be null, but is array");
- CHECK_THROWS_WITH(json(json::value_t::boolean).get<std::nullptr_t>(),
- "[json.exception.type_error.302] type must be null, but is boolean");
- CHECK_THROWS_WITH(json(json::value_t::number_integer).get<std::nullptr_t>(),
- "[json.exception.type_error.302] type must be null, but is number");
- CHECK_THROWS_WITH(json(json::value_t::number_unsigned).get<std::nullptr_t>(),
- "[json.exception.type_error.302] type must be null, but is number");
- CHECK_THROWS_WITH(json(json::value_t::number_float).get<std::nullptr_t>(),
- "[json.exception.type_error.302] type must be null, but is number");
-
+ CHECK_THROWS_WITH_AS(json(json::value_t::string).get<std::nullptr_t>(),
+ "[json.exception.type_error.302] type must be null, but is string", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::object).get<std::nullptr_t>(),
+ "[json.exception.type_error.302] type must be null, but is object", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::array).get<std::nullptr_t>(),
+ "[json.exception.type_error.302] type must be null, but is array", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::boolean).get<std::nullptr_t>(),
+ "[json.exception.type_error.302] type must be null, but is boolean", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::number_integer).get<std::nullptr_t>(),
+ "[json.exception.type_error.302] type must be null, but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::number_unsigned).get<std::nullptr_t>(),
+ "[json.exception.type_error.302] type must be null, but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::number_float).get<std::nullptr_t>(),
+ "[json.exception.type_error.302] type must be null, but is number", json::type_error&);
}
#if JSON_USE_IMPLICIT_CONVERSIONS
@@ -655,49 +567,33 @@
SECTION("exception in case of a non-number type")
{
- CHECK_THROWS_AS(json(json::value_t::null).get<json::boolean_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::object).get<json::boolean_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::array).get<json::boolean_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::string).get<json::boolean_t>(),
- json::type_error&);
CHECK_THROWS_AS(json(json::value_t::string).get<uint8_t>(),
json::type_error&);
- CHECK_THROWS_AS(
- json(json::value_t::number_integer).get<json::boolean_t>(),
- json::type_error&);
- CHECK_THROWS_AS(
- json(json::value_t::number_unsigned).get<json::boolean_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::number_float).get<json::boolean_t>(),
- json::type_error&);
- CHECK_THROWS_WITH(
+ CHECK_THROWS_WITH_AS(
json(json::value_t::null).get<json::boolean_t>(),
- "[json.exception.type_error.302] type must be boolean, but is null");
- CHECK_THROWS_WITH(json(json::value_t::object).get<json::boolean_t>(),
- "[json.exception.type_error.302] type must be boolean, "
- "but is object");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be boolean, but is null", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::object).get<json::boolean_t>(),
+ "[json.exception.type_error.302] type must be boolean, "
+ "but is object", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::array).get<json::boolean_t>(),
- "[json.exception.type_error.302] type must be boolean, but is array");
- CHECK_THROWS_WITH(json(json::value_t::string).get<json::boolean_t>(),
- "[json.exception.type_error.302] type must be boolean, "
- "but is string");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be boolean, but is array", json::type_error&);
+ CHECK_THROWS_WITH_AS(json(json::value_t::string).get<json::boolean_t>(),
+ "[json.exception.type_error.302] type must be boolean, "
+ "but is string", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::number_integer).get<json::boolean_t>(),
"[json.exception.type_error.302] type must be boolean, but is "
- "number");
- CHECK_THROWS_WITH(
+ "number", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::number_unsigned).get<json::boolean_t>(),
"[json.exception.type_error.302] type must be boolean, but is "
- "number");
- CHECK_THROWS_WITH(
+ "number", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::number_float).get<json::boolean_t>(),
"[json.exception.type_error.302] type must be boolean, but is "
- "number");
+ "number", json::type_error&);
}
}
@@ -934,34 +830,22 @@
SECTION("exception in case of a non-number type")
{
- CHECK_THROWS_AS(json(json::value_t::null).get<json::number_integer_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::object).get<json::number_integer_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::array).get<json::number_integer_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::string).get<json::number_integer_t>(),
- json::type_error&);
- CHECK_THROWS_AS(
- json(json::value_t::boolean).get<json::number_integer_t>(),
- json::type_error&);
-
- CHECK_THROWS_WITH(
+ CHECK_THROWS_WITH_AS(
json(json::value_t::null).get<json::number_integer_t>(),
- "[json.exception.type_error.302] type must be number, but is null");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be number, but is null", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::object).get<json::number_integer_t>(),
- "[json.exception.type_error.302] type must be number, but is object");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be number, but is object", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::array).get<json::number_integer_t>(),
- "[json.exception.type_error.302] type must be number, but is array");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be number, but is array", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::string).get<json::number_integer_t>(),
- "[json.exception.type_error.302] type must be number, but is string");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be number, but is string", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::boolean).get<json::number_integer_t>(),
"[json.exception.type_error.302] type must be number, but is "
- "boolean");
+ "boolean", json::type_error&);
CHECK_NOTHROW(
json(json::value_t::number_float).get<json::number_integer_t>());
@@ -1209,33 +1093,22 @@
SECTION("exception in case of a non-string type")
{
- CHECK_THROWS_AS(json(json::value_t::null).get<json::number_float_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::object).get<json::number_float_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::array).get<json::number_float_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::string).get<json::number_float_t>(),
- json::type_error&);
- CHECK_THROWS_AS(json(json::value_t::boolean).get<json::number_float_t>(),
- json::type_error&);
-
- CHECK_THROWS_WITH(
+ CHECK_THROWS_WITH_AS(
json(json::value_t::null).get<json::number_float_t>(),
- "[json.exception.type_error.302] type must be number, but is null");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be number, but is null", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::object).get<json::number_float_t>(),
- "[json.exception.type_error.302] type must be number, but is object");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be number, but is object", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::array).get<json::number_float_t>(),
- "[json.exception.type_error.302] type must be number, but is array");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be number, but is array", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::string).get<json::number_float_t>(),
- "[json.exception.type_error.302] type must be number, but is string");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be number, but is string", json::type_error&);
+ CHECK_THROWS_WITH_AS(
json(json::value_t::boolean).get<json::number_float_t>(),
"[json.exception.type_error.302] type must be number, but is "
- "boolean");
+ "boolean", json::type_error&);
CHECK_NOTHROW(
json(json::value_t::number_integer).get<json::number_float_t>());
@@ -1450,11 +1323,9 @@
SECTION("exception in case of a non-object type")
{
- CHECK_THROWS_AS((json().get<std::map<std::string, int>>()),
- json::type_error&);
- CHECK_THROWS_WITH(
+ CHECK_THROWS_WITH_AS(
(json().get<std::map<std::string, int>>()),
- "[json.exception.type_error.302] type must be object, but is null");
+ "[json.exception.type_error.302] type must be object, but is null", json::type_error&);
}
}
@@ -1495,9 +1366,8 @@
SECTION("std::array is larger than JSON")
{
std::array<int, 6> arr6 = {{1, 2, 3, 4, 5, 6}};
- CHECK_THROWS_AS(j1.get_to(arr6), json::out_of_range&);
- CHECK_THROWS_WITH(j1.get_to(arr6), "[json.exception.out_of_range.401] "
- "array index 4 is out of range");
+ CHECK_THROWS_WITH_AS(j1.get_to(arr6), "[json.exception.out_of_range.401] "
+ "array index 4 is out of range", json::out_of_range&);
}
SECTION("std::array is smaller than JSON")
@@ -1564,14 +1434,12 @@
json j7 = {0, 1, 2, 3};
json j8 = 2;
- CHECK_THROWS_AS((j7.get<std::map<int, int>>()), json::type_error&);
- CHECK_THROWS_AS((j8.get<std::map<int, int>>()), json::type_error&);
- CHECK_THROWS_WITH((j7.get<std::map<int, int>>()),
- "[json.exception.type_error.302] type must be array, "
- "but is number");
- CHECK_THROWS_WITH((j8.get<std::map<int, int>>()),
- "[json.exception.type_error.302] type must be array, "
- "but is number");
+ CHECK_THROWS_WITH_AS((j7.get<std::map<int, int>>()),
+ "[json.exception.type_error.302] type must be array, "
+ "but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS((j8.get<std::map<int, int>>()),
+ "[json.exception.type_error.302] type must be array, "
+ "but is number", json::type_error&);
SECTION("superfluous entries")
{
@@ -1591,14 +1459,12 @@
json j7 = {0, 1, 2, 3};
json j8 = 2;
- CHECK_THROWS_AS((j7.get<std::unordered_map<int, int>>()), json::type_error&);
- CHECK_THROWS_AS((j8.get<std::unordered_map<int, int>>()), json::type_error&);
- CHECK_THROWS_WITH((j7.get<std::unordered_map<int, int>>()),
- "[json.exception.type_error.302] type must be array, "
- "but is number");
- CHECK_THROWS_WITH((j8.get<std::unordered_map<int, int>>()),
- "[json.exception.type_error.302] type must be array, "
- "but is number");
+ CHECK_THROWS_WITH_AS((j7.get<std::unordered_map<int, int>>()),
+ "[json.exception.type_error.302] type must be array, "
+ "but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS((j8.get<std::unordered_map<int, int>>()),
+ "[json.exception.type_error.302] type must be array, "
+ "but is number", json::type_error&);
SECTION("superfluous entries")
{
@@ -1610,32 +1476,26 @@
SECTION("exception in case of a non-object type")
{
- CHECK_THROWS_AS((json().get<std::list<int>>()), json::type_error&);
- CHECK_THROWS_AS((json().get<std::vector<int>>()), json::type_error&);
- CHECK_THROWS_AS((json().get<std::vector<json>>()), json::type_error&);
- CHECK_THROWS_AS((json().get<std::list<json>>()), json::type_error&);
- CHECK_THROWS_AS((json().get<std::valarray<int>>()), json::type_error&);
-
// does type really must be an array? or it rather must not be null?
// that's what I thought when other test like this one broke
- CHECK_THROWS_WITH(
+ CHECK_THROWS_WITH_AS(
(json().get<std::list<int>>()),
- "[json.exception.type_error.302] type must be array, but is null");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be array, but is null", json::type_error&);
+ CHECK_THROWS_WITH_AS(
(json().get<std::vector<int>>()),
- "[json.exception.type_error.302] type must be array, but is null");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be array, but is null", json::type_error&);
+ CHECK_THROWS_WITH_AS(
(json().get<std::vector<json>>()),
- "[json.exception.type_error.302] type must be array, but is null");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be array, but is null", json::type_error&);
+ CHECK_THROWS_WITH_AS(
(json().get<std::list<json>>()),
- "[json.exception.type_error.302] type must be array, but is null");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be array, but is null", json::type_error&);
+ CHECK_THROWS_WITH_AS(
(json().get<std::valarray<int>>()),
- "[json.exception.type_error.302] type must be array, but is null");
- CHECK_THROWS_WITH(
+ "[json.exception.type_error.302] type must be array, but is null", json::type_error&);
+ CHECK_THROWS_WITH_AS(
(json().get<std::map<int, int>>()),
- "[json.exception.type_error.302] type must be array, but is null");
+ "[json.exception.type_error.302] type must be array, but is null", json::type_error&);
}
}
}
@@ -1709,12 +1569,4 @@
}
}
-#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/test/src/unit-deserialization.cpp b/tests/src/unit-deserialization.cpp
similarity index 84%
rename from test/src/unit-deserialization.cpp
rename to tests/src/unit-deserialization.cpp
index bb24241..f4a76b3 100644
--- a/test/src/unit-deserialization.cpp
+++ b/tests/src/unit-deserialization.cpp
@@ -1,38 +1,20 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// Copyright (c) 2013-2022 Niels Lohmann <http://nlohmann.me>.
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
#include <nlohmann/json.hpp>
using nlohmann::json;
+using namespace nlohmann::literals; // NOLINT(google-build-using-namespace)
#include <iostream>
+#include <iterator>
#include <sstream>
#include <valarray>
@@ -184,6 +166,52 @@
return false;
}
};
+
+template <typename T>
+class proxy_iterator
+{
+ public:
+ using iterator = typename T::iterator;
+ using value_type = typename std::iterator_traits<iterator>::value_type;
+ using reference = typename std::iterator_traits<iterator>::reference;
+ using pointer = typename std::iterator_traits<iterator>::pointer;
+ using difference_type =
+ typename std::iterator_traits<iterator>::difference_type;
+ using iterator_category = std::input_iterator_tag;
+
+ proxy_iterator() = default;
+ explicit proxy_iterator(iterator& it) : m_it(std::addressof(it)) {}
+
+ proxy_iterator& operator++()
+ {
+ ++*m_it;
+ return *this;
+ }
+
+ proxy_iterator& operator--()
+ {
+ --*m_it;
+ return *this;
+ }
+
+ bool operator==(const proxy_iterator& rhs) const
+ {
+ return (m_it && rhs.m_it) ? (*m_it == *rhs.m_it) : (m_it == rhs.m_it);
+ }
+
+ bool operator!=(const proxy_iterator& rhs) const
+ {
+ return !(*this == rhs);
+ }
+
+ reference operator*() const
+ {
+ return **m_it;
+ }
+
+ private:
+ iterator* m_it = nullptr;
+};
} // namespace
TEST_CASE("deserialization")
@@ -281,20 +309,16 @@
SECTION("stream")
{
std::stringstream ss1;
- std::stringstream ss2;
std::stringstream ss3;
std::stringstream ss4;
std::stringstream ss5;
ss1 << R"(["foo",1,2,3,false,{"one":1})";
- ss2 << R"(["foo",1,2,3,false,{"one":1})";
ss3 << R"(["foo",1,2,3,false,{"one":1})";
ss4 << R"(["foo",1,2,3,false,{"one":1})";
ss5 << R"(["foo",1,2,3,false,{"one":1})";
json _;
- CHECK_THROWS_AS(_ = json::parse(ss1), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse(ss2),
- "[json.exception.parse_error.101] parse error at line 1, column 29: syntax error while parsing array - unexpected end of input; expected ']'");
+ CHECK_THROWS_WITH_AS(_ = json::parse(ss1), "[json.exception.parse_error.101] parse error at line 1, column 29: syntax error while parsing array - unexpected end of input; expected ']'", json::parse_error&);
CHECK(!json::accept(ss3));
json j_error;
@@ -317,9 +341,7 @@
{
json::string_t s = R"(["foo",1,2,3,false,{"one":1})";
json _;
- CHECK_THROWS_AS(_ = json::parse(s), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse(s),
- "[json.exception.parse_error.101] parse error at line 1, column 29: syntax error while parsing array - unexpected end of input; expected ']'");
+ CHECK_THROWS_WITH_AS(_ = json::parse(s), "[json.exception.parse_error.101] parse error at line 1, column 29: syntax error while parsing array - unexpected end of input; expected ']'", json::parse_error&);
CHECK(!json::accept(s));
json j_error;
@@ -340,33 +362,23 @@
SECTION("operator<<")
{
- std::stringstream ss1;
- std::stringstream ss2;
- ss1 << R"(["foo",1,2,3,false,{"one":1})";
- ss2 << R"(["foo",1,2,3,false,{"one":1})";
+ std::stringstream ss;
+ ss << R"(["foo",1,2,3,false,{"one":1})";
json j;
- CHECK_THROWS_AS(j << ss1, json::parse_error&);
- CHECK_THROWS_WITH(j << ss2,
- "[json.exception.parse_error.101] parse error at line 1, column 29: syntax error while parsing array - unexpected end of input; expected ']'");
+ CHECK_THROWS_WITH_AS(j << ss, "[json.exception.parse_error.101] parse error at line 1, column 29: syntax error while parsing array - unexpected end of input; expected ']'", json::parse_error&);
}
SECTION("operator>>")
{
- std::stringstream ss1;
- std::stringstream ss2;
- ss1 << R"(["foo",1,2,3,false,{"one":1})";
- ss2 << R"(["foo",1,2,3,false,{"one":1})";
+ std::stringstream ss;
+ ss << R"(["foo",1,2,3,false,{"one":1})";
json j;
- CHECK_THROWS_AS(ss1 >> j, json::parse_error&);
- CHECK_THROWS_WITH(ss2 >> j,
- "[json.exception.parse_error.101] parse error at line 1, column 29: syntax error while parsing array - unexpected end of input; expected ']'");
+ CHECK_THROWS_WITH_AS(ss >> j, "[json.exception.parse_error.101] parse error at line 1, column 29: syntax error while parsing array - unexpected end of input; expected ']'", json::parse_error&);
}
SECTION("user-defined string literal")
{
- CHECK_THROWS_AS("[\"foo\",1,2,3,false,{\"one\":1}"_json, json::parse_error&);
- CHECK_THROWS_WITH("[\"foo\",1,2,3,false,{\"one\":1}"_json,
- "[json.exception.parse_error.101] parse error at line 1, column 29: syntax error while parsing array - unexpected end of input; expected ']'");
+ CHECK_THROWS_WITH_AS("[\"foo\",1,2,3,false,{\"one\":1}"_json, "[json.exception.parse_error.101] parse error at line 1, column 29: syntax error while parsing array - unexpected end of input; expected ']'", json::parse_error&);
}
}
@@ -554,6 +566,28 @@
CHECK(l.events.size() == 1);
CHECK(l.events == std::vector<std::string>({"parse_error(1)"}));
}
+
+ SECTION("iterator_input_adapter advances iterators correctly")
+ {
+ using nlohmann::json;
+ using nlohmann::detail::input_format_t;
+ using nlohmann::detail::json_sax_dom_parser;
+ using proxy = proxy_iterator<std::string>;
+
+ std::string str1 = "[1]";
+ std::string str2 = "[2]";
+ std::string str = str1 + str2;
+
+ auto first = str.begin();
+ auto last = str.end();
+ json j;
+ json_sax_dom_parser<json> sax(j, true);
+
+ CHECK(json::sax_parse(proxy(first), proxy(last), &sax,
+ input_format_t::json, false));
+ CHECK(j.dump() == str1);
+ CHECK(std::string(first, last) == str2);
+ }
}
// these cases are required for 100% line coverage
@@ -648,9 +682,7 @@
{
std::array<std::uint8_t, 4> v = {{'\"', 0x7F, 0xDF, 0x7F}};
json _;
- CHECK_THROWS_AS(_ = json::parse(std::begin(v), std::end(v)), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse(std::begin(v), std::end(v)),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid string: ill-formed UTF-8 byte; last read: '\"\x7f\xdf\x7f'");
+ CHECK_THROWS_WITH_AS(_ = json::parse(std::begin(v), std::end(v)), "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - invalid string: ill-formed UTF-8 byte; last read: '\"\x7f\xdf\x7f'", json::parse_error&);
CHECK(!json::accept(std::begin(v), std::end(v)));
json j_error;
@@ -846,13 +878,9 @@
SECTION("BOM only")
{
json _;
- CHECK_THROWS_AS(_ = json::parse(bom), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse(bom),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
+ CHECK_THROWS_WITH_AS(_ = json::parse(bom), "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
- CHECK_THROWS_AS(_ = json::parse(std::istringstream(bom)), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse(std::istringstream(bom)),
- "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
+ CHECK_THROWS_WITH_AS(_ = json::parse(std::istringstream(bom)), "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
SaxEventLogger l;
CHECK(!json::sax_parse(bom, &l));
@@ -887,13 +915,9 @@
SECTION("2 byte of BOM")
{
json _;
- CHECK_THROWS_AS(_ = json::parse(bom.substr(0, 2)), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse(bom.substr(0, 2)),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid BOM; must be 0xEF 0xBB 0xBF if given; last read: '\xEF\xBB'");
+ CHECK_THROWS_WITH_AS(_ = json::parse(bom.substr(0, 2)), "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid BOM; must be 0xEF 0xBB 0xBF if given; last read: '\xEF\xBB'", json::parse_error&);
- CHECK_THROWS_AS(_ = json::parse(std::istringstream(bom.substr(0, 2))), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse(std::istringstream(bom.substr(0, 2))),
- "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid BOM; must be 0xEF 0xBB 0xBF if given; last read: '\xEF\xBB'");
+ CHECK_THROWS_WITH_AS(_ = json::parse(std::istringstream(bom.substr(0, 2))), "[json.exception.parse_error.101] parse error at line 1, column 3: syntax error while parsing value - invalid BOM; must be 0xEF 0xBB 0xBF if given; last read: '\xEF\xBB'", json::parse_error&);
SaxEventLogger l1;
SaxEventLogger l2;
@@ -914,13 +938,9 @@
SECTION("1 byte of BOM")
{
json _;
- CHECK_THROWS_AS(_ = json::parse(bom.substr(0, 1)), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse(bom.substr(0, 1)),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid BOM; must be 0xEF 0xBB 0xBF if given; last read: '\xEF'");
+ CHECK_THROWS_WITH_AS(_ = json::parse(bom.substr(0, 1)), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid BOM; must be 0xEF 0xBB 0xBF if given; last read: '\xEF'", json::parse_error&);
- CHECK_THROWS_AS(_ = json::parse(std::istringstream(bom.substr(0, 1))), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse(std::istringstream(bom.substr(0, 1))),
- "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid BOM; must be 0xEF 0xBB 0xBF if given; last read: '\xEF'");
+ CHECK_THROWS_WITH_AS(_ = json::parse(std::istringstream(bom.substr(0, 1))), "[json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value - invalid BOM; must be 0xEF 0xBB 0xBF if given; last read: '\xEF'", json::parse_error&);
SaxEventLogger l1;
SaxEventLogger l2;
@@ -1065,6 +1085,48 @@
"start_array()"
}));
}
+
+ SECTION("JSON Lines")
+ {
+ SECTION("Example file")
+ {
+ std::stringstream ss;
+ ss << R"({"name": "Gilbert", "wins": [["straight", "7♣"], ["one pair", "10♥"]]}
+ {"name": "Alexa", "wins": [["two pair", "4♠"], ["two pair", "9♠"]]}
+ {"name": "May", "wins": []}
+ {"name": "Deloise", "wins": [["three of a kind", "5♣"]]}
+)";
+
+ std::string line;
+ int object_count = 0;
+ while (std::getline(ss, line))
+ {
+ ++object_count;
+ CHECK(json::accept(line));
+ }
+
+ CHECK(object_count == 4);
+ }
+
+ SECTION("Example file without trailing newline")
+ {
+ std::stringstream ss;
+ ss << R"({"name": "Gilbert", "wins": [["straight", "7♣"], ["one pair", "10♥"]]}
+ {"name": "Alexa", "wins": [["two pair", "4♠"], ["two pair", "9♠"]]}
+ {"name": "May", "wins": []}
+ {"name": "Deloise", "wins": [["three of a kind", "5♣"]]})";
+
+ std::string line;
+ int object_count = 0;
+ while (std::getline(ss, line))
+ {
+ ++object_count;
+ CHECK(json::accept(line));
+ }
+
+ CHECK(object_count == 4);
+ }
+ }
}
TEST_CASE_TEMPLATE("deserialization of different character types (ASCII)", T,
diff --git a/test/src/unit-diagnostics.cpp b/tests/src/unit-diagnostics.cpp
similarity index 85%
rename from test/src/unit-diagnostics.cpp
rename to tests/src/unit-diagnostics.cpp
index c4d7a6a..5fe9b34 100644
--- a/test/src/unit-diagnostics.cpp
+++ b/tests/src/unit-diagnostics.cpp
@@ -1,31 +1,11 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// Copyright (c) 2013-2022 Niels Lohmann <http://nlohmann.me>.
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
diff --git a/tests/src/unit-disabled_exceptions.cpp b/tests/src/unit-disabled_exceptions.cpp
new file mode 100644
index 0000000..7d6f9da
--- /dev/null
+++ b/tests/src/unit-disabled_exceptions.cpp
@@ -0,0 +1,52 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// Copyright (c) 2013-2022 Niels Lohmann <http://nlohmann.me>.
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+// disable -Wnoexcept as exceptions are switched off for this test suite
+DOCTEST_GCC_SUPPRESS_WARNING_PUSH
+DOCTEST_GCC_SUPPRESS_WARNING("-Wnoexcept")
+
+#include <nlohmann/json.hpp>
+using json = nlohmann::json;
+
+/////////////////////////////////////////////////////////////////////
+// for #2824
+/////////////////////////////////////////////////////////////////////
+
+class sax_no_exception : public nlohmann::detail::json_sax_dom_parser<json>
+{
+ public:
+ explicit sax_no_exception(json& j) : nlohmann::detail::json_sax_dom_parser<json>(j, false) {}
+
+ static bool parse_error(std::size_t /*position*/, const std::string& /*last_token*/, const json::exception& ex)
+ {
+ error_string = new std::string(ex.what()); // NOLINT(cppcoreguidelines-owning-memory)
+ return false;
+ }
+
+ static std::string* error_string;
+};
+
+std::string* sax_no_exception::error_string = nullptr;
+
+TEST_CASE("Tests with disabled exceptions")
+{
+ SECTION("issue #2824 - encoding of json::exception::what()")
+ {
+ json j;
+ sax_no_exception sax(j);
+
+ CHECK (!json::sax_parse("xyz", &sax));
+ CHECK(*sax_no_exception::error_string == "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - invalid literal; last read: 'x'");
+ delete sax_no_exception::error_string; // NOLINT(cppcoreguidelines-owning-memory)
+ }
+}
+
+DOCTEST_GCC_SUPPRESS_WARNING_POP
diff --git a/tests/src/unit-element_access1.cpp b/tests/src/unit-element_access1.cpp
new file mode 100644
index 0000000..7051405
--- /dev/null
+++ b/tests/src/unit-element_access1.cpp
@@ -0,0 +1,881 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// Copyright (c) 2013-2022 Niels Lohmann <http://nlohmann.me>.
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#include <nlohmann/json.hpp>
+using nlohmann::json;
+
+TEST_CASE("element access 1")
+{
+ SECTION("array")
+ {
+ json j = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ const json j_const = j;
+
+ SECTION("access specified element with bounds checking")
+ {
+ SECTION("access within bounds")
+ {
+ CHECK(j.at(0) == json(1));
+ CHECK(j.at(1) == json(1u));
+ CHECK(j.at(2) == json(true));
+ CHECK(j.at(3) == json(nullptr));
+ CHECK(j.at(4) == json("string"));
+ CHECK(j.at(5) == json(42.23));
+ CHECK(j.at(6) == json::object());
+ CHECK(j.at(7) == json({1, 2, 3}));
+
+ CHECK(j_const.at(0) == json(1));
+ CHECK(j_const.at(1) == json(1u));
+ CHECK(j_const.at(2) == json(true));
+ CHECK(j_const.at(3) == json(nullptr));
+ CHECK(j_const.at(4) == json("string"));
+ CHECK(j_const.at(5) == json(42.23));
+ CHECK(j_const.at(6) == json::object());
+ CHECK(j_const.at(7) == json({1, 2, 3}));
+ }
+
+ SECTION("access outside bounds")
+ {
+ CHECK_THROWS_WITH_AS(j.at(8),
+ "[json.exception.out_of_range.401] array index 8 is out of range", json::out_of_range&);
+ CHECK_THROWS_WITH_AS(j_const.at(8),
+ "[json.exception.out_of_range.401] array index 8 is out of range", json::out_of_range&);
+ }
+
+ SECTION("access on non-array type")
+ {
+ SECTION("null")
+ {
+ json j_nonarray(json::value_t::null);
+ const json j_nonarray_const(j_nonarray);
+
+ CHECK_THROWS_WITH_AS(j_nonarray.at(0), "[json.exception.type_error.304] cannot use at() with null", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray_const.at(0), "[json.exception.type_error.304] cannot use at() with null", json::type_error&);
+ }
+
+ SECTION("boolean")
+ {
+ json j_nonarray(json::value_t::boolean);
+ const json j_nonarray_const(j_nonarray);
+
+ CHECK_THROWS_WITH_AS(j_nonarray.at(0), "[json.exception.type_error.304] cannot use at() with boolean", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray_const.at(0), "[json.exception.type_error.304] cannot use at() with boolean", json::type_error&);
+ }
+
+ SECTION("string")
+ {
+ json j_nonarray(json::value_t::string);
+ const json j_nonarray_const(j_nonarray);
+
+ CHECK_THROWS_WITH_AS(j_nonarray.at(0), "[json.exception.type_error.304] cannot use at() with string", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray_const.at(0), "[json.exception.type_error.304] cannot use at() with string", json::type_error&);
+ }
+
+ SECTION("object")
+ {
+ json j_nonarray(json::value_t::object);
+ const json j_nonarray_const(j_nonarray);
+
+ CHECK_THROWS_WITH_AS(j_nonarray.at(0), "[json.exception.type_error.304] cannot use at() with object", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray_const.at(0), "[json.exception.type_error.304] cannot use at() with object", json::type_error&);
+ }
+
+ SECTION("number (integer)")
+ {
+ json j_nonarray(json::value_t::number_integer);
+ const json j_nonarray_const(j_nonarray);
+
+ CHECK_THROWS_WITH_AS(j_nonarray.at(0), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray_const.at(0), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+ }
+
+ SECTION("number (unsigned)")
+ {
+ json j_nonarray(json::value_t::number_unsigned);
+ const json j_nonarray_const(j_nonarray);
+
+ CHECK_THROWS_WITH_AS(j_nonarray.at(0), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray_const.at(0), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+ }
+
+ SECTION("number (floating-point)")
+ {
+ json j_nonarray(json::value_t::number_float);
+ const json j_nonarray_const(j_nonarray);
+
+ CHECK_THROWS_WITH_AS(j_nonarray.at(0), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray_const.at(0), "[json.exception.type_error.304] cannot use at() with number", json::type_error&);
+ }
+ }
+ }
+
+ SECTION("front and back")
+ {
+ CHECK(j.front() == json(1));
+ CHECK(j_const.front() == json(1));
+ CHECK(j.back() == json({1, 2, 3}));
+ CHECK(j_const.back() == json({1, 2, 3}));
+ }
+
+ SECTION("access specified element")
+ {
+ SECTION("access within bounds")
+ {
+ CHECK(j[0] == json(1));
+ CHECK(j[1] == json(1u));
+ CHECK(j[2] == json(true));
+ CHECK(j[3] == json(nullptr));
+ CHECK(j[4] == json("string"));
+ CHECK(j[5] == json(42.23));
+ CHECK(j[6] == json::object());
+ CHECK(j[7] == json({1, 2, 3}));
+
+ CHECK(j_const[0] == json(1));
+ CHECK(j_const[1] == json(1u));
+ CHECK(j_const[2] == json(true));
+ CHECK(j_const[3] == json(nullptr));
+ CHECK(j_const[4] == json("string"));
+ CHECK(j_const[5] == json(42.23));
+ CHECK(j_const[6] == json::object());
+ CHECK(j_const[7] == json({1, 2, 3}));
+ }
+
+ SECTION("access on non-array type")
+ {
+ SECTION("null")
+ {
+ SECTION("standard tests")
+ {
+ json j_nonarray(json::value_t::null);
+ const json j_nonarray_const(j_nonarray);
+ CHECK_NOTHROW(j_nonarray[0]);
+ CHECK_THROWS_WITH_AS(j_nonarray_const[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with null", json::type_error&);
+ }
+
+ SECTION("implicit transformation to properly filled array")
+ {
+ json j_nonarray;
+ j_nonarray[3] = 42;
+ CHECK(j_nonarray == json({nullptr, nullptr, nullptr, 42}));
+ }
+ }
+
+ SECTION("boolean")
+ {
+ json j_nonarray(json::value_t::boolean);
+ const json j_nonarray_const(j_nonarray);
+ CHECK_THROWS_WITH_AS(j_nonarray[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with boolean", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray_const[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with boolean", json::type_error&);
+ }
+
+ SECTION("string")
+ {
+ json j_nonarray(json::value_t::string);
+ const json j_nonarray_const(j_nonarray);
+ CHECK_THROWS_WITH_AS(j_nonarray[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with string", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray_const[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with string", json::type_error&);
+ }
+
+ SECTION("object")
+ {
+ json j_nonarray(json::value_t::object);
+ const json j_nonarray_const(j_nonarray);
+ CHECK_THROWS_WITH_AS(j_nonarray[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with object", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray_const[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with object", json::type_error&);
+ }
+
+ SECTION("number (integer)")
+ {
+ json j_nonarray(json::value_t::number_integer);
+ const json j_nonarray_const(j_nonarray);
+ CHECK_THROWS_WITH_AS(j_nonarray[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with number", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray_const[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with number", json::type_error&);
+ }
+
+ SECTION("number (unsigned)")
+ {
+ json j_nonarray(json::value_t::number_unsigned);
+ const json j_nonarray_const(j_nonarray);
+ CHECK_THROWS_WITH_AS(j_nonarray[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with number", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray_const[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with number", json::type_error&);
+ }
+
+ SECTION("number (floating-point)")
+ {
+ json j_nonarray(json::value_t::number_float);
+ const json j_nonarray_const(j_nonarray);
+ CHECK_THROWS_WITH_AS(j_nonarray[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with number", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray_const[0], "[json.exception.type_error.305] cannot use operator[] with a numeric argument with number", json::type_error&);
+ }
+ }
+ }
+
+ SECTION("remove specified element")
+ {
+ SECTION("remove element by index")
+ {
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ jarray.erase(0);
+ CHECK(jarray == json({1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}}));
+ }
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ jarray.erase(1);
+ CHECK(jarray == json({1, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}}));
+ }
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ jarray.erase(2);
+ CHECK(jarray == json({1, 1u, nullptr, "string", 42.23, json::object(), {1, 2, 3}}));
+ }
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ jarray.erase(3);
+ CHECK(jarray == json({1, 1u, true, "string", 42.23, json::object(), {1, 2, 3}}));
+ }
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ jarray.erase(4);
+ CHECK(jarray == json({1, 1u, true, nullptr, 42.23, json::object(), {1, 2, 3}}));
+ }
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ jarray.erase(5);
+ CHECK(jarray == json({1, 1u, true, nullptr, "string", json::object(), {1, 2, 3}}));
+ }
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ jarray.erase(6);
+ CHECK(jarray == json({1, 1u, true, nullptr, "string", 42.23, {1, 2, 3}}));
+ }
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ jarray.erase(7);
+ CHECK(jarray == json({1, 1u, true, nullptr, "string", 42.23, json::object()}));
+ }
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ CHECK_THROWS_WITH_AS(jarray.erase(8), "[json.exception.out_of_range.401] array index 8 is out of range", json::out_of_range&);
+ }
+ }
+
+ SECTION("remove element by iterator")
+ {
+ SECTION("erase(begin())")
+ {
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ json::iterator it2 = jarray.erase(jarray.begin());
+ CHECK(jarray == json({1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}}));
+ CHECK(*it2 == json(1u));
+ }
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ json::const_iterator it2 = jarray.erase(jarray.cbegin());
+ CHECK(jarray == json({1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}}));
+ CHECK(*it2 == json(1u));
+ }
+ }
+
+ SECTION("erase(begin(), end())")
+ {
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ json::iterator it2 = jarray.erase(jarray.begin(), jarray.end());
+ CHECK(jarray == json::array());
+ CHECK(it2 == jarray.end());
+ }
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ json::const_iterator it2 = jarray.erase(jarray.cbegin(), jarray.cend());
+ CHECK(jarray == json::array());
+ CHECK(it2 == jarray.cend());
+ }
+ }
+
+ SECTION("erase(begin(), begin())")
+ {
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ json::iterator it2 = jarray.erase(jarray.begin(), jarray.begin());
+ CHECK(jarray == json({1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}}));
+ CHECK(*it2 == json(1));
+ }
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ json::const_iterator it2 = jarray.erase(jarray.cbegin(), jarray.cbegin());
+ CHECK(jarray == json({1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}}));
+ CHECK(*it2 == json(1));
+ }
+ }
+
+ SECTION("erase at offset")
+ {
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ json::iterator it = jarray.begin() + 4;
+ json::iterator it2 = jarray.erase(it);
+ CHECK(jarray == json({1, 1u, true, nullptr, 42.23, json::object(), {1, 2, 3}}));
+ CHECK(*it2 == json(42.23));
+ }
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ json::const_iterator it = jarray.cbegin() + 4;
+ json::const_iterator it2 = jarray.erase(it);
+ CHECK(jarray == json({1, 1u, true, nullptr, 42.23, json::object(), {1, 2, 3}}));
+ CHECK(*it2 == json(42.23));
+ }
+ }
+
+ SECTION("erase subrange")
+ {
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ json::iterator it2 = jarray.erase(jarray.begin() + 3, jarray.begin() + 6);
+ CHECK(jarray == json({1, 1u, true, json::object(), {1, 2, 3}}));
+ CHECK(*it2 == json::object());
+ }
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ json::const_iterator it2 = jarray.erase(jarray.cbegin() + 3, jarray.cbegin() + 6);
+ CHECK(jarray == json({1, 1u, true, json::object(), {1, 2, 3}}));
+ CHECK(*it2 == json::object());
+ }
+ }
+
+ SECTION("different arrays")
+ {
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ json jarray2 = {"foo", "bar"};
+
+ CHECK_THROWS_WITH_AS(jarray.erase(jarray2.begin()),
+ "[json.exception.invalid_iterator.202] iterator does not fit current value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(jarray.erase(jarray.begin(), jarray2.end()),
+ "[json.exception.invalid_iterator.203] iterators do not fit current value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(jarray.erase(jarray2.begin(), jarray.end()),
+ "[json.exception.invalid_iterator.203] iterators do not fit current value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(jarray.erase(jarray2.begin(), jarray2.end()),
+ "[json.exception.invalid_iterator.203] iterators do not fit current value", json::invalid_iterator&);
+ }
+ {
+ json jarray = {1, 1u, true, nullptr, "string", 42.23, json::object(), {1, 2, 3}};
+ json jarray2 = {"foo", "bar"};
+
+ CHECK_THROWS_WITH_AS(jarray.erase(jarray2.cbegin()),
+ "[json.exception.invalid_iterator.202] iterator does not fit current value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(jarray.erase(jarray.cbegin(), jarray2.cend()),
+ "[json.exception.invalid_iterator.203] iterators do not fit current value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(jarray.erase(jarray2.cbegin(), jarray.cend()),
+ "[json.exception.invalid_iterator.203] iterators do not fit current value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(jarray.erase(jarray2.cbegin(), jarray2.cend()),
+ "[json.exception.invalid_iterator.203] iterators do not fit current value", json::invalid_iterator&);
+ }
+ }
+ }
+
+ SECTION("remove element by index in non-array type")
+ {
+ SECTION("null")
+ {
+ json j_nonobject(json::value_t::null);
+ CHECK_THROWS_WITH_AS(j_nonobject.erase(0), "[json.exception.type_error.307] cannot use erase() with null", json::type_error&);
+ }
+
+ SECTION("boolean")
+ {
+ json j_nonobject(json::value_t::boolean);
+ CHECK_THROWS_WITH_AS(j_nonobject.erase(0), "[json.exception.type_error.307] cannot use erase() with boolean", json::type_error&);
+ }
+
+ SECTION("string")
+ {
+ json j_nonobject(json::value_t::string);
+ CHECK_THROWS_WITH_AS(j_nonobject.erase(0), "[json.exception.type_error.307] cannot use erase() with string", json::type_error&);
+ }
+
+ SECTION("object")
+ {
+ json j_nonobject(json::value_t::object);
+ CHECK_THROWS_WITH_AS(j_nonobject.erase(0), "[json.exception.type_error.307] cannot use erase() with object", json::type_error&);
+ }
+
+ SECTION("number (integer)")
+ {
+ json j_nonobject(json::value_t::number_integer);
+ CHECK_THROWS_WITH_AS(j_nonobject.erase(0), "[json.exception.type_error.307] cannot use erase() with number", json::type_error&);
+ }
+
+ SECTION("number (unsigned)")
+ {
+ json j_nonobject(json::value_t::number_unsigned);
+ CHECK_THROWS_WITH_AS(j_nonobject.erase(0), "[json.exception.type_error.307] cannot use erase() with number", json::type_error&);
+ }
+
+ SECTION("number (floating-point)")
+ {
+ json j_nonobject(json::value_t::number_float);
+ CHECK_THROWS_WITH_AS(j_nonobject.erase(0), "[json.exception.type_error.307] cannot use erase() with number", json::type_error&);
+ }
+ }
+ }
+ }
+
+ SECTION("other values")
+ {
+ SECTION("front and back")
+ {
+ SECTION("null")
+ {
+ {
+ json j;
+ CHECK_THROWS_WITH_AS(j.front(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.back(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ }
+ {
+ const json j{};
+ CHECK_THROWS_WITH_AS(j.front(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.back(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("string")
+ {
+ {
+ json j = "foo";
+ CHECK(j.front() == j);
+ CHECK(j.back() == j);
+ }
+ {
+ const json j = "bar";
+ CHECK(j.front() == j);
+ CHECK(j.back() == j);
+ }
+ }
+
+ SECTION("number (boolean)")
+ {
+ {
+ json j = false;
+ CHECK(j.front() == j);
+ CHECK(j.back() == j);
+ }
+ {
+ const json j = true;
+ CHECK(j.front() == j);
+ CHECK(j.back() == j);
+ }
+ }
+
+ SECTION("number (integer)")
+ {
+ {
+ json j = 17;
+ CHECK(j.front() == j);
+ CHECK(j.back() == j);
+ }
+ {
+ const json j = 17;
+ CHECK(j.front() == j);
+ CHECK(j.back() == j);
+ }
+ }
+
+ SECTION("number (unsigned)")
+ {
+ {
+ json j = 17u;
+ CHECK(j.front() == j);
+ CHECK(j.back() == j);
+ }
+ {
+ const json j = 17u;
+ CHECK(j.front() == j);
+ CHECK(j.back() == j);
+ }
+ }
+
+ SECTION("number (floating point)")
+ {
+ {
+ json j = 23.42;
+ CHECK(j.front() == j);
+ CHECK(j.back() == j);
+ }
+ {
+ const json j = 23.42;
+ CHECK(j.front() == j);
+ CHECK(j.back() == j);
+ }
+ }
+ }
+
+ SECTION("erase with one valid iterator")
+ {
+ SECTION("null")
+ {
+ {
+ json j;
+ CHECK_THROWS_WITH_AS(j.erase(j.begin()), "[json.exception.type_error.307] cannot use erase() with null", json::type_error&);
+ }
+ {
+ json j;
+ CHECK_THROWS_WITH_AS(j.erase(j.begin()),
+ "[json.exception.type_error.307] cannot use erase() with null", json::type_error&);
+ }
+ }
+
+ SECTION("string")
+ {
+ {
+ json j = "foo";
+ json::iterator it = j.erase(j.begin());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ {
+ json j = "bar";
+ json::const_iterator it = j.erase(j.cbegin());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ }
+
+ SECTION("number (boolean)")
+ {
+ {
+ json j = false;
+ json::iterator it = j.erase(j.begin());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ {
+ json j = true;
+ json::const_iterator it = j.erase(j.cbegin());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ }
+
+ SECTION("number (integer)")
+ {
+ {
+ json j = 17;
+ json::iterator it = j.erase(j.begin());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ {
+ json j = 17;
+ json::const_iterator it = j.erase(j.cbegin());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ }
+
+ SECTION("number (unsigned)")
+ {
+ {
+ json j = 17u;
+ json::iterator it = j.erase(j.begin());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ {
+ json j = 17u;
+ json::const_iterator it = j.erase(j.cbegin());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ }
+
+ SECTION("number (floating point)")
+ {
+ {
+ json j = 23.42;
+ json::iterator it = j.erase(j.begin());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ {
+ json j = 23.42;
+ json::const_iterator it = j.erase(j.cbegin());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ }
+
+ SECTION("binary")
+ {
+ {
+ json j = json::binary({1, 2, 3});
+ json::iterator it = j.erase(j.begin());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ {
+ json j = json::binary({1, 2, 3});
+ json::const_iterator it = j.erase(j.cbegin());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ }
+ }
+
+ SECTION("erase with one invalid iterator")
+ {
+ SECTION("string")
+ {
+ {
+ json j = "foo";
+ CHECK_THROWS_WITH_AS(j.erase(j.end()), "[json.exception.invalid_iterator.205] iterator out of range", json::invalid_iterator&);
+ }
+ {
+ json j = "bar";
+ CHECK_THROWS_WITH_AS(j.erase(j.cend()), "[json.exception.invalid_iterator.205] iterator out of range", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("number (boolean)")
+ {
+ {
+ json j = false;
+ CHECK_THROWS_WITH_AS(j.erase(j.end()), "[json.exception.invalid_iterator.205] iterator out of range", json::invalid_iterator&);
+ }
+ {
+ json j = true;
+ CHECK_THROWS_WITH_AS(j.erase(j.cend()), "[json.exception.invalid_iterator.205] iterator out of range", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("number (integer)")
+ {
+ {
+ json j = 17;
+ CHECK_THROWS_WITH_AS(j.erase(j.end()), "[json.exception.invalid_iterator.205] iterator out of range", json::invalid_iterator&);
+ }
+ {
+ json j = 17;
+ CHECK_THROWS_WITH_AS(j.erase(j.cend()), "[json.exception.invalid_iterator.205] iterator out of range", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("number (unsigned)")
+ {
+ {
+ json j = 17u;
+ CHECK_THROWS_WITH_AS(j.erase(j.end()), "[json.exception.invalid_iterator.205] iterator out of range", json::invalid_iterator&);
+ }
+ {
+ json j = 17u;
+ CHECK_THROWS_WITH_AS(j.erase(j.cend()), "[json.exception.invalid_iterator.205] iterator out of range", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("number (floating point)")
+ {
+ {
+ json j = 23.42;
+ CHECK_THROWS_WITH_AS(j.erase(j.end()), "[json.exception.invalid_iterator.205] iterator out of range", json::invalid_iterator&);
+ }
+ {
+ json j = 23.42;
+ CHECK_THROWS_WITH_AS(j.erase(j.cend()), "[json.exception.invalid_iterator.205] iterator out of range", json::invalid_iterator&);
+ }
+ }
+ }
+
+ SECTION("erase with two valid iterators")
+ {
+ SECTION("null")
+ {
+ {
+ json j;
+ CHECK_THROWS_WITH_AS(j.erase(j.begin(), j.end()), "[json.exception.type_error.307] cannot use erase() with null", json::type_error&);
+ }
+ {
+ json j;
+ CHECK_THROWS_WITH_AS(j.erase(j.cbegin(), j.cend()), "[json.exception.type_error.307] cannot use erase() with null", json::type_error&);
+ }
+ }
+
+ SECTION("string")
+ {
+ {
+ json j = "foo";
+ json::iterator it = j.erase(j.begin(), j.end());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ {
+ json j = "bar";
+ json::const_iterator it = j.erase(j.cbegin(), j.cend());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ }
+
+ SECTION("number (boolean)")
+ {
+ {
+ json j = false;
+ json::iterator it = j.erase(j.begin(), j.end());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ {
+ json j = true;
+ json::const_iterator it = j.erase(j.cbegin(), j.cend());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ }
+
+ SECTION("number (integer)")
+ {
+ {
+ json j = 17;
+ json::iterator it = j.erase(j.begin(), j.end());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ {
+ json j = 17;
+ json::const_iterator it = j.erase(j.cbegin(), j.cend());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ }
+
+ SECTION("number (unsigned)")
+ {
+ {
+ json j = 17u;
+ json::iterator it = j.erase(j.begin(), j.end());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ {
+ json j = 17u;
+ json::const_iterator it = j.erase(j.cbegin(), j.cend());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ }
+
+ SECTION("number (floating point)")
+ {
+ {
+ json j = 23.42;
+ json::iterator it = j.erase(j.begin(), j.end());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ {
+ json j = 23.42;
+ json::const_iterator it = j.erase(j.cbegin(), j.cend());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ }
+
+ SECTION("binary")
+ {
+ {
+ json j = json::binary({1, 2, 3});
+ json::iterator it = j.erase(j.begin(), j.end());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ {
+ json j = json::binary({1, 2, 3});
+ json::const_iterator it = j.erase(j.cbegin(), j.cend());
+ CHECK(j.type() == json::value_t::null);
+ CHECK(it == j.end());
+ }
+ }
+ }
+
+ SECTION("erase with two invalid iterators")
+ {
+ SECTION("string")
+ {
+ {
+ json j = "foo";
+ CHECK_THROWS_WITH_AS(j.erase(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.erase(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ }
+ {
+ json j = "bar";
+ CHECK_THROWS_WITH_AS(j.erase(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.erase(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("number (boolean)")
+ {
+ {
+ json j = false;
+ CHECK_THROWS_WITH_AS(j.erase(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.erase(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ }
+ {
+ json j = true;
+ CHECK_THROWS_WITH_AS(j.erase(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.erase(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("number (integer)")
+ {
+ {
+ json j = 17;
+ CHECK_THROWS_WITH_AS(j.erase(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.erase(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ }
+ {
+ json j = 17;
+ CHECK_THROWS_WITH_AS(j.erase(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.erase(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("number (unsigned)")
+ {
+ {
+ json j = 17u;
+ CHECK_THROWS_WITH_AS(j.erase(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.erase(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ }
+ {
+ json j = 17u;
+ CHECK_THROWS_WITH_AS(j.erase(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.erase(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("number (floating point)")
+ {
+ {
+ json j = 23.42;
+ CHECK_THROWS_WITH_AS(j.erase(j.end(), j.end()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.erase(j.begin(), j.begin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ }
+ {
+ json j = 23.42;
+ CHECK_THROWS_WITH_AS(j.erase(j.cend(), j.cend()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.erase(j.cbegin(), j.cbegin()), "[json.exception.invalid_iterator.204] iterators out of range", json::invalid_iterator&);
+ }
+ }
+ }
+ }
+}
diff --git a/tests/src/unit-element_access2.cpp b/tests/src/unit-element_access2.cpp
new file mode 100644
index 0000000..ab59461
--- /dev/null
+++ b/tests/src/unit-element_access2.cpp
@@ -0,0 +1,1488 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// Copyright (c) 2013-2022 Niels Lohmann <http://nlohmann.me>.
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#include <nlohmann/json.hpp>
+using namespace nlohmann::literals; // NOLINT(google-build-using-namespace)
+
+TEST_CASE_TEMPLATE("element access 2", Json, nlohmann::json, nlohmann::ordered_json)
+{
+ SECTION("object")
+ {
+ Json j = {{"integer", 1}, {"unsigned", 1u}, {"floating", 42.23}, {"null", nullptr}, {"string", "hello world"}, {"boolean", true}, {"object", Json::object()}, {"array", {1, 2, 3}}};
+ const Json j_const = j;
+
+ SECTION("access specified element with bounds checking")
+ {
+ SECTION("access within bounds")
+ {
+ CHECK(j.at("integer") == Json(1));
+ CHECK(j.at("unsigned") == Json(1u));
+ CHECK(j.at("boolean") == Json(true));
+ CHECK(j.at("null") == Json(nullptr));
+ CHECK(j.at("string") == Json("hello world"));
+ CHECK(j.at("floating") == Json(42.23));
+ CHECK(j.at("object") == Json::object());
+ CHECK(j.at("array") == Json({1, 2, 3}));
+
+ CHECK(j_const.at("integer") == Json(1));
+ CHECK(j_const.at("unsigned") == Json(1u));
+ CHECK(j_const.at("boolean") == Json(true));
+ CHECK(j_const.at("null") == Json(nullptr));
+ CHECK(j_const.at("string") == Json("hello world"));
+ 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", typename Json::out_of_range&);
+ CHECK_THROWS_WITH_AS(j_const.at("foo"), "[json.exception.out_of_range.403] key 'foo' not found", typename 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", typename 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", typename Json::out_of_range&);
+#endif
+ }
+
+ SECTION("access on non-object type")
+ {
+ SECTION("null")
+ {
+ Json j_nonobject(Json::value_t::null);
+ 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with null", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("boolean")
+ {
+ Json j_nonobject(Json::value_t::boolean);
+ 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with boolean", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("string")
+ {
+ Json j_nonobject(Json::value_t::string);
+ 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with string", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("array")
+ {
+ Json j_nonobject(Json::value_t::array);
+ 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with array", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("number (integer)")
+ {
+ Json j_nonobject(Json::value_t::number_integer);
+ 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with number", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("number (unsigned)")
+ {
+ Json j_nonobject(Json::value_t::number_unsigned);
+ 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with number", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("number (floating-point)")
+ {
+ Json j_nonobject(Json::value_t::number_float);
+ 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.at("foo"), "[json.exception.type_error.304] cannot use at() with number", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+ }
+ }
+
+ SECTION("access specified element with default value")
+ {
+ SECTION("given a key")
+ {
+ SECTION("access existing value")
+ {
+ CHECK(j.value("integer", 2) == 1);
+ CHECK(j.value("integer", 1.0) == Approx(1));
+ CHECK(j.value("unsigned", 2) == 1u);
+ CHECK(j.value("unsigned", 1.0) == Approx(1u));
+ CHECK(j.value("null", Json(1)) == Json());
+ CHECK(j.value("boolean", false) == true);
+ CHECK(j.value("string", "bar") == "hello world");
+ CHECK(j.value("string", std::string("bar")) == "hello world");
+ CHECK(j.value("floating", 12.34) == Approx(42.23));
+ CHECK(j.value("floating", 12) == 42);
+ CHECK(j.value("object", Json({{"foo", "bar"}})) == Json::object());
+ CHECK(j.value("array", Json({10, 100})) == Json({1, 2, 3}));
+
+ CHECK(j_const.value("integer", 2) == 1);
+ CHECK(j_const.value("integer", 1.0) == Approx(1));
+ CHECK(j_const.value("unsigned", 2) == 1u);
+ CHECK(j_const.value("unsigned", 1.0) == Approx(1u));
+ CHECK(j_const.value("boolean", false) == true);
+ CHECK(j_const.value("string", "bar") == "hello world");
+ CHECK(j_const.value("string", std::string("bar")) == "hello world");
+ CHECK(j_const.value("floating", 12.34) == Approx(42.23));
+ 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")
+ {
+ CHECK(j.value("_", 2) == 2);
+ CHECK(j.value("_", 2u) == 2u);
+ CHECK(j.value("_", false) == false);
+ CHECK(j.value("_", "bar") == "bar");
+ CHECK(j.value("_", 12.34) == Approx(12.34));
+ CHECK(j.value("_", Json({{"foo", "bar"}})) == Json({{"foo", "bar"}}));
+ CHECK(j.value("_", Json({10, 100})) == Json({10, 100}));
+
+ CHECK(j_const.value("_", 2) == 2);
+ CHECK(j_const.value("_", 2u) == 2u);
+ CHECK(j_const.value("_", false) == false);
+ CHECK(j_const.value("_", "bar") == "bar");
+ 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")
+ {
+ SECTION("null")
+ {
+ Json j_nonobject(Json::value_t::null);
+ 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.value("foo", 1), "[json.exception.type_error.306] cannot use value() with null", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("boolean")
+ {
+ Json j_nonobject(Json::value_t::boolean);
+ 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.value("foo", 1), "[json.exception.type_error.306] cannot use value() with boolean", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("string")
+ {
+ Json j_nonobject(Json::value_t::string);
+ 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.value("foo", 1), "[json.exception.type_error.306] cannot use value() with string", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("array")
+ {
+ Json j_nonobject(Json::value_t::array);
+ 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.value("foo", 1), "[json.exception.type_error.306] cannot use value() with array", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("number (integer)")
+ {
+ Json j_nonobject(Json::value_t::number_integer);
+ 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.value("foo", 1), "[json.exception.type_error.306] cannot use value() with number", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("number (unsigned)")
+ {
+ Json j_nonobject(Json::value_t::number_unsigned);
+ 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.value("foo", 1), "[json.exception.type_error.306] cannot use value() with number", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("number (floating-point)")
+ {
+ Json j_nonobject(Json::value_t::number_float);
+ 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.value("foo", 1), "[json.exception.type_error.306] cannot use value() with number", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+ }
+ }
+
+ SECTION("given a JSON pointer")
+ {
+ SECTION("access existing value")
+ {
+ CHECK(j.value("/integer"_json_pointer, 2) == 1);
+ CHECK(j.value("/integer"_json_pointer, 1.0) == Approx(1));
+ CHECK(j.value("/unsigned"_json_pointer, 2) == 1u);
+ CHECK(j.value("/unsigned"_json_pointer, 1.0) == Approx(1u));
+ CHECK(j.value("/null"_json_pointer, Json(1)) == Json());
+ CHECK(j.value("/boolean"_json_pointer, false) == true);
+ CHECK(j.value("/string"_json_pointer, "bar") == "hello world");
+ CHECK(j.value("/string"_json_pointer, std::string("bar")) == "hello world");
+ CHECK(j.value("/floating"_json_pointer, 12.34) == Approx(42.23));
+ CHECK(j.value("/floating"_json_pointer, 12) == 42);
+ CHECK(j.value("/object"_json_pointer, Json({{"foo", "bar"}})) == Json::object());
+ CHECK(j.value("/array"_json_pointer, Json({10, 100})) == Json({1, 2, 3}));
+
+ CHECK(j_const.value("/integer"_json_pointer, 2) == 1);
+ CHECK(j_const.value("/integer"_json_pointer, 1.0) == Approx(1));
+ CHECK(j_const.value("/unsigned"_json_pointer, 2) == 1u);
+ CHECK(j_const.value("/unsigned"_json_pointer, 1.0) == Approx(1u));
+ CHECK(j_const.value("/boolean"_json_pointer, false) == true);
+ CHECK(j_const.value("/string"_json_pointer, "bar") == "hello world");
+ CHECK(j_const.value("/string"_json_pointer, std::string("bar")) == "hello world");
+ CHECK(j_const.value("/floating"_json_pointer, 12.34) == Approx(42.23));
+ CHECK(j_const.value("/floating"_json_pointer, 12) == 42);
+ CHECK(j_const.value("/object"_json_pointer, Json({{"foo", "bar"}})) == Json::object());
+ CHECK(j_const.value("/array"_json_pointer, Json({10, 100})) == Json({1, 2, 3}));
+ }
+
+ SECTION("access on non-object type")
+ {
+ SECTION("null")
+ {
+ Json j_nonobject(Json::value_t::null);
+ const Json j_nonobject_const(Json::value_t::null);
+ CHECK_THROWS_WITH_AS(j_nonobject.value("/foo"_json_pointer, 1), "[json.exception.type_error.306] cannot use value() with null", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.value("/foo"_json_pointer, 1), "[json.exception.type_error.306] cannot use value() with null", typename Json::type_error&);
+ }
+
+ SECTION("boolean")
+ {
+ Json j_nonobject(Json::value_t::boolean);
+ const Json j_nonobject_const(Json::value_t::boolean);
+ CHECK_THROWS_WITH_AS(j_nonobject.value("/foo"_json_pointer, 1), "[json.exception.type_error.306] cannot use value() with boolean", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.value("/foo"_json_pointer, 1), "[json.exception.type_error.306] cannot use value() with boolean", typename Json::type_error&);
+ }
+
+ SECTION("string")
+ {
+ Json j_nonobject(Json::value_t::string);
+ const Json j_nonobject_const(Json::value_t::string);
+ CHECK_THROWS_WITH_AS(j_nonobject.value("/foo"_json_pointer, 1), "[json.exception.type_error.306] cannot use value() with string", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.value("/foo"_json_pointer, 1), "[json.exception.type_error.306] cannot use value() with string", typename Json::type_error&);
+ }
+
+ SECTION("array")
+ {
+ Json j_nonobject(Json::value_t::array);
+ const Json j_nonobject_const(Json::value_t::array);
+ CHECK_THROWS_WITH_AS(j_nonobject.value("/foo"_json_pointer, 1), "[json.exception.type_error.306] cannot use value() with array", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.value("/foo"_json_pointer, 1), "[json.exception.type_error.306] cannot use value() with array", typename Json::type_error&);
+ }
+
+ SECTION("number (integer)")
+ {
+ Json j_nonobject(Json::value_t::number_integer);
+ const Json j_nonobject_const(Json::value_t::number_integer);
+ CHECK_THROWS_WITH_AS(j_nonobject.value("/foo"_json_pointer, 1), "[json.exception.type_error.306] cannot use value() with number", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.value("/foo"_json_pointer, 1), "[json.exception.type_error.306] cannot use value() with number", typename Json::type_error&);
+ }
+
+ SECTION("number (unsigned)")
+ {
+ Json j_nonobject(Json::value_t::number_unsigned);
+ const Json j_nonobject_const(Json::value_t::number_unsigned);
+ CHECK_THROWS_WITH_AS(j_nonobject.value("/foo"_json_pointer, 1), "[json.exception.type_error.306] cannot use value() with number", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.value("/foo"_json_pointer, 1), "[json.exception.type_error.306] cannot use value() with number", typename Json::type_error&);
+ }
+
+ SECTION("number (floating-point)")
+ {
+ Json j_nonobject(Json::value_t::number_float);
+ const Json j_nonobject_const(Json::value_t::number_float);
+ CHECK_THROWS_WITH_AS(j_nonobject.value("/foo"_json_pointer, 1), "[json.exception.type_error.306] cannot use value() with number", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject_const.value("/foo"_json_pointer, 1), "[json.exception.type_error.306] cannot use value() with number", typename Json::type_error&);
+ }
+ }
+ }
+ }
+
+ 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")
+ {
+ if (std::is_same<Json, nlohmann::ordered_json>::value)
+ {
+ // "integer" is the first key
+ CHECK(j.front() == Json(1));
+ CHECK(j_const.front() == Json(1));
+ // "array" is last key
+ CHECK(j.back() == Json({1, 2, 3}));
+ CHECK(j_const.back() == Json({1, 2, 3}));
+ }
+ else
+ {
+ // "array" is the smallest key
+ CHECK(j.front() == Json({1, 2, 3}));
+ CHECK(j_const.front() == Json({1, 2, 3}));
+ // "unsigned" is the largest key
+ CHECK(j.back() == Json(1u));
+ CHECK(j_const.back() == Json(1u));
+ }
+ }
+
+ SECTION("access specified element")
+ {
+ SECTION("access within bounds")
+ {
+ CHECK(j["integer"] == Json(1));
+ CHECK(j[typename Json::object_t::key_type("integer")] == j["integer"]);
+
+ CHECK(j["unsigned"] == Json(1u));
+ CHECK(j[typename Json::object_t::key_type("unsigned")] == j["unsigned"]);
+
+ CHECK(j["boolean"] == Json(true));
+ CHECK(j[typename Json::object_t::key_type("boolean")] == j["boolean"]);
+
+ CHECK(j["null"] == Json(nullptr));
+ CHECK(j[typename Json::object_t::key_type("null")] == j["null"]);
+
+ CHECK(j["string"] == Json("hello world"));
+ CHECK(j[typename Json::object_t::key_type("string")] == j["string"]);
+
+ CHECK(j["floating"] == Json(42.23));
+ CHECK(j[typename Json::object_t::key_type("floating")] == j["floating"]);
+
+ CHECK(j["object"] == Json::object());
+ CHECK(j[typename Json::object_t::key_type("object")] == j["object"]);
+
+ CHECK(j["array"] == Json({1, 2, 3}));
+ CHECK(j[typename Json::object_t::key_type("array")] == j["array"]);
+
+ CHECK(j_const["integer"] == Json(1));
+ CHECK(j_const[typename Json::object_t::key_type("integer")] == j["integer"]);
+
+ CHECK(j_const["boolean"] == Json(true));
+ CHECK(j_const[typename Json::object_t::key_type("boolean")] == j["boolean"]);
+
+ CHECK(j_const["null"] == Json(nullptr));
+ CHECK(j_const[typename Json::object_t::key_type("null")] == j["null"]);
+
+ CHECK(j_const["string"] == Json("hello world"));
+ CHECK(j_const[typename Json::object_t::key_type("string")] == j["string"]);
+
+ CHECK(j_const["floating"] == Json(42.23));
+ CHECK(j_const[typename Json::object_t::key_type("floating")] == j["floating"]);
+
+ CHECK(j_const["object"] == Json::object());
+ CHECK(j_const[typename Json::object_t::key_type("object")] == j["object"]);
+
+ CHECK(j_const["array"] == Json({1, 2, 3}));
+ CHECK(j_const[typename 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")
+ {
+ 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[typename 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", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_const_nonobject[typename Json::object_t::key_type("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with null", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("boolean")
+ {
+ Json j_nonobject(Json::value_t::boolean);
+ const Json j_const_nonobject(j_nonobject);
+ CHECK_THROWS_WITH_AS(j_nonobject["foo"],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with boolean", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject[typename Json::object_t::key_type("foo")],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with boolean", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_const_nonobject["foo"],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with boolean", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_const_nonobject[typename Json::object_t::key_type("foo")],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with boolean", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("string")
+ {
+ Json j_nonobject(Json::value_t::string);
+ const Json j_const_nonobject(j_nonobject);
+ CHECK_THROWS_WITH_AS(j_nonobject["foo"],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with string", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject[typename Json::object_t::key_type("foo")],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with string", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_const_nonobject["foo"],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with string", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_const_nonobject[typename Json::object_t::key_type("foo")],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with string", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("array")
+ {
+ Json j_nonobject(Json::value_t::array);
+ const Json j_const_nonobject(j_nonobject);
+ CHECK_THROWS_WITH_AS(j_nonobject["foo"],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with array", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject[typename Json::object_t::key_type("foo")], "[json.exception.type_error.305] cannot use operator[] with a string argument with array", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_const_nonobject["foo"],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with array", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_const_nonobject[typename Json::object_t::key_type("foo")],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with array", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("number (integer)")
+ {
+ Json j_nonobject(Json::value_t::number_integer);
+ const Json j_const_nonobject(j_nonobject);
+ CHECK_THROWS_WITH_AS(j_nonobject["foo"],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with number", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject[typename Json::object_t::key_type("foo")],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with number", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_const_nonobject["foo"],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with number", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_const_nonobject[typename Json::object_t::key_type("foo")],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with number", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("number (unsigned)")
+ {
+ Json j_nonobject(Json::value_t::number_unsigned);
+ const Json j_const_nonobject(j_nonobject);
+ CHECK_THROWS_WITH_AS(j_nonobject["foo"],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with number", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject[typename Json::object_t::key_type("foo")],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with number", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_const_nonobject["foo"],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with number", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_const_nonobject[typename Json::object_t::key_type("foo")],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with number", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+
+ SECTION("number (floating-point)")
+ {
+ Json j_nonobject(Json::value_t::number_float);
+ const Json j_const_nonobject(j_nonobject);
+ CHECK_THROWS_WITH_AS(j_nonobject["foo"],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with number", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonobject[typename Json::object_t::key_type("foo")],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with number", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_const_nonobject["foo"],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with number", typename Json::type_error&);
+ CHECK_THROWS_WITH_AS(j_const_nonobject[typename Json::object_t::key_type("foo")],
+ "[json.exception.type_error.305] cannot use operator[] with a string argument with number", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+ }
+ }
+
+ SECTION("remove specified element")
+ {
+ SECTION("remove element by key")
+ {
+ CHECK(j.find("integer") != j.end());
+ CHECK(j.erase("integer") == 1);
+ CHECK(j.find("integer") == j.end());
+ CHECK(j.erase("integer") == 0);
+
+ CHECK(j.find("unsigned") != j.end());
+ CHECK(j.erase("unsigned") == 1);
+ CHECK(j.find("unsigned") == j.end());
+ CHECK(j.erase("unsigned") == 0);
+
+ CHECK(j.find("boolean") != j.end());
+ CHECK(j.erase("boolean") == 1);
+ CHECK(j.find("boolean") == j.end());
+ CHECK(j.erase("boolean") == 0);
+
+ CHECK(j.find("null") != j.end());
+ CHECK(j.erase("null") == 1);
+ CHECK(j.find("null") == j.end());
+ CHECK(j.erase("null") == 0);
+
+ CHECK(j.find("string") != j.end());
+ CHECK(j.erase("string") == 1);
+ CHECK(j.find("string") == j.end());
+ CHECK(j.erase("string") == 0);
+
+ CHECK(j.find("floating") != j.end());
+ CHECK(j.erase("floating") == 1);
+ CHECK(j.find("floating") == j.end());
+ CHECK(j.erase("floating") == 0);
+
+ CHECK(j.find("object") != j.end());
+ CHECK(j.erase("object") == 1);
+ CHECK(j.find("object") == j.end());
+ CHECK(j.erase("object") == 0);
+
+ CHECK(j.find("array") != j.end());
+ CHECK(j.erase("array") == 1);
+ CHECK(j.find("array") == j.end());
+ 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())")
+ {
+ {
+ Json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
+ typename Json::iterator it2 = jobject.erase(jobject.begin());
+ CHECK(jobject == Json({{"b", 1}, {"c", 17u}}));
+ CHECK(*it2 == Json(1));
+ }
+ {
+ Json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
+ typename Json::const_iterator it2 = jobject.erase(jobject.cbegin());
+ CHECK(jobject == Json({{"b", 1}, {"c", 17u}}));
+ CHECK(*it2 == Json(1));
+ }
+ }
+
+ SECTION("erase(begin(), end())")
+ {
+ {
+ Json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
+ typename Json::iterator it2 = jobject.erase(jobject.begin(), jobject.end());
+ CHECK(jobject == Json::object());
+ CHECK(it2 == jobject.end());
+ }
+ {
+ Json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
+ typename Json::const_iterator it2 = jobject.erase(jobject.cbegin(), jobject.cend());
+ CHECK(jobject == Json::object());
+ CHECK(it2 == jobject.cend());
+ }
+ }
+
+ SECTION("erase(begin(), begin())")
+ {
+ {
+ Json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
+ typename Json::iterator it2 = jobject.erase(jobject.begin(), jobject.begin());
+ CHECK(jobject == Json({{"a", "a"}, {"b", 1}, {"c", 17u}}));
+ CHECK(*it2 == Json("a"));
+ }
+ {
+ Json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
+ typename Json::const_iterator it2 = jobject.erase(jobject.cbegin(), jobject.cbegin());
+ CHECK(jobject == Json({{"a", "a"}, {"b", 1}, {"c", 17u}}));
+ CHECK(*it2 == Json("a"));
+ }
+ }
+
+ SECTION("erase at offset")
+ {
+ {
+ Json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
+ typename Json::iterator it = jobject.find("b");
+ typename Json::iterator it2 = jobject.erase(it);
+ CHECK(jobject == Json({{"a", "a"}, {"c", 17u}}));
+ CHECK(*it2 == Json(17));
+ }
+ {
+ Json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}};
+ typename Json::const_iterator it = jobject.find("b");
+ typename Json::const_iterator it2 = jobject.erase(it);
+ CHECK(jobject == Json({{"a", "a"}, {"c", 17u}}));
+ CHECK(*it2 == Json(17));
+ }
+ }
+
+ SECTION("erase subrange")
+ {
+ {
+ Json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}, {"d", false}, {"e", true}};
+ typename Json::iterator it2 = jobject.erase(jobject.find("b"), jobject.find("e"));
+ CHECK(jobject == Json({{"a", "a"}, {"e", true}}));
+ CHECK(*it2 == Json(true));
+ }
+ {
+ Json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}, {"d", false}, {"e", true}};
+ typename Json::const_iterator it2 = jobject.erase(jobject.find("b"), jobject.find("e"));
+ CHECK(jobject == Json({{"a", "a"}, {"e", true}}));
+ CHECK(*it2 == Json(true));
+ }
+ }
+
+ SECTION("different objects")
+ {
+ {
+ Json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}, {"d", false}, {"e", true}};
+ Json jobject2 = {{"a", "a"}, {"b", 1}, {"c", 17u}};
+ CHECK_THROWS_WITH_AS(jobject.erase(jobject2.begin()),
+ "[json.exception.invalid_iterator.202] iterator does not fit current value", typename Json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(jobject.erase(jobject.begin(), jobject2.end()),
+ "[json.exception.invalid_iterator.203] iterators do not fit current value", typename Json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(jobject.erase(jobject2.begin(), jobject.end()),
+ "[json.exception.invalid_iterator.203] iterators do not fit current value", typename Json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(jobject.erase(jobject2.begin(), jobject2.end()),
+ "[json.exception.invalid_iterator.203] iterators do not fit current value", typename Json::invalid_iterator&);
+ }
+ {
+ Json jobject = {{"a", "a"}, {"b", 1}, {"c", 17u}, {"d", false}, {"e", true}};
+ Json jobject2 = {{"a", "a"}, {"b", 1}, {"c", 17u}};
+ CHECK_THROWS_WITH_AS(jobject.erase(jobject2.cbegin()),
+ "[json.exception.invalid_iterator.202] iterator does not fit current value", typename Json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(jobject.erase(jobject.cbegin(), jobject2.cend()),
+ "[json.exception.invalid_iterator.203] iterators do not fit current value", typename Json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(jobject.erase(jobject2.cbegin(), jobject.cend()),
+ "[json.exception.invalid_iterator.203] iterators do not fit current value", typename Json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(jobject.erase(jobject2.cbegin(), jobject2.cend()),
+ "[json.exception.invalid_iterator.203] iterators do not fit current value", typename Json::invalid_iterator&);
+ }
+ }
+ }
+
+ SECTION("remove element by key in non-object type")
+ {
+ SECTION("null")
+ {
+ 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", typename 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", typename 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", typename 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", typename 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", typename 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", typename 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", typename 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", typename 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", typename 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", typename 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", typename 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", typename Json::type_error&);
+#endif
+ }
+ }
+ }
+
+ SECTION("find an element in an object")
+ {
+ SECTION("existing element")
+ {
+ for (const auto* 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));
+ }
+#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")
+ {
+ SECTION("null")
+ {
+ 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
+ }
+ }
+ }
+
+ SECTION("count keys in an object")
+ {
+ SECTION("existing element")
+ {
+ for (const auto* key :
+ {"integer", "unsigned", "floating", "null", "string", "boolean", "object", "array"
+ })
+ {
+ 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")
+ {
+ SECTION("null")
+ {
+ 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
+ }
+ }
+ }
+
+ SECTION("check existence of key in an object")
+ {
+ SECTION("existing element")
+ {
+ for (const auto* key :
+ {"integer", "unsigned", "floating", "null", "string", "boolean", "object", "array"
+ })
+ {
+ 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")
+ {
+ SECTION("null")
+ {
+ 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)")
+ {
+ Json j_nonobject(Json::value_t::number_float);
+ 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
+ }
+ }
+ }
+ }
+}
+
+#if !defined(JSON_NOEXCEPTION)
+TEST_CASE_TEMPLATE("element access 2 (throwing tests)", Json, nlohmann::json, nlohmann::ordered_json)
+{
+ SECTION("object")
+ {
+ Json j = {{"integer", 1}, {"unsigned", 1u}, {"floating", 42.23}, {"null", nullptr}, {"string", "hello world"}, {"boolean", true}, {"object", Json::object()}, {"array", {1, 2, 3}}};
+ const Json j_const = {{"integer", 1}, {"unsigned", 1u}, {"floating", 42.23}, {"null", nullptr}, {"string", "hello world"}, {"boolean", true}, {"object", Json::object()}, {"array", {1, 2, 3}}};
+
+ SECTION("access specified element with default value")
+ {
+ SECTION("given a JSON pointer")
+ {
+ SECTION("access non-existing value")
+ {
+ CHECK(j.value("/not/existing"_json_pointer, 2) == 2);
+ CHECK(j.value("/not/existing"_json_pointer, 2u) == 2u);
+ CHECK(j.value("/not/existing"_json_pointer, false) == false);
+ CHECK(j.value("/not/existing"_json_pointer, "bar") == "bar");
+ CHECK(j.value("/not/existing"_json_pointer, 12.34) == Approx(12.34));
+ CHECK(j.value("/not/existing"_json_pointer, Json({{"foo", "bar"}})) == Json({{"foo", "bar"}}));
+ CHECK(j.value("/not/existing"_json_pointer, Json({10, 100})) == Json({10, 100}));
+
+ CHECK(j_const.value("/not/existing"_json_pointer, 2) == 2);
+ CHECK(j_const.value("/not/existing"_json_pointer, 2u) == 2u);
+ CHECK(j_const.value("/not/existing"_json_pointer, false) == false);
+ CHECK(j_const.value("/not/existing"_json_pointer, "bar") == "bar");
+ CHECK(j_const.value("/not/existing"_json_pointer, 12.34) == Approx(12.34));
+ CHECK(j_const.value("/not/existing"_json_pointer, Json({{"foo", "bar"}})) == Json({{"foo", "bar"}}));
+ CHECK(j_const.value("/not/existing"_json_pointer, Json({10, 100})) == Json({10, 100}));
+ }
+ }
+ }
+ }
+}
+#endif
diff --git a/test/src/unit-hash.cpp b/tests/src/unit-hash.cpp
similarity index 72%
rename from test/src/unit-hash.cpp
rename to tests/src/unit-hash.cpp
index efe977b..f44d729 100644
--- a/test/src/unit-hash.cpp
+++ b/tests/src/unit-hash.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
diff --git a/test/src/unit-inspection.cpp b/tests/src/unit-inspection.cpp
similarity index 90%
rename from test/src/unit-inspection.cpp
rename to tests/src/unit-inspection.cpp
index 49d2431..cd6cb6d 100644
--- a/test/src/unit-inspection.cpp
+++ b/tests/src/unit-inspection.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -34,7 +13,7 @@
#include <fstream>
#include <sstream>
-#include <test_data.hpp>
+#include "make_test_data_available.hpp"
TEST_CASE("object inspection")
{
diff --git a/test/src/unit-items.cpp b/tests/src/unit-items.cpp
similarity index 93%
rename from test/src/unit-items.cpp
rename to tests/src/unit-items.cpp
index f9021fe..6a19bf3 100644
--- a/test/src/unit-items.cpp
+++ b/tests/src/unit-items.cpp
@@ -1,47 +1,21 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
#include <nlohmann/json.hpp>
using nlohmann::json;
-#if (defined(__cplusplus) && __cplusplus >= 201703L) || (defined(_HAS_CXX17) && _HAS_CXX17 == 1) // fix for issue #464
- #define JSON_HAS_CPP_17
- #define JSON_HAS_CPP_14
-#elif (defined(__cplusplus) && __cplusplus >= 201402L) || (defined(_HAS_CXX14) && _HAS_CXX14 == 1)
- #define JSON_HAS_CPP_14
-#endif
-
// This test suite uses range for loops where values are copied. This is inefficient in usual code, but required to achieve 100% coverage.
DOCTEST_GCC_SUPPRESS_WARNING_PUSH
-DOCTEST_GCC_SUPPRESS_WARNING("-Wrange-loop-construct")
+#if DOCTEST_GCC >= DOCTEST_COMPILER(11, 0, 0)
+ DOCTEST_GCC_SUPPRESS_WARNING("-Wrange-loop-construct")
+#endif
DOCTEST_CLANG_SUPPRESS_WARNING_PUSH
DOCTEST_CLANG_SUPPRESS_WARNING("-Wrange-loop-construct")
@@ -87,7 +61,7 @@
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++)
{
@@ -233,7 +207,7 @@
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++)
{
@@ -368,7 +342,7 @@
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++)
{
@@ -514,7 +488,7 @@
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++)
{
@@ -631,7 +605,7 @@
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() == "");
@@ -700,7 +674,7 @@
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() == "");
@@ -784,7 +758,7 @@
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++)
{
@@ -946,7 +920,7 @@
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++)
{
@@ -1081,7 +1055,7 @@
json j = { "A", "B" };
int counter = 1;
- for (auto& i : j.items())
+ for (auto& i : j.items()) // NOLINT(readability-qualified-auto)
{
switch (counter++)
{
@@ -1227,7 +1201,7 @@
const json j = { "A", "B" };
int counter = 1;
- for (auto& i : j.items())
+ for (auto& i : j.items()) // NOLINT(readability-qualified-auto)
{
switch (counter++)
{
@@ -1344,7 +1318,7 @@
json j = 1;
int counter = 1;
- for (auto& i : j.items())
+ for (auto& i : j.items()) // NOLINT(readability-qualified-auto)
{
++counter;
CHECK(i.key() == "");
@@ -1413,7 +1387,7 @@
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() == "");
@@ -1455,13 +1429,5 @@
}
}
-#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/test/src/unit-iterators1.cpp b/tests/src/unit-iterators1.cpp
similarity index 83%
rename from test/src/unit-iterators1.cpp
rename to tests/src/unit-iterators1.cpp
index 758e2b5..3f30885 100644
--- a/test/src/unit-iterators1.cpp
+++ b/tests/src/unit-iterators1.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -338,23 +317,17 @@
{
auto it = j.begin();
auto cit = j_const.cbegin();
- CHECK_THROWS_AS(it.key(), json::invalid_iterator&);
- CHECK_THROWS_WITH(it.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
+ CHECK_THROWS_WITH_AS(it.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
CHECK(it.value() == json(true));
- CHECK_THROWS_AS(cit.key(), json::invalid_iterator&);
- CHECK_THROWS_WITH(cit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
+ CHECK_THROWS_WITH_AS(cit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
CHECK(cit.value() == json(true));
auto rit = j.rend();
auto crit = j.crend();
- CHECK_THROWS_AS(rit.key(), json::invalid_iterator&);
- CHECK_THROWS_AS(rit.value(), json::invalid_iterator&);
- CHECK_THROWS_AS(crit.key(), json::invalid_iterator&);
- CHECK_THROWS_AS(crit.value(), json::invalid_iterator&);
- CHECK_THROWS_WITH(rit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
- CHECK_THROWS_WITH(rit.value(), "[json.exception.invalid_iterator.214] cannot get value");
- CHECK_THROWS_WITH(crit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
- CHECK_THROWS_WITH(crit.value(), "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(rit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(rit.value(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(crit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(crit.value(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
}
}
@@ -542,23 +515,17 @@
{
auto it = j.begin();
auto cit = j_const.cbegin();
- CHECK_THROWS_AS(it.key(), json::invalid_iterator&);
- CHECK_THROWS_WITH(it.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
+ CHECK_THROWS_WITH_AS(it.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
CHECK(it.value() == json("hello world"));
- CHECK_THROWS_AS(cit.key(), json::invalid_iterator&);
- CHECK_THROWS_WITH(cit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
+ CHECK_THROWS_WITH_AS(cit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
CHECK(cit.value() == json("hello world"));
auto rit = j.rend();
auto crit = j.crend();
- CHECK_THROWS_AS(rit.key(), json::invalid_iterator&);
- CHECK_THROWS_AS(rit.value(), json::invalid_iterator&);
- CHECK_THROWS_AS(crit.key(), json::invalid_iterator&);
- CHECK_THROWS_AS(crit.value(), json::invalid_iterator&);
- CHECK_THROWS_WITH(rit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
- CHECK_THROWS_WITH(rit.value(), "[json.exception.invalid_iterator.214] cannot get value");
- CHECK_THROWS_WITH(crit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
- CHECK_THROWS_WITH(crit.value(), "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(rit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(rit.value(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(crit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(crit.value(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
}
}
@@ -739,11 +706,9 @@
{
auto it = j.begin();
auto cit = j_const.cbegin();
- CHECK_THROWS_AS(it.key(), json::invalid_iterator&);
- CHECK_THROWS_WITH(it.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
+ CHECK_THROWS_WITH_AS(it.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
CHECK(it.value() == json(1));
- CHECK_THROWS_AS(cit.key(), json::invalid_iterator&);
- CHECK_THROWS_WITH(cit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
+ CHECK_THROWS_WITH_AS(cit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
CHECK(cit.value() == json(1));
}
}
@@ -1116,23 +1081,17 @@
{
auto it = j.begin();
auto cit = j_const.cbegin();
- CHECK_THROWS_AS(it.key(), json::invalid_iterator&);
- CHECK_THROWS_WITH(it.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
+ CHECK_THROWS_WITH_AS(it.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
CHECK(it.value() == json(23));
- CHECK_THROWS_AS(cit.key(), json::invalid_iterator&);
- CHECK_THROWS_WITH(cit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
+ CHECK_THROWS_WITH_AS(cit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
CHECK(cit.value() == json(23));
auto rit = j.rend();
auto crit = j.crend();
- CHECK_THROWS_AS(rit.key(), json::invalid_iterator&);
- CHECK_THROWS_AS(rit.value(), json::invalid_iterator&);
- CHECK_THROWS_AS(crit.key(), json::invalid_iterator&);
- CHECK_THROWS_AS(crit.value(), json::invalid_iterator&);
- CHECK_THROWS_WITH(rit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
- CHECK_THROWS_WITH(rit.value(), "[json.exception.invalid_iterator.214] cannot get value");
- CHECK_THROWS_WITH(crit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
- CHECK_THROWS_WITH(crit.value(), "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(rit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(rit.value(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(crit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(crit.value(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
}
}
@@ -1320,23 +1279,17 @@
{
auto it = j.begin();
auto cit = j_const.cbegin();
- CHECK_THROWS_AS(it.key(), json::invalid_iterator&);
- CHECK_THROWS_WITH(it.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
+ CHECK_THROWS_WITH_AS(it.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
CHECK(it.value() == json(23));
- CHECK_THROWS_AS(cit.key(), json::invalid_iterator&);
- CHECK_THROWS_WITH(cit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
+ CHECK_THROWS_WITH_AS(cit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
CHECK(cit.value() == json(23));
auto rit = j.rend();
auto crit = j.crend();
- CHECK_THROWS_AS(rit.key(), json::invalid_iterator&);
- CHECK_THROWS_AS(rit.value(), json::invalid_iterator&);
- CHECK_THROWS_AS(crit.key(), json::invalid_iterator&);
- CHECK_THROWS_AS(crit.value(), json::invalid_iterator&);
- CHECK_THROWS_WITH(rit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
- CHECK_THROWS_WITH(rit.value(), "[json.exception.invalid_iterator.214] cannot get value");
- CHECK_THROWS_WITH(crit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
- CHECK_THROWS_WITH(crit.value(), "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(rit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(rit.value(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(crit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(crit.value(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
}
}
@@ -1524,23 +1477,17 @@
{
auto it = j.begin();
auto cit = j_const.cbegin();
- CHECK_THROWS_AS(it.key(), json::invalid_iterator&);
- CHECK_THROWS_WITH(it.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
+ CHECK_THROWS_WITH_AS(it.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
CHECK(it.value() == json(23.42));
- CHECK_THROWS_AS(cit.key(), json::invalid_iterator&);
- CHECK_THROWS_WITH(cit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
+ CHECK_THROWS_WITH_AS(cit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
CHECK(cit.value() == json(23.42));
auto rit = j.rend();
auto crit = j.crend();
- CHECK_THROWS_AS(rit.key(), json::invalid_iterator&);
- CHECK_THROWS_AS(rit.value(), json::invalid_iterator&);
- CHECK_THROWS_AS(crit.key(), json::invalid_iterator&);
- CHECK_THROWS_AS(crit.value(), json::invalid_iterator&);
- CHECK_THROWS_WITH(rit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
- CHECK_THROWS_WITH(rit.value(), "[json.exception.invalid_iterator.214] cannot get value");
- CHECK_THROWS_WITH(crit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
- CHECK_THROWS_WITH(crit.value(), "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(rit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(rit.value(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(crit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(crit.value(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
}
}
@@ -1598,25 +1545,17 @@
{
auto it = j.begin();
auto cit = j_const.cbegin();
- CHECK_THROWS_AS(it.key(), json::invalid_iterator&);
- CHECK_THROWS_AS(it.value(), json::invalid_iterator&);
- CHECK_THROWS_AS(cit.key(), json::invalid_iterator&);
- CHECK_THROWS_AS(cit.value(), json::invalid_iterator&);
- CHECK_THROWS_WITH(it.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
- CHECK_THROWS_WITH(it.value(), "[json.exception.invalid_iterator.214] cannot get value");
- CHECK_THROWS_WITH(cit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
- CHECK_THROWS_WITH(cit.value(), "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(it.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it.value(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(cit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(cit.value(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
auto rit = j.rend();
auto crit = j.crend();
- CHECK_THROWS_AS(rit.key(), json::invalid_iterator&);
- CHECK_THROWS_AS(rit.value(), json::invalid_iterator&);
- CHECK_THROWS_AS(crit.key(), json::invalid_iterator&);
- CHECK_THROWS_AS(crit.value(), json::invalid_iterator&);
- CHECK_THROWS_WITH(rit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
- CHECK_THROWS_WITH(rit.value(), "[json.exception.invalid_iterator.214] cannot get value");
- CHECK_THROWS_WITH(crit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators");
- CHECK_THROWS_WITH(crit.value(), "[json.exception.invalid_iterator.214] cannot get value");
+ CHECK_THROWS_WITH_AS(rit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(rit.value(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(crit.key(), "[json.exception.invalid_iterator.207] cannot use key() for non-object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(crit.value(), "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
}
}
}
diff --git a/tests/src/unit-iterators2.cpp b/tests/src/unit-iterators2.cpp
new file mode 100644
index 0000000..235d46b
--- /dev/null
+++ b/tests/src/unit-iterators2.cpp
@@ -0,0 +1,972 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+// 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")
+ {
+ json j_values = {nullptr, true, 42, 42u, 23.23, {{"one", 1}, {"two", 2}}, {1, 2, 3, 4, 5}, "Hello, world"};
+
+ for (json& j : j_values)
+ {
+ auto it1 = j.begin();
+ auto it2 = j.begin();
+ auto it3 = j.begin();
+ ++it2;
+ ++it3;
+ ++it3;
+ auto it1_c = j.cbegin();
+ auto it2_c = j.cbegin();
+ auto it3_c = j.cbegin();
+ ++it2_c;
+ ++it3_c;
+ ++it3_c;
+
+ // comparison: equal
+ {
+ CHECK(it1 == it1);
+ CHECK(!(it1 == it2));
+ CHECK(!(it1 == it3));
+ CHECK(!(it2 == it3));
+ CHECK(it1_c == it1_c);
+ CHECK(!(it1_c == it2_c));
+ CHECK(!(it1_c == it3_c));
+ CHECK(!(it2_c == it3_c));
+ }
+
+ // comparison: not equal
+ {
+ // check definition
+ CHECK( (it1 != it1) == !(it1 == it1) );
+ CHECK( (it1 != it2) == !(it1 == it2) );
+ CHECK( (it1 != it3) == !(it1 == it3) );
+ CHECK( (it2 != it3) == !(it2 == it3) );
+ CHECK( (it1_c != it1_c) == !(it1_c == it1_c) );
+ CHECK( (it1_c != it2_c) == !(it1_c == it2_c) );
+ CHECK( (it1_c != it3_c) == !(it1_c == it3_c) );
+ CHECK( (it2_c != it3_c) == !(it2_c == it3_c) );
+ }
+
+ // comparison: smaller
+ {
+ if (j.type() == json::value_t::object)
+ {
+#if JSON_DIAGNOSTICS
+ CHECK_THROWS_WITH_AS(it1 < it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 < it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 < it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 < it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c < it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c < it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c < it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c < it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+#else
+ CHECK_THROWS_WITH_AS(it1 < it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 < it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 < it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 < it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c < it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c < it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c < it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c < it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+#endif
+ }
+ else
+ {
+ CHECK(!(it1 < it1));
+ CHECK(it1 < it2);
+ CHECK(it1 < it3);
+ CHECK(it2 < it3);
+ CHECK(!(it1_c < it1_c));
+ CHECK(it1_c < it2_c);
+ CHECK(it1_c < it3_c);
+ CHECK(it2_c < it3_c);
+ }
+ }
+
+ // comparison: less than or equal
+ {
+ if (j.type() == json::value_t::object)
+ {
+#if JSON_DIAGNOSTICS
+ CHECK_THROWS_WITH_AS(it1 <= it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 <= it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 <= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 <= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c <= it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c <= it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c <= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c <= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+#else
+ CHECK_THROWS_WITH_AS(it1 <= it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 <= it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 <= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 <= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c <= it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c <= it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c <= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c <= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+#endif
+ }
+ else
+ {
+ // check definition
+ CHECK( (it1 <= it1) == !(it1 < it1) );
+ CHECK( (it1 <= it2) == !(it2 < it1) );
+ CHECK( (it1 <= it3) == !(it3 < it1) );
+ CHECK( (it2 <= it3) == !(it3 < it2) );
+ CHECK( (it1_c <= it1_c) == !(it1_c < it1_c) );
+ CHECK( (it1_c <= it2_c) == !(it2_c < it1_c) );
+ CHECK( (it1_c <= it3_c) == !(it3_c < it1_c) );
+ CHECK( (it2_c <= it3_c) == !(it3_c < it2_c) );
+ }
+ }
+
+ // comparison: greater than
+ {
+ if (j.type() == json::value_t::object)
+ {
+#if JSON_DIAGNOSTICS
+ CHECK_THROWS_WITH_AS(it1 > it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 > it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 > it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 > it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c > it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c > it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c > it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c > it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+#else
+ CHECK_THROWS_WITH_AS(it1 > it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 > it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 > it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 > it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c > it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c > it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c > it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c > it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+#endif
+ }
+ else
+ {
+ // check definition
+ CHECK( (it1 > it1) == (it1 < it1) );
+ CHECK( (it1 > it2) == (it2 < it1) );
+ CHECK( (it1 > it3) == (it3 < it1) );
+ CHECK( (it2 > it3) == (it3 < it2) );
+ CHECK( (it1_c > it1_c) == (it1_c < it1_c) );
+ CHECK( (it1_c > it2_c) == (it2_c < it1_c) );
+ CHECK( (it1_c > it3_c) == (it3_c < it1_c) );
+ CHECK( (it2_c > it3_c) == (it3_c < it2_c) );
+ }
+ }
+
+ // comparison: greater than or equal
+ {
+ if (j.type() == json::value_t::object)
+ {
+#if JSON_DIAGNOSTICS
+ CHECK_THROWS_WITH_AS(it1 >= it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 >= it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 >= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 >= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c >= it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c >= it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c >= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c >= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+#else
+ CHECK_THROWS_WITH_AS(it1 >= it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 >= it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 >= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 >= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c >= it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c >= it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c >= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c >= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+#endif
+ }
+ else
+ {
+ // check definition
+ CHECK( (it1 >= it1) == !(it1 < it1) );
+ CHECK( (it1 >= it2) == !(it1 < it2) );
+ CHECK( (it1 >= it3) == !(it1 < it3) );
+ CHECK( (it2 >= it3) == !(it2 < it3) );
+ CHECK( (it1_c >= it1_c) == !(it1_c < it1_c) );
+ CHECK( (it1_c >= it2_c) == !(it1_c < it2_c) );
+ CHECK( (it1_c >= it3_c) == !(it1_c < it3_c) );
+ CHECK( (it2_c >= it3_c) == !(it2_c < it3_c) );
+ }
+ }
+ }
+
+ // check exceptions if different objects are compared
+ for (auto j : j_values)
+ {
+ for (auto k : j_values)
+ {
+ if (j != k)
+ {
+#if JSON_DIAGNOSTICS
+ // the output differs in each loop, so we cannot fix a string for the expected exception
+#else
+ CHECK_THROWS_WITH_AS(j.begin() == k.begin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.cbegin() == k.cbegin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.begin() < k.begin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.cbegin() < k.cbegin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers", json::invalid_iterator&);
+#endif
+ }
+ }
+ }
+ }
+
+ SECTION("iterator arithmetic")
+ {
+ json j_object = {{"one", 1}, {"two", 2}, {"three", 3}};
+ json j_array = {1, 2, 3, 4, 5, 6};
+ json j_null = nullptr;
+ json j_value = 42;
+
+ SECTION("addition and subtraction")
+ {
+ SECTION("object")
+ {
+ {
+ auto it = j_object.begin();
+ CHECK_THROWS_WITH_AS(it += 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.cbegin();
+ CHECK_THROWS_WITH_AS(it += 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.begin();
+ CHECK_THROWS_WITH_AS(it + 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.cbegin();
+ CHECK_THROWS_WITH_AS(it + 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.begin();
+ CHECK_THROWS_WITH_AS(1 + it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.cbegin();
+ CHECK_THROWS_WITH_AS(1 + it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.begin();
+ CHECK_THROWS_WITH_AS(it -= 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.cbegin();
+ CHECK_THROWS_WITH_AS(it -= 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.begin();
+ CHECK_THROWS_WITH_AS(it - 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.cbegin();
+ CHECK_THROWS_WITH_AS(it - 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.begin();
+ CHECK_THROWS_WITH_AS(it - it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.cbegin();
+ CHECK_THROWS_WITH_AS(it - it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("array")
+ {
+ {
+ auto it = j_array.begin();
+ it += 3;
+ CHECK((j_array.begin() + 3) == it);
+ CHECK((3 + j_array.begin()) == it);
+ CHECK((it - 3) == j_array.begin());
+ CHECK((it - j_array.begin()) == 3);
+ CHECK(*it == json(4));
+ it -= 2;
+ CHECK(*it == json(2));
+ }
+ {
+ auto it = j_array.cbegin();
+ it += 3;
+ CHECK((j_array.cbegin() + 3) == it);
+ CHECK((3 + j_array.cbegin()) == it);
+ CHECK((it - 3) == j_array.cbegin());
+ CHECK((it - j_array.cbegin()) == 3);
+ CHECK(*it == json(4));
+ it -= 2;
+ CHECK(*it == json(2));
+ }
+ }
+
+ SECTION("null")
+ {
+ {
+ auto it = j_null.begin();
+ it += 3;
+ CHECK((j_null.begin() + 3) == it);
+ CHECK((3 + j_null.begin()) == it);
+ CHECK((it - 3) == j_null.begin());
+ CHECK((it - j_null.begin()) == 3);
+ CHECK(it != j_null.end());
+ it -= 3;
+ CHECK(it == j_null.end());
+ }
+ {
+ auto it = j_null.cbegin();
+ it += 3;
+ CHECK((j_null.cbegin() + 3) == it);
+ CHECK((3 + j_null.cbegin()) == it);
+ CHECK((it - 3) == j_null.cbegin());
+ CHECK((it - j_null.cbegin()) == 3);
+ CHECK(it != j_null.cend());
+ it -= 3;
+ CHECK(it == j_null.cend());
+ }
+ }
+
+ SECTION("value")
+ {
+ {
+ auto it = j_value.begin();
+ it += 3;
+ CHECK((j_value.begin() + 3) == it);
+ CHECK((3 + j_value.begin()) == it);
+ CHECK((it - 3) == j_value.begin());
+ CHECK((it - j_value.begin()) == 3);
+ CHECK(it != j_value.end());
+ it -= 3;
+ CHECK(*it == json(42));
+ }
+ {
+ auto it = j_value.cbegin();
+ it += 3;
+ CHECK((j_value.cbegin() + 3) == it);
+ CHECK((3 + j_value.cbegin()) == it);
+ CHECK((it - 3) == j_value.cbegin());
+ CHECK((it - j_value.cbegin()) == 3);
+ CHECK(it != j_value.cend());
+ it -= 3;
+ CHECK(*it == json(42));
+ }
+ }
+ }
+
+ SECTION("subscript operator")
+ {
+ SECTION("object")
+ {
+ {
+ auto it = j_object.begin();
+ CHECK_THROWS_WITH_AS(it[0], "[json.exception.invalid_iterator.208] cannot use operator[] for object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it[1], "[json.exception.invalid_iterator.208] cannot use operator[] for object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.cbegin();
+ CHECK_THROWS_WITH_AS(it[0], "[json.exception.invalid_iterator.208] cannot use operator[] for object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it[1], "[json.exception.invalid_iterator.208] cannot use operator[] for object iterators", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("array")
+ {
+ {
+ auto it = j_array.begin();
+ CHECK(it[0] == json(1));
+ CHECK(it[1] == json(2));
+ CHECK(it[2] == json(3));
+ CHECK(it[3] == json(4));
+ CHECK(it[4] == json(5));
+ CHECK(it[5] == json(6));
+ }
+ {
+ auto it = j_array.cbegin();
+ CHECK(it[0] == json(1));
+ CHECK(it[1] == json(2));
+ CHECK(it[2] == json(3));
+ CHECK(it[3] == json(4));
+ CHECK(it[4] == json(5));
+ CHECK(it[5] == json(6));
+ }
+ }
+
+ SECTION("null")
+ {
+ {
+ auto it = j_null.begin();
+ CHECK_THROWS_WITH_AS(it[0], "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it[1], "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ }
+ {
+ auto it = j_null.cbegin();
+ CHECK_THROWS_WITH_AS(it[0], "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it[1], "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("value")
+ {
+ {
+ auto it = j_value.begin();
+ CHECK(it[0] == json(42));
+ CHECK_THROWS_WITH_AS(it[1], "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ }
+ {
+ auto it = j_value.cbegin();
+ CHECK(it[0] == json(42));
+ CHECK_THROWS_WITH_AS(it[1], "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ }
+ }
+ }
+ }
+
+ SECTION("reverse iterator comparisons")
+ {
+ json j_values = {nullptr, true, 42, 42u, 23.23, {{"one", 1}, {"two", 2}}, {1, 2, 3, 4, 5}, "Hello, world"};
+
+ for (json& j : j_values)
+ {
+ auto it1 = j.rbegin();
+ auto it2 = j.rbegin();
+ auto it3 = j.rbegin();
+ ++it2;
+ ++it3;
+ ++it3;
+ auto it1_c = j.crbegin();
+ auto it2_c = j.crbegin();
+ auto it3_c = j.crbegin();
+ ++it2_c;
+ ++it3_c;
+ ++it3_c;
+
+ // comparison: equal
+ {
+ CHECK(it1 == it1);
+ CHECK(!(it1 == it2));
+ CHECK(!(it1 == it3));
+ CHECK(!(it2 == it3));
+ CHECK(it1_c == it1_c);
+ CHECK(!(it1_c == it2_c));
+ CHECK(!(it1_c == it3_c));
+ CHECK(!(it2_c == it3_c));
+ }
+
+ // comparison: not equal
+ {
+ // check definition
+ CHECK( (it1 != it1) == !(it1 == it1) );
+ CHECK( (it1 != it2) == !(it1 == it2) );
+ CHECK( (it1 != it3) == !(it1 == it3) );
+ CHECK( (it2 != it3) == !(it2 == it3) );
+ CHECK( (it1_c != it1_c) == !(it1_c == it1_c) );
+ CHECK( (it1_c != it2_c) == !(it1_c == it2_c) );
+ CHECK( (it1_c != it3_c) == !(it1_c == it3_c) );
+ CHECK( (it2_c != it3_c) == !(it2_c == it3_c) );
+ }
+
+ // comparison: smaller
+ {
+ if (j.type() == json::value_t::object)
+ {
+#if JSON_DIAGNOSTICS
+ CHECK_THROWS_WITH_AS(it1 < it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 < it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 < it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 < it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c < it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c < it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c < it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c < it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+#else
+ CHECK_THROWS_WITH_AS(it1 < it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 < it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 < it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 < it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c < it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c < it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c < it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c < it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+#endif
+ }
+ else
+ {
+ CHECK(!(it1 < it1));
+ CHECK(it1 < it2);
+ CHECK(it1 < it3);
+ CHECK(it2 < it3);
+ CHECK(!(it1_c < it1_c));
+ CHECK(it1_c < it2_c);
+ CHECK(it1_c < it3_c);
+ CHECK(it2_c < it3_c);
+ }
+ }
+
+ // comparison: less than or equal
+ {
+ if (j.type() == json::value_t::object)
+ {
+#if JSON_DIAGNOSTICS
+ CHECK_THROWS_WITH_AS(it1 <= it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 <= it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 <= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 <= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c <= it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c <= it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c <= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c <= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+#else
+ CHECK_THROWS_WITH_AS(it1 <= it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 <= it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 <= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 <= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c <= it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c <= it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c <= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c <= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+#endif
+ }
+ else
+ {
+ // check definition
+ CHECK( (it1 <= it1) == !(it1 < it1) );
+ CHECK( (it1 <= it2) == !(it2 < it1) );
+ CHECK( (it1 <= it3) == !(it3 < it1) );
+ CHECK( (it2 <= it3) == !(it3 < it2) );
+ CHECK( (it1_c <= it1_c) == !(it1_c < it1_c) );
+ CHECK( (it1_c <= it2_c) == !(it2_c < it1_c) );
+ CHECK( (it1_c <= it3_c) == !(it3_c < it1_c) );
+ CHECK( (it2_c <= it3_c) == !(it3_c < it2_c) );
+ }
+ }
+
+ // comparison: greater than
+ {
+ if (j.type() == json::value_t::object)
+ {
+#if JSON_DIAGNOSTICS
+ CHECK_THROWS_WITH_AS(it1 > it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 > it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 > it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 > it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c > it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c > it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c > it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c > it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+#else
+ CHECK_THROWS_WITH_AS(it1 > it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 > it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 > it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 > it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c > it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c > it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c > it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c > it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+#endif
+ }
+ else
+ {
+ // check definition
+ CHECK( (it1 > it1) == (it1 < it1) );
+ CHECK( (it1 > it2) == (it2 < it1) );
+ CHECK( (it1 > it3) == (it3 < it1) );
+ CHECK( (it2 > it3) == (it3 < it2) );
+ CHECK( (it1_c > it1_c) == (it1_c < it1_c) );
+ CHECK( (it1_c > it2_c) == (it2_c < it1_c) );
+ CHECK( (it1_c > it3_c) == (it3_c < it1_c) );
+ CHECK( (it2_c > it3_c) == (it3_c < it2_c) );
+ }
+ }
+
+ // comparison: greater than or equal
+ {
+ if (j.type() == json::value_t::object)
+ {
+#if JSON_DIAGNOSTICS
+ CHECK_THROWS_WITH_AS(it1 >= it1, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 >= it2, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 >= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 >= it3, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c >= it1_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c >= it2_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c >= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c >= it3_c, "[json.exception.invalid_iterator.213] (/5) cannot compare order of object iterators", json::invalid_iterator&);
+#else
+ CHECK_THROWS_WITH_AS(it1 >= it1, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 >= it2, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2 >= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1 >= it3, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c >= it1_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c >= it2_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it2_c >= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it1_c >= it3_c, "[json.exception.invalid_iterator.213] cannot compare order of object iterators", json::invalid_iterator&);
+#endif
+ }
+ else
+ {
+ // check definition
+ CHECK( (it1 >= it1) == !(it1 < it1) );
+ CHECK( (it1 >= it2) == !(it1 < it2) );
+ CHECK( (it1 >= it3) == !(it1 < it3) );
+ CHECK( (it2 >= it3) == !(it2 < it3) );
+ CHECK( (it1_c >= it1_c) == !(it1_c < it1_c) );
+ CHECK( (it1_c >= it2_c) == !(it1_c < it2_c) );
+ CHECK( (it1_c >= it3_c) == !(it1_c < it3_c) );
+ CHECK( (it2_c >= it3_c) == !(it2_c < it3_c) );
+ }
+ }
+ }
+
+ // check exceptions if different objects are compared
+ for (auto j : j_values)
+ {
+ for (auto k : j_values)
+ {
+ if (j != k)
+ {
+#if JSON_DIAGNOSTICS
+ // the output differs in each loop, so we cannot fix a string for the expected exception
+#else
+ CHECK_THROWS_WITH_AS(j.rbegin() == k.rbegin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.crbegin() == k.crbegin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.rbegin() < k.rbegin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j.crbegin() < k.crbegin(), "[json.exception.invalid_iterator.212] cannot compare iterators of different containers", json::invalid_iterator&);
+#endif
+ }
+ }
+ }
+ }
+
+ SECTION("reverse iterator arithmetic")
+ {
+ json j_object = {{"one", 1}, {"two", 2}, {"three", 3}};
+ json j_array = {1, 2, 3, 4, 5, 6};
+ json j_null = nullptr;
+ json j_value = 42;
+
+ SECTION("addition and subtraction")
+ {
+ SECTION("object")
+ {
+ {
+ auto it = j_object.rbegin();
+ CHECK_THROWS_WITH_AS(it += 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.crbegin();
+ CHECK_THROWS_WITH_AS(it += 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.rbegin();
+ CHECK_THROWS_WITH_AS(it + 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.crbegin();
+ CHECK_THROWS_WITH_AS(it + 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.rbegin();
+ CHECK_THROWS_WITH_AS(1 + it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.crbegin();
+ CHECK_THROWS_WITH_AS(1 + it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.rbegin();
+ CHECK_THROWS_WITH_AS(it -= 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.crbegin();
+ CHECK_THROWS_WITH_AS(it -= 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.rbegin();
+ CHECK_THROWS_WITH_AS(it - 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.crbegin();
+ CHECK_THROWS_WITH_AS(it - 1, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.rbegin();
+ CHECK_THROWS_WITH_AS(it - it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.crbegin();
+ CHECK_THROWS_WITH_AS(it - it, "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("array")
+ {
+ {
+ auto it = j_array.rbegin();
+ it += 3;
+ CHECK((j_array.rbegin() + 3) == it);
+ CHECK(json::reverse_iterator(3 + j_array.rbegin()) == it);
+ CHECK((it - 3) == j_array.rbegin());
+ CHECK((it - j_array.rbegin()) == 3);
+ CHECK(*it == json(3));
+ it -= 2;
+ CHECK(*it == json(5));
+ }
+ {
+ auto it = j_array.crbegin();
+ it += 3;
+ CHECK((j_array.crbegin() + 3) == it);
+ CHECK(json::const_reverse_iterator(3 + j_array.crbegin()) == it);
+ CHECK((it - 3) == j_array.crbegin());
+ CHECK((it - j_array.crbegin()) == 3);
+ CHECK(*it == json(3));
+ it -= 2;
+ CHECK(*it == json(5));
+ }
+ }
+
+ SECTION("null")
+ {
+ {
+ auto it = j_null.rbegin();
+ it += 3;
+ CHECK((j_null.rbegin() + 3) == it);
+ CHECK(json::reverse_iterator(3 + j_null.rbegin()) == it);
+ CHECK((it - 3) == j_null.rbegin());
+ CHECK((it - j_null.rbegin()) == 3);
+ CHECK(it != j_null.rend());
+ it -= 3;
+ CHECK(it == j_null.rend());
+ }
+ {
+ auto it = j_null.crbegin();
+ it += 3;
+ CHECK((j_null.crbegin() + 3) == it);
+ CHECK(json::const_reverse_iterator(3 + j_null.crbegin()) == it);
+ CHECK((it - 3) == j_null.crbegin());
+ CHECK((it - j_null.crbegin()) == 3);
+ CHECK(it != j_null.crend());
+ it -= 3;
+ CHECK(it == j_null.crend());
+ }
+ }
+
+ SECTION("value")
+ {
+ {
+ auto it = j_value.rbegin();
+ it += 3;
+ CHECK((j_value.rbegin() + 3) == it);
+ CHECK(json::reverse_iterator(3 + j_value.rbegin()) == it);
+ CHECK((it - 3) == j_value.rbegin());
+ CHECK((it - j_value.rbegin()) == 3);
+ CHECK(it != j_value.rend());
+ it -= 3;
+ CHECK(*it == json(42));
+ }
+ {
+ auto it = j_value.crbegin();
+ it += 3;
+ CHECK((j_value.crbegin() + 3) == it);
+ CHECK(json::const_reverse_iterator(3 + j_value.crbegin()) == it);
+ CHECK((it - 3) == j_value.crbegin());
+ CHECK((it - j_value.crbegin()) == 3);
+ CHECK(it != j_value.crend());
+ it -= 3;
+ CHECK(*it == json(42));
+ }
+ }
+ }
+
+ SECTION("subscript operator")
+ {
+ SECTION("object")
+ {
+ {
+ auto it = j_object.rbegin();
+ CHECK_THROWS_WITH_AS(it[0], "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it[1], "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ {
+ auto it = j_object.crbegin();
+ CHECK_THROWS_WITH_AS(it[0], "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it[1], "[json.exception.invalid_iterator.209] cannot use offsets with object iterators", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("array")
+ {
+ {
+ auto it = j_array.rbegin();
+ CHECK(it[0] == json(6));
+ CHECK(it[1] == json(5));
+ CHECK(it[2] == json(4));
+ CHECK(it[3] == json(3));
+ CHECK(it[4] == json(2));
+ CHECK(it[5] == json(1));
+ }
+ {
+ auto it = j_array.crbegin();
+ CHECK(it[0] == json(6));
+ CHECK(it[1] == json(5));
+ CHECK(it[2] == json(4));
+ CHECK(it[3] == json(3));
+ CHECK(it[4] == json(2));
+ CHECK(it[5] == json(1));
+ }
+ }
+
+ SECTION("null")
+ {
+ {
+ auto it = j_null.rbegin();
+ CHECK_THROWS_WITH_AS(it[0], "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it[1], "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ }
+ {
+ auto it = j_null.crbegin();
+ CHECK_THROWS_WITH_AS(it[0], "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(it[1], "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ }
+ }
+
+ SECTION("value")
+ {
+ {
+ auto it = j_value.rbegin();
+ CHECK(it[0] == json(42));
+ CHECK_THROWS_WITH_AS(it[1], "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ }
+ {
+ auto it = j_value.crbegin();
+ CHECK(it[0] == json(42));
+ CHECK_THROWS_WITH_AS(it[1], "[json.exception.invalid_iterator.214] cannot get value", json::invalid_iterator&);
+ }
+ }
+ }
+ }
+
+
+#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 !DOCTEST_CLANG || (DOCTEST_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 !(DOCTEST_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/test/src/unit-json_patch.cpp b/tests/src/unit-json_patch.cpp
similarity index 74%
rename from test/src/unit-json_patch.cpp
rename to tests/src/unit-json_patch.cpp
index 2c6b9cf..0b39d00 100644
--- a/test/src/unit-json_patch.cpp
+++ b/tests/src/unit-json_patch.cpp
@@ -1,39 +1,19 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
#include <nlohmann/json.hpp>
using nlohmann::json;
+using namespace nlohmann::literals; // NOLINT(google-build-using-namespace)
#include <fstream>
-#include <test_data.hpp>
+#include "make_test_data_available.hpp"
TEST_CASE("JSON patch")
{
@@ -53,7 +33,7 @@
SECTION("4.1 add")
{
- json patch = R"([{ "op": "add", "path": "/a/b/c", "value": [ "foo", "bar" ] }])"_json;
+ json patch1 = R"([{ "op": "add", "path": "/a/b", "value": [ "foo", "bar" ] }])"_json;
// However, the object itself or an array containing it does need
// to exist, and it remains an error for that not to be the case.
@@ -63,26 +43,32 @@
// is not an error, because "a" exists, and "b" will be added to
// its value.
- CHECK_NOTHROW(doc1.patch(patch));
+ CHECK_NOTHROW(doc1.patch(patch1));
auto doc1_ans = R"(
{
"a": {
"foo": 1,
- "b": {
- "c": [ "foo", "bar" ]
- }
+ "b": [ "foo", "bar" ]
}
}
)"_json;
- CHECK(doc1.patch(patch) == doc1_ans);
+ CHECK(doc1.patch(patch1) == doc1_ans);
// It is an error in this document:
json doc2 = R"({ "q": { "bar": 2 } })"_json;
// because "a" does not exist.
- CHECK_THROWS_AS(doc2.patch(patch), json::out_of_range&);
- CHECK_THROWS_WITH(doc2.patch(patch),
- "[json.exception.out_of_range.403] key 'a' not found");
+ CHECK_THROWS_WITH_AS(doc2.patch(patch1), "[json.exception.out_of_range.403] key 'a' not found", json::out_of_range&);
+
+ json doc3 = R"({ "a": {} })"_json;
+ json patch2 = R"([{ "op": "add", "path": "/a/b/c", "value": 1 }])"_json;
+
+ // should cause an error because "b" does not exist in doc3
+#if JSON_DIAGNOSTICS
+ CHECK_THROWS_WITH_AS(doc3.patch(patch2), "[json.exception.out_of_range.403] (/a) key 'b' not found", json::out_of_range&);
+#else
+ CHECK_THROWS_WITH_AS(doc3.patch(patch2), "[json.exception.out_of_range.403] key 'b' not found", json::out_of_range&);
+#endif
}
SECTION("4.2 remove")
@@ -430,9 +416,7 @@
// references neither the root of the document, nor a member of
// an existing object, nor a member of an existing array.
- CHECK_THROWS_AS(doc.patch(patch), json::out_of_range&);
- CHECK_THROWS_WITH(doc.patch(patch),
- "[json.exception.out_of_range.403] key 'baz' not found");
+ CHECK_THROWS_WITH_AS(doc.patch(patch), "[json.exception.out_of_range.403] key 'baz' not found", json::out_of_range&);
}
// A.13. Invalid JSON Patch Document
@@ -681,20 +665,17 @@
{
json j;
json patch = {{"op", "add"}, {"path", ""}, {"value", 1}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
- CHECK_THROWS_WITH(j.patch(patch),
- "[json.exception.parse_error.104] parse error: JSON patch must be an array of objects");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.104] parse error: JSON patch must be an array of objects", json::parse_error&);
}
SECTION("not an array of objects")
{
json j;
json patch = {"op", "add", "path", "", "value", 1};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.104] parse error: (/0) JSON patch must be an array of objects");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.104] parse error: (/0) JSON patch must be an array of objects", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.104] parse error: JSON patch must be an array of objects");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.104] parse error: JSON patch must be an array of objects", json::parse_error&);
#endif
}
@@ -702,11 +683,10 @@
{
json j;
json patch = {{{"foo", "bar"}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation must have member 'op'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation must have member 'op'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation must have member 'op'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation must have member 'op'", json::parse_error&);
#endif
}
@@ -714,11 +694,10 @@
{
json j;
json patch = {{{"op", 1}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation must have string member 'op'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation must have string member 'op'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation must have string member 'op'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation must have string member 'op'", json::parse_error&);
#endif
}
@@ -726,11 +705,10 @@
{
json j;
json patch = {{{"op", "foo"}, {"path", ""}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation value 'foo' is invalid");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation value 'foo' is invalid", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation value 'foo' is invalid");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation value 'foo' is invalid", json::parse_error&);
#endif
}
}
@@ -741,11 +719,10 @@
{
json j;
json patch = {{{"op", "add"}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'add' must have member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'add' must have member 'path'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'add' must have member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'add' must have member 'path'", json::parse_error&);
#endif
}
@@ -753,11 +730,10 @@
{
json j;
json patch = {{{"op", "add"}, {"path", 1}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'add' must have string member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'add' must have string member 'path'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'add' must have string member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'add' must have string member 'path'", json::parse_error&);
#endif
}
@@ -765,11 +741,10 @@
{
json j;
json patch = {{{"op", "add"}, {"path", ""}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'add' must have member 'value'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'add' must have member 'value'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'add' must have member 'value'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'add' must have member 'value'", json::parse_error&);
#endif
}
@@ -777,9 +752,7 @@
{
json j = {1, 2};
json patch = {{{"op", "add"}, {"path", "/4"}, {"value", 4}}};
- CHECK_THROWS_AS(j.patch(patch), json::out_of_range&);
- CHECK_THROWS_WITH(j.patch(patch),
- "[json.exception.out_of_range.401] array index 4 is out of range");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.out_of_range.401] array index 4 is out of range", json::out_of_range&);
}
}
@@ -789,11 +762,10 @@
{
json j;
json patch = {{{"op", "remove"}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'remove' must have member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'remove' must have member 'path'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'remove' must have member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'remove' must have member 'path'", json::parse_error&);
#endif
}
@@ -801,11 +773,10 @@
{
json j;
json patch = {{{"op", "remove"}, {"path", 1}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'remove' must have string member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'remove' must have string member 'path'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'remove' must have string member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'remove' must have string member 'path'", json::parse_error&);
#endif
}
@@ -813,27 +784,21 @@
{
json j = {1, 2, 3};
json patch = {{{"op", "remove"}, {"path", "/17"}}};
- CHECK_THROWS_AS(j.patch(patch), json::out_of_range&);
- CHECK_THROWS_WITH(j.patch(patch),
- "[json.exception.out_of_range.401] array index 17 is out of range");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.out_of_range.401] array index 17 is out of range", json::out_of_range&);
}
SECTION("nonexisting target location (object)")
{
json j = {{"foo", 1}, {"bar", 2}};
json patch = {{{"op", "remove"}, {"path", "/baz"}}};
- CHECK_THROWS_AS(j.patch(patch), json::out_of_range&);
- CHECK_THROWS_WITH(j.patch(patch),
- "[json.exception.out_of_range.403] key 'baz' not found");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.out_of_range.403] key 'baz' not found", json::out_of_range&);
}
SECTION("root element as target location")
{
json j = "string";
json patch = {{{"op", "remove"}, {"path", ""}}};
- CHECK_THROWS_AS(j.patch(patch), json::out_of_range&);
- CHECK_THROWS_WITH(j.patch(patch),
- "[json.exception.out_of_range.405] JSON pointer has no parent");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.out_of_range.405] JSON pointer has no parent", json::out_of_range&);
}
}
@@ -843,11 +808,10 @@
{
json j;
json patch = {{{"op", "replace"}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'replace' must have member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'replace' must have member 'path'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'replace' must have member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'replace' must have member 'path'", json::parse_error&);
#endif
}
@@ -855,11 +819,10 @@
{
json j;
json patch = {{{"op", "replace"}, {"path", 1}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'replace' must have string member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'replace' must have string member 'path'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'replace' must have string member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'replace' must have string member 'path'", json::parse_error&);
#endif
}
@@ -867,11 +830,10 @@
{
json j;
json patch = {{{"op", "replace"}, {"path", ""}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'replace' must have member 'value'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'replace' must have member 'value'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'replace' must have member 'value'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'replace' must have member 'value'", json::parse_error&);
#endif
}
@@ -879,18 +841,14 @@
{
json j = {1, 2, 3};
json patch = {{{"op", "replace"}, {"path", "/17"}, {"value", 19}}};
- CHECK_THROWS_AS(j.patch(patch), json::out_of_range&);
- CHECK_THROWS_WITH(j.patch(patch),
- "[json.exception.out_of_range.401] array index 17 is out of range");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.out_of_range.401] array index 17 is out of range", json::out_of_range&);
}
SECTION("nonexisting target location (object)")
{
json j = {{"foo", 1}, {"bar", 2}};
json patch = {{{"op", "replace"}, {"path", "/baz"}, {"value", 3}}};
- CHECK_THROWS_AS(j.patch(patch), json::out_of_range&);
- CHECK_THROWS_WITH(j.patch(patch),
- "[json.exception.out_of_range.403] key 'baz' not found");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.out_of_range.403] key 'baz' not found", json::out_of_range&);
}
}
@@ -900,11 +858,10 @@
{
json j;
json patch = {{{"op", "move"}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'move' must have member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'move' must have member 'path'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'move' must have member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'move' must have member 'path'", json::parse_error&);
#endif
}
@@ -912,11 +869,10 @@
{
json j;
json patch = {{{"op", "move"}, {"path", 1}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'move' must have string member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'move' must have string member 'path'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'move' must have string member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'move' must have string member 'path'", json::parse_error&);
#endif
}
@@ -926,9 +882,9 @@
json patch = {{{"op", "move"}, {"path", ""}}};
CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'move' must have member 'from'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'move' must have member 'from'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'move' must have member 'from'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'move' must have member 'from'", json::parse_error&);
#endif
}
@@ -938,9 +894,9 @@
json patch = {{{"op", "move"}, {"path", ""}, {"from", 1}}};
CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'move' must have string member 'from'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'move' must have string member 'from'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'move' must have string member 'from'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'move' must have string member 'from'", json::parse_error&);
#endif
}
@@ -948,18 +904,14 @@
{
json j = {1, 2, 3};
json patch = {{{"op", "move"}, {"path", "/0"}, {"from", "/5"}}};
- CHECK_THROWS_AS(j.patch(patch), json::out_of_range&);
- CHECK_THROWS_WITH(j.patch(patch),
- "[json.exception.out_of_range.401] array index 5 is out of range");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.out_of_range.401] array index 5 is out of range", json::out_of_range&);
}
SECTION("nonexisting from location (object)")
{
json j = {{"foo", 1}, {"bar", 2}};
json patch = {{{"op", "move"}, {"path", "/baz"}, {"from", "/baz"}}};
- CHECK_THROWS_AS(j.patch(patch), json::out_of_range&);
- CHECK_THROWS_WITH(j.patch(patch),
- "[json.exception.out_of_range.403] key 'baz' not found");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.out_of_range.403] key 'baz' not found", json::out_of_range&);
}
}
@@ -969,11 +921,10 @@
{
json j;
json patch = {{{"op", "copy"}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'copy' must have member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'copy' must have member 'path'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'copy' must have member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'copy' must have member 'path'", json::parse_error&);
#endif
}
@@ -981,11 +932,10 @@
{
json j;
json patch = {{{"op", "copy"}, {"path", 1}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'copy' must have string member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'copy' must have string member 'path'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'copy' must have string member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'copy' must have string member 'path'", json::parse_error&);
#endif
}
@@ -993,11 +943,10 @@
{
json j;
json patch = {{{"op", "copy"}, {"path", ""}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'copy' must have member 'from'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'copy' must have member 'from'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'copy' must have member 'from'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'copy' must have member 'from'", json::parse_error&);
#endif
}
@@ -1005,11 +954,10 @@
{
json j;
json patch = {{{"op", "copy"}, {"path", ""}, {"from", 1}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'copy' must have string member 'from'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'copy' must have string member 'from'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'copy' must have string member 'from'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'copy' must have string member 'from'", json::parse_error&);
#endif
}
@@ -1017,18 +965,14 @@
{
json j = {1, 2, 3};
json patch = {{{"op", "copy"}, {"path", "/0"}, {"from", "/5"}}};
- CHECK_THROWS_AS(j.patch(patch), json::out_of_range&);
- CHECK_THROWS_WITH(j.patch(patch),
- "[json.exception.out_of_range.401] array index 5 is out of range");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.out_of_range.401] array index 5 is out of range", json::out_of_range&);
}
SECTION("nonexisting from location (object)")
{
json j = {{"foo", 1}, {"bar", 2}};
json patch = {{{"op", "copy"}, {"path", "/fob"}, {"from", "/baz"}}};
- CHECK_THROWS_AS(j.patch(patch), json::out_of_range&);
- CHECK_THROWS_WITH(j.patch(patch),
- "[json.exception.out_of_range.403] key 'baz' not found");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.out_of_range.403] key 'baz' not found", json::out_of_range&);
}
}
@@ -1038,11 +982,10 @@
{
json j;
json patch = {{{"op", "test"}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'test' must have member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'test' must have member 'path'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'test' must have member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'test' must have member 'path'", json::parse_error&);
#endif
}
@@ -1050,11 +993,10 @@
{
json j;
json patch = {{{"op", "test"}, {"path", 1}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'test' must have string member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'test' must have string member 'path'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'test' must have string member 'path'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'test' must have string member 'path'", json::parse_error&);
#endif
}
@@ -1062,11 +1004,10 @@
{
json j;
json patch = {{{"op", "test"}, {"path", ""}}};
- CHECK_THROWS_AS(j.patch(patch), json::parse_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'test' must have member 'value'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: (/0) operation 'test' must have member 'value'", json::parse_error&);
#else
- CHECK_THROWS_WITH(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'test' must have member 'value'");
+ CHECK_THROWS_WITH_AS(j.patch(patch), "[json.exception.parse_error.105] parse error: operation 'test' must have member 'value'", json::parse_error&);
#endif
}
}
diff --git a/test/src/unit-json_pointer.cpp b/tests/src/unit-json_pointer.cpp
similarity index 62%
rename from test/src/unit-json_pointer.cpp
rename to tests/src/unit-json_pointer.cpp
index 41d7d3a..445b8f0 100644
--- a/test/src/unit-json_pointer.cpp
+++ b/tests/src/unit-json_pointer.cpp
@@ -1,69 +1,45 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
#define JSON_TESTS_PRIVATE
#include <nlohmann/json.hpp>
using nlohmann::json;
+using namespace nlohmann::literals; // NOLINT(google-build-using-namespace)
+
+#include <sstream>
TEST_CASE("JSON pointers")
{
SECTION("errors")
{
- CHECK_THROWS_AS(json::json_pointer("foo"), json::parse_error&);
- CHECK_THROWS_WITH(json::json_pointer("foo"),
- "[json.exception.parse_error.107] parse error at byte 1: JSON pointer must be empty or begin with '/' - was: 'foo'");
+ CHECK_THROWS_WITH_AS(json::json_pointer("foo"),
+ "[json.exception.parse_error.107] parse error at byte 1: JSON pointer must be empty or begin with '/' - was: 'foo'", json::parse_error&);
- CHECK_THROWS_AS(json::json_pointer("/~~"), json::parse_error&);
- CHECK_THROWS_WITH(json::json_pointer("/~~"),
- "[json.exception.parse_error.108] parse error: escape character '~' must be followed with '0' or '1'");
+ CHECK_THROWS_WITH_AS(json::json_pointer("/~~"),
+ "[json.exception.parse_error.108] parse error: escape character '~' must be followed with '0' or '1'", json::parse_error&);
- CHECK_THROWS_AS(json::json_pointer("/~"), json::parse_error&);
- CHECK_THROWS_WITH(json::json_pointer("/~"),
- "[json.exception.parse_error.108] parse error: escape character '~' must be followed with '0' or '1'");
+ CHECK_THROWS_WITH_AS(json::json_pointer("/~"),
+ "[json.exception.parse_error.108] parse error: escape character '~' must be followed with '0' or '1'", json::parse_error&);
json::json_pointer p;
- CHECK_THROWS_AS(p.top(), json::out_of_range&);
- CHECK_THROWS_WITH(p.top(),
- "[json.exception.out_of_range.405] JSON pointer has no parent");
- CHECK_THROWS_AS(p.pop_back(), json::out_of_range&);
- CHECK_THROWS_WITH(p.pop_back(),
- "[json.exception.out_of_range.405] JSON pointer has no parent");
+ CHECK_THROWS_WITH_AS(p.top(),
+ "[json.exception.out_of_range.405] JSON pointer has no parent", json::out_of_range&);
+ CHECK_THROWS_WITH_AS(p.pop_back(),
+ "[json.exception.out_of_range.405] JSON pointer has no parent", json::out_of_range&);
SECTION("array index error")
{
json v = {1, 2, 3, 4};
json::json_pointer ptr("/10e");
- CHECK_THROWS_AS(v[ptr], json::out_of_range&);
- CHECK_THROWS_WITH(v[ptr],
- "[json.exception.out_of_range.404] unresolved reference token '10e'");
+ CHECK_THROWS_WITH_AS(v[ptr],
+ "[json.exception.out_of_range.404] unresolved reference token '10e'", json::out_of_range&);
}
}
@@ -165,12 +141,10 @@
// unresolved access
json j_primitive = 1;
- CHECK_THROWS_AS(j_primitive["/foo"_json_pointer], json::out_of_range&);
- CHECK_THROWS_WITH(j_primitive["/foo"_json_pointer],
- "[json.exception.out_of_range.404] unresolved reference token 'foo'");
- CHECK_THROWS_AS(j_primitive.at("/foo"_json_pointer), json::out_of_range&);
- CHECK_THROWS_WITH(j_primitive.at("/foo"_json_pointer),
- "[json.exception.out_of_range.404] unresolved reference token 'foo'");
+ CHECK_THROWS_WITH_AS(j_primitive["/foo"_json_pointer],
+ "[json.exception.out_of_range.404] unresolved reference token 'foo'", json::out_of_range&);
+ CHECK_THROWS_WITH_AS(j_primitive.at("/foo"_json_pointer),
+ "[json.exception.out_of_range.404] unresolved reference token 'foo'", json::out_of_range&);
CHECK(!j_primitive.contains(json::json_pointer("/foo")));
}
@@ -229,18 +203,15 @@
CHECK(j[json::json_pointer("/m~0n")] == j["m~n"]);
// unescaped access
- CHECK_THROWS_AS(j.at(json::json_pointer("/a/b")), json::out_of_range&);
- CHECK_THROWS_WITH(j.at(json::json_pointer("/a/b")),
- "[json.exception.out_of_range.403] key 'a' not found");
+ CHECK_THROWS_WITH_AS(j.at(json::json_pointer("/a/b")),
+ "[json.exception.out_of_range.403] key 'a' not found", json::out_of_range&);
// unresolved access
const json j_primitive = 1;
- CHECK_THROWS_AS(j_primitive["/foo"_json_pointer], json::out_of_range&);
- CHECK_THROWS_WITH(j_primitive["/foo"_json_pointer],
- "[json.exception.out_of_range.404] unresolved reference token 'foo'");
- CHECK_THROWS_AS(j_primitive.at("/foo"_json_pointer), json::out_of_range&);
- CHECK_THROWS_WITH(j_primitive.at("/foo"_json_pointer),
- "[json.exception.out_of_range.404] unresolved reference token 'foo'");
+ CHECK_THROWS_WITH_AS(j_primitive["/foo"_json_pointer],
+ "[json.exception.out_of_range.404] unresolved reference token 'foo'", json::out_of_range&);
+ CHECK_THROWS_WITH_AS(j_primitive.at("/foo"_json_pointer),
+ "[json.exception.out_of_range.404] unresolved reference token 'foo'", json::out_of_range&);
}
SECTION("user-defined string literal")
@@ -300,18 +271,14 @@
CHECK(j == json({1, 13, 3, 33, nullptr, 55}));
// error with leading 0
- CHECK_THROWS_AS(j["/01"_json_pointer], json::parse_error&);
- CHECK_THROWS_WITH(j["/01"_json_pointer],
- "[json.exception.parse_error.106] parse error: array index '01' must not begin with '0'");
- CHECK_THROWS_AS(j_const["/01"_json_pointer], json::parse_error&);
- CHECK_THROWS_WITH(j_const["/01"_json_pointer],
- "[json.exception.parse_error.106] parse error: array index '01' must not begin with '0'");
- CHECK_THROWS_AS(j.at("/01"_json_pointer), json::parse_error&);
- CHECK_THROWS_WITH(j.at("/01"_json_pointer),
- "[json.exception.parse_error.106] parse error: array index '01' must not begin with '0'");
- CHECK_THROWS_AS(j_const.at("/01"_json_pointer), json::parse_error&);
- CHECK_THROWS_WITH(j_const.at("/01"_json_pointer),
- "[json.exception.parse_error.106] parse error: array index '01' must not begin with '0'");
+ CHECK_THROWS_WITH_AS(j["/01"_json_pointer],
+ "[json.exception.parse_error.106] parse error: array index '01' must not begin with '0'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(j_const["/01"_json_pointer],
+ "[json.exception.parse_error.106] parse error: array index '01' must not begin with '0'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(j.at("/01"_json_pointer),
+ "[json.exception.parse_error.106] parse error: array index '01' must not begin with '0'", json::parse_error&);
+ CHECK_THROWS_WITH_AS(j_const.at("/01"_json_pointer),
+ "[json.exception.parse_error.106] parse error: array index '01' must not begin with '0'", json::parse_error&);
CHECK(!j.contains("/01"_json_pointer));
CHECK(!j.contains("/01"_json_pointer));
@@ -319,43 +286,33 @@
CHECK(!j_const.contains("/01"_json_pointer));
// error with incorrect numbers
- CHECK_THROWS_AS(j["/one"_json_pointer] = 1, json::parse_error&);
- CHECK_THROWS_WITH(j["/one"_json_pointer] = 1,
- "[json.exception.parse_error.109] parse error: array index 'one' is not a number");
- CHECK_THROWS_AS(j_const["/one"_json_pointer] == 1, json::parse_error&);
- CHECK_THROWS_WITH(j_const["/one"_json_pointer] == 1,
- "[json.exception.parse_error.109] parse error: array index 'one' is not a number");
+ CHECK_THROWS_WITH_AS(j["/one"_json_pointer] = 1,
+ "[json.exception.parse_error.109] parse error: array index 'one' is not a number", json::parse_error&);
+ CHECK_THROWS_WITH_AS(j_const["/one"_json_pointer] == 1,
+ "[json.exception.parse_error.109] parse error: array index 'one' is not a number", json::parse_error&);
- CHECK_THROWS_AS(j.at("/one"_json_pointer) = 1, json::parse_error&);
- CHECK_THROWS_WITH(j.at("/one"_json_pointer) = 1,
- "[json.exception.parse_error.109] parse error: array index 'one' is not a number");
- CHECK_THROWS_AS(j_const.at("/one"_json_pointer) == 1, json::parse_error&);
- CHECK_THROWS_WITH(j_const.at("/one"_json_pointer) == 1,
- "[json.exception.parse_error.109] parse error: array index 'one' is not a number");
+ CHECK_THROWS_WITH_AS(j.at("/one"_json_pointer) = 1,
+ "[json.exception.parse_error.109] parse error: array index 'one' is not a number", json::parse_error&);
+ CHECK_THROWS_WITH_AS(j_const.at("/one"_json_pointer) == 1,
+ "[json.exception.parse_error.109] parse error: array index 'one' is not a number", json::parse_error&);
- CHECK_THROWS_AS(j["/+1"_json_pointer] = 1, json::parse_error&);
- CHECK_THROWS_WITH(j["/+1"_json_pointer] = 1,
- "[json.exception.parse_error.109] parse error: array index '+1' is not a number");
- CHECK_THROWS_AS(j_const["/+1"_json_pointer] == 1, json::parse_error&);
- CHECK_THROWS_WITH(j_const["/+1"_json_pointer] == 1,
- "[json.exception.parse_error.109] parse error: array index '+1' is not a number");
+ CHECK_THROWS_WITH_AS(j["/+1"_json_pointer] = 1,
+ "[json.exception.parse_error.109] parse error: array index '+1' is not a number", json::parse_error&);
+ CHECK_THROWS_WITH_AS(j_const["/+1"_json_pointer] == 1,
+ "[json.exception.parse_error.109] parse error: array index '+1' is not a number", json::parse_error&);
- CHECK_THROWS_AS(j["/1+1"_json_pointer] = 1, json::out_of_range&);
- CHECK_THROWS_WITH(j["/1+1"_json_pointer] = 1,
- "[json.exception.out_of_range.404] unresolved reference token '1+1'");
- CHECK_THROWS_AS(j_const["/1+1"_json_pointer] == 1, json::out_of_range&);
- CHECK_THROWS_WITH(j_const["/1+1"_json_pointer] == 1,
- "[json.exception.out_of_range.404] unresolved reference token '1+1'");
+ CHECK_THROWS_WITH_AS(j["/1+1"_json_pointer] = 1,
+ "[json.exception.out_of_range.404] unresolved reference token '1+1'", json::out_of_range&);
+ CHECK_THROWS_WITH_AS(j_const["/1+1"_json_pointer] == 1,
+ "[json.exception.out_of_range.404] unresolved reference token '1+1'", json::out_of_range&);
{
auto too_large_index = std::to_string((std::numeric_limits<unsigned long long>::max)()) + "1";
json::json_pointer jp(std::string("/") + too_large_index);
std::string throw_msg = std::string("[json.exception.out_of_range.404] unresolved reference token '") + too_large_index + "'";
- CHECK_THROWS_AS(j[jp] = 1, json::out_of_range&);
- CHECK_THROWS_WITH(j[jp] = 1, throw_msg.c_str());
- CHECK_THROWS_AS(j_const[jp] == 1, json::out_of_range&);
- CHECK_THROWS_WITH(j_const[jp] == 1, throw_msg.c_str());
+ CHECK_THROWS_WITH_AS(j[jp] = 1, throw_msg.c_str(), json::out_of_range&);
+ CHECK_THROWS_WITH_AS(j_const[jp] == 1, throw_msg.c_str(), json::out_of_range&);
}
// on some machines, the check below is not constant
@@ -369,47 +326,39 @@
json::json_pointer jp(std::string("/") + too_large_index);
std::string throw_msg = std::string("[json.exception.out_of_range.410] array index ") + too_large_index + " exceeds size_type";
- CHECK_THROWS_AS(j[jp] = 1, json::out_of_range&);
- CHECK_THROWS_WITH(j[jp] = 1, throw_msg.c_str());
- CHECK_THROWS_AS(j_const[jp] == 1, json::out_of_range&);
- CHECK_THROWS_WITH(j_const[jp] == 1, throw_msg.c_str());
+ CHECK_THROWS_WITH_AS(j[jp] = 1, throw_msg.c_str(), json::out_of_range&);
+ CHECK_THROWS_WITH_AS(j_const[jp] == 1, throw_msg.c_str(), json::out_of_range&);
}
DOCTEST_MSVC_SUPPRESS_WARNING_POP
- CHECK_THROWS_AS(j.at("/one"_json_pointer) = 1, json::parse_error&);
- CHECK_THROWS_WITH(j.at("/one"_json_pointer) = 1,
- "[json.exception.parse_error.109] parse error: array index 'one' is not a number");
- CHECK_THROWS_AS(j_const.at("/one"_json_pointer) == 1, json::parse_error&);
- CHECK_THROWS_WITH(j_const.at("/one"_json_pointer) == 1,
- "[json.exception.parse_error.109] parse error: array index 'one' is not a number");
+ CHECK_THROWS_WITH_AS(j.at("/one"_json_pointer) = 1,
+ "[json.exception.parse_error.109] parse error: array index 'one' is not a number", json::parse_error&);
+ CHECK_THROWS_WITH_AS(j_const.at("/one"_json_pointer) == 1,
+ "[json.exception.parse_error.109] parse error: array index 'one' is not a number", json::parse_error&);
CHECK(!j.contains("/one"_json_pointer));
CHECK(!j.contains("/one"_json_pointer));
CHECK(!j_const.contains("/one"_json_pointer));
CHECK(!j_const.contains("/one"_json_pointer));
- CHECK_THROWS_AS(json({{"/list/0", 1}, {"/list/1", 2}, {"/list/three", 3}}).unflatten(), json::parse_error&);
- CHECK_THROWS_WITH(json({{"/list/0", 1}, {"/list/1", 2}, {"/list/three", 3}}).unflatten(),
- "[json.exception.parse_error.109] parse error: array index 'three' is not a number");
+ CHECK_THROWS_WITH_AS(json({{"/list/0", 1}, {"/list/1", 2}, {"/list/three", 3}}).unflatten(),
+ "[json.exception.parse_error.109] parse error: array index 'three' is not a number", json::parse_error&);
// assign to "-"
j["/-"_json_pointer] = 99;
CHECK(j == json({1, 13, 3, 33, nullptr, 55, 99}));
// error when using "-" in const object
- CHECK_THROWS_AS(j_const["/-"_json_pointer], json::out_of_range&);
- CHECK_THROWS_WITH(j_const["/-"_json_pointer],
- "[json.exception.out_of_range.402] array index '-' (3) is out of range");
+ CHECK_THROWS_WITH_AS(j_const["/-"_json_pointer],
+ "[json.exception.out_of_range.402] array index '-' (3) is out of range", json::out_of_range&);
CHECK(!j_const.contains("/-"_json_pointer));
// error when using "-" with at
- CHECK_THROWS_AS(j.at("/-"_json_pointer), json::out_of_range&);
- CHECK_THROWS_WITH(j.at("/-"_json_pointer),
- "[json.exception.out_of_range.402] array index '-' (7) is out of range");
- CHECK_THROWS_AS(j_const.at("/-"_json_pointer), json::out_of_range&);
- CHECK_THROWS_WITH(j_const.at("/-"_json_pointer),
- "[json.exception.out_of_range.402] array index '-' (3) is out of range");
+ CHECK_THROWS_WITH_AS(j.at("/-"_json_pointer),
+ "[json.exception.out_of_range.402] array index '-' (7) is out of range", json::out_of_range&);
+ CHECK_THROWS_WITH_AS(j_const.at("/-"_json_pointer),
+ "[json.exception.out_of_range.402] array index '-' (3) is out of range", json::out_of_range&);
CHECK(!j_const.contains("/-"_json_pointer));
}
@@ -423,24 +372,20 @@
CHECK(j["/2"_json_pointer] == j[2]);
// assign to nonexisting index
- CHECK_THROWS_AS(j.at("/3"_json_pointer), json::out_of_range&);
- CHECK_THROWS_WITH(j.at("/3"_json_pointer),
- "[json.exception.out_of_range.401] array index 3 is out of range");
+ CHECK_THROWS_WITH_AS(j.at("/3"_json_pointer),
+ "[json.exception.out_of_range.401] array index 3 is out of range", json::out_of_range&);
CHECK(!j.contains("/3"_json_pointer));
// assign to nonexisting index (with gap)
- CHECK_THROWS_AS(j.at("/5"_json_pointer), json::out_of_range&);
- CHECK_THROWS_WITH(j.at("/5"_json_pointer),
- "[json.exception.out_of_range.401] array index 5 is out of range");
+ CHECK_THROWS_WITH_AS(j.at("/5"_json_pointer),
+ "[json.exception.out_of_range.401] array index 5 is out of range", json::out_of_range&);
CHECK(!j.contains("/5"_json_pointer));
// assign to "-"
- CHECK_THROWS_AS(j["/-"_json_pointer], json::out_of_range&);
- CHECK_THROWS_WITH(j["/-"_json_pointer],
- "[json.exception.out_of_range.402] array index '-' (3) is out of range");
- CHECK_THROWS_AS(j.at("/-"_json_pointer), json::out_of_range&);
- CHECK_THROWS_WITH(j.at("/-"_json_pointer),
- "[json.exception.out_of_range.402] array index '-' (3) is out of range");
+ CHECK_THROWS_WITH_AS(j["/-"_json_pointer],
+ "[json.exception.out_of_range.402] array index '-' (3) is out of range", json::out_of_range&);
+ CHECK_THROWS_WITH_AS(j.at("/-"_json_pointer),
+ "[json.exception.out_of_range.402] array index '-' (3) is out of range", json::out_of_range&);
CHECK(!j.contains("/-"_json_pointer));
}
}
@@ -496,23 +441,20 @@
CHECK(j_flatten.unflatten() == j);
// error for nonobjects
- CHECK_THROWS_AS(json(1).unflatten(), json::type_error&);
- CHECK_THROWS_WITH(json(1).unflatten(),
- "[json.exception.type_error.314] only objects can be unflattened");
+ CHECK_THROWS_WITH_AS(json(1).unflatten(),
+ "[json.exception.type_error.314] only objects can be unflattened", json::type_error&);
// error for nonprimitve values
- CHECK_THROWS_AS(json({{"/1", {1, 2, 3}}}).unflatten(), json::type_error&);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(json({{"/1", {1, 2, 3}}}).unflatten(), "[json.exception.type_error.315] (/~11) values in object must be primitive");
+ CHECK_THROWS_WITH_AS(json({{"/1", {1, 2, 3}}}).unflatten(), "[json.exception.type_error.315] (/~11) values in object must be primitive", json::type_error&);
#else
- CHECK_THROWS_WITH(json({{"/1", {1, 2, 3}}}).unflatten(), "[json.exception.type_error.315] values in object must be primitive");
+ CHECK_THROWS_WITH_AS(json({{"/1", {1, 2, 3}}}).unflatten(), "[json.exception.type_error.315] values in object must be primitive", json::type_error&);
#endif
// error for conflicting values
json j_error = {{"", 42}, {"/foo", 17}};
- CHECK_THROWS_AS(j_error.unflatten(), json::type_error&);
- CHECK_THROWS_WITH(j_error.unflatten(),
- "[json.exception.type_error.313] invalid value to unflatten");
+ CHECK_THROWS_WITH_AS(j_error.unflatten(),
+ "[json.exception.type_error.313] invalid value to unflatten", json::type_error&);
// explicit roundtrip check
CHECK(j.flatten().unflatten() == j);
@@ -536,12 +478,16 @@
SECTION("string representation")
{
- for (const auto* ptr :
+ for (const auto* ptr_str :
{"", "/foo", "/foo/0", "/", "/a~1b", "/c%d", "/e^f", "/g|h", "/i\\j", "/k\"l", "/ ", "/m~0n"
})
{
- CHECK(json::json_pointer(ptr).to_string() == ptr);
- CHECK(std::string(json::json_pointer(ptr)) == ptr);
+ json::json_pointer ptr(ptr_str);
+ std::stringstream ss;
+ ss << ptr;
+ CHECK(ptr.to_string() == ptr_str);
+ CHECK(std::string(ptr) == ptr_str);
+ CHECK(ss.str() == ptr_str);
}
}
@@ -700,4 +646,54 @@
CHECK(j[ptr] == j["object"]["/"]);
CHECK(ptr.to_string() == "/object/~1");
}
+
+ SECTION("equality comparison")
+ {
+ auto ptr1 = json::json_pointer("/foo/bar");
+ auto ptr2 = json::json_pointer("/foo/bar");
+
+ CHECK(ptr1 == ptr2);
+ CHECK_FALSE(ptr1 != ptr2);
+ }
+
+ SECTION("backwards compatibility and mixing")
+ {
+ json j = R"(
+ {
+ "foo": ["bar", "baz"]
+ }
+ )"_json;
+
+ using nlohmann::ordered_json;
+ using json_ptr_str = nlohmann::json_pointer<std::string>;
+ using json_ptr_j = nlohmann::json_pointer<json>;
+ using json_ptr_oj = nlohmann::json_pointer<ordered_json>;
+
+ CHECK(std::is_same<json_ptr_str::string_t, json::json_pointer::string_t>::value);
+ CHECK(std::is_same<json_ptr_str::string_t, ordered_json::json_pointer::string_t>::value);
+ CHECK(std::is_same<json_ptr_str::string_t, json_ptr_j::string_t>::value);
+ CHECK(std::is_same<json_ptr_str::string_t, json_ptr_oj::string_t>::value);
+
+ json_ptr_str ptr{"/foo/0"};
+ json_ptr_j ptr_j{"/foo/0"};
+ json_ptr_oj ptr_oj{"/foo/0"};
+
+ CHECK(j.contains(ptr));
+ CHECK(j.contains(ptr_j));
+ CHECK(j.contains(ptr_oj));
+
+ CHECK(j.at(ptr) == j.at(ptr_j));
+ CHECK(j.at(ptr) == j.at(ptr_oj));
+
+ CHECK(j[ptr] == j[ptr_j]);
+ CHECK(j[ptr] == j[ptr_oj]);
+
+ CHECK(j.value(ptr, "x") == j.value(ptr_j, "x"));
+ CHECK(j.value(ptr, "x") == j.value(ptr_oj, "x"));
+
+ CHECK(ptr == ptr_j);
+ CHECK(ptr == ptr_oj);
+ CHECK_FALSE(ptr != ptr_j);
+ CHECK_FALSE(ptr != ptr_oj);
+ }
}
diff --git a/tests/src/unit-large_json.cpp b/tests/src/unit-large_json.cpp
new file mode 100644
index 0000000..d9c5421
--- /dev/null
+++ b/tests/src/unit-large_json.cpp
@@ -0,0 +1,29 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#include <nlohmann/json.hpp>
+using nlohmann::json;
+
+#include <algorithm>
+
+TEST_CASE("tests on very large JSONs")
+{
+ SECTION("issue #1419 - Segmentation fault (stack overflow) due to unbounded recursion")
+ {
+ const auto depth = 5000000;
+
+ std::string s(static_cast<std::size_t>(2 * depth), '[');
+ std::fill(s.begin() + depth, s.end(), ']');
+
+ json _;
+ CHECK_NOTHROW(_ = nlohmann::json::parse(s));
+ }
+}
+
diff --git a/test/src/unit-merge_patch.cpp b/tests/src/unit-merge_patch.cpp
similarity index 82%
rename from test/src/unit-merge_patch.cpp
rename to tests/src/unit-merge_patch.cpp
index 6455403..47bab58 100644
--- a/test/src/unit-merge_patch.cpp
+++ b/tests/src/unit-merge_patch.cpp
@@ -1,36 +1,16 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
#include <nlohmann/json.hpp>
using nlohmann::json;
+using namespace nlohmann::literals; // NOLINT(google-build-using-namespace)
TEST_CASE("JSON Merge Patch")
{
diff --git a/tests/src/unit-meta.cpp b/tests/src/unit-meta.cpp
new file mode 100644
index 0000000..2e5029e
--- /dev/null
+++ b/tests/src/unit-meta.cpp
@@ -0,0 +1,36 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#include <nlohmann/json.hpp>
+using nlohmann::json;
+
+TEST_CASE("version information")
+{
+ SECTION("meta()")
+ {
+ json j = json::meta();
+
+ CHECK(j["name"] == "JSON for Modern C++");
+ CHECK(j["copyright"] == "(C) 2013-2022 Niels Lohmann");
+ CHECK(j["url"] == "https://github.com/nlohmann/json");
+ CHECK(j["version"] == json(
+ {
+ {"string", "3.11.0"},
+ {"major", 3},
+ {"minor", 11},
+ {"patch", 0}
+ }));
+
+ CHECK(j.find("platform") != j.end());
+ CHECK(j.at("compiler").find("family") != j.at("compiler").end());
+ CHECK(j.at("compiler").find("version") != j.at("compiler").end());
+ CHECK(j.at("compiler").find("c++") != j.at("compiler").end());
+ }
+}
diff --git a/test/src/unit-modifiers.cpp b/tests/src/unit-modifiers.cpp
similarity index 70%
rename from test/src/unit-modifiers.cpp
rename to tests/src/unit-modifiers.cpp
index ca26930..2c27778 100644
--- a/test/src/unit-modifiers.cpp
+++ b/tests/src/unit-modifiers.cpp
@@ -1,31 +1,11 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// Copyright (c) 2013-2022 Niels Lohmann <http://nlohmann.me>.
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -198,8 +178,7 @@
SECTION("other type")
{
json j = 1;
- CHECK_THROWS_AS(j.push_back("Hello"), json::type_error&);
- CHECK_THROWS_WITH(j.push_back("Hello"), "[json.exception.type_error.308] cannot use push_back() with number");
+ CHECK_THROWS_WITH_AS(j.push_back("Hello"), "[json.exception.type_error.308] cannot use push_back() with number", json::type_error&);
}
}
@@ -228,8 +207,7 @@
{
json j = 1;
json k("Hello");
- CHECK_THROWS_AS(j.push_back(k), json::type_error&);
- CHECK_THROWS_WITH(j.push_back(k), "[json.exception.type_error.308] cannot use push_back() with number");
+ CHECK_THROWS_WITH_AS(j.push_back(k), "[json.exception.type_error.308] cannot use push_back() with number", json::type_error&);
}
}
}
@@ -261,9 +239,7 @@
{
json j = 1;
json k("Hello");
- CHECK_THROWS_AS(j.push_back(json::object_t::value_type({"one", 1})), json::type_error&);
- CHECK_THROWS_WITH(j.push_back(json::object_t::value_type({"one", 1})),
- "[json.exception.type_error.308] cannot use push_back() with number");
+ CHECK_THROWS_WITH_AS(j.push_back(json::object_t::value_type({"one", 1})), "[json.exception.type_error.308] cannot use push_back() with number", json::type_error&);
}
}
@@ -298,12 +274,9 @@
CHECK(j == json({{"key1", 1}, {"key2", "bar"}}));
// invalid values (no string/val pair)
- CHECK_THROWS_AS(j.push_back({1}), json::type_error&);
- CHECK_THROWS_WITH(j.push_back({1}), "[json.exception.type_error.308] cannot use push_back() with object");
- CHECK_THROWS_AS(j.push_back({1, 2}), json::type_error&);
- CHECK_THROWS_WITH(j.push_back({1, 2}), "[json.exception.type_error.308] cannot use push_back() with object");
- CHECK_THROWS_AS(j.push_back({1, 2, 3, 4}), json::type_error&);
- CHECK_THROWS_WITH(j.push_back({1, 2, 3, 4}), "[json.exception.type_error.308] cannot use push_back() with object");
+ CHECK_THROWS_WITH_AS(j.push_back({1}), "[json.exception.type_error.308] cannot use push_back() with object", json::type_error&);
+ CHECK_THROWS_WITH_AS(j.push_back({1, 2}), "[json.exception.type_error.308] cannot use push_back() with object", json::type_error&);
+ CHECK_THROWS_WITH_AS(j.push_back({1, 2, 3, 4}), "[json.exception.type_error.308] cannot use push_back() with object", json::type_error&);
}
}
}
@@ -345,9 +318,7 @@
SECTION("other type")
{
json j = 1;
- CHECK_THROWS_AS(j.emplace_back("Hello"), json::type_error&);
- CHECK_THROWS_WITH(j.emplace_back("Hello"),
- "[json.exception.type_error.311] cannot use emplace_back() with number");
+ CHECK_THROWS_WITH_AS(j.emplace_back("Hello"), "[json.exception.type_error.311] cannot use emplace_back() with number", json::type_error&);
}
}
@@ -405,9 +376,7 @@
SECTION("other type")
{
json j = 1;
- CHECK_THROWS_AS(j.emplace("foo", "bar"), json::type_error&);
- CHECK_THROWS_WITH(j.emplace("foo", "bar"),
- "[json.exception.type_error.311] cannot use emplace() with number");
+ CHECK_THROWS_WITH_AS(j.emplace("foo", "bar"), "[json.exception.type_error.311] cannot use emplace() with number", json::type_error&);
}
}
@@ -437,8 +406,7 @@
SECTION("other type")
{
json j = 1;
- CHECK_THROWS_AS(j += "Hello", json::type_error&);
- CHECK_THROWS_WITH(j += "Hello", "[json.exception.type_error.308] cannot use push_back() with number");
+ CHECK_THROWS_WITH_AS(j += "Hello", "[json.exception.type_error.308] cannot use push_back() with number", json::type_error&);
}
}
@@ -467,8 +435,7 @@
{
json j = 1;
json k("Hello");
- CHECK_THROWS_AS(j += k, json::type_error&);
- CHECK_THROWS_WITH(j += k, "[json.exception.type_error.308] cannot use push_back() with number");
+ CHECK_THROWS_WITH_AS(j += k, "[json.exception.type_error.308] cannot use push_back() with number", json::type_error&);
}
}
}
@@ -500,9 +467,7 @@
{
json j = 1;
json k("Hello");
- CHECK_THROWS_AS(j += json::object_t::value_type({"one", 1}), json::type_error&);
- CHECK_THROWS_WITH(j += json::object_t::value_type({"one", 1}),
- "[json.exception.type_error.308] cannot use push_back() with number");
+ CHECK_THROWS_WITH_AS(j += json::object_t::value_type({"one", 1}), "[json.exception.type_error.308] cannot use push_back() with number", json::type_error&);
}
}
@@ -537,8 +502,7 @@
CHECK(j == json({{"key1", 1}, {"key2", "bar"}}));
json k = {{"key1", 1}};
- CHECK_THROWS_AS((k += {1, 2, 3, 4}), json::type_error&);
- CHECK_THROWS_WITH((k += {1, 2, 3, 4}), "[json.exception.type_error.308] cannot use push_back() with object");
+ CHECK_THROWS_WITH_AS((k += {1, 2, 3, 4}), "[json.exception.type_error.308] cannot use push_back() with object", json::type_error&);
}
}
}
@@ -673,15 +637,10 @@
{
json j_other_array2 = {"first", "second"};
- CHECK_THROWS_AS(j_array.insert(j_array.end(), j_array.begin(), j_array.end()),
- json::invalid_iterator&);
- CHECK_THROWS_AS(j_array.insert(j_array.end(), j_other_array.begin(), j_other_array2.end()),
- json::invalid_iterator&);
-
- CHECK_THROWS_WITH(j_array.insert(j_array.end(), j_array.begin(), j_array.end()),
- "[json.exception.invalid_iterator.211] passed iterators may not belong to container");
- CHECK_THROWS_WITH(j_array.insert(j_array.end(), j_other_array.begin(), j_other_array2.end()),
- "[json.exception.invalid_iterator.210] iterators do not fit");
+ CHECK_THROWS_WITH_AS(j_array.insert(j_array.end(), j_array.begin(), j_array.end()), "[json.exception.invalid_iterator.211] passed iterators may not belong to container",
+ json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j_array.insert(j_array.end(), j_other_array.begin(), j_other_array2.end()), "[json.exception.invalid_iterator.210] iterators do not fit",
+ json::invalid_iterator&);
}
}
@@ -706,16 +665,9 @@
{
json j_other_array2 = {"first", "second"};
- CHECK_THROWS_AS(j_array.insert(j_object2.begin(), j_object2.end()), json::type_error&);
- CHECK_THROWS_AS(j_object1.insert(j_object1.begin(), j_object2.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(j_object1.insert(j_array.begin(), j_array.end()), json::invalid_iterator&);
-
- CHECK_THROWS_WITH(j_array.insert(j_object2.begin(), j_object2.end()),
- "[json.exception.type_error.309] cannot use insert() with array");
- CHECK_THROWS_WITH(j_object1.insert(j_object1.begin(), j_object2.end()),
- "[json.exception.invalid_iterator.210] iterators do not fit");
- CHECK_THROWS_WITH(j_object1.insert(j_array.begin(), j_array.end()),
- "[json.exception.invalid_iterator.202] iterators first and last must point to objects");
+ CHECK_THROWS_WITH_AS(j_array.insert(j_object2.begin(), j_object2.end()), "[json.exception.type_error.309] cannot use insert() with array", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_object1.insert(j_object1.begin(), j_object2.end()), "[json.exception.invalid_iterator.210] iterators do not fit", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j_object1.insert(j_array.begin(), j_array.end()), "[json.exception.invalid_iterator.202] iterators first and last must point to objects", json::invalid_iterator&);
}
}
@@ -754,22 +706,11 @@
// pass iterator to a different array
json j_another_array = {1, 2};
json j_yet_another_array = {"first", "second"};
- CHECK_THROWS_AS(j_array.insert(j_another_array.end(), 10), json::invalid_iterator&);
- CHECK_THROWS_AS(j_array.insert(j_another_array.end(), j_value), json::invalid_iterator&);
- CHECK_THROWS_AS(j_array.insert(j_another_array.end(), 10, 11), json::invalid_iterator&);
- CHECK_THROWS_AS(j_array.insert(j_another_array.end(), j_yet_another_array.begin(), j_yet_another_array.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(j_array.insert(j_another_array.end(), {1, 2, 3, 4}), json::invalid_iterator&);
-
- CHECK_THROWS_WITH(j_array.insert(j_another_array.end(), 10),
- "[json.exception.invalid_iterator.202] iterator does not fit current value");
- CHECK_THROWS_WITH(j_array.insert(j_another_array.end(), j_value),
- "[json.exception.invalid_iterator.202] iterator does not fit current value");
- CHECK_THROWS_WITH(j_array.insert(j_another_array.end(), 10, 11),
- "[json.exception.invalid_iterator.202] iterator does not fit current value");
- CHECK_THROWS_WITH(j_array.insert(j_another_array.end(), j_yet_another_array.begin(), j_yet_another_array.end()),
- "[json.exception.invalid_iterator.202] iterator does not fit current value");
- CHECK_THROWS_WITH(j_array.insert(j_another_array.end(), {1, 2, 3, 4}),
- "[json.exception.invalid_iterator.202] iterator does not fit current value");
+ CHECK_THROWS_WITH_AS(j_array.insert(j_another_array.end(), 10), "[json.exception.invalid_iterator.202] iterator does not fit current value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j_array.insert(j_another_array.end(), j_value), "[json.exception.invalid_iterator.202] iterator does not fit current value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j_array.insert(j_another_array.end(), 10, 11), "[json.exception.invalid_iterator.202] iterator does not fit current value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j_array.insert(j_another_array.end(), j_yet_another_array.begin(), j_yet_another_array.end()), "[json.exception.invalid_iterator.202] iterator does not fit current value", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j_array.insert(j_another_array.end(), {1, 2, 3, 4}), "[json.exception.invalid_iterator.202] iterator does not fit current value", json::invalid_iterator&);
}
SECTION("non-array type")
@@ -777,20 +718,11 @@
// call insert on a non-array type
json j_nonarray = 3;
json j_yet_another_array = {"first", "second"};
- CHECK_THROWS_AS(j_nonarray.insert(j_nonarray.end(), 10), json::type_error&);
- CHECK_THROWS_AS(j_nonarray.insert(j_nonarray.end(), j_value), json::type_error&);
- CHECK_THROWS_AS(j_nonarray.insert(j_nonarray.end(), 10, 11), json::type_error&);
- CHECK_THROWS_AS(j_nonarray.insert(j_nonarray.end(), j_yet_another_array.begin(),
- j_yet_another_array.end()), json::type_error&);
- CHECK_THROWS_AS(j_nonarray.insert(j_nonarray.end(), {1, 2, 3, 4}), json::type_error&);
-
- CHECK_THROWS_WITH(j_nonarray.insert(j_nonarray.end(), 10), "[json.exception.type_error.309] cannot use insert() with number");
- CHECK_THROWS_WITH(j_nonarray.insert(j_nonarray.end(), j_value), "[json.exception.type_error.309] cannot use insert() with number");
- CHECK_THROWS_WITH(j_nonarray.insert(j_nonarray.end(), 10, 11), "[json.exception.type_error.309] cannot use insert() with number");
- CHECK_THROWS_WITH(j_nonarray.insert(j_nonarray.end(), j_yet_another_array.begin(),
- j_yet_another_array.end()), "[json.exception.type_error.309] cannot use insert() with number");
- CHECK_THROWS_WITH(j_nonarray.insert(j_nonarray.end(), {1, 2, 3, 4}),
- "[json.exception.type_error.309] cannot use insert() with number");
+ CHECK_THROWS_WITH_AS(j_nonarray.insert(j_nonarray.end(), 10), "[json.exception.type_error.309] cannot use insert() with number", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray.insert(j_nonarray.end(), j_value), "[json.exception.type_error.309] cannot use insert() with number", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray.insert(j_nonarray.end(), 10, 11), "[json.exception.type_error.309] cannot use insert() with number", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray.insert(j_nonarray.end(), j_yet_another_array.begin(), j_yet_another_array.end()), "[json.exception.type_error.309] cannot use insert() with number", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_nonarray.insert(j_nonarray.end(), {1, 2, 3, 4}), "[json.exception.type_error.309] cannot use insert() with number", json::type_error&);
}
}
@@ -816,11 +748,9 @@
SECTION("wrong types")
{
- CHECK_THROWS_AS(j_array.update(j_object1), json::type_error&);
- CHECK_THROWS_WITH(j_array.update(j_object1), "[json.exception.type_error.312] cannot use update() with array");
+ CHECK_THROWS_WITH_AS(j_array.update(j_object1), "[json.exception.type_error.312] cannot use update() with array", json::type_error&);
- CHECK_THROWS_AS(j_object1.update(j_array), json::type_error&);
- CHECK_THROWS_WITH(j_object1.update(j_array), "[json.exception.type_error.312] cannot use update() with array");
+ CHECK_THROWS_WITH_AS(j_object1.update(j_array), "[json.exception.type_error.312] cannot use update() with array", json::type_error&);
}
}
@@ -846,16 +776,9 @@
{
json j_other_array2 = {"first", "second"};
- CHECK_THROWS_AS(j_array.update(j_object2.begin(), j_object2.end()), json::type_error&);
- CHECK_THROWS_AS(j_object1.update(j_object1.begin(), j_object2.end()), json::invalid_iterator&);
- CHECK_THROWS_AS(j_object1.update(j_array.begin(), j_array.end()), json::type_error&);
-
- CHECK_THROWS_WITH(j_array.update(j_object2.begin(), j_object2.end()),
- "[json.exception.type_error.312] cannot use update() with array");
- CHECK_THROWS_WITH(j_object1.update(j_object1.begin(), j_object2.end()),
- "[json.exception.invalid_iterator.210] iterators do not fit");
- CHECK_THROWS_WITH(j_object1.update(j_array.begin(), j_array.end()),
- "[json.exception.type_error.312] cannot use update() with array");
+ CHECK_THROWS_WITH_AS(j_array.update(j_object2.begin(), j_object2.end()), "[json.exception.type_error.312] cannot use update() with array", json::type_error&);
+ CHECK_THROWS_WITH_AS(j_object1.update(j_object1.begin(), j_object2.end()), "[json.exception.invalid_iterator.210] iterators do not fit", json::invalid_iterator&);
+ CHECK_THROWS_WITH_AS(j_object1.update(j_array.begin(), j_array.end()), "[json.exception.type_error.312] cannot use update() with array", json::type_error&);
}
}
}
@@ -932,8 +855,7 @@
json j = 17;
json::array_t a = {"foo", "bar", "baz"};
- CHECK_THROWS_AS(j.swap(a), json::type_error&);
- CHECK_THROWS_WITH(j.swap(a), "[json.exception.type_error.310] cannot use swap() with number");
+ CHECK_THROWS_WITH_AS(j.swap(a), "[json.exception.type_error.310] cannot use swap(array_t&) with number", json::type_error&);
}
}
@@ -958,8 +880,7 @@
json j = 17;
json::object_t o = {{"cow", "Kuh"}, {"chicken", "Huhn"}};
- CHECK_THROWS_AS(j.swap(o), json::type_error&);
- CHECK_THROWS_WITH(j.swap(o), "[json.exception.type_error.310] cannot use swap() with number");
+ CHECK_THROWS_WITH_AS(j.swap(o), "[json.exception.type_error.310] cannot use swap(object_t&) with number", json::type_error&);
}
}
@@ -984,8 +905,7 @@
json j = 17;
json::string_t s = "Hallo Welt";
- CHECK_THROWS_AS(j.swap(s), json::type_error&);
- CHECK_THROWS_WITH(j.swap(s), "[json.exception.type_error.310] cannot use swap() with number");
+ CHECK_THROWS_WITH_AS(j.swap(s), "[json.exception.type_error.310] cannot use swap(string_t&) with number", json::type_error&);
}
}
@@ -1025,8 +945,8 @@
json::binary_t s1 = {{1, 2, 3, 4}};
std::vector<std::uint8_t> s2 = {{5, 6, 7, 8}};
- CHECK_THROWS_WITH_AS(j.swap(s1), "[json.exception.type_error.310] cannot use swap() with number", json::type_error);
- CHECK_THROWS_WITH_AS(j.swap(s2), "[json.exception.type_error.310] cannot use swap() with number", json::type_error);
+ CHECK_THROWS_WITH_AS(j.swap(s1), "[json.exception.type_error.310] cannot use swap(binary_t&) with number", json::type_error);
+ CHECK_THROWS_WITH_AS(j.swap(s2), "[json.exception.type_error.310] cannot use swap(binary_t::container_type&) with number", json::type_error);
}
}
}
diff --git a/test/src/unit-msgpack.cpp b/tests/src/unit-msgpack.cpp
similarity index 88%
rename from test/src/unit-msgpack.cpp
rename to tests/src/unit-msgpack.cpp
index 70bd6a0..5c720f6 100644
--- a/test/src/unit-msgpack.cpp
+++ b/tests/src/unit-msgpack.cpp
@@ -1,42 +1,22 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
#include <nlohmann/json.hpp>
using nlohmann::json;
+using namespace nlohmann::literals; // NOLINT(google-build-using-namespace)
#include <fstream>
#include <sstream>
#include <iomanip>
#include <set>
-#include <test_data.hpp>
+#include "make_test_data_available.hpp"
#include "test_utils.hpp"
namespace
@@ -1425,76 +1405,54 @@
SECTION("empty byte vector")
{
json _;
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>()), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>()),
- "[json.exception.parse_error.110] parse error at byte 1: syntax error while parsing MessagePack value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>()), "[json.exception.parse_error.110] parse error at byte 1: syntax error while parsing MessagePack value: unexpected end of input", json::parse_error&);
CHECK(json::from_msgpack(std::vector<uint8_t>(), true, false).is_discarded());
}
SECTION("too short byte vector")
{
json _;
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0x87})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcc})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcd})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcd, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xce})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xce, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xce, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xce, 0x00, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xa5, 0x68, 0x65})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0x92, 0x01})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0x81, 0xa1, 0x61})), json::parse_error&);
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xc4, 0x02})), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0x87})),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing MessagePack string: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xcc})),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xcd})),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xcd, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xce})),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xce, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xce, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xce, 0x00, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xcf})),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 6: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00})),
- "[json.exception.parse_error.110] parse error at byte 9: syntax error while parsing MessagePack number: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xa5, 0x68, 0x65})),
- "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing MessagePack string: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0x92, 0x01})),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing MessagePack value: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0x81, 0xa1, 0x61})),
- "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing MessagePack value: unexpected end of input");
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xc4, 0x02})),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing MessagePack binary: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0x87})),
+ "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing MessagePack string: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcc})),
+ "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcd})),
+ "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcd, 0x00})),
+ "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xce})),
+ "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xce, 0x00})),
+ "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xce, 0x00, 0x00})),
+ "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xce, 0x00, 0x00, 0x00})),
+ "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf})),
+ "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00})),
+ "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00})),
+ "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00})),
+ "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00, 0x00})),
+ "[json.exception.parse_error.110] parse error at byte 6: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00, 0x00, 0x00})),
+ "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00})),
+ "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xcf, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00})),
+ "[json.exception.parse_error.110] parse error at byte 9: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xa5, 0x68, 0x65})),
+ "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing MessagePack string: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0x92, 0x01})),
+ "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing MessagePack value: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0x81, 0xa1, 0x61})),
+ "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing MessagePack value: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xc4, 0x02})),
+ "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing MessagePack binary: unexpected end of input", json::parse_error&);
CHECK(json::from_msgpack(std::vector<uint8_t>({0x87}), true, false).is_discarded());
CHECK(json::from_msgpack(std::vector<uint8_t>({0xcc}), true, false).is_discarded());
@@ -1524,9 +1482,7 @@
SECTION("concrete examples")
{
json _;
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xc1})), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0xc1})),
- "[json.exception.parse_error.112] parse error at byte 1: syntax error while parsing MessagePack value: invalid byte: 0xC1");
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0xc1})), "[json.exception.parse_error.112] parse error at byte 1: syntax error while parsing MessagePack value: invalid byte: 0xC1", json::parse_error&);
}
SECTION("all unsupported bytes")
@@ -1547,9 +1503,7 @@
SECTION("invalid string in map")
{
json _;
- CHECK_THROWS_AS(_ = json::from_msgpack(std::vector<uint8_t>({0x81, 0xff, 0x01})), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_msgpack(std::vector<uint8_t>({0x81, 0xff, 0x01})),
- "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing MessagePack string: expected length specification (0xA0-0xBF, 0xD9-0xDB); last byte: 0xFF");
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(std::vector<uint8_t>({0x81, 0xff, 0x01})), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing MessagePack string: expected length specification (0xA0-0xBF, 0xD9-0xDB); last byte: 0xFF", json::parse_error&);
CHECK(json::from_msgpack(std::vector<uint8_t>({0x81, 0xff, 0x01}), true, false).is_discarded());
}
@@ -1565,9 +1519,7 @@
SECTION("strict mode")
{
json _;
- CHECK_THROWS_AS(_ = json::from_msgpack(vec), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_msgpack(vec),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing MessagePack value: expected end of input; last byte: 0xC0");
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(vec), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing MessagePack value: expected end of input; last byte: 0xC0", json::parse_error&);
CHECK(json::from_msgpack(vec, true, false).is_discarded());
}
}
diff --git a/test/src/unit-noexcept.cpp b/tests/src/unit-noexcept.cpp
similarity index 68%
rename from test/src/unit-noexcept.cpp
rename to tests/src/unit-noexcept.cpp
index bc805bc..c9e941d 100644
--- a/test/src/unit-noexcept.cpp
+++ b/tests/src/unit-noexcept.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
diff --git a/tests/src/unit-ordered_json.cpp b/tests/src/unit-ordered_json.cpp
new file mode 100644
index 0000000..e6aef2c
--- /dev/null
+++ b/tests/src/unit-ordered_json.cpp
@@ -0,0 +1,72 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#include <nlohmann/json.hpp>
+using nlohmann::json;
+using nlohmann::ordered_json;
+
+
+TEST_CASE("ordered_json")
+{
+ json j;
+ ordered_json oj;
+
+ j["element3"] = 3;
+ j["element1"] = 1;
+ j["element2"] = 2;
+
+ oj["element3"] = 3;
+ oj["element1"] = 1;
+ oj["element2"] = 2;
+
+ CHECK(j.dump() == "{\"element1\":1,\"element2\":2,\"element3\":3}");
+ CHECK(oj.dump() == "{\"element3\":3,\"element1\":1,\"element2\":2}");
+
+ CHECK(j == json(oj));
+ CHECK(ordered_json(json(oj)) == ordered_json(j));
+
+ j.erase("element1");
+ oj.erase("element1");
+
+ CHECK(j.dump() == "{\"element2\":2,\"element3\":3}");
+ CHECK(oj.dump() == "{\"element3\":3,\"element2\":2}");
+
+ // remove again and nothing changes
+ j.erase("element1");
+ oj.erase("element1");
+
+ CHECK(j.dump() == "{\"element2\":2,\"element3\":3}");
+ CHECK(oj.dump() == "{\"element3\":3,\"element2\":2}");
+
+ // There are no dup keys cause constructor calls emplace...
+ json multi {{"z", 1}, {"m", 2}, {"m", 3}, {"y", 4}, {"m", 5}};
+ CHECK(multi.size() == 3);
+ CHECK(multi.dump() == "{\"m\":2,\"y\":4,\"z\":1}");
+
+ ordered_json multi_ordered {{"z", 1}, {"m", 2}, {"m", 3}, {"y", 4}, {"m", 5}};
+ CHECK(multi_ordered.size() == 3);
+ CHECK(multi_ordered.dump() == "{\"z\":1,\"m\":2,\"y\":4}");
+ CHECK(multi_ordered.erase("m") == 1);
+ CHECK(multi_ordered.dump() == "{\"z\":1,\"y\":4}");
+
+ // Ranged insert test.
+ // It seems that values shouldn't be overwritten. Only new values are added
+ json j1 {{"c", 1}, {"b", 2}, {"a", 3}};
+ const json j2 {{"c", 77}, {"d", 42}, {"a", 4}};
+ j1.insert( j2.cbegin(), j2.cend() );
+ CHECK(j1.size() == 4);
+ CHECK(j1.dump() == "{\"a\":3,\"b\":2,\"c\":1,\"d\":42}");
+
+ ordered_json oj1 {{"c", 1}, {"b", 2}, {"a", 3}};
+ const ordered_json oj2 {{"c", 77}, {"d", 42}, {"a", 4}};
+ oj1.insert( oj2.cbegin(), oj2.cend() );
+ CHECK(oj1.size() == 4);
+ CHECK(oj1.dump() == "{\"c\":1,\"b\":2,\"a\":3,\"d\":42}");
+}
diff --git a/test/src/unit-ordered_map.cpp b/tests/src/unit-ordered_map.cpp
similarity index 86%
rename from test/src/unit-ordered_map.cpp
rename to tests/src/unit-ordered_map.cpp
index 6d511f6..b35863d 100644
--- a/test/src/unit-ordered_map.cpp
+++ b/tests/src/unit-ordered_map.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
diff --git a/test/src/unit-pointer_access.cpp b/tests/src/unit-pointer_access.cpp
similarity index 93%
rename from test/src/unit-pointer_access.cpp
rename to tests/src/unit-pointer_access.cpp
index 5aa38f6..f50c64b 100644
--- a/test/src/unit-pointer_access.cpp
+++ b/tests/src/unit-pointer_access.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
diff --git a/test/src/unit-readme.cpp b/tests/src/unit-readme.cpp
similarity index 86%
rename from test/src/unit-readme.cpp
rename to tests/src/unit-readme.cpp
index 33fadae..71fffff 100644
--- a/test/src/unit-readme.cpp
+++ b/tests/src/unit-readme.cpp
@@ -1,36 +1,16 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
#include <nlohmann/json.hpp>
using nlohmann::json;
+using namespace nlohmann::literals; // NOLINT(google-build-using-namespace)
#include <deque>
#include <forward_list>
diff --git a/tests/src/unit-reference_access.cpp b/tests/src/unit-reference_access.cpp
new file mode 100644
index 0000000..fa53961
--- /dev/null
+++ b/tests/src/unit-reference_access.cpp
@@ -0,0 +1,247 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#include <nlohmann/json.hpp>
+using nlohmann::json;
+
+TEST_CASE("reference access")
+{
+ // create a JSON value with different types
+ json json_types =
+ {
+ {"boolean", true},
+ {
+ "number", {
+ {"integer", 42},
+ {"floating-point", 17.23}
+ }
+ },
+ {"string", "Hello, world!"},
+ {"array", {1, 2, 3, 4, 5}},
+ {"null", nullptr}
+ };
+
+ SECTION("reference access to object_t")
+ {
+ using test_type = json::object_t;
+ json value = {{"one", 1}, {"two", 2}};
+
+ // check if references are returned correctly
+ auto& p1 = value.get_ref<test_type&>();
+ CHECK(&p1 == value.get_ptr<test_type*>());
+ CHECK(p1 == value.get<test_type>());
+
+ const auto& p2 = value.get_ref<const test_type&>();
+ CHECK(&p2 == value.get_ptr<const test_type*>());
+ CHECK(p2 == value.get<test_type>());
+
+ // check if mismatching references throw correctly
+ CHECK_NOTHROW(value.get_ref<json::object_t&>());
+ CHECK_THROWS_WITH_AS(value.get_ref<json::array_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is object", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::string_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is object", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::boolean_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is object", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_integer_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is object", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_unsigned_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is object", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_float_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is object", json::type_error&);
+ }
+
+ SECTION("const reference access to const object_t")
+ {
+ using test_type = json::object_t;
+ const json value = {{"one", 1}, {"two", 2}};
+
+ // this should not compile
+ // test_type& p1 = value.get_ref<test_type&>();
+
+ // check if references are returned correctly
+ const auto& p2 = value.get_ref<const test_type&>();
+ CHECK(&p2 == value.get_ptr<const test_type*>());
+ CHECK(p2 == value.get<test_type>());
+ }
+
+ SECTION("reference access to array_t")
+ {
+ using test_type = json::array_t;
+ json value = {1, 2, 3, 4};
+
+ // check if references are returned correctly
+ auto& p1 = value.get_ref<test_type&>();
+ CHECK(&p1 == value.get_ptr<test_type*>());
+ CHECK(p1 == value.get<test_type>());
+
+ const auto& p2 = value.get_ref<const test_type&>();
+ CHECK(&p2 == value.get_ptr<const test_type*>());
+ CHECK(p2 == value.get<test_type>());
+
+ // check if mismatching references throw correctly
+ CHECK_THROWS_WITH_AS(value.get_ref<json::object_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is array", json::type_error&);
+ CHECK_NOTHROW(value.get_ref<json::array_t&>());
+ CHECK_THROWS_WITH_AS(value.get_ref<json::string_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is array", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::boolean_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is array", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_integer_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is array", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_unsigned_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is array", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_float_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is array", json::type_error&);
+ }
+
+ SECTION("reference access to string_t")
+ {
+ using test_type = json::string_t;
+ json value = "hello";
+
+ // check if references are returned correctly
+ auto& p1 = value.get_ref<test_type&>();
+ CHECK(&p1 == value.get_ptr<test_type*>());
+ CHECK(p1 == value.get<test_type>());
+
+ const auto& p2 = value.get_ref<const test_type&>();
+ CHECK(&p2 == value.get_ptr<const test_type*>());
+ CHECK(p2 == value.get<test_type>());
+
+ // check if mismatching references throw correctly
+ CHECK_THROWS_WITH_AS(value.get_ref<json::object_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is string", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::array_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is string", json::type_error&);
+ CHECK_NOTHROW(value.get_ref<json::string_t&>());
+ CHECK_THROWS_WITH_AS(value.get_ref<json::boolean_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is string", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_integer_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is string", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_unsigned_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is string", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_float_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is string", json::type_error&);
+ }
+
+ SECTION("reference access to boolean_t")
+ {
+ using test_type = json::boolean_t;
+ json value = false;
+
+ // check if references are returned correctly
+ auto& p1 = value.get_ref<test_type&>();
+ CHECK(&p1 == value.get_ptr<test_type*>());
+ CHECK(p1 == value.get<test_type>());
+
+ const auto& p2 = value.get_ref<const test_type&>();
+ CHECK(&p2 == value.get_ptr<const test_type*>());
+ CHECK(p2 == value.get<test_type>());
+
+ // check if mismatching references throw correctly
+ CHECK_THROWS_WITH_AS(value.get_ref<json::object_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is boolean", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::array_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is boolean", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::string_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is boolean", json::type_error&);
+ CHECK_NOTHROW(value.get_ref<json::boolean_t&>());
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_integer_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is boolean", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_unsigned_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is boolean", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_float_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is boolean", json::type_error&);
+ }
+
+ SECTION("reference access to number_integer_t")
+ {
+ using test_type = json::number_integer_t;
+ json value = -23;
+
+ // check if references are returned correctly
+ auto& p1 = value.get_ref<test_type&>();
+ CHECK(&p1 == value.get_ptr<test_type*>());
+ CHECK(p1 == value.get<test_type>());
+
+ const auto& p2 = value.get_ref<const test_type&>();
+ CHECK(&p2 == value.get_ptr<const test_type*>());
+ CHECK(p2 == value.get<test_type>());
+
+ // check if mismatching references throw correctly
+ CHECK_THROWS_WITH_AS(value.get_ref<json::object_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::array_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::string_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::boolean_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_NOTHROW(value.get_ref<json::number_integer_t&>());
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_unsigned_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_float_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ }
+
+ SECTION("reference access to number_unsigned_t")
+ {
+ using test_type = json::number_unsigned_t;
+ json value = 23u;
+
+ // check if references are returned correctly
+ auto& p1 = value.get_ref<test_type&>();
+ CHECK(&p1 == value.get_ptr<test_type*>());
+ CHECK(p1 == value.get<test_type>());
+
+ const auto& p2 = value.get_ref<const test_type&>();
+ CHECK(&p2 == value.get_ptr<const test_type*>());
+ CHECK(p2 == value.get<test_type>());
+
+ // check if mismatching references throw correctly
+ CHECK_THROWS_WITH_AS(value.get_ref<json::object_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::array_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::string_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::boolean_t&>(),
+ "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ //CHECK_THROWS_WITH_AS(value.get_ref<json::number_integer_t&>(),
+ // "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_NOTHROW(value.get_ref<json::number_unsigned_t&>());
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_float_t&>(), "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ }
+
+ SECTION("reference access to number_float_t")
+ {
+ using test_type = json::number_float_t;
+ json value = 42.23;
+
+ // check if references are returned correctly
+ auto& p1 = value.get_ref<test_type&>();
+ CHECK(&p1 == value.get_ptr<test_type*>());
+ CHECK(p1 == value.get<test_type>());
+
+ const auto& p2 = value.get_ref<const test_type&>();
+ CHECK(&p2 == value.get_ptr<const test_type*>());
+ CHECK(p2 == value.get<test_type>());
+
+ // check if mismatching references throw correctly
+ CHECK_THROWS_WITH_AS(value.get_ref<json::object_t&>(), "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::array_t&>(), "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::string_t&>(), "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::boolean_t&>(), "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_integer_t&>(), "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(value.get_ref<json::number_unsigned_t&>(), "[json.exception.type_error.303] incompatible ReferenceType for get_ref, actual type is number", json::type_error&);
+ CHECK_NOTHROW(value.get_ref<json::number_float_t&>());
+ }
+}
diff --git a/test/src/unit-regression1.cpp b/tests/src/unit-regression1.cpp
similarity index 78%
rename from test/src/unit-regression1.cpp
rename to tests/src/unit-regression1.cpp
index 8991b82..77a194d 100644
--- a/test/src/unit-regression1.cpp
+++ b/tests/src/unit-regression1.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -35,16 +14,13 @@
#define JSON_TESTS_PRIVATE
#include <nlohmann/json.hpp>
using nlohmann::json;
+using namespace nlohmann::literals; // NOLINT(google-build-using-namespace)
#include <fstream>
#include <sstream>
#include <list>
#include <cstdio>
-#include <test_data.hpp>
-
-#if (defined(__cplusplus) && __cplusplus >= 201703L) || (defined(_HAS_CXX17) && _HAS_CXX17 == 1) // fix for issue #464
- #define JSON_HAS_CPP_17
-#endif
+#include "make_test_data_available.hpp"
#ifdef JSON_HAS_CPP_17
#include <variant>
@@ -395,11 +371,10 @@
// improve coverage
o["int"] = 1;
- CHECK_THROWS_AS(s2 = o["int"], json::type_error);
#if JSON_DIAGNOSTICS
- CHECK_THROWS_WITH(s2 = o["int"], "[json.exception.type_error.302] (/int) type must be string, but is number");
+ CHECK_THROWS_WITH_AS(s2 = o["int"], "[json.exception.type_error.302] (/int) type must be string, but is number", json::type_error);
#else
- CHECK_THROWS_WITH(s2 = o["int"], "[json.exception.type_error.302] type must be string, but is number");
+ CHECK_THROWS_WITH_AS(s2 = o["int"], "[json.exception.type_error.302] type must be string, but is number", json::type_error);
#endif
}
#endif
@@ -679,9 +654,7 @@
SECTION("issue #329 - serialized value not always can be parsed")
{
json _;
- CHECK_THROWS_AS(_ = json::parse("22e2222"), json::out_of_range&);
- CHECK_THROWS_WITH(_ = json::parse("22e2222"),
- "[json.exception.out_of_range.406] number overflow parsing '22e2222'");
+ CHECK_THROWS_WITH_AS(_ = json::parse("22e2222"), "[json.exception.out_of_range.406] number overflow parsing '22e2222'", json::out_of_range&);
}
SECTION("issue #360 - Loss of precision when serializing <double>")
@@ -746,8 +719,7 @@
{
std::ifstream f("file_not_found.json");
json _;
- CHECK_THROWS_AS(_ = json::parse(f), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse(f), "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
+ CHECK_THROWS_WITH_AS(_ = json::parse(f), "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
}
SECTION("issue #367 - calling stream at EOF")
@@ -761,9 +733,7 @@
// ss is not at EOF; this yielded an error before the fix
// (threw basic_string::append). No, it should just throw
// a parse error because of the EOF.
- CHECK_THROWS_AS(ss >> j, json::parse_error&);
- CHECK_THROWS_WITH(ss >> j,
- "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
+ CHECK_THROWS_WITH_AS(ss >> j, "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
}
SECTION("issue #367 - behavior of operator>> should more closely resemble that of built-in overloads")
@@ -772,9 +742,7 @@
{
std::stringstream ss;
json j;
- CHECK_THROWS_AS(ss >> j, json::parse_error&);
- CHECK_THROWS_WITH(ss >> j,
- "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
+ CHECK_THROWS_WITH_AS(ss >> j, "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
}
SECTION("(whitespace)")
@@ -782,9 +750,8 @@
std::stringstream ss;
ss << " ";
json j;
- CHECK_THROWS_AS(ss >> j, json::parse_error&);
- CHECK_THROWS_WITH(ss >> j,
- "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
+ CHECK_THROWS_WITH_AS(ss >> j,
+ "[json.exception.parse_error.101] parse error at line 1, column 4: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
}
SECTION("one value")
@@ -795,9 +762,7 @@
CHECK_NOTHROW(ss >> j);
CHECK(j == 111);
- CHECK_THROWS_AS(ss >> j, json::parse_error&);
- CHECK_THROWS_WITH(ss >> j,
- "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
+ CHECK_THROWS_WITH_AS(ss >> j, "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
}
SECTION("one value + whitespace")
@@ -808,9 +773,8 @@
CHECK_NOTHROW(ss >> j);
CHECK(j == 222);
- CHECK_THROWS_AS(ss >> j, json::parse_error&);
- CHECK_THROWS_WITH(ss >> j,
- "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
+ CHECK_THROWS_WITH_AS(ss >> j,
+ "[json.exception.parse_error.101] parse error at line 2, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
}
SECTION("whitespace + one value")
@@ -821,9 +785,7 @@
CHECK_NOTHROW(ss >> j);
CHECK(j == 333);
- CHECK_THROWS_AS(ss >> j, json::parse_error&);
- CHECK_THROWS_WITH(ss >> j,
- "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
+ CHECK_THROWS_WITH_AS(ss >> j, "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
}
SECTION("three values")
@@ -838,9 +800,7 @@
CHECK_NOTHROW(ss >> j);
CHECK(j == 333);
- CHECK_THROWS_AS(ss >> j, json::parse_error&);
- CHECK_THROWS_WITH(ss >> j,
- "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
+ CHECK_THROWS_WITH_AS(ss >> j, "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
}
SECTION("literals without whitespace")
@@ -857,9 +817,7 @@
CHECK_NOTHROW(ss >> j);
CHECK(j == "");
- CHECK_THROWS_AS(ss >> j, json::parse_error&);
- CHECK_THROWS_WITH(ss >> j,
- "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
+ CHECK_THROWS_WITH_AS(ss >> j, "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
}
SECTION("example from #529")
@@ -872,9 +830,7 @@
CHECK_NOTHROW(ss >> j);
CHECK(j == json({{"three", 3}}));
- CHECK_THROWS_AS(ss >> j, json::parse_error&);
- CHECK_THROWS_WITH(ss >> j,
- "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal");
+ CHECK_THROWS_WITH_AS(ss >> j, "[json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - unexpected end of input; expected '[', '{', or a literal", json::parse_error&);
}
SECTION("second example from #529")
@@ -943,9 +899,7 @@
// original test case
std::vector<uint8_t> vec {0x65, 0xf5, 0x0a, 0x48, 0x21};
json _;
- CHECK_THROWS_AS(_ = json::from_cbor(vec), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec),
- "[json.exception.parse_error.110] parse error at byte 6: syntax error while parsing CBOR string: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec), "[json.exception.parse_error.110] parse error at byte 6: syntax error while parsing CBOR string: unexpected end of input", json::parse_error&);
}
SECTION("issue #407 - Heap-buffer-overflow (OSS-Fuzz issue 343)")
@@ -954,33 +908,23 @@
// original test case: incomplete float64
std::vector<uint8_t> vec1 {0xcb, 0x8f, 0x0a};
- CHECK_THROWS_AS(_ = json::from_msgpack(vec1), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_msgpack(vec1),
- "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing MessagePack number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(vec1), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
// related test case: incomplete float32
std::vector<uint8_t> vec2 {0xca, 0x8f, 0x0a};
- CHECK_THROWS_AS(_ = json::from_msgpack(vec2), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_msgpack(vec2),
- "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing MessagePack number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(vec2), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing MessagePack number: unexpected end of input", json::parse_error&);
// related test case: incomplete Half-Precision Float (CBOR)
std::vector<uint8_t> vec3 {0xf9, 0x8f};
- CHECK_THROWS_AS(_ = json::from_cbor(vec3), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec3),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec3), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
// related test case: incomplete Single-Precision Float (CBOR)
std::vector<uint8_t> vec4 {0xfa, 0x8f, 0x0a};
- CHECK_THROWS_AS(_ = json::from_cbor(vec4), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec4),
- "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing CBOR number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec4), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
// related test case: incomplete Double-Precision Float (CBOR)
std::vector<uint8_t> vec5 {0xfb, 0x8f, 0x0a};
- CHECK_THROWS_AS(_ = json::from_cbor(vec5), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec5),
- "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing CBOR number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec5), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing CBOR number: unexpected end of input", json::parse_error&);
}
SECTION("issue #408 - Heap-buffer-overflow (OSS-Fuzz issue 344)")
@@ -989,9 +933,7 @@
// original test case
std::vector<uint8_t> vec1 {0x87};
- CHECK_THROWS_AS(_ = json::from_msgpack(vec1), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_msgpack(vec1),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing MessagePack string: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(vec1), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing MessagePack string: unexpected end of input", json::parse_error&);
// more test cases for MessagePack
for (auto b :
@@ -1023,12 +965,8 @@
// special case: empty input
std::vector<uint8_t> vec2;
- CHECK_THROWS_AS(_ = json::from_cbor(vec2), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec2),
- "[json.exception.parse_error.110] parse error at byte 1: syntax error while parsing CBOR value: unexpected end of input");
- CHECK_THROWS_AS(_ = json::from_msgpack(vec2), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_msgpack(vec2),
- "[json.exception.parse_error.110] parse error at byte 1: syntax error while parsing MessagePack value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec2), "[json.exception.parse_error.110] parse error at byte 1: syntax error while parsing CBOR value: unexpected end of input", json::parse_error&);
+ CHECK_THROWS_WITH_AS(_ = json::from_msgpack(vec2), "[json.exception.parse_error.110] parse error at byte 1: syntax error while parsing MessagePack value: unexpected end of input", json::parse_error&);
}
SECTION("issue #411 - Heap-buffer-overflow (OSS-Fuzz issue 366)")
@@ -1037,21 +975,15 @@
// original test case: empty UTF-8 string (indefinite length)
std::vector<uint8_t> vec1 {0x7f};
- CHECK_THROWS_AS(_ = json::from_cbor(vec1), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec1),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR string: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec1), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR string: unexpected end of input", json::parse_error&);
// related test case: empty array (indefinite length)
std::vector<uint8_t> vec2 {0x9f};
- CHECK_THROWS_AS(_ = json::from_cbor(vec2), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec2),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec2), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR value: unexpected end of input", json::parse_error&);
// related test case: empty map (indefinite length)
std::vector<uint8_t> vec3 {0xbf};
- CHECK_THROWS_AS(_ = json::from_cbor(vec3), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec3),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR string: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec3), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing CBOR string: unexpected end of input", json::parse_error&);
}
SECTION("issue #412 - Heap-buffer-overflow (OSS-Fuzz issue 367)")
@@ -1079,27 +1011,19 @@
};
json _;
- CHECK_THROWS_AS(_ = json::from_cbor(vec), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec),
- "[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: 0x98");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec), "[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: 0x98", json::parse_error&);
// related test case: nonempty UTF-8 string (indefinite length)
std::vector<uint8_t> vec1 {0x7f, 0x61, 0x61};
- CHECK_THROWS_AS(_ = json::from_cbor(vec1), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec1),
- "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing CBOR string: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec1), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing CBOR string: unexpected end of input", json::parse_error&);
// related test case: nonempty array (indefinite length)
std::vector<uint8_t> vec2 {0x9f, 0x01};
- CHECK_THROWS_AS(_ = json::from_cbor(vec2), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec2),
- "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec2), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing CBOR value: unexpected end of input", json::parse_error&);
// related test case: nonempty map (indefinite length)
std::vector<uint8_t> vec3 {0xbf, 0x61, 0x61, 0x01};
- CHECK_THROWS_AS(_ = json::from_cbor(vec3), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec3),
- "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing CBOR string: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec3), "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing CBOR string: unexpected end of input", json::parse_error&);
}
SECTION("issue #414 - compare with literal 0)")
@@ -1134,9 +1058,7 @@
};
json _;
- CHECK_THROWS_AS(_ = json::from_cbor(vec1), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec1),
- "[json.exception.parse_error.113] parse error at byte 13: syntax error while parsing CBOR string: expected length specification (0x60-0x7B) or indefinite string type (0x7F); last byte: 0xB4");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec1), "[json.exception.parse_error.113] parse error at byte 13: syntax error while parsing CBOR string: expected length specification (0x60-0x7B) or indefinite string type (0x7F); last byte: 0xB4", json::parse_error&);
// related test case: double-precision
std::vector<uint8_t> vec2
@@ -1148,9 +1070,7 @@
0x96, 0x96, 0xb4, 0xb4, 0xfa, 0x94, 0x94, 0x61,
0x61, 0x61, 0x61, 0x61, 0x61, 0x61, 0x61, 0xfb
};
- CHECK_THROWS_AS(_ = json::from_cbor(vec2), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_cbor(vec2),
- "[json.exception.parse_error.113] parse error at byte 13: syntax error while parsing CBOR string: expected length specification (0x60-0x7B) or indefinite string type (0x7F); last byte: 0xB4");
+ CHECK_THROWS_WITH_AS(_ = json::from_cbor(vec2), "[json.exception.parse_error.113] parse error at byte 13: syntax error while parsing CBOR string: expected length specification (0x60-0x7B) or indefinite string type (0x7F); last byte: 0xB4", json::parse_error&);
}
SECTION("issue #452 - Heap-buffer-overflow (OSS-Fuzz issue 585)")
@@ -1200,10 +1120,8 @@
};
CHECK_NOTHROW(create(j_array));
- CHECK_THROWS_AS(create(j_number), json::type_error&);
- CHECK_THROWS_WITH(create(j_number), "[json.exception.type_error.302] type must be array, but is number");
- CHECK_THROWS_AS(create(j_null), json::type_error&);
- CHECK_THROWS_WITH(create(j_null), "[json.exception.type_error.302] type must be array, but is null");
+ CHECK_THROWS_WITH_AS(create(j_number), "[json.exception.type_error.302] type must be array, but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(create(j_null), "[json.exception.type_error.302] type must be array, but is null", json::type_error&);
}
SECTION("std::list")
@@ -1214,10 +1132,8 @@
};
CHECK_NOTHROW(create(j_array));
- CHECK_THROWS_AS(create(j_number), json::type_error&);
- CHECK_THROWS_WITH(create(j_number), "[json.exception.type_error.302] type must be array, but is number");
- CHECK_THROWS_AS(create(j_null), json::type_error&);
- CHECK_THROWS_WITH(create(j_null), "[json.exception.type_error.302] type must be array, but is null");
+ CHECK_THROWS_WITH_AS(create(j_number), "[json.exception.type_error.302] type must be array, but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(create(j_null), "[json.exception.type_error.302] type must be array, but is null", json::type_error&);
}
SECTION("std::forward_list")
@@ -1228,10 +1144,8 @@
};
CHECK_NOTHROW(create(j_array));
- CHECK_THROWS_AS(create(j_number), json::type_error&);
- CHECK_THROWS_WITH(create(j_number), "[json.exception.type_error.302] type must be array, but is number");
- CHECK_THROWS_AS(create(j_null), json::type_error&);
- CHECK_THROWS_WITH(create(j_null), "[json.exception.type_error.302] type must be array, but is null");
+ CHECK_THROWS_WITH_AS(create(j_number), "[json.exception.type_error.302] type must be array, but is number", json::type_error&);
+ CHECK_THROWS_WITH_AS(create(j_null), "[json.exception.type_error.302] type must be array, but is null", json::type_error&);
}
}
#endif
@@ -1380,9 +1294,7 @@
CHECK(v[i] == j[i]);
}
- CHECK_THROWS_AS(json().get<std::valarray<double>>(), json::type_error&);
- CHECK_THROWS_WITH(json().get<std::valarray<double>>(),
- "[json.exception.type_error.302] type must be array, but is null");
+ CHECK_THROWS_WITH_AS(json().get<std::valarray<double>>(), "[json.exception.type_error.302] type must be array, but is null", json::type_error&);
}
}
#endif
@@ -1452,8 +1364,7 @@
std::array<uint8_t, 28> key1 = {{ 103, 92, 117, 48, 48, 48, 55, 92, 114, 215, 126, 214, 95, 92, 34, 174, 40, 71, 38, 174, 40, 71, 38, 223, 134, 247, 127, 0 }};
std::string key1_str(reinterpret_cast<char*>(key1.data()));
json j = key1_str;
- CHECK_THROWS_AS(j.dump(), json::type_error&);
- CHECK_THROWS_WITH(j.dump(), "[json.exception.type_error.316] invalid UTF-8 byte at index 10: 0x7E");
+ CHECK_THROWS_WITH_AS(j.dump(), "[json.exception.type_error.316] invalid UTF-8 byte at index 10: 0x7E", json::type_error&);
}
#if JSON_USE_IMPLICIT_CONVERSIONS
@@ -1480,24 +1391,14 @@
auto p1 = R"([{"op": "move",
"from": "/one/two/three",
"path": "/a/b/c"}])"_json;
- CHECK_THROWS_AS(model.patch(p1), json::out_of_range&);
+ CHECK_THROWS_WITH_AS(model.patch(p1),
+ "[json.exception.out_of_range.403] key 'a' not found", json::out_of_range&);
- auto p2 = R"([{"op": "move",
+ auto p2 = R"([{"op": "copy",
"from": "/one/two/three",
"path": "/a/b/c"}])"_json;
- CHECK_THROWS_WITH(model.patch(p2),
- "[json.exception.out_of_range.403] key 'a' not found");
-
- auto p3 = R"([{"op": "copy",
- "from": "/one/two/three",
- "path": "/a/b/c"}])"_json;
- CHECK_THROWS_AS(model.patch(p3), json::out_of_range&);
-
- auto p4 = R"([{"op": "copy",
- "from": "/one/two/three",
- "path": "/a/b/c"}])"_json;
- CHECK_THROWS_WITH(model.patch(p4),
- "[json.exception.out_of_range.403] key 'a' not found");
+ CHECK_THROWS_WITH_AS(model.patch(p2),
+ "[json.exception.out_of_range.403] key 'a' not found", json::out_of_range&);
}
SECTION("issue #961 - incorrect parsing of indefinite length CBOR strings")
@@ -1599,7 +1500,7 @@
/////////////////////////////////////////////////////////////////////
// the code below fails with Clang on Windows, so we need to exclude it there
-#if defined(__clang__) && (defined(WIN32) || defined(_WIN32) || defined(__WIN32) && !defined(__CYGWIN__))
+#if DOCTEST_CLANG && (defined(WIN32) || defined(_WIN32) || defined(__WIN32) && !defined(__CYGWIN__))
#else
template <typename T> class array {};
template <typename T> class object {};
diff --git a/test/src/unit-regression2.cpp b/tests/src/unit-regression2.cpp
similarity index 78%
rename from test/src/unit-regression2.cpp
rename to tests/src/unit-regression2.cpp
index 52db358..5ba3d31 100644
--- a/test/src/unit-regression2.cpp
+++ b/tests/src/unit-regression2.cpp
@@ -1,31 +1,17 @@
-/*
- __ _____ _____ _____
- __| | __| | | | JSON for Modern C++ (test suite)
-| | |__ | | | | | | version 3.10.5
-|_____|_____|_____|_|___| https://github.com/nlohmann/json
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
-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.
-*/
+// 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"
@@ -36,93 +22,18 @@
#include <nlohmann/json.hpp>
using json = nlohmann::json;
using ordered_json = nlohmann::ordered_json;
+using namespace nlohmann::literals; // NOLINT(google-build-using-namespace)
#include <cstdio>
#include <list>
#include <type_traits>
#include <utility>
-#if (defined(__cplusplus) && __cplusplus >= 201703L) || (defined(_HAS_CXX17) && _HAS_CXX17 == 1) // fix for issue #464
- #define JSON_HAS_CPP_17
-#endif
-
#ifdef JSON_HAS_CPP_17
+ #include <any>
#include <variant>
-
- #if !defined(JSON_HAS_FILESYSTEM) && !defined(JSON_HAS_EXPERIMENTAL_FILESYSTEM)
- #if defined(__cpp_lib_filesystem)
- #define JSON_HAS_FILESYSTEM 1
- #elif defined(__cpp_lib_experimental_filesystem)
- #define JSON_HAS_EXPERIMENTAL_FILESYSTEM 1
- #elif !defined(__has_include)
- #define JSON_HAS_EXPERIMENTAL_FILESYSTEM 1
- #elif __has_include(<filesystem>)
- #define JSON_HAS_FILESYSTEM 1
- #elif __has_include(<experimental/filesystem>)
- #define JSON_HAS_EXPERIMENTAL_FILESYSTEM 1
- #endif
-
- // std::filesystem does not work on MinGW GCC 8: https://sourceforge.net/p/mingw-w64/bugs/737/
- #if defined(__MINGW32__) && defined(__GNUC__) && __GNUC__ == 8
- #undef JSON_HAS_FILESYSTEM
- #undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
- #endif
-
- // no filesystem support before GCC 8: https://en.cppreference.com/w/cpp/compiler_support
- #if defined(__GNUC__) && __GNUC__ < 8 && !defined(__clang__)
- #undef JSON_HAS_FILESYSTEM
- #undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
- #endif
-
- // no filesystem support before Clang 7: https://en.cppreference.com/w/cpp/compiler_support
- #if defined(__clang_major__) && __clang_major__ < 7
- #undef JSON_HAS_FILESYSTEM
- #undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
- #endif
-
- // no filesystem support before MSVC 19.14: https://en.cppreference.com/w/cpp/compiler_support
- #if defined(_MSC_VER) && _MSC_VER < 1940
- #undef JSON_HAS_FILESYSTEM
- #undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
- #endif
-
- // no filesystem support before iOS 13
- #if defined(__IPHONE_OS_VERSION_MIN_REQUIRED) && __IPHONE_OS_VERSION_MIN_REQUIRED < 130000
- #undef JSON_HAS_FILESYSTEM
- #undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
- #endif
-
- // no filesystem support before macOS Catalina
- #if defined(__MAC_OS_X_VERSION_MIN_REQUIRED) && __MAC_OS_X_VERSION_MIN_REQUIRED < 101500
- #undef JSON_HAS_FILESYSTEM
- #undef JSON_HAS_EXPERIMENTAL_FILESYSTEM
- #endif
- #endif
#endif
-#ifndef JSON_HAS_EXPERIMENTAL_FILESYSTEM
- #define JSON_HAS_EXPERIMENTAL_FILESYSTEM 0
-#endif
-
-#ifndef JSON_HAS_FILESYSTEM
- #define JSON_HAS_FILESYSTEM 0
-#endif
-
-#if JSON_HAS_EXPERIMENTAL_FILESYSTEM
-#include <experimental/filesystem>
-namespace nlohmann::detail
-{
-namespace std_fs = std::experimental::filesystem;
-} // namespace nlohmann::detail
-#elif JSON_HAS_FILESYSTEM
-#include <filesystem>
-namespace nlohmann::detail
-{
-namespace std_fs = std::filesystem;
-} // namespace nlohmann::detail
-#endif
-
-
#ifdef JSON_HAS_CPP_20
#include <span>
#endif
@@ -271,7 +182,10 @@
template<class T>
class my_allocator : public std::allocator<T>
-{};
+{
+ public:
+ using std::allocator<T>::allocator;
+};
/////////////////////////////////////////////////////////////////////
// for #3077
@@ -299,6 +213,100 @@
j.at("value").get_to(fb.foo.value);
}
+/////////////////////////////////////////////////////////////////////
+// for #3171
+/////////////////////////////////////////////////////////////////////
+
+struct for_3171_base // NOLINT(cppcoreguidelines-special-member-functions)
+{
+ for_3171_base(const std::string& /*unused*/ = {}) {}
+ virtual ~for_3171_base() = default;
+
+ virtual void _from_json(const json& j)
+ {
+ j.at("str").get_to(str);
+ }
+
+ std::string str{};
+};
+
+struct for_3171_derived : public for_3171_base
+{
+ for_3171_derived() = default;
+ explicit for_3171_derived(const std::string& /*unused*/) { }
+};
+
+inline void from_json(const json& j, for_3171_base& tb)
+{
+ tb._from_json(j);
+}
+
+/////////////////////////////////////////////////////////////////////
+// for #3312
+/////////////////////////////////////////////////////////////////////
+
+#ifdef JSON_HAS_CPP_20
+struct for_3312
+{
+ std::string name;
+};
+
+inline void from_json(const json& j, for_3312& obj)
+{
+ j.at("name").get_to(obj.name);
+}
+#endif
+
+/////////////////////////////////////////////////////////////////////
+// for #3204
+/////////////////////////////////////////////////////////////////////
+
+struct for_3204_foo
+{
+ for_3204_foo() = default;
+ explicit for_3204_foo(std::string /*unused*/) {} // NOLINT(performance-unnecessary-value-param)
+};
+
+struct for_3204_bar
+{
+ enum constructed_from_t
+ {
+ constructed_from_none = 0,
+ constructed_from_foo = 1,
+ constructed_from_json = 2
+ };
+
+ explicit for_3204_bar(std::function<void(for_3204_foo)> /*unused*/) noexcept // NOLINT(performance-unnecessary-value-param)
+ : constructed_from(constructed_from_foo) {}
+ explicit for_3204_bar(std::function<void(json)> /*unused*/) noexcept // NOLINT(performance-unnecessary-value-param)
+ : constructed_from(constructed_from_json) {}
+
+ constructed_from_t constructed_from = constructed_from_none;
+};
+
+/////////////////////////////////////////////////////////////////////
+// for #3333
+/////////////////////////////////////////////////////////////////////
+
+struct for_3333 final
+{
+ for_3333(int x_ = 0, int y_ = 0) : x(x_), y(y_) {}
+
+ template <class T>
+ for_3333(const T& /*unused*/)
+ {
+ CHECK(false);
+ }
+
+ int x = 0;
+ int y = 0;
+};
+
+template <>
+inline for_3333::for_3333(const json& j)
+ : for_3333(j.value("x", 0), j.value("y", 0))
+{}
+
TEST_CASE("regression tests 2")
{
SECTION("issue #1001 - Fix memory leak during parser callback")
@@ -338,7 +346,7 @@
]
})";
- json::parser_callback_t cb = [&](int /*level*/, json::parse_event_t event, json & parsed)
+ json::parser_callback_t cb = [&](int /*level*/, json::parse_event_t event, json & parsed) noexcept
{
// skip uninteresting events
if (event == json::parse_event_t::value && !parsed.is_primitive())
@@ -526,12 +534,15 @@
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);
@@ -653,7 +664,7 @@
#ifdef JSON_HAS_CPP_20
SECTION("issue #2546 - parsing containers of std::byte")
{
- const char DATA[] = R"("Hello, world!")";
+ const char DATA[] = R"("Hello, world!")"; // NOLINT(cppcoreguidelines-avoid-c-arrays,hicpp-avoid-c-arrays,modernize-avoid-c-arrays)
const auto s = std::as_bytes(std::span(DATA));
json j = json::parse(s);
CHECK(j.dump() == "\"Hello, world!\"");
@@ -774,7 +785,6 @@
{
std::string p = "/root";
- // matching types
json test1;
test1[json::json_pointer(p)] = json::object();
CHECK(test1.dump() == "{\"root\":{}}");
@@ -783,10 +793,11 @@
test2[ordered_json::json_pointer(p)] = json::object();
CHECK(test2.dump() == "{\"root\":{}}");
- // mixed type - the JSON Pointer is implicitly converted into a string "/root"
+ // json::json_pointer and ordered_json::json_pointer are the same type; behave as above
ordered_json test3;
test3[json::json_pointer(p)] = json::object();
- CHECK(test3.dump() == "{\"/root\":{}}");
+ CHECK(std::is_same<json::json_pointer::string_t, ordered_json::json_pointer::string_t>::value);
+ CHECK(test3.dump() == "{\"root\":{}}");
}
SECTION("issue #2982 - to_{binary format} does not provide a mechanism for specifying a custom allocator for the returned type")
@@ -799,6 +810,7 @@
}
#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");
@@ -807,7 +819,10 @@
const auto j_path = j.get<nlohmann::detail::std_fs::path>();
CHECK(j_path == text_path);
+#if DOCTEST_CLANG || DOCTEST_GCC >= DOCTEST_COMPILER(8, 4, 0)
+ // 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
}
#endif
@@ -835,6 +850,77 @@
CHECK(j.dump() == "[1,4]");
}
+
+ SECTION("issue #3343 - json and ordered_json are not interchangable")
+ {
+ json::object_t jobj({ { "product", "one" } });
+ ordered_json::object_t ojobj({{"product", "one"}});
+
+ auto jit = jobj.begin();
+ auto ojit = ojobj.begin();
+
+ CHECK(jit->first == ojit->first);
+ CHECK(jit->second.get<std::string>() == ojit->second.get<std::string>());
+ }
+
+ SECTION("issue #3171 - if class is_constructible from std::string wrong from_json overload is being selected, compilation failed")
+ {
+ json j{{ "str", "value"}};
+
+ // failed with: error: no match for ‘operator=’ (operand types are ‘for_3171_derived’ and ‘const nlohmann::basic_json<>::string_t’
+ // {aka ‘const std::__cxx11::basic_string<char>’})
+ // s = *j.template get_ptr<const typename BasicJsonType::string_t*>();
+ auto td = j.get<for_3171_derived>();
+
+ CHECK(td.str == "value");
+ }
+
+#ifdef JSON_HAS_CPP_20
+ SECTION("issue #3312 - Parse to custom class from unordered_json breaks on G++11.2.0 with C++20")
+ {
+ // see test for #3171
+ ordered_json j = {{"name", "class"}};
+ for_3312 obj{};
+
+ j.get_to(obj);
+
+ CHECK(obj.name == "class");
+ }
+#endif
+
+#if defined(JSON_HAS_CPP_17) && JSON_USE_IMPLICIT_CONVERSIONS
+ SECTION("issue #3428 - Error occurred when converting nlohmann::json to std::any")
+ {
+ json j;
+ std::any a1 = j;
+ std::any&& a2 = j;
+
+ CHECK(a1.type() == typeid(j));
+ CHECK(a2.type() == typeid(j));
+ }
+#endif
+
+ SECTION("issue #3204 - ambiguous regression")
+ {
+ for_3204_bar bar_from_foo([](for_3204_foo) noexcept {}); // NOLINT(performance-unnecessary-value-param)
+ for_3204_bar bar_from_json([](json) noexcept {}); // NOLINT(performance-unnecessary-value-param)
+
+ CHECK(bar_from_foo.constructed_from == for_3204_bar::constructed_from_foo);
+ CHECK(bar_from_json.constructed_from == for_3204_bar::constructed_from_json);
+ }
+
+ SECTION("issue #3333 - Ambiguous conversion from nlohmann::basic_json<> to custom class")
+ {
+ const json j
+ {
+ {"x", 1},
+ {"y", 2}
+ };
+ for_3333 p = j;
+
+ CHECK(p.x == 1);
+ CHECK(p.y == 2);
+ }
}
DOCTEST_CLANG_SUPPRESS_WARNING_POP
diff --git a/test/src/unit-serialization.cpp b/tests/src/unit-serialization.cpp
similarity index 82%
rename from test/src/unit-serialization.cpp
rename to tests/src/unit-serialization.cpp
index b07c349..6ffe39a 100644
--- a/test/src/unit-serialization.cpp
+++ b/tests/src/unit-serialization.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -104,10 +83,8 @@
{
json j = "ä\xA9ü";
- CHECK_THROWS_AS(j.dump(), json::type_error&);
- CHECK_THROWS_WITH(j.dump(), "[json.exception.type_error.316] invalid UTF-8 byte at index 2: 0xA9");
- CHECK_THROWS_AS(j.dump(1, ' ', false, json::error_handler_t::strict), json::type_error&);
- CHECK_THROWS_WITH(j.dump(1, ' ', false, json::error_handler_t::strict), "[json.exception.type_error.316] invalid UTF-8 byte at index 2: 0xA9");
+ CHECK_THROWS_WITH_AS(j.dump(), "[json.exception.type_error.316] invalid UTF-8 byte at index 2: 0xA9", json::type_error&);
+ CHECK_THROWS_WITH_AS(j.dump(1, ' ', false, json::error_handler_t::strict), "[json.exception.type_error.316] invalid UTF-8 byte at index 2: 0xA9", json::type_error&);
CHECK(j.dump(-1, ' ', false, json::error_handler_t::ignore) == "\"äü\"");
CHECK(j.dump(-1, ' ', false, json::error_handler_t::replace) == "\"ä\xEF\xBF\xBDü\"");
CHECK(j.dump(-1, ' ', true, json::error_handler_t::replace) == "\"\\u00e4\\ufffd\\u00fc\"");
@@ -117,8 +94,7 @@
{
json j = "123\xC2";
- CHECK_THROWS_AS(j.dump(), json::type_error&);
- CHECK_THROWS_WITH(j.dump(), "[json.exception.type_error.316] incomplete UTF-8 string; last byte: 0xC2");
+ CHECK_THROWS_WITH_AS(j.dump(), "[json.exception.type_error.316] incomplete UTF-8 string; last byte: 0xC2", json::type_error&);
CHECK_THROWS_AS(j.dump(1, ' ', false, json::error_handler_t::strict), json::type_error&);
CHECK(j.dump(-1, ' ', false, json::error_handler_t::ignore) == "\"123\"");
CHECK(j.dump(-1, ' ', false, json::error_handler_t::replace) == "\"123\xEF\xBF\xBD\"");
@@ -129,8 +105,7 @@
{
json j = "123\xF1\xB0\x34\x35\x36";
- CHECK_THROWS_AS(j.dump(), json::type_error&);
- CHECK_THROWS_WITH(j.dump(), "[json.exception.type_error.316] invalid UTF-8 byte at index 5: 0x34");
+ CHECK_THROWS_WITH_AS(j.dump(), "[json.exception.type_error.316] invalid UTF-8 byte at index 5: 0x34", json::type_error&);
CHECK_THROWS_AS(j.dump(1, ' ', false, json::error_handler_t::strict), json::type_error&);
CHECK(j.dump(-1, ' ', false, json::error_handler_t::ignore) == "\"123456\"");
CHECK(j.dump(-1, ' ', false, json::error_handler_t::replace) == "\"123\xEF\xBF\xBD\x34\x35\x36\"");
diff --git a/test/src/unit-testsuites.cpp b/tests/src/unit-testsuites.cpp
similarity index 98%
rename from test/src/unit-testsuites.cpp
rename to tests/src/unit-testsuites.cpp
index 7fbf831..d5e4074 100644
--- a/test/src/unit-testsuites.cpp
+++ b/tests/src/unit-testsuites.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -33,7 +12,7 @@
using nlohmann::json;
#include <fstream>
-#include <test_data.hpp>
+#include "make_test_data_available.hpp"
TEST_CASE("compliance tests from json.org")
{
diff --git a/test/src/unit-to_chars.cpp b/tests/src/unit-to_chars.cpp
similarity index 95%
rename from test/src/unit-to_chars.cpp
rename to tests/src/unit-to_chars.cpp
index 09bdc86..83c1360 100644
--- a/test/src/unit-to_chars.cpp
+++ b/tests/src/unit-to_chars.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
// XXX:
// Only compile these tests if 'float' and 'double' are IEEE-754 single- and
diff --git a/test/src/unit-ubjson.cpp b/tests/src/unit-ubjson.cpp
similarity index 91%
rename from test/src/unit-ubjson.cpp
rename to tests/src/unit-ubjson.cpp
index 84568f8..dcdcede 100644
--- a/test/src/unit-ubjson.cpp
+++ b/tests/src/unit-ubjson.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -35,7 +14,7 @@
#include <iostream>
#include <fstream>
#include <set>
-#include <test_data.hpp>
+#include "make_test_data_available.hpp"
#include "test_utils.hpp"
namespace
@@ -1595,9 +1574,7 @@
SECTION("strict mode")
{
json _;
- CHECK_THROWS_AS(_ = json::from_ubjson(vec), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vec),
- "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing UBJSON value: expected end of input; last byte: 0x5A");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vec), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing UBJSON value: expected end of input; last byte: 0x5A", json::parse_error&);
}
}
@@ -1610,7 +1587,7 @@
CHECK_THROWS_AS(_ = json::from_ubjson(v_ubjson), json::out_of_range&);
json j;
- nlohmann::detail::json_sax_dom_callback_parser<json> scp(j, [](int /*unused*/, json::parse_event_t /*unused*/, const json& /*unused*/)
+ nlohmann::detail::json_sax_dom_callback_parser<json> scp(j, [](int /*unused*/, json::parse_event_t /*unused*/, const json& /*unused*/) noexcept
{
return true;
});
@@ -1624,7 +1601,7 @@
CHECK_THROWS_AS(_ = json::from_ubjson(v_ubjson), json::out_of_range&);
json j;
- nlohmann::detail::json_sax_dom_callback_parser<json> scp(j, [](int /*unused*/, json::parse_event_t /*unused*/, const json& /*unused*/)
+ nlohmann::detail::json_sax_dom_callback_parser<json> scp(j, [](int /*unused*/, json::parse_event_t /*unused*/, const json& /*unused*/) noexcept
{
return true;
});
@@ -1820,9 +1797,7 @@
SECTION("empty byte vector")
{
json _;
- CHECK_THROWS_AS(_ = json::from_ubjson(std::vector<uint8_t>()), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(std::vector<uint8_t>()),
- "[json.exception.parse_error.110] parse error at byte 1: syntax error while parsing UBJSON value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(std::vector<uint8_t>()), "[json.exception.parse_error.110] parse error at byte 1: syntax error while parsing UBJSON value: unexpected end of input", json::parse_error&);
}
SECTION("char")
@@ -1831,16 +1806,14 @@
{
std::vector<uint8_t> v = {'C'};
json _;
- CHECK_THROWS_AS(_ = json::from_ubjson(v), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(v), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing UBJSON char: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(v), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing UBJSON 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_ubjson(v), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(v), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing UBJSON char: byte after 'C' must be in range 0x00..0x7F; last byte: 0x82");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(v), "[json.exception.parse_error.113] parse error at byte 2: syntax error while parsing UBJSON char: byte after 'C' must be in range 0x00..0x7F; last byte: 0x82", json::parse_error&);
}
}
@@ -1850,16 +1823,14 @@
{
std::vector<uint8_t> v = {'S'};
json _;
- CHECK_THROWS_AS(_ = json::from_ubjson(v), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(v), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing UBJSON value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(v), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing UBJSON 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_ubjson(v), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(v), "[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: 0x31");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(v), "[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: 0x31", json::parse_error&);
}
}
@@ -1869,8 +1840,7 @@
{
std::vector<uint8_t> v = {'[', '$', 'i', 2};
json _;
- CHECK_THROWS_AS(_ = json::from_ubjson(v), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(v), "[json.exception.parse_error.112] parse error at byte 4: syntax error while parsing UBJSON size: expected '#' after type information; last byte: 0x02");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(v), "[json.exception.parse_error.112] parse error at byte 4: syntax error while parsing UBJSON size: expected '#' after type information; last byte: 0x02", json::parse_error&);
}
}
@@ -1878,18 +1848,15 @@
{
std::vector<uint8_t> vS = {'S'};
json _;
- CHECK_THROWS_AS(_ = json::from_ubjson(vS), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vS), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing UBJSON value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vS), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing UBJSON value: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vS, true, false).is_discarded());
std::vector<uint8_t> v = {'S', 'i', '2', 'a'};
- CHECK_THROWS_AS(_ = json::from_ubjson(v), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(v), "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing UBJSON string: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(v), "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing UBJSON string: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(v, true, false).is_discarded());
std::vector<uint8_t> vC = {'C'};
- CHECK_THROWS_AS(_ = json::from_ubjson(vC), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vC), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing UBJSON char: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vC), "[json.exception.parse_error.110] parse error at byte 2: syntax error while parsing UBJSON char: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vC, true, false).is_discarded());
}
@@ -1897,33 +1864,27 @@
{
std::vector<uint8_t> vU = {'[', '#', 'U'};
json _;
- CHECK_THROWS_AS(_ = json::from_ubjson(vU), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vU), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing UBJSON number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vU), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing UBJSON number: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vU, true, false).is_discarded());
std::vector<uint8_t> vi = {'[', '#', 'i'};
- CHECK_THROWS_AS(_ = json::from_ubjson(vi), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vi), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing UBJSON number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vi), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing UBJSON number: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vi, true, false).is_discarded());
std::vector<uint8_t> vI = {'[', '#', 'I'};
- CHECK_THROWS_AS(_ = json::from_ubjson(vI), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vI), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing UBJSON number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vI), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing UBJSON number: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vI, true, false).is_discarded());
std::vector<uint8_t> vl = {'[', '#', 'l'};
- CHECK_THROWS_AS(_ = json::from_ubjson(vl), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vl), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing UBJSON number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vl), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing UBJSON number: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vl, true, false).is_discarded());
std::vector<uint8_t> vL = {'[', '#', 'L'};
- CHECK_THROWS_AS(_ = json::from_ubjson(vL), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vL), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing UBJSON number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vL), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing UBJSON number: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vL, true, false).is_discarded());
std::vector<uint8_t> v0 = {'[', '#', 'T', ']'};
- 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: 0x54");
+ 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: 0x54", json::parse_error&);
CHECK(json::from_ubjson(v0, true, false).is_discarded());
}
@@ -1931,18 +1892,15 @@
{
std::vector<uint8_t> v0 = {'[', '$'};
json _;
- CHECK_THROWS_AS(_ = json::from_ubjson(v0), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(v0), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing UBJSON type: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(v0), "[json.exception.parse_error.110] parse error at byte 3: syntax error while parsing UBJSON type: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(v0, true, false).is_discarded());
std::vector<uint8_t> vi = {'[', '$', '#'};
- CHECK_THROWS_AS(_ = json::from_ubjson(vi), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vi), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing UBJSON value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vi), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing UBJSON value: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vi, true, false).is_discarded());
std::vector<uint8_t> vT = {'[', '$', 'T'};
- CHECK_THROWS_AS(_ = json::from_ubjson(vT), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vT), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing UBJSON value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vT), "[json.exception.parse_error.110] parse error at byte 4: syntax error while parsing UBJSON value: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vT, true, false).is_discarded());
}
@@ -1950,18 +1908,15 @@
{
std::vector<uint8_t> vST = {'[', '$', 'i', '#', 'i', 2, 1};
json _;
- CHECK_THROWS_AS(_ = json::from_ubjson(vST), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vST), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing UBJSON number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vST), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing UBJSON number: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vST, true, false).is_discarded());
std::vector<uint8_t> vS = {'[', '#', 'i', 2, 'i', 1};
- CHECK_THROWS_AS(_ = json::from_ubjson(vS), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vS), "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing UBJSON value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vS), "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing UBJSON value: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vS, true, false).is_discarded());
std::vector<uint8_t> v = {'[', 'i', 2, 'i', 1};
- CHECK_THROWS_AS(_ = json::from_ubjson(v), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(v), "[json.exception.parse_error.110] parse error at byte 6: syntax error while parsing UBJSON value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(v), "[json.exception.parse_error.110] parse error at byte 6: syntax error while parsing UBJSON value: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(v, true, false).is_discarded());
}
@@ -1969,43 +1924,35 @@
{
std::vector<uint8_t> vST = {'{', '$', 'i', '#', 'i', 2, 'i', 1, 'a', 1};
json _;
- CHECK_THROWS_AS(_ = json::from_ubjson(vST), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vST), "[json.exception.parse_error.110] parse error at byte 11: syntax error while parsing UBJSON value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vST), "[json.exception.parse_error.110] parse error at byte 11: syntax error while parsing UBJSON value: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vST, true, false).is_discarded());
std::vector<uint8_t> vT = {'{', '$', 'i', 'i', 1, 'a', 1};
- CHECK_THROWS_AS(_ = json::from_ubjson(vT), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vT), "[json.exception.parse_error.112] parse error at byte 4: syntax error while parsing UBJSON size: expected '#' after type information; last byte: 0x69");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vT), "[json.exception.parse_error.112] parse error at byte 4: syntax error while parsing UBJSON size: expected '#' after type information; last byte: 0x69", json::parse_error&);
CHECK(json::from_ubjson(vT, true, false).is_discarded());
std::vector<uint8_t> vS = {'{', '#', 'i', 2, 'i', 1, 'a', 'i', 1};
- CHECK_THROWS_AS(_ = json::from_ubjson(vS), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vS), "[json.exception.parse_error.110] parse error at byte 10: syntax error while parsing UBJSON value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vS), "[json.exception.parse_error.110] parse error at byte 10: syntax error while parsing UBJSON value: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vS, true, false).is_discarded());
std::vector<uint8_t> v = {'{', 'i', 1, 'a', 'i', 1};
- CHECK_THROWS_AS(_ = json::from_ubjson(v), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(v), "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing UBJSON value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(v), "[json.exception.parse_error.110] parse error at byte 7: syntax error while parsing UBJSON value: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(v, true, false).is_discarded());
std::vector<uint8_t> v2 = {'{', 'i', 1, 'a', 'i', 1, 'i'};
- CHECK_THROWS_AS(_ = json::from_ubjson(v2), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(v2), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing UBJSON number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(v2), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing UBJSON number: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(v2, true, false).is_discarded());
std::vector<uint8_t> v3 = {'{', 'i', 1, 'a'};
- CHECK_THROWS_AS(_ = json::from_ubjson(v3), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(v3), "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing UBJSON value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(v3), "[json.exception.parse_error.110] parse error at byte 5: syntax error while parsing UBJSON value: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(v3, true, false).is_discarded());
std::vector<uint8_t> vST1 = {'{', '$', 'd', '#', 'i', 2, 'i', 1, 'a'};
- CHECK_THROWS_AS(_ = json::from_ubjson(vST1), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vST1), "[json.exception.parse_error.110] parse error at byte 10: syntax error while parsing UBJSON number: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vST1), "[json.exception.parse_error.110] parse error at byte 10: syntax error while parsing UBJSON number: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vST1, true, false).is_discarded());
std::vector<uint8_t> vST2 = {'{', '#', 'i', 2, 'i', 1, 'a'};
- CHECK_THROWS_AS(_ = json::from_ubjson(vST2), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::from_ubjson(vST2), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing UBJSON value: unexpected end of input");
+ CHECK_THROWS_WITH_AS(_ = json::from_ubjson(vST2), "[json.exception.parse_error.110] parse error at byte 8: syntax error while parsing UBJSON value: unexpected end of input", json::parse_error&);
CHECK(json::from_ubjson(vST2, true, false).is_discarded());
}
}
diff --git a/tests/src/unit-udl.cpp b/tests/src/unit-udl.cpp
new file mode 100644
index 0000000..19d901f
--- /dev/null
+++ b/tests/src/unit-udl.cpp
@@ -0,0 +1,51 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#undef JSON_USE_GLOBAL_UDLS
+#define JSON_USE_GLOBAL_UDLS 0
+#include <nlohmann/json.hpp>
+
+TEST_CASE("user-defined string literals")
+{
+ auto j_expected = nlohmann::json::parse(R"({"foo": "bar", "baz": 42})");
+ auto ptr_expected = nlohmann::json::json_pointer("/foo/bar");
+
+ SECTION("using namespace nlohmann::literals::json_literals")
+ {
+ using namespace nlohmann::literals::json_literals; // NOLINT(google-build-using-namespace)
+
+ CHECK(R"({"foo": "bar", "baz": 42})"_json == j_expected);
+ CHECK("/foo/bar"_json_pointer == ptr_expected);
+ }
+
+ SECTION("using namespace nlohmann::json_literals")
+ {
+ using namespace nlohmann::json_literals; // NOLINT(google-build-using-namespace)
+
+ CHECK(R"({"foo": "bar", "baz": 42})"_json == j_expected);
+ CHECK("/foo/bar"_json_pointer == ptr_expected);
+ }
+
+ SECTION("using namespace nlohmann::literals")
+ {
+ using namespace nlohmann::literals; // NOLINT(google-build-using-namespace)
+
+ CHECK(R"({"foo": "bar", "baz": 42})"_json == j_expected);
+ CHECK("/foo/bar"_json_pointer == ptr_expected);
+ }
+
+ SECTION("using namespace nlohmann")
+ {
+ using namespace nlohmann; // NOLINT(google-build-using-namespace)
+
+ CHECK(R"({"foo": "bar", "baz": 42})"_json == j_expected);
+ CHECK("/foo/bar"_json_pointer == ptr_expected);
+ }
+}
diff --git a/test/src/unit-udt.cpp b/tests/src/unit-udt.cpp
similarity index 93%
rename from test/src/unit-udt.cpp
rename to tests/src/unit-udt.cpp
index 0bc3241..7952442 100644
--- a/test/src/unit-udt.cpp
+++ b/tests/src/unit-udt.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -35,11 +14,11 @@
#include <nlohmann/json.hpp>
using nlohmann::json;
+using namespace nlohmann::literals; // NOLINT(google-build-using-namespace)
#include <map>
#include <memory>
#include <string>
-#include <memory>
#include <utility>
namespace udt
diff --git a/test/src/unit-udt_macro.cpp b/tests/src/unit-udt_macro.cpp
similarity index 72%
rename from test/src/unit-udt_macro.cpp
rename to tests/src/unit-udt_macro.cpp
index 5aef227..daae579 100644
--- a/test/src/unit-udt_macro.cpp
+++ b/tests/src/unit-udt_macro.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include <string>
#include <vector>
@@ -59,6 +38,42 @@
NLOHMANN_DEFINE_TYPE_INTRUSIVE(person_with_private_data, age, name, metadata)
};
+class person_with_private_data_2
+{
+ private:
+ std::string name{};
+ int age = 0;
+ json metadata = nullptr;
+
+ public:
+ bool operator==(const person_with_private_data_2& rhs) const
+ {
+ return name == rhs.name && age == rhs.age && metadata == rhs.metadata;
+ }
+
+ person_with_private_data_2() = default;
+ person_with_private_data_2(std::string name_, int age_, json metadata_)
+ : name(std::move(name_))
+ , age(age_)
+ , metadata(std::move(metadata_))
+ {}
+
+ std::string getName() const
+ {
+ return name;
+ }
+ int getAge() const
+ {
+ return age;
+ }
+ json getMetadata() const
+ {
+ return metadata;
+ }
+
+ NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT(person_with_private_data_2, age, name, metadata)
+};
+
class person_without_private_data_1
{
public:
@@ -103,6 +118,41 @@
NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(person_without_private_data_2, age, name, metadata)
+class person_without_private_data_3
+{
+ public:
+ std::string name{};
+ int age = 0;
+ json metadata = nullptr;
+
+ bool operator==(const person_without_private_data_3& rhs) const
+ {
+ return name == rhs.name && age == rhs.age && metadata == rhs.metadata;
+ }
+
+ person_without_private_data_3() = default;
+ person_without_private_data_3(std::string name_, int age_, json metadata_)
+ : name(std::move(name_))
+ , age(age_)
+ , metadata(std::move(metadata_))
+ {}
+
+ std::string getName() const
+ {
+ return name;
+ }
+ int getAge() const
+ {
+ return age;
+ }
+ json getMetadata() const
+ {
+ return metadata;
+ }
+};
+
+NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT(person_without_private_data_3, age, name, metadata)
+
class person_with_private_alphabet
{
public:
@@ -231,7 +281,7 @@
} // namespace persons
-TEST_CASE_TEMPLATE("Serialization/deserialization via NLOHMANN_DEFINE_TYPE_INTRUSIVE", T,
+TEST_CASE_TEMPLATE("Serialization/deserialization via NLOHMANN_DEFINE_TYPE_INTRUSIVE and NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE", T,
persons::person_with_private_data,
persons::person_without_private_data_1,
persons::person_without_private_data_2)
@@ -257,6 +307,40 @@
}
}
+TEST_CASE_TEMPLATE("Serialization/deserialization via NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT and NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE_WITH_DEFAULT", T,
+ persons::person_with_private_data_2,
+ persons::person_without_private_data_3)
+{
+ SECTION("person with default values")
+ {
+ // serialization of default constructed object
+ T p0;
+ CHECK(json(p0).dump() == "{\"age\":0,\"metadata\":null,\"name\":\"\"}");
+
+ // serialization
+ T p1("Erik", 1, {{"haircuts", 2}});
+ CHECK(json(p1).dump() == "{\"age\":1,\"metadata\":{\"haircuts\":2},\"name\":\"Erik\"}");
+
+ // deserialization
+ auto p2 = json(p1).get<T>();
+ CHECK(p2 == p1);
+
+ // roundtrip
+ CHECK(T(json(p1)) == p1);
+ CHECK(json(T(json(p1))) == json(p1));
+
+ // check default value in case of missing field
+ json j = json(p1);
+ j.erase("name");
+ j.erase("age");
+ j.erase("metadata");
+ T p3 = j.get<T>();
+ CHECK(p3.getName() == "");
+ CHECK(p3.getAge() == 0);
+ CHECK(p3.getMetadata() == nullptr);
+ }
+}
+
TEST_CASE_TEMPLATE("Serialization/deserialization of classes with 26 public/private member variables via NLOHMANN_DEFINE_TYPE_INTRUSIVE and NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE", T,
persons::person_with_private_alphabet,
persons::person_with_public_alphabet)
diff --git a/test/src/unit-unicode1.cpp b/tests/src/unit-unicode1.cpp
similarity index 85%
rename from test/src/unit-unicode1.cpp
rename to tests/src/unit-unicode1.cpp
index 3a736b0..f6c8028 100644
--- a/test/src/unit-unicode1.cpp
+++ b/tests/src/unit-unicode1.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -37,7 +16,7 @@
#include <fstream>
#include <sstream>
#include <iomanip>
-#include <test_data.hpp>
+#include "make_test_data_available.hpp"
TEST_CASE("Unicode (1/5)" * doctest::skip())
{
@@ -107,33 +86,19 @@
{
json _;
- CHECK_THROWS_AS(_ = json::parse("\"\\uDC00\\uDC00\""), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse("\"\\uDC00\\uDC00\""),
- "[json.exception.parse_error.101] parse error at line 1, column 7: syntax error while parsing value - invalid string: surrogate U+DC00..U+DFFF must follow U+D800..U+DBFF; last read: '\"\\uDC00'");
+ CHECK_THROWS_WITH_AS(_ = json::parse("\"\\uDC00\\uDC00\""), "[json.exception.parse_error.101] parse error at line 1, column 7: syntax error while parsing value - invalid string: surrogate U+DC00..U+DFFF must follow U+D800..U+DBFF; last read: '\"\\uDC00'", json::parse_error&);
- CHECK_THROWS_AS(_ = json::parse("\"\\uD7FF\\uDC00\""), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse("\"\\uD7FF\\uDC00\""),
- "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing value - invalid string: surrogate U+DC00..U+DFFF must follow U+D800..U+DBFF; last read: '\"\\uD7FF\\uDC00'");
+ CHECK_THROWS_WITH_AS(_ = json::parse("\"\\uD7FF\\uDC00\""), "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing value - invalid string: surrogate U+DC00..U+DFFF must follow U+D800..U+DBFF; last read: '\"\\uD7FF\\uDC00'", json::parse_error&);
- CHECK_THROWS_AS(_ = json::parse("\"\\uD800]\""), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse("\"\\uD800]\""),
- "[json.exception.parse_error.101] parse error at line 1, column 8: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD800]'");
+ CHECK_THROWS_WITH_AS(_ = json::parse("\"\\uD800]\""), "[json.exception.parse_error.101] parse error at line 1, column 8: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD800]'", json::parse_error&);
- CHECK_THROWS_AS(_ = json::parse("\"\\uD800\\v\""), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse("\"\\uD800\\v\""),
- "[json.exception.parse_error.101] parse error at line 1, column 9: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD800\\v'");
+ CHECK_THROWS_WITH_AS(_ = json::parse("\"\\uD800\\v\""), "[json.exception.parse_error.101] parse error at line 1, column 9: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD800\\v'", json::parse_error&);
- CHECK_THROWS_AS(_ = json::parse("\"\\uD800\\u123\""), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse("\"\\uD800\\u123\""),
- "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\uD800\\u123\"'");
+ CHECK_THROWS_WITH_AS(_ = json::parse("\"\\uD800\\u123\""), "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing value - invalid string: '\\u' must be followed by 4 hex digits; last read: '\"\\uD800\\u123\"'", json::parse_error&);
- CHECK_THROWS_AS(_ = json::parse("\"\\uD800\\uDBFF\""), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse("\"\\uD800\\uDBFF\""),
- "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD800\\uDBFF'");
+ CHECK_THROWS_WITH_AS(_ = json::parse("\"\\uD800\\uDBFF\""), "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD800\\uDBFF'", json::parse_error&);
- CHECK_THROWS_AS(_ = json::parse("\"\\uD800\\uE000\""), json::parse_error&);
- CHECK_THROWS_WITH(_ = json::parse("\"\\uD800\\uE000\""),
- "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD800\\uE000'");
+ CHECK_THROWS_WITH_AS(_ = json::parse("\"\\uD800\\uE000\""), "[json.exception.parse_error.101] parse error at line 1, column 13: syntax error while parsing value - invalid string: surrogate U+D800..U+DBFF must be followed by U+DC00..U+DFFF; last read: '\"\\uD800\\uE000'", json::parse_error&);
}
}
diff --git a/test/src/unit-unicode2.cpp b/tests/src/unit-unicode2.cpp
similarity index 93%
rename from test/src/unit-unicode2.cpp
rename to tests/src/unit-unicode2.cpp
index 8438f17..fcbf259 100644
--- a/test/src/unit-unicode2.cpp
+++ b/tests/src/unit-unicode2.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -39,7 +18,7 @@
#include <sstream>
#include <iostream>
#include <iomanip>
-#include <test_data.hpp>
+#include "make_test_data_available.hpp"
// this test suite uses static variables with non-trivial destructors
DOCTEST_CLANG_SUPPRESS_WARNING_PUSH
diff --git a/test/src/unit-unicode3.cpp b/tests/src/unit-unicode3.cpp
similarity index 87%
rename from test/src/unit-unicode3.cpp
rename to tests/src/unit-unicode3.cpp
index 5bc1afe..8b601ef 100644
--- a/test/src/unit-unicode3.cpp
+++ b/tests/src/unit-unicode3.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -39,7 +18,7 @@
#include <sstream>
#include <iostream>
#include <iomanip>
-#include <test_data.hpp>
+#include "make_test_data_available.hpp"
// this test suite uses static variables with non-trivial destructors
DOCTEST_CLANG_SUPPRESS_WARNING_PUSH
diff --git a/test/src/unit-unicode4.cpp b/tests/src/unit-unicode4.cpp
similarity index 87%
rename from test/src/unit-unicode4.cpp
rename to tests/src/unit-unicode4.cpp
index d51880d..a28e6ee 100644
--- a/test/src/unit-unicode4.cpp
+++ b/tests/src/unit-unicode4.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -39,7 +18,7 @@
#include <sstream>
#include <iostream>
#include <iomanip>
-#include <test_data.hpp>
+#include "make_test_data_available.hpp"
// this test suite uses static variables with non-trivial destructors
DOCTEST_CLANG_SUPPRESS_WARNING_PUSH
diff --git a/test/src/unit-unicode5.cpp b/tests/src/unit-unicode5.cpp
similarity index 87%
rename from test/src/unit-unicode5.cpp
rename to tests/src/unit-unicode5.cpp
index b63ad16..ee90f1e 100644
--- a/test/src/unit-unicode5.cpp
+++ b/tests/src/unit-unicode5.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
@@ -39,7 +18,7 @@
#include <sstream>
#include <iostream>
#include <iomanip>
-#include <test_data.hpp>
+#include "make_test_data_available.hpp"
// this test suite uses static variables with non-trivial destructors
DOCTEST_CLANG_SUPPRESS_WARNING_PUSH
diff --git a/test/src/unit-user_defined_input.cpp b/tests/src/unit-user_defined_input.cpp
similarity index 67%
rename from test/src/unit-user_defined_input.cpp
rename to tests/src/unit-user_defined_input.cpp
index 3308fec..750a058 100644
--- a/test/src/unit-user_defined_input.cpp
+++ b/tests/src/unit-user_defined_input.cpp
@@ -1,31 +1,10 @@
-/*
- __ _____ _____ _____
- __| | __| | | | 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.
-*/
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
#include "doctest_compatibility.h"
diff --git a/tests/src/unit-windows_h.cpp b/tests/src/unit-windows_h.cpp
new file mode 100644
index 0000000..e7aab33
--- /dev/null
+++ b/tests/src/unit-windows_h.cpp
@@ -0,0 +1,21 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#ifdef _WIN32
+ #include <windows.h>
+#endif
+
+#include <nlohmann/json.hpp>
+using nlohmann::json;
+
+TEST_CASE("include windows.h")
+{
+ CHECK(true);
+}
diff --git a/tests/src/unit-wstring.cpp b/tests/src/unit-wstring.cpp
new file mode 100644
index 0000000..3f826a9
--- /dev/null
+++ b/tests/src/unit-wstring.cpp
@@ -0,0 +1,99 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#include "doctest_compatibility.h"
+
+#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();
+bool wstring_is_utf16()
+{
+ return (std::wstring(L"đŠ") == std::wstring(L"\U0001F4A9"));
+}
+
+bool u16string_is_utf16();
+bool u16string_is_utf16()
+{
+ return (std::u16string(u"đŠ") == std::u16string(u"\U0001F4A9"));
+}
+
+bool u32string_is_utf32();
+bool u32string_is_utf32()
+{
+ return (std::u32string(U"đŠ") == std::u32string(U"\U0001F4A9"));
+}
+} // namespace
+
+TEST_CASE("wide strings")
+{
+ SECTION("std::wstring")
+ {
+ if (wstring_is_utf16())
+ {
+ std::wstring w = L"[12.2,\"á
aäöđ¤đ§ĸ\"]";
+ json j = json::parse(w);
+ CHECK(j.dump() == "[12.2,\"á
aäöđ¤đ§ĸ\"]");
+ }
+ }
+
+ SECTION("invalid std::wstring")
+ {
+ if (wstring_is_utf16())
+ {
+ std::wstring w = L"\"\xDBFF";
+ json _;
+ CHECK_THROWS_AS(_ = json::parse(w), json::parse_error&);
+ }
+ }
+
+ SECTION("std::u16string")
+ {
+ if (u16string_is_utf16())
+ {
+ std::u16string w = u"[12.2,\"á
aäöđ¤đ§ĸ\"]";
+ json j = json::parse(w);
+ CHECK(j.dump() == "[12.2,\"á
aäöđ¤đ§ĸ\"]");
+ }
+ }
+
+ SECTION("invalid std::u16string")
+ {
+ if (wstring_is_utf16())
+ {
+ std::u16string w = u"\"\xDBFF";
+ json _;
+ CHECK_THROWS_AS(_ = json::parse(w), json::parse_error&);
+ }
+ }
+
+ SECTION("std::u32string")
+ {
+ if (u32string_is_utf32())
+ {
+ std::u32string w = U"[12.2,\"á
aäöđ¤đ§ĸ\"]";
+ json j = json::parse(w);
+ CHECK(j.dump() == "[12.2,\"á
aäöđ¤đ§ĸ\"]");
+ }
+ }
+
+ SECTION("invalid std::u32string")
+ {
+ if (u32string_is_utf32())
+ {
+ std::u32string w = U"\"\x110000";
+ json _;
+ CHECK_THROWS_AS(_ = json::parse(w), json::parse_error&);
+ }
+ }
+}
+#endif
diff --git a/tests/src/unit.cpp b/tests/src/unit.cpp
new file mode 100644
index 0000000..e6c1e08
--- /dev/null
+++ b/tests/src/unit.cpp
@@ -0,0 +1,10 @@
+// __ _____ _____ _____
+// __| | __| | | | JSON for Modern C++ (supporting code)
+// | | |__ | | | | | | version 3.11.0
+// |_____|_____|_____|_|___| https://github.com/nlohmann/json
+//
+// SPDX-FileCopyrightText: 2013-2022 Niels Lohmann <https://nlohmann.me>
+// SPDX-License-Identifier: MIT
+
+#define DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
+#include "doctest_compatibility.h"
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/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/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/third_party/amalgamate/LICENSE.md b/third_party/amalgamate/LICENSE.md
deleted file mode 100644
index 7fe9cf0..0000000
--- a/third_party/amalgamate/LICENSE.md
+++ /dev/null
@@ -1,27 +0,0 @@
-amalgamate.py - Amalgamate C source and header files
-Copyright (c) 2012, Erik Edlund <erik.edlund@32767.se>
-
-Redistribution and use in source and binary forms, with or without modification,
-are permitted provided that the following conditions are met:
-
- * Redistributions of source code must retain the above copyright notice,
- this list of conditions and the following disclaimer.
-
- * Redistributions in binary form must reproduce the above copyright notice,
- this list of conditions and the following disclaimer in the documentation
- and/or other materials provided with the distribution.
-
- * Neither the name of Erik Edlund, nor the names of its contributors may
- be used to endorse or promote products derived from this software without
- specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
-ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
-ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
-(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
-ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
-SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/third_party/cpplint/LICENSE b/third_party/cpplint/LICENSE
deleted file mode 100644
index 1756a59..0000000
--- a/third_party/cpplint/LICENSE
+++ /dev/null
@@ -1,27 +0,0 @@
-cpplint.py and its corresponding unit tests are Copyright (C) 2009 Google Inc.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
- * Redistributions of source code must retain the above copyright
-notice, this list of conditions and the following disclaimer.
- * Redistributions in binary form must reproduce the above
-copyright notice, this list of conditions and the following disclaimer
-in the documentation and/or other materials provided with the
-distribution.
- * Neither the name of Google Inc. nor the names of its
-contributors may be used to endorse or promote products derived from
-this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/third_party/gdb_pretty_printer/nlohmann-json.py b/third_party/gdb_pretty_printer/nlohmann-json.py
deleted file mode 100644
index c85a383..0000000
--- a/third_party/gdb_pretty_printer/nlohmann-json.py
+++ /dev/null
@@ -1,28 +0,0 @@
-import gdb
-
-class JsonValuePrinter:
- "Print a json-value"
-
- def __init__(self, val):
- self.val = val
-
- def to_string(self):
- if self.val.type.strip_typedefs().code == gdb.TYPE_CODE_FLT:
- return ("%.6f" % float(self.val)).rstrip("0")
- return self.val
-
-def json_lookup_function(val):
- name = val.type.strip_typedefs().name
- if name and name.startswith("nlohmann::basic_json<") and name.endswith(">"):
- t = str(val['m_type'])
- if t.startswith("nlohmann::detail::value_t::"):
- try:
- union_val = val['m_value'][t[27:]]
- if union_val.type.code == gdb.TYPE_CODE_PTR:
- return gdb.default_visualizer(union_val.dereference())
- else:
- return JsonValuePrinter(union_val)
- except:
- return JsonValuePrinter(val['m_type'])
-
-gdb.pretty_printers.append(json_lookup_function)
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/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 99%
rename from third_party/amalgamate/amalgamate.py
rename to tools/amalgamate/amalgamate.py
index f01b43b..0aed7c9 100755
--- a/third_party/amalgamate/amalgamate.py
+++ b/tools/amalgamate/amalgamate.py
@@ -1,4 +1,4 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
# coding=utf-8
# amalgamate.py - Amalgamate C source and header files.
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/README.rst b/tools/cpplint/README.rst
similarity index 94%
rename from third_party/cpplint/README.rst
rename to tools/cpplint/README.rst
index 18af13c..9ff67c0 100644
--- a/third_party/cpplint/README.rst
+++ b/tools/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 @@
* 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/tools/cpplint/cpplint.py
similarity index 99%
rename from third_party/cpplint/cpplint.py
rename to tools/cpplint/cpplint.py
index 3bf3441..6b78b30 100755
--- a/third_party/cpplint/cpplint.py
+++ b/tools/cpplint/cpplint.py
@@ -41,6 +41,11 @@
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 @@
# if empty, use defaults
_valid_extensions = set([])
-__VERSION__ = '1.5.5'
+__VERSION__ = '1.6.0'
try:
xrange # Python 2
@@ -1915,6 +1920,7 @@
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 @@
#
# 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 @@
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():
diff --git a/third_party/cpplint/update.sh b/tools/cpplint/update.sh
similarity index 68%
rename from third_party/cpplint/update.sh
rename to tools/cpplint/update.sh
index 03b6785..382b9cd 100755
--- a/third_party/cpplint/update.sh
+++ b/tools/cpplint/update.sh
@@ -1,5 +1,4 @@
#!/bin/sh
wget -N https://raw.githubusercontent.com/cpplint/cpplint/master/cpplint.py
-wget -N https://raw.githubusercontent.com/cpplint/cpplint/master/LICENSE
wget -N https://raw.githubusercontent.com/cpplint/cpplint/master/README.rst
diff --git a/third_party/gdb_pretty_printer/README.md b/tools/gdb_pretty_printer/README.md
similarity index 93%
rename from third_party/gdb_pretty_printer/README.md
rename to tools/gdb_pretty_printer/README.md
index f5f6192..c1a3651 100644
--- a/third_party/gdb_pretty_printer/README.md
+++ b/tools/gdb_pretty_printer/README.md
@@ -50,7 +50,8 @@
}
```
-Tested with GDB 9.2. See [#1952](https://github.com/nlohmann/json/issues/1952) for more information. Please post questions there.
+Requires Python 3.9+. Last tested with GDB 12.1.
+See [#1952](https://github.com/nlohmann/json/issues/1952) for more information. Please post questions there.
## Copyright
diff --git a/tools/gdb_pretty_printer/nlohmann-json.py b/tools/gdb_pretty_printer/nlohmann-json.py
new file mode 100644
index 0000000..774756d
--- /dev/null
+++ b/tools/gdb_pretty_printer/nlohmann-json.py
@@ -0,0 +1,32 @@
+import gdb
+import re
+
+ns_pattern = re.compile(r'nlohmann::json_v(?P<v_major>\d+)_(?P<v_minor>\d+)_(?P<v_patch>\d+)(?P<tags>\w*)::(?P<name>.+)')
+class JsonValuePrinter:
+ "Print a json-value"
+
+ def __init__(self, val):
+ self.val = val
+
+ def to_string(self):
+ if self.val.type.strip_typedefs().code == gdb.TYPE_CODE_FLT:
+ return ("%.6f" % float(self.val)).rstrip("0")
+ return self.val
+
+def json_lookup_function(val):
+ m = ns_pattern.fullmatch(val.type.strip_typedefs().name)
+ name = m.group('name')
+ if name and name.startswith('basic_json<') and name.endswith('>'):
+ m = ns_pattern.fullmatch(str(val['m_type']))
+ t = m.group('name')
+ if t and t.startswith('detail::value_t::'):
+ try:
+ union_val = val['m_value'][t.removeprefix('detail::value_t::')]
+ if union_val.type.code == gdb.TYPE_CODE_PTR:
+ return gdb.default_visualizer(union_val.dereference())
+ else:
+ return JsonValuePrinter(union_val)
+ except:
+ return JsonValuePrinter(val['m_type'])
+
+gdb.pretty_printers.append(json_lookup_function)
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
diff --git a/tools/serve_header/README.md b/tools/serve_header/README.md
new file mode 100644
index 0000000..a95ef20
--- /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.
+
+
+
+## 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 0000000..b777516
--- /dev/null
+++ b/tools/serve_header/demo.png
Binary files differ
diff --git a/tools/serve_header/requirements.txt b/tools/serve_header/requirements.txt
new file mode 100644
index 0000000..d32eed3
--- /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 0000000..666fa57
--- /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 0000000..4231091
--- /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
diff --git a/wsjcpp.yml b/wsjcpp.yml
index dff50e8..619d46b 100644
--- a/wsjcpp.yml
+++ b/wsjcpp.yml
@@ -2,7 +2,7 @@
cmake_minimum_required: "3.0"
cmake_cxx_standard: "11"
name: "nlohmann/json"
-version: "v3.10.5"
+version: "v3.11.0"
description: "JSON for Modern C++"
issues: "https://github.com/nlohmann/json/issues"
keywords:
