[#bsl-multimap-0ae-2constructor-005]
= xref:bsl.adoc[bsl]::xref:bsl/multimap-0ae.adoc[multimap]::multimap
:relfileprefix: ../../
:mrdocs:

Constructors

== Synopses

Declared in `<bslstl_multimap.h>`

Create an empty multimap.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/multimap-0ae/2constructor-083.adoc[multimap]();
----

[.small]#xref:bsl/multimap-0ae/2constructor-083.adoc[_» more..._]#

Create a multimap with the same value as `original`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/multimap-0ae/2constructor-000.adoc[multimap](xref:bsl/multimap-0ae.adoc[multimap] const& original);
----

[.small]#xref:bsl/multimap-0ae/2constructor-000.adoc[_» more..._]#

Create a multimap by moving from `original`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/multimap-0ae/2constructor-04.adoc[multimap](xref:BloombergLP/bslmf/MovableRef.adoc[BloombergLP::bslmf::MovableRef<multimap>] original);
----

[.small]#xref:bsl/multimap-0ae/2constructor-04.adoc[_» more..._]#

Create an empty multimap that uses `basicAllocator`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
explicit
xref:bsl/multimap-0ae/2constructor-05.adoc[multimap](ALLOCATOR const& basicAllocator);
----

[.small]#xref:bsl/multimap-0ae/2constructor-05.adoc[_» more..._]#

Create a multimap by moving from `original` using `basicAllocator`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/multimap-0ae/2constructor-00f.adoc[multimap](
    xref:BloombergLP/bslmf/MovableRef.adoc[BloombergLP::bslmf::MovableRef<multimap>] original,
    ALLOCATOR const& basicAllocator);
----

[.small]#xref:bsl/multimap-0ae/2constructor-00f.adoc[_» more..._]#

Create a multimap from `values` using `basicAllocator`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/multimap-0ae/2constructor-029.adoc[multimap](
    std::initializer_list<value_type> values,
    ALLOCATOR const& basicAllocator);
----

[.small]#xref:bsl/multimap-0ae/2constructor-029.adoc[_» more..._]#

Create an empty multimap using `comparator` and `basicAllocator`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
explicit
xref:bsl/multimap-0ae/2constructor-08d.adoc[multimap](
    COMPARATOR const& comparator,
    ALLOCATOR const& basicAllocator = ALLOCATOR());
----

[.small]#xref:bsl/multimap-0ae/2constructor-08d.adoc[_» more..._]#

Create a multimap with the value of `original` using `basicAllocator`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/multimap-0ae/2constructor-0c.adoc[multimap](
    xref:bsl/multimap-0ae.adoc[multimap] const& original,
    ALLOCATOR const& basicAllocator);
----

[.small]#xref:bsl/multimap-0ae/2constructor-0c.adoc[_» more..._]#

Create a multimap from `values`, optionally with comparator and allocator.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/multimap-0ae/2constructor-085.adoc[multimap](
    std::initializer_list<value_type> values,
    COMPARATOR const& comparator = COMPARATOR(),
    ALLOCATOR const& basicAllocator = ALLOCATOR());
----

[.small]#xref:bsl/multimap-0ae/2constructor-085.adoc[_» more..._]#

Create a multimap from `[first, last)]` using `basicAllocator`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class INPUT_ITERATOR>
xref:bsl/multimap-0ae/2constructor-0a.adoc[multimap](
    INPUT_ITERATOR first,
    INPUT_ITERATOR last,
    ALLOCATOR const& basicAllocator);
----

[.small]#xref:bsl/multimap-0ae/2constructor-0a.adoc[_» more..._]#

Create a multimap from `range` using `basicAllocator`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class RANGE>
xref:bsl/multimap-0ae/2constructor-09.adoc[multimap](
    std::from_range_t tag,
    RANGE&& range,
    ALLOCATOR const& basicAllocator);
----

[.small]#xref:bsl/multimap-0ae/2constructor-09.adoc[_» more..._]#

Create a multimap from `[first, last)]`, optionally with comparator and allocator.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class INPUT_ITERATOR>
xref:bsl/multimap-0ae/2constructor-02e.adoc[multimap](
    INPUT_ITERATOR first,
    INPUT_ITERATOR last,
    COMPARATOR const& comparator = COMPARATOR(),
    ALLOCATOR const& basicAllocator = ALLOCATOR());
----

[.small]#xref:bsl/multimap-0ae/2constructor-02e.adoc[_» more..._]#

Create a multimap from `range`, optionally with comparator and allocator.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class RANGE>
xref:bsl/multimap-0ae/2constructor-0d.adoc[multimap](
    std::from_range_t tag,
    RANGE&& range,
    COMPARATOR const& comparator = COMPARATOR(),
    ALLOCATOR const& basicAllocator = ALLOCATOR());
----

[.small]#xref:bsl/multimap-0ae/2constructor-0d.adoc[_» more..._]#

== Parameters

[cols="1,4"]
|===
| Name| Description
| *original*
| multimap to copy
| *basicAllocator*
| allocator used to supply memory
| *values*
| initializer list of elements to insert
| *comparator*
| functor used to order keys
| *first*
| beginning of the range to copy
| *last*
| end of the range to copy
| *tag*
| disambiguation tag for range construction
| *range*
| input range of elements to insert
|===


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