BloombergLP::bslalg::DequePrimitives::insertAndMoveToBack

Insert copies of a value toward the back (bitwise-copyable).

Synopsis

Declared in <bslalg_dequeprimitives.h>

template<class ALLOCATOR>
static
void
insertAndMoveToBack(
    Iterator* toEnd,
    Iterator fromEnd,
    Iterator position,
    size_type numElements,
    VALUE_TYPE const& value,
    ALLOCATOR allocator,
    bsl::integral_constant<int, BSLALG_DEQUEPRIMITIVES_BITWISE_COPYABLE_TRAITS> traits);

Description

Insert the specified numElements copies of the specified value 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 deque 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). Note that the last argument is for removing overload ambiguities and is not used.

Parameters

NameDescription
toEndloads the end iterator after insertion
fromEndcurrent end of the deque
positioninsertion position within the deque
numElementsnumber of copies of value to insert
valuevalue copied into each inserted element
allocatorallocator passed to element constructors
traitsunused trait tag for overload resolution