c4::yml::extra::EventHandlerTestSuite Struct Reference

This event produces standard YAML events as used in the YAML test suite. More...

#include <event_handler_testsuite.hpp>

Inheritance diagram for c4::yml::extra::EventHandlerTestSuite:

Public Types
using	pfn_relocate_arena = detail::pfn_relocate_arena
types
using	state = EventHandlerTestSuiteState
using	EventSink = extra::string

Public Member Functions
void	check_trailing_doc_token () const
	Check whether the current parse tokens are trailing on the previous doc, and raise an error if they are. More...
construction and resetting
	EventHandlerTestSuite ()
	EventHandlerTestSuite (Callbacks const &cb)
	EventHandlerTestSuite (EventSink *sink, Callbacks const &cb)
	EventHandlerTestSuite (EventSink *sink)
void	reset ()
parse events
void	start_parse (const char *filename, csubstr src, detail::pfn_relocate_arena relocate_arena, void *relocate_arena_data)
void	finish_parse ()
void	cancel_parse ()
YAML stream events
void	begin_stream ()
void	end_stream ()
YAML document events
void	begin_doc ()
	implicit doc start (without —) More...
void	end_doc ()
	implicit doc end (without ...) More...
void	begin_doc_expl ()
	explicit doc start, with — More...
void	end_doc_expl ()
	explicit doc end, with ... More...
YAML map functions
void	begin_map_key_flow ()
void	begin_map_key_block ()
void	begin_map_val_flow ()
void	begin_map_val_block ()
void	end_map_block ()
void	end_map_flow (bool)
YAML seq events
void	begin_seq_key_flow ()
void	begin_seq_key_block ()
void	begin_seq_val_flow ()
void	begin_seq_val_block ()
void	end_seq_block ()
void	end_seq_flow (bool)
YAML structure events
void	add_sibling ()
void	actually_val_is_first_key_of_new_map_flow ()
	set the previous val as the first key of a new map, with flow style. More...
void	actually_val_is_first_key_of_new_map_block ()
	like its flow counterpart, but this function can only be called after the end of a flow-val at root or doc level. More...
YAML scalar events
void	set_key_scalar_plain_empty () noexcept
void	set_val_scalar_plain_empty () noexcept
void	set_key_scalar_plain (csubstr scalar)
void	set_val_scalar_plain (csubstr scalar)
void	set_key_scalar_dquoted (csubstr scalar)
void	set_val_scalar_dquoted (csubstr scalar)
void	set_key_scalar_squoted (csubstr scalar)
void	set_val_scalar_squoted (csubstr scalar)
void	set_key_scalar_literal (csubstr scalar)
void	set_val_scalar_literal (csubstr scalar)
void	set_key_scalar_folded (csubstr scalar)
void	set_val_scalar_folded (csubstr scalar)
void	mark_key_scalar_unfiltered ()
void	mark_val_scalar_unfiltered ()
YAML anchor/reference events
void	set_key_anchor (csubstr anchor)
void	set_val_anchor (csubstr anchor)
void	set_key_ref (csubstr ref)
void	set_val_ref (csubstr ref)
YAML tag events
void	set_key_tag (csubstr tag)
void	set_val_tag (csubstr tag)
YAML directive events
void	add_directive (csubstr directive)
YAML arena events
substr	alloc_arena (size_t len)
substr	alloc_arena (size_t len, substr *relocated)

Public Attributes
detail::stack< state >	m_stack
state *	m_curr
	current stack level: top of the stack. cached here for easier access. More...
state *	m_parent
	parent of the current stack level. More...
pfn_relocate_arena	m_relocate_arena
	callback when the arena gets relocated More...
void *	m_relocate_arena_data
csubstr	m_src

Protected Member Functions
void	_stack_start_parse (const char *filename, csubstr ymlsrc, pfn_relocate_arena relocate_arena, void *relocate_arena_data)
void	_stack_finish_parse ()
void	_stack_reset_root ()
void	_stack_reset_non_root ()
void	_stack_push ()
void	_stack_pop ()
bool	_stack_should_push_on_begin_doc () const
bool	_stack_should_pop_on_end_doc () const
void	_stack_relocate_to_new_arena (csubstr prev, substr curr)
substr	_stack_relocate_to_new_arena (csubstr s, csubstr prev, substr curr)

Detailed Description

This event produces standard YAML events as used in the YAML test suite.

See the documentation for Event Handlers, which has important notes about the event model used by rapidyaml.

This class is used only in the CI of this project, and in the application used as part of the standard YAML playground. It is not part of the library and is not installed. *

Definition at line 45 of file event_handler_testsuite.hpp.

Member Typedef Documentation

state

using c4::yml::extra::EventHandlerTestSuite::state = EventHandlerTestSuiteState

