[#BloombergLP-bdlcc-StripedUnorderedContainerImpl-eraseBulkFirst]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlcc.adoc[bdlcc]::xref:BloombergLP/bdlcc/StripedUnorderedContainerImpl.adoc[StripedUnorderedContainerImpl]::eraseBulkFirst
:relfileprefix: ../../../
:mrdocs:

Erase the first element for each key in `[first, last)]`.

== Synopsis

Declared in `<bdlcc_stripedunorderedcontainerimpl.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class RANDOM_ITER>
std::size_t
eraseBulkFirst(
    RANDOM_ITER first,
    RANDOM_ITER last);
----

== Description

The iterators provide read access to a sequence of `KEY` objects. If there are multiple elements for any key value, erase just the first such element found. All erasures are done by the calling thread and the order of erasure is not specified. Return the number of elements removed. The behavior is undefined unless `first <= last`. Note that the map may not have an element for every value in `keys`.

== Return Value

number of elements removed

== Parameters

[cols="1,4"]
|===
| Name| Description
| *first*
| beginning of the key range
| *last*
| end of the key range
|===


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