[#BloombergLP-bdlcc-StripedUnorderedMultiMap-visitReadOnly-0a]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlcc.adoc[bdlcc]::xref:BloombergLP/bdlcc/StripedUnorderedMultiMap.adoc[StripedUnorderedMultiMap]::visitReadOnly
:relfileprefix: ../../../
:mrdocs:

`visitReadOnly` overloads

== Synopses

Declared in `<bdlcc_stripedunorderedmultimap.h>`

Call the specified `visitor` (in an unspecified order) on the elements in this hash table until each such element has been visited or `visitor` returns `false`. That is, for `(key, value)`, invoke: ` bool visitor(value, key); ` Return the number of elements visited or the negation of that value if visitations stopped because `visitor` returned `false`. `visitor` has read‐only access to each element for duration of each invocation. Every element present in this hash map at the time `visit` is invoked will be visited unless it is removed before `visitor` is called for that element. Each visitation is done by the calling thread and the order of visitation is not specified. The behavior is undefined if hash map manipulators are invoked from within `visitor`, as it may lead to a deadlock. Note that `visitor` can _not_ change the value of the visited elements.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
xref:BloombergLP/bdlcc/StripedUnorderedMultiMap/visitReadOnly-00.adoc[visitReadOnly](xref:BloombergLP/bdlcc/StripedUnorderedMultiMap/ReadOnlyVisitorFunction.adoc[ReadOnlyVisitorFunction] const& visitor) const;
----

[.small]#xref:BloombergLP/bdlcc/StripedUnorderedMultiMap/visitReadOnly-00.adoc[_» more..._]#

Serially call the specified `visitor` on each element (if one exists) in this hash map having the specified `key` until every such element has been visited or `visitor` returns `false`. That is, for `(key, value)`, invoke: ` bool visitor(value, key); ` Return the number of elements visited or the negation of that value if visitations stopped because `visitor` returned `false`. `visitor` has read‐only access to each element for duration of each invocation. The behavior is undefined if hash map manipulators are invoked from within `visitor`, as it may lead to a deadlock.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
xref:BloombergLP/bdlcc/StripedUnorderedMultiMap/visitReadOnly-06.adoc[visitReadOnly](
    KEY const& key,
    xref:BloombergLP/bdlcc/StripedUnorderedMultiMap/ReadOnlyVisitorFunction.adoc[ReadOnlyVisitorFunction] const& visitor) const;
----

[.small]#xref:BloombergLP/bdlcc/StripedUnorderedMultiMap/visitReadOnly-06.adoc[_» more..._]#


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