[#BloombergLP-bdlcc-StripedUnorderedMultiMap-setValueFirst-01]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlcc.adoc[bdlcc]::xref:BloombergLP/bdlcc/StripedUnorderedMultiMap.adoc[StripedUnorderedMultiMap]::setValueFirst
:relfileprefix: ../../../
:mrdocs:

`setValueFirst` overloads

== Synopses

Declared in `<bdlcc_stripedunorderedmultimap.h>`

Set the value attribute of the _first_ element in this hash map (of possibly many) found to have the specified `key` to the specified move‐insertable `value`. If no such such element exists, insert `(key, value)`. Return the number of elements found with `key`. The `value` object is left in a valid but unspecified state. If `value` is allocator‐enabled and `allocator() != value.allocator()` this operation may cost as much as a copy. Note that if no elements were found, and a new value was inserted, `0` is returned. Also note that this method is more performant than `setValueAll` when there is one element having `key` in the hash map.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::size_t
xref:BloombergLP/bdlcc/StripedUnorderedMultiMap/setValueFirst-0e.adoc[setValueFirst](
    KEY const& key,
    xref:BloombergLP/bslmf/MovableRef.adoc[bslmf::MovableRef<VALUE>] value);
----

[.small]#xref:BloombergLP/bdlcc/StripedUnorderedMultiMap/setValueFirst-0e.adoc[_» more..._]#

Set the value attribute of the _first_ element in this hash map (of possibly many) found to have the specified `key` to the specified `value`. If no such such element exists, insert `(key, value)`. Return the number of elements found with `key`. Note that if no elements were found, and a new value was inserted, `0` is returned. Also note that this method is more performant than `setValueAll` when there is one element having `key` in the hash map.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::size_t
xref:BloombergLP/bdlcc/StripedUnorderedMultiMap/setValueFirst-0f.adoc[setValueFirst](
    KEY const& key,
    VALUE const& value);
----

[.small]#xref:BloombergLP/bdlcc/StripedUnorderedMultiMap/setValueFirst-0f.adoc[_» more..._]#


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