BloombergLP::bslalg::DequePrimitives::valueInititalizeN

Append value-initialized elements to the back of a deque.

Synopsis

Declared in <bslalg_dequeprimitives.h>

template<class ALLOCATOR>
static
void
valueInititalizeN(
    Iterator* toEnd,
    Iterator fromEnd,
    size_type numElements,
    ALLOCATOR allocator);

Description

Append the specified numElements value-initialized objects to the deque ending at the specified fromEnd iterator, passing the specified allocator through to the new elements, and load into the specified toEnd an iterator pointing to the end of the data after appending (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

NameDescription
toEndloads the end iterator after appending
fromEndcurrent end of the deque
numElementsnumber of value-initialized elements to append
allocatorallocator passed to element constructors