[#BloombergLP-bsltf-InputIteratorUtil-begin-060]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bsltf.adoc[bsltf]::xref:BloombergLP/bsltf/InputIteratorUtil.adoc[InputIteratorUtil]::begin
:relfileprefix: ../../../
:mrdocs:

`begin` overloads

== Synopses

Declared in `&lt;bsltf&lowbar;inputiterator&period;h&gt;`

Return an `InputIterator` referring to the first element of the specified `container` or a null iterator if `container` is empty&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class CONTIGUOUS&lowbar;CONTAINER&gt;
static
xref:BloombergLP/bsltf/InputIterator.adoc[InputIterator&lt;CONTIGUOUS&lowbar;CONTAINER::value&lowbar;type&gt;]
xref:BloombergLP/bsltf/InputIteratorUtil/begin-05.adoc[begin](CONTIGUOUS&lowbar;CONTAINER& container);
----

[.small]#xref:BloombergLP/bsltf/InputIteratorUtil/begin-05.adoc[_» more&period;&period;&period;_]#

Return an `InputIterator` referring to the first element of the specified `container` or a null iterator if `container` is empty&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class CONTIGUOUS&lowbar;CONTAINER&gt;
static
xref:BloombergLP/bsltf/InputIterator.adoc[InputIterator&lt;CONTIGUOUS&lowbar;CONTAINER::value&lowbar;type const&gt;]
xref:BloombergLP/bsltf/InputIteratorUtil/begin-06b.adoc[begin](CONTIGUOUS&lowbar;CONTAINER const& container);
----

[.small]#xref:BloombergLP/bsltf/InputIteratorUtil/begin-06b.adoc[_» more&period;&period;&period;_]#

Return an `InputIterator` referring to the first element of the specified `array`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;
    class TYPE,
    std::size&lowbar;t LEN&gt;
static
xref:BloombergLP/bsltf/InputIterator.adoc[InputIterator&lt;TYPE&gt;]
xref:BloombergLP/bsltf/InputIteratorUtil/begin-0e.adoc[begin](TYPE(& array)[]);
----

[.small]#xref:BloombergLP/bsltf/InputIteratorUtil/begin-0e.adoc[_» more&period;&period;&period;_]#

Return an `InputIterator` referring to the first element of the specified `array`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;
    class TYPE,
    std::size&lowbar;t LEN&gt;
static
xref:BloombergLP/bsltf/InputIterator.adoc[InputIterator&lt;TYPE const&gt;]
xref:BloombergLP/bsltf/InputIteratorUtil/begin-03.adoc[begin](TYPE const(& array)[]);
----

[.small]#xref:BloombergLP/bsltf/InputIteratorUtil/begin-03.adoc[_» more&period;&period;&period;_]#

== Return Value

* an iterator to the first element, or a null iterator if empty
* an iterator referring to the first element of `array`

== Parameters

[cols="1,4"]
|===
| Name| Description
| *container*
| contiguous container providing the range
| *array*
| contiguous array providing the range
|===


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