c4::yml::extra::ievt Namespace Reference

Typedefs
using	evt_bits = int32_t
	data type for integer events bits. More...

Enumerations
enum	EventBits : evt_bits {   KEY_ = (1 << 0), VAL_ = (1 << 1), BEG_ = (1 << 2), END_ = (1 << 3),   SEQ_ = (1 << 4), MAP_ = (1 << 5), DOC_ = (1 << 6), EXPL = (1 << 7),   STRM = (1 << 8), BSEQ = BEG_|SEQ_, ESEQ = END_|SEQ_, BMAP = BEG_|MAP_,   EMAP = END_|MAP_, BSTR = BEG_|STRM, ESTR = END_|STRM, BDOC = BEG_|DOC_,   EDOC = END_|DOC_, SCLR = (1 << 9), ALIA = (1 << 10), ANCH = (1 << 11),   TAG_ = (1 << 12), YAML = (1 << 13), TAGH = (1 << 14), TAGP = (1 << 15),   PLAI = (1 << 16), SQUO = (1 << 17), DQUO = (1 << 18), LITL = (1 << 19),   FOLD = (1 << 20), FLOW = (1 << 21), BLCK = (1 << 22), UNFILT = (1 << 23),   AREN = (1 << 24), WSTR = SCLR|ALIA|ANCH|TAG_|TAGH|TAGP|YAML, PSTR = (1 << 25), JUMP = (1 << 26),   PJUMP = (1 << 27), LAST = PJUMP, MASK = (LAST << 1) - 1 }
	enumeration of integer event bits. More...

Functions
size_t	to_str (substr buf, yml::extra::ievt::evt_bits flags) noexcept
	Convert bit mask of ievt::EventBits to text. More...
csubstr	to_str_sub (substr buf, yml::extra::ievt::evt_bits flags)
	Convert bit mask of ievt::EventBits to text. More...

Typedef Documentation

using c4::yml::extra::ievt::evt_bits = typedef int32_t

data type for integer events bits.

This is set to an int32_t integer to allow compatibility with a wide range of processing languages.

Definition at line 183 of file event_handler_ints.hpp.

Enumeration Type Documentation

enum c4::yml::extra::ievt::EventBits : evt_bits

enumeration of integer event bits.

