Struct alloy_primitives::FixedBytes

#[repr(transparent)]
pub struct FixedBytes<const N: usize>(pub [u8; N]);

A byte array of fixed length ([u8; N]).

This type allows us to more tightly control serialization, deserialization. rlp encoding, decoding, and other type-level attributes for fixed-length byte arrays.

Users looking to prevent type-confusion between byte arrays of different lengths should use the wrap_fixed_bytes! macro to create a new fixed-length byte array type.

Tuple Fields

0: [u8; N]

Implementations

impl<const N: usize> FixedBytes<N>

pub const ZERO: Self = _

Array of Zero bytes.

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

Wraps the given byte array in FixedBytes.

pub const fn with_last_byte(x: u8) -> Self

Creates a new FixedBytes with the last byte set to x.

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

Creates a new FixedBytes where all bytes are set to byte.

pub const fn len_bytes() -> usize

Returns the size of this byte array (N).

pub const fn concat_const<const M: usize, const Z: usize>( self, other: FixedBytes<M>, ) -> FixedBytes<Z>

Concatenate two FixedBytes.

Due to constraints in the language, the user must specify the value of the output size Z.

Panics

Panics if Z is not equal to N + M.

pub fn from_slice(src: &[u8]) -> Self

Create a new FixedBytes from the given slice src.

For a fallible version, use the TryFrom<&[u8]> implementation.

Note

The given bytes are interpreted in big endian order.

Panics

If the length of src and the number of bytes in Self do not match.

pub fn left_padding_from(value: &[u8]) -> Self

Create a new FixedBytes from the given slice src, left-padding it with zeroes if necessary.

Note

The given bytes are interpreted in big endian order.

Panics

Panics if src.len() > N.

pub fn right_padding_from(value: &[u8]) -> Self

Create a new FixedBytes from the given slice src, right-padding it with zeroes if necessary.

Note

The given bytes are interpreted in big endian order.

Panics

Panics if src.len() > N.

pub const fn as_slice(&self) -> &[u8]

Returns a slice containing the entire array. Equivalent to &s[..].

pub fn as_mut_slice(&mut self) -> &mut [u8]

Returns a mutable slice containing the entire array. Equivalent to &mut s[..].

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

Returns true if all bits set in self are also set in b.

pub const fn const_covers(self, other: Self) -> bool

Returns true if all bits set in self are also set in b.

pub const fn const_eq(&self, other: &Self) -> bool

Compile-time equality. NOT constant-time equality.

pub fn is_zero(&self) -> bool

Returns true if no bits are set.

pub const fn const_is_zero(&self) -> bool

Returns true if no bits are set.

pub const fn bit_and(self, rhs: Self) -> Self

Computes the bitwise AND of two FixedBytes.

pub const fn bit_or(self, rhs: Self) -> Self

Computes the bitwise OR of two FixedBytes.

pub const fn bit_xor(self, rhs: Self) -> Self

Computes the bitwise XOR of two FixedBytes.

Methods from Deref<Target = [u8; N]>

pub fn as_slice(&self) -> &[T]

Returns a slice containing the entire array. Equivalent to &s[..].

pub fn as_mut_slice(&mut self) -> &mut [T]

Returns a mutable slice containing the entire array. Equivalent to &mut s[..].

pub fn each_ref(&self) -> [&T; N]

Borrows each element and returns an array of references with the same size as self.

Example

let floats = [3.1, 2.7, -1.0];
let float_refs: [&f64; 3] = floats.each_ref();
assert_eq!(float_refs, [&3.1, &2.7, &-1.0]);

This method is particularly useful if combined with other methods, like map. This way, you can avoid moving the original array if its elements are not Copy.

let strings = ["Ferris".to_string(), "♥".to_string(), "Rust".to_string()];
let is_ascii = strings.each_ref().map(|s| s.is_ascii());
assert_eq!(is_ascii, [true, false, true]);

// We can still access the original array: it has not been moved.
assert_eq!(strings.len(), 3);

pub fn each_mut(&mut self) -> [&mut T; N]

Borrows each element mutably and returns an array of mutable references with the same size as self.

Example

let mut floats = [3.1, 2.7, -1.0];
let float_refs: [&mut f64; 3] = floats.each_mut();
*float_refs[0] = 0.0;
assert_eq!(float_refs, [&mut 0.0, &mut 2.7, &mut -1.0]);
assert_eq!(floats, [0.0, 2.7, -1.0]);

