[#BloombergLP-bslalg-ArrayPrimitives-destructiveMoveAndInsert-06]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslalg.adoc[bslalg]::xref:BloombergLP/bslalg/ArrayPrimitives.adoc[ArrayPrimitives]::destructiveMoveAndInsert
:relfileprefix: ../../../
:mrdocs:

Move the elements of the (template parameter) `TARGET_TYPE` in the starting at the specified `fromBegin` address and ending immediately before the specified `fromEnd` address into the uninitialized array beginning at the specified `toBegin` location using the specified `allocator` to supply memory (if required), inserting at the specified `position` (after translating from `fromBegin` to `toBegin`) `numElements` objects initialized to default values, ensuring that the specified `fromEndPtr` points to the first uninitialized element in `[fromBegin .. fromEnd)]` as the elements are moved from source to destination. On return, the elements in the input range are invalid, i.e., their destructors must not be called after this operation returns. If a constructor throws an exception during this operation, the output array is left in an uninitialized state. If a default constructor throws an exception, the input array is unaffected; otherwise, if a (copy or move) constructor throws an exception during this operation, the input elements in the range `[fromBegin .. *fromEndPtr)]` are left in a valid but unspecified state and the remaining portion of the input array is left in an uninitialized state. The behavior is undefined unless `fromBegin <= position <= fromEnd` and `toBegin` refers to space sufficient to hold `fromEnd ‐ fromBegin + numElements` elements.

== Synopsis

Declared in `<bslalg_arrayprimitives.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class TARGET_TYPE>
static
void
destructiveMoveAndInsert(
    TARGET_TYPE* toBegin,
    TARGET_TYPE** fromEndPtr,
    TARGET_TYPE* fromBegin,
    TARGET_TYPE* position,
    TARGET_TYPE* fromEnd,
    xref:BloombergLP/bslalg/ArrayPrimitives/size_type.adoc[size_type] numElements,
    xref:BloombergLP/bslma/Allocator.adoc[bslma::Allocator]* allocator);
----


[.small]#Created with https://www.mrdocs.com[MrDocs]#