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

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

== Synopsis

Declared in `<bsltf_inputiterator.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class CONTIGUOUS_CONTAINER>
static
xref:BloombergLP/bsltf/InputIterator.adoc[InputIterator<CONTIGUOUS_CONTAINER::value_type const>]
begin(CONTIGUOUS_CONTAINER const& container);
----

== Return Value

an iterator to the first element, or a null iterator if empty

== Parameters

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


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