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.
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
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.
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
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.
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.

Detailed Description

Function Documentation

emitrs_yaml() [1/3]

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.

{
    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;
}

emitrs_yaml() [2/3]

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);
}

emitrs_json() [1/3]

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.

{
    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;
}

emitrs_json() [2/3]

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);
}

emitrs_yaml() [3/3]

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;
}

emitrs_json() [3/3]

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;
}