c4::yml::LineContents Struct Reference

Helper to control the line contents while parsing a buffer. More...

#include <parser_state.hpp>

Public Member Functions
	LineContents ()=default
void	reset_with_next_line (substr buf, size_t offset)
void	reset (substr full_, substr stripped_)
size_t	current_col () const RYML_NOEXCEPT
size_t	current_col (csubstr s) const RYML_NOEXCEPT

Public Attributes
substr	rem
	the stripped line remainder; initially starts at the first non-space character More...
size_t	indentation
	the number of spaces on the beginning of the line More...
substr	full
	the full line, including newlines on the right More...
substr	stripped
	the stripped line, excluding newlines on the right More...

Detailed Description

Helper to control the line contents while parsing a buffer.

Definition at line 51 of file parser_state.hpp.

Constructor & Destructor Documentation

LineContents()

c4::yml::LineContents::LineContents ( )

default

Member Function Documentation

reset_with_next_line()

void c4::yml::LineContents::reset_with_next_line ( substr  buf, size_t  offset  )

inline

Definition at line 60 of file parser_state.hpp.

    {
        RYML_ASSERT(offset <= buf.len);
        size_t e = offset;
        // get the current line stripped of newline chars
        while(e < buf.len && (buf.str[e] != '\n' && buf.str[e] != '\r'))
            ++e;
        RYML_ASSERT(e >= offset);
        const substr stripped_ = buf.range(offset, e);
        #if defined(__GNUC__) && __GNUC__ == 11
        C4_DONT_OPTIMIZE(stripped_);
        #endif
        // advance pos to include the first line ending
        if(e < buf.len && buf.str[e] == '\r')
            ++e;
        if(e < buf.len && buf.str[e] == '\n')
            ++e;
        const substr full_ = buf.range(offset, e);
        reset(full_, stripped_);
    }

References reset().

reset()

void c4::yml::LineContents::reset ( substr  full_, substr  stripped_  )

inline

Definition at line 81 of file parser_state.hpp.

    {
        rem = stripped_;
        indentation = stripped_.first_not_of(' ');  // find the first column where the character is not a space
        full = full_;
        stripped = stripped_;
    }

References full, indentation, rem, and stripped.

Referenced by reset_with_next_line().

current_col() [1/2]

size_t c4::yml::LineContents::current_col ( ) const

inline

Definition at line 89 of file parser_state.hpp.

    {
        // WARNING: gcc x86 release builds were wrong (eg returning 0
        // when the result should be 4 ) when this function was like
        // this:
        //
        //return current_col(rem);
        //
        // (see below for the full definition of the called overload
        // of current_col())
        //
        // ... so we explicitly inline the code in here:
        RYML_ASSERT(rem.str >= full.str);
        size_t col = static_cast<size_t>(rem.str - full.str);
        return col;
        //
        // this was happening only on builds specifically with (gcc
        // AND x86 AND release); no other builds were having the
        // problem: not in debug, not in x64, not in other
        // architectures, not in clang, not in visual studio. WTF!?
        //
        // Enabling debug prints with RYML_DBG made the problem go
        // away, so these could not be used to debug the
        // problem. Adding prints inside the called current_col() also
        // made the problem go away! WTF!???
        //
        // a prize will be offered to anybody able to explain why this
        // was happening.
    }

References full, and rem.

current_col() [2/2]

size_t c4::yml::LineContents::current_col ( csubstr  s ) const

inline

Definition at line 119 of file parser_state.hpp.

    {
        RYML_ASSERT(s.str >= full.str);
        RYML_ASSERT(full.is_super(s));
        size_t col = static_cast<size_t>(s.str - full.str);
        return col;
    }

References full.

Member Data Documentation

rem

substr c4::yml::LineContents::rem

the stripped line remainder; initially starts at the first non-space character

Definition at line 53 of file parser_state.hpp.

Referenced by c4::yml::ParserState::at_line_beginning(), current_col(), and reset().

indentation

size_t c4::yml::LineContents::indentation

the number of spaces on the beginning of the line

Definition at line 54 of file parser_state.hpp.

Referenced by c4::yml::ParserState::indentation_eq(), c4::yml::ParserState::indentation_ge(), c4::yml::ParserState::indentation_gt(), c4::yml::ParserState::indentation_lt(), and reset().

full

substr c4::yml::LineContents::full

the full line, including newlines on the right

Definition at line 55 of file parser_state.hpp.

Referenced by c4::yml::ParserState::at_line_beginning(), current_col(), and reset().

stripped

substr c4::yml::LineContents::stripped

the stripped line, excluding newlines on the right

Definition at line 56 of file parser_state.hpp.

Referenced by reset().

---

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

• /home/docs/checkouts/readthedocs.org/user_builds/rapidyaml/checkouts/v0.8.0/src/c4/yml/parser_state.hpp