erase overloads

Synopses

Declared in <bslalg_arrayprimitives.h>

TBD: improve comment Destroy the elements of type given by the allocator_traits class template for (template parameter) ALLOCATOR starting at the specified first first pointer and ending immediately before the specified middle pointer, and move the elements in the array starting at middle and ending at the specified last pointer down to the first pointer. If an assignment throws an exception during this process, all of the elements in the range [ first, last )] will have unspecified but valid values, and no elements are destroyed. The behavior is undefined unless first <= middle <= last.

template<class ALLOCATOR>
static
void
erase(
    bsl::allocator_traits<ALLOCATOR>::pointer first,
    bsl::allocator_traits<ALLOCATOR>::pointer middle,
    bsl::allocator_traits<ALLOCATOR>::pointer last,
    ALLOCATOR allocator);

Destroy the elements of the parameterized TARGET_TYPE in the array starting at the specified first address and ending immediately before the specified middle address, and move the elements in the array starting at middle and ending at the specified last address down to the first address. If an assignment throws an exception during this process, all of the elements in the range [ first, last )] will have unspecified but valid values, and no elements are destroyed. The behavior is undefined unless first <= middle <= last.

template<class TARGET_TYPE>
static
void
erase(
    TARGET_TYPE* first,
    TARGET_TYPE* middle,
    TARGET_TYPE* last,
    bslma::Allocator* allocator = 0);

Created with MrDocs