BloombergLP::bslalg::ArrayPrimitives::defaultConstruct

Value-initialize elements into an uninitialized array.

Synopsis

Declared in <bslalg_arrayprimitives.h>

template<class ALLOCATOR>
static
void
defaultConstruct(
    bsl::allocator_traits<ALLOCATOR>::pointer begin,
    size_type numElements,
    ALLOCATOR allocator);

Description

Value-initialize the specified numElements objects of type allocator_traits<ALLOCATOR>::value_type into the uninitialized array beginning at the specified begin location, using the specified allocator to supply memory (if required). If a constructor throws an exception during this operation, then the destructor is called on any newly constructed elements, leaving the output array in an uninitialized state. The behavior is undefined unless the begin refers to space sufficient to hold numElements.

Parameters

NameDescription
beginbeginning of the uninitialized destination range
numElementsnumber of elements to value-initialize
allocatorallocator used to supply memory if required