Text of rust.docs.kernel.org › next › core › cmp › trait.Eq.html as Styx crawled it on Nov 18, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Eq in core::cmp - Rust

Skip to main content Eq core :: cmp Trait Eq 1.6.0 (const: unstable ) · Source pub trait Eq: PartialEq <Self> + PointeeSized { } Expand description Trait for comparisons corresponding to equivalence relations . The primary difference to PartialEq is the additional requirement for reflexivity. A type that implements PartialEq guarantees that for all a , b and c : symmetric: a == b implies b == a transitive: a == b and b == c implies a == c consistent: a != b if and only if !(a == b) Eq , which builds on top of PartialEq also implies: reflexive: a == a This property cannot be checked by the compiler, and therefore Eq is a trait without methods.

Violating this property is a logic error. The behavior resulting from a logic error is not specified, but users of the trait must ensure that such logic errors do not result in undefined behavior. This means that unsafe code must not rely on the correctness of these methods. Floating point types such as f32 and f64 implement only PartialEq but not Eq because NaN != NaN . § Derivable This trait can be used with #[derive] .

When derive d, because Eq has no extra methods, it is only informing the compiler that this is an equivalence relation rather than a partial equivalence relation. Note that the derive strategy requires all fields are Eq , which isn’t always desired. § How can I implement Eq ? If you cannot use the derive strategy, specify that your type implements Eq , which has no extra methods: enum BookFormat { Paperback, Hardback, Ebook, } struct Book { isbn: i32, format: BookFormat, } impl PartialEq for Book { fn eq( & self , other: & Self ) -> bool { self .isbn == other.isbn } } impl Eq for Book {} Dyn Compatibility § This trait is not dyn compatible .

In older versions of Rust, dyn compatibility was called "object safety". Implementors § 1.100.0 (const: unstable ) · Source § impl Eq for ! 1.0.0 (const: unstable ) · Source § impl Eq for () Source § impl Eq for Abi 1.0.0 · Source § impl Eq for AddrParseError 1.102.0 (const: unstable ) · Source § impl Eq for core::mem:: Alignment 1.28.0 · Source § impl Eq for core::fmt:: Alignment 1.100.0 · Source § impl Eq for AllocError Source § impl Eq for AsciiChar Source § impl Eq for Assume Source § impl Eq for AtomicOrdering Source § impl Eq for ByteStr 1.64.0 (const: unstable ) · Source § impl Eq for CStr Source § impl Eq for CharCase 1.34.0 · Source § impl Eq for CharTryFromError 1.27.0 · Source § impl Eq for CpuidResult Available on x86 or x86-64 only.

Source § impl Eq for DebugAsHex 1.9.0 · Source § impl Eq for DecodeUtf16Error 1.3.0 · Source § impl Eq for Duration 1.0.0 · Source § impl Eq for Error 1.0.0 · Source § impl Eq for ErrorKind Source § impl Eq for FieldId Source § impl Eq for FormattingOptions 1.0.0 · Source § impl Eq for FpCategory 1.69.0 · Source § impl Eq for FromBytesUntilNulError 1.64.0 · Source § impl Eq for FromBytesWithNulError 1.86.0 · Source § impl Eq for GetDisjointMutError 1.55.0 · Source § impl Eq for IntErrorKind 1.7.0 · Source § impl Eq for IpAddr 1.0.0 (const: unstable ) · Source § impl Eq for Ipv4Addr 1.0.0 (const: unstable ) · Source § impl Eq for Ipv6Addr Source § impl Eq for Ipv6MulticastScope 1.28.0 · Source § impl Eq for Layout 1.50.0 · Source § impl Eq for LayoutError Source § impl Eq for Locality 1.10.0 (const: unstable ) · Source § impl Eq for Location <'_> 1.0.0 (const: unstable ) · Source § impl Eq for core::cmp:: Ordering 1.0.0 · Source § impl Eq for core::sync::atomic:: Ordering 1.0.0 · Source § impl Eq for ParseBoolError 1.20.0 · Source § impl Eq for ParseCharError 1.0.0 · Source § impl Eq for ParseIntError 1.33.0 · Source § impl Eq for PhantomPinned 1.0.0 (const: unstable ) · Source § impl Eq for RangeFull Source § impl Eq for SearchStep 1.0.0 · Source § impl Eq for SeekFrom Source § impl Eq for Sign Source § impl Eq for SimdAlign 1.0.0 · Source § impl Eq for SocketAddr 1.0.0 · Source § impl Eq for SocketAddrV4 1.0.0 · Source § impl Eq for SocketAddrV6 1.59.0 · Source § impl Eq for TryFromCharError 1.66.0 · Source § impl Eq for TryFromFloatSecsError 1.34.0 · Source § impl Eq for TryFromIntError 1.0.0 (const: unstable ) · Source § impl Eq for TypeId 1.0.0 · Source § impl Eq for Utf8Error Source § impl Eq for VariantId 1.0.0 (const: unstable ) · Source § impl Eq for bool 1.0.0 (const: unstable ) · Source § impl Eq for char 1.0.0 (const: unstable ) · Source § impl Eq for i8 1.0.0 (const: unstable ) · Source § impl Eq for i16 1.0.0 (const: unstable ) · Source § impl Eq for i32 1.0.0 (const: unstable ) · Source § impl Eq for i64 1.0.0 (const: unstable ) · Source § impl Eq for i128 1.0.0 (const: unstable ) · Source § impl Eq for isize 1.0.0 (const: unstable ) · Source § impl Eq for str Source § impl Eq for svpattern Available on AArch64 or ARM64EC only.

