Struct Gate 

pub struct Gate<'a> {
    pub requires_flags: &'a [FlagId],
    pub forbids_flags: &'a [FlagId],
    pub requires_state: &'a [StateCompare],
}

A gate, as one value: everything that decides whether the thing carrying it may happen.

Borrowed rather than owned, so gate() is free on every consumer and no consumer has to store a second copy of its own fields.

Fields

requires_flags: &'a [FlagId]

Flags that must all be set (DSL v0.3/v0.4).

forbids_flags: &'a [FlagId]

Flags whose being set suppresses this (DSL v0.6).

requires_state: &'a [StateCompare]

Numeric comparisons that must all hold (DSL v0.10, spec-0031).

Implementations

impl<'a> Gate<'a>

pub const OPEN: Gate<'static>

The always-open gate: no flags, no comparison.

pub fn of( requires_flags: &'a [FlagId], forbids_flags: &'a [FlagId], requires_state: &'a [StateCompare], ) -> Self

Build a gate from its three fields. The one constructor, so a consumer that forgets a field is a rustc error rather than a silently narrower gate.

pub fn is_empty(&self) -> bool

True if this gate constrains nothing — the thing carrying it is unconditional, and emission writes it verbatim with no execute wrapper.

pub fn terms(&self) -> usize

How many terms this gate has, across all three axes. The number a binding ledger reports.

impl Gate<'_>

pub fn contradiction(&self) -> Option<GateContradiction>

The first reason this gate can NEVER open, or None for a satisfiable gate.

A gate is a conjunction, so it is unsatisfiable exactly when one flag is on both lists, or one datum’s terms intersect to the empty set. Terms on distinct flags/datums are independent and cannot contradict each other.

Trait Implementations

impl<'a> Clone for Gate<'a>

fn clone(&self) -> Gate<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Gate<'a>

impl<'a> Debug for Gate<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for Gate<'a>

impl<'a> PartialEq for Gate<'a>

fn eq(&self, other: &Gate<'a>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for Gate<'a>