Definition at line 52 of file event_handler_testsuite.hpp.

EventSink

using c4::yml::extra::EventHandlerTestSuite::EventSink = extra::string

Definition at line 54 of file event_handler_testsuite.hpp.

pfn_relocate_arena

using c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::pfn_relocate_arena = detail::pfn_relocate_arena

inherited

Definition at line 47 of file event_handler_stack.hpp.

Constructor & Destructor Documentation

EventHandlerTestSuite() [1/4]

c4::yml::extra::EventHandlerTestSuite::EventHandlerTestSuite ( )

inline

Definition at line 82 of file event_handler_testsuite.hpp.

: EventHandlerStack(), m_sink(), m_val_buffers(), m_key_tag_buf(), m_val_tag_buf(), m_tag_directives(), m_has_yaml_directive(), m_arena(), m_has_docs(), m_src() {}

EventHandlerTestSuite() [2/4]

c4::yml::extra::EventHandlerTestSuite::EventHandlerTestSuite ( Callbacks const &  cb )

inline

Definition at line 83 of file event_handler_testsuite.hpp.

: EventHandlerStack(cb), m_sink(), m_val_buffers(), m_key_tag_buf(), m_val_tag_buf(), m_tag_directives(), m_has_yaml_directive(), m_arena(), m_has_docs(), m_src()  {}

EventHandlerTestSuite() [3/4]

c4::yml::extra::EventHandlerTestSuite::EventHandlerTestSuite ( EventSink *  sink, Callbacks const &  cb  )

inline

Definition at line 84 of file event_handler_testsuite.hpp.

                                                                : EventHandlerStack(cb), m_sink(sink), m_val_buffers(), m_key_tag_buf(), m_val_tag_buf(), m_tag_directives(), m_has_yaml_directive(), m_arena(), m_has_docs(), m_src()
    {
        reset();
    }

EventHandlerTestSuite() [4/4]

c4::yml::extra::EventHandlerTestSuite::EventHandlerTestSuite ( EventSink *  sink )

inline

Definition at line 88 of file event_handler_testsuite.hpp.

: EventHandlerTestSuite(sink, get_callbacks()) {}

Member Function Documentation

reset()

void c4::yml::extra::EventHandlerTestSuite::reset ( )

inline

Definition at line 90 of file event_handler_testsuite.hpp.

    {
        _stack_reset_root();
        m_curr->flags |= RUNK|RTOP;
        m_has_yaml_directive = false;
        for(TagDirective &td : m_tag_directives)
            td = {};
        m_val_buffers.clear();
        m_val_buffers.resize((size_t)m_stack.size());
        m_arena.clear();
        m_arena.reserve(1024);
        m_key_tag_buf.resize(256);
        m_val_tag_buf.resize(256);
        m_has_docs = false;
        m_src = {};
    }

References c4::yml::extra::string::clear(), c4::yml::extra::string_vector::clear(), c4::yml::extra::string::reserve(), c4::yml::extra::string::resize(), c4::yml::extra::string_vector::resize(), c4::yml::RTOP, and c4::yml::RUNK.

start_parse()

void c4::yml::extra::EventHandlerTestSuite::start_parse ( const char *  filename, csubstr  src, detail::pfn_relocate_arena  relocate_arena, void *  relocate_arena_data  )

inline

Definition at line 114 of file event_handler_testsuite.hpp.

    {
        this->_stack_start_parse(filename, src, relocate_arena, relocate_arena_data);
    }

finish_parse()

void c4::yml::extra::EventHandlerTestSuite::finish_parse ( )

inline

Definition at line 119 of file event_handler_testsuite.hpp.

    {
        if((_num_tag_directives() || m_has_yaml_directive) && !m_has_docs)
            _RYML_ERR_PARSE_(m_stack.m_callbacks, m_curr->pos, "directives cannot be used without a document");
        this->_stack_finish_parse();
    }

cancel_parse()

void c4::yml::extra::EventHandlerTestSuite::cancel_parse ( )

inline

Definition at line 126 of file event_handler_testsuite.hpp.

    {
        while(m_stack.size() > 1)
            _pop();
        _buf_flush_();
    }

begin_stream()

void c4::yml::extra::EventHandlerTestSuite::begin_stream ( )

inline

Definition at line 140 of file event_handler_testsuite.hpp.

    {
        _send_("+STR\n");
    }

end_stream()

void c4::yml::extra::EventHandlerTestSuite::end_stream ( )

inline

Definition at line 145 of file event_handler_testsuite.hpp.

    {
        _send_("-STR\n");
        _buf_flush_();
    }

begin_doc()

void c4::yml::extra::EventHandlerTestSuite::begin_doc ( )

inline

implicit doc start (without —)

