Struct chbs::entropy::Entropy

pub struct Entropy(_);

Password entropy.

The entropy number used internally represents the number of base 2 entropy bits, and is calculated using log2(choices).

Implementations

impl Entropy

pub fn zero() -> Self

Construct entropy for zero bits, representing no entropy.

pub fn one() -> Self

Construct entropy for one bit, representing 50/50 chance.

pub fn from_bits<F: Into<f64>>(bits: F) -> Self

Construct entropy from a number of entropy bits.

pub fn from_real<F: Into<f64>>(real: F) -> Self

Construct entropy from a real number.

For a wordlist of 7776 words where choices are uniform, the real number 7776 may be given to construct the proper entropy value. This would produce an entropy instance with about 12.9 bits.

If Entropy should be constructed from a number of bits, use from_bits instead.

pub fn bits(self) -> f64

Get the number of entropy bits.

Trait Implementations

impl<B> Add<B> for Entropy where
    B: Into<f64>, 

type Output = Entropy

The resulting type after applying the + operator.

fn add(self, b: B) -> Entropy

Performs the + operation.

impl Add<Entropy> for Entropy

type Output = Entropy

The resulting type after applying the + operator.

fn add(self, Entropy: Entropy) -> Entropy

Performs the + operation.

impl Clone for Entropy

fn clone(&self) -> Entropy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Entropy

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

Formats the value using the given formatter.

impl Display for Entropy

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

Formats the value using the given formatter.

impl<B> Div<B> for Entropy where
    B: Into<f64>, 

type Output = Entropy

The resulting type after applying the / operator.

fn div(self, b: B) -> Entropy

Performs the / operation.

impl Div<Entropy> for Entropy

type Output = Entropy

The resulting type after applying the / operator.

fn div(self, Entropy: Entropy) -> Entropy

Performs the / operation.

impl<B> Mul<B> for Entropy where
    B: Into<f64>, 

type Output = Entropy

The resulting type after applying the * operator.

fn mul(self, b: B) -> Entropy

Performs the * operation.

impl Mul<Entropy> for Entropy

type Output = Entropy

The resulting type after applying the * operator.

fn mul(self, Entropy: Entropy) -> Entropy

Performs the * operation.

impl PartialEq<Entropy> for Entropy

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

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

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

This method tests for !=.

impl PartialOrd<Entropy> for Entropy

fn partial_cmp(&self, other: &Entropy) -> 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<B> Sub<B> for Entropy where
    B: Into<f64>, 

type Output = Entropy

The resulting type after applying the - operator.

fn sub(self, b: B) -> Entropy

Performs the - operation.

impl Sub<Entropy> for Entropy

type Output = Entropy

The resulting type after applying the - operator.

fn sub(self, Entropy: Entropy) -> Entropy

Performs the - operation.

impl Sum<Entropy> for Entropy

fn sum<I>(iter: I) -> Self where
    I: Iterator,
    I::Item: Into<Entropy>, 

Method which takes an iterator and generates Self from the elements by “summing up” the items.

impl Copy for Entropy

impl StructuralPartialEq for Entropy