[][src]Struct subtle::Choice

pub struct Choice(u8);

The Choice struct represents a choice for use in conditional assignment.

It is a wrapper around a u8, which should have the value either 1 (true) or 0 (false).

With the nightly feature enabled, the conversion from u8 to Choice passes the value through an optimization barrier, as a best-effort attempt to prevent the compiler from inferring that the Choice value is a boolean. This strategy is based on Tim Maclean's work on rust-timing-shield, which attempts to provide a more comprehensive approach for preventing software side-channels in Rust code.

The Choice struct implements operators for AND, OR, XOR, and NOT, to allow combining Choice values. These operations do not short-circuit.

Methods

impl Choice[src]

pub fn unwrap_u8(&self) -> u8[src]

Unwrap the Choice wrapper to reveal the underlying u8.

Note

This function only exists as an escape hatch for the rare case where it's not possible to use one of the subtle-provided trait impls.

Trait Implementations

impl Clone for Choice[src]

fn clone_from(&mut self, source: &Self)
1.0.0
[src]

Performs copy-assignment from source. Read more

impl Debug for Choice[src]

impl From<Choice> for bool[src]

fn from(source: Choice) -> bool[src]

Convert the Choice wrapper into a bool, depending on whether the underlying u8 was a 0 or a 1.

Note

This function exists to avoid having higher-level cryptographic protocol implementations duplicating this pattern.

The intended use case for this conversion is at the end of a higher-level primitive implementation: for example, in checking a keyed MAC, where the verification should happen in constant-time (and thus use a Choice) but it is safe to return a bool at the end of the verification.

impl From<u8> for Choice[src]

impl Copy for Choice[src]

impl Not for Choice[src]

type Output = Choice

The resulting type after applying the ! operator.

impl BitAnd<Choice> for Choice[src]

type Output = Choice

The resulting type after applying the & operator.

impl BitOr<Choice> for Choice[src]

type Output = Choice

The resulting type after applying the | operator.

impl BitXor<Choice> for Choice[src]

type Output = Choice

The resulting type after applying the ^ operator.

impl BitAndAssign<Choice> for Choice[src]

impl BitOrAssign<Choice> for Choice[src]

impl BitXorAssign<Choice> for Choice[src]

Auto Trait Implementations

impl Send for Choice

impl Sync for Choice

Blanket Implementations

impl<T> From for T[src]

impl<T, U> TryFrom for T where
    U: Into<T>, 
[src]

type Error = !

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

The type returned in the event of a conversion error.

impl<T, U> TryInto for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

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

The type returned in the event of a conversion error.

impl<T, U> Into for T where
    U: From<T>, 
[src]

impl<T> Borrow for T where
    T: ?Sized
[src]

impl<T> BorrowMut for T where
    T: ?Sized
[src]

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T