Definition at line 159 of file event_handler_testsuite.hpp.

    {
        _c4dbgp("begin_doc");
        if(_stack_should_push_on_begin_doc())
        {
            _c4dbgp("push!");
            _push();
            _enable_(DOC);
        }
        _send_("+DOC\n");
        m_has_docs = true;
    }

References c4::yml::DOC.

end_doc()

void c4::yml::extra::EventHandlerTestSuite::end_doc ( )

inline

implicit doc end (without ...)

Definition at line 172 of file event_handler_testsuite.hpp.

    {
        _c4dbgp("end_doc");
        _send_("-DOC\n");
        if(_stack_should_pop_on_end_doc())
        {
            _c4dbgp("pop!");
            _pop();
        }
    }

begin_doc_expl()

void c4::yml::extra::EventHandlerTestSuite::begin_doc_expl ( )

inline

explicit doc start, with —

Definition at line 184 of file event_handler_testsuite.hpp.

    {
        _c4dbgp("begin_doc_expl");
        if(_stack_should_push_on_begin_doc())
        {
            _c4dbgp("push!");
            _push();
        }
        _send_("+DOC ---\n");
        _enable_(DOC);
        m_has_docs = true;
    }

References c4::yml::DOC.

end_doc_expl()

void c4::yml::extra::EventHandlerTestSuite::end_doc_expl ( )

inline

explicit doc end, with ...

Definition at line 197 of file event_handler_testsuite.hpp.

    {
        _c4dbgp("end_doc_expl");
        _send_("-DOC ...\n");
        if(_stack_should_pop_on_end_doc())
        {
            _c4dbgp("pop!");
            _pop();
        }
        m_has_yaml_directive = false;
    }

begin_map_key_flow()

void c4::yml::extra::EventHandlerTestSuite::begin_map_key_flow ( )

inline

Definition at line 216 of file event_handler_testsuite.hpp.

    {
        _RYML_CHECK_BASIC_(m_stack.m_callbacks, !_has_any_(VAL));
        _send_("+MAP {}");
        _send_key_props_();
        _send_('\n');
        _mark_parent_with_children_();
        _enable_(MAP|FLOW_SL);
        _push();
    }

References _has_any_, c4::yml::FLOW_SL, c4::yml::MAP, and c4::yml::VAL.

begin_map_key_block()

void c4::yml::extra::EventHandlerTestSuite::begin_map_key_block ( )

inline

Definition at line 226 of file event_handler_testsuite.hpp.

    {
        _RYML_CHECK_BASIC_(m_stack.m_callbacks, !_has_any_(VAL));
        _send_("+MAP");
        _send_key_props_();
        _send_('\n');
        _mark_parent_with_children_();
        _enable_(MAP|BLOCK);
        _push();
    }

References _has_any_, c4::yml::BLOCK, c4::yml::MAP, and c4::yml::VAL.

begin_map_val_flow()

void c4::yml::extra::EventHandlerTestSuite::begin_map_val_flow ( )

inline

Definition at line 237 of file event_handler_testsuite.hpp.

    {
        _RYML_CHECK_BASIC_(m_stack.m_callbacks, !_has_any_(VAL));
        _send_("+MAP {}");
        _send_val_props_();
        _send_('\n');
        _mark_parent_with_children_();
        _enable_(MAP|FLOW_SL);
        _push();
    }

References _has_any_, c4::yml::FLOW_SL, c4::yml::MAP, and c4::yml::VAL.

begin_map_val_block()

void c4::yml::extra::EventHandlerTestSuite::begin_map_val_block ( )

inline

Definition at line 247 of file event_handler_testsuite.hpp.

    {
        _RYML_CHECK_BASIC_(m_stack.m_callbacks, !_has_any_(VAL));
        _send_("+MAP");
        _send_val_props_();
        _send_('\n');
        _mark_parent_with_children_();
        _enable_(MAP|BLOCK);
        _push();
    }

References _has_any_, c4::yml::BLOCK, c4::yml::MAP, and c4::yml::VAL.

end_map_block()

void c4::yml::extra::EventHandlerTestSuite::end_map_block ( )

inline

Definition at line 258 of file event_handler_testsuite.hpp.

    {
        _pop();
        _send_("-MAP\n");
    }

end_map_flow()

void c4::yml::extra::EventHandlerTestSuite::end_map_flow ( bool  )

inline

Definition at line 264 of file event_handler_testsuite.hpp.

    {
        _pop();
        _send_("-MAP\n");
    }

begin_seq_key_flow()

void c4::yml::extra::EventHandlerTestSuite::begin_seq_key_flow ( )

inline

