Emit to memory buffer

Modules
	Emit to resizeable container

Enumerations
enum	c4::yml::EmitOptions::EmitOptionFlags_e : uint32_t { c4::yml::EmitOptions::DEFAULT_FLAGS = 0u , c4::yml::EmitOptions::JSON_ERR_ON_TAG = 1u << 0u , c4::yml::EmitOptions::JSON_ERR_ON_ANCHOR = 1u << 1u , c4::yml::EmitOptions::_JSON_ERR_MASK = JSON_ERR_ON_TAG|JSON_ERR_ON_ANCHOR }

Functions
bool	c4::yml::detail::is_set_ (ConstNodeRef n)
bool	c4::yml::EmitOptions::operator== (const EmitOptions &that) const noexcept
template<class ... Args>
	c4::yml::Emitter< Writer >::Emitter (Args &&...args)
	Construct the emitter and its internal Writer state, using default emit options. More...
template<class ... Args>
	c4::yml::Emitter< Writer >::Emitter (EmitOptions const &opts, Args &&...args)
	Construct the emitter and its internal Writer state. More...
substr	c4::yml::Emitter< Writer >::emit_as (EmitType_e type, Tree const &t, id_type id, bool error_on_excess)
	emit! More...
substr	c4::yml::Emitter< Writer >::emit_as (EmitType_e type, Tree const &t, bool error_on_excess=true)
	emit starting at the root node More...
substr	c4::yml::Emitter< Writer >::emit_as (EmitType_e type, ConstNodeRef const &n, bool error_on_excess=true)
	emit starting at the given node More...
EmitOptions const &	c4::yml::Emitter< Writer >::options () const noexcept
	get the emit options for this object More...
void	c4::yml::Emitter< Writer >::max_depth (id_type max_depth) noexcept
	set the max depth for emitted trees (to prevent a stack overflow) More...
id_type	c4::yml::Emitter< Writer >::max_depth () const noexcept
	get the max depth for emitted trees (to prevent a stack overflow) More...
	c4::yml::as_json::as_json (Tree const &t, EmitOptions const &opts={})
	c4::yml::as_json::as_json (Tree const &t, size_t id, EmitOptions const &opts={})
	c4::yml::as_json::as_json (ConstNodeRef const &n, EmitOptions const &opts={})
	c4::yml::as_yaml::as_yaml (Tree const &t, EmitOptions const &opts={})
	c4::yml::as_yaml::as_yaml (Tree const &t, size_t id, EmitOptions const &opts={})
	c4::yml::as_yaml::as_yaml (ConstNodeRef const &n, EmitOptions const &opts={})
substr	c4::yml::emit_yaml (Tree const &t, id_type id, EmitOptions const &opts, substr buf, bool error_on_excess=true)
	(1) emit YAML to the given buffer. More...
substr	c4::yml::emit_yaml (Tree const &t, id_type id, substr buf, bool error_on_excess=true)
	(2) like (1), but use default emit options More...
substr	c4::yml::emit_json (Tree const &t, id_type id, EmitOptions const &opts, substr buf, bool error_on_excess=true)
	(1) emit JSON to the given buffer. More...
substr	c4::yml::emit_json (Tree const &t, id_type id, substr buf, bool error_on_excess=true)
	(2) like (1), but use default emit options More...
substr	c4::yml::emit_yaml (Tree const &t, EmitOptions const &opts, substr buf, bool error_on_excess=true)
	(1) emit YAML to the given buffer. More...
substr	c4::yml::emit_yaml (Tree const &t, substr buf, bool error_on_excess=true)
	(2) like (1), but use default emit options More...
substr	c4::yml::emit_json (Tree const &t, EmitOptions const &opts, substr buf, bool error_on_excess=true)
	(1) emit JSON to the given buffer. More...
substr	c4::yml::emit_json (Tree const &t, substr buf, bool error_on_excess=true)
	(2) like (1), but use default emit options More...
substr	c4::yml::emit_yaml (ConstNodeRef const &r, EmitOptions const &opts, substr buf, bool error_on_excess=true)
	(1) emit YAML to the given buffer. More...
substr	c4::yml::emit_yaml (ConstNodeRef const &r, substr buf, bool error_on_excess=true)
	(2) like (1), but use default emit options More...
substr	c4::yml::emit_json (ConstNodeRef const &r, EmitOptions const &opts, substr buf, bool error_on_excess=true)
	(1) emit JSON to the given buffer. More...
substr	c4::yml::emit_json (ConstNodeRef const &r, substr buf, bool error_on_excess=true)
	(2) like (1), but use default emit options More...

