Emit from nested node id

Functions
template<class CharOwningContainer >
substr	c4::yml::emitrs_yaml (Tree const &t, id_type id, EmitOptions const &opts, CharOwningContainer *cont, bool append=false)
	(1) emit+resize: emit YAML to the given std::string/std::vector<char>-like container, resizing it as needed to fit the emitted YAML. More...
template<class CharOwningContainer >
substr	c4::yml::emitrs_yaml (Tree const &t, id_type id, CharOwningContainer *cont, bool append=false)
	(2) like (1), but use default emit options More...
template<class CharOwningContainer >
substr	c4::yml::emitrs_json (Tree const &t, id_type id, EmitOptions const &opts, CharOwningContainer *cont, bool append=false)
	(1) emit+resize: emit JSON to the given std::string/std::vector<char>-like container, resizing it as needed to fit the emitted JSON. More...
template<class CharOwningContainer >
substr	c4::yml::emitrs_json (Tree const &t, id_type id, CharOwningContainer *cont, bool append=false)
	(2) like (1), but use default emit options More...
template<class CharOwningContainer >
CharOwningContainer	c4::yml::emitrs_yaml (Tree const &t, id_type id, EmitOptions const &opts={})
	(3) emit+resize: YAML to a newly-created std::string/std::vector<char>-like container. More...
template<class CharOwningContainer >
CharOwningContainer	c4::yml::emitrs_json (Tree const &t, id_type id, EmitOptions const &opts={})
	(3) emit+resize: JSON to a newly-created std::string/std::vector<char>-like container. More...

Detailed Description

Function Documentation

template<class CharOwningContainer >

substr c4::yml::emitrs_yaml	(	Tree const &	t,
		id_type	id,
		EmitOptions const &	opts,
		CharOwningContainer *	cont,
		bool	append = false
	)

(1) emit+resize: emit YAML to the given std::string/std::vector<char>-like container, resizing it as needed to fit the emitted YAML.

If append is set to true, the emitted YAML is appended at the end of the container.

Returns

a substr trimmed to the emitted YAML (excluding the initial contents, when appending)

Definition at line 35 of file emit_container.hpp.

Referenced by c4::yml::emitrs_yaml(), and sample_emit_to_container().

{
    const size_t startpos = append ? cont->size() : 0u;
    cont->resize(cont->capacity()); // otherwise the first emit would be certain to fail
    substr buf = to_substr(*cont).sub(startpos);
    substr ret = emit_yaml(t, id, opts, buf, /*error_on_excess*/false);
    cont->resize(startpos + ret.len);
    if(ret.len && !ret.str)
    {
        buf = to_substr(*cont).sub(startpos);
        ret = emit_yaml(t, id, opts, buf, /*error_on_excess*/true);
    }
    return ret;
}

template<class CharOwningContainer >

substr c4::yml::emitrs_yaml	(	Tree const &	t,
		id_type	id,
		CharOwningContainer *	cont,
		bool	append = false
	)

(2) like (1), but use default emit options

Definition at line 51 of file emit_container.hpp.

{
    return emitrs_yaml(t, id, EmitOptions{}, cont, append);
}

template<class CharOwningContainer >

substr c4::yml::emitrs_json	(	Tree const &	t,
		id_type	id,
		EmitOptions const &	opts,
		CharOwningContainer *	cont,
		bool	append = false
	)

(1) emit+resize: emit JSON to the given std::string/std::vector<char>-like container, resizing it as needed to fit the emitted JSON.

If append is set to true, the emitted YAML is appended at the end of the container.

Returns

a substr trimmed to the emitted JSON (excluding the initial contents, when appending)

Definition at line 63 of file emit_container.hpp.

Referenced by c4::yml::emitrs_json().

{
    const size_t startpos = append ? cont->size() : 0u;
    cont->resize(cont->capacity()); // otherwise the first emit would be certain to fail
    substr buf = to_substr(*cont).sub(startpos);
    substr ret = emit_json(t, id, opts, buf, /*error_on_excess*/false);
    cont->resize(startpos + ret.len);
    if(ret.len && !ret.str)
    {
        buf = to_substr(*cont).sub(startpos);
        ret = emit_json(t, id, opts, buf, /*error_on_excess*/true);
    }
    return ret;
}

template<class CharOwningContainer >

substr c4::yml::emitrs_json	(	Tree const &	t,
		id_type	id,
		CharOwningContainer *	cont,
		bool	append = false
	)

(2) like (1), but use default emit options

Definition at line 79 of file emit_container.hpp.

{
    return emitrs_json(t, id, EmitOptions{}, cont, append);
}

template<class CharOwningContainer >

CharOwningContainer c4::yml::emitrs_yaml	(	Tree const &	t,
		id_type	id,
		EmitOptions const &	opts = {}
	)

(3) emit+resize: YAML to a newly-created std::string/std::vector<char>-like container.

Definition at line 87 of file emit_container.hpp.

                                                                                   {})
{
    CharOwningContainer c;
    emitrs_yaml(t, id, opts, &c);
    return c;
}

template<class CharOwningContainer >

CharOwningContainer c4::yml::emitrs_json	(	Tree const &	t,
		id_type	id,
		EmitOptions const &	opts = {}
	)

(3) emit+resize: JSON to a newly-created std::string/std::vector<char>-like container.

Definition at line 95 of file emit_container.hpp.

                                                                                   {})
{
    CharOwningContainer c;
    emitrs_json(t, id, opts, &c);
    return c;
}