[#nlohmann-basic_json-0c-sax_parse-07]
= xref:nlohmann.adoc[nlohmann]::xref:nlohmann/basic_json-0c.adoc[basic_json]::sax_parse
:relfileprefix: ../../
:mrdocs:

generate SAX events

== Synopsis

Declared in `<nlohmann/json.hpp>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<typename SAX>
[[deprecated]]
static
bool
sax_parse(
    /* implementation-defined */::span_input_adapter&& i,
    SAX* sax,
    xref:nlohmann/basic_json-0c/input_format_t.adoc[input_format_t] format = input_format_t::json,
    bool const strict = true,
    bool const ignore_comments = false,
    bool const ignore_trailing_commas = false);
----

[WARNING]
====
https://en.cppreference.com/cpp/language/attributes/deprecated[Deprecated^]: Since 3.8.0; use sax_parse(ptr, ptr + len, ...). Use of this entity is allowed but discouraged.
====
== Return Value

whether the generation of SAX events completed successfully

== Parameters

[cols="1,4"]
|===
| Name| Description
| *i*
| input to read the JSON value from
| *sax*
| SAX event consumer
| *format*
| the format to parse the input as
| *strict*
| whether to expect the input to be consumed until EOF
| *ignore_comments*
| whether comments should be ignored and treated like whitespace (`true`) or yield a parse error (`false`); only applies to the `json` format
| *ignore_trailing_commas*
| whether trailing commas in arrays and objects should be ignored (`true`) or yield a parse error (`false`); only applies to the `json` format
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#