Struct solana_libra_crypto::hash::HashValue

pub struct HashValue { /* fields omitted */ }

Output value of our hash function. Intentionally opaque for safety and modularity.

Methods

impl HashValue

pub const LENGTH: usize

The length of the hash in bytes.

pub const LENGTH_IN_BITS: usize

The length of the hash in bits.

pub fn new(hash: [u8; 32]) -> Self

Create a new HashValue from a byte array.

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

Create from a slice (e.g. retrieved from storage).

pub fn to_vec(&self) -> Vec<u8>

Dumps into a vector.

pub fn zero() -> Self

Creates a zero-initialized instance.

pub fn is_zero(&self) -> bool

Check if the hash value is zero.

pub fn random() -> Self

Create a cryptographically random instance.

pub fn random_with_rng<R: Rng>(rng: &mut R) -> Self

Creates a random instance with given rng. Useful in unit tests.

pub fn len() -> usize

Get the size of the hash.

pub fn last_n_bytes(&self, bytes: usize) -> String

Get the last n bytes as a String.

Important traits for HashValueBitIterator<'a>

impl<'a> Iterator for HashValueBitIterator<'a> type Item = bool;

pub fn iter_bits(&self) -> HashValueBitIterator

Returns a HashValueBitIterator over all the bits that represent this HashValue.

pub fn common_prefix_bits_len(&self, other: HashValue) -> usize

Returns the length of common prefix of self and other in bits.

Trait Implementations

impl Clone for HashValue

fn clone(&self) -> HashValue

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Ord for HashValue

fn cmp(&self, other: &HashValue) -> Ordering

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

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

Restrict a value to a certain interval.

impl AsRef<[u8; 32]> for HashValue

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

Performs the conversion.

impl Default for HashValue

fn default() -> Self

Returns the "default value" for a type.

impl From<HashValue> for Bytes

fn from(value: HashValue) -> Bytes

Performs the conversion.

impl PartialOrd<HashValue> for HashValue

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

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

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

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

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

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

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

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

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

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

impl PartialEq<HashValue> for HashValue

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

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

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

This method tests for !=.

impl Copy for HashValue

impl Eq for HashValue

impl Display for HashValue

Will print shortened (4 bytes) hash

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

Formats the value using the given formatter.

impl Debug for HashValue

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

Formats the value using the given formatter.

impl Index<usize> for HashValue

type Output = u8

The returned type after indexing.

fn index(&self, s: usize) -> &u8

Performs the indexing (container[index]) operation.

impl Hash for HashValue

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, 

Feeds a slice of this type into the given [Hasher].

impl Binary for HashValue

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

Formats the value using the given formatter.

impl LowerHex for HashValue

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

Formats the value using the given formatter.

impl IntoProto for HashValue

type ProtoType = Vec<u8>

The corresponding Protobuf type.

fn into_proto(self) -> Self::ProtoType

Converts a Rust struct to corresponding Protobuf struct. This should not fail.

impl FromProto for HashValue

type ProtoType = Vec<u8>

The corresponding Protobuf type.

fn from_proto(bytes: Self::ProtoType) -> Result<Self>

Converts a Protobuf struct to corresponding Rust struct. The conversion could fail if the Protobuf struct is invalid. For example, the Protobuf struct could have a byte array that is intended to be a HashValue, and the conversion would fail if the byte array is not exactly 32 bytes.

impl Serialize for HashValue

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

Serialize this value into the given Serde serializer.

impl<'de> Deserialize<'de> for HashValue

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Arbitrary for HashValue

type Parameters = <[u8; 32] as Arbitrary>::Parameters

The type of parameters that [arbitrary_with] accepts for configuration of the generated [Strategy]. Parameters must implement [Default].

type Strategy = Map<(<[u8; 32] as Arbitrary>::Strategy,), fn(_: ([u8; 32],)) -> Self>

The type of [Strategy] used to generate values of type Self.

fn arbitrary_with(_top: Self::Parameters) -> Self::Strategy

Generates a [Strategy] for producing arbitrary values of type the implementing type (Self). The strategy is passed the arguments given in args.

fn arbitrary() -> Self::Strategy

Generates a [Strategy] for producing arbitrary values of type the implementing type (Self).