Destroy the elements in the specified array range using an allocator.

Synopsis

Declared in <bslalg_arraydestructionprimitives.h>

template<
    class TARGET_TYPE,
    class ALLOCATOR>
static
void
destroy(
    TARGET_TYPE* begin,
    TARGET_TYPE* end,
    ALLOCATOR allocator);

Description

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).

Parameters

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

Created with MrDocs