Struct Text

Source

pub struct Text(/* private fields */);

Expand description

The primary type of quetta, representing an immutable sequence of characters. Internally, this can be either a full string or a slice into another Text. Can be cloned cheaply.

Implementations§

Source §

impl Text

Source

pub fn new<'a, I: Into<&'a str>>(s: I) -> Self

Creates a new Text by copying the provided slice.

Source

pub fn as_str(&self) -> &str

Gets the Text as a slice.

Source

pub fn substring(&self, start: usize, len: usize) -> Text

Creates another Text with a provided start code point and length. Will panic if the substring exceeds the Text’s bounds.

§Example

use quetta::Text;

let text = Text::new("qwerty");
let sub = text.substring(0, 2);
assert_eq!("qw", sub.as_str());

Source

pub fn slice(&self, start: usize, end: usize) -> Text

Creates another Text with a provided start code point and end code point, similar to the slice operator. Will panic if the slice exceeds the Text’s bounds.

§Example

use quetta::Text;

let text = Text::new("qwerty");
let sub = text.slice(1, 3);
assert_eq!("we", sub.as_str());

Source

pub fn len(&self) -> usize

Gets the length of the Text.

§Example

use quetta::Text;

let text = Text::new("I was born in a water moon");
assert_eq!(26, text.len());

Source

pub fn is_empty(&self) -> bool

Is this Text empty?

§Example

use quetta::Text;

let text = Text::default();
assert!(text.is_empty());

Source

pub fn try_lift_slice(&self, slice: &str) -> Option<Text>

Attempt to create a Text from a slice sliced from this Text. Will return None if the slice is not contained in self.

§Example

use quetta::Text;

let text = Text::new("Test");
let s = &text.as_str()[0..2];
let st = text.try_lift_slice(s);
assert!(st.is_some());
assert_eq!("Te", st.unwrap().as_str());

Source

pub fn lift_slice(&self, slice: &str) -> Text

Creates a Text from a slice, if possible, as a substring of self.

§Example

use quetta::Text;

let text = Text::new("Test");
let s = &text.as_str()[0..2];
let st = text.lift_slice(s);
assert_eq!("Te", st.as_str());

Source

pub fn try_lift<F: Fn(&str) -> &str>(&self, f: F) -> Option<Text>

Lifts a function &str -> &str so it will be executed on the &str self. Will return none if the &str returned by the function is not contained in self.

§Example

use quetta::Text;

let text = Text::new("  a  ");
let trimmed = text.try_lift(|t| t.trim())?;
assert_eq!("a", trimmed.as_str());

Source

pub fn lift<F: Fn(&str) -> &str>(&self, f: F) -> Text

Lifts a function &str -> &str so it will be executed on the &str self. If the returned &str is not contained in self, a new Text will be created from it.

§Example

use quetta::Text;

let text = Text::new("  a  ");
let trimmed = text.try_lift(|t| t.trim())?;
assert_eq!("a", trimmed.as_str());

Source

pub fn try_lift_many<'a, I: Iterator<Item = &'a str> + 'a, F: Fn(&'a str) -> I>( &'a self, f: F, ) -> impl Iterator<Item = Text> + 'a

Lifts a function &str -> Iterator<Item=&str> so it will be executed on self and returns an Iterator<Item=[Text]>. If one of the &str in the iterator is not contained in self, the iterator will end.

§Example

use quetta::Text;
let t = Text::new("A:B:C:D");
let lifted: Vec<Text> = t.try_lift_many(|s| s.split(":")).collect();
assert_eq!(4, lifted.len());
assert_eq!("A", lifted[0].as_str());
assert_eq!("B", lifted[1].as_str());
assert_eq!("C", lifted[2].as_str());
assert_eq!("D", lifted[3].as_str());

Source

pub fn lift_many<'a, I: Iterator<Item = &'a str> + 'a, F: Fn(&'a str) -> I>( &'a self, f: F, ) -> impl Iterator<Item = Text> + 'a

Lifts a function &str -> Iterator<Item=&str> so it will be executed on self and returns an Iterator<Item=[Text]>. If the iterator yields a &str that is not contained within self, a new Text will be created from it.

§Example

use quetta::Text;
let t = Text::new("A:B:C:D");
let lifted: Vec<Text> = t.lift_many(|s| s.split(":")).collect();
assert_eq!(4, lifted.len());
assert_eq!("A", lifted[0].as_str());
assert_eq!("B", lifted[1].as_str());
assert_eq!("C", lifted[2].as_str());
assert_eq!("D", lifted[3].as_str());