std::inplace_vector<T,N>::swap
From cppreference.com
< cpp | container | inplace vector
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Containers library
(C++17)
(C++11)
(C++26)
(C++26)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++23)
(C++23)
(C++23)
(C++23)
(C++20)
(C++23)
Tables
std::inplace_vector
inplace_vector::swap
constexpr void swap( inplace_vector& other ) noexcept(/* see below */);
(since C++26)
Exchanges the contents of the container with those of other. Does not cause iterators and references to associate with the other container.
[edit] Parameters
other
-
container to exchange the contents with
[edit] Return value
(none)
[edit] Exceptions
noexcept specification:
noexcept(N == 0 ||
(std::is_nothrow_swappable_v <T> && std::is_nothrow_move_constructible_v <T>))
(std::is_nothrow_swappable_v <T> && std::is_nothrow_move_constructible_v <T>))
[edit] Complexity
Linear in size of the container.
[edit] Example
Run this code
#include <inplace_vector> #include <print> int main() { std::inplace_vector <int, 3> a1{1, 2, 3}, a2{4, 5, 6}; auto i1 = a1.begin(); auto i2 = a2.begin(); int& r1 = a1[1]; int& r2 = a2[1]; auto print_them_all = [&](auto rem) { std::println ("{}a1 = {}, a2 = {}, *i1 = {}, *i2 = {}, r1 = {}, r2 = {}", rem, a1, a2, *i1, *i2, r1, r2); }; print_them_all("Before swap:\n"); a1.swap(a2); print_them_all("After swap:\n"); // Note that after swap() iterators and references stay associated with their // original sites, e.g., i1 points to element a1[0], r1 refers to a1[1]. }
Output:
Before swap: a1 = [1, 2, 3], a2 = [4, 5, 6], *i1 = 1, *i2 = 4, r1 = 2, r2 = 5 After swap: a1 = [4, 5, 6], a2 = [1, 2, 3], *i1 = 4, *i2 = 1, r1 = 5, r2 = 2