JSON for Modern C++ version 3.11.2

[nlohmann]

Release date: 2022-08-12
SHA-256: 665fa14b8af3837966949e8eb0052d583e2ac105d3438baba9951785512cf921 (json.hpp), e5c7a9f49a16814be27e4ed0ee900ecd0092bfb7dbfca65b5a421b774dccaaed (include.zip), 8c4b26bf4b422252e13f332bc5e388ec0ab5c3443d24399acb675e68278d341f (json.tar.xz)

Summary

This release fixes some bugs found in the 3.11.1 release. Furthermore, the of the library has been re-structured.

All changes are backward-compatible.

💰 Note you can support this project via GitHub sponsors or PayPal.

🐛 Bug Fixes

• Fix the value function which was broken for strings, size types, and nullptr in release 3.11.0. Regression: call to member function 'value' is ambiguous #3652 regression: .value<size_t> is compilation error. #3655 Reimplement value() access functions #3663
• Fix the json_fwd.hpp header to be self-contained and add it to the single-header release. json_fwd.hpp no longer standalone #3656 Amalgamate the forward declaration header #3679 Add amalgamated json-fwd.hpp to release #3687
• Fix regression that broke using json_pointer as key in associative containers. Add operator< to , to allow use as a map key #3680 Make json_pointer usable as map key (again) #3685
• Add missing constraint to deprecated JSON Pointer overloads of contains and at. Add forgotten is_basic_json guard to functions with json_pointer<Basi… #3658 Properly constrain non-string json_pointer overloads #3681
• Fix comparison between json_pointer and strings with == and !=. These comparisons worked in 3.10.5, but were broken in 3.11.0 and 3.11.1. Regression: no match for 'operator!=' comparing json_pointer and const char */string_t #3654 Add json_pointer/string_t equality comparison operators #3664
• Fix to_json conversion of std::vector<bool>::reference and std::vector<bool>::const_reference for STLs where these are the same as basic_json::boolean_t& and basic_json::boolean_t, respectively. Fix -Wignored-reference-qualifiers #3677 Fix 'const' qualifier on bool& has no effect #3678

⚡ Improvements

• Restructure inline namespace and allow version component to be disabled. See documentation. Restructure inline namespace and allow version component to be disabled #3683 MSVC natvis visualizer does not work after introduction of inline ABI namespace #3696 Add Python script for generating Natvis file and update file for 3.11.2 #3697 generate_natvis.py: validate version number; cleanup #3698
• Avoid heap allocations in BJData parser. Minor BJData fixes #3637

🔨 Further Changes

Documentation

• Publish documentation on every push to develop branch. Publish documentation on push to develop branch #3660 Refine 'Publish documentation' workflow #3673
• Add missing examples for the public API. Documentation change #3672 Documentation updates for 3.11.2 #3686
• Fix typo in json_pointer documentation. fix typo in json_pointer.md #3692

Community

• Add a badge for the Discord chat to the README file. The goal of that additional communication channel beyond the existing ones is to quickly coordinate between the contributors. Add Discord badge to README #3651
• Complete contributor list. Complete contributor list #3662 Complete contributor list #3670

CI

• Remove the macos-10.15 image from the CI as it is removed by GitHub Actions. macOS 10.15 Actions runner image deprecation #3612 Bump macos-10.5 runner to macos-11 and update Xcode versions #3615 Update CI #3626
• Remove hardcoded paths in Ubuntu workflow. Update CI #3626
• Only trigger AppVeyor builds if relevant files have been changed. Update CI #3626
• Fix CodeQL warning. Update CI #3626
• Harmonize naming of GitHub Actions jobs. Adjust naming of GitHub action jobs #3661
• Add labeler action to automatically add PR labels based on the changed files. Add labeler action #3671 Attempt to fix labeler permissions #3674 Fix whitespace in workflow files #3675
• Lint API documentation in the CI. Documentation change #3672
• Add local LGTM configuration and suppress warnings on third-party scripts. Miscellaneous small fixes #3643

🔥 Deprecated functions

• This release deprecations comparing JSON Pointers with strings via operator== and operator!=. To compare a json_pointer p with a string s, convert s to a json_pointer first and use json_pointer::operator== or json_pointer::operator!=. Deprecate json_pointer/string_t comparisons #3684

The following functions have been deprecated in earlier versions and will be removed in the next major version (i.e., 4.0.0):

• The function iterator_wrapper is deprecated. Please use the member function items() instead.
• Functions friend std::istream& operator<<(basic_json&, std::istream&) and friend std::ostream& operator>>(const basic_json&, std::ostream&) are deprecated. Please use friend std::istream& operator>>(std::istream&, basic_json&) and friend operator<<(std::ostream&, const basic_json&) instead.
• Passing iterator pairs or pointer/length pairs to parsing functions (basic_json::parse, basic_json::accept, basic_json::sax_parse, basic_json::from_cbor, basic_json::from_msgpack, basic_json::from_ubjson, basic_json::from_bson) via initializer lists is deprecated. Instead, pass two iterators; for instance, call basic_json::from_cbor(ptr, ptr+len) instead of basic_json::from_cbor({ptr, len}).
• The implicit conversion from JSON Pointers to string (json_pointer::operator string_t) is deprecated. Use json_pointer::to_string instead.

All deprecations are annotated with HEDLEY_DEPRECATED_FOR to report which function to use instead.

---

This discussion was created from the release JSON for Modern C++ version 3.11.2.