Variables
Tree const *	c4::yml::as_json::tree
size_t	c4::yml::as_json::node
EmitOptions	c4::yml::as_json::options
Tree const *	c4::yml::as_yaml::tree
size_t	c4::yml::as_yaml::node
EmitOptions	c4::yml::as_yaml::options

max depth for the emitted tree
This makes the emitter fail when emitting trees exceeding the max_depth.
static constexpr const id_type	c4::yml::EmitOptions::max_depth_default = 64
id_type	c4::yml::EmitOptions::max_depth () const noexcept
EmitOptions &	c4::yml::EmitOptions::max_depth (id_type d) noexcept

option flags
EmitOptionFlags_e	c4::yml::EmitOptions::json_error_flags () const noexcept
EmitOptions &	c4::yml::EmitOptions::json_error_flags (EmitOptionFlags_e d) noexcept

Detailed Description

Enumeration Type Documentation

EmitOptionFlags_e

enum c4::yml::EmitOptions::EmitOptionFlags_e : uint32_t

Enumerator
DEFAULT_FLAGS
JSON_ERR_ON_TAG
JSON_ERR_ON_ANCHOR
_JSON_ERR_MASK

Definition at line 64 of file emit.hpp.

                 : uint32_t {
        DEFAULT_FLAGS = 0u,
        JSON_ERR_ON_TAG = 1u << 0u,
        JSON_ERR_ON_ANCHOR = 1u << 1u,
        _JSON_ERR_MASK = JSON_ERR_ON_TAG|JSON_ERR_ON_ANCHOR,
    } EmitOptionFlags_e;

Function Documentation

is_set_()

bool c4::yml::detail::is_set_ ( ConstNodeRef  n )

inline

Definition at line 42 of file emit.hpp.

{ return n.tree() && (n.id() != NONE); }

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

Referenced by c4::yml::Emitter< Writer >::emit_as(), c4::yml::emit_json(), c4::yml::emit_yaml(), c4::yml::emitrs_json(), c4::yml::emitrs_yaml(), and c4::yml::operator<<().

json_error_flags() [1/2]

EmitOptionFlags_e c4::yml::EmitOptions::json_error_flags ( ) const

inlinenoexcept

Definition at line 76 of file emit.hpp.

{ return m_option_flags; }

json_error_flags() [2/2]

EmitOptions& c4::yml::EmitOptions::json_error_flags ( EmitOptionFlags_e  d )

inlinenoexcept

Definition at line 77 of file emit.hpp.

{ m_option_flags = (EmitOptionFlags_e)(d & _JSON_ERR_MASK); return *this; }

max_depth() [1/4]

id_type c4::yml::EmitOptions::max_depth ( ) const

inlinenoexcept

Definition at line 88 of file emit.hpp.

{ return m_max_depth; }

max_depth() [2/4]

EmitOptions& c4::yml::EmitOptions::max_depth ( id_type  d )

inlinenoexcept

Definition at line 89 of file emit.hpp.

{ m_max_depth = d; return *this; }

operator==()

bool c4::yml::EmitOptions::operator== ( const EmitOptions &  that ) const

inlinenoexcept

Definition at line 95 of file emit.hpp.

    {
        return m_max_depth == that.m_max_depth &&
            m_option_flags == that.m_option_flags;
    }

Emitter() [1/2]

template<class Writer >

template<class ... Args>

c4::yml::Emitter< Writer >::Emitter ( Args &&...  args )

inline

Construct the emitter and its internal Writer state, using default emit options.

Parameters

args	arguments to be forwarded to the constructor of the writer.

Definition at line 125 of file emit.hpp.

: Writer(std::forward<Args>(args)...), m_tree(), m_opts(), m_flow(false) {}

Emitter() [2/2]

template<class Writer >

template<class ... Args>

c4::yml::Emitter< Writer >::Emitter ( EmitOptions const &  opts, Args &&...  args  )

inline

Construct the emitter and its internal Writer state.

Parameters

opts	EmitOptions
args	arguments to be forwarded to the constructor of the writer.

Definition at line 133 of file emit.hpp.

: Writer(std::forward<Args>(args)...), m_tree(), m_opts(opts), m_flow(false) {}

emit_as() [1/3]

template<class Writer >

substr c4::yml::Emitter< Writer >::emit_as	(	EmitType_e	type,
		Tree const &	t,
		id_type	id,
		bool	error_on_excess
	)

emit!

When writing to a buffer, returns a substr of the emitted YAML. If the given buffer has insufficient space, the returned substr will be null and its size will be the needed space. Whatever the size of the buffer, it is guaranteed that no writes are done past its end.

