Emit to resizeable container

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

Detailed Description

Function Documentation

emitrs_yaml() [1/9]

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-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 764 of file emit.hpp.

{
    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);
    if(ret.str == nullptr && ret.len > 0)
    {
        cont->resize(startpos + ret.len);
        buf = to_substr(*cont).sub(startpos);
        ret = emit_yaml(t, id, opts, buf, /*error_on_excess*/true);
    }
    else
    {
        cont->resize(startpos + ret.len);
    }
    return ret;
}

References c4::yml::emit_yaml(), and c4::to_substr().

emitrs_yaml() [2/9]

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 784 of file emit.hpp.

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

References c4::yml::emitrs_yaml().

emitrs_json() [1/9]

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-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 794 of file emit.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);
    EmitterBuf em(opts, buf);
    substr ret = emit_json(t, id, opts, buf, /*error_on_excess*/false);
    if(ret.str == nullptr && ret.len > 0)
    {
        cont->resize(startpos + ret.len);
        buf = to_substr(*cont).sub(startpos);
        ret = emit_json(t, id, opts, buf, /*error_on_excess*/true);
    }
    else
    {
        cont->resize(startpos + ret.len);
    }
    return ret;
}

References c4::yml::emit_json(), and c4::to_substr().

emitrs_json() [2/9]

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 815 of file emit.hpp.

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

References c4::yml::emitrs_json().

emitrs_yaml() [3/9]

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

Definition at line 823 of file emit.hpp.

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

emitrs_json() [3/9]

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

Definition at line 831 of file emit.hpp.

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

emitrs_yaml() [4/9]

template<class CharOwningContainer >

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

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

Returns

a substr trimmed to the new emitted contents.

Definition at line 845 of file emit.hpp.

{
    if(t.empty())
        return {};
    return emitrs_yaml(t, t.root_id(), opts, cont, append);
}

References c4::yml::emitrs_yaml(), c4::yml::Tree::empty(), and c4::yml::Tree::root_id().

emitrs_yaml() [5/9]

template<class CharOwningContainer >

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

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

Definition at line 853 of file emit.hpp.

{
    if(t.empty())
        return {};
    return emitrs_yaml(t, t.root_id(), EmitOptions{}, cont, append);
}

References c4::yml::emitrs_yaml(), c4::yml::Tree::empty(), and c4::yml::Tree::root_id().

emitrs_json() [4/9]

template<class CharOwningContainer >

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

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

Returns

a substr trimmed to the new emitted contents.

Definition at line 863 of file emit.hpp.

{
    if(t.empty())
        return {};
    return emitrs_json(t, t.root_id(), opts, cont, append);
}

References c4::yml::emitrs_json(), c4::yml::Tree::empty(), and c4::yml::Tree::root_id().

emitrs_json() [5/9]

template<class CharOwningContainer >

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

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

Definition at line 871 of file emit.hpp.

{
    if(t.empty())
        return {};
    return emitrs_json(t, t.root_id(), EmitOptions{}, cont, append);
}

References c4::yml::emitrs_json(), c4::yml::Tree::empty(), and c4::yml::Tree::root_id().

emitrs_yaml() [6/9]

template<class CharOwningContainer >

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

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

Definition at line 881 of file emit.hpp.

                                                                       {})
{
    CharOwningContainer c;
    if(t.empty())
        return c;
    emitrs_yaml(t, t.root_id(), opts, &c);
    return c;
}

emitrs_json() [6/9]

template<class CharOwningContainer >

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

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

Definition at line 891 of file emit.hpp.

                                                                       {})
{
    CharOwningContainer c;
    if(t.empty())
        return c;
    emitrs_json(t, t.root_id(), opts, &c);
    return c;
}

emitrs_yaml() [7/9]

template<class CharOwningContainer >

substr c4::yml::emitrs_yaml	(	ConstNodeRef const &	n,
		EmitOptions const &	opts,
		CharOwningContainer *	cont,
		bool	append = false
	)

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

Returns

a substr trimmed to the new emitted contents

Definition at line 908 of file emit.hpp.

{
    if(!n.readable())
        return {};
    return emitrs_yaml(*n.tree(), n.id(), opts, cont, append);
}

References c4::yml::emitrs_yaml(), c4::yml::ConstNodeRef::id(), c4::yml::ConstNodeRef::readable(), and c4::yml::ConstNodeRef::tree().

emitrs_yaml() [8/9]

template<class CharOwningContainer >

substr c4::yml::emitrs_yaml	(	ConstNodeRef const &	n,
		CharOwningContainer *	cont,
		bool	append = false
	)

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

Definition at line 916 of file emit.hpp.

{
    if(!n.readable())
        return {};
    return emitrs_yaml(*n.tree(), n.id(), EmitOptions{}, cont, append);
}

References c4::yml::emitrs_yaml(), c4::yml::ConstNodeRef::id(), c4::yml::ConstNodeRef::readable(), and c4::yml::ConstNodeRef::tree().

emitrs_json() [7/9]

template<class CharOwningContainer >

substr c4::yml::emitrs_json	(	ConstNodeRef const &	n,
		EmitOptions const &	opts,
		CharOwningContainer *	cont,
		bool	append = false
	)

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

Returns

a substr trimmed to the new emitted contents

Definition at line 926 of file emit.hpp.

{
    if(!n.readable())
        return {};
    return emitrs_json(*n.tree(), n.id(), opts, cont, append);
}

References c4::yml::emitrs_json(), c4::yml::ConstNodeRef::id(), c4::yml::ConstNodeRef::readable(), and c4::yml::ConstNodeRef::tree().

emitrs_json() [8/9]

template<class CharOwningContainer >

substr c4::yml::emitrs_json	(	ConstNodeRef const &	n,
		CharOwningContainer *	cont,
		bool	append = false
	)

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

Definition at line 934 of file emit.hpp.

{
    if(!n.readable())
        return {};
    return emitrs_json(*n.tree(), n.id(), EmitOptions{}, cont, append);
}

References c4::yml::emitrs_json(), c4::yml::ConstNodeRef::id(), c4::yml::ConstNodeRef::readable(), and c4::yml::ConstNodeRef::tree().

emitrs_yaml() [9/9]

template<class CharOwningContainer >

CharOwningContainer c4::yml::emitrs_yaml	(	ConstNodeRef const &	n,
		EmitOptions const &	opts = {}
	)

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

Definition at line 944 of file emit.hpp.

                                                                               {})
{
    if(!n.readable())
        return {};
    CharOwningContainer c;
    emitrs_yaml(*n.tree(), n.id(), opts, &c);
    return c;
}

emitrs_json() [9/9]

template<class CharOwningContainer >

CharOwningContainer c4::yml::emitrs_json	(	ConstNodeRef const &	n,
		EmitOptions const &	opts = {}
	)

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

Definition at line 954 of file emit.hpp.

                                                                               {})
{
    if(!n.readable())
        return {};
    CharOwningContainer c;
    emitrs_json(*n.tree(), n.id(), opts, &c);
    return c;
}