cplusplus.com cplusplus.com
cplusplus.com   C++ : Reference : STL Containers : multimap : operator=
- -
C++
Information
Documentation
Reference
Articles
Sourcecode
Forum
Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
STL Containers
bitset
deque
list
map
multimap
multiset
priority_queue
queue
set
stack
vector
multimap
comparison operators
multimap::multimap
multimap::~multimap
member functions:
· multimap::begin
· multimap::clear
· multimap::count
· multimap::empty
· multimap::end
· multimap::equal_range
· multimap::erase
· multimap::find
· multimap::get_allocator
· multimap::insert
· multimap::key_comp
· multimap::lower_bound
· multimap::max_size
· multimap::operator=
· multimap::rbegin
· multimap::rend
· multimap::size
· multimap::swap
· multimap::upper_bound
· multimap::value_comp

-

multimap::operator= public member function
multimap<Key,T,Compare,Allocator>&
     operator= ( const multimap<Key,T,Compare,Allocator>& x );

Copy container content

Assigns a copy of the elements in x as the new content for the container.

The elements contained in the object before the call are dropped, and replaced by copies of those in multimap x, if any.

After a call to this member function, both the multimap object and x will have the same size and compare equal to each other.

Parameters

x
A multimap object with the same class template parameters (Key, T, Compare and Allocator).

Return value

*this

Example

// assignment operator with multimaps
#include <iostream>
#include <map>
using namespace std;

int main ()
{
  multimap<char,int> first;
  multimap<char,int> second;

  first.insert(pair<char,int>('x',32));
  first.insert(pair<char,int>('y',64));
  first.insert(pair<char,int>('y',96));
  first.insert(pair<char,int>('z',128));

  second=first;                // second now contains 4 ints
  first=multimap<char,int>();  // and first is now empty

  cout << "Size of first: " << int (first.size()) << endl;
  cout << "Size of second: " << int (second.size()) << endl;
  return 0;
}
Output:
Size of first: 0
Size of second: 4

Complexity

Linear on sizes (destruction, copy construction).

See also

multimap::insert Insert element (public member function)
multimap::find Get iterator to element (public member function)
multimap::multimap Construct multimap (public member function)

© The C++ Resources Network, 2000-2007 - All rights reserved
Spotted an error? - contact us