Struct ToneRow 

pub struct ToneRow { /* private fields */ }

An ordered aggregate containing every canonical pitch class exactly once.

Implementations

impl ToneRow

pub fn rotate(&self, steps: usize) -> Self

Returns the row rotated left by steps, reduced modulo twelve.

pub fn permute_ordinals( &self, permutation: &OrdinalMap, ) -> Result<Self, RowError>

Applies a caller-supplied validated ordinal permutation to the row.

pub fn try_permute_ordinals( &self, output_to_input: Vec<usize>, ) -> Result<Self, RowError>

Validates and applies a raw output-to-input ordinal permutation.

impl ToneRow

pub fn try_from_classes(classes: [PitchClass; 12]) -> Result<Self, RowError>

Constructs a row after exact membership and multiplicity validation.

The fixed array establishes cardinality. Series with the exhaustive exactly-once rule supplies the canonical alphabet membership and multiplicity proof.

pub const fn classes(&self) -> &[PitchClass; 12]

Returns the twelve classes in row order.

pub fn apply(&self, operation: RowOperation) -> RowForm

Applies a total P/I/R/RI operation and retains its normalized identity.

impl ToneRow

pub fn segment(&self, start: usize, len: usize) -> Result<RowSegment, RowError>

Extracts a contiguous segment [start, start + len) from the row.

pub fn wrapped_segment( &self, start: usize, len: usize, ) -> Result<RowSegment, RowError>

Extracts a wrapping segment starting at start and continuing modulo twelve.

pub fn indexed_segment( &self, ordinals: &[usize], ) -> Result<RowSegment, RowError>

Extracts a segment from an explicit ordinal sequence.

pub fn ordered_intervals(&self) -> OrderedIntervalString

Returns the directed ordered intervals between adjacent row positions.

Trait Implementations

impl Clone for ToneRow

fn clone(&self) -> ToneRow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToneRow

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

Formats the value using the given formatter.

impl Eq for ToneRow

impl PartialEq for ToneRow

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ToneRow