pub fn split_array_ref<const M: usize>(&self) -> (&[T; M], &[T])

🔬This is a nightly-only experimental API. (split_array)

Divides one array reference into two at an index.

The first will contain all indices from [0, M) (excluding the index M itself) and the second will contain all indices from [M, N) (excluding the index N itself).

Panics

Panics if M > N.

Examples

#![feature(split_array)]

let v = [1, 2, 3, 4, 5, 6];

{
   let (left, right) = v.split_array_ref::<0>();
   assert_eq!(left, &[]);
   assert_eq!(right, &[1, 2, 3, 4, 5, 6]);
}

{
    let (left, right) = v.split_array_ref::<2>();
    assert_eq!(left, &[1, 2]);
    assert_eq!(right, &[3, 4, 5, 6]);
}

{
    let (left, right) = v.split_array_ref::<6>();
    assert_eq!(left, &[1, 2, 3, 4, 5, 6]);
    assert_eq!(right, &[]);
}

pub fn split_array_mut<const M: usize>(&mut self) -> (&mut [T; M], &mut [T])

🔬This is a nightly-only experimental API. (split_array)

Divides one mutable array reference into two at an index.

The first will contain all indices from [0, M) (excluding the index M itself) and the second will contain all indices from [M, N) (excluding the index N itself).

Panics

Panics if M > N.

Examples

#![feature(split_array)]

let mut v = [1, 0, 3, 0, 5, 6];
let (left, right) = v.split_array_mut::<2>();
assert_eq!(left, &mut [1, 0][..]);
assert_eq!(right, &mut [3, 0, 5, 6]);
left[1] = 2;
right[1] = 4;
assert_eq!(v, [1, 2, 3, 4, 5, 6]);

pub fn rsplit_array_ref<const M: usize>(&self) -> (&[T], &[T; M])

🔬This is a nightly-only experimental API. (split_array)

Divides one array reference into two at an index from the end.

The first will contain all indices from [0, N - M) (excluding the index N - M itself) and the second will contain all indices from [N - M, N) (excluding the index N itself).

Panics

Panics if M > N.

Examples

#![feature(split_array)]

let v = [1, 2, 3, 4, 5, 6];

{
   let (left, right) = v.rsplit_array_ref::<0>();
   assert_eq!(left, &[1, 2, 3, 4, 5, 6]);
   assert_eq!(right, &[]);
}

{
    let (left, right) = v.rsplit_array_ref::<2>();
    assert_eq!(left, &[1, 2, 3, 4]);
    assert_eq!(right, &[5, 6]);
}

{
    let (left, right) = v.rsplit_array_ref::<6>();
    assert_eq!(left, &[]);
    assert_eq!(right, &[1, 2, 3, 4, 5, 6]);
}

pub fn rsplit_array_mut<const M: usize>(&mut self) -> (&mut [T], &mut [T; M])

🔬This is a nightly-only experimental API. (split_array)

Divides one mutable array reference into two at an index from the end.

The first will contain all indices from [0, N - M) (excluding the index N - M itself) and the second will contain all indices from [N - M, N) (excluding the index N itself).

Panics

Panics if M > N.

Examples

#![feature(split_array)]

let mut v = [1, 0, 3, 0, 5, 6];
let (left, right) = v.rsplit_array_mut::<4>();
assert_eq!(left, &mut [1, 0]);
assert_eq!(right, &mut [3, 0, 5, 6][..]);
left[1] = 2;
right[1] = 4;
assert_eq!(v, [1, 2, 3, 4, 5, 6]);

pub fn as_ascii(&self) -> Option<&[AsciiChar; N]>

🔬This is a nightly-only experimental API. (ascii_char)

Converts this array of bytes into a array of ASCII characters, or returns None if any of the characters is non-ASCII.

Examples

#![feature(ascii_char)]
#![feature(const_option)]

const HEX_DIGITS: [std::ascii::Char; 16] =
    *b"0123456789abcdef".as_ascii().unwrap();

assert_eq!(HEX_DIGITS[1].as_str(), "1");
assert_eq!(HEX_DIGITS[10].as_str(), "a");

pub unsafe fn as_ascii_unchecked(&self) -> &[AsciiChar; N]

🔬This is a nightly-only experimental API. (ascii_char)

Converts this array of bytes into a array of ASCII characters, without checking whether they’re valid.

