Struct LxStr

pub struct LxStr { /* private fields */ }

A borrowed reference to a string that may or may not be valid utf-8.

This is analogous to OsStr on Linux, but behaves the same on all platforms.

Implementations

impl LxStr

pub fn new<T: AsRef<LxStr> + ?Sized>(s: &T) -> &LxStr

Coerces into an LxStr slice.

pub fn from_bytes(slice: &[u8]) -> &LxStr

Creates an LxStr from a byte slice.

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

Gets the underlying byte view of the LxStr slice.

pub fn to_lx_string(&self) -> LxString

Copies the slice into an owned LxString.

pub fn len(&self) -> usize

Returns the length of this LxStr.

pub fn is_empty(&self) -> bool

Checks whether the LxStr is empty.

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

Yields a &str slice if the LxStr is valid Unicode.

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

Convert an LxStr to a Cow<str>.

Any non-Unicode sequences are replaced with U+FFFD REPLACEMENT CHARACTER.

Trait Implementations

impl AsRef<LxStr> for LxStr

fn as_ref(&self) -> &LxStr

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

impl AsRef<LxStr> for LxString

fn as_ref(&self) -> &LxStr

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

impl AsRef<LxStr> for String

fn as_ref(&self) -> &LxStr

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

impl AsRef<LxStr> for str

fn as_ref(&self) -> &LxStr

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

impl Borrow<LxStr> for LxString

fn borrow(&self) -> &LxStr

Immutably borrows from an owned value.

impl Debug for LxStr

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

Formats the value using the given formatter.

impl Hash for LxStr

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

Feeds this value into the given Hasher.

impl PartialEq<LxStr> for str

fn eq(&self, other: &LxStr) -> 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<str> for LxStr

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 LxStr

fn eq(&self, other: &LxStr) -> 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 ToOwned for LxStr

type Owned = LxString

The resulting type after obtaining ownership.

fn to_owned(&self) -> Self::Owned

Creates owned data from borrowed data, usually by cloning.

fn clone_into(&self, target: &mut Self::Owned)

Uses borrowed data to replace owned data, usually by cloning.

impl Eq for LxStr

impl StructuralPartialEq for LxStr