Struct Outcome 

#[repr(transparent)]
pub struct Outcome(pub SmallVec<[u64; 4]>);

Measurement outcome as a compact bit vector.

Bit Layout & Endianness (Little-Endian)

This struct uses Little-Endian storage:

• Low Index holds Low Bits: measured_qubits[0] is stored in chunks[0], bit 0.
• High Index holds High Bits: measured_qubits[64] is stored in chunks[1], bit 0.

Visual Mapping

Memory Index:    [     0      ]  [     1      ] ...
Data (u64):      [ 63 ... 0   ]  [ 127 ... 64 ]
                   ^      ^                 ^
                   |      |                 |
Qubit Index:      MSB    LSB               LSB of next chunk

Note: while stored as little-endian chunks, bitstrings are written in standard binary form (MSB left). The original input width is not stored: parsing "001" and "1" produces the same outcome. Callers must provide the desired output width to Outcome::to_bitstring.

Tuple Fields

0: SmallVec<[u64; 4]>

Implementations

impl Outcome

pub fn new(chunks: SmallVec<[u64; 4]>) -> Self

Creates an outcome from raw chunks.

pub fn from_indices( width: usize, indices: impl IntoIterator<Item = usize>, ) -> Self

Creates an outcome with the given bit indices set to one.

width is the number of logical bits in the outcome. Indices greater than or equal to width are ignored. Bit index 0 is stored as the least significant bit, matching Outcome’s little-endian layout.

pub fn from_bitstring(s: &str) -> Result<Self, OutcomeError>

Create an Outcome from a binary string (e.g., “101”).

Convention

• The string is interpreted as Big-Endian visual order.
• The last character (rightmost) corresponds to Qubit 0 (LSB).
• The first character (leftmost) corresponds to Qubit N-1 (MSB).

Example: from_bitstring("100") -> Qubit 2=1, Qubit 1=0, Qubit 0=0.

pub fn is_one(&self, index: usize) -> bool

Returns true if the bit at given index is 1.

pub fn to_bitstring(&self, num_qubits: usize) -> String

Formats the outcome as a binary string with the requested width.

Output is big-endian (MSB left), padded with leading zeros. If the requested width is smaller than the stored value, high bits are truncated.

Trait Implementations

impl Clone for Outcome

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 Outcome

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

Formats the value using the given formatter.

impl Eq for Outcome

impl FromStr for Outcome

type Err = OutcomeError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Outcome

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 Outcome

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Outcome