devela/text/char/impls/
mod.rs

Help
1// devela::text::char::impls
2//
3//!
4//
5// TOC
6// - specific implementations
7// - common implementations
8
9#[allow(unused_imports)]
10use super::*; // char*
11
12/* specific implementations */
13
14mod c;
15#[cfg(feature = "_char16")]
16mod c16;
17#[cfg(feature = "_char7")]
18mod c7;
19#[cfg(feature = "_char8")]
20mod c8;
21
22/* common implementations */
23
24/// implements `UnicodeScalar` for custom char types.
25macro_rules! impl_char {
26    () => {
27        impl_char![7|"_char7", 8|"_char8", 16|"_char16"];
28    };
29    ($( $bits:literal | $feature:literal ),+ ) => { $crate::paste! {
30        $(
31            #[cfg(feature = $feature)]
32            impl_char!(@[<char $bits>]);
33        )+
34    }};
35    (@$name:ident) => {
36
37        /* impl traits */
38
39        impl UnicodeScalar for $name {
40            const MIN: Self = Self::MIN;
41            const MAX: Self = Self::MAX;
42
43            /* encode */
44
45            fn byte_len(self) -> usize { self.byte_len() }
46            fn len_utf8(self) -> usize { self.len_utf8() }
47            fn len_utf16(self) -> usize { self.len_utf16() }
48            fn encode_utf8(self, dst: &mut [u8]) -> &mut str {
49                self.to_char().encode_utf8(dst)
50            }
51            fn to_utf8_bytes(self) -> [u8; 4] {
52                let dyn_array = self.to_utf8_bytes();
53                let mut array = [0u8; 4];
54                for i in 0..dyn_array.len() {
55                    array[i] = dyn_array[i];
56                }
57                array
58            }
59            fn encode_utf16(self, dst: &mut [u16]) -> &mut [u16] {
60                self.to_char().encode_utf16(dst)
61            }
62            fn to_digit(self, radix: u32) -> Option<u32> { self.to_digit(radix) }
63            fn to_ascii_uppercase(self) -> Self { self.to_ascii_uppercase() }
64            fn to_ascii_lowercase(self) -> Self { self.to_ascii_lowercase() }
65
66            /* queries */
67
68            fn is_noncharacter(self) -> bool { self.is_noncharacter() }
69            fn is_digit(self, radix: u32) -> bool { self.is_digit(radix) }
70            //
71            fn is_control(self) -> bool { self.to_char().is_control() }
72            fn is_nul(self) -> bool { self.is_nul() }
73            fn is_alphabetic(self) -> bool { self.to_char().is_alphabetic() }
74            fn is_numeric(self) -> bool { self.to_char().is_numeric() }
75            fn is_alphanumeric(self) -> bool { self.to_char().is_alphanumeric() }
76            fn is_lowercase(self) -> bool { self.to_char().is_lowercase() }
77            fn is_uppercase(self) -> bool { self.to_char().is_uppercase() }
78            fn is_whitespace(self) -> bool { self.to_char().is_whitespace() }
79            //
80            fn is_ascii(self) -> bool { self.is_ascii() }
81        }
82
83        /* impl const fns */
84
85        impl $name {
86            /* encode */
87
88            /// Returns the number of bytes needed to represent the scalar value.
89            #[must_use]
90            pub const fn byte_len(self) -> usize { Char::byte_len(self.to_u32()) }
91
92            /// Returns the number of bytes needed to encode in UTF-8.
93            #[must_use]
94            pub const fn len_utf8(self) -> usize { self.to_char().len_utf8() }
95
96            /// Returns the number of bytes needed to encode in UTF-16.
97            #[must_use]
98            pub const fn len_utf16(self) -> usize { self.to_char().len_utf16() }
99
100            /// Converts the scalar to a digit in the given radix.
101            ///
102            /// ‘Digit’ is defined to be only the following characters:
103            /// `0-9`, `a-z`, `A-Z`.
104            ///
105            /// # Errors
106            /// Returns None if the char does not refer to a digit in the given radix.
107            ///
108            /// # Panics
109            /// Panics if given a radix larger than 36.
110            #[must_use]
111            pub const fn to_digit(self, radix: u32) -> Option<u32> {
112                self.to_char().to_digit(radix)
113            }
114
115            /* queries */
116
117            /// Returns `true` if this is the nul character (`0x00`).
118            #[must_use]
119            pub const fn is_nul(self) -> bool { self.to_u32() == 0 }
120
121            /// Checks if the unicode scalar is a digit in the given radix.
122            ///
123            /// See also [`to_digit`][Self#method.to_digit].
124            #[must_use]
125            pub const fn is_digit(self, radix: u32) -> bool {
126                if let Some(_) = self.to_digit(radix) { true } else { false }
127            }
128        }
129    };
130}
131impl_char!();
devela/text/char/impls/mod.rs

devela/text/char/impls/
mod.rs
