Struct xcb::Lat1String

pub struct Lat1String { /* private fields */ }

A struct owning a Latin-1 (aka. ISO 8859-1) string.

See Lat1Str for details.

Implementations

impl Lat1String

pub fn from_bytes(bytes: &[u8]) -> Self

Construct a Lat1String from a slice of bytes.

pub fn from_utf8(str: &str) -> Self

Construct a Lat1String from UTF-8 (a conversion to Latin-1 is performed).

Methods from Deref<Target = Lat1Str>

pub fn is_ascii(&self) -> bool

Checks whether the slice only contains ASCII characters.

pub fn len(&self) -> usize

Returns the number of characters in the string.

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

Returns the string as slice of bytes.

pub fn try_as_ascii(&self) -> Result<&str, Lat1Error>

Returns the string in UTF-8 encoding, only if the string is pure ASCII. Otherwise, a Lat1Error::NonAscii is returned.

pub fn as_ascii(&self) -> &str

Returns the string in UTF-8 encoding, only if the string is pure ASCII.

Panics

This function panics if the string contains non-ASCII chars.

pub unsafe fn as_ascii_unchecked(&self) -> &str

Returns the string in UTF-8 encoding.

Safety

If the string contains non-ASCII characters, the returned string will be invalid UTF-8.

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

Returns the string converted to UTF-8.

Cow::Borrowed is returned if the string is pure ASCII, otherwise a conversion to UTF-8 is performed and Cow::Owned is returned.

Trait Implementations

impl Borrow<Lat1Str> for Lat1String

fn borrow(&self) -> &Lat1Str

Immutably borrows from an owned value.

impl Clone for Lat1String

fn clone(&self) -> Lat1String

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Lat1String

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

Formats the value using the given formatter.

impl Deref for Lat1String

type Target = Lat1Str

The resulting type after dereferencing.

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

Dereferences the value.

impl Display for Lat1String

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

Formats the value using the given formatter.