[#BloombergLP-bslalg-ScalarPrimitives-destructiveMove]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslalg.adoc[bslalg]::xref:BloombergLP/bslalg/ScalarPrimitives.adoc[ScalarPrimitives]::destructiveMove
:relfileprefix: ../../../
:mrdocs:

Move the state of the object of the parameterized `TARGET_TYPE` from the object at the specified `original` address to the uninitialized memory at the specified `address`, as if by move constructing and then destroying the original. If the parameterized `ALLOCATOR` is based on `bslma::Allocator` and `TARGET_TYPE` takes an allocator constructor argument, then the moved object uses the specified `allocator` to supply memory. If the move constructor throws, the `address` is left in an uninitialized state and the `original` is left unchanged. The behavior is undefined unless the `original` object also uses the `allocator`. Note that bit‐wise copy will be used and `allocator` will be ignored if TARGET_TYPE' has the bit‐wise moveable trait. Note that, if `ALLOCATOR` is not based on `bslma::Allocator`, then the `allocator` argument is ignored; the allocator used by the resulting object at `address` might or might not be the same as the allocator used by `original`, depending on whether `TARGET_TYPE` has a move constructor (C++11).

== Synopsis

Declared in `<bslalg_scalarprimitives.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class TARGET_TYPE,
    class ALLOCATOR>
static
void
destructiveMove(
    TARGET_TYPE* address,
    TARGET_TYPE* original,
    ALLOCATOR* allocator);
----


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