SAX implementation to create a JSON value from SAX events. More...

#include "json.h"

Collaboration diagram for detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >:

Public Types
using	binary_t = typename BasicJsonType::binary_t

using	lexer_t = lexer< BasicJsonType, InputAdapterType >

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	string_t = typename BasicJsonType::string_t

Public Member Functions
	json_sax_dom_parser (BasicJsonType &r, const bool allow_exceptions_=true, lexer_t *lexer_=nullptr)

	json_sax_dom_parser (const json_sax_dom_parser &)=delete

	json_sax_dom_parser (json_sax_dom_parser &&)=default

	~json_sax_dom_parser ()=default

bool	binary (binary_t &val)

bool	boolean (bool val)

bool	end_array ()

bool	end_object ()

constexpr bool	is_errored () const

bool	key (string_t &val)

bool	null ()

bool	number_float (number_float_t val, const string_t &)

bool	number_integer (number_integer_t val)

bool	number_unsigned (number_unsigned_t val)

json_sax_dom_parser &	operator= (const json_sax_dom_parser &)=delete

json_sax_dom_parser &	operator= (json_sax_dom_parser &&)=default

template<class Exception >
bool	parse_error (std::size_t, const std::string &, const Exception &ex)

bool	start_array (std::size_t len)

bool	start_object (std::size_t len)

bool	string (string_t &val)

Private Member Functions
template<typename Value >
JSON_HEDLEY_RETURNS_NON_NULL BasicJsonType *	handle_value (Value &&v)

Private Attributes
const bool	allow_exceptions = true
	whether to throw exceptions in case of errors

bool	errored = false
	whether a syntax error occurred

lexer_t *	m_lexer_ref = nullptr
	the lexer reference to obtain the current position

BasicJsonType *	object_element = nullptr
	helper to hold the reference for the next object element

std::vector< BasicJsonType * >	ref_stack {}
	stack to model hierarchy of values

BasicJsonType &	root
	the parsed JSON value

Detailed Description

template<typename BasicJsonType, typename InputAdapterType>
class detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >

SAX implementation to create a JSON value from SAX events.

This class implements the 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.

Template Parameters

BasicJsonType the JSON type

Definition at line 8865 of file json.h.

Member Typedef Documentation

◆ binary_t

template<typename BasicJsonType , typename InputAdapterType >

using detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::binary_t = typename BasicJsonType::binary_t

Definition at line 8872 of file json.h.

◆ lexer_t

template<typename BasicJsonType , typename InputAdapterType >

using detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::lexer_t = lexer<BasicJsonType, InputAdapterType>

Definition at line 8873 of file json.h.

◆ number_float_t

template<typename BasicJsonType , typename InputAdapterType >

using detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::number_float_t = typename BasicJsonType::number_float_t

Definition at line 8870 of file json.h.

◆ number_integer_t

template<typename BasicJsonType , typename InputAdapterType >

using detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::number_integer_t = typename BasicJsonType::number_integer_t

Definition at line 8868 of file json.h.

◆ number_unsigned_t

template<typename BasicJsonType , typename InputAdapterType >

using detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::number_unsigned_t = typename BasicJsonType::number_unsigned_t

Definition at line 8869 of file json.h.

◆ string_t

template<typename BasicJsonType , typename InputAdapterType >

using detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::string_t = typename BasicJsonType::string_t

Definition at line 8871 of file json.h.

Constructor & Destructor Documentation

◆ json_sax_dom_parser() [1/3]

template<typename BasicJsonType , typename InputAdapterType >

detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::json_sax_dom_parser	(	BasicJsonType &	r,
		const bool	allow_exceptions_ = `true`,
		lexer_t *	lexer_ = `nullptr`
	)

inlineexplicit

Parameters

[in,out]	r	reference to a JSON value that is manipulated while parsing
[in]	allow_exceptions_	whether parse errors yield exceptions

Definition at line 8880 of file json.h.

◆ json_sax_dom_parser() [2/3]

template<typename BasicJsonType , typename InputAdapterType >

detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::json_sax_dom_parser ( const json_sax_dom_parser< BasicJsonType, InputAdapterType > & )

delete

◆ json_sax_dom_parser() [3/3]

template<typename BasicJsonType , typename InputAdapterType >

detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::json_sax_dom_parser ( json_sax_dom_parser< BasicJsonType, InputAdapterType > && )

default

◆ ~json_sax_dom_parser()

template<typename BasicJsonType , typename InputAdapterType >

detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::~json_sax_dom_parser ( )

default

Member Function Documentation

◆ binary()

template<typename BasicJsonType , typename InputAdapterType >

bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::binary ( binary_t & val )

inline

Definition at line 8927 of file json.h.

◆ boolean()

template<typename BasicJsonType , typename InputAdapterType >

bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::boolean ( bool val )

inline

Definition at line 8897 of file json.h.

◆ end_array()

template<typename BasicJsonType , typename InputAdapterType >

bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::end_array ( )

inline

Definition at line 9005 of file json.h.

References JSON_ASSERT.

◆ end_object()

template<typename BasicJsonType , typename InputAdapterType >

bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::end_object ( )

inline

Definition at line 8966 of file json.h.

References JSON_ASSERT.

◆ handle_value()

template<typename BasicJsonType , typename InputAdapterType >

