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 |