Struct Block8 

#[repr(transparent)]
pub struct Block8(pub u8);

GF(2^8) in the tower basis: bit i is the coefficient of x^i modulo x^8 + x^4 + x^3 + x + 1, as in AES (FIPS-197 §4.2). The flat basis has the same modulus, and φ(a) = a^32.

Tuple Fields

0: u8

Implementations

impl Block8

pub const fn new(val: u8) -> Self

Builds the element from its tower-basis byte val.

pub fn square(self) -> Self

Returns self^2; squaring is additive in characteristic 2.

Trait Implementations

impl Add for Block8

Add (XOR)

type Output = Block8

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign for Block8

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl CanonicalDeserialize for Block8

fn deserialize(bytes: &[u8]) -> Result<Self, ()>

Reads an element from the start of bytes; ignores the rest.

impl CanonicalSerialize for Block8

fn serialized_size(&self) -> usize

Returns the encoded length in bytes.

fn serialize(&self, writer: &mut [u8]) -> Result<(), ()>

Writes the encoding to the start of writer; later bytes are left as they are.

fn to_bytes(&self) -> Vec<u8>

Encodes self into a new Vec<u8> of serialized_size() bytes.

impl Clone for Block8

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Block8

impl Debug for Block8

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

Formats the value using the given formatter.

impl Default for Block8

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Block8

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Block8

impl FlatPromote<Block8> for Block128

Available on non-crate feature table-math only.

fn promote_flat(val: Flat<Block8>) -> Flat<Self>

Maps a flat FromF element into the flat basis of Self.

fn promote_flat_batch(input: &[Flat<FromF>], output: &mut [Flat<Self>])

Promotes input[i] into output[i] for every i below the shorter length; the rest of output is left as it is.

impl FlatPromote<Block8> for Block16

fn promote_flat(val: Flat<Block8>) -> Flat<Self>

Maps a flat FromF element into the flat basis of Self.

fn promote_flat_batch(input: &[Flat<FromF>], output: &mut [Flat<Self>])

Promotes input[i] into output[i] for every i below the shorter length; the rest of output is left as it is.

impl FlatPromote<Block8> for Block256

fn promote_flat(val: Flat<Block8>) -> Flat<Self>

Maps a flat FromF element into the flat basis of Self.

fn promote_flat_batch(input: &[Flat<Block8>], output: &mut [Flat<Self>])

Promotes input[i] into output[i] for every i below the shorter length; the rest of output is left as it is.

impl FlatPromote<Block8> for Block32

fn promote_flat(val: Flat<Block8>) -> Flat<Self>

Maps a flat FromF element into the flat basis of Self.

fn promote_flat_batch(input: &[Flat<FromF>], output: &mut [Flat<Self>])

Promotes input[i] into output[i] for every i below the shorter length; the rest of output is left as it is.

impl FlatPromote<Block8> for Block64

fn promote_flat(val: Flat<Block8>) -> Flat<Self>

Maps a flat FromF element into the flat basis of Self.

fn promote_flat_batch(input: &[Flat<FromF>], output: &mut [Flat<Self>])

Promotes input[i] into output[i] for every i below the shorter length; the rest of output is left as it is.

impl From<Bit> for Block8

fn from(val: Bit) -> Self

Converts to this type from the input type.

impl From<Block8> for Block128

fn from(val: Block8) -> Self

Converts to this type from the input type.

impl From<Block8> for Block16

fn from(val: Block8) -> Self

Converts to this type from the input type.

impl From<Block8> for Block256

fn from(val: Block8) -> Self

Converts to this type from the input type.

impl From<Block8> for Block32

fn from(val: Block8) -> Self

Converts to this type from the input type.

impl From<Block8> for Block64

fn from(val: Block8) -> Self

Converts to this type from the input type.

impl From<u8> for Block8

fn from(val: u8) -> Self

Converts to this type from the input type.

impl From<u32> for Block8

fn from(val: u32) -> Self

Converts to this type from the input type.

impl From<u64> for Block8

fn from(val: u64) -> Self

Converts to this type from the input type.

impl From<u128> for Block8

fn from(val: u128) -> Self

Converts to this type from the input type.

impl HardwareField for Block8

fn to_hardware(self) -> Flat<Self>

Maps self to the flat basis: φ(self).

fn from_hardware(value: Flat<Self>) -> Self

Maps value back to the tower basis: φ⁻¹(value).

fn add_hardware(lhs: Flat<Self>, rhs: Flat<Self>) -> Flat<Self>

Adds two flat elements (XOR).

fn add_hardware_packed( lhs: PackedFlat<Self>, rhs: PackedFlat<Self>, ) -> PackedFlat<Self>

Adds two packed flat vectors lane by lane (XOR).

fn mul_hardware(lhs: Flat<Self>, rhs: Flat<Self>) -> Flat<Self>

Multiplies two flat elements.

fn mul_hardware_packed( lhs: PackedFlat<Self>, rhs: PackedFlat<Self>, ) -> PackedFlat<Self>

Multiplies two packed flat vectors lane by lane.

fn mul_hardware_scalar_packed( lhs: PackedFlat<Self>, rhs: Flat<Self>, ) -> PackedFlat<Self>

Multiplies every lane of lhs by the flat scalar rhs.

fn tower_bit_from_hardware(value: Flat<Self>, bit_idx: usize) -> u8

Returns bit bit_idx of φ⁻¹(value) without a full conversion; constant time in value.

impl Mul for Block8

Mul (Galois Field Multiplication)

type Output = Block8

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Block8> for PackedBlock8

type Output = PackedBlock8

The resulting type after applying the * operator.

fn mul(self, rhs: Block8) -> Self

Performs the * operation.

impl MulAssign for Block8

fn mul_assign(&mut self, rhs: Self)

Performs the *= operation.

impl PackableField for Block8

const WIDTH: usize = PACKED_WIDTH_8

How many elements fit in one packed vector.

type Packed = PackedBlock8

The packed form; operators act lane by lane.

fn pack(chunk: &[Self]) -> Self::Packed

Packs chunk[..WIDTH] into one value; ignores the rest.

fn unpack(packed: Self::Packed, output: &mut [Self])

Writes the lanes of packed to output[..WIDTH]; the rest of output is left as it is.

impl PartialEq for Block8

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Block8

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Block8

impl Sub for Block8

type Output = Block8

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign for Block8

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl TowerField for Block8

const BITS: usize = 8

Degree over GF(2): 2^BITS elements.

const ZERO: Self

The additive identity.

const ONE: Self

The multiplicative identity.

const EXTENSION_TAU: Self

τ of the next level, F[X] / (X^2 + X + τ), for Block8 up. Tr(τ) = 1 makes X^2 + X + τ irreducible.

fn invert(&self) -> Self

Returns self^-1, or 0 for 0. No branch on the value in the default build.

fn from_uniform_bytes(bytes: &[u8; 32]) -> Self

Builds the element from the first BITS bits of bytes, little-endian; ignores the rest.

impl Zeroize for Block8

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.