Struct raw_string::RawString

pub struct RawString { /* private fields */ }

A String with unchecked contents.

It is basically a Vec<u8>, to be interpreted as string. Unlike String, there are no guarantees about the contents being valid UTF-8. Unlike Vec<u8>, its Display and Debug implementations show a string, not an array of numbers.

Implementations

impl RawString

pub fn new() -> Self

pub fn with_capacity(capacity: usize) -> Self

pub fn from_bytes(bytes: Vec<u8>) -> Self

pub fn from_string(bytes: String) -> Self

pub fn into_bytes(self) -> Vec<u8>

pub fn capacity(&self) -> usize

pub fn reserve(&mut self, additional: usize)

pub fn reserve_exact(&mut self, additional: usize)

pub fn shrink_to_fit(&mut self)

pub fn clear(&mut self)

pub fn truncate(&mut self, new_len: usize)

pub fn pop(&mut self) -> Option<u8>

pub fn remove(&mut self, idx: usize) -> u8

pub fn retain<F: FnMut(u8) -> bool>(&mut self, f: F)

pub fn insert(&mut self, idx: usize, b: u8)

pub fn insert_str<T: AsRef<RawStr>>(&mut self, idx: usize, s: T)

pub fn split_off(&mut self, at: usize) -> RawString

pub fn drain<R: RangeBounds<usize>>(&mut self, range: R) -> Drain<'_, u8>

pub fn replace_range<R: RangeBounds<usize>, T: AsRef<RawStr>>(
    &mut self,
    range: R,
    replace_with: T
)

pub fn into_boxed_raw_str(self) -> Box<RawStr>

pub fn push(&mut self, b: u8)

pub fn push_str<T: AsRef<RawStr>>(&mut self, s: T)

pub fn as_mut_bytes(&mut self) -> &mut Vec<u8>

pub fn to_string(self) -> Result<String, FromUtf8Error>

pub fn to_osstring(self) -> Result<OsString, FromUtf8Error>

Convert to an OsString.

On Unix, it never fails. On other platforms, it must be encoded as UTF-8.

A never-failing version for Unix only is available as unix::RawStringExt::into_osstring.

pub fn to_pathbuf(self) -> Result<PathBuf, FromUtf8Error>

Convert to a PathBuf.

On Unix, it never fails. On other platforms, it must be encoded as UTF-8.

A never-failing version for Unix only is available as unix::RawStringExt::into_pathbuf.

Methods from Deref<Target = RawStr>

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

pub fn as_bytes_mut(&mut self) -> &mut [u8]

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn as_ptr(&self) -> *const u8

pub fn first(&self) -> Option<u8>

pub fn first_mut(&mut self) -> Option<&mut u8>

pub fn last(&self) -> Option<u8>

pub fn last_mut(&mut self) -> Option<&mut u8>

pub fn split_first(&self) -> Option<(u8, &RawStr)>

pub fn split_first_mut(&mut self) -> Option<(&mut u8, &mut RawStr)>

pub fn split_last(&self) -> Option<(u8, &RawStr)>

pub fn split_last_mut(&mut self) -> Option<(&mut u8, &mut RawStr)>

pub fn split_at(&self, mid: usize) -> (&RawStr, &RawStr)

pub fn split_at_mut(&mut self, mid: usize) -> (&mut RawStr, &mut RawStr)

pub fn contains_byte(&self, x: u8) -> bool

pub fn starts_with<T: AsRef<RawStr>>(&self, x: T) -> bool

pub fn ends_with<T: AsRef<RawStr>>(&self, x: T) -> bool

pub fn get<I: RawStrIndex>(&self, index: I) -> Option<&I::Output>

pub fn get_mut<I: RawStrIndex>(&mut self, index: I) -> Option<&mut I::Output>

pub unsafe fn get_unchecked<I: RawStrIndex>(&self, index: I) -> &I::Output

pub unsafe fn get_unchecked_mut<I: RawStrIndex>(
    &mut self,
    index: I
) -> &mut I::Output

pub unsafe fn slice_unchecked(&self, begin: usize, end: usize) -> &RawStr

pub unsafe fn slice_mut_unchecked(
    &mut self,
    begin: usize,
    end: usize
) -> &mut RawStr

pub fn bytes(&self) -> Cloned<Iter<'_, u8>>

pub fn bytes_mut(&mut self) -> IterMut<'_, u8>

pub fn utf8_chunks(&self) -> Utf8ChunksIter<'_>

Iterate over chunks of valid UTF-8.

The iterator iterates over the chunks of valid UTF-8 separated by any broken characters, which could be replaced by the unicode replacement character.

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

pub fn to_osstr(&self) -> Result<&OsStr, Utf8Error>

Convert to an OsStr.

On Unix, it never fails. On other platforms, it must be encoded as UTF-8.

A never-failing version for Unix only is available as unix::RawStrExt::as_osstr.

