Movatterモバイル変換


[0]ホーム

URL:


cppreference.com
Namespaces
Variants
    Actions

      std::map<Key,T,Compare,Allocator>::swap

      From cppreference.com
      <cpp‎ |container‎ |map

      [edit template]
       
       
       
      std::map
      Member functions
      Non-member functions
      (until C++20)(until C++20)(until C++20)(until C++20)(until C++20)
      Deduction guides(C++17)
       
      void swap( map& other);
      (until C++17)
      void swap( map& other)noexcept(/* see below */);
      (since C++17)
      (constexpr since C++26)

      Exchanges the contents of the container with those ofother. Does not invoke any move, copy, or swap operations on individual elements.

      All iterators and references remain valid. Theend() iterator is invalidated.Compare must beSwappable, and objects of this type are exchanged using unqualified call to non-memberswap.

      Ifstd::allocator_traits<allocator_type>::propagate_on_container_swap::value istrue, then the allocators are exchanged using an unqualified call to non-memberswap. Otherwise, they are not swapped (and ifget_allocator()!= other.get_allocator(), the behavior is undefined).

      (since C++11)

      Contents

      [edit]Parameters

      other - container to exchange the contents with

      [edit]Exceptions

      Any exception thrown by the swap of theCompare objects.

      (until C++17)
      noexcept specification:  
      noexcept(std::allocator_traits<Allocator>::is_always_equal::value
      &&std::is_nothrow_swappable<Compare>::value)
      (since C++17)

      [edit]Complexity

      Constant.

      [edit]Example

      Run this code
      #include <iostream>#include <string>#include <utility>#include <map> // print out a std::pairtemplate<class Os,class U,class V>Os& operator<<(Os& os,conststd::pair<U, V>& p){return os<< p.first<<':'<< p.second;} // print out a containertemplate<class Os,class Co>Os& operator<<(Os& os,const Co& co){    os<<'{';for(constauto& i: co)        os<<' '<< i;return os<<" }\n";} int main(){std::map<std::string,std::string>        m1{{"γ","gamma"},{"β","beta"},{"α","alpha"},{"γ","gamma"}},        m2{{"ε","epsilon"},{"δ","delta"},{"ε","epsilon"}}; constauto& ref=*(m1.begin());constauto iter=std::next(m1.cbegin()); std::cout<<"──────── before swap ────────\n"<<"m1: "<< m1<<"m2: "<< m2<<"ref: "<< ref<<"\niter: "<<*iter<<'\n';     m1.swap(m2); std::cout<<"──────── after swap ────────\n"<<"m1: "<< m1<<"m2: "<< m2<<"ref: "<< ref<<"\niter: "<<*iter<<'\n'; // Note that every iterator referring to an element in one container before// the swap refers to the same element in the other container after the swap.// Same is true for references.}

      Output:

      ──────── before swap ────────m1: { α:alpha β:beta γ:gamma }m2: { δ:delta ε:epsilon }ref: α:alphaiter: β:beta──────── after swap ────────m1: { δ:delta ε:epsilon }m2: { α:alpha β:beta γ:gamma }ref: α:alphaiter: β:beta

      [edit]See also

      specializes thestd::swap algorithm
      (function template)[edit]
      Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/container/map/swap&oldid=135927"

      [8]ページ先頭

      ©2009-2025 Movatter.jp