Struct Char8 

pub struct Char8(/* private fields */);

An 8-bit unicode scalar value, limited to basic latin and latin-1 subsets.

This is the only scalar type without memory layout optimization because each possible value is a valid unicode scalar. Therefore Option<Char8> is the same size as Char16 or Option<Char16> (2 bytes).

See also: Char7, Char16, Char24, Char32, char.

Implementations

impl Char8

pub const fn byte_len(self) -> usize

Returns the number of bytes needed to represent the scalar value.

pub const fn len_utf8(self) -> usize

Returns the number of bytes needed to encode in UTF-8.

pub const fn len_utf16(self) -> usize

Returns the number of bytes needed to encode in UTF-16.

pub const fn to_digit(self, radix: u32) -> Option<u32>

Converts the scalar to a digit in the given radix.

‘Digit’ is defined to be only the following characters: 0-9, a-z, A-Z.

Errors

Returns None if the char does not refer to a digit in the given radix.

Panics

Panics if given a radix larger than 36.

pub const fn is_nul(self) -> bool

Returns true if this is the nul character (0x00).

pub const fn is_digit(self, radix: u32) -> bool

Checks if the unicode scalar is a digit in the given radix.

See also to_digit.

impl Char8

pub const MAX: Char8

The highest unicode scalar a Char8 can represent, '\u{FF}'.

pub const fn from_char7(c: Char7) -> Char8

Converts a Char7 to Char8.

pub const fn try_from_char16(c: Char16) -> Result<Char8>

Tries to convert a Char16 to Char8.

pub const fn try_from_char24(c: Char24) -> Result<Char8>

Tries to convert a Char24 to Char8.

pub const fn try_from_char32(c: Char32) -> Result<Char8>

Tries to convert a Char32 to Char8.

pub const fn try_from_char(c: char) -> Result<Char8>

Tries to convert a char to Char8.

pub const fn try_to_char7(self) -> Result<Char7>

Tries to convert this Char8 to Char7.

pub const fn to_char16(self) -> Char16

Converts this Char8 to Char16.

pub const fn to_char24(self) -> Char24

Converts this Char8 to Char24.

pub const fn to_char32(self) -> Char32

Converts this Char8 to Char32.

pub const fn to_char(self) -> char

Converts this Char8 to char.

pub const fn to_u32(self) -> u32

Converts this Char8 to u32.

pub const fn to_utf8_bytes(self) -> [u8; 2]

Converts this Char8 to an UTF-8 encoded sequence of bytes.

Note that this function always returns a 2-byte array, but the actual UTF-8 sequence may be shorter. The unused bytes are set to 0.

pub const fn is_noncharacter(self) -> bool

Returns true if this unicode scalar is a noncharacter.

pub const fn is_character(self) -> bool

Returns true if this unicode scalar is an abstract character.

pub const fn is_ascii(self) -> bool

Checks if the value is within the ASCII range.

pub const fn to_ascii_uppercase(self) -> Char8

Makes a copy of the value in its ASCII upper case equivalent.

ASCII letters ‘a’ to ‘z’ are mapped to ‘A’ to ‘Z’, but non-ASCII letters are unchanged.

pub const fn to_ascii_lowercase(self) -> Char8

Makes a copy of the value in its ASCII lower case equivalent.

ASCII letters ‘A’ to ‘Z’ are mapped to ‘a’ to ‘z’, but non-ASCII letters are unchanged.

Trait Implementations

impl Binary for Char8

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

Formats the value using the given formatter.

impl Chars for Char8

const MAX: Self = Self::MAX

The highest unicode scalar that can be represented by this type.

fn byte_len(self) -> usize

Returns the number of bytes needed to represent the scalar value.

fn len_utf8(self) -> usize

Returns the number of bytes needed to encode in UTF-8.

fn len_utf16(self) -> usize

Returns the number of bytes needed to encode in UTF-16.

fn encode_utf8(self, dst: &mut [u8]) -> &mut str

Encodes this scalar as UTF-8 into the provided byte buffer, and then returns the subslice of the buffer that contains the encoded scalar.

fn to_utf8_bytes(self) -> [u8; 4]

Converts this scalar to an UTF-8 encoded sequence of bytes.

fn encode_utf16(self, dst: &mut [u16]) -> &mut [u16]

Encodes this scalar as UTF-16 into the provided byte buffer, and then returns the subslice of the buffer that contains the encoded scalar.

