containertools.replace_n_edge_elements_in_container_with_rests

abjad.tools.containertools.replace_n_edge_elements_in_container_with_rests.replace_n_edge_elements_in_container_with_rests(container, n)

New in version 2.0.

Replace first n elements in container with big-endian rests:

abjad> staff = Staff("c'8 d'8 e'8 f'8 g'8 a'8")

abjad> f(staff)
\new Staff {
    c'8
    d'8
    e'8
    f'8
    g'8
    a'8
}

abjad> containertools.replace_n_edge_elements_in_container_with_rests(staff, 5)
Staff{3}

abjad> f(staff)
\new Staff {
    r2
    r8
    a'8
}

Replace last n elements in container with little-endian rests:

abjad> staff = Staff("c'8 d'8 e'8 f'8 g'8 a'8")

abjad> f(staff)
\new Staff {
    c'8
    d'8
    e'8
    f'8
    g'8
    a'8
}

abjad> containertools.replace_n_edge_elements_in_container_with_rests(staff, -5)
Staff{3}

abjad> f(staff)
\new Staff {
    c'8
    r8
    r2
}

Return container.

Changed in version 2.0: renamed containertools.replace_first_n_elements_in_container_with_rests() to containertools.replace_n_edge_elements_in_container_with_rests().