When writing to a file, the returned substr will be null, but its length will be set to the number of bytes written.

Parameters

type	specify what to emit
t	the tree to emit
id	the id of the node to emit
error_on_excess	when true, an error is raised when the output buffer is too small for the emitted YAML/JSON

Definition at line 17 of file emit.def.hpp.

{
    if(t.empty())
    {
        _RYML_CB_ASSERT(t.callbacks(), id == NONE);
        return {};
    }
    if(id == NONE)
        id = t.root_id();
    _RYML_CB_CHECK(t.callbacks(), id < t.capacity());
    m_tree = &t;
    m_flow = false;
    if(type == EMIT_YAML)
        _emit_yaml(id);
    else if(type == EMIT_JSON)
        _do_visit_json(id, 0);
    else
        _RYML_CB_ERR(m_tree->callbacks(), "unknown emit type");
    m_tree = nullptr;
    return this->Writer::_get(error_on_excess);
}

References c4::yml::Tree::callbacks(), c4::yml::Tree::capacity(), c4::yml::EMIT_JSON, c4::yml::EMIT_YAML, c4::yml::Tree::empty(), c4::yml::NONE, and c4::yml::Tree::root_id().

Referenced by c4::yml::emit_json(), c4::yml::emit_yaml(), and c4::yml::operator<<().

emit_as() [2/3]

template<class Writer >

substr c4::yml::Emitter< Writer >::emit_as ( EmitType_e  type, Tree const &  t, bool  error_on_excess = true  )

inline

emit starting at the root node

Definition at line 154 of file emit.hpp.

    {
        if(t.empty())
            return {};
        return this->emit_as(type, t, t.root_id(), error_on_excess);
    }

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

emit_as() [3/3]

template<class Writer >

substr c4::yml::Emitter< Writer >::emit_as ( EmitType_e  type, ConstNodeRef const &  n, bool  error_on_excess = true  )

inline

emit starting at the given node

Definition at line 161 of file emit.hpp.

    {
        if(!detail::is_set_(n))
            return {};
        _RYML_CB_CHECK(n.tree()->callbacks(), n.readable());
        return this->emit_as(type, *n.tree(), n.id(), error_on_excess);
    }

References c4::yml::Tree::callbacks(), c4::yml::ConstNodeRef::id(), c4::yml::detail::is_set_(), c4::yml::ConstNodeRef::readable(), and c4::yml::ConstNodeRef::tree().

options()

template<class Writer >

EmitOptions const& c4::yml::Emitter< Writer >::options ( ) const

inlinenoexcept

get the emit options for this object

Definition at line 172 of file emit.hpp.

{ return m_opts; }

max_depth() [3/4]

template<class Writer >

void c4::yml::Emitter< Writer >::max_depth ( id_type  max_depth )

inlinenoexcept

set the max depth for emitted trees (to prevent a stack overflow)

Definition at line 175 of file emit.hpp.

{ m_opts.max_depth(max_depth); }

max_depth() [4/4]

template<class Writer >

id_type c4::yml::Emitter< Writer >::max_depth ( ) const

inlinenoexcept

get the max depth for emitted trees (to prevent a stack overflow)

Definition at line 177 of file emit.hpp.

{ return m_opts.max_depth(); }

as_json() [1/3]

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

inline

Definition at line 397 of file emit.hpp.

{}) : tree(&t), node(t.empty() ? NONE : t.root_id()), options(opts)  {}

as_json() [2/3]

c4::yml::as_json::as_json ( Tree const &  t, size_t  id, EmitOptions const &  opts = {}  )

inline

Definition at line 398 of file emit.hpp.

{}) : tree(&t), node(id), options(opts)  {}

as_json() [3/3]

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

inline

Definition at line 399 of file emit.hpp.

{}) : tree(n.tree()), node(n.id()), options(opts) {}

as_yaml() [1/3]

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

inline

Definition at line 418 of file emit.hpp.

{}) : tree(&t), node(t.empty() ? NONE : t.root_id()), options(opts)  {}

as_yaml() [2/3]

c4::yml::as_yaml::as_yaml ( Tree const &  t, size_t  id, EmitOptions const &  opts = {}  )

inline

Definition at line 419 of file emit.hpp.

{}) : tree(&t), node(id), options(opts)  {}

as_yaml() [3/3]

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

inline

Definition at line 420 of file emit.hpp.

{}) : tree(n.tree()), node(n.id()), options(opts) {}

emit_yaml() [1/6]

substr c4::yml::emit_yaml ( Tree const &  t, id_type  id, EmitOptions const &  opts, substr  buf, bool  error_on_excess = true  )