fn to_digit(self, radix: u32) -> Option<u32>

Converts the scalar to a digit in the given radix.

fn to_ascii_uppercase(self) -> Self

Makes a copy of the value in its ASCII upper case equivalent.

fn to_ascii_lowercase(self) -> Self

Makes a copy of the value in its ASCII lower case equivalent.

fn is_noncharacter(self) -> bool

Returns true if this unicode scalar is a noncharacter.

fn is_digit(self, radix: u32) -> bool

Checks if the unicode scalar is a digit in the given radix.

fn is_control(self) -> bool

Returns true if this unicode scalar has the general category for control codes.

fn is_nul(self) -> bool

Returns true if this unicode scalar is the nul character (0x00).

fn is_alphabetic(self) -> bool

Returns true if this unicode scalar has the Alphabetic property.

fn is_numeric(self) -> bool

Returns true if this unicode scalar has one of the general categories for numbers.

fn is_alphanumeric(self) -> bool

Returns true if this unicode scalar satisfies either is_alphabetic() or is_numeric().

fn is_lowercase(self) -> bool

Returns true if this unicode scalar has the Lowercase property.

fn is_uppercase(self) -> bool

Returns true if this unicode scalar has the Lowercase property.

fn is_whitespace(self) -> bool

Returns true if this unicode scalar has the White_Space property.

fn is_ascii(self) -> bool

Checks if the value is within the ASCII range.

fn is_character(self) -> bool

where Self: Sized,

Returns true if this unicode scalar is an abstract character.

impl Clone for Char8

fn clone(&self) -> Char8

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Char8

impl Debug for Char8

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

Formats the value using the given formatter.

impl Default for Char8

Returns the default value of \x00 (nul character).

fn default() -> Self

Returns the “default value” for a type.

impl Display for Char8

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

Formats the value using the given formatter.

impl Eq for Char8

impl From<Char7> for Char8

fn from(c: Char7) -> Char8

Converts to this type from the input type.

impl From<Char8> for Char16

fn from(c: Char8) -> Char16

Converts to this type from the input type.

impl From<Char8> for Char24

fn from(c: Char8) -> Char24

Converts to this type from the input type.

impl From<Char8> for Char32

fn from(c: Char8) -> Char32

Converts to this type from the input type.

impl From<Char8> for char

fn from(c: Char8) -> char

Converts to this type from the input type.

impl From<Char8> for NonNulEgc16

fn from(c: Char8) -> NonNulEgc16

Converts to this type from the input type.

impl From<Char8> for NonNulEgc24

fn from(c: Char8) -> NonNulEgc24

Converts to this type from the input type.

impl From<Char8> for NonNulEgc32

fn from(c: Char8) -> NonNulEgc32

Converts to this type from the input type.

impl From<Char8> for NonNulEgc40

fn from(c: Char8) -> NonNulEgc40

Converts to this type from the input type.

impl From<Char8> for NonNulEgc48

fn from(c: Char8) -> NonNulEgc48

Converts to this type from the input type.

impl From<Char8> for NonNulEgc56

fn from(c: Char8) -> NonNulEgc56

Converts to this type from the input type.

impl From<Char8> for NonNulEgc64

fn from(c: Char8) -> NonNulEgc64

Converts to this type from the input type.

impl From<Char8> for NonNulEgc128

fn from(c: Char8) -> NonNulEgc128

Converts to this type from the input type.

impl From<Char8> for Egc24

fn from(c: Char8) -> Egc24

Converts to this type from the input type.

impl From<Char8> for Egc32

fn from(c: Char8) -> Egc32

Converts to this type from the input type.

impl From<Char8> for Egc40

fn from(c: Char8) -> Egc40

Converts to this type from the input type.

impl From<Char8> for Egc48

fn from(c: Char8) -> Egc48

Converts to this type from the input type.

impl From<Char8> for Egc56

fn from(c: Char8) -> Egc56

Converts to this type from the input type.

impl From<Char8> for Egc64

fn from(c: Char8) -> Egc64

Converts to this type from the input type.

impl From<Char8> for Egc128

fn from(c: Char8) -> Egc128

Converts to this type from the input type.

impl From<Char8> for NonNulString16

fn from(c: Char8) -> NonNulString16

Converts to this type from the input type.

impl From<Char8> for NonNulString24

