Struct RopeTextRef

pub struct RopeTextRef<'a> {
    pub text: &'a Rope,
}

Fields

text: &'a Rope

Implementations

impl<'a> RopeTextRef<'a>

pub fn new(text: &'a Rope) -> Self

Trait Implementations

impl<'a> Clone for RopeTextRef<'a>

fn clone(&self) -> RopeTextRef<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> From<&'a Node<RopeInfo>> for RopeTextRef<'a>

fn from(text: &'a Rope) -> Self

Converts to this type from the input type.

impl RopeText for RopeTextRef<'_>

fn text(&self) -> &Rope

fn len(&self) -> usize

fn is_empty(&self) -> bool

fn last_line(&self) -> usize

The last line of the held rope

fn offset_of_line(&self, line: usize) -> usize

Get the offset into the rope of the start of the given line. If the line it out of bounds, then the last offset (the len) is returned.

fn offset_line_end(&self, offset: usize, caret: bool) -> usize

fn line_of_offset(&self, offset: usize) -> usize

fn offset_to_line_col(&self, offset: usize) -> (usize, usize)

fn offset_of_line_col(&self, line: usize, col: usize) -> usize

Get the offset for a specific line and column.
This should be preferred over simply adding the column to the line offset, because it validates better and avoids returning newlines.

fn line_end_col(&self, line: usize, caret: bool) -> usize

fn line_end_offset(&self, line: usize, caret: bool) -> usize

Get the offset of the end of the line. The caret decides whether it is after the last character, or before it. If the line is out of bounds, then the last offset (the len) is returned.

fn line_content(&self, line: usize) -> Cow<'_, str>

Returns the content of the given line. Includes the line ending if it exists. (-> the last line won’t have a line ending) Lines past the end of the document will return an empty string.

fn prev_grapheme_offset( &self, offset: usize, count: usize, limit: usize, ) -> usize

Get the offset of the previous grapheme cluster.

fn next_grapheme_offset( &self, offset: usize, count: usize, limit: usize, ) -> usize

fn prev_code_boundary(&self, offset: usize) -> usize

fn next_code_boundary(&self, offset: usize) -> usize

fn select_word(&self, offset: usize) -> (usize, usize)

Return the previous and end boundaries of the word under cursor.

fn first_non_blank_character_on_line(&self, line: usize) -> usize

Returns the offset of the first non-blank character on the given line. If the line is one past the last line, then the offset at the end of the rope is returned. If the line is further past that, then it defaults to the last line.

fn indent_on_line(&self, line: usize) -> String

fn slice_to_cow(&self, range: Range<usize>) -> Cow<'_, str>

Get the content of the rope as a Cow string, for ‘nice’ ranges (small, and at the right offsets) this will be a reference to the rope’s data. Otherwise, it allocates a new string. You should be somewhat wary of requesting large parts of the rope, as it will allocate a new string since it isn’t contiguous in memory for large chunks.

fn char_indices_iter<'a, T: IntervalBounds>( &'a self, range: T, ) -> CharIndicesJoin<CharIndices<'a>, Map<ChunkIter<'a>, fn(&str) -> CharIndices<'_>>>

Iterate over (utf8_offset, char) values in the given range. This uses iter_chunks and so does not allocate, compared to Self::slice_to_cow which can

fn num_lines(&self) -> usize

The number of lines in the file

fn line_len(&self, line: usize) -> usize

The length of the given line

fn is_line_whitespace(&self, line: usize) -> bool

Returns true if the given line contains no non-whitespace characters.

fn move_left(&self, offset: usize, mode: Mode, count: usize) -> usize

fn move_right(&self, offset: usize, mode: Mode, count: usize) -> usize

fn find_nth_paragraph<F>( &self, offset: usize, count: usize, find_next: F, ) -> usize

where F: FnMut(&mut ParagraphCursor<'_>) -> Option<usize>,

fn move_n_paragraphs_forward(&self, offset: usize, count: usize) -> usize

fn move_n_paragraphs_backward(&self, offset: usize, count: usize) -> usize

fn find_nth_word<F>(&self, offset: usize, count: usize, find_next: F) -> usize

where F: FnMut(&mut WordCursor<'_>) -> Option<usize>,

Find the nth (count) word starting at offset in either direction depending on find_next.

fn move_n_words_forward(&self, offset: usize, count: usize) -> usize

fn move_n_wordends_forward( &self, offset: usize, count: usize, inserting: bool, ) -> usize

fn move_n_words_backward( &self, offset: usize, count: usize, mode: Mode, ) -> usize

fn move_word_backward_deletion(&self, offset: usize) -> usize

impl<'a> Copy for RopeTextRef<'a>