Emplace a newly constructed element, shifting subsequent elements.

Synopses

Declared in <bslalg_arrayprimitives.h>

Emplace a newly constructed element, shifting subsequent elements.

template<
    class ALLOCATOR,
    class... ARGS>
static
void
emplace(
    bsl::allocator_traits<ALLOCATOR>::pointer toBegin,
    bsl::allocator_traits<ALLOCATOR>::pointer toEnd,
    ALLOCATOR allocator,
    ARGS&&... arguments);

Emplace a newly constructed element, shifting subsequent elements.

template<
    class TARGET_TYPE,
    class... ARGS>
static
void
emplace(
    TARGET_TYPE* toBegin,
    TARGET_TYPE* toEnd,
    bslma::Allocator* allocator,
    ARGS&&... args);

Parameters

Name

Description

toBegin

insertion position within the destination array

toEnd

end of the populated destination range

allocator

allocator used to supply memory if required

arguments

constructor arguments forwarded to the new element

args

constructor arguments forwarded to the new element

Created with MrDocs