Struct TextString

pub struct TextString { /* private fields */ }

Single line text-store.

Implementations

impl TextString

pub fn new() -> Self

New empty.

pub fn new_text(t: &str) -> Self

New from string.

pub fn new_string(t: String) -> Self

New from string.

pub fn as_str(&self) -> &str

str

Trait Implementations

impl Clone for TextString

fn clone(&self) -> TextString

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TextString

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

Formats the value using the given formatter.

impl Default for TextString

fn default() -> TextString

Returns the “default value” for a type.

impl TextStore for TextString

fn is_multi_line(&self) -> bool

Can store multi-line content?

todo: allow col=0, row=1

fn string(&self) -> String

Get content as string.

fn set_string(&mut self, t: &str)

Set content as string.

fn byte_range_at(&self, pos: TextPosition) -> Result<Range<usize>, TextError>

Grapheme position to byte position. This is the (start,end) position of the single grapheme after pos.

• pos must be a valid position: row <= len_lines, col <= line_width of the row.

fn byte_range(&self, range: TextRange) -> Result<Range<usize>, TextError>

Grapheme range to byte range.

• range must be a valid range. row <= len_lines, col <= line_width of the row.

fn byte_to_pos(&self, byte_pos: usize) -> Result<TextPosition, TextError>

Byte position to grapheme position. Returns the position that contains the given byte index.

• byte must <= byte-len.

fn bytes_to_range(&self, bytes: Range<usize>) -> Result<TextRange, TextError>

Byte range to grapheme range.

• byte must <= byte-len.

fn str_slice(&self, range: TextRange) -> Result<Cow<'_, str>, TextError>

A range of the text as Cow<str>.

• range must be a valid range. row <= len_lines, col <= line_width of the row.
• pos must be inside of range.

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

A range of the text as Cow<str>.

• range must be valid

fn graphemes( &self, range: TextRange, pos: TextPosition, ) -> Result<impl Cursor<Item = Grapheme<'_>>, TextError>

Return a cursor over the graphemes of the range, start at the given position.

• range must be a valid range. row <= len_lines, col <= line_width of the row.
• pos must be inside of range.

fn line_at(&self, row: upos_type) -> Result<Cow<'_, str>, TextError>

Line as str.

• row must be <= len_lines

fn lines_at( &self, row: upos_type, ) -> Result<impl Iterator<Item = Cow<'_, str>>, TextError>

Iterate over text-lines, starting at line-offset.

• row must be <= len_lines

fn line_graphemes( &self, row: upos_type, ) -> Result<impl Cursor<Item = Grapheme<'_>>, TextError>

Return a line as an iterator over the graphemes. This contains the ‘\n’ at the end.

• row must be <= len_lines

fn line_width(&self, row: upos_type) -> Result<upos_type, TextError>

Line width of row as grapheme count. Excludes the terminating ‘\n’.

• row must be <= len_lines

fn len_lines(&self) -> upos_type

Number of lines.

fn insert_char( &mut self, pos: TextPosition, c: char, ) -> Result<(TextRange, Range<usize>), TextError>

Insert a char at the given position.

• range must be a valid range. row <= len_lines, col <= line_width of the row.

fn insert_str( &mut self, pos: TextPosition, t: &str, ) -> Result<(TextRange, Range<usize>), TextError>

Insert a str at position.

fn remove( &mut self, range: TextRange, ) -> Result<(String, (TextRange, Range<usize>)), TextError>

Remove a range.

fn insert_b(&mut self, byte_pos: usize, t: &str) -> Result<(), TextError>

Insert a string at the given byte index.

fn remove_b(&mut self, byte_range: Range<usize>) -> Result<(), TextError>

Remove the given byte-range.