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 606 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().

Referenced by sample::sample_emit_to_container().

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 626 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 636 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 657 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 665 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 673 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 687 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 695 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 705 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 713 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 723 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 733 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 750 of file emit.hpp.

{
    if(!detail::is_set_(n))
        return {};
    _RYML_CB_CHECK(n.tree()->callbacks(), n.readable());
    return emitrs_yaml(*n.tree(), n.id(), opts, cont, append);
}

References c4::yml::Tree::callbacks(), c4::yml::emitrs_yaml(), c4::yml::ConstNodeRef::id(), c4::yml::detail::is_set_(), 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 759 of file emit.hpp.

{
    if(!detail::is_set_(n))
        return {};
    _RYML_CB_CHECK(n.tree()->callbacks(), n.readable());
    return emitrs_yaml(*n.tree(), n.id(), EmitOptions{}, cont, append);
}

References c4::yml::Tree::callbacks(), c4::yml::emitrs_yaml(), c4::yml::ConstNodeRef::id(), c4::yml::detail::is_set_(), 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 770 of file emit.hpp.

{
    if(!detail::is_set_(n))
        return {};
    _RYML_CB_CHECK(n.tree()->callbacks(), n.readable());
    return emitrs_json(*n.tree(), n.id(), opts, cont, append);
}

References c4::yml::Tree::callbacks(), c4::yml::emitrs_json(), c4::yml::ConstNodeRef::id(), c4::yml::detail::is_set_(), 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 779 of file emit.hpp.

{
    if(!detail::is_set_(n))
        return {};
    _RYML_CB_CHECK(n.tree()->callbacks(), n.readable());
    return emitrs_json(*n.tree(), n.id(), EmitOptions{}, cont, append);
}

References c4::yml::Tree::callbacks(), c4::yml::emitrs_json(), c4::yml::ConstNodeRef::id(), c4::yml::detail::is_set_(), 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 790 of file emit.hpp.

                                                                               {})
{
    if(!detail::is_set_(n))
        return {};
    _RYML_CB_CHECK(n.tree()->callbacks(), n.readable());
    CharOwningContainer c;
    emitrs_yaml(*n.tree(), n.id(), opts, &c);
    return c;
}

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

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

                                                                               {})
{
    if(!detail::is_set_(n))
        return {};
    _RYML_CB_CHECK(n.tree()->callbacks(), n.readable());
    CharOwningContainer c;
    emitrs_json(*n.tree(), n.id(), opts, &c);
    return c;
}

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