Definition at line 277 of file event_handler_testsuite.hpp.

    {
        _RYML_CHECK_BASIC_(m_stack.m_callbacks, !_has_any_(VAL));
        _send_("+SEQ []");
        _send_key_props_();
        _send_('\n');
        _mark_parent_with_children_();
        _enable_(SEQ|FLOW_SL);
        _push();
    }

References _has_any_, c4::yml::FLOW_SL, c4::yml::SEQ, and c4::yml::VAL.

begin_seq_key_block()

void c4::yml::extra::EventHandlerTestSuite::begin_seq_key_block ( )

inline

Definition at line 287 of file event_handler_testsuite.hpp.

    {
        _RYML_CHECK_BASIC_(m_stack.m_callbacks, !_has_any_(VAL));
        _send_("+SEQ");
        _send_key_props_();
        _send_('\n');
        _mark_parent_with_children_();
        _enable_(SEQ|BLOCK);
        _push();
    }

References _has_any_, c4::yml::BLOCK, c4::yml::SEQ, and c4::yml::VAL.

begin_seq_val_flow()

void c4::yml::extra::EventHandlerTestSuite::begin_seq_val_flow ( )

inline

Definition at line 298 of file event_handler_testsuite.hpp.

    {
        _RYML_CHECK_BASIC_(m_stack.m_callbacks, !_has_any_(VAL));
        _send_("+SEQ []");
        _send_val_props_();
        _send_('\n');
        _mark_parent_with_children_();
        _enable_(SEQ|FLOW_SL);
        _push();
    }

References _has_any_, c4::yml::FLOW_SL, c4::yml::SEQ, and c4::yml::VAL.

begin_seq_val_block()

void c4::yml::extra::EventHandlerTestSuite::begin_seq_val_block ( )

inline

Definition at line 308 of file event_handler_testsuite.hpp.

    {
        _RYML_CHECK_BASIC_(m_stack.m_callbacks, !_has_any_(VAL));
        _send_("+SEQ");
        _send_val_props_();
        _send_('\n');
        _mark_parent_with_children_();
        _enable_(SEQ|BLOCK);
        _push();
    }

References _has_any_, c4::yml::BLOCK, c4::yml::SEQ, and c4::yml::VAL.

end_seq_block()

void c4::yml::extra::EventHandlerTestSuite::end_seq_block ( )

inline

Definition at line 319 of file event_handler_testsuite.hpp.

    {
        _pop();
        _send_("-SEQ\n");
    }

end_seq_flow()

void c4::yml::extra::EventHandlerTestSuite::end_seq_flow ( bool  )

inline

Definition at line 325 of file event_handler_testsuite.hpp.

    {
        _pop();
        _send_("-SEQ\n");
    }

add_sibling()

void c4::yml::extra::EventHandlerTestSuite::add_sibling ( )

inline

Definition at line 338 of file event_handler_testsuite.hpp.

    {
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, m_parent);
        _buf_flush_to_(m_curr->level, m_parent->level);
        m_curr->ev_data = {};
    }

actually_val_is_first_key_of_new_map_flow()

void c4::yml::extra::EventHandlerTestSuite::actually_val_is_first_key_of_new_map_flow ( )

inline

set the previous val as the first key of a new map, with flow style.

See the documentation for Event Handlers, which has important notes about this event.

Definition at line 350 of file event_handler_testsuite.hpp.

    {
        // ensure we have a temporary buffer to save the current val
        const id_type tmp = m_curr->level + id_type(2);
        _buf_ensure_(tmp + id_type(2));
        // save the current val to the temporary buffer
        _buf_flush_to_(m_curr->level, tmp);
        _disable_(_VALMASK|VAL_STYLE);
        // create the map.
        // this will push a new level, and tmp is one further
        begin_map_val_flow();
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, tmp != m_curr->level);
        // now move the saved val as the first key
        _buf_flush_to_(tmp, m_curr->level);
    }

References c4::yml::_VALMASK, and c4::yml::VAL_STYLE.

actually_val_is_first_key_of_new_map_block()

void c4::yml::extra::EventHandlerTestSuite::actually_val_is_first_key_of_new_map_block ( )

inline

like its flow counterpart, but this function can only be called after the end of a flow-val at root or doc level.

See the documentation for Event Handlers, which has important notes about this event.

