Insert a source range, shifting existing elements toward the back.
Declared in <bslalg_dequeprimitives.h>
template<
class FWD_ITER,
class SENTINEL,
class ALLOCATOR>
static
void
insertAndMoveToBack(
Iterator* toEnd,
Iterator fromEnd,
Iterator position,
FWD_ITER first,
SENTINEL last,
size_type numElements,
ALLOCATOR allocator);Insert the specified numElements in the range [first .. last)] at the specified position, by moving the elements in the range [position .. fromEnd)] forward by numElements position. Pass the specified allocator to the copy constructor if appropriate. Load into the specified toEnd an iterator to the end of the data after insertion (i.e., fromEnd + numElements). The behavior is undefined unless fromEnd + numElements is a valid iterator (i.e., the block pointer array holds enough room after the fromEnd position to insert numElements).
| Name | Description |
|---|---|
| toEnd | loads the end iterator after insertion |
| fromEnd | current end of the deque |
| position | insertion position within the deque |
| first | beginning of the source range to insert |
| last | end of the source range to insert (one past the last) |
| numElements | number of elements in [first .. last)] |
| allocator | allocator passed to element constructors |