Destroy the elements in the specified array range using an allocator.
Declared in <bslalg_arraydestructionprimitives.h>
template<
class TARGET_TYPE,
class ALLOCATOR>
static
void
destroy(
TARGET_TYPE* begin,
TARGET_TYPE* end,
ALLOCATOR allocator);Destroy the elements in the segment of an array of parameterized TARGET_TYPE beginning at the specified begin address and ending immediately before the specified end address, using the specified allocator. If begin == 0 and end == 0 this function has no effect. The behavior is undefined unless either (1) begin <= end, begin != 0, and end != 0, or (2) begin == 0 && end == 0. Note that this method does not deallocate any memory (except memory deallocated by the element destructor calls).
| Name | Description |
|---|---|
| begin | beginning of the range of elements to destroy |
| end | end of the range of elements to destroy (one past the last) |
| allocator | allocator used to destroy elements |