Definition at line 372 of file event_handler_testsuite.hpp.

    {
        EventSink &sink = _buf_();
        substr full = sink;(void)full;
        // interpolate +MAP\n after the last +DOC\n
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, full.len);
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, !full.count('\r'));
        size_t docpos = sink.find_last("+DOC\n");
        if(docpos != npos)
        {
            _RYML_ASSERT_BASIC_(m_stack.m_callbacks, (m_stack.size() == 1u) ? (docpos >= 5u) : (docpos == 0u));
            _RYML_ASSERT_BASIC_(m_stack.m_callbacks, docpos + 5u < full.len);
            sink.insert("+MAP\n", docpos + 5u);
        }
        else
        {
            // ... or interpolate +MAP\n after the last +DOC ---\n
            docpos = sink.find_last("+DOC ---\n");
            _RYML_ASSERT_BASIC_(m_stack.m_callbacks, docpos != npos);
            _RYML_ASSERT_BASIC_(m_stack.m_callbacks, (m_stack.size() == 1u) ? (docpos >= 5u) : (docpos == 0u));
            _RYML_ASSERT_BASIC_(m_stack.m_callbacks, docpos + 9u < full.len);
            sink.insert("+MAP\n", docpos + 9u);
        }
        _push();
    }

References c4::yml::extra::string::find_last(), c4::yml::extra::string::insert(), and c4::yml::npos.

set_key_scalar_plain_empty()

void c4::yml::extra::EventHandlerTestSuite::set_key_scalar_plain_empty ( )

inlinenoexcept

Definition at line 406 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set key scalar plain as empty", m_curr->node_id);
        _send_key_scalar_({}, ':');
        _enable_(KEY|KEY_PLAIN|KEYNIL);
    }

References c4::yml::KEY, c4::yml::KEY_PLAIN, and c4::yml::KEYNIL.

set_val_scalar_plain_empty()

void c4::yml::extra::EventHandlerTestSuite::set_val_scalar_plain_empty ( )

inlinenoexcept

Definition at line 412 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set val scalar plain as empty", m_curr->node_id);
        _send_val_scalar_({}, ':');
        _enable_(VAL|VAL_PLAIN|VALNIL);
    }

References c4::yml::VAL, c4::yml::VAL_PLAIN, and c4::yml::VALNIL.

set_key_scalar_plain()

void c4::yml::extra::EventHandlerTestSuite::set_key_scalar_plain ( csubstr  scalar )

inline

Definition at line 419 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set key scalar plain: [{}]~~~{}~~~", m_curr->node_id, scalar.len, scalar);
        _send_key_scalar_(scalar, ':');
        _enable_(KEY|KEY_PLAIN);
    }

References c4::yml::KEY, and c4::yml::KEY_PLAIN.

set_val_scalar_plain()

void c4::yml::extra::EventHandlerTestSuite::set_val_scalar_plain ( csubstr  scalar )

inline

Definition at line 425 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set val scalar plain: [{}]~~~{}~~~", m_curr->node_id, scalar.len, scalar);
        _send_val_scalar_(scalar, ':');
        _enable_(VAL|VAL_PLAIN);
    }

References c4::yml::VAL, and c4::yml::VAL_PLAIN.

set_key_scalar_dquoted()

void c4::yml::extra::EventHandlerTestSuite::set_key_scalar_dquoted ( csubstr  scalar )

inline

Definition at line 433 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set key scalar dquot: [{}]~~~{}~~~", m_curr->node_id, scalar.len, scalar);
        _send_key_scalar_(scalar, '"');
        _enable_(KEY|KEY_DQUO);
    }

References c4::yml::KEY, and c4::yml::KEY_DQUO.

set_val_scalar_dquoted()

void c4::yml::extra::EventHandlerTestSuite::set_val_scalar_dquoted ( csubstr  scalar )

inline

Definition at line 439 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set val scalar dquot: [{}]~~~{}~~~", m_curr->node_id, scalar.len, scalar);
        _send_val_scalar_(scalar, '"');
        _enable_(VAL|VAL_DQUO);
    }

References c4::yml::VAL, and c4::yml::VAL_DQUO.

set_key_scalar_squoted()

void c4::yml::extra::EventHandlerTestSuite::set_key_scalar_squoted ( csubstr  scalar )

inline

Definition at line 447 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set key scalar squot: [{}]~~~{}~~~", m_curr->node_id, scalar.len, scalar);
        _send_key_scalar_(scalar, '\'');
        _enable_(KEY|KEY_SQUO);
    }

References c4::yml::KEY, and c4::yml::KEY_SQUO.

set_val_scalar_squoted()

void c4::yml::extra::EventHandlerTestSuite::set_val_scalar_squoted ( csubstr  scalar )

inline

Definition at line 453 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set val scalar squot: [{}]~~~{}~~~", m_curr->node_id, scalar.len, scalar);
        _send_val_scalar_(scalar, '\'');
        _enable_(VAL|VAL_SQUO);
    }

References c4::yml::VAL, and c4::yml::VAL_SQUO.

set_key_scalar_literal()

void c4::yml::extra::EventHandlerTestSuite::set_key_scalar_literal ( csubstr  scalar )

inline

Definition at line 461 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set key scalar literal: [{}]~~~{}~~~", m_curr->node_id, scalar.len, scalar);
        _send_key_scalar_(scalar, '|');
        _enable_(KEY|KEY_LITERAL);
    }

