Struct CLiveExecution 

#[repr(C)]
pub struct CLiveExecution {
    pub compute_gate: fn(json: *const c_char) -> i32,
    pub compute_native_gates: fn(json: *const c_char) -> i32,
    pub measure: fn(qubits: *const usize, len: usize, result: &mut u64) -> i32,
    pub dump: fn(qubits: *const usize, len: usize, result_json: &mut *const c_char) -> i32,
    pub sample: fn(qubits: *const usize, len: usize, shots: usize, result_json: &mut *const c_char) -> i32,
    pub exp_value: fn(hamiltonian_json: *const c_char, result: &mut f64) -> i32,
}

FFI-compatible function-pointer table for a live (gate-at-a-time) execution backend.

In live mode each gate is dispatched to the hardware or simulator immediately as it is applied to the process, and measurement results are available without an explicit ket_process_execute call.

Construct a CLiveExecution value on the C side, fill in all function pointers, then call ket_quantum_execution_live to create the corresponding QuantumExecution variant.

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

Fields

compute_gate: fn(json: *const c_char) -> i32

Dispatch a single quantum gate to the backend.

json is a null-terminated JSON string encoding the gate instruction (type, parameters, target qubit, etc.). Returns 0 on success.

compute_native_gates: fn(json: *const c_char) -> i32

Dispatch a sequence of pre-translated native gate instructions to the backend.

json is a null-terminated JSON string encoding the array of native gate instructions (each a [name, angles, qubits] triple). Returns 0 on success.

measure: fn(qubits: *const usize, len: usize, result: &mut u64) -> i32

Perform a single-shot measurement of len qubits.

qubits points to an array of len qubit indices. On success the measurement result is written to *result as a bitmask where bit i corresponds to qubits[i]. Returns 0 on success.

dump: fn(qubits: *const usize, len: usize, result_json: &mut *const c_char) -> i32

Retrieve the full quantum state (probability amplitudes) of len qubits.

qubits points to an array of len qubit indices. On success *result_json is set to a heap-allocated null-terminated JSON string encoding the state; Rust will parse it and then it is the C side’s responsibility to manage the lifetime. Returns 0 on success.

sample: fn(qubits: *const usize, len: usize, shots: usize, result_json: &mut *const c_char) -> i32

Perform a repeated measurement sample of len qubits over shots shots.

qubits points to an array of len qubit indices. On success *result_json is set to a heap-allocated null-terminated JSON string with the sample counts. Returns 0 on success.

exp_value: fn(hamiltonian_json: *const c_char, result: &mut f64) -> i32

Compute the expectation value of a Hamiltonian on the current quantum state.

hamiltonian_json is a null-terminated JSON string encoding the Hamiltonian. On success *result is set to the computed expectation value. Returns 0 on success.

Trait Implementations

impl Clone for CLiveExecution

fn clone(&self) -> CLiveExecution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CLiveExecution

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

Formats the value using the given formatter.

impl LiveExecution for CLiveExecution

fn compute_gate(&mut self, gate: &GateInstruction) -> Result<(), KetError>

Dispatches a single logical gate instruction to the backend.

fn compute_native_gates(&mut self, gates: &[NativeGate]) -> Result<(), KetError>

Dispatches a sequence of already-translated native gate instructions to the backend.

fn measure(&mut self, qubits: &[usize]) -> Result<u64, KetError>

Collapses and reads out the specified qubits, returning the result as a packed integer (bit i corresponds to qubits[i]).

fn sample( &mut self, qubits: &[usize], shots: usize, ) -> Result<SampleData, KetError>

Samples the measurement distribution of qubits over shots repetitions.

fn exp_value(&mut self, hamiltonian: Hamiltonian) -> Result<f64, KetError>

Computes the expectation value of hamiltonian with respect to the current quantum state.

fn dump(&mut self, qubits: &[usize]) -> Result<DumpData, KetError>

Returns a full state-vector snapshot restricted to qubits.