//! Comparison traits for `[T]`. use super::{from_raw_parts, memchr}; use crate::ascii; use crate::cmp::{self, BytewiseEq, Ordering}; use crate::intrinsics::compare_bytes; use crate::num::NonZero; #[stable(feature = "rust1", since = "1.0.0")] impl PartialEq<[U]> for [T] where T: PartialEq, { fn eq(&self, other: &[U]) -> bool { SlicePartialEq::equal(self, other) } fn ne(&self, other: &[U]) -> bool { SlicePartialEq::not_equal(self, other) } } #[stable(feature = "rust1", since = "1.0.0")] impl Eq for [T] {} /// Implements comparison of slices [lexicographically](Ord#lexicographical-comparison). #[stable(feature = "rust1", since = "1.0.0")] impl Ord for [T] { fn cmp(&self, other: &[T]) -> Ordering { SliceOrd::compare(self, other) } } /// Implements comparison of slices [lexicographically](Ord#lexicographical-comparison). #[stable(feature = "rust1", since = "1.0.0")] impl PartialOrd for [T] { fn partial_cmp(&self, other: &[T]) -> Option { SlicePartialOrd::partial_compare(self, other) } } #[doc(hidden)] // intermediate trait for specialization of slice's PartialEq trait SlicePartialEq { fn equal(&self, other: &[B]) -> bool; fn not_equal(&self, other: &[B]) -> bool { !self.equal(other) } } // Generic slice equality impl SlicePartialEq for [A] where A: PartialEq, { default fn equal(&self, other: &[B]) -> bool { if self.len() != other.len() { return false; } // Implemented as explicit indexing rather // than zipped iterators for performance reasons. // See PR https://github.com/rust-lang/rust/pull/116846 for idx in 0..self.len() { // bound checks are optimized away if self[idx] != other[idx] { return false; } } true } } // When each element can be compared byte-wise, we can compare all the bytes // from the whole size in one call to the intrinsics. impl SlicePartialEq for [A] where A: BytewiseEq, { fn equal(&self, other: &[B]) -> bool { if self.len() != other.len() { return false; } // SAFETY: `self` and `other` are references and are thus guaranteed to be valid. // The two slices have been checked to have the same size above. unsafe { let size = size_of_val(self); compare_bytes(self.as_ptr() as *const u8, other.as_ptr() as *const u8, size) == 0 } } } #[doc(hidden)] // intermediate trait for specialization of slice's PartialOrd trait SlicePartialOrd: Sized { fn partial_compare(left: &[Self], right: &[Self]) -> Option; } impl SlicePartialOrd for A { default fn partial_compare(left: &[A], right: &[A]) -> Option { let l = cmp::min(left.len(), right.len()); // Slice to the loop iteration range to enable bound check // elimination in the compiler let lhs = &left[..l]; let rhs = &right[..l]; for i in 0..l { match lhs[i].partial_cmp(&rhs[i]) { Some(Ordering::Equal) => (), non_eq => return non_eq, } } left.len().partial_cmp(&right.len()) } } // This is the impl that we would like to have. Unfortunately it's not sound. // See `partial_ord_slice.rs`. /* impl SlicePartialOrd for A where A: Ord, { default fn partial_compare(left: &[A], right: &[A]) -> Option { Some(SliceOrd::compare(left, right)) } } */ impl SlicePartialOrd for A { fn partial_compare(left: &[A], right: &[A]) -> Option { Some(SliceOrd::compare(left, right)) } } #[rustc_specialization_trait] trait AlwaysApplicableOrd: SliceOrd + Ord {} macro_rules! always_applicable_ord { ($([$($p:tt)*] $t:ty,)*) => { $(impl<$($p)*> AlwaysApplicableOrd for $t {})* } } always_applicable_ord! { [] u8, [] u16, [] u32, [] u64, [] u128, [] usize, [] i8, [] i16, [] i32, [] i64, [] i128, [] isize, [] bool, [] char, [T: ?Sized] *const T, [T: ?Sized] *mut T, [T: AlwaysApplicableOrd] &T, [T: AlwaysApplicableOrd] &mut T, [T: AlwaysApplicableOrd] Option, } #[doc(hidden)] // intermediate trait for specialization of slice's Ord trait SliceOrd: Sized { fn compare(left: &[Self], right: &[Self]) -> Ordering; } impl SliceOrd for A { default fn compare(left: &[Self], right: &[Self]) -> Ordering { let l = cmp::min(left.len(), right.len()); // Slice to the loop iteration range to enable bound check // elimination in the compiler let lhs = &left[..l]; let rhs = &right[..l]; for i in 0..l { match lhs[i].cmp(&rhs[i]) { Ordering::Equal => (), non_eq => return non_eq, } } left.len().cmp(&right.len()) } } /// Marks that a type should be treated as an unsigned byte for comparisons. /// /// # Safety /// * The type must be readable as an `u8`, meaning it has to have the same /// layout as `u8` and always be initialized. /// * For every `x` and `y` of this type, `Ord(x, y)` must return the same /// value as `Ord::cmp(transmute::<_, u8>(x), transmute::<_, u8>(y))`. #[rustc_specialization_trait] unsafe trait UnsignedBytewiseOrd {} unsafe impl UnsignedBytewiseOrd for bool {} unsafe impl UnsignedBytewiseOrd for u8 {} unsafe impl UnsignedBytewiseOrd for NonZero {} unsafe impl UnsignedBytewiseOrd for Option> {} unsafe impl UnsignedBytewiseOrd for ascii::Char {} // `compare_bytes` compares a sequence of unsigned bytes lexicographically, so // use it if the requirements for `UnsignedBytewiseOrd` are fulfilled. impl SliceOrd for A { #[inline] fn compare(left: &[Self], right: &[Self]) -> Ordering { // Since the length of a slice is always less than or equal to // isize::MAX, this never underflows. let diff = left.len() as isize - right.len() as isize; // This comparison gets optimized away (on x86_64 and ARM) because the // subtraction updates flags. let len = if left.len() < right.len() { left.len() } else { right.len() }; let left = left.as_ptr().cast(); let right = right.as_ptr().cast(); // SAFETY: `left` and `right` are references and are thus guaranteed to // be valid. `UnsignedBytewiseOrd` is only implemented for types that // are valid u8s and can be compared the same way. We use the minimum // of both lengths which guarantees that both regions are valid for // reads in that interval. let mut order = unsafe { compare_bytes(left, right, len) as isize }; if order == 0 { order = diff; } order.cmp(&0) } } pub(super) trait SliceContains: Sized { fn slice_contains(&self, x: &[Self]) -> bool; } impl SliceContains for T where T: PartialEq, { default fn slice_contains(&self, x: &[Self]) -> bool { x.iter().any(|y| *y == *self) } } impl SliceContains for u8 { #[inline] fn slice_contains(&self, x: &[Self]) -> bool { memchr::memchr(*self, x).is_some() } } impl SliceContains for i8 { #[inline] fn slice_contains(&self, x: &[Self]) -> bool { let byte = *self as u8; // SAFETY: `i8` and `u8` have the same memory layout, thus casting `x.as_ptr()` // as `*const u8` is safe. The `x.as_ptr()` comes from a reference and is thus guaranteed // to be valid for reads for the length of the slice `x.len()`, which cannot be larger // than `isize::MAX`. The returned slice is never mutated. let bytes: &[u8] = unsafe { from_raw_parts(x.as_ptr() as *const u8, x.len()) }; memchr::memchr(byte, bytes).is_some() } } macro_rules! impl_slice_contains { ($($t:ty),*) => { $( impl SliceContains for $t { #[inline] fn slice_contains(&self, arr: &[$t]) -> bool { // Make our LANE_COUNT 4x the normal lane count (aiming for 128 bit vectors). // The compiler will nicely unroll it. const LANE_COUNT: usize = 4 * (128 / (size_of::<$t>() * 8)); // SIMD let mut chunks = arr.chunks_exact(LANE_COUNT); for chunk in &mut chunks { if chunk.iter().fold(false, |acc, x| acc | (*x == *self)) { return true; } } // Scalar remainder return chunks.remainder().iter().any(|x| *x == *self); } } )* }; } impl_slice_contains!(u16, u32, u64, i16, i32, i64, f32, f64, usize, isize, char);