Struct CNativeGateSet 

#[repr(C)]
pub struct CNativeGateSet {
    pub translate: fn(gate_json: *const c_char, target: usize, native_gate_json: &mut *const c_char) -> i32,
    pub cnot: fn(control: usize, target: usize, native_gate_json: &mut *const c_char) -> i32,
}

FFI-compatible function-pointer table for translating abstract gates into backend-native instructions.

The compiler calls these callbacks during the decomposition and routing passes to convert high-level gate representations into the instruction set understood by the target hardware or simulator.

Construct a CNativeGateSet value on the C side, fill in all function pointers, then pass it to ket_quantum_execution_batch. Passing NULL instead uses identity translation (no decomposition).

All callbacks must return 0 on success or a non-zero libket error code on failure.

Fields

translate: fn(gate_json: *const c_char, target: usize, native_gate_json: &mut *const c_char) -> i32

Translate a single-qubit gate (given as a 2×2 unitary matrix) into native gate instructions.

gate_json is a null-terminated JSON string encoding the gate as a flat 2×2 complex matrix [[re,im,re,im],[re,im,re,im]]. target is the target qubit index. On success *native_gate_json is set to a heap-allocated null-terminated JSON string encoding the native gate sequence. Returns 0 on success.

cnot: fn(control: usize, target: usize, native_gate_json: &mut *const c_char) -> i32

Produce the native gate sequence that implements a CNOT between two qubits.

The first argument is the control qubit index and the second is the target qubit index. On success *native_gate_json is set to a heap-allocated null-terminated JSON string encoding the native CNOT decomposition. Returns 0 on success.

Trait Implementations

impl Clone for CNativeGateSet

fn clone(&self) -> CNativeGateSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CNativeGateSet

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

Formats the value using the given formatter.

impl NativeGateSet for CNativeGateSet

fn translate( &self, matrix: &[[Complex<f64>; 2]; 2], target: usize, ) -> Result<Vec<NativeGate>, KetError>

Translates the 2×2 complex unitary matrix acting on target into zero or more native single-qubit gate instructions.

fn cnot( &self, control: usize, target: usize, ) -> Result<Vec<NativeGate>, KetError>

Translates a CNOT gate into native gate instructions.