Question

function void erase_range( List_Iterator#(T) first, last );

erase_range removes from a list the range of elements specified by the first and last iterators. This operation removes elements from the first iterator’s position up to, but not including, the last iterator’s position. If the last iterator refers to an element before the first iterator, the range wraps around the end of the list.

list1.erase_range( list1.start, list1.finish ); // Remove all elements from

// list1

If the range iterators are invalid (i.e., they refer to different lists or to invalid positions), then this operation is illegal and can generate an error.