inline

(1) emit YAML to the given buffer.

Return a substr trimmed to the emitted YAML.

Parameters

t	the tree to emit.
id	the node where to start emitting.
opts	emit options.
buf	the output buffer.
error_on_excess	Raise an error if the space in the buffer is insufficient.

Returns

a substr trimmed to the result in the output buffer. If the buffer is insufficient (when error_on_excess is false), the string pointer of the result will be set to null, and the length will report the required buffer size.

Definition at line 466 of file emit.hpp.

{
    EmitterBuf em(opts, buf);
    return em.emit_as(EMIT_YAML, t, id, error_on_excess);
}

References c4::yml::Emitter< Writer >::emit_as(), and c4::yml::EMIT_YAML.

emit_yaml() [2/6]

substr c4::yml::emit_yaml ( Tree const &  t, id_type  id, substr  buf, bool  error_on_excess = true  )

inline

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

Definition at line 472 of file emit.hpp.

{
    EmitterBuf em(buf);
    return em.emit_as(EMIT_YAML, t, id, error_on_excess);
}

References c4::yml::Emitter< Writer >::emit_as(), and c4::yml::EMIT_YAML.

emit_json() [1/6]

substr c4::yml::emit_json ( Tree const &  t, id_type  id, EmitOptions const &  opts, substr  buf, bool  error_on_excess = true  )

inline

(1) emit JSON to the given buffer.

Return a substr trimmed to the emitted JSON.

Parameters

t	the tree to emit.
id	the node where to start emitting.
opts	emit options.
buf	the output buffer.
error_on_excess	Raise an error if the space in the buffer is insufficient.

Returns

a substr trimmed to the result in the output buffer. If the buffer is insufficient (when error_on_excess is false), the string pointer of the result will be set to null, and the length will report the required buffer size.

Definition at line 486 of file emit.hpp.

{
    EmitterBuf em(opts, buf);
    return em.emit_as(EMIT_JSON, t, id, error_on_excess);
}

References c4::yml::Emitter< Writer >::emit_as(), and c4::yml::EMIT_JSON.

emit_json() [2/6]

substr c4::yml::emit_json ( Tree const &  t, id_type  id, substr  buf, bool  error_on_excess = true  )

inline

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

Definition at line 492 of file emit.hpp.

{
    EmitterBuf em(buf);
    return em.emit_as(EMIT_JSON, t, id, error_on_excess);
}

References c4::yml::Emitter< Writer >::emit_as(), and c4::yml::EMIT_JSON.

emit_yaml() [3/6]

substr c4::yml::emit_yaml ( Tree const &  t, EmitOptions const &  opts, substr  buf, bool  error_on_excess = true  )

inline

(1) emit YAML to the given buffer.

Return a substr trimmed to the emitted YAML.

Parameters

t	the tree; will be emitted from the root node.
opts	emit options.
buf	the output buffer.
error_on_excess	Raise an error if the space in the buffer is insufficient.

Returns

a substr trimmed to the result in the output buffer. If the buffer is insufficient (when error_on_excess is false), the string pointer of the result will be set to null, and the length will report the required buffer size.

Definition at line 509 of file emit.hpp.

{
    EmitterBuf em(opts, buf);
    return em.emit_as(EMIT_YAML, t, error_on_excess);
}

References c4::yml::Emitter< Writer >::emit_as(), and c4::yml::EMIT_YAML.

emit_yaml() [4/6]

substr c4::yml::emit_yaml ( Tree const &  t, substr  buf, bool  error_on_excess = true  )

inline

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

Definition at line 515 of file emit.hpp.

{
    EmitterBuf em(buf);
    return em.emit_as(EMIT_YAML, t, error_on_excess);
}

References c4::yml::Emitter< Writer >::emit_as(), and c4::yml::EMIT_YAML.

emit_json() [3/6]

substr c4::yml::emit_json ( Tree const &  t, EmitOptions const &  opts, substr  buf, bool  error_on_excess = true  )

inline

(1) emit JSON to the given buffer.

Return a substr trimmed to the emitted JSON.

Parameters

t	the tree; will be emitted from the root node.
opts	emit options.
buf	the output buffer.
error_on_excess	Raise an error if the space in the buffer is insufficient.

Returns

a substr trimmed to the result in the output buffer. If the buffer is insufficient (when error_on_excess is false), the string pointer of the result will be set to null, and the length will report the required buffer size.

Definition at line 528 of file emit.hpp.

{
    EmitterBuf em(opts, buf);
    return em.emit_as(EMIT_JSON, t, error_on_excess);
}

