Struct DecompositionRuleCache 

pub struct DecompositionRuleCache { /* private fields */ }

Pass-local cache for runtime decomposition rules.

Implementations

impl DecompositionRuleCache

pub fn instantiate_mc_gate( &mut self, request: McGateRuleRequest<'_>, controls: &[Qubit], targets: &[Qubit], ancillas: &[Qubit], ) -> Result<Option<Vec<ValueOperation>>, CompilerError>

Instantiates a cached multi-controlled-gate decomposition rule.

Returns Ok(None) when the cache has no matching rule. The supplied qubit slices provide the concrete role bindings for a cached template.

pub fn insert_mc_gate( &mut self, request: McGateRuleRequest<'_>, controls: &[Qubit], targets: &[Qubit], ancillas: &[Qubit], operations: &[ValueOperation], ) -> Result<(), CompilerError>

Records a synthesized multi-controlled-gate decomposition as a runtime rule.

operations must use only the supplied controls, targets, and ancillas. The generated rule is independent of the concrete qubit ids and can be instantiated later with any qubits that have the same role counts.

pub const fn stats(&self) -> DecompositionRuleStats

Returns cache hit/miss/insert counters.

pub fn instantiate_numeric_unitary( &mut self, request: NumericUnitaryRuleRequest<'_>, qubits: &[Qubit], ) -> Result<Option<(Vec<ValueOperation>, f64)>, CompilerError>

Instantiates a cached numeric unitary decomposition rule.

Returns Ok(None) when no bit-exact matrix and basis match exists.

pub fn insert_numeric_unitary( &mut self, request: NumericUnitaryRuleRequest<'_>, qubits: &[Qubit], operations: &[ValueOperation], phase_delta: f64, ) -> Result<(), CompilerError>

Records a synthesized numeric unitary decomposition as a runtime rule.

The numeric matrix key is bit-exact: mathematically equivalent matrices with different floating-point representations are intentionally distinct.

Trait Implementations

impl Clone for DecompositionRuleCache

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DecompositionRuleCache

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

Formats the value using the given formatter.

impl Default for DecompositionRuleCache

fn default() -> Self

Returns the “default value” for a type.