Struct Salt

pub struct Salt { /* private fields */ }

Available on crate feature dep_orion only.

A type to represent the Salt that Argon2i uses during key derivation.

As default it will randomly generate a Salt of 16 bytes.

Errors:

An error will be returned if:

• slice is empty.
• length is 0.
• length is not less than isize::MAX.

Panics:

A panic will occur if:

• Failure to generate random bytes securely.

Implementations

impl Salt

pub fn from_slice(slice: &[u8]) -> Result<Salt, UnknownCryptoError>

Construct from a given byte slice.

pub fn len(&self) -> usize

Return the length of the object.

pub fn is_empty(&self) -> bool

Return true if this object does not hold any data, false otherwise.

NOTE: This method should always return false, since there shouldn’t be a way to create an empty instance of this object.

pub fn generate(length: usize) -> Result<Salt, UnknownCryptoError>

Randomly generate using a CSPRNG. Not available in no_std context.

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 Debug for Salt

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

Formats the value using the given formatter.

impl Default for Salt

fn default() -> Salt

Randomly generate using a CSPRNG with recommended size. Not available in no_std context.

impl<'de> Deserialize<'de> for Salt

This type tries to deserialize as a Vec<u8> would. If it succeeds, the digest will be built using Self::from_slice.

Note that this allocates once to store the referenced bytes on the heap.

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq<&[u8]> for Salt

fn eq(&self, other: &&[u8]) -> 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 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 Serialize for Salt

This type tries to serialize as a &[u8] would. Note that the serialized type likely does not have the same protections that Orion provides, such as constant-time operations. A good rule of thumb is to only serialize these types for storage. Don’t operate on the serialized types.

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&[u8]> for Salt

Delegates to from_slice implementation

type Error = UnknownCryptoError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl Eq for Salt