NDDEM
Public Types | Public Member Functions | Private Member Functions | Private Attributes | List of all members
detail::json_sax_dom_parser< BasicJsonType, InputAdapterType > Class Template Reference

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

#include <json.hpp>

Public Types

using number_integer_t = typename BasicJsonType::number_integer_t
 
using number_unsigned_t = typename BasicJsonType::number_unsigned_t
 
using number_float_t = typename BasicJsonType::number_float_t
 
using string_t = typename BasicJsonType::string_t
 
using binary_t = typename BasicJsonType::binary_t
 
using lexer_t = lexer< BasicJsonType, InputAdapterType >
 

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_parseroperator= (const json_sax_dom_parser &)=delete
 
json_sax_dom_parseroperator= (json_sax_dom_parser &&)=default
 
 ~json_sax_dom_parser ()=default
 
bool null ()
 
bool boolean (bool val)
 
bool number_integer (number_integer_t val)
 
bool number_unsigned (number_unsigned_t val)
 
bool number_float (number_float_t val, const string_t &)
 
bool string (string_t &val)
 
bool binary (binary_t &val)
 
bool start_object (std::size_t len)
 
bool key (string_t &val)
 
bool end_object ()
 
bool start_array (std::size_t len)
 
bool end_array ()
 
template<class Exception >
bool parse_error (std::size_t, const std::string &, const Exception &ex)
 
constexpr bool is_errored () const
 

Private Member Functions

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

Private Attributes

BasicJsonType & root
 the parsed JSON value More...
 
std::vector< BasicJsonType * > ref_stack {}
 stack to model hierarchy of values More...
 
BasicJsonType * object_element = nullptr
 helper to hold the reference for the next object element More...
 
bool errored = false
 whether a syntax error occurred More...
 
const bool allow_exceptions = true
 whether to throw exceptions in case of errors More...
 
lexer_tm_lexer_ref = nullptr
 the lexer reference to obtain the current position More...
 

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
BasicJsonTypethe JSON type

Member Typedef Documentation

◆ binary_t

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

◆ lexer_t

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

◆ number_float_t

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

◆ number_integer_t

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

◆ number_unsigned_t

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

◆ string_t

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

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]rreference to a JSON value that is manipulated while parsing
[in]allow_exceptions_whether parse errors yield exceptions

◆ 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

◆ boolean()

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

◆ end_array()

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

◆ end_object()

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

◆ 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

◆ is_errored()

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

◆ key()

template<typename BasicJsonType , typename InputAdapterType >
bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::key ( string_t val)
inline

◆ null()

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

◆ 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

◆ number_integer()

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

◆ number_unsigned()

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

◆ 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

◆ start_array()

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

◆ start_object()

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

◆ string()

template<typename BasicJsonType , typename InputAdapterType >
bool detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::string ( string_t val)
inline

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

◆ errored

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

whether a syntax error occurred

◆ 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

◆ 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

◆ 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

◆ root

template<typename BasicJsonType , typename InputAdapterType >
BasicJsonType& detail::json_sax_dom_parser< BasicJsonType, InputAdapterType >::root
private

the parsed JSON value


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