Struct Char16 

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

A 16-bit unicode scalar value, limited to the Basic Multilingual Plane subset.

It can represent every scalar from the Basic Multilingual Plane (BMP), the first and most important plane in the Unicode standard (also known as plane 0), containing nearly all commonly used writing systems and symbols.

Option<Char16> is the same size as Char16 (2 bytes).

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

Implementations

impl Char16

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 Char16

pub const MAX: Char16

The highest unicode scalar a Char16 can represent, '\u{FFFF}'.

Note that '\u{FFFF}' is a noncharacter.

pub const REPLACEMENT_CHARACTER: Char16

U+FFFD REPLACEMENT CHARACTER (�) is used in Unicode to represent a decoding error.

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

Converts a Char7 to Char16.

pub const fn from_char8(c: Char8) -> Char16

Converts a Char8 to Char16.

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

Tries to convert a Char24 to Char16.

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

Tries to convert a Char32 to Char16.

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

Tries to convert a char to Char16.

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

Tries to convert this Char16 to Char7.

pub const fn try_to_char8(self) -> Result<Char8>

Tries to convert this Char16 to Char8.

pub const fn to_char24(self) -> Char24

Converts this Char16 to Char24.

pub const fn to_char32(self) -> Char32

Converts this Char16 to Char32.

pub const fn to_char(self) -> char

Converts this Char16 to char.

pub const fn to_u32(self) -> u32

Converts this Char16 to u32.

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

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

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

pub const fn to_ascii_uppercase(self) -> Char16

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) -> Char16

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.

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.

Trait Implementations

impl Binary for Char16

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

Formats the value using the given formatter.

impl Chars for Char16

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 Char16

fn clone(&self) -> Char16

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Char16

impl Debug for Char16

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

Formats the value using the given formatter.

impl Default for Char16

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

fn default() -> Self

Returns the “default value” for a type.

impl Display for Char16

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

Formats the value using the given formatter.

impl Eq for Char16

impl From<Char7> for Char16

fn from(c: Char7) -> Char16

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<Char16> for Char24

fn from(c: Char16) -> Char24

Converts to this type from the input type.

impl From<Char16> for Char32

fn from(c: Char16) -> Char32

Converts to this type from the input type.

impl From<Char16> for char

fn from(c: Char16) -> char

Converts to this type from the input type.

impl From<Char16> for NonNulEgc24

fn from(c: Char16) -> NonNulEgc24

Converts to this type from the input type.

impl From<Char16> for NonNulEgc32

fn from(c: Char16) -> NonNulEgc32

Converts to this type from the input type.

impl From<Char16> for NonNulEgc40

fn from(c: Char16) -> NonNulEgc40

Converts to this type from the input type.

impl From<Char16> for NonNulEgc48

fn from(c: Char16) -> NonNulEgc48

Converts to this type from the input type.

impl From<Char16> for NonNulEgc56

fn from(c: Char16) -> NonNulEgc56

Converts to this type from the input type.

impl From<Char16> for NonNulEgc64

fn from(c: Char16) -> NonNulEgc64

Converts to this type from the input type.

impl From<Char16> for NonNulEgc128

fn from(c: Char16) -> NonNulEgc128

Converts to this type from the input type.

impl From<Char16> for Egc32

fn from(c: Char16) -> Egc32

Converts to this type from the input type.

impl From<Char16> for Egc40

fn from(c: Char16) -> Egc40

Converts to this type from the input type.

impl From<Char16> for Egc48

fn from(c: Char16) -> Egc48

Converts to this type from the input type.

impl From<Char16> for Egc56

fn from(c: Char16) -> Egc56

Converts to this type from the input type.

impl From<Char16> for Egc64

fn from(c: Char16) -> Egc64

Converts to this type from the input type.

impl From<Char16> for Egc128

fn from(c: Char16) -> Egc128

Converts to this type from the input type.

impl From<Char16> for NonNulString24

fn from(c: Char16) -> NonNulString24

Converts to this type from the input type.

impl From<Char16> for NonNulString32

fn from(c: Char16) -> NonNulString32

Converts to this type from the input type.

impl From<Char16> for NonNulString40

fn from(c: Char16) -> NonNulString40

Converts to this type from the input type.

impl From<Char16> for NonNulString48

fn from(c: Char16) -> NonNulString48

Converts to this type from the input type.

impl From<Char16> for NonNulString56

fn from(c: Char16) -> NonNulString56

Converts to this type from the input type.

impl From<Char16> for NonNulString64

fn from(c: Char16) -> NonNulString64

Converts to this type from the input type.

impl From<Char16> for NonNulString128

fn from(c: Char16) -> NonNulString128

Converts to this type from the input type.

impl From<Char16> for NonNulString256

fn from(c: Char16) -> NonNulString256

Converts to this type from the input type.

impl From<Char16> for NonNulString512

fn from(c: Char16) -> NonNulString512

Converts to this type from the input type.

impl From<Char16> for NonNulString1024

fn from(c: Char16) -> NonNulString1024

Converts to this type from the input type.

impl From<Char16> for NonNulString2048

fn from(c: Char16) -> NonNulString2048

Converts to this type from the input type.

impl From<Char16> for String32

fn from(c: Char16) -> String32

Converts to this type from the input type.

impl From<Char16> for String40

fn from(c: Char16) -> String40

Converts to this type from the input type.

impl From<Char16> for String48

fn from(c: Char16) -> String48

Converts to this type from the input type.

impl From<Char16> for String56

fn from(c: Char16) -> String56

Converts to this type from the input type.

impl From<Char16> for String64

fn from(c: Char16) -> String64

Converts to this type from the input type.

impl From<Char16> for String128

fn from(c: Char16) -> String128

Converts to this type from the input type.

impl From<Char16> for String256

fn from(c: Char16) -> String256

Converts to this type from the input type.

impl From<Char16> for String512

fn from(c: Char16) -> String512

Converts to this type from the input type.

impl From<Char16> for String1024

fn from(c: Char16) -> String1024

Converts to this type from the input type.

impl From<Char16> for String2048

fn from(c: Char16) -> String2048

Converts to this type from the input type.

impl Hash for Char16

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 Char16

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

Formats the value using the given formatter.

impl Octal for Char16

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

Formats the value using the given formatter.

impl Ord for Char16

fn cmp(&self, other: &Char16) -> 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 Char16

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Char16

fn partial_cmp(&self, other: &Char16) -> 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 Char16

impl StructuralPartialEq for Char16

impl TryFrom<Char16> for Char7

type Error = TextosError

The type returned in the event of a conversion error.

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

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<Char16> for NonNulEgc8

type Error = TextosError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Char16> for NonNulEgc16

type Error = TextosError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Char16> for Egc16

type Error = TextosError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Char16> for Egc24

type Error = TextosError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Char16> for NonNulString8

type Error = TextosError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Char16> for NonNulString16

type Error = TextosError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Char16> for String16

type Error = TextosError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Char16> for String24

type Error = TextosError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Char24> for Char16

type Error = TextosError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Char32> for Char16

type Error = TextosError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<char> for Char16

type Error = TextosError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl UpperHex for Char16

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

Formats the value using the given formatter.