Struct SourceText 

pub struct SourceText { /* private fields */ }

Immutable source text with checked UTF-8 byte and UTF-16 coordinate mapping.

The map records only boundaries immediately after non-ASCII code points. Between checkpoints, byte and UTF-16 offsets advance together through ASCII, so binary search plus one subtraction converts either direction without a per-code-point map.

Implementations

impl SourceText

pub fn new(text: impl Into<Arc<str>>) -> Self

Stores source text and precomputes its immutable position indexes.

pub fn from_arc(text: Arc<str>) -> Self

Stores an existing shared source allocation without copying its text.

pub fn as_str(&self) -> &str

Returns the original UTF-8 source text.

pub const fn len_utf16(&self) -> Utf16Pos

Returns the source length in UTF-16 code units.

pub fn is_empty(&self) -> bool

Returns whether the source has no code points.

pub fn byte_to_utf16( &self, byte_offset: usize, ) -> Result<Utf16Pos, SourcePositionError>

Converts a UTF-8 byte boundary to a UTF-16 boundary.

pub fn utf16_to_byte( &self, position: Utf16Pos, ) -> Result<usize, SourcePositionError>

Converts a UTF-16 boundary to a UTF-8 byte boundary.

pub fn range( &self, start: Utf16Pos, end: Utf16Pos, ) -> Result<TextRange, SourcePositionError>

Returns a source-relative, ordered range after validating both endpoints.

pub fn line_column( &self, position: Utf16Pos, ) -> Result<(usize, usize), SourcePositionError>

Returns the zero-based line and UTF-16 column of a valid source boundary.

\r\n contributes one line break, with the next line beginning after the \n. A bare \r, a bare \n, \u{2028} (LINE SEPARATOR), and \u{2029} (PARAGRAPH SEPARATOR) each also begin a new line.

Trait Implementations

impl Clone for SourceText

fn clone(&self) -> SourceText

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SourceText

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

Formats the value using the given formatter.