template<typename Value >

JSON_HEDLEY_RETURNS_NON_NULL BasicJsonType * detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::handle_value ( Value && v )

inlineprivate

Invariant: If the ref stack is empty, then the passed value will be the new root.; If the ref stack contains a value, then it is an array or an object to which we can add elements

Definition at line 9119 of file json.h.

References JSON_ASSERT.

◆ is_errored()

template<typename BasicJsonType , typename InputAdapterType >

constexpr bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::is_errored ( ) const

inlineconstexpr

Definition at line 9036 of file json.h.

Referenced by detail::parser< BasicJsonType, InputAdapterType >::parse().

Here is the caller graph for this function:

◆ key()

template<typename BasicJsonType , typename InputAdapterType >

bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::key ( string_t & val )

inline

Definition at line 8956 of file json.h.

References JSON_ASSERT.

◆ null()

template<typename BasicJsonType , typename InputAdapterType >

bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::null ( )

inline

Definition at line 8891 of file json.h.

◆ number_float()

template<typename BasicJsonType , typename InputAdapterType >

bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::number_float	(	number_float_t	val,
		const string_t &
	)

inline

Definition at line 8915 of file json.h.

◆ number_integer()

template<typename BasicJsonType , typename InputAdapterType >

bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::number_integer ( number_integer_t val )

inline

Definition at line 8903 of file json.h.

◆ number_unsigned()

template<typename BasicJsonType , typename InputAdapterType >

bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::number_unsigned ( number_unsigned_t val )

inline

Definition at line 8909 of file json.h.

◆ operator=() [1/2]

template<typename BasicJsonType , typename InputAdapterType >

json_sax_dom_parser & detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::operator= ( const json_sax_dom_parser< BasicJsonType, InputAdapterType > & )

delete

◆ operator=() [2/2]

template<typename BasicJsonType , typename InputAdapterType >

json_sax_dom_parser & detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::operator= ( json_sax_dom_parser< BasicJsonType, InputAdapterType > && )

default

◆ parse_error()

template<typename BasicJsonType , typename InputAdapterType >

template<class Exception >

bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::parse_error	(	std::size_t	,
		const std::string &	,
		const Exception &	ex
	)

inline

Definition at line 9024 of file json.h.

References JSON_THROW.

Referenced by detail::parser< BasicJsonType, InputAdapterType >::parse().

Here is the caller graph for this function:

◆ start_array()

template<typename BasicJsonType , typename InputAdapterType >

bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::start_array ( std::size_t len )

inline

Definition at line 8984 of file json.h.

References detail::concat(), JSON_HEDLEY_UNLIKELY, JSON_THROW, and detail::unknown_size().

Here is the call graph for this function:

◆ start_object()

template<typename BasicJsonType , typename InputAdapterType >

bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::start_object ( std::size_t len )

inline

Definition at line 8933 of file json.h.

References detail::concat(), JSON_HEDLEY_UNLIKELY, JSON_THROW, and detail::unknown_size().

Here is the call graph for this function:

◆ string()

template<typename BasicJsonType , typename InputAdapterType >

bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::string ( string_t & val )

inline

Definition at line 8921 of file json.h.

Member Data Documentation

◆ allow_exceptions

template<typename BasicJsonType , typename InputAdapterType >

const bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::allow_exceptions = true

private

whether to throw exceptions in case of errors

Definition at line 9165 of file json.h.

◆ errored

template<typename BasicJsonType , typename InputAdapterType >

bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::errored = false

private

whether a syntax error occurred

Definition at line 9163 of file json.h.

◆ m_lexer_ref

template<typename BasicJsonType , typename InputAdapterType >

lexer_t* detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::m_lexer_ref = nullptr

private

the lexer reference to obtain the current position

Definition at line 9167 of file json.h.

◆ object_element

template<typename BasicJsonType , typename InputAdapterType >

BasicJsonType* detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::object_element = nullptr

private

helper to hold the reference for the next object element

Definition at line 9161 of file json.h.

◆ ref_stack

template<typename BasicJsonType , typename InputAdapterType >

std::vector<BasicJsonType*> detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::ref_stack {}

private

stack to model hierarchy of values

Definition at line 9159 of file json.h.

◆ root

template<typename BasicJsonType , typename InputAdapterType >

BasicJsonType& detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::root

private

the parsed JSON value

Definition at line 9157 of file json.h.

The documentation for this class was generated from the following file:

src/applications/model/json.h

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

◆ binary_t

◆ lexer_t

◆ number_float_t

◆ number_integer_t

◆ number_unsigned_t

◆ string_t

Constructor & Destructor Documentation

◆ json_sax_dom_parser() [1/3]

◆ json_sax_dom_parser() [2/3]

◆ json_sax_dom_parser() [3/3]

◆ ~json_sax_dom_parser()

Member Function Documentation

◆ binary()

◆ boolean()

◆ end_array()

◆ end_object()

◆ handle_value()

◆ is_errored()

◆ key()

◆ null()

◆ number_float()

◆ number_integer()

◆ number_unsigned()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ parse_error()

◆ start_array()

◆ start_object()

◆ string()

Member Data Documentation

◆ allow_exceptions

◆ errored

◆ m_lexer_ref

◆ object_element

◆ ref_stack

◆ root