[#BloombergLP-bdlc-PackedIntArray-0b-remove-08]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlc.adoc[bdlc]::xref:BloombergLP/bdlc/PackedIntArray-0b.adoc[PackedIntArray]::remove
:relfileprefix: ../../../
:mrdocs:

Remove elements in the half‐open range `[dstFirst, dstLast)]`.

== Synopsis

Declared in `<bdlc_packedintarray.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/bdlc/PackedIntArray-0b/const_iterator.adoc[PackedIntArray<TYPE>::const_iterator]
remove(
    xref:BloombergLP/bdlc/PackedIntArray-0b/const_iterator.adoc[const_iterator] dstFirst,
    xref:BloombergLP/bdlc/PackedIntArray-0b/const_iterator.adoc[const_iterator] dstLast);
----

== Description

Remove from this array the elements starting from the specified `dstFirst` up to, but not including, the specified `dstLast`, shifting the elements of this array that are at or above `dstLast` to `dstLast ‐ dstFirst` indices lower. Return an iterator to the new position of the element that was referred to by `dstLast` or `end()` if `dstLast == end()`. The behavior is undefined unless `dstFirst <= dstLast`.

== Return Value

iterator to the new position of the former `dstLast` element, or `end()` if `dstLast == end()`

== Parameters

[cols="1,4"]
|===
| Name| Description
| *dstFirst*
| iterator to the first element to remove
| *dstLast*
| iterator one past the last element to remove
|===


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