Struct Nonce 

pub struct Nonce(pub [u8; 24]);

Nonce for asymmetric authenticated encryption

Tuple Fields

0: [u8; 24]

Implementations

impl Nonce

pub fn from_slice(bs: &[u8]) -> Option<Nonce>

from_slice() creates an object from a byte slice

This function will fail and return None if the length of the byte-slice isn’t equal to the length of the object

pub fn increment_le(&self) -> Nonce

increment_le() treats the nonce as an unsigned little-endian number and returns an incremented version of it.

WARNING: this method does not check for arithmetic overflow. It is the callers responsibility to ensure that any given nonce value is only used once. If the caller does not do that the cryptographic primitives in sodiumoxide will not uphold any security guarantees (i.e. they will break)

pub fn increment_le_inplace(&mut self)

increment_le_inplace() treats the nonce as an unsigned little-endian number and increments it.

WARNING: this method does not check for arithmetic overflow. It is the callers responsibility to ensure that any given nonce value is only used once. If the caller does not do that the cryptographic primitives in sodiumoxide will not uphold any security guarantees.

Trait Implementations

impl AsRef<[u8]> for Nonce

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

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

impl Clone for Nonce

fn clone(&self) -> Nonce

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Nonce

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Nonce

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for Nonce

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

where H: Hasher,

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 Index<Range<usize>> for Nonce

Allows a user to access the byte contents of an object as a slice.

WARNING: it might be tempting to do comparisons on objects by using x[a..b] == y[a..b]. This will open up for timing attacks when comparing for example authenticator tags. Because of this only use the comparison functions exposed by the sodiumoxide API.

type Output = [u8]

The returned type after indexing.

fn index(&self, _index: Range<usize>) -> &[u8]

Performs the indexing (container[index]) operation.

impl Index<RangeFrom<usize>> for Nonce

Allows a user to access the byte contents of an object as a slice.

WARNING: it might be tempting to do comparisons on objects by using x[a..] == y[a..]. This will open up for timing attacks when comparing for example authenticator tags. Because of this only use the comparison functions exposed by the sodiumoxide API.

type Output = [u8]

The returned type after indexing.

fn index(&self, _index: RangeFrom<usize>) -> &[u8]

Performs the indexing (container[index]) operation.

impl Index<RangeFull> for Nonce

Allows a user to access the byte contents of an object as a slice.

WARNING: it might be tempting to do comparisons on objects by using x[] == y[]. This will open up for timing attacks when comparing for example authenticator tags. Because of this only use the comparison functions exposed by the sodiumoxide API.

type Output = [u8]

The returned type after indexing.

fn index(&self, _index: RangeFull) -> &[u8]

Performs the indexing (container[index]) operation.

impl Index<RangeTo<usize>> for Nonce

Allows a user to access the byte contents of an object as a slice.

WARNING: it might be tempting to do comparisons on objects by using x[..b] == y[..b]. This will open up for timing attacks when comparing for example authenticator tags. Because of this only use the comparison functions exposed by the sodiumoxide API.

type Output = [u8]

The returned type after indexing.

fn index(&self, _index: RangeTo<usize>) -> &[u8]

Performs the indexing (container[index]) operation.

impl Ord for Nonce

fn cmp(&self, other: &Nonce) -> 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,

Restrict a value to a certain interval.

impl PartialEq for Nonce

fn eq(&self, other: &Nonce) -> 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 PartialOrd for Nonce

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

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

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

Tests greater than (for self and other) and is used by the > operator.

impl Serialize for Nonce

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 Copy for Nonce

impl Eq for Nonce