Struct ShufflePlan 

pub struct ShufflePlan { /* private fields */ }

A validated permutation and duplication of whole logical value groups.

Input and output units are numbered from the bottom of the stack. The unit-level constructor makes decoded stack-machine instructions convenient to express while ensuring execution can never split a multi-unit value.

Implementations

impl ShufflePlan

pub fn new( input_widths: impl IntoIterator<Item = usize>, output_units: impl IntoIterator<Item = usize>, ) -> Result<Self, ShuffleError>

Validates a unit-level output layout against whole input value groups.

A group may be omitted, moved, or repeated. Every occurrence must name all of its units exactly once and in their original order.

pub fn execute<P>(&self, stack: &mut UnitStack<P>) -> Result<(), ShuffleError>

where P: ValueWidthPolicy, P::Value: Clone,

Applies the plan atomically, leaving stack untouched on every error.

Trait Implementations

impl Clone for ShufflePlan

fn clone(&self) -> ShufflePlan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ShufflePlan

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

Formats the value using the given formatter.

impl Eq for ShufflePlan

impl PartialEq for ShufflePlan

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ShufflePlan