Reader

Provides an API to read characters from a UTF-8 buffer and build slices into that buffer to avoid allocations (see SliceBuilder).

package final

class Reader {

Endian endian_;

this(ubyte[] buffer);

dchar peek(const size_t index);

dchar peek();

char peekByte(const size_t index);

char peekByte();

char[] prefix(const size_t length);

char[] prefixBytes(const size_t length);

char[] slice(const size_t end);

dchar get();

char[] get(const size_t length);

void forward(size_t length);

void forward();

SliceBuilder sliceBuilder;

Mark mark();

uint line();

uint column();

size_t charIndex();

Encoding encoding();

}

Constructors

this this(ubyte[] buffer): Construct a Reader.

Members

Functions

charIndex size_t charIndex(): Get index of the current character in the buffer.
column uint column(): Get current column number.
encoding Encoding encoding(): Get encoding of the input buffer.
forward void forward(size_t length): Move current position forward.
forward void forward(): Move current position forward by one character.
get dchar get(): Get the next character, moving buffer position beyond it.
get char[] get(const size_t length): Get specified number of characters, moving buffer position beyond them.
line uint line(): Get current line number.
mark Mark mark(): Get a string describing current buffer position, used for error messages.
peek dchar peek(const size_t index): Get character at specified index relative to current position.
peek dchar peek(): Optimized version of peek() for the case where peek index is 0.
peekByte char peekByte(const size_t index): Get byte at specified index relative to current position.
peekByte char peekByte(): Optimized version of peekByte() for the case where peek byte index is 0.
prefix char[] prefix(const size_t length): Get specified number of characters starting at current position.
prefixBytes char[] prefixBytes(const size_t length): Get specified number of bytes, not code points, starting at current position.
slice char[] slice(const size_t end): Get a slice view of the internal buffer, starting at the current position.

Variables

sliceBuilder SliceBuilder sliceBuilder;: Used to build slices of read data in Reader; to avoid allocations.

Meta

Source

See Implementation

dyaml reader classes

structs

SliceBuilder