Emit to memory buffer

Modules
	Emit to resizeable container

Functions
bool	c4::yml::EmitOptions::operator== (const EmitOptions &that) const noexcept
template<class ... WriterArgs>
	c4::yml::Emitter< Writer >::Emitter (EmitOptions const &opts, WriterArgs &&...args)
	Construct the emitter and its internal Writer state. More...
template<class ... WriterArgs>
	c4::yml::Emitter< Writer >::Emitter (WriterArgs &&...args)
	Construct the emitter and its internal Writer state, using default emit options. 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 >::options (EmitOptions opts) noexcept
	set 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, id_type 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, id_type 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
id_type	c4::yml::as_json::node
EmitOptions	c4::yml::as_json::options
Tree const *	c4::yml::as_yaml::tree
id_type	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
bool	c4::yml::EmitOptions::emit_nonroot_key () const noexcept
EmitOptions &	c4::yml::EmitOptions::emit_nonroot_key (bool enabled) noexcept
bool	c4::yml::EmitOptions::emit_nonroot_dash () const noexcept
EmitOptions &	c4::yml::EmitOptions::emit_nonroot_dash (bool enabled) noexcept
bool	c4::yml::EmitOptions::indent_flow_ml () const noexcept
EmitOptions &	c4::yml::EmitOptions::indent_flow_ml (bool enabled) noexcept
EmitOptionFlags_e	c4::yml::EmitOptions::json_error_flags () const noexcept
EmitOptions &	c4::yml::EmitOptions::json_error_flags (EmitOptionFlags_e d) noexcept

Detailed Description

Function Documentation

emit_nonroot_key() [1/2]

bool c4::yml::EmitOptions::emit_nonroot_key ( ) const

inlinenoexcept

Definition at line 81 of file emit.hpp.

{ return (m_option_flags & EMIT_NONROOT_KEY) != 0; }

emit_nonroot_key() [2/2]

EmitOptions& c4::yml::EmitOptions::emit_nonroot_key ( bool  enabled )

inlinenoexcept

Definition at line 82 of file emit.hpp.

{ m_option_flags = (EmitOptionFlags_e)(enabled ? (m_option_flags | EMIT_NONROOT_KEY) : (m_option_flags & ~EMIT_NONROOT_KEY)); return *this; }

emit_nonroot_dash() [1/2]

bool c4::yml::EmitOptions::emit_nonroot_dash ( ) const

inlinenoexcept

Definition at line 84 of file emit.hpp.

{ return (m_option_flags & EMIT_NONROOT_DASH) != 0; }

emit_nonroot_dash() [2/2]

EmitOptions& c4::yml::EmitOptions::emit_nonroot_dash ( bool  enabled )

inlinenoexcept

Definition at line 85 of file emit.hpp.

{ m_option_flags = (EmitOptionFlags_e)(enabled ? (m_option_flags | EMIT_NONROOT_DASH) : (m_option_flags & ~EMIT_NONROOT_DASH)); return *this; }

indent_flow_ml() [1/2]

bool c4::yml::EmitOptions::indent_flow_ml ( ) const

inlinenoexcept

Definition at line 87 of file emit.hpp.

{ return (m_option_flags & INDENT_FLOW_ML) != 0; }

indent_flow_ml() [2/2]

EmitOptions& c4::yml::EmitOptions::indent_flow_ml ( bool  enabled )

inlinenoexcept

Definition at line 88 of file emit.hpp.

{ m_option_flags = (EmitOptionFlags_e)(enabled ? (m_option_flags | INDENT_FLOW_ML) : (m_option_flags & ~INDENT_FLOW_ML)); return *this; }

json_error_flags() [1/2]

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

inlinenoexcept

Definition at line 90 of file emit.hpp.

{ return (EmitOptionFlags_e)(m_option_flags & _JSON_ERR_MASK); }

json_error_flags() [2/2]

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

inlinenoexcept

Definition at line 91 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 103 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 104 of file emit.hpp.

{ m_max_depth = d; return *this; }

operator==()

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

inlinenoexcept

Definition at line 110 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 ... WriterArgs>

c4::yml::Emitter< Writer >::Emitter ( EmitOptions const &  opts, WriterArgs &&...  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 142 of file emit.hpp.

        : Writer(std::forward<WriterArgs>(args)...)
        , m_tree()
        , m_opts(opts)
        , m_col()
        , m_depth()
        , m_ilevel()
        , m_pws()
    {}

Emitter() [2/2]

template<class Writer >

template<class ... WriterArgs>

c4::yml::Emitter< Writer >::Emitter ( WriterArgs &&...  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 156 of file emit.hpp.

        : Writer(std::forward<WriterArgs>(args)...)
        , m_tree()
        , m_opts()
        , m_col()
        , m_depth()
        , m_ilevel()
        , m_pws()
    {}

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 (YAML or JSON)
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 19 of file emit.def.hpp.

{
    if(tree.empty())
    {
        _RYML_ASSERT_BASIC_(tree.callbacks(), id == NONE);
        return {};
    }
    if(id == NONE)
        id = tree.root_id();
    _RYML_CHECK_VISIT_(tree.callbacks(), id < tree.capacity(), &tree, id);
    m_tree = &tree;
    m_col = 0;
    m_depth = 0;
    m_ilevel = 0;
    m_pws = _PWS_NONE;
    if(type == EMIT_YAML)
        _emit_yaml(id);
    else if(type == EMIT_JSON)
        _json_emit(id);
    else
        _RYML_ERR_BASIC_(m_tree->callbacks(), "unknown emit type"); // LCOV_EXCL_LINE
    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().

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

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

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

options() [1/2]

template<class Writer >

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

inlinenoexcept

get the emit options for this object

Definition at line 204 of file emit.hpp.

{ return m_opts; }

options() [2/2]

template<class Writer >

void c4::yml::Emitter< Writer >::options ( EmitOptions  opts )

inlinenoexcept

set the emit options for this object

Definition at line 206 of file emit.hpp.

{ m_opts = 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 209 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 211 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 555 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, id_type  id, EmitOptions const &  opts = {}  )

inline

Definition at line 556 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 557 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 576 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, id_type  id, EmitOptions const &  opts = {}  )

inline

Definition at line 577 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 578 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 624 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 630 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 644 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 650 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 667 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 673 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 686 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 692 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 709 of file emit.hpp.

{
    if(!r.readable())
        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::ConstNodeRef::readable().

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

{
    if(!r.readable())
        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::ConstNodeRef::readable().

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

{
    if(!r.readable())
        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::ConstNodeRef::readable().

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

{
    if(!r.readable())
        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::ConstNodeRef::readable().

Variable Documentation

max_depth_default

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

staticconstexpr

Definition at line 105 of file emit.hpp.

tree [1/2]

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

Definition at line 552 of file emit.hpp.

node [1/2]

id_type c4::yml::as_json::node

Definition at line 553 of file emit.hpp.

options [1/2]

EmitOptions c4::yml::as_json::options

Definition at line 554 of file emit.hpp.

tree [2/2]

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

Definition at line 573 of file emit.hpp.

node [2/2]

id_type c4::yml::as_yaml::node

Definition at line 574 of file emit.hpp.

options [2/2]

EmitOptions c4::yml::as_yaml::options

Definition at line 575 of file emit.hpp.