Source § impl Eq for svprfop Available on AArch64 or ARM64EC only. 1.0.0 (const: unstable ) · Source § impl Eq for u8 1.0.0 (const: unstable ) · Source § impl Eq for u16 1.0.0 (const: unstable ) · Source § impl Eq for u32 1.0.0 (const: unstable ) · Source § impl Eq for u64 1.0.0 (const: unstable ) · Source § impl Eq for u128 1.0.0 (const: unstable ) · Source § impl Eq for usize Source § impl<'a> Eq for PhantomContravariantLifetime <'a> Source § impl<'a> Eq for PhantomCovariantLifetime <'a> Source § impl<'a> Eq for PhantomInvariantLifetime <'a> 1.79.0 · Source § impl<'a> Eq for Utf8Chunk <'a> Source § impl<'a> Eq for Utf8Pattern <'a> 1.0.0 (const: unstable ) · Source § impl<A> Eq for &A where A: Eq + PointeeSized , 1.0.0 (const: unstable ) · Source § impl<A> Eq for &mut A where A: Eq + PointeeSized , 1.55.0 (const: unstable ) · Source § impl<B: Eq , C: Eq > Eq for ControlFlow <B, C> Source § impl<Dyn: PointeeSized > Eq for DynMetadata <Dyn> 1.4.0 · Source § impl<F: FnPtr > Eq for F 1.29.0 · Source § impl<H> Eq for BuildHasherDefault <H> 1.0.0 · Source § impl<Idx: Eq > Eq for core::ops:: Range <Idx> 1.96.0 (const: unstable ) · Source § impl<Idx: Eq > Eq for core::range:: Range <Idx> 1.0.0 · Source § impl<Idx: Eq > Eq for core::ops:: RangeFrom <Idx> 1.96.0 (const: unstable ) · Source § impl<Idx: Eq > Eq for core::range:: RangeFrom <Idx> 1.26.0 (const: unstable ) · Source § impl<Idx: Eq > Eq for core::ops:: RangeInclusive <Idx> 1.95.0 · Source § impl<Idx: Eq > Eq for core::range:: RangeInclusive <Idx> 1.0.0 · Source § impl<Idx: Eq > Eq for RangeTo <Idx> 1.26.0 · Source § impl<Idx: Eq > Eq for core::ops:: RangeToInclusive <Idx> 1.96.0 · Source § impl<Idx: Eq > Eq for core::range:: RangeToInclusive <Idx> 1.41.0 · Source § impl<Ptr: Deref <Target: Eq >> Eq for Pin <Ptr> Source § impl<T, const N: usize > Eq for Simd <T, N> where T: SimdElement + Eq , 1.2.0 · Source § impl<T: ?

Sized + Eq > Eq for RefCell <T> Source § impl<T: ? Sized , const VARIANT: u32 , const FIELD: u32 > Eq for FieldRepresentingType <T, VARIANT, FIELD> 1.20.0 · Source § impl<T: Eq + ? Sized > Eq for ManuallyDrop <T> 1.2.0 · Source § impl<T: Eq + Copy > Eq for Cell <T> Source § impl<T: Eq + PointeeSized > Eq for TraitImpl <T> 1.0.0 (const: unstable ) · Source § impl<T: Eq , E: Eq > Eq for Result <T, E> 1.0.0 (const: unstable ) · Source § impl<T: Eq , const N: usize > Eq for [T; N] 1.0.0 (const: unstable ) · Source § impl<T: Eq > Eq for (T₁, T₂, …, Tₙ) This trait is implemented for tuples up to twelve items long.

1.17.0 (const: unstable ) · Source § impl<T: Eq > Eq for Bound <T> Source § impl<T: Eq > Eq for Complex <T> 1.0.0 · Source § impl<T: Eq > Eq for Cursor <T> 1.70.0 · Source § impl<T: Eq > Eq for OnceCell <T> 1.0.0 (const: unstable ) · Source § impl<T: Eq > Eq for Option <T> 1.36.0 · Source § impl<T: Eq > Eq for Poll <T> 1.19.0 (const: unstable ) · Source § impl<T: Eq > Eq for Reverse <T> 1.74.0 · Source § impl<T: Eq > Eq for Saturating <T> 1.0.0 · Source § impl<T: Eq > Eq for Wrapping <T> 1.0.0 (const:

The rest of this page is on the live site.