std::queue<T,Container>::swap - cppreference.com (original) (raw)

| void swap( queue& other ) noexcept(/* see below */); | | (since C++11) | | ------------------------------------------------------ | | ------------- |

Exchanges the contents of the container adaptor with those of other. Effectively calls

Contents

[edit] Parameters

other - container adaptor to exchange the contents with

[edit] Return value

(none)

[edit] Exceptions

[edit] Complexity

Same as underlying container (typically constant).

Notes

Some implementations (e.g. libc++) provide the swap member function as an extension to pre-C++11 modes.

[edit] Example

#include #include #include #include #include #include   template requires (std::ranges::input_range) void print(std::string_view name, const Adaptor& adaptor) { struct Printer : Adaptor // to use protected Adaptor::Container c; { void print(std::string_view name) const { std::cout << name << " [" << std::size(this->c) << "]: "; for (auto const& elem : this->c) std::cout << elem << ' '; std::cout << '\n'; } };   static_cast<Printer const&>(adaptor).print(name); }   int main() { std::vector<std::string> v1{"1","2","3","4"}, v2{"Ɐ","B","Ɔ","D","Ǝ"};   std::queue s1(std::move(v1)); std::queue s2(std::move(v2));   print("s1", s1); print("s2", s2);   s1.swap(s2);   print("s1", s1); print("s2", s2); }

Output:

s1 [4]: 4 3 2 1 s2 [5]: Ǝ D Ɔ B Ɐ s1 [5]: Ǝ D Ɔ B Ɐ s2 [4]: 4 3 2 1

Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

DR Applied to Behavior as published Correct behavior
LWG 2456 C++11 the noexcept specification is ill-formed made to work

[edit] See also