Enum SharedString 

pub enum SharedString<'a> {
    Owned(Arc<Vec<u8>>),
    Borrowed(&'a [u8]),
    Sliced {
        other: Arc<Vec<u8>>,
        range: Range<usize>,
    },
}

Helper for holding either an owned or borrowed string, and where the slice method is aware of that borrowing, allowing for efficient copying and slicing without making extraneous additional copies

Variants

Owned(Arc<Vec<u8>>)

Borrowed(&'a [u8])

Sliced

Fields

other: Arc<Vec<u8>>

range: Range<usize>

Implementations

impl SharedString<'_>

pub fn slice(&self, slice_range: Range<usize>) -> Self

pub fn as_bytes(&self) -> &[u8]

pub fn to_str(&self) -> Result<&str, Utf8Error>

pub fn to_str_lossy(&self) -> Cow<'_, str>

pub fn len(&self) -> usize

pub fn to_owned(&self) -> SharedString<'static>

Trait Implementations

impl Clone for SharedString<'_>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SharedString<'_>

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

Formats the value using the given formatter.

impl Display for SharedString<'_>

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

Formats the value using the given formatter.

impl<'a> From<&'a [u8]> for SharedString<'a>

fn from(s: &'a [u8]) -> Self

Converts to this type from the input type.

impl<'a> From<&'a str> for SharedString<'a>

fn from(s: &'a str) -> Self

Converts to this type from the input type.

impl From<BString> for SharedString<'_>

fn from(s: BString) -> Self

Converts to this type from the input type.

impl From<String> for SharedString<'_>

fn from(s: String) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for SharedString<'_>

fn from(s: Vec<u8>) -> Self

Converts to this type from the input type.

impl Index<usize> for SharedString<'_>

type Output = u8

The returned type after indexing.

fn index(&self, index: usize) -> &u8

Performs the indexing (container[index]) operation.

impl PartialEq<&str> for SharedString<'_>

fn eq(&self, other: &&str) -> 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 PartialEq for SharedString<'_>

fn eq(&self, other: &Self) -> 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.