[#BloombergLP-bdlc-PackedIntArray-08-remove-07]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlc.adoc[bdlc]::xref:BloombergLP/bdlc/PackedIntArray-08.adoc[PackedIntArray<int>]::remove
:relfileprefix: ../../../
:mrdocs:

`remove` overloads

== Synopses

Declared in `<bdlc_packedintarray.h>`

Remove from this array the element at the specified `dstIndex`. Each element having an index greater than `dstIndex` before the removal is shifted down by one index position. The behavior is undefined unless `dstIndex < length()` .


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlc/PackedIntArray-08/remove-013.adoc[remove](std::size_t dstIndex);
----

[.small]#xref:BloombergLP/bdlc/PackedIntArray-08/remove-013.adoc[_» more..._]#

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


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

[.small]#xref:BloombergLP/bdlc/PackedIntArray-08/remove-01b.adoc[_» more..._]#

Remove from this array, starting at the specified `dstIndex`, the specified `numElements`, shifting the elements of this array that are at `dstIndex + numElements` or above to `numElements` indices lower. The behavior is undefined unless `dstIndex + numElements <= length()`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/bdlc/PackedIntArray-08/remove-04.adoc[remove](
    std::size_t dstIndex,
    std::size_t numElements);
----

[.small]#xref:BloombergLP/bdlc/PackedIntArray-08/remove-04.adoc[_» more..._]#


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