References c4::yml::KEY, and c4::yml::KEY_LITERAL.

set_val_scalar_literal()

void c4::yml::extra::EventHandlerTestSuite::set_val_scalar_literal ( csubstr  scalar )

inline

Definition at line 467 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set val scalar literal: [{}]~~~{}~~~", m_curr->node_id, scalar.len, scalar);
        _send_val_scalar_(scalar, '|');
        _enable_(VAL|VAL_LITERAL);
    }

References c4::yml::VAL, and c4::yml::VAL_LITERAL.

set_key_scalar_folded()

void c4::yml::extra::EventHandlerTestSuite::set_key_scalar_folded ( csubstr  scalar )

inline

Definition at line 475 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set key scalar folded: [{}]~~~{}~~~", m_curr->node_id, scalar.len, scalar);
        _send_key_scalar_(scalar, '>');
        _enable_(KEY|KEY_FOLDED);
    }

References c4::yml::KEY, and c4::yml::KEY_FOLDED.

set_val_scalar_folded()

void c4::yml::extra::EventHandlerTestSuite::set_val_scalar_folded ( csubstr  scalar )

inline

Definition at line 481 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set val scalar folded: [{}]~~~{}~~~", m_curr->node_id, scalar.len, scalar);
        _send_val_scalar_(scalar, '>');
        _enable_(VAL|VAL_FOLDED);
    }

References c4::yml::VAL, and c4::yml::VAL_FOLDED.

mark_key_scalar_unfiltered()

void c4::yml::extra::EventHandlerTestSuite::mark_key_scalar_unfiltered ( )

inline

Definition at line 489 of file event_handler_testsuite.hpp.

    {
        // nothing to do here
    }

mark_val_scalar_unfiltered()

void c4::yml::extra::EventHandlerTestSuite::mark_val_scalar_unfiltered ( )

inline

Definition at line 493 of file event_handler_testsuite.hpp.

    {
        // nothing to do here
    }

set_key_anchor()

void c4::yml::extra::EventHandlerTestSuite::set_key_anchor ( csubstr  anchor )

inline

Definition at line 505 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set key anchor: [{}]~~~{}~~~", m_curr->node_id, anchor.len, anchor);
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, !_has_any_(KEYREF));
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, !anchor.begins_with('&'));
        _enable_(KEYANCH);
        m_curr->ev_data.m_key.anchor = anchor;
    }

References _has_any_, c4::yml::KEYANCH, and c4::yml::KEYREF.

set_val_anchor()

void c4::yml::extra::EventHandlerTestSuite::set_val_anchor ( csubstr  anchor )

inline

Definition at line 513 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set val anchor: [{}]~~~{}~~~", m_curr->node_id, anchor.len, anchor);
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, !_has_any_(VALREF));
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, !anchor.begins_with('&'));
        _enable_(VALANCH);
        m_curr->ev_data.m_val.anchor = anchor;
    }

References _has_any_, c4::yml::VALANCH, and c4::yml::VALREF.

set_key_ref()

void c4::yml::extra::EventHandlerTestSuite::set_key_ref ( csubstr  ref )

inline

Definition at line 522 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set key ref: [{}]~~~{}~~~", m_curr->node_id, ref.len, ref);
        if(C4_UNLIKELY(_has_any_(KEYANCH)))
            _RYML_ERR_PARSE_(m_stack.m_callbacks, m_curr->pos, "key cannot have both anchor and ref");
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, ref.begins_with('*'));
        _enable_(KEY|KEYREF);
        _send_("=ALI ");
        _send_(ref);
        _send_('\n');
    }

References _has_any_, c4::yml::KEY, c4::yml::KEYANCH, and c4::yml::KEYREF.

set_val_ref()

void c4::yml::extra::EventHandlerTestSuite::set_val_ref ( csubstr  ref )

inline

Definition at line 533 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set val ref: [{}]~~~{}~~~", m_curr->node_id, ref.len, ref);
        if(C4_UNLIKELY(_has_any_(VALANCH)))
            _RYML_ERR_PARSE_(m_stack.m_callbacks, m_curr->pos, "val cannot have both anchor and ref");
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, ref.begins_with('*'));
        _enable_(VAL|VALREF);
        _send_("=ALI ");
        _send_(ref);
        _send_('\n');
    }

References _has_any_, c4::yml::VAL, c4::yml::VALANCH, and c4::yml::VALREF.

set_key_tag()

void c4::yml::extra::EventHandlerTestSuite::set_key_tag ( csubstr  tag )

inline

Definition at line 552 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set key tag: [{}]~~~{}~~~", m_curr->node_id, tag.len, tag);
        _enable_(KEYTAG);
        m_curr->ev_data.m_key.tag = _transform_directive(tag, &m_key_tag_buf);
    }

