Skip to main content

ket_process_dump

ket::c_api::process

Function ket_process_dump 

Source 
#[unsafe(no_mangle)]
pub extern "C" fn ket_process_dump(
    process: &mut Process,
    qubits: *const usize,
    qubits_len: usize,
    dump_json: &mut *const c_char,
) -> i32
Expand description

Dumps the quantum state of qubits (live mode only).

Returns the full probability amplitude vector for the specified qubits as a heap-allocated JSON string. The caller must free it with super::ket_string_delete.

§Parameters

  • process: The process whose state is dumped.
  • qubits: Pointer to an array of qubit indices to dump.
  • qubits_len: Number of elements in qubits.
  • dump_json: Output: set to a pointer to a heap-allocated null-terminated JSON string encoding the quantum state.

§Returns

0 on success, non-zero error code on failure.