Struct Block

pub struct Block(/* private fields */);

A 128-bit block. Uses SIMD operations where available.

Implementations

impl Block

pub fn clmul(&self, rhs: &Self) -> (Self, Self)

Carryless multiplication of two Blocks as polynomials over GF(2).

Returns (low, high) bits.

pub fn gf_mul(&self, rhs: &Self) -> Self

Multiplication over GF(2^128).

Uses the irreducible polynomial `x^128 + x^7 + x^2 + x + 1.

pub fn gf_reduce(low: &Self, high: &Self) -> Self

Reduce polynomial over GF(2) by x^128 + x^7 + x^2 + x + 1.

pub fn gf_pow(&self, exp: u64) -> Block

impl Block

pub const ZERO: Self

All bits set to 0.

pub const ONES: Self

All bits set to 1.

pub const ONE: Self

Lsb set to 1, all others zero.

pub const MASK_LSB: Self

Mask to mask off the LSB of a Block.

let b = Block::ONES;
let masked = b & Block::MASK_LSB;
assert_eq!(masked, Block::ONES << 1)

pub const BYTES: usize = 16usize

16 bytes in a Block.

pub const BITS: usize = 128usize

128 bits in a block.

pub const fn new(bytes: [u8; 16]) -> Self

Create a new block from bytes.

pub const fn splat(byte: u8) -> Self

Create a block with all bytes set to byte.

pub const fn pack(low: u64, high: u64) -> Self

Pack two u64 into a Block. Usable in const context.

In non-const contexts, using Block::from([low, high]) is likely faster.

pub fn as_bytes(&self) -> &[u8; 16]

Bytes of the block.

pub fn as_mut_bytes(&mut self) -> &mut [u8; 16]

Mutable bytes of the block.

pub fn ro_hash(&self) -> Hash

Hash the block with a random_oracle.

pub fn from_choices(choices: &[Choice]) -> Self

Create a block from 128 Choices.

Panics

If choices.len() != 128

pub fn low(&self) -> u64

Low 64 bits of the block.

pub fn high(&self) -> u64

High 64 bits of the block.

pub fn lsb(&self) -> bool

Least significant bit of the block

pub fn bits(&self) -> impl Iterator<Item = bool>

Iterator over bits of the Block.

Trait Implementations

impl Add for Block

type Output = Block

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

impl AsMut<[u8]> for Block

fn as_mut(&mut self) -> &mut [u8]

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<[u8]> for Block

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Binary for Block

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl BitAnd for Block

type Output = Block

The resulting type after applying the & operator.

fn bitand(self, rhs: Self) -> Self

Performs the & operation.

impl BitAndAssign for Block

fn bitand_assign(&mut self, rhs: Self)

Performs the &= operation.

impl BitOr for Block

type Output = Block

The resulting type after applying the | operator.

fn bitor(self, rhs: Self) -> Self

Performs the | operation.

impl BitOrAssign for Block

fn bitor_assign(&mut self, rhs: Self)

Performs the |= operation.

impl BitXor for Block

type Output = Block

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: Self) -> Self

Performs the ^ operation.

impl BitXorAssign for Block

fn bitxor_assign(&mut self, rhs: Self)

Performs the ^= operation.

impl Clone for Block

fn clone(&self) -> Block

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ConditionallySelectable for Block

fn conditional_select(a: &Self, b: &Self, choice: Choice) -> Self

Select a or b according to choice.

fn conditional_assign(&mut self, other: &Self, choice: Choice)

Conditionally assign other to self, according to choice.

fn conditional_swap(a: &mut Self, b: &mut Self, choice: Choice)

Conditionally swap self and other if choice == 1; otherwise, reassign both unto themselves.

impl Debug for Block

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Block

fn default() -> Block

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Block

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Distribution<Block> for StandardUniform

fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> Block

Generate a random value of T, using rng as the source of randomness.

fn sample_iter<R>(self, rng: R) -> Iter<Self, R, T>

where R: Rng, Self: Sized,

Create an iterator that generates random values of T, using rng as the source of randomness.

fn map<F, S>(self, func: F) -> Map<Self, F, T, S>

where F: Fn(T) -> S, Self: Sized,

Map sampled values to type S

impl From<&Block> for __m128i

fn from(value: &Block) -> Self

Converts to this type from the input type.

impl From<&Block> for u128

fn from(value: &Block) -> Self

Converts to this type from the input type.

impl From<&__m128i> for Block

fn from(value: &__m128i) -> Self

Converts to this type from the input type.

impl From<&u128> for Block

fn from(value: &u128) -> Self

Converts to this type from the input type.

impl From<[u64; 2]> for Block

fn from(value: [u64; 2]) -> Self

Converts to this type from the input type.

impl From<Array<u8, UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>>> for Block

fn from(value: Array<u8, U16>) -> Self

Converts to this type from the input type.

impl From<Block> for [u64; 2]

fn from(value: Block) -> Self

Converts to this type from the input type.

impl From<Block> for Array<u8, U16>

fn from(value: Block) -> Self

Converts to this type from the input type.

impl From<Block> for __m128i

fn from(value: Block) -> Self

Converts to this type from the input type.

impl From<Block> for u128

fn from(value: Block) -> Self

Converts to this type from the input type.

impl From<__m128i> for Block

fn from(value: __m128i) -> Self

Converts to this type from the input type.

impl From<u128> for Block

fn from(value: u128) -> Self

Converts to this type from the input type.

impl From<usize> for Block

fn from(value: usize) -> Self

Converts to this type from the input type.

impl Not for Block

type Output = Block

The resulting type after applying the ! operator.

fn not(self) -> Self

Performs the unary ! operation.

impl PartialEq for Block

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Block

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<Rhs> Shl<Rhs> for Block

where u128: Shl<Rhs, Output = u128>,

type Output = Block

The resulting type after applying the << operator.

fn shl(self, rhs: Rhs) -> Self::Output

Performs the << operation.

impl<Rhs> Shr<Rhs> for Block

where u128: Shr<Rhs, Output = u128>,

type Output = Block

The resulting type after applying the >> operator.

fn shr(self, rhs: Rhs) -> Self::Output

Performs the >> operation.

impl TryFrom<&[u8]> for Block

type Error = WrongLength

The type returned in the event of a conversion error.

fn try_from(value: &[u8]) -> Result<Self, Self::Error>

Performs the conversion.

impl Zero for Block

fn zero() -> Self

Returns the additive identity element of Self, 0.

fn is_zero(&self) -> bool

Returns true if self is equal to the additive identity.

fn set_zero(&mut self)

Sets self to the additive identity element of Self, 0.

impl Zeroable for Block

fn zeroed() -> Self

Calls zeroed.

impl Copy for Block

impl Eq for Block

impl Pod for Block