Struct ark_r1cs_std::bits::boolean::AllocatedBool

pub struct AllocatedBool<F: Field> { /* fields omitted */ }

Represents a variable in the constraint system which is guaranteed to be either zero or one.

In general, one should prefer using Boolean instead of AllocatedBool, as Boolean offers better support for constant values, and implements more traits.

Implementations

impl<F: Field> AllocatedBool<F>

pub fn value(&self) -> Result<bool, SynthesisError>

Get the assigned value for self.

pub fn variable(&self) -> Variable

Get the R1CS variable for self.

pub fn xor(&self, b: &Self) -> Result<Self, SynthesisError>

Performs an XOR operation over the two operands, returning an AllocatedBool.

pub fn and(&self, b: &Self) -> Result<Self, SynthesisError>

Performs an AND operation over the two operands, returning an AllocatedBool.

pub fn or(&self, b: &Self) -> Result<Self, SynthesisError>

Performs an OR operation over the two operands, returning an AllocatedBool.

pub fn and_not(&self, b: &Self) -> Result<Self, SynthesisError>

Calculates a AND (NOT b).

pub fn nor(&self, b: &Self) -> Result<Self, SynthesisError>

Calculates (NOT a) AND (NOT b).

Trait Implementations

impl<F: Field> AllocVar<bool, F> for AllocatedBool<F>

fn new_variable<T: Borrow<bool>>(
    cs: impl Into<Namespace<F>>,
    f: impl FnOnce() -> Result<T, SynthesisError>,
    mode: AllocationMode
) -> Result<Self, SynthesisError>

Produces a new variable of the appropriate kind (instance or witness), with a booleanity check.

N.B.: we could omit the booleanity check when allocating self as a new public input, but that places an additional burden on protocol designers. Better safe than sorry!

fn new_constant(
    cs: impl Into<Namespace<F>>,
    t: impl Borrow<V>
) -> Result<Self, SynthesisError>

Allocates a new constant of type Self in the ConstraintSystem cs.

fn new_input<T: Borrow<V>>(
    cs: impl Into<Namespace<F>>,
    f: impl FnOnce() -> Result<T, SynthesisError>
) -> Result<Self, SynthesisError>

Allocates a new public input of type Self in the ConstraintSystem cs.

fn new_witness<T: Borrow<V>>(
    cs: impl Into<Namespace<F>>,
    f: impl FnOnce() -> Result<T, SynthesisError>
) -> Result<Self, SynthesisError>

Allocates a new private witness of type Self in the ConstraintSystem cs.

impl<F: Clone + Field> Clone for AllocatedBool<F>

fn clone(&self) -> AllocatedBool<F>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<F: Field> CondSelectGadget<F> for AllocatedBool<F>

fn conditionally_select(
    cond: &Boolean<F>,
    true_val: &Self,
    false_val: &Self
) -> Result<Self, SynthesisError>

If cond == &Boolean::TRUE, then this returns true_value; else, returns false_value.

fn conditionally_select_power_of_two_vector(
    position: &[Boolean<ConstraintF>],
    values: &[Self]
) -> Result<Self, SynthesisError>

Returns an element of values whose index in represented by position. position is an array of boolean that represents an unsigned integer in big endian order.

impl<F: Debug + Field> Debug for AllocatedBool<F>

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

Formats the value using the given formatter.

impl<F: Field> From<AllocatedBool<F>> for Boolean<F>

fn from(b: AllocatedBool<F>) -> Self

Performs the conversion.

impl<F: PartialEq + Field> PartialEq<AllocatedBool<F>> for AllocatedBool<F>

fn eq(&self, other: &AllocatedBool<F>) -> bool

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

fn ne(&self, other: &AllocatedBool<F>) -> bool

This method tests for !=.

impl<F: Eq + Field> Eq for AllocatedBool<F>

impl<F: Field> StructuralEq for AllocatedBool<F>

impl<F: Field> StructuralPartialEq for AllocatedBool<F>