References c4::yml::KEYTAG.

set_val_tag()

void c4::yml::extra::EventHandlerTestSuite::set_val_tag ( csubstr  tag )

inline

Definition at line 558 of file event_handler_testsuite.hpp.

    {
        _c4dbgpf("node[{}]: set val tag: [{}]~~~{}~~~", m_curr->node_id, tag.len, tag);
        _enable_(VALTAG);
        m_curr->ev_data.m_val.tag = _transform_directive(tag, &m_val_tag_buf);
    }

References c4::yml::VALTAG.

add_directive()

void c4::yml::extra::EventHandlerTestSuite::add_directive ( csubstr  directive )

inline

Definition at line 572 of file event_handler_testsuite.hpp.

    {
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, directive.begins_with('%'));
        if(directive.begins_with("%TAG"))
        {
            const id_type pos = _num_tag_directives();
            if(C4_UNLIKELY(pos >= RYML_MAX_TAG_DIRECTIVES))
                _RYML_ERR_PARSE_(m_stack.m_callbacks, m_curr->pos, "too many directives");
            if(C4_UNLIKELY(!m_tag_directives[pos].create_from_str(directive)))
                _RYML_ERR_PARSE_(m_stack.m_callbacks, m_curr->pos, "failed to add directive");
        }
        else if(directive.begins_with("%YAML"))
        {
            _c4dbgpf("%YAML directive! ignoring...: {}", directive);
            if(C4_UNLIKELY(m_has_yaml_directive))
                _RYML_ERR_PARSE_(m_stack.m_callbacks, m_curr->pos, "multiple yaml directives");
            m_has_yaml_directive = true;
        }
        else
        {
            _c4dbgpf("unknown directive! ignoring... {}", directive);
        }
    }

References RYML_MAX_TAG_DIRECTIVES.

alloc_arena() [1/2]

substr c4::yml::extra::EventHandlerTestSuite::alloc_arena ( size_t  len )

inline

Definition at line 603 of file event_handler_testsuite.hpp.

    {
        const size_t sz = m_arena.size();
        csubstr prev = m_arena;
        m_arena.resize(sz + len);
        substr out = to_substr(m_arena).sub(sz);
        substr curr = to_substr(m_arena);
        if(curr.str != prev.str)
            _stack_relocate_to_new_arena(prev, curr);
        return out;
    }

References c4::yml::extra::string::resize(), c4::yml::extra::string::size(), and c4::to_substr().

alloc_arena() [2/2]

substr c4::yml::extra::EventHandlerTestSuite::alloc_arena ( size_t  len, substr *  relocated  )

inline

Definition at line 615 of file event_handler_testsuite.hpp.

    {
        csubstr prev = m_arena;
        if(!prev.is_super(*relocated))
            return alloc_arena(len);
        substr out = alloc_arena(len);
        substr curr = to_substr(m_arena);
        if(curr.str != prev.str)
            *relocated = _stack_relocate_to_new_arena(*relocated, prev, curr);
        return out;
    }

References c4::to_substr().

_stack_start_parse()

void c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::_stack_start_parse ( const char *  filename, csubstr  ymlsrc, pfn_relocate_arena  relocate_arena, void *  relocate_arena_data  )

inlineprotectedinherited

Definition at line 65 of file event_handler_stack.hpp.

    {
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, m_curr != nullptr);
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, relocate_arena != nullptr);
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, relocate_arena_data != nullptr);
        m_curr->start_parse(filename, m_curr->node_id);
        m_relocate_arena = relocate_arena;
        m_relocate_arena_data = relocate_arena_data;
        m_src = ymlsrc;
    }

_stack_finish_parse()

void c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::_stack_finish_parse ( )

inlineprotectedinherited

Definition at line 76 of file event_handler_stack.hpp.

    {
        m_src = {};
    }

_stack_reset_root()

void c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::_stack_reset_root ( )

inlineprotectedinherited

Definition at line 83 of file event_handler_stack.hpp.

    {
        m_stack.clear();
        m_stack.push({});
        m_parent = nullptr;
        m_curr = &m_stack.top();
    }

_stack_reset_non_root()

void c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::_stack_reset_non_root ( )

inlineprotectedinherited

Definition at line 91 of file event_handler_stack.hpp.

    {
        m_stack.clear();
        m_stack.push({}); // parent
        m_stack.push({}); // node
        m_parent = &m_stack.top(1);
        m_curr = &m_stack.top();
    }

_stack_push()

void c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::_stack_push ( )

inlineprotectedinherited

Definition at line 100 of file event_handler_stack.hpp.

    {
        m_stack.push_top();
        m_parent = &m_stack.top(1); // don't use m_curr. watch out for relocations inside the prev push
        m_curr = &m_stack.top();
        m_curr->reset_after_push();
    }