Safety

Every byte in the array must be in 0..=127, or else this is UB.

Trait Implementations

impl<const N: usize> AsMut<[u8]> for FixedBytes<N>

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

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

impl<const N: usize> AsMut<[u8; N]> for FixedBytes<N>

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

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

impl AsMut<FixedBytes<20>> for Address

fn as_mut(&mut self) -> &mut FixedBytes<20>

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

impl AsMut<FixedBytes<24>> for Function

fn as_mut(&mut self) -> &mut FixedBytes<24>

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

impl AsMut<FixedBytes<256>> for Bloom

fn as_mut(&mut self) -> &mut FixedBytes<256>

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

impl<const N: usize> AsRef<[u8]> for FixedBytes<N>

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

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

impl<const N: usize> AsRef<[u8; N]> for FixedBytes<N>

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

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

impl AsRef<FixedBytes<20>> for Address

fn as_ref(&self) -> &FixedBytes<20>

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

impl AsRef<FixedBytes<24>> for Function

fn as_ref(&self) -> &FixedBytes<24>

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

impl AsRef<FixedBytes<256>> for Bloom

fn as_ref(&self) -> &FixedBytes<256>

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

impl<const N: usize> BitAnd for FixedBytes<N>

type Output = FixedBytes<N>

The resulting type after applying the & operator.

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

Performs the & operation.

impl<const N: usize> BitAndAssign for FixedBytes<N>

fn bitand_assign(&mut self, rhs: Self)

Performs the &= operation.

impl<const N: usize> BitOr for FixedBytes<N>

type Output = FixedBytes<N>

The resulting type after applying the | operator.

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

Performs the | operation.

impl<const N: usize> BitOrAssign for FixedBytes<N>

fn bitor_assign(&mut self, rhs: Self)

Performs the |= operation.

impl<const N: usize> BitXor for FixedBytes<N>

type Output = FixedBytes<N>

The resulting type after applying the ^ operator.

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

Performs the ^ operation.

impl<const N: usize> BitXorAssign for FixedBytes<N>

fn bitxor_assign(&mut self, rhs: Self)

Performs the ^= operation.

impl<const N: usize> Borrow<[u8]> for &FixedBytes<N>

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

Immutably borrows from an owned value.

impl<const N: usize> Borrow<[u8]> for &mut FixedBytes<N>

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

Immutably borrows from an owned value.

impl<const N: usize> Borrow<[u8]> for FixedBytes<N>

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

Immutably borrows from an owned value.

impl<const N: usize> Borrow<[u8; N]> for &FixedBytes<N>

fn borrow(&self) -> &[u8; N]

Immutably borrows from an owned value.

impl<const N: usize> Borrow<[u8; N]> for &mut FixedBytes<N>

fn borrow(&self) -> &[u8; N]

Immutably borrows from an owned value.

impl<const N: usize> Borrow<[u8; N]> for FixedBytes<N>

fn borrow(&self) -> &[u8; N]

Immutably borrows from an owned value.

impl<const N: usize> BorrowMut<[u8]> for &mut FixedBytes<N>

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

Mutably borrows from an owned value.

impl<const N: usize> BorrowMut<[u8]> for FixedBytes<N>

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

Mutably borrows from an owned value.

impl<const N: usize> BorrowMut<[u8; N]> for &mut FixedBytes<N>

fn borrow_mut(&mut self) -> &mut [u8; N]

Mutably borrows from an owned value.

impl<const N: usize> BorrowMut<[u8; N]> for FixedBytes<N>

fn borrow_mut(&mut self) -> &mut [u8; N]

Mutably borrows from an owned value.

impl<const N: usize> Clone for FixedBytes<N>

fn clone(&self) -> FixedBytes<N>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<const N: usize> Debug for FixedBytes<N>

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

Formats the value using the given formatter.

impl<const N: usize> Decodable for FixedBytes<N>

Available on crate feature rlp only.

fn decode(buf: &mut &[u8]) -> Result<Self>

Decodes the blob into the appropriate type. buf must be advanced past the decoded object.

impl<'a, const N: usize> Default for &'a FixedBytes<N>

fn default() -> Self

Returns the “default value” for a type.

impl<const N: usize> Default for FixedBytes<N>

fn default() -> Self

Returns the “default value” for a type.

impl<const N: usize> Deref for FixedBytes<N>

