Niels Lohmann
ffd4242dc2
* Docs: fill documentation gaps found in user questions Add pages on class-hierarchy/smart-pointer/variant/chrono recipes, working without exceptions, and large, streamed and partial input. Extend the FAQ (23 entries, Known bugs first), parse error documentation (empty-input checklist, line/column, diagnostic positions), element access, conversions, creating values, ADL troubleshooting, memory, and build/distribution notes. Add 14 examples with generated output. Correct the statement that parse errors cannot be recovered from with -fno-exceptions. The topics come from recurring questions on Stack Overflow, Reddit, Hacker News, YouTube, and the project's GitHub discussions and issues. Signed-off-by: Niels Lohmann <mail@nlohmann.me> * docs: declare range-for lists in variables to keep astyle quiet astyle reformats a braced init list placed directly in a range-for header; declare the list first so check_amalgamation passes. Signed-off-by: Niels Lohmann <mail@nlohmann.me> --------- Signed-off-by: Niels Lohmann <mail@nlohmann.me>
29 lines
1018 B
C++
29 lines
1018 B
C++
#include <cstdint>
|
|
#include <iostream>
|
|
#include <vector>
|
|
#include <nlohmann/json.hpp>
|
|
|
|
using json = nlohmann::json;
|
|
|
|
// None of the calls below throws, so this example also works with -fno-exceptions.
|
|
int main()
|
|
{
|
|
const std::string invalid = R"({"name": "Mary", "age": )";
|
|
|
|
// parse() with allow_exceptions = false returns a discarded value
|
|
json j = json::parse(invalid, nullptr, false);
|
|
std::cout << std::boolalpha << "parse: discarded = " << j.is_discarded() << '\n';
|
|
|
|
// accept() only tells whether the input is valid JSON
|
|
std::cout << "accept: " << json::accept(invalid) << '\n';
|
|
|
|
// the binary formats have the same parameter
|
|
const std::vector<std::uint8_t> truncated_cbor = {0x83, 0x01};
|
|
json c = json::from_cbor(truncated_cbor, true, false);
|
|
std::cout << "from_cbor: discarded = " << c.is_discarded() << '\n';
|
|
|
|
// valid input is parsed as usual
|
|
json valid = json::parse(R"({"name": "Mary"})", nullptr, false);
|
|
std::cout << "valid input: " << valid << '\n';
|
|
}
|