Enumerator
KEY_	as key
VAL_	as value
BEG_	scope: begin
END_	scope: end
SEQ_	scope: seq
MAP_	scope: map
DOC_	scope: doc
EXPL	--- (with BDOC) or ... (with EDOC)
STRM	scope: stream
BSEQ	begin seq (+SEQ in test suite events)
ESEQ	end seq (-SEQ in test suite events)
BMAP	begin map (+MAP in test suite events)
EMAP	end map (-MAP in test suite events)
BSTR	begin stream (+STR in test suite events)
ESTR	end stream (-STR in test suite events)
BDOC	begin doc (+DOC in test suite events)
EDOC	end doc (-DOC in test suite events)
SCLR	scalar (=VAL in test suite events)
ALIA	*ref (reference)
ANCH	&anchor
TAG_	!tag
YAML	yaml directive: \YAML <version>
TAGH	tag directive, handle: \TAG <handle> ........
TAGP	tag directive, prefix: \TAG ........ <prefix>
PLAI	scalar: plain
SQUO	scalar: single-quoted (')
DQUO	scalar: double-quoted ("")
LITL	scalar: block literal (|)
FOLD	scalar: block folded (>)
FLOW	container: flow: [] for seqs or {} for maps
BLCK	container: block
UNFILT	Special flag to mark a scalar as unfiltered (when the parser is set not to filter).
AREN	Special flag to mark events whose string was placed in the arena. This happens when the filtered string is larger than the original string in the YAML code (eg from tags that resolve to a larger string, or from "\L" or "\P" in double quotes, which expand from two to three bytes). Because of this size expansion, the filtered string cannot be placed in the original source and needs to be placed in the arena.
WSTR	WithSTRing: mask of all events that encode a string following the event. For such events, the next two integers will provide respectively the string's offset and length. See also PSTR.
PSTR	Special flag to enable look-back in the event array. It signifies that the previous event has a string, meaning that the jump back to that event is 3 positions. without this flag it would be impossible to jump to the previous event. see also WSTR.
JUMP	unused: reserved for future use (to enable rope-like buffers)
PJUMP	unused: reserved for future use (same purpose as PSTR, but for JUMP)
LAST	the last flag defined above
MASK	a mask of all bits in this enumeration

Definition at line 187 of file event_handler_ints.hpp.

             : evt_bits { // NOLINT

    //-------------------------------------------------------------------------
    // YAML flags

    // YAML structure flags
    KEY_ = (1 <<  0),  ///< as key
    VAL_ = (1 <<  1),  ///< as value

    // YAML event scopes
    BEG_ = (1 <<  2),  ///< scope: begin
    END_ = (1 <<  3),  ///< scope: end
    SEQ_ = (1 <<  4),  ///< scope: seq
    MAP_ = (1 <<  5),  ///< scope: map
    DOC_ = (1 <<  6),  ///< scope: doc
    EXPL = (1 <<  7),  ///< `---` (with BDOC) or `...` (with EDOC)
    STRM = (1 <<  8),  ///< scope: stream
    BSEQ = BEG_|SEQ_,  ///< begin seq    (+SEQ in test suite events)
    ESEQ = END_|SEQ_,  ///< end seq      (-SEQ in test suite events)
    BMAP = BEG_|MAP_,  ///< begin map    (+MAP in test suite events)
    EMAP = END_|MAP_,  ///< end map      (-MAP in test suite events)
    BSTR = BEG_|STRM,  ///< begin stream (+STR in test suite events)
    ESTR = END_|STRM,  ///< end stream   (-STR in test suite events)
    BDOC = BEG_|DOC_,  ///< begin doc    (+DOC in test suite events)
    EDOC = END_|DOC_,  ///< end doc      (-DOC in test suite events)

    // YAML string events
    SCLR = (1 <<  9),  ///< scalar (=VAL in test suite events)
    ALIA = (1 << 10),  ///< *ref (reference)
    ANCH = (1 << 11),  ///< &anchor
    TAG_ = (1 << 12),  ///< !tag
    // directives
    YAML = (1 << 13),  ///< yaml directive: `\%YAML <version>`
    TAGH = (1 << 14),  ///< tag directive, handle: `\%TAG <handle> ........`
    TAGP = (1 << 15),  ///< tag directive, prefix: `\%TAG ........ <prefix>`

    // YAML style flags
    PLAI = (1 << 16),  ///< scalar: plain
    SQUO = (1 << 17),  ///< scalar: single-quoted (')
    DQUO = (1 << 18),  ///< scalar: double-quoted ("")
    LITL = (1 << 19),  ///< scalar: block literal (|)
    FOLD = (1 << 20),  ///< scalar: block folded (>)
    FLOW = (1 << 21),  ///< container: flow: [] for seqs or {} for maps
    BLCK = (1 << 22),  ///< container: block

    /// Special flag to mark a scalar as unfiltered (when the parser
    /// is set not to filter).
    UNFILT = (1 << 23),

    //-------------------------------------------------------------------------
    // NON-YAML FLAGS

    /// Special flag to mark events whose string was placed in the
    /// arena. This happens when the filtered string is larger than
    /// the original string in the YAML code (eg from tags that
    /// resolve to a larger string, or from "\L" or "\P" in double
    /// quotes, which expand from two to three bytes). Because of this
    /// size expansion, the filtered string cannot be placed in the
    /// original source and needs to be placed in the arena.
    AREN = (1 << 24),

    /// WithSTRing: mask of all events that encode a string following
    /// the event. For such events, the next two integers will provide
    /// respectively the string's offset and length. See also @ref PSTR
    WSTR = SCLR|ALIA|ANCH|TAG_|TAGH|TAGP|YAML,

    /// Special flag to enable look-back in the event array. It
    /// signifies that the previous event has a string, meaning that
    /// the jump back to that event is 3 positions. without this flag it
    /// would be impossible to jump to the previous event.
    /// see also @ref WSTR
    PSTR = (1 << 25),

    /// unused: reserved for future use (to enable rope-like buffers)
    JUMP = (1 << 26),
    /// unused: reserved for future use (same purpose as @ref PSTR,
    /// but for @ref JUMP)
    PJUMP = (1 << 27),

    /// the last flag defined above
    LAST = PJUMP,

    /// a mask of all bits in this enumeration
    MASK = (LAST << 1) - 1,

} EventBits;

Function Documentation

size_t c4::yml::extra::ievt::to_str ( substr  buf, yml::extra::ievt::evt_bits  flags  )

noexcept

Convert bit mask of ievt::EventBits to text.

Definition at line 60 of file ints_utils.cpp.

Referenced by main(), and to_str_sub().

{
    detail::SubstrWriter_ writer(buf);
    for(const FlagSym sym : flag_syms_)
    {
        if(flags & sym.flags)
        {
            if(writer.pos)
                writer.append('|');
            writer.append(sym.str);
            flags &= ~sym.flags;
        }
    }
    if(!writer.pos)
        writer.append("NONE");
    if(buf.len > writer.pos)
        buf[writer.pos] = '\0';
    return writer.pos;
}

csubstr c4::yml::extra::ievt::to_str_sub	(	substr	buf,
		yml::extra::ievt::evt_bits	flags
	)

Convert bit mask of ievt::EventBits to text.

Definition at line 80 of file ints_utils.cpp.

Referenced by c4::yml::extra::events_ints_print().

{
    size_t reqsize = ievt::to_str(buf, flags);
    RYML_CHECK_BASIC_(reqsize > 0u);
    RYML_CHECK_BASIC_(reqsize < buf.len);
    return buf.first(reqsize);
}