Struct SegmentMatcher 

pub struct SegmentMatcher {
    pub matching: Matching,
    pub repetitions: Repetitions,
    pub include_chords: bool,
}

Finds the runs of a stream’s notes and chords that are segments or sets of pitch classes searched for: music21’s SegmentMatcher and the matchers built on it, chosen by Matching.

Fields

matching: Matching

How a run is told the same as a segment searched for.

repetitions: Repetitions

How repeated pitch classes are read.

include_chords: bool

Whether chords may be in a run.

Implementations

impl SegmentMatcher

pub fn new( matching: Matching, repetitions: Repetitions, include_chords: bool, ) -> Self

A matcher of this kind, reading repetitions so, chords included or not.

pub fn find<'a>( &self, stream: &'a Stream, search: &[Vec<IntegerType>], ) -> Result<Vec<ContiguousSegment<'a>>>

Each run that matches one of the segments searched for, by the first it matches, in the order searched and found: music21’s find. A segment the same as one searched for already is passed over. A run matching two segments is listed for each, as music21 lists the one run twice, both times as it was matched last.

Errors

As ContiguousSegmentSearcher::by_length.

pub fn label( &self, stream: &Stream, named: &[(String, Vec<IntegerType>)], convention: Option<TransformationConvention>, ) -> Result<Stream>

A copy of the stream with each run found marked, as music21’s labelSegments and its kin mark them: a line spanner from its first note to its last, in its part, and the name of the segment it matched as a lyric of its first note, unless the note already carries that lyric. Runs are marked part by part, measure by measure, offset by offset. With a convention, as music21’s labelTransformedSegments takes one, each name is followed by the transformations taking the segment to the run, as ,T0 or ,P0.

Errors

As SegmentMatcher::find.

Trait Implementations

impl Clone for SegmentMatcher

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SegmentMatcher

impl Debug for SegmentMatcher

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

Formats the value using the given formatter.

impl Default for SegmentMatcher

fn default() -> Self

Returns the “default value” for a type.