measuretools.iterate_measures_forward_in_expr

abjad.tools.measuretools.iterate_measures_forward_in_expr.iterate_measures_forward_in_expr(expr, start=0, stop=None)[source]

New in version 2.0.

Iterate measures forward in expr:

abjad> staff = Staff(Measure((2, 8), notetools.make_repeated_notes(2)) * 3)
abjad> pitchtools.set_ascending_named_diatonic_pitches_on_nontied_pitched_components_in_expr(staff)
abjad> f(staff)
\new Staff {
    {
        \time 2/8
        c'8
        d'8
    }
    {
        \time 2/8
        e'8
        f'8
    }
    {
        \time 2/8
        g'8
        a'8
    }
}
abjad> for measure in measuretools.iterate_measures_forward_in_expr(staff):
...     measure
...
Measure(2/8, [c'8, d'8])
Measure(2/8, [e'8, f'8])
Measure(2/8, [g'8, a'8])

Use the optional start and stop keyword parameters to control the start and stop indices of iteration.

abjad> for measure in measuretools.iterate_measures_forward_in_expr(staff, start = 1):
...     measure
...
Measure(2/8, [e'8, f'8])
Measure(2/8, [g'8, a'8])
abjad> for measure in measuretools.iterate_measures_forward_in_expr(staff, start = 0, stop = 2):
...     measure
...
Measure(2/8, [c'8, d'8])
Measure(2/8, [e'8, f'8])

Changed in version 2.0: renamed iterate.measures_forward_in() to measuretools.iterate_measures_forward_in_expr().

This Page