Struct Salt

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

Random salt used to decorrelate other information.

Implementations

impl Salt

pub fn from_data(data: impl Into<Vec<u8>>) -> Self

Create a new salt from data.

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

Return the data of the salt.

pub fn new_with_len(count: usize) -> Result<Self>

Create a specific number of bytes of salt.

If the number of bytes is less than 8, this will return None.

pub fn new_with_len_using( count: usize, rng: &mut impl RandomNumberGenerator, ) -> Result<Self>

Create a specific number of bytes of salt.

If the number of bytes is less than 8, this will return None.

pub fn new_in_range(range: RangeInclusive<usize>) -> Result<Self>

Create a number of bytes of salt chosen randomly from the given range.

If the minimum number of bytes is less than 8, this will return None.

pub fn new_in_range_using( range: &RangeInclusive<usize>, rng: &mut impl RandomNumberGenerator, ) -> Result<Self>

Create a number of bytes of salt chosen randomly from the given range.

If the minimum number of bytes is less than 8, this will return None.

pub fn new_for_size(size: usize) -> Self

Create a number of bytes of salt generally proportionate to the size of the object being salted.

pub fn new_for_size_using( size: usize, rng: &mut impl RandomNumberGenerator, ) -> Self

Create a number of bytes of salt generally proportionate to the size of the object being salted.

pub fn from_hex(hex: impl AsRef<str>) -> Self

Create a new salt from the given hexadecimal string.

pub fn hex(&self) -> String

The data as a hexadecimal string.

Trait Implementations

impl AsRef<[u8]> for Salt

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

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

impl AsRef<Salt> for Salt

fn as_ref(&self) -> &Salt

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

impl CBORTagged for Salt

fn cbor_tags() -> Vec<Tag>

The CBOR tags assocated with this type. If more than one tag is present, they are considered equivalent for reading, but only the first one is used for writing.

impl CBORTaggedDecodable for Salt

fn from_untagged_cbor(untagged_cbor: CBOR) -> Result<Self>

Creates an instance of this type by decoding it from untagged CBOR.

fn from_tagged_cbor(cbor: CBOR) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from tagged CBOR.

fn from_tagged_cbor_data(data: impl AsRef<[u8]>) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from binary encoded tagged CBOR.

fn from_untagged_cbor_data(data: impl AsRef<[u8]>) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from binary encoded untagged CBOR.

impl CBORTaggedEncodable for Salt

fn untagged_cbor(&self) -> CBOR

Returns the untagged CBOR encoding of this instance.

fn tagged_cbor(&self) -> CBOR

Returns the tagged CBOR encoding of this instance.

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

Returns the tagged value in CBOR binary representation.

impl Clone for Salt

fn clone(&self) -> Salt

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Salt

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

Formats the value using the given formatter.

impl<'a> From<&'a Salt> for &'a [u8]

fn from(value: &'a Salt) -> Self

Converts to this type from the input type.

impl From<&Salt> for Salt

fn from(salt: &Salt) -> Self

Converts to this type from the input type.

impl From<&Salt> for Vec<u8>

fn from(salt: &Salt) -> Self

Converts to this type from the input type.

impl From<Salt> for CBOR

fn from(value: Salt) -> Self

Converts to this type from the input type.

impl From<Salt> for Vec<u8>

fn from(salt: Salt) -> Self

Converts to this type from the input type.

impl PartialEq for Salt

fn eq(&self, other: &Salt) -> 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 TryFrom<CBOR> for Salt

type Error = Error

The type returned in the event of a conversion error.

fn try_from(cbor: CBOR) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Salt

impl StructuralPartialEq for Salt