_stack_pop()

void c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::_stack_pop ( )

inlineprotectedinherited

Definition at line 108 of file event_handler_stack.hpp.

    {
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, m_parent);
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, m_stack.size() > 1);
        m_parent->reset_before_pop(*m_curr);
        m_stack.pop();
        m_parent = m_stack.size() > 1 ? &m_stack.top(1) : nullptr;
        m_curr = &m_stack.top();
        #ifdef RYML_DBG
        if(m_parent)
            _c4dbgpf("popped! top is now node={} (parent={})", m_curr->node_id, m_parent->node_id);
        else
            _c4dbgpf("popped! top is now node={} @ ROOT", m_curr->node_id);
        #endif
    }

_stack_should_push_on_begin_doc()

bool c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::_stack_should_push_on_begin_doc ( ) const

inlineprotectedinherited

Definition at line 129 of file event_handler_stack.hpp.

    {
        const bool is_root = (m_stack.size() == 1u);
        return is_root && (_has_any_(DOC|VAL|MAP|SEQ) || m_curr->has_children);
    }

_stack_should_pop_on_end_doc()

bool c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::_stack_should_pop_on_end_doc ( ) const

inlineprotectedinherited

Definition at line 135 of file event_handler_stack.hpp.

    {
        const bool is_root = (m_stack.size() == 1u);
        return !is_root && _has_any_(DOC);
    }

_stack_relocate_to_new_arena() [1/2]

void c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::_stack_relocate_to_new_arena ( csubstr  prev, substr  curr  )

inlineprotectedinherited

Definition at line 143 of file event_handler_stack.hpp.

    {
        for(state &st : m_stack)
        {
            if(st.line_contents.rem.is_sub(prev))
                st.line_contents.rem = _stack_relocate_to_new_arena(st.line_contents.rem, prev, curr);
            if(st.line_contents.full.is_sub(prev))
                st.line_contents.full = _stack_relocate_to_new_arena(st.line_contents.full, prev, curr);
        }
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, m_relocate_arena != nullptr);
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, m_relocate_arena_data != nullptr);
        m_relocate_arena(m_relocate_arena_data, prev, curr);
    }

_stack_relocate_to_new_arena() [2/2]

substr c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::_stack_relocate_to_new_arena ( csubstr  s, csubstr  prev, substr  curr  )

inlineprotectedinherited

Definition at line 157 of file event_handler_stack.hpp.

    {
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, prev.is_super(s));
        auto pos = s.str - prev.str;
        substr out = {curr.str + pos, s.len};
        _RYML_ASSERT_BASIC_(m_stack.m_callbacks, curr.is_super(out));
        return out;
    }

check_trailing_doc_token()

void c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::check_trailing_doc_token ( ) const

inlineinherited

Check whether the current parse tokens are trailing on the previous doc, and raise an error if they are.

This function is called by the parse engine (not the event handler) before a doc is started.

Definition at line 172 of file event_handler_stack.hpp.

    {
        const bool is_root = (m_stack.size() == 1u);
        const bool isndoc = (m_curr->flags & NDOC) != 0;
        const bool suspicious = _has_any_(MAP|SEQ|VAL);
        _c4dbgpf("target={} isroot={} suspicious={} ndoc={}", m_curr->node_id, is_root, suspicious, isndoc);
        if((is_root || _has_any_(DOC)) && suspicious && !isndoc)
            _RYML_ERR_PARSE_(m_stack.m_callbacks, m_curr->pos, "parse error");
    }

Member Data Documentation

m_stack

detail::stack<state> c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::m_stack

inherited

Definition at line 51 of file event_handler_stack.hpp.

m_curr

state* c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::m_curr

inherited

current stack level: top of the stack. cached here for easier access.

Definition at line 52 of file event_handler_stack.hpp.

m_parent

state* c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::m_parent

inherited

parent of the current stack level.

Definition at line 53 of file event_handler_stack.hpp.

m_relocate_arena

pfn_relocate_arena c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::m_relocate_arena

inherited

callback when the arena gets relocated

Definition at line 54 of file event_handler_stack.hpp.

m_relocate_arena_data

void* c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::m_relocate_arena_data

inherited

Definition at line 55 of file event_handler_stack.hpp.

m_src

csubstr c4::yml::EventHandlerStack< EventHandlerTestSuite , EventHandlerTestSuiteState >::m_src

inherited

Definition at line 56 of file event_handler_stack.hpp.

---

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

• /home/docs/checkouts/readthedocs.org/user_builds/rapidyaml/checkouts/v0.11.0/src_extra/c4/yml/extra/event_handler_testsuite.hpp