parse()

template<typename BasicJsonType , typename InputAdapterType >

void nlohmann::detail::parser< BasicJsonType, InputAdapterType >::parse ( const bool  strict, BasicJsonType &  result  )

inline

public parser interface

Parameters

[in]	strict	whether to expect the last token to be EOF
[in,out]	result	parsed JSON value

Exceptions

parse_error.101	in case of an unexpected token
parse_error.102	if to_unicode fails or surrogate error
parse_error.103	if to_unicode fails

Definition at line 11088 of file json.hpp.

    {
        if (callback)
        {
            json_sax_dom_callback_parser<BasicJsonType> sdp(result, callback, allow_exceptions);
            sax_parse_internal(&sdp);
 
            // in strict mode, input must be completely read
            if (strict && (get_token() != token_type::end_of_input))
            {
                sdp.parse_error(m_lexer.get_position(),
                                m_lexer.get_token_string(),
                                parse_error::create(101, m_lexer.get_position(),
                                                    exception_message(token_type::end_of_input, "value"), BasicJsonType()));
            }
 
            // in case of an error, return discarded value
            if (sdp.is_errored())
            {
                result = value_t::discarded;
                return;
            }
 
            // set top-level value to null if it was discarded by the callback
            // function
            if (result.is_discarded())
            {
                result = nullptr;
            }
        }
 
        else
        {
            json_sax_dom_parser<BasicJsonType> sdp(result, allow_exceptions);
            sax_parse_internal(&sdp);
 
            // in strict mode, input must be completely read
            if (strict && (get_token() != token_type::end_of_input))
            {
                sdp.parse_error(m_lexer.get_position(),
                                m_lexer.get_token_string(),
                                parse_error::create(101, m_lexer.get_position(), exception_message(token_type::end_of_input, "value"), BasicJsonType()));
            }
 
            // in case of an error, return discarded value
            if (sdp.is_errored())
            {
                result = value_t::discarded;
                return;
            }
        }
 
        result.assert_invariant();
    }