Enum Directive 

#[repr(u8)]
pub enum Directive {
    Barrier = 0,
    Measure = 1,
    Reset = 2,
}

Non-unitary operations in a quantum circuit.

Directives represent operations that cannot be described by unitary matrices and often involve classical outcomes or hardware-specific behavior.

Variants

• Barrier: Prevents gate reordering across its boundary during optimization
• Measure: Collapses qubit state to classical bit
• Reset: Prepares qubit in |0⟩ state

Examples

use cqlib_core::circuit::gate::Directive;

// Create a barrier directive
let barrier = Directive::Barrier;

// Measurement directive
let measure = Directive::Measure;

// Reset directive
let reset = Directive::Reset;

Variants

Barrier = 0

A synchronization barrier preventing gate reordering.

Ensures that operations before and after the barrier cannot be reordered during circuit optimization. Useful for timing-critical sequences or hardware constraints.

Measure = 1

Measurement operation collapsing quantum state to classical information.

Measures the qubit in the computational basis and stores the result (0 or 1) in a classical register.

Reset = 2

Reset operation preparing qubit in the |0⟩ state.

Forces the qubit into the ground state regardless of its current state. This is typically implemented via measurement followed by conditional X gate or direct initialization.

Implementations

impl Directive

pub const fn name(self) -> &'static str

Returns the stable lowercase operation name.

pub fn inverse(&self) -> Option<Self>

Returns the inverse of the directive if it exists.

Returns

• Some(Directive::Barrier): Barrier is self-inverse
• None: Measure and Reset have no inverse

Examples

use cqlib_core::circuit::gate::Directive;

// Barrier is self-inverse
assert_eq!(Directive::Barrier.inverse(), Some(Directive::Barrier));

// Measurement has no inverse
assert_eq!(Directive::Measure.inverse(), None);

// Reset has no inverse
assert_eq!(Directive::Reset.inverse(), None);

Trait Implementations

impl Clone for Directive

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Directive

impl Debug for Directive

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

Formats the value using the given formatter.

impl Display for Directive

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

Formats the value using the given formatter.

impl Eq for Directive

impl From<Directive> for Instruction

fn from(d: Directive) -> Self

Converts to this type from the input type.

impl Hash for Directive

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

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 PartialEq for Directive

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Directive