Struct ImmutableString 

pub struct ImmutableString<TAllocator: Allocator> { /* private fields */ }

This struct is a smart pointer around a string. Internally keeps reference counters for both strong and weak references. Cloning the struct is therefore cheap.

Implementations

impl<TAllocator: Allocator> ImmutableString<TAllocator>

pub fn empty() -> Result<Self, ImmutableStringError>

Creates a new, empty ImmutableString.

This function allocates under the hood, since all immutable strings are backed by smart pointer.

Errors

For details see ImmutableStringError.

pub fn from_str_slice(text: &str) -> Result<Self, ImmutableStringError>

Creates a new ImmutableString out of passed string slice.

This function allocates under the hood, since all immutable strings are backed by smart pointer. It also copies the input into the output’s buffer.

Errors

For details see ImmutableStringError.

pub fn from_str_slice_and_allocator( text: &str, allocator: TAllocator, ) -> Result<Self, ImmutableStringError>

Creates a new ImmutableString out of passed string slice and allocator.

This function allocates under the hood, since all immutable strings are backed by smart pointer. It also copies the input into the output’s buffer.

Errors

For details see ImmutableStringError.

pub fn empty_with_allocator( allocator: TAllocator, ) -> Result<Self, ImmutableStringError>

Creates a new, empty ImmutableString with a given allocator.

This function allocates under the hood, since all immutable strings are backed by smart pointer.

Errors

For details see ImmutableStringError.

pub fn strong_count(&self) -> u32

pub fn weak_count(&self) -> u32

pub const fn as_str(&self) -> &str

Returns the underlying string.

pub const fn as_c_str(&self) -> &str

Returns the underlying string as C-string.

Meaning the string has an additional 0 at the end of the buffer. In particular, the C-string returned by this method has length +1 compared to ImmutableString::as_str call.

pub const fn length(&self) -> Length

The length of the string.

pub fn downgrade(&self) -> WeakImmutableString<TAllocator>

Creates a new WeakImmutableString out of current.

pub fn abandon(self) -> Option<WeakImmutableString<TAllocator>>

Abandons current ImmutableString.

This function returns None if the underlying strong reference counter is still positive. Otherwise it returns the final WeakImmutableString reference.

Trait Implementations

impl<TAllocator: Allocator> AsRef<str> for ImmutableString<TAllocator>

fn as_ref(&self) -> &str

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

impl<TAllocator: Allocator> Borrow<str> for ImmutableString<TAllocator>

fn borrow(&self) -> &str

Immutably borrows from an owned value.

impl<TAllocator: Allocator> Clone for ImmutableString<TAllocator>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<TAllocator: Debug + Allocator> Debug for ImmutableString<TAllocator>

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

Formats the value using the given formatter.

impl<TAllocator: Allocator> Drop for ImmutableString<TAllocator>

fn drop(&mut self)

Executes the destructor for this type.

impl<TAllocator: Allocator> Hash for ImmutableString<TAllocator>

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<TAllocator: Allocator, TRight: AsRef<str>> PartialEq<TRight> for ImmutableString<TAllocator>

fn eq(&self, other: &TRight) -> 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<TAllocator: Allocator> ReprC for ImmutableString<TAllocator>

const CHECK: ()

This field is used for const checks only.

impl<TAllocator: Allocator> Eq for ImmutableString<TAllocator>