Emit from nested node id

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

Detailed Description

Function Documentation

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.

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 59 of file emit_buf.cpp.

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

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

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

Definition at line 66 of file emit_buf.cpp.

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

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.

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 73 of file emit_buf.cpp.

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

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

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

Definition at line 80 of file emit_buf.cpp.

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