c4::yml::TagDirective Struct Reference

#include <tag.hpp>

Public Member Functions
bool	create_from_str (csubstr directive_)
	leaves next_node_id unfilled More...
bool	create_from_str (csubstr directive_, Tree *tree)
size_t	transform (csubstr tag, substr output, Callbacks const &callbacks) const

Public Attributes
csubstr	handle
	Eg. More...
csubstr	prefix
	Eg. More...
id_type	next_node_id
	The next node to which this tag directive applies. More...

Detailed Description

Definition at line 57 of file tag.hpp.

Member Function Documentation

create_from_str() [1/2]

bool c4::yml::TagDirective::create_from_str

(

csubstr

directive_

)

leaves next_node_id unfilled

Definition at line 204 of file tag.cpp.

{
    csubstr directive = directive_;
    directive = directive.sub(4);
    if(!directive.begins_with(' '))
        return false;
    directive = directive.triml(' ');
    size_t pos = directive.find(' ');
    if(pos == npos)
        return false;
    handle = directive.first(pos);
    directive = directive.sub(handle.len).triml(' ');
    pos = directive.find(' ');
    if(pos != npos)
        directive = directive.first(pos);
    prefix = directive;
    next_node_id = NONE;
    _c4dbgpf("%TAG: handle={} prefix={}", handle, prefix);
    return true;
}

References handle, next_node_id, c4::yml::NONE, c4::yml::npos, and prefix.

Referenced by c4::yml::Tree::add_tag_directive(), and create_from_str().

create_from_str() [2/2]

bool c4::yml::TagDirective::create_from_str	(	csubstr	directive_,
		Tree *	tree
	)

Definition at line 225 of file tag.cpp.

{
    _RYML_CB_CHECK(tree->callbacks(), directive_.begins_with("%TAG "));
    if(!create_from_str(directive_))
    {
        _RYML_CB_ERR(tree->callbacks(), "invalid tag directive");
    }
    next_node_id = tree->size();
    if(!tree->empty())
    {
        const id_type prev = tree->size() - 1;
        if(tree->is_root(prev) && tree->type(prev) != NOTYPE && !tree->is_stream(prev))
            ++next_node_id;
    }
    _c4dbgpf("%TAG: handle={} prefix={} next_node={}", handle, prefix, next_node_id);
    return true;
}

References c4::yml::Tree::callbacks(), create_from_str(), c4::yml::Tree::empty(), handle, c4::yml::Tree::is_root(), c4::yml::Tree::is_stream(), next_node_id, c4::yml::NOTYPE, prefix, c4::yml::Tree::size(), and c4::yml::Tree::type().

transform()

size_t c4::yml::TagDirective::transform	(	csubstr	tag,
		substr	output,
		Callbacks const &	callbacks
	)		const

Definition at line 243 of file tag.cpp.

{
    _c4dbgpf("%TAG: handle={} prefix={} next_node={}. tag={}", handle, prefix, next_node_id, tag);
    _RYML_CB_ASSERT(callbacks, tag.len >= handle.len);
    csubstr rest = tag.sub(handle.len);
    _c4dbgpf("%TAG: rest={}", rest);
    if(rest.begins_with('<'))
    {
        _c4dbgpf("%TAG: begins with <. rest={}", rest);
        if(C4_UNLIKELY(!rest.ends_with('>')))
            _RYML_CB_ERR(callbacks, "malformed tag");
        rest = rest.offs(1, 1);
        if(rest.begins_with(prefix))
        {
            _c4dbgpf("%TAG: already transformed! actual={}", rest.sub(prefix.len));
            return 0; // return 0 to signal that the tag is local and cannot be resolved
        }
    }
    size_t len = 1u + prefix.len + rest.len + 1u;
    size_t numpc = rest.count('%');
    if(numpc == 0)
    {
        if(len <= output.len)
        {
            output.str[0] = '<';
            memcpy(1u + output.str, prefix.str, prefix.len);
            memcpy(1u + output.str + prefix.len, rest.str, rest.len);
            output.str[1u + prefix.len + rest.len] = '>';
        }
    }
    else
    {
        // need to decode URI % sequences
        size_t pos = rest.find('%');
        _RYML_CB_ASSERT(callbacks, pos != npos);
        do {
            size_t next = rest.first_not_of("0123456789abcdefABCDEF", pos+1);
            if(next == npos)
                next = rest.len;
            _RYML_CB_CHECK(callbacks, pos+1 < next);
            _RYML_CB_CHECK(callbacks, pos+1 + 2 <= next);
            size_t delta = next - (pos+1);
            len -= delta;
            pos = rest.find('%', pos+1);
        } while(pos != npos);
        if(len <= output.len)
        {
            size_t prev = 0, wpos = 0;
            auto appendstr = [&](csubstr s) { memcpy(output.str + wpos, s.str, s.len); wpos += s.len; };
            auto appendchar = [&](char c) { output.str[wpos++] = c; };
            appendchar('<');
            appendstr(prefix);
            pos = rest.find('%');
            _RYML_CB_ASSERT(callbacks, pos != npos);
            do {
                size_t next = rest.first_not_of("0123456789abcdefABCDEF", pos+1);
                if(next == npos)
                    next = rest.len;
                _RYML_CB_CHECK(callbacks, pos+1 < next);
                _RYML_CB_CHECK(callbacks, pos+1 + 2 <= next);
                uint8_t val;
                if(C4_UNLIKELY(!read_hex(rest.range(pos+1, next), &val) || val > 127))
                    _RYML_CB_ERR(callbacks, "invalid URI character");
                appendstr(rest.range(prev, pos));
                appendchar(static_cast<char>(val));
                prev = next;
                pos = rest.find('%', pos+1);
            } while(pos != npos);
            _RYML_CB_ASSERT(callbacks, pos == npos);
            _RYML_CB_ASSERT(callbacks, prev > 0);
            _RYML_CB_ASSERT(callbacks, rest.len >= prev);
            appendstr(rest.sub(prev));
            appendchar('>');
            _RYML_CB_ASSERT(callbacks, wpos == len);
        }
    }
    return len;
}

References handle, next_node_id, c4::yml::npos, prefix, and c4::read_hex().

Referenced by c4::yml::Tree::resolve_tag().

Member Data Documentation

handle

csubstr c4::yml::TagDirective::handle

Eg.

!e!

in

TAG !e! tag:example.com,2000:app/

Definition at line 60 of file tag.hpp.

Referenced by c4::yml::Tree::add_tag_directive(), create_from_str(), and transform().

prefix

csubstr c4::yml::TagDirective::prefix

Eg.

tag:example.com,2000:app/

in

TAG !e! tag:example.com,2000:app/

Definition at line 62 of file tag.hpp.

Referenced by c4::yml::Tree::add_tag_directive(), create_from_str(), and transform().

next_node_id

id_type c4::yml::TagDirective::next_node_id

The next node to which this tag directive applies.

Definition at line 64 of file tag.hpp.

Referenced by create_from_str(), and transform().

---

The documentation for this struct was generated from the following files:

• /home/docs/checkouts/readthedocs.org/user_builds/rapidyaml/checkouts/v0.9.0/src/c4/yml/tag.hpp
• /home/docs/checkouts/readthedocs.org/user_builds/rapidyaml/checkouts/v0.9.0/src/c4/yml/tag.cpp