nlohmann::basic_json::sax_parse

generate SAX events (iterator pair, or iterator+sentinel pair for C++20 ranges support)

Synopsis

Declared in <nlohmann/json.hpp>

template<
    class IteratorType,
    class SAX,
    class SentinelType = IteratorType>
requires detail::can_compare_ne<IteratorType, SentinelType>::value
static
bool
sax_parse(
    IteratorType first,
    SentinelType last,
    SAX* sax,
    input_format_t format = input_format_t::json,
    bool const strict = true,
    bool const ignore_comments = false,
    bool const ignore_trailing_commas = false);

Return Value

whether the generation of SAX events completed successfully

Parameters

NameDescription
firstiterator to the start of the input
lastiterator to the end of the input, or a sentinel value comparable to first
saxSAX event consumer
formatthe format to parse the input as
strictwhether to expect the input to be consumed until EOF
ignore_commentswhether comments should be ignored and treated like whitespace (true) or yield a parse error (false); only applies to the json format
ignore_trailing_commaswhether trailing commas in arrays and objects should be ignored (true) or yield a parse error (false); only applies to the json format