Trait hacspec_lib::prelude::Shl

1.0.0 · source · []
pub trait Shl<Rhs = Self> {
    type Output;

    fn shl(self, rhs: Rhs) -> Self::Output;
}
Expand description

The left shift operator <<. Note that because this trait is implemented for all integer types with multiple right-hand-side types, Rust’s type checker has special handling for _ << _, setting the result type for integer operations to the type of the left-hand-side operand. This means that though a << b and a.shl(b) are one and the same from an evaluation standpoint, they are different when it comes to type inference.

Examples

An implementation of Shl that lifts the << operation on integers to a wrapper around usize.

use std::ops::Shl;

#[derive(PartialEq, Debug)]
struct Scalar(usize);

impl Shl<Scalar> for Scalar {
    type Output = Self;

    fn shl(self, Self(rhs): Self) -> Self::Output {
        let Self(lhs) = self;
        Self(lhs << rhs)
    }
}

assert_eq!(Scalar(4) << Scalar(2), Scalar(16));

An implementation of Shl that spins a vector leftward by a given amount.

use std::ops::Shl;

#[derive(PartialEq, Debug)]
struct SpinVector<T: Clone> {
    vec: Vec<T>,
}

impl<T: Clone> Shl<usize> for SpinVector<T> {
    type Output = Self;

    fn shl(self, rhs: usize) -> Self::Output {
        // Rotate the vector by `rhs` places.
        let (a, b) = self.vec.split_at(rhs);
        let mut spun_vector = vec![];
        spun_vector.extend_from_slice(b);
        spun_vector.extend_from_slice(a);
        Self { vec: spun_vector }
    }
}

assert_eq!(SpinVector { vec: vec![0, 1, 2, 3, 4] } << 2,
           SpinVector { vec: vec![2, 3, 4, 0, 1] });

Required Associated Types

The resulting type after applying the << operator.

Required Methods

Performs the << operation.

Examples
assert_eq!(5u8 << 1, 10);
assert_eq!(1u8 << 1, 2);

Implementors

Unimplemented

Unimplemented

Unimplemented

Unimplemented

impl Shl<usize> for State

impl Shl<usize> for Constants

impl Shl<usize> for Block

impl Shl<usize> for ChaChaIV

impl Shl<usize> for ChaChaKey

impl Shl<usize> for PolyKey

impl Shl<usize> for PolyBlock

impl Shl<usize> for State

impl Shl<usize> for Row

impl Shl<usize> for Digest224

impl Shl<usize> for Digest256

impl Shl<usize> for Digest384

impl Shl<usize> for Digest512

impl Shl<B0> for UTerm

impl Shl<B1> for UTerm

impl<U: Unsigned, B: Bit> Shl<B0> for UInt<U, B>

impl<U: Unsigned, B: Bit> Shl<B1> for UInt<U, B>

impl<U: Unsigned, B: Bit> Shl<UTerm> for UInt<U, B>

impl<U: Unsigned> Shl<U> for UTerm

impl<U: Unsigned, B: Bit, Ur: Unsigned, Br: Bit> Shl<UInt<Ur, Br>> for UInt<U, B> where
    UInt<Ur, Br>: Sub<B1>,
    UInt<UInt<U, B>, B0>: Shl<Sub1<UInt<Ur, Br>>>, 

impl Shl<usize> for Block

impl Shl<usize> for Word

impl Shl<usize> for RoundKey

impl Shl<usize> for Nonce

impl Shl<usize> for SBox

impl Shl<usize> for RCon

impl Shl<usize> for Bytes144

impl Shl<usize> for Bytes176

impl Shl<usize> for Bytes208

impl Shl<usize> for Bytes240

impl Shl<usize> for Key128

impl Shl<usize> for Key256

impl Shl<usize> for Block

impl Shl<usize> for Key

impl Shl<usize> for Tag

impl Shl<usize> for DigestB

impl Shl<usize> for Scalar

impl Shl<usize> for Scalar

impl Shl<usize> for Scalar

impl Shl<usize> for Block

impl Shl<usize> for Digest

impl Shl<usize> for Hash