Insert a source range, shifting existing elements toward the back.

Synopsis

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);

Description

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).

Parameters

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

Created with MrDocs