References c4::yml::Emitter< Writer >::emit_as(), and c4::yml::EMIT_JSON.

emit_json() [4/6]

substr c4::yml::emit_json ( Tree const &  t, substr  buf, bool  error_on_excess = true  )

inline

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

Definition at line 534 of file emit.hpp.

{
    EmitterBuf em(buf);
    return em.emit_as(EMIT_JSON, t, error_on_excess);
}

References c4::yml::Emitter< Writer >::emit_as(), and c4::yml::EMIT_JSON.

emit_yaml() [5/6]

substr c4::yml::emit_yaml ( ConstNodeRef const &  r, EmitOptions const &  opts, substr  buf, bool  error_on_excess = true  )

inline

(1) emit YAML to the given buffer.

Return a substr trimmed to the emitted YAML.

Parameters

r	the starting node.
buf	the output buffer.
opts	emit options.
error_on_excess	Raise an error if the space in the buffer is insufficient.

Returns

a substr trimmed to the result in the output buffer. If the buffer is insufficient (when error_on_excess is false), the string pointer of the result will be set to null, and the length will report the required buffer size.

Definition at line 551 of file emit.hpp.

{
    if(!detail::is_set_(r))
        return {};
    EmitterBuf em(opts, buf);
    return em.emit_as(EMIT_YAML, r, error_on_excess);
}

References c4::yml::Emitter< Writer >::emit_as(), c4::yml::EMIT_YAML, and c4::yml::detail::is_set_().

emit_yaml() [6/6]

substr c4::yml::emit_yaml ( ConstNodeRef const &  r, substr  buf, bool  error_on_excess = true  )

inline

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

Definition at line 559 of file emit.hpp.

{
    if(!detail::is_set_(r))
        return {};
    EmitterBuf em(buf);
    return em.emit_as(EMIT_YAML, r, error_on_excess);
}

References c4::yml::Emitter< Writer >::emit_as(), c4::yml::EMIT_YAML, and c4::yml::detail::is_set_().

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

emit_json() [5/6]

substr c4::yml::emit_json ( ConstNodeRef const &  r, EmitOptions const &  opts, substr  buf, bool  error_on_excess = true  )

inline

(1) emit JSON to the given buffer.

Return a substr trimmed to the emitted JSON.

Parameters

r	the starting node.
buf	the output buffer.
opts	emit options.
error_on_excess	Raise an error if the space in the buffer is insufficient.

Returns

a substr trimmed to the result in the output buffer. If the buffer is insufficient (when error_on_excess is false), the string pointer of the result will be set to null, and the length will report the required buffer size.

Definition at line 574 of file emit.hpp.

{
    if(!detail::is_set_(r))
        return {};
    EmitterBuf em(opts, buf);
    return em.emit_as(EMIT_JSON, r, error_on_excess);
}

References c4::yml::Emitter< Writer >::emit_as(), c4::yml::EMIT_JSON, and c4::yml::detail::is_set_().

emit_json() [6/6]

substr c4::yml::emit_json ( ConstNodeRef const &  r, substr  buf, bool  error_on_excess = true  )

inline

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

Definition at line 582 of file emit.hpp.

{
    if(!detail::is_set_(r))
        return {};
    EmitterBuf em(buf);
    return em.emit_as(EMIT_JSON, r, error_on_excess);
}

References c4::yml::Emitter< Writer >::emit_as(), c4::yml::EMIT_JSON, and c4::yml::detail::is_set_().

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

Variable Documentation

max_depth_default

constexpr const id_type c4::yml::EmitOptions::max_depth_default = 64

staticconstexpr

Definition at line 90 of file emit.hpp.

tree [1/2]

Tree const* c4::yml::as_json::tree

Definition at line 394 of file emit.hpp.

Referenced by c4::yml::operator<<().

node [1/2]

size_t c4::yml::as_json::node

Definition at line 395 of file emit.hpp.

Referenced by c4::yml::operator<<().

options [1/2]

EmitOptions c4::yml::as_json::options

Definition at line 396 of file emit.hpp.

Referenced by c4::yml::operator<<().

tree [2/2]

Tree const* c4::yml::as_yaml::tree

Definition at line 415 of file emit.hpp.

Referenced by c4::yml::operator<<().

node [2/2]

size_t c4::yml::as_yaml::node

Definition at line 416 of file emit.hpp.

Referenced by c4::yml::operator<<().

options [2/2]

EmitOptions c4::yml::as_yaml::options

Definition at line 417 of file emit.hpp.

Referenced by c4::yml::operator<<().