Insert copies of a value, shifting subsequent elements.
Declared in <bslalg_arrayprimitives.h>
template<class ALLOCATOR>
static
void
insert(
bsl::allocator_traits<ALLOCATOR>::pointer toBegin,
bsl::allocator_traits<ALLOCATOR>::pointer toEnd,
bsl::allocator_traits<ALLOCATOR>::value_type const& value,
size_type numElements,
ALLOCATOR allocator);Insert the specified numElements copies of the specified value into the array of type allocator_traits<ALLOCATOR>::value_type starting at the specified toBegin location, shifting forward the elements from toBegin to the specified toEnd location by numElements positions. If a (copy or move) constructor or a (copy or move) assignment operator throws an exception, any elements created after toEnd are destroyed and the elements in the range [toBegin .. toEnd)] are left in a valid but unspecified state. The behavior is undefined unless toBegin refers to space sufficient to hold at least toEnd - toBegin + numElements elements.
| Name | Description |
|---|---|
| toBegin | insertion position within the destination array |
| toEnd | end of the populated destination range |
| value | value copied into each inserted element |
| numElements | number of copies of value to insert |
| allocator | allocator used to supply memory if required |