Struct Source 

pub struct Source { /* private fields */ }

Original YAML input plus line-start metadata.

Implementations

impl Source

pub fn new(text: String) -> Result<Source, YamlError>

Builds a source buffer, validates YAML 1.2.2 printable characters, and records all line starts.

Errors

Returns an error when text contains characters that are not valid in a YAML 1.2.2 stream.

pub fn as_str(&self) -> &str

Returns the original input text.

pub fn len(&self) -> usize

Returns the source length in bytes.

pub fn is_empty(&self) -> bool

Returns true when the source is empty.

pub fn line_starts(&self) -> &[u32]

Returns the recorded line-start byte offsets.

pub fn slice(&self, span: Span) -> &str

Returns the source slice for span.

Panics

Panics if span is outside the source or does not fall on UTF-8 boundaries. Use Source::try_slice when handling user-provided spans.

pub fn try_slice(&self, span: Span) -> Result<&str, YamlError>

Returns the source slice for span, or a span-rich error when invalid.

Errors

Returns an error when span is outside the source text or does not fall on UTF-8 boundaries.

pub fn line_col(&self, offset: usize) -> LineCol

Converts a byte offset into a one-based line/column pair.

pub fn diagnostic_position(&self, diagnostic: &Diagnostic) -> LineCol

Returns the line/column pair for a diagnostic’s primary span.

Trait Implementations

impl Clone for Source

fn clone(&self) -> Source

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Source

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Eq for Source

impl PartialEq for Source

fn eq(&self, other: &Source) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Source