[#bsl-hashtable-insert_equal-0f]
= xref:bsl.adoc[bsl]::xref:bsl/hashtable.adoc[hashtable]::insert&lowbar;equal
:relfileprefix: ../../
:mrdocs:

`insert&lowbar;equal` overloads

== Synopses

Declared in `&lt;bslstp&lowbar;hashtable&period;h&gt;`

Insert the specified `&lowbar;&lowbar;obj` if no equivalent element exists&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/hashtable/iterator.adoc[iterator]
xref:bsl/hashtable/insert_equal-01.adoc[insert&lowbar;equal](xref:bsl/hashtable/value_type.adoc[value&lowbar;type] const& &lowbar;&lowbar;obj);
----

[.small]#xref:bsl/hashtable/insert_equal-01.adoc[_» more&period;&period;&period;_]#

Insert each value in the specified `&lsqb;&lowbar;&lowbar;f, &lowbar;&lowbar;l)&rsqb;` range&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class &lowbar;InputIterator&gt;
void
xref:bsl/hashtable/insert_equal-06.adoc[insert&lowbar;equal](
    &lowbar;InputIterator &lowbar;&lowbar;f,
    &lowbar;InputIterator &lowbar;&lowbar;l);
----

[.small]#xref:bsl/hashtable/insert_equal-06.adoc[_» more&period;&period;&period;_]#

Insert each value in the specified forward range&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class &lowbar;ForwardIterator&gt;
void
xref:bsl/hashtable/insert_equal-08.adoc[insert&lowbar;equal](
    &lowbar;ForwardIterator &lowbar;&lowbar;f,
    &lowbar;ForwardIterator &lowbar;&lowbar;l,
    std::forward&lowbar;iterator&lowbar;tag const& &lowbar;&lowbar;tag);
----

[.small]#xref:bsl/hashtable/insert_equal-08.adoc[_» more&period;&period;&period;_]#

Insert each value in the specified `&lsqb;&lowbar;&lowbar;f, &lowbar;&lowbar;l)&rsqb;` range, allowing duplicates&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class &lowbar;InputIterator&gt;
void
xref:bsl/hashtable/insert_equal-00.adoc[insert&lowbar;equal](
    &lowbar;InputIterator &lowbar;&lowbar;f,
    &lowbar;InputIterator &lowbar;&lowbar;l,
    std::input&lowbar;iterator&lowbar;tag const& &lowbar;&lowbar;tag);
----

[.small]#xref:bsl/hashtable/insert_equal-00.adoc[_» more&period;&period;&period;_]#

== Return Value

iterator to the inserted element

== Parameters

[cols="1,4"]
|===
| Name| Description
| *&lowbar;&lowbar;obj*
| value to insert
| *&lowbar;&lowbar;f*
| beginning of the input range
| *&lowbar;&lowbar;l*
| end of the input range
| *&lowbar;&lowbar;tag*
| forward&hyphen;iterator category tag (overload discriminator)
|===


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