Struct LinePositions 

pub struct LinePositions { /* private fields */ }

A struct for efficiently converting absolute string positions to line-relative positions.

Implementations

impl LinePositions

pub fn from_offset(&self, offset: usize) -> (LineNumber, usize)

Return the line and column corresponding to this offset. offset is measured in bytes.

Panics

Panics if offset is out of bounds.

Examples found in repository

examples/simple.rs (line 10)

fn main() {
    let s = "foo\nbar\nbaz\n";
    let s_lines: Vec<_> = s.lines().collect();

    let line_positions = LinePositions::from(s);

    let offset = 5;
    let (line_num, column) = line_positions.from_offset(offset);

    println!(
        "Offset {} is on line {} (column {}), and the text of that line is {:?}.",
        offset,
        line_num.display(),
        column,
        s_lines[line_num.as_usize()]
    );
}

pub fn from_region( &self, region_start: usize, region_end: usize, ) -> Vec<SingleLineSpan>

Convert this region into line spans. If the region includes a newline, the vec will contain multiple items.

Panics

Panics if region_start or region_end are out of bounds, or if region_start is greater than region_end.

pub fn from_region_relative_to( &self, start: SingleLineSpan, region_start: usize, region_end: usize, ) -> Vec<SingleLineSpan>

Given a region in the current LinePositions, convert it to be relative to a start offset in a larger, enclosing string.

Panics

Panics if region_start or region_end are out of bounds, or if region_start is greater than region_end.

Trait Implementations

impl Debug for LinePositions

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

Formats the value using the given formatter.

impl From<&str> for LinePositions

fn from(s: &str) -> Self

Converts to this type from the input type.