Skip to main content

LineIndex

Struct LineIndex 

Source
pub struct LineIndex { /* private fields */ }
Expand description

Index for mapping byte offsets to line/column positions.

Built once per source text, then queried as needed (e.g. for error display).

use pydocstring::ast::{LineIndex, TextSize};

let source = "first\nsecond\nthird";
let index = LineIndex::from_source(source);
let (line, col) = index.line_col(TextSize::new(6));
assert_eq!(line, 1); // 0-indexed: second line
assert_eq!(col, 0);  // start of line

Implementations§

Source§

impl LineIndex

Source

pub fn from_source(source: &str) -> Self

Build a line index from source text.

Source

pub fn line_col(&self, offset: TextSize) -> (u32, u32)

Returns 0-indexed (line, column) for a byte offset.

Column is the byte offset from the start of the line.

Source

pub fn line(&self, offset: TextSize) -> u32

Returns the 0-indexed line number for a byte offset.

Source

pub fn line_start(&self, line: u32) -> TextSize

Returns the byte offset of the start of a given line.

Source

pub fn line_count(&self) -> u32

Number of lines in the source.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.