Trait One

pub trait One: Sized + Mul<Self, Output = Self> {
    // Required method
    fn one() -> Self;

    // Provided methods
    fn set_one(&mut self) { ... }
    fn is_one(&self) -> bool
       where Self: PartialEq { ... }
}

Defines a multiplicative identity element for Self.

Laws

a * 1 = a       ∀ a ∈ Self
1 * a = a       ∀ a ∈ Self

Required Methods

fn one() -> Self

Returns the multiplicative identity element of Self, 1.

Purity

This function should return the same result at all times regardless of external mutable state, for example values stored in TLS or in static muts.

Provided Methods

fn set_one(&mut self)

Sets self to the multiplicative identity element of Self, 1.

fn is_one(&self) -> bool

where Self: PartialEq,

Returns true if self is equal to the multiplicative identity.

For performance reasons, it’s best to implement this manually. After a semver bump, this method will be required, and the where Self: PartialEq bound will be removed.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl One for f32

fn one() -> f32

fn is_one(&self) -> bool

impl One for f64

fn one() -> f64

fn is_one(&self) -> bool

impl One for i8

fn one() -> i8

fn is_one(&self) -> bool

impl One for i16

fn one() -> i16

fn is_one(&self) -> bool

impl One for i32

fn one() -> i32

fn is_one(&self) -> bool

impl One for i64

fn one() -> i64

fn is_one(&self) -> bool

impl One for i128

fn one() -> i128

fn is_one(&self) -> bool

impl One for isize

fn one() -> isize

fn is_one(&self) -> bool

impl One for u8

fn one() -> u8

fn is_one(&self) -> bool

impl One for u16

fn one() -> u16

fn is_one(&self) -> bool

impl One for u32

fn one() -> u32

fn is_one(&self) -> bool

impl One for u64

fn one() -> u64

fn is_one(&self) -> bool

impl One for u128

fn one() -> u128

fn is_one(&self) -> bool

impl One for usize

fn one() -> usize

fn is_one(&self) -> bool

impl<T: One> One for Wrapping<T>

where Wrapping<T>: Mul<Output = Wrapping<T>>,

fn set_one(&mut self)

fn one() -> Self

Implementors