Struct pstr::IStr

pub struct IStr(_);

Immutable Interning String

Implementations

impl IStr

pub fn new(s: impl AsRef<str>) -> Self

Create a IStr from str slice

Example

let s = IStr::new("hello world");

pub fn from_string(s: String) -> Self

Create a IStr from String

pub fn from_boxed(s: Box<str>) -> Self

Create a IStr from Box<str>

pub fn from_arc(s: Arc<str>) -> Self

Create a IStr from Arc<str>

pub fn from_rc(s: Rc<str>) -> Self

Create a IStr from Rc<str>

pub fn from_mow(s: MowStr) -> Self

Create a IStr from MowStr

pub fn from_to_arc<S: AsRef<str>>(
    s: S,
    to_arc: impl FnOnce(S) -> Arc<str>
) -> Self

Create a IStr from custom fn

impl IStr

pub fn as_str(&self) -> &str

Extracts a string slice containing the entire IStr

pub fn into_boxed_str(&self) -> Box<str>

Clone a boxed string slice containing the entire IStr

pub fn into_mut(&self) -> MowStr

Convert to MowStr

Trait Implementations

impl AsRef<[u8]> for IStr

fn as_ref(&self) -> &[u8]

Performs the conversion.

impl AsRef<OsStr> for IStr

fn as_ref(&self) -> &OsStr

Performs the conversion.

impl AsRef<Path> for IStr

fn as_ref(&self) -> &Path

Performs the conversion.

impl AsRef<str> for IStr

fn as_ref(&self) -> &str

Performs the conversion.

impl Borrow<str> for IStr

fn borrow(&self) -> &str

Immutably borrows from an owned value.

impl Clone for IStr

fn clone(&self) -> IStr

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for IStr

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

Formats the value using the given formatter.

impl Deref for IStr

type Target = str

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Eq for IStr

impl Extend<IStr> for MowStr

fn extend<T: IntoIterator<Item = IStr>>(&mut self, iter: T)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬 This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬 This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl<'_> From<&'_ String> for IStr

fn from(s: &String) -> Self

Performs the conversion.

impl<'_> From<&'_ mut str> for IStr

fn from(s: &mut str) -> Self

Performs the conversion.

impl<'_> From<&'_ str> for IStr

fn from(s: &str) -> Self

Performs the conversion.

impl<'a> From<&'a IStr> for Cow<'a, str>

fn from(v: &'a IStr) -> Self

Performs the conversion.

impl From<Arc<str>> for IStr

fn from(s: Arc<str>) -> Self

Performs the conversion.

impl From<Box<str>> for IStr

fn from(s: Box<str>) -> Self

Performs the conversion.

impl<'a> From<Cow<'a, str>> for IStr

fn from(s: Cow<'a, str>) -> Self

Performs the conversion.

impl From<IStr> for Box<str>

fn from(v: IStr) -> Self

Performs the conversion.

impl From<IStr> for Vec<u8>

fn from(v: IStr) -> Self

Performs the conversion.

impl From<IStr> for MowStr

fn from(v: IStr) -> Self

Performs the conversion.

impl From<IStr> for Arc<str>

fn from(v: IStr) -> Self

Performs the conversion.

impl From<IStr> for Rc<str>

fn from(v: IStr) -> Self

Performs the conversion.

impl<'a> From<IStr> for Cow<'a, str>

fn from(v: IStr) -> Self

Performs the conversion.

impl From<IStr> for Box<dyn Error>

fn from(v: IStr) -> Self

Performs the conversion.

impl From<IStr> for Box<dyn Error + Send + Sync>

fn from(v: IStr) -> Self

Performs the conversion.

impl From<IStr> for OsString

fn from(v: IStr) -> Self

Performs the conversion.

impl From<IStr> for PathBuf

fn from(v: IStr) -> Self

Performs the conversion.

impl From<IStr> for String

fn from(v: IStr) -> Self

Performs the conversion.

impl From<MowStr> for IStr

fn from(v: MowStr) -> Self

Performs the conversion.

impl From<Rc<str>> for IStr

fn from(s: Rc<str>) -> Self

Performs the conversion.

impl From<String> for IStr

fn from(v: String) -> Self

Performs the conversion.

impl From<char> for IStr

fn from(c: char) -> Self

Performs the conversion.

impl<'a> FromIterator<&'a char> for IStr

fn from_iter<T: IntoIterator<Item = &'a char>>(iter: T) -> Self

Creates a value from an iterator.

impl<'a> FromIterator<&'a str> for IStr

fn from_iter<T: IntoIterator<Item = &'a str>>(iter: T) -> Self

Creates a value from an iterator.

impl FromIterator<Box<str>> for IStr

fn from_iter<T: IntoIterator<Item = Box<str>>>(iter: T) -> Self

Creates a value from an iterator.

impl<'a> FromIterator<Cow<'a, str>> for IStr

fn from_iter<T: IntoIterator<Item = Cow<'a, str>>>(iter: T) -> Self

Creates a value from an iterator.

impl FromIterator<String> for IStr

fn from_iter<T: IntoIterator<Item = String>>(iter: T) -> Self

Creates a value from an iterator.

impl FromIterator<char> for IStr

fn from_iter<T: IntoIterator<Item = char>>(iter: T) -> Self

Creates a value from an iterator.

impl FromStr for IStr

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for IStr

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl<I: SliceIndex<str>> Index<I> for IStr

type Output = <I as SliceIndex<str>>::Output

The returned type after indexing.

fn index(&self, index: I) -> &Self::Output

Performs the indexing (container[index]) operation.

impl Interning for IStr

type Outern = IStr

fn interned(self) -> Self::Outern

Convert to Interning String

impl Muterning for IStr

type Outern = MowStr

fn muterned(self) -> Self::Outern

Convert to Mutable on Write Interning String

impl Ord for IStr

fn cmp(&self, other: &IStr) -> Ordering

This method returns an Ordering between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl<'_> PartialEq<&'_ OsStr> for IStr

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

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

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

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

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<IStr> for IStr

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

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

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

This method tests for !=.

impl PartialEq<OsStr> for IStr

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

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<OsString> for IStr

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

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<String> for IStr

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

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<str> for IStr

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

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialOrd<IStr> for IStr

fn partial_cmp(&self, other: &IStr) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &IStr) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &IStr) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &IStr) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &IStr) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralEq for IStr

impl StructuralPartialEq for IStr

impl ToSocketAddrs for IStr

type Iter = <str as ToSocketAddrs>::Iter

Returned iterator over socket addresses which this type may correspond to.

fn to_socket_addrs(&self) -> Result<Self::Iter>

Converts this object to an iterator of resolved SocketAddrs.

impl ToString for IStr

fn to_string(&self) -> String

Converts the given value to a String.