Struct kaolinite::row::Row

pub struct Row {
    pub text: Vec<char>,
    pub indices: Vec<usize>,
    pub modified: bool,
    pub tokens: Vec<Token>,
    pub needs_rerender: bool,
}

A struct that contains all the basic tools necessary to manage rows in a document

Fields

text: Vec<char>

All the characters within the row

indices: Vec<usize>

Corresponding display widths for each character

modified: bool

A tool for determining if the row has been edited

use kaolinite::row::Row;
let tab_width = 4;
let mut row = Row::new("Hello", tab_width);
assert_eq!(row.modified, false);
row.insert(5, ", world!", tab_width);
assert_eq!(row.modified, true);
row.modified = false;
assert_eq!(row.modified, false);

This is ideal for optimisation

tokens: Vec<Token>

Tokens for this row

needs_rerender: bool

Implementations

impl Row

pub fn new<S: Into<String>>(raw: S, tab_width: usize) -> Self

Create a new row from raw text

pub fn insert<S: Into<String>>(
    &mut self,
    start: usize,
    text: S,
    tabs: usize
) -> Result<Status>

Insert text at a position

Errors

Will return Err if start is out of range of the row

pub fn remove<R>(&mut self, range: R) -> Result<Status> where
    R: BoundedRange, 

Remove text in a range

This takes in an inclusive or exclusive range: .. and ..= only.

Errors

Will return Err if range is out of range of the row

pub fn split(&self, idx: usize) -> Result<(Row, Row)>

Splits this row into two separate rows

Errors

Will return Err if idx is out of range of the row

pub fn splice(&mut self, row: Row) -> Row

Joins this row with another row

pub fn words(&self) -> Vec<usize>

Retrieve the indices of word boundaries

// Opening a file,
use kaolinite::document::Document;
let mut doc = Document::new((10, 10));
// Imagine if test.txt were `The quick brown fox`
doc.open("examples/test.txt").expect("Failed to open file");
// This would get the word boundaries of the first row: [0, 4, 10, 16, 19]
println!("{:?}", doc.row(0).unwrap().words());

pub fn next_word_forth(&self, loc: usize) -> usize

Find the next word in this row from the character index

pub fn next_word_back(&self, loc: usize) -> usize

Find the previous word in this row from the character index

pub fn render(&self, range: RangeFrom<usize>, tabs: usize) -> String

Render part of the row When trying to render X axis offset, this is the ideal function to use

"He好llo好" // 0..
"e好llo好"  // 1..
"好llo好"   // 2..
" llo好"    // 3..
"llo好"     // 4..
"lo好"      // 5..
"o好"       // 6..
"好"        // 7..
" "         // 8..
""          // 9..

This also handles double width characters by inserting whitespace when half of the character is off the screen

pub fn render_full(&self, tabs: usize) -> String

Render the entire row, with tabs converted into spaces

pub fn render_raw(&self) -> String

Render this row as is, with no tab interference

pub fn len(&self) -> usize

Find the character length of this row

pub fn is_empty(&self) -> bool

Determine if the row is empty

pub fn width(&self) -> usize

Find the display width of this row

pub fn get_char_ptr(&self, x: usize) -> usize

Calculate the character pointer from a display index

Trait Implementations

impl Clone for Row

fn clone(&self) -> Row

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Row

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

Formats the value using the given formatter.

impl PartialEq<Row> for Row

fn eq(&self, other: &Row) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Row) -> bool

This method tests for !=.

impl StructuralPartialEq for Row