Erase a range of elements from a deque and close the gap.
Declared in <bslalg_dequeprimitives.h>
template<class ALLOCATOR>
static
DequePrimitives<VALUE_TYPE, BLOCK_LENGTH>::Iterator
erase(
Iterator* toBegin,
Iterator* toEnd,
Iterator fromBegin,
Iterator first,
Iterator last,
Iterator fromEnd,
ALLOCATOR allocator);Call the destructor on each of the elements of a deque of parameterized VALUE_TYPE in the specified range [first .. last)]. Shift the elements to fill up the empty space after the erasure, using the smaller of the range defined by [fromBegin .. first)] and [last .. fromEnd)] after the erasure. Load in the specified toBegin and toEnd the new boundaries of the deque after erasure and return an iterator pointing to the element immediately following the removed elements. The behavior is undefined unless fromBegin <= first <= last <= fromEnd.
iterator to the element immediately following the removed elements
| Name | Description |
|---|---|
| toBegin | loads the new beginning iterator of the deque |
| toEnd | loads the new end iterator of the deque |
| fromBegin | current beginning of the deque |
| first | beginning of the range to erase |
| last | end of the range to erase (one past the last) |
| fromEnd | current end of the deque |
| allocator | allocator used to destroy elements |