Enum IndexedCow

pub enum IndexedCow {
    Borrowed {
        start: usize,
        end: usize,
    },
    Owned(String),
}

A span of text that can be either owned, or indexed in another String.

Variants

Borrowed

Indexes content in a separate string.

Fields

start: usize

Byte offset of the beginning of the span (inclusive)

end: usize

Byte offset of the end of the span (exclusive)

Owned(String)

Owns its content.

Implementations

impl IndexedCow

pub fn resolve<'a>(&'a self, source: &'a str) -> &'a str

Resolve the span to a string slice.

pub fn subcow(&self, range: Range<usize>) -> IndexedCow

Gets a new IndexedCow for the given range.

The given range is relative to this span.

pub fn as_borrowed(&self) -> Option<(usize, usize)>

Return the (start, end) indexes if self is IndexedCow::Borrowed.

pub fn as_borrowed_mut(&mut self) -> Option<(&mut usize, &mut usize)>

Return the (start, end) indexes if self is IndexedCow::Borrowed.

pub fn as_owned(&self) -> Option<&str>

Returns the embedded text content if self is IndexedCow::Owned.

pub fn from_str(value: &str, source: &str) -> IndexedCow

Returns an indexed view of the given string.

Note: it is assumed cow, if borrowed, is a substring of source.

pub fn from_cow(cow: Cow<'_, str>, source: &str) -> IndexedCow

Returns an indexed view of the given item.

Note: it is assumed cow, if borrowed, is a substring of source.

pub fn is_empty(&self) -> bool

Returns true if this represents an empty span.

pub fn offset(&mut self, offset: usize)

If self is borrowed, offset its indices by the given value.

Useful to update spans when concatenating sources. This span will now point to text offset further in the source.

pub fn rev_offset(&mut self, offset: usize)

If self is borrowed, offset its indices back by the given value.

Useful to update spans when removing a prefix from the source. This span will now point to text offset closer to the start of the source.

This span may become empty as a result.

Trait Implementations

impl<T> AsRef<IndexedCow> for IndexedSpan<T>

fn as_ref(&self) -> &IndexedCow

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for IndexedCow

fn clone(&self) -> IndexedCow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IndexedCow

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

Formats the value using the given formatter.

impl Hash for IndexedCow

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for IndexedCow

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for IndexedCow

impl StructuralPartialEq for IndexedCow