[#bsl-unordered_map-02b-begin-03]
= xref:bsl.adoc[bsl]::xref:bsl/unordered_map-02b.adoc[unordered&lowbar;map]::begin
:relfileprefix: ../../
:mrdocs:

Return a const local iterator to the first element in bucket `index`&period;

== Synopsis

Declared in `&lt;bslstl&lowbar;unorderedmap&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/unordered_map-02b/const_local_iterator.adoc[const&lowbar;local&lowbar;iterator]
begin(xref:bsl/unordered_map-02b/size_type.adoc[size&lowbar;type] index) const;
----

== Description

Return a local iterator providing non&hyphen;modifiable access to the first `value&lowbar;type` object in the sequence of `value&lowbar;type` objects of the bucket having the specified `index` in the array of buckets maintained by this unordered map, or the `end(index)` iterator if the bucket is empty&period; The behavior is undefined unless `index &lt; bucket&lowbar;count()`&period;

== Return Value

const local iterator to the first element, or `end(index)` if empty

== Parameters

[cols="1,4"]
|===
| Name| Description
| *index*
| bucket index
|===


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