/rust/registry/src/index.crates.io-1949cf8c6b5b557f/tinystr-0.8.1/src/ule.rs
Line | Count | Source |
1 | | // This file is part of ICU4X. For terms of use, please see the file |
2 | | // called LICENSE at the top level of the ICU4X source tree |
3 | | // (online at: https://github.com/unicode-org/icu4x/blob/main/LICENSE ). |
4 | | |
5 | | use crate::{TinyAsciiStr, UnvalidatedTinyAsciiStr}; |
6 | | #[cfg(feature = "alloc")] |
7 | | use zerovec::maps::ZeroMapKV; |
8 | | use zerovec::ule::*; |
9 | | #[cfg(feature = "alloc")] |
10 | | use zerovec::{ZeroSlice, ZeroVec}; |
11 | | |
12 | | // Safety (based on the safety checklist on the ULE trait): |
13 | | // 1. TinyAsciiStr does not include any uninitialized or padding bytes. |
14 | | // (achieved by `#[repr(transparent)]` on a type that satisfies this invariant) |
15 | | // 2. TinyAsciiStr is aligned to 1 byte. |
16 | | // (achieved by `#[repr(transparent)]` on a type that satisfies this invariant) |
17 | | // 3. The impl of validate_bytes() returns an error if any byte is not valid. |
18 | | // 4. The impl of validate_bytes() returns an error if there are extra bytes. |
19 | | // 5. The other ULE methods use the default impl. |
20 | | // 6. TinyAsciiStr byte equality is semantic equality |
21 | | unsafe impl<const N: usize> ULE for TinyAsciiStr<N> { |
22 | | #[inline] |
23 | 0 | fn validate_bytes(bytes: &[u8]) -> Result<(), UleError> { |
24 | 0 | if bytes.len() % N != 0 { |
25 | 0 | return Err(UleError::length::<Self>(bytes.len())); |
26 | 0 | } |
27 | | // Validate the bytes |
28 | 0 | for chunk in bytes.chunks_exact(N) { |
29 | 0 | let _ = TinyAsciiStr::<N>::try_from_utf8_inner(chunk, true) |
30 | 0 | .map_err(|_| UleError::parse::<Self>())?; |
31 | | } |
32 | 0 | Ok(()) |
33 | 0 | } |
34 | | } |
35 | | |
36 | | impl<const N: usize> NicheBytes<N> for TinyAsciiStr<N> { |
37 | | // AsciiByte is 0..128 |
38 | | const NICHE_BIT_PATTERN: [u8; N] = [255; N]; |
39 | | } |
40 | | |
41 | | impl<const N: usize> AsULE for TinyAsciiStr<N> { |
42 | | type ULE = Self; |
43 | | |
44 | | #[inline] |
45 | 0 | fn to_unaligned(self) -> Self::ULE { |
46 | 0 | self |
47 | 0 | } |
48 | | |
49 | | #[inline] |
50 | 0 | fn from_unaligned(unaligned: Self::ULE) -> Self { |
51 | 0 | unaligned |
52 | 0 | } |
53 | | } |
54 | | |
55 | | #[cfg(feature = "alloc")] |
56 | | impl<'a, const N: usize> ZeroMapKV<'a> for TinyAsciiStr<N> { |
57 | | type Container = ZeroVec<'a, TinyAsciiStr<N>>; |
58 | | type Slice = ZeroSlice<TinyAsciiStr<N>>; |
59 | | type GetType = TinyAsciiStr<N>; |
60 | | type OwnedType = TinyAsciiStr<N>; |
61 | | } |
62 | | |
63 | | // Safety (based on the safety checklist on the ULE trait): |
64 | | // 1. UnvalidatedTinyAsciiStr does not include any uninitialized or padding bytes. |
65 | | // (achieved by `#[repr(transparent)]` on a type that satisfies this invariant) |
66 | | // 2. UnvalidatedTinyAsciiStr is aligned to 1 byte. |
67 | | // (achieved by `#[repr(transparent)]` on a type that satisfies this invariant) |
68 | | // 3. The impl of validate_bytes() returns an error if any byte is not valid. |
69 | | // 4. The impl of validate_bytes() returns an error if there are extra bytes. |
70 | | // 5. The other ULE methods use the default impl. |
71 | | // 6. UnvalidatedTinyAsciiStr byte equality is semantic equality |
72 | | unsafe impl<const N: usize> ULE for UnvalidatedTinyAsciiStr<N> { |
73 | | #[inline] |
74 | 0 | fn validate_bytes(bytes: &[u8]) -> Result<(), UleError> { |
75 | 0 | if bytes.len() % N != 0 { |
76 | 0 | return Err(UleError::length::<Self>(bytes.len())); |
77 | 0 | } |
78 | 0 | Ok(()) |
79 | 0 | } |
80 | | } |
81 | | |
82 | | impl<const N: usize> AsULE for UnvalidatedTinyAsciiStr<N> { |
83 | | type ULE = Self; |
84 | | |
85 | | #[inline] |
86 | 0 | fn to_unaligned(self) -> Self::ULE { |
87 | 0 | self |
88 | 0 | } |
89 | | |
90 | | #[inline] |
91 | 0 | fn from_unaligned(unaligned: Self::ULE) -> Self { |
92 | 0 | unaligned |
93 | 0 | } |
94 | | } |
95 | | |
96 | | #[cfg(feature = "alloc")] |
97 | | impl<'a, const N: usize> ZeroMapKV<'a> for UnvalidatedTinyAsciiStr<N> { |
98 | | type Container = ZeroVec<'a, UnvalidatedTinyAsciiStr<N>>; |
99 | | type Slice = ZeroSlice<UnvalidatedTinyAsciiStr<N>>; |
100 | | type GetType = UnvalidatedTinyAsciiStr<N>; |
101 | | type OwnedType = UnvalidatedTinyAsciiStr<N>; |
102 | | } |
103 | | |
104 | | #[cfg(test)] |
105 | | mod test { |
106 | | use crate::*; |
107 | | use zerovec::*; |
108 | | |
109 | | #[test] |
110 | | fn test_zerovec() { |
111 | | let mut vec = ZeroVec::<TinyAsciiStr<7>>::new(); |
112 | | |
113 | | vec.with_mut(|v| v.push("foobar".parse().unwrap())); |
114 | | vec.with_mut(|v| v.push("baz".parse().unwrap())); |
115 | | vec.with_mut(|v| v.push("quux".parse().unwrap())); |
116 | | |
117 | | let bytes = vec.as_bytes(); |
118 | | |
119 | | let vec: ZeroVec<TinyAsciiStr<7>> = ZeroVec::parse_bytes(bytes).unwrap(); |
120 | | |
121 | | assert_eq!(&*vec.get(0).unwrap(), "foobar"); |
122 | | assert_eq!(&*vec.get(1).unwrap(), "baz"); |
123 | | assert_eq!(&*vec.get(2).unwrap(), "quux"); |
124 | | } |
125 | | } |