fn from(c: Char8) -> NonNulString24

Converts to this type from the input type.

impl From<Char8> for NonNulString32

fn from(c: Char8) -> NonNulString32

Converts to this type from the input type.

impl From<Char8> for NonNulString40

fn from(c: Char8) -> NonNulString40

Converts to this type from the input type.

impl From<Char8> for NonNulString48

fn from(c: Char8) -> NonNulString48

Converts to this type from the input type.

impl From<Char8> for NonNulString56

fn from(c: Char8) -> NonNulString56

Converts to this type from the input type.

impl From<Char8> for NonNulString64

fn from(c: Char8) -> NonNulString64

Converts to this type from the input type.

impl From<Char8> for NonNulString128

fn from(c: Char8) -> NonNulString128

Converts to this type from the input type.

impl From<Char8> for NonNulString256

fn from(c: Char8) -> NonNulString256

Converts to this type from the input type.

impl From<Char8> for NonNulString512

fn from(c: Char8) -> NonNulString512

Converts to this type from the input type.

impl From<Char8> for NonNulString1024

fn from(c: Char8) -> NonNulString1024

Converts to this type from the input type.

impl From<Char8> for NonNulString2048

fn from(c: Char8) -> NonNulString2048

Converts to this type from the input type.

impl From<Char8> for String24

fn from(c: Char8) -> String24

Converts to this type from the input type.

impl From<Char8> for String32

fn from(c: Char8) -> String32

Converts to this type from the input type.

impl From<Char8> for String40

fn from(c: Char8) -> String40

Converts to this type from the input type.

impl From<Char8> for String48

fn from(c: Char8) -> String48

Converts to this type from the input type.

impl From<Char8> for String56

fn from(c: Char8) -> String56

Converts to this type from the input type.

impl From<Char8> for String64

fn from(c: Char8) -> String64

Converts to this type from the input type.

impl From<Char8> for String128

fn from(c: Char8) -> String128

Converts to this type from the input type.

impl From<Char8> for String256

fn from(c: Char8) -> String256

Converts to this type from the input type.

impl From<Char8> for String512

fn from(c: Char8) -> String512

Converts to this type from the input type.

impl From<Char8> for String1024

fn from(c: Char8) -> String1024

Converts to this type from the input type.

impl From<Char8> for String2048

fn from(c: Char8) -> String2048

Converts to this type from the input type.

impl Hash for Char8

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 LowerHex for Char8

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

Formats the value using the given formatter.

impl Octal for Char8

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

Formats the value using the given formatter.

impl Ord for Char8

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

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Char8

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Char8

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl Strings for Char8

impl StructuralPartialEq for Char8

impl TryFrom<Char8> for Char7

type Error = TextosError

The type returned in the event of a conversion error.

fn try_from(c: Char8) -> Result<Char7>

Performs the conversion.

impl TryFrom<Char8> for NonNulEgc8

type Error = TextosError

The type returned in the event of a conversion error.

fn try_from(c: Char8) -> Result<NonNulEgc8>

Performs the conversion.

impl TryFrom<Char8> for Egc16

type Error = TextosError

The type returned in the event of a conversion error.

fn try_from(c: Char8) -> Result<Egc16>

Performs the conversion.

impl TryFrom<Char8> for NonNulString8

type Error = TextosError

The type returned in the event of a conversion error.

fn try_from(c: Char8) -> Result<NonNulString8>

Performs the conversion.

impl TryFrom<Char8> for String16

type Error = TextosError

The type returned in the event of a conversion error.

fn try_from(c: Char8) -> Result<String16>

Performs the conversion.

impl TryFrom<Char16> for Char8

type Error = TextosError

The type returned in the event of a conversion error.

fn try_from(c: Char16) -> Result<Char8>

Performs the conversion.

impl TryFrom<Char24> for Char8

type Error = TextosError

The type returned in the event of a conversion error.

fn try_from(c: Char24) -> Result<Char8>

Performs the conversion.

impl TryFrom<Char32> for Char8

type Error = TextosError

The type returned in the event of a conversion error.

fn try_from(c: Char32) -> Result<Char8>

Performs the conversion.

impl TryFrom<char> for Char8

type Error = TextosError

The type returned in the event of a conversion error.

fn try_from(c: char) -> Result<Char8>

Performs the conversion.

impl UpperHex for Char8

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

Formats the value using the given formatter.