pub fn to_path(&self) -> Result<&Path, Utf8Error>

Convert to a Path.

On Unix, it never fails. On other platforms, it must be encoded as UTF-8.

A never-failing version for Unix only is available as unix::RawStrExt::as_path.

pub fn is_ascii(&self) -> bool

pub fn eq_ignore_ascii_case(&self, other: &RawStr) -> bool

pub fn make_ascii_uppercase(&mut self)

pub fn make_ascii_lowercase(&mut self)

Trait Implementations

impl AsRef<[u8]> for RawString

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

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

impl AsRef<RawStr> for RawString

fn as_ref(&self) -> &RawStr

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

impl Borrow<RawStr> for RawString

fn borrow(&self) -> &RawStr

Immutably borrows from an owned value.

impl Clone for RawString

fn clone(&self) -> RawString

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RawString

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

Formats the value using the given formatter.

impl Default for RawString

fn default() -> RawString

Returns the “default value” for a type.

impl Deref for RawString

type Target = RawStr

The resulting type after dereferencing.

fn deref(&self) -> &RawStr

Dereferences the value.

impl DerefMut for RawString

fn deref_mut(&mut self) -> &mut RawStr

Mutably dereferences the value.

impl Display for RawString

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

Formats the value using the given formatter.

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

fn from(src: &'a [u8]) -> RawString

Converts to this type from the input type.

impl<'a> From<&'a RawStr> for RawString

fn from(src: &'a RawStr) -> RawString

Converts to this type from the input type.

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

fn from(src: &'a str) -> RawString

Converts to this type from the input type.

impl From<String> for RawString

fn from(src: String) -> RawString

Converts to this type from the input type.

impl From<Vec<u8, Global>> for RawString

fn from(src: Vec<u8>) -> RawString

Converts to this type from the input type.

impl Hash for RawString

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<'a> IntoIterator for &'a RawString

type Item = u8

The type of the elements being iterated over.

type IntoIter = Cloned<Iter<'a, u8>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a> IntoIterator for &'a mut RawString

type Item = &'a mut u8

The type of the elements being iterated over.

type IntoIter = IterMut<'a, u8>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for RawString

type Item = u8

The type of the elements being iterated over.

type IntoIter = IntoIter<u8, Global>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl Ord for RawString

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

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere
    Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere
    Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere
    Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<&[u8]> for RawString

fn eq(&self, other: &&[u8]) -> bool

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

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

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

impl PartialEq<&RawStr> for RawString

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

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

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

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

impl PartialEq<&str> for RawString

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

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

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

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

impl PartialEq<[u8]> for RawString

fn eq(&self, other: &[u8]) -> bool

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

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

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

impl PartialEq<RawStr> for RawString

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

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

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

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

impl PartialEq<RawString> for &[u8]

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

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

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

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

impl PartialEq<RawString> for &RawStr

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

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

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

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

impl PartialEq<RawString> for &str

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

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

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

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

impl PartialEq<RawString> for [u8]

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

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

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

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

impl PartialEq<RawString> for RawStr

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

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

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

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

impl PartialEq<RawString> for RawString

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

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

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

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

impl PartialEq<RawString> for str

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

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

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

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

impl PartialEq<str> for RawString

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

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

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

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

impl PartialOrd<&[u8]> for RawString

fn partial_cmp(&self, other: &&[u8]) -> Option<Ordering>

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

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

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

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

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

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

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

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

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

impl PartialOrd<&RawStr> for RawString

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

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

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

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

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

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

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

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

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

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

impl PartialOrd<&str> for RawString

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

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

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

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

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

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

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

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

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

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

impl PartialOrd<[u8]> for RawString

fn partial_cmp(&self, other: &[u8]) -> Option<Ordering>

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

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

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

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

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

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

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

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

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

impl PartialOrd<RawStr> for RawString

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

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

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

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

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

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

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

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

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

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

impl PartialOrd<RawString> for &[u8]

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

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

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

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

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

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

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

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

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

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

impl PartialOrd<RawString> for &RawStr

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

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

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

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

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

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

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

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

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

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

impl PartialOrd<RawString> for &str

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

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

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

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

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

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

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

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

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

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

impl PartialOrd<RawString> for [u8]

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

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

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

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

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

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

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

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

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

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

impl PartialOrd<RawString> for RawStr

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

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

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

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

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

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

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

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

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

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

impl PartialOrd<RawString> for RawString

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

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

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

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

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

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

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

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

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

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

impl PartialOrd<RawString> for str

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

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

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

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

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

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

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

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

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

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

impl PartialOrd<str> for RawString

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

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

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

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

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

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

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

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

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

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

impl RawStringExt for RawString

Conversions only available on unix.

fn into_osstring(self) -> OsString

fn into_pathbuf(self) -> PathBuf

impl Eq for RawString

impl StructuralEq for RawString

impl StructuralPartialEq for RawString