c4::yml::TagDirective Struct Reference

#include <tag.hpp>

Public Member Functions
bool	create_from_str (csubstr directive_)
	leaves next_node_id unfilled More...
size_t	transform (csubstr tag, substr output, Callbacks const &callbacks, bool with_brackets=true) 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()

bool c4::yml::TagDirective::create_from_str

(

csubstr

directive_

)

leaves next_node_id unfilled

Definition at line 209 of file tag.cpp.

{
    _RYML_CHECK_BASIC(directive.begins_with("%TAG "));
    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.

transform()

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

Definition at line 230 of file tag.cpp.

{
    _c4dbgpf("%TAG: handle={} prefix={} next_node={}. tag={}", handle, prefix, next_node_id, tag);
    _RYML_ASSERT_BASIC_(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_ERR_BASIC_(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 = prefix.len + rest.len;
    if(with_brackets)
        len += 2;
    size_t numpc = rest.count('%');
    if(numpc == 0)
    {
        if(len <= output.len)
        {
            if(with_brackets)
            {
                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
            {
                memcpy(output.str, prefix.str, prefix.len);
                memcpy(output.str + prefix.len, rest.str, rest.len);
            }
        }
    }
    else
    {
        // need to decode URI % sequences
        size_t pos = rest.find('%');
        _RYML_ASSERT_BASIC_(callbacks, pos != npos);
        do {
            size_t next = rest.first_not_of("0123456789abcdefABCDEF", pos+1);
            if(next == npos)
                next = rest.len;
            _RYML_CHECK_BASIC_(callbacks, pos+1 < next);
            _RYML_CHECK_BASIC_(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; };
            if(with_brackets)
                appendchar('<');
            appendstr(prefix);
            pos = rest.find('%');
            _RYML_ASSERT_BASIC_(callbacks, pos != npos);
            do {
                size_t next = rest.first_not_of("0123456789abcdefABCDEF", pos+1);
                if(next == npos)
                    next = rest.len;
                _RYML_CHECK_BASIC_(callbacks, pos+1 < next);
                _RYML_CHECK_BASIC_(callbacks, pos+1 + 2 <= next);
                uint8_t val;
                if(C4_UNLIKELY(!read_hex(rest.range(pos+1, next), &val) || val > 127))
                    _RYML_ERR_BASIC_(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_ASSERT_BASIC_(callbacks, pos == npos);
            _RYML_ASSERT_BASIC_(callbacks, prev > 0);
            _RYML_ASSERT_BASIC_(callbacks, rest.len >= prev);
            appendstr(rest.sub(prev));
            if(with_brackets)
                appendchar('>');
            _RYML_ASSERT_BASIC_(callbacks, wpos == len);
        }
    }
    return len;
}

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

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.

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.

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.

---

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

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