Struct SpanConverter 

pub struct SpanConverter { /* private fields */ }

Converter for efficiently handling many spans from the same text.

Pre-computes mapping tables so each conversion is O(1).

Implementations

impl SpanConverter

pub fn new(text: &str) -> Self

Create a converter for the given text.

pub fn byte_to_char(&self, byte_idx: usize) -> usize

Convert byte offset to char offset.

Arguments

• byte_idx - Byte offset in the text

Returns

Character offset corresponding to the byte offset. If byte_idx is out of bounds, returns the last valid character index (or 0 if the map is empty).

Panics

In debug mode, panics if byte_idx exceeds the text length by more than 1 (allowing for the exclusive end position).

pub fn char_to_byte(&self, char_idx: usize) -> usize

Convert char offset to byte offset.

Arguments

• char_idx - Character offset in the text

Returns

Byte offset corresponding to the character offset. If char_idx is out of bounds, returns the last valid byte index (or 0 if the map is empty).

Panics

In debug mode, panics if char_idx exceeds the character count by more than 1 (allowing for the exclusive end position).

pub fn from_bytes(&self, byte_start: usize, byte_end: usize) -> TextSpan

Convert byte span to TextSpan.

pub fn from_chars(&self, char_start: usize, char_end: usize) -> TextSpan

Convert char span to TextSpan.

pub const fn is_ascii(&self) -> bool

Check if this text is ASCII.