std::inplace_vector<T,N>::operator=

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

容器庫

序列

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

關聯

set

multiset

map

multimap

無序關聯

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

介面卡

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

檢視

span (C++20)

mdspan (C++23)

表格

迭代器失效

成員函式表格

非成員函式表格

 

std::inplace_vector

成員型別
成員函式
inplace_vector::inplace_vector inplace_vector::~inplace_vector    inplace_vector::operator= inplace_vector::assign inplace_vector::assign_range 大小和容量 inplace_vector::empty inplace_vector::size inplace_vector::max_size inplace_vector::capacity inplace_vector::resize inplace_vector::reserve inplace_vector::shrink_to_fit 迭代器 inplace_vector::begininplace_vector::cbegin inplace_vector::endinplace_vector::cend inplace_vector::rbegininplace_vector::crbegin inplace_vector::rendinplace_vector::crend	元素訪問 inplace_vector::at inplace_vector::operator[] inplace_vector::front inplace_vector::back inplace_vector::data 修改器 inplace_vector::clear inplace_vector::erase inplace_vector::swap inplace_vector::insert inplace_vector::insert_range inplace_vector::emplace inplace_vector::emplace_back inplace_vector::try_emplace_back inplace_vector::unchecked_emplace_back inplace_vector::push_back inplace_vector::try_push_back inplace_vector::unchecked_push_back inplace_vector::pop_back inplace_vector::append_range inplace_vector::try_append_range
非成員函式
erase(std::inplace_vector)erase_if(std::inplace_vector) swap(std::inplace_vector)	operator==operator<=>

 

constexpr inplace_vector& operator=( const inplace_vector& other );	(1)	(C++26 起)
constexpr inplace_vector& operator=( inplace_vector&& other )     noexcept(/* 見下 */);	(2)	(C++26 起)
constexpr inplace_vector& operator=( std::initializer_list<T> init );	(3)	(C++26 起)

替換 inplace_vector 的內容。

1) 複製賦值運算子。如果 std::inplace_vector<T, N> 具有平凡解構函式，且 std::is_trivially_copy_constructible_v<T> && std::is_trivially_copy_assignable_v<T> 為 true，則它也是一個平凡複製賦值運算子。用 other 內容的副本替換當前內容。

2) 移動賦值運算子。如果 std::inplace_vector<T, N> 具有平凡解構函式，且 std::is_trivially_move_constructible_v<T> && std::is_trivially_move_assignable_v<T> 為 true，則它也是一個平凡移動賦值運算子。使用移動語義（即，other 中的資料從 other 移動到此容器中）替換內容。之後 other 處於有效但未指定的狀態。

3) 用初始化列表 init 標識的內容替換當前內容。

引數

其他	-	另一個 inplace_vector，用作初始化容器元素的源
init	-	用於初始化容器元素的初始化列表

複雜度

1,2) 與 *this 和 other 的大小呈線性關係。

3) 與 *this 和 init 的大小呈線性關係。

異常

2)

noexcept 規範：  

noexcept(N == 0 ||

        (std::is_nothrow_move_assignable_v<T> &&

         std::is_nothrow_move_constructible_v<T>))

3) 如果 init.size() > N，則丟擲 std::bad_alloc。

示例

執行此程式碼

#include <initializer_list>
#include <inplace_vector>
#include <new>
#include <print>
#include <ranges>
#include <string>
 
int main()
{
    std::inplace_vector<int, 4> x({1, 2, 3}), y;
    std::println("Initially:");
    std::println("x = {}", x);
    std::println("y = {}", y);
 
    std::println("Copy assignment copies data from x to y:");
    y = x; // overload (1)
    std::println("x = {}", x);
    std::println("y = {}", y);
 
    std::inplace_vector<std::string, 3> z, w{"\N{CAT}", "\N{GREEN HEART}"};
    std::println("Initially:");
    std::println("z = {}", z);
    std::println("w = {}", w);
 
    std::println("Move assignment moves data from w to z:");
    z = std::move(w); // overload (2)
    std::println("z = {}", z);
    std::println("w = {}", w); // w is in valid but unspecified state
 
    auto l = {4, 5, 6, 7};
    std::println("Assignment of initializer_list {} to x:", l);
    x = l; // overload (3)
    std::println("x = {}", x);
 
    std::println("Assignment of initializer_list with size bigger than N throws:");
    try
    {
        x = {1, 2, 3, 4, 5}; // throws: (initializer list size == 5) > (capacity N == 4)
    }
    catch(const std::bad_alloc& ex)
    {
        std::println("ex.what(): {}", ex.what());
    }
}

可能的輸出

Initially:
x = [1, 2, 3]
y = []
Copy assignment copies data from x to y:
x = [1, 2, 3]
y = [1, 2, 3]
Initially:
z = []
w = ["🐈", "💚"]
Move assignment moves data from w to z:
z = ["🐈", "💚"]
w = ["", ""]
Assignment of initializer_list [4, 5, 6, 7] to x:
x = [4, 5, 6, 7]
Assignment of initializer_list with size bigger than N throws:
ex.what(): std::bad_alloc

參閱

(建構函式)	構造 inplace_vector (public member function)
assign	將值賦給容器 (public member function)