Struct StrInput 

pub struct StrInput<'a> { /* private fields */ }

A parser input backed by a &str.

Implementations

impl<'a> StrInput<'a>

pub fn new(input: &'a str) -> Self

Create a new StrInput over the given string slice.

Trait Implementations

impl<'a> BorrowedInput<'a> for StrInput<'a>

fn slice_borrowed(&self, start: usize, end: usize) -> Option<&'a str>

Return a borrowed slice of the underlying source between two byte offsets.

impl Input for StrInput<'_>

fn next_is_alpha(&self) -> bool

Check if the next character is an ASCII alphanumeric, _, or -.

This is used as a heuristic for error detection (e.g., when : is followed by tab and then a potential value character). The ASCII-only check is intentional: it catches common cases like key:\tvalue while avoiding false positives for valid YAML constructs. Unicode value starters (e.g., äöü) are not detected, but such cases will still fail to parse (with a less specific error message).

fn fetch_while_is_alpha(&mut self, out: &mut String) -> usize

Fetch characters matching is_alpha (ASCII alphanumeric, _, -).

This is used for scanning tag handles (e.g., !foo!). Per YAML 1.2 spec, tag handles use ns-word-char which is [0-9a-zA-Z-]. Our implementation is slightly more permissive by also accepting _, but this is harmless and matches common practice. Unicode characters like ä or π are NOT valid in tag handles per spec, so the ASCII-only byte-based scanning here is both correct and efficient.

fn lookahead(&mut self, x: usize)

A hint to the input source that we will need to read count characters.

fn buflen(&self) -> usize

Return the number of characters in the active lookahead window.

fn bufmaxlen(&self) -> usize

Return the maximum number of characters this input can buffer for lookahead.

fn raw_read_ch(&mut self) -> char

Read the next character from the logical input stream and return it directly.

fn raw_read_non_breakz_ch(&mut self) -> Option<char>

Read a non-breakz character from the input stream and return it directly.

fn skip(&mut self)

Consume the next character.

fn skip_n(&mut self, count: usize)

Consume the next count characters.

fn peek(&self) -> char

Return the next character, without consuming it.

fn peek_nth(&self, n: usize) -> char

Return the n-th character in the buffer, without consuming it.

fn byte_offset(&self) -> Option<usize>

Return the current byte offset in the underlying source, if available.

fn slice_bytes(&self, start: usize, end: usize) -> Option<&str>

Return a borrowed slice of the underlying source between two byte offsets.

fn may_contain_comments(&self) -> bool

Return whether this input may contain a # character.

fn next_2_are(&self, c1: char, c2: char) -> bool

Return whether the next 2 characters in the input source match the given characters.

fn next_3_are(&self, c1: char, c2: char, c3: char) -> bool

Return whether the next 3 characters in the input source match the given characters.

fn next_is_document_indicator(&self) -> bool

Check whether the next characters correspond to a document indicator.

fn next_is_document_start(&self) -> bool

Check whether the next characters correspond to a start of document.

fn next_is_document_end(&self) -> bool

Check whether the next characters correspond to an end of document.

fn skip_ws_to_eol( &mut self, skip_tabs: SkipTabs, ) -> (usize, Result<SkipTabs, ErrorKind>)

Skip YAML whitespace up to the end of the current line.

fn skip_ws_to_eol_blanks(&mut self, skip_tabs: SkipTabs) -> (usize, SkipTabs)

Skip YAML blank characters, stopping before comments, line breaks, or other content.

fn next_is_blank_or_break(&self) -> bool

Check whether the next character is a blank or a break.

fn next_is_blank_or_breakz(&self) -> bool

Check whether the next character is a blank or a breakz.

fn next_is_blank(&self) -> bool

Check whether the next character is a blank.

fn next_is_break(&self) -> bool

Check whether the next character is a break.

fn next_is_breakz(&self) -> bool

Check whether the next character is a breakz.

fn next_is_z(&self) -> bool

Check whether the input is at its physical end.

fn next_is_flow(&self) -> bool

Check whether the next character is a flow.

fn next_is_digit(&self) -> bool

Check whether the next character is a digit.

fn skip_while_non_breakz(&mut self) -> usize

Skip printable characters until a breakz or non-printable character is found.

fn skip_while_blank(&mut self) -> usize

Skip characters from the input while blanks are found.

fn fetch_while_is_yaml_non_space(&mut self, out: &mut String) -> usize

Fetch characters as long as they satisfy is_yaml_non_space(c).

fn fetch_plain_scalar_chunk( &mut self, out: &mut String, _count: usize, flow_level_gt_0: bool, ) -> (bool, usize)

Fetch a chunk of plain scalar characters.

fn skip_plain_scalar_chunk( &mut self, _count: usize, flow_level_gt_0: bool, ) -> (bool, usize)

Consume a chunk of plain-scalar characters without materializing them.

fn buf_is_empty(&self) -> bool

Return whether the active lookahead window is empty.

fn take_source_error(&mut self) -> Option<ErrorKind>

Take a terminal error reported by the underlying source.

fn look_ch(&mut self) -> char

Look for the next character and return it.

fn next_char_is(&self, c: char) -> bool

Return whether the next character in the input source is equal to c.

fn nth_char_is(&self, n: usize, c: char) -> bool

Return whether the n-th character in the input source is equal to c.

fn next_can_be_plain_scalar(&self, in_flow: bool) -> bool

Check whether the next characters may be part of a plain scalar.