type Target = [u8; N]

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<const N: usize> DerefMut for FixedBytes<N>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'de, const N: usize> Deserialize<'de> for FixedBytes<N>

Available on crate feature serde only.

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl<const N: usize> Display for FixedBytes<N>

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

Formats the value using the given formatter.

impl<const N: usize> Encodable for FixedBytes<N>

Available on crate feature rlp only.

fn length(&self) -> usize

Returns the length of the encoding of this type in bytes.

fn encode(&self, out: &mut dyn BufMut)

Encodes the type into the out buffer.

impl<'a, const N: usize> From<&'a [u8; N]> for &'a FixedBytes<N>

fn from(value: &'a [u8; N]) -> &'a FixedBytes<N>

Converts to this type from the input type.

impl<const N: usize> From<&[u8; N]> for FixedBytes<N>

fn from(bytes: &[u8; N]) -> Self

Converts to this type from the input type.

impl<'a, const N: usize> From<&'a FixedBytes<N>> for &'a [u8; N]

fn from(value: &'a FixedBytes<N>) -> &'a [u8; N]

Converts to this type from the input type.

impl<const N: usize> From<&'static FixedBytes<N>> for Bytes

fn from(value: &'static FixedBytes<N>) -> Self

Converts to this type from the input type.

impl<'a, const N: usize> From<&'a mut [u8; N]> for &'a FixedBytes<N>

fn from(value: &'a mut [u8; N]) -> &'a FixedBytes<N>

Converts to this type from the input type.

impl<'a, const N: usize> From<&'a mut [u8; N]> for &'a mut FixedBytes<N>

fn from(value: &'a mut [u8; N]) -> &'a mut FixedBytes<N>

Converts to this type from the input type.

impl<const N: usize> From<&mut [u8; N]> for FixedBytes<N>

fn from(bytes: &mut [u8; N]) -> Self

Converts to this type from the input type.

impl<'a, const N: usize> From<&'a mut FixedBytes<N>> for &'a [u8; N]

fn from(value: &'a mut FixedBytes<N>) -> &'a [u8; N]

Converts to this type from the input type.

impl<'a, const N: usize> From<&'a mut FixedBytes<N>> for &'a mut [u8; N]

fn from(value: &'a mut FixedBytes<N>) -> &'a mut [u8; N]

Converts to this type from the input type.

impl<const N: usize> From<[u8; N]> for FixedBytes<N>

fn from(value: [u8; N]) -> Self

Converts to this type from the input type.

impl From<Address> for FixedBytes<20>

fn from(value: Address) -> Self

Converts to this type from the input type.

impl From<Bloom> for FixedBytes<256>

fn from(value: Bloom) -> Self

Converts to this type from the input type.

impl From<FixedBytes<1>> for I8

fn from(value: B8) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<1>> for U8

fn from(value: B8) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<1>> for i8

fn from(value: B8) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<1>> for u8

fn from(value: B8) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<16>> for I128

fn from(value: B128) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<16>> for U128

fn from(value: B128) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<16>> for i128

fn from(value: B128) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<16>> for u128

fn from(value: B128) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<2>> for I16

fn from(value: B16) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<2>> for U16

fn from(value: B16) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<2>> for i16

fn from(value: B16) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<2>> for u16

fn from(value: B16) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<20>> for Address

fn from(value: FixedBytes<20>) -> Self

Converts to this type from the input type.

impl From<FixedBytes<20>> for I160

fn from(value: B160) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<20>> for U160

fn from(value: B160) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<24>> for Function

fn from(value: FixedBytes<24>) -> Self

Converts to this type from the input type.

impl From<FixedBytes<256>> for Bloom

fn from(value: FixedBytes<256>) -> Self

Converts to this type from the input type.

impl From<FixedBytes<32>> for I256

fn from(value: B256) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<32>> for U256

fn from(value: B256) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<4>> for I32

fn from(value: B32) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<4>> for U32

fn from(value: B32) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<4>> for i32

fn from(value: B32) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<4>> for u32

fn from(value: B32) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<64>> for I512

fn from(value: B512) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<64>> for U512

fn from(value: B512) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<8>> for I64

fn from(value: B64) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<8>> for U64

fn from(value: B64) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<8>> for i64

fn from(value: B64) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl From<FixedBytes<8>> for u64

fn from(value: B64) -> Self

Converts a fixed byte array into a fixed-width unsigned integer by interpreting the bytes as big-endian.

impl<const N: usize> From<FixedBytes<N>> for [u8; N]

fn from(s: FixedBytes<N>) -> Self

Converts to this type from the input type.

impl<const N: usize> From<FixedBytes<N>> for Bytes

fn from(value: FixedBytes<N>) -> Self

Converts to this type from the input type.

impl From<Function> for FixedBytes<24>

fn from(value: Function) -> Self

Converts to this type from the input type.

impl<const N: usize> FromHex for FixedBytes<N>

type Error = FromHexError

The associated error which can be returned from parsing.

fn from_hex<T: AsRef<[u8]>>(hex: T) -> Result<Self, Self::Error>

Creates an instance of type Self from the given hex string, or fails with a custom error type.

impl<const N: usize> FromStr for FixedBytes<N>

type Err = FromHexError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl<const N: usize> Hash for FixedBytes<N>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<__IdxT, const N: usize> Index<__IdxT> for FixedBytes<N>

where [u8; N]: Index<__IdxT>,

type Output = <[u8; N] as Index<__IdxT>>::Output

The returned type after indexing.

fn index(&self, idx: __IdxT) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<__IdxT, const N: usize> IndexMut<__IdxT> for FixedBytes<N>

where [u8; N]: IndexMut<__IdxT>,

fn index_mut(&mut self, idx: __IdxT) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<'__deriveMoreLifetime, const N: usize> IntoIterator for &'__deriveMoreLifetime FixedBytes<N>

where &'__deriveMoreLifetime [u8; N]: IntoIterator,

type Item = <&'__deriveMoreLifetime [u8; N] as IntoIterator>::Item

The type of the elements being iterated over.

type IntoIter = <&'__deriveMoreLifetime [u8; N] as IntoIterator>::IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'__deriveMoreLifetime, const N: usize> IntoIterator for &'__deriveMoreLifetime mut FixedBytes<N>

where &'__deriveMoreLifetime mut [u8; N]: IntoIterator,

type Item = <&'__deriveMoreLifetime mut [u8; N] as IntoIterator>::Item

The type of the elements being iterated over.

type IntoIter = <&'__deriveMoreLifetime mut [u8; N] as IntoIterator>::IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<const N: usize> IntoIterator for FixedBytes<N>

where [u8; N]: IntoIterator,

type Item = <[u8; N] as IntoIterator>::Item

The type of the elements being iterated over.

type IntoIter = <[u8; N] as IntoIterator>::IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<const N: usize> LowerHex for FixedBytes<N>

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

Formats the value using the given formatter.

impl<const N: usize> MaxEncodedLenAssoc for FixedBytes<N>

Available on crate feature rlp only.

const LEN: usize = _

The maximum length.

impl<const N: usize> Not for FixedBytes<N>

type Output = FixedBytes<N>

The resulting type after applying the ! operator.

fn not(self) -> Self::Output

Performs the unary ! operation.

impl<const N: usize> Ord for FixedBytes<N>

fn cmp(&self, other: &FixedBytes<N>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl<const N: usize> PartialEq<&[u8]> for FixedBytes<N>

fn eq(&self, other: &&[u8]) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: usize> PartialEq<&[u8; N]> for FixedBytes<N>

fn eq(&self, other: &&[u8; N]) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: usize> PartialEq<&FixedBytes<N>> for [u8]

fn eq(&self, other: &&FixedBytes<N>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: usize> PartialEq<&FixedBytes<N>> for [u8; N]

fn eq(&self, other: &&FixedBytes<N>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: usize> PartialEq<[u8]> for &FixedBytes<N>

fn eq(&self, other: &[u8]) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: usize> PartialEq<[u8]> for FixedBytes<N>

fn eq(&self, other: &[u8]) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: usize> PartialEq<[u8; N]> for &FixedBytes<N>

fn eq(&self, other: &[u8; N]) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: usize> PartialEq<[u8; N]> for FixedBytes<N>

fn eq(&self, other: &[u8; N]) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: usize> PartialEq<FixedBytes<N>> for &[u8]

fn eq(&self, other: &FixedBytes<N>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: usize> PartialEq<FixedBytes<N>> for &[u8; N]

fn eq(&self, other: &FixedBytes<N>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: usize> PartialEq<FixedBytes<N>> for [u8]

fn eq(&self, other: &FixedBytes<N>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: usize> PartialEq<FixedBytes<N>> for [u8; N]

fn eq(&self, other: &FixedBytes<N>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: usize> PartialEq for FixedBytes<N>

fn eq(&self, other: &FixedBytes<N>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: usize> PartialOrd<&[u8]> for FixedBytes<N>

fn partial_cmp(&self, other: &&[u8]) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<const N: usize> PartialOrd<&FixedBytes<N>> for [u8]

fn partial_cmp(&self, other: &&FixedBytes<N>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<const N: usize> PartialOrd<[u8]> for &FixedBytes<N>

fn partial_cmp(&self, other: &[u8]) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<const N: usize> PartialOrd<[u8]> for FixedBytes<N>

fn partial_cmp(&self, other: &[u8]) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<const N: usize> PartialOrd<FixedBytes<N>> for &[u8]

fn partial_cmp(&self, other: &FixedBytes<N>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<const N: usize> PartialOrd<FixedBytes<N>> for [u8]

fn partial_cmp(&self, other: &FixedBytes<N>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<const N: usize> PartialOrd for FixedBytes<N>

fn partial_cmp(&self, other: &FixedBytes<N>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<const N: usize> Serialize for FixedBytes<N>

Available on crate feature serde only.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl<'a, const N: usize> TryFrom<&'a [u8]> for &'a FixedBytes<N>

Tries to create a ref FixedBytes<N> by copying from a slice &[u8]. Succeeds if slice.len() == N.

type Error = TryFromSliceError

The type returned in the event of a conversion error.

fn try_from(slice: &'a [u8]) -> Result<&'a FixedBytes<N>, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<&[u8]> for FixedBytes<N>

Tries to create a FixedBytes<N> by copying from a slice &[u8]. Succeeds if slice.len() == N.

type Error = TryFromSliceError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl<'a, const N: usize> TryFrom<&'a mut [u8]> for &'a mut FixedBytes<N>

Tries to create a ref FixedBytes<N> by copying from a mutable slice &mut [u8]. Succeeds if slice.len() == N.

type Error = TryFromSliceError

The type returned in the event of a conversion error.

fn try_from(slice: &'a mut [u8]) -> Result<&'a mut FixedBytes<N>, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<&mut [u8]> for FixedBytes<N>

Tries to create a FixedBytes<N> by copying from a mutable slice &mut [u8]. Succeeds if slice.len() == N.

type Error = TryFromSliceError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl<const N: usize> UpperHex for FixedBytes<N>

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

Formats the value using the given formatter.

impl<const N: usize> Copy for FixedBytes<N>

impl<const N: usize> Eq for FixedBytes<N>

impl MaxEncodedLen<{ $sz + length_of_length($sz) }> for FixedBytes<0>

Available on crate feature rlp only.

impl MaxEncodedLen<{ $sz + length_of_length($sz) }> for FixedBytes<1>

Available on crate feature rlp only.

impl MaxEncodedLen<{ $sz + length_of_length($sz) }> for FixedBytes<1024>

Available on crate feature rlp only.

impl MaxEncodedLen<{ $sz + length_of_length($sz) }> for FixedBytes<128>

Available on crate feature rlp only.

impl MaxEncodedLen<{ $sz + length_of_length($sz) }> for FixedBytes<16>

Available on crate feature rlp only.

impl MaxEncodedLen<{ $sz + length_of_length($sz) }> for FixedBytes<2>

Available on crate feature rlp only.

impl MaxEncodedLen<{ $sz + length_of_length($sz) }> for FixedBytes<20>

Available on crate feature rlp only.

impl MaxEncodedLen<{ $sz + length_of_length($sz) }> for FixedBytes<256>

Available on crate feature rlp only.

impl MaxEncodedLen<{ $sz + length_of_length($sz) }> for FixedBytes<32>

Available on crate feature rlp only.

impl MaxEncodedLen<{ $sz + length_of_length($sz) }> for FixedBytes<4>

Available on crate feature rlp only.

impl MaxEncodedLen<{ $sz + length_of_length($sz) }> for FixedBytes<512>

Available on crate feature rlp only.

impl MaxEncodedLen<{ $sz + length_of_length($sz) }> for FixedBytes<64>

Available on crate feature rlp only.

impl MaxEncodedLen<{ $sz + length_of_length($sz) }> for FixedBytes<8>

Available on crate feature rlp only.

impl<const N: usize> StructuralPartialEq for FixedBytes<N>