std::valarray<T>::operator=

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

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

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

數值庫

常用數學函式
數學特殊函式 (C++17)
數學常數 (C++20)
基本線性代數演算法 (C++26)
資料並行型別 (SIMD) (C++26)
浮點環境 (C++11)
複數
數值陣列 (valarray)
偽隨機數生成
位操作 (C++20)
因子運算
gcd (C++17)	lcm (C++17)
插值
midpoint (C++20)	lerp (C++20)
飽和算術
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
通用數值運算
iota (C++11) ranges::iota (C++23) accumulate inner_product adjacent_difference    partial_sum	reduce (C++17) transform_reduce (C++17) inclusive_scan (C++17) exclusive_scan (C++17) transform_inclusive_scan (C++17) transform_exclusive_scan (C++17)

 

std::valarray

成員函式
valarray::valarray valarray::~valarray valarray::operator= valarray::operator[] valarray::swap valarray::size valarray::resize valarray::sum valarray::min valarray::max valarray::shift valarray::cshift valarray::apply	valarray::operator+valarray::operator-valarray::operator~valarray::operator! valarray::operator+=valarray::operator-=valarray::operator*=valarray::operator/=valarray::operator%=valarray::operator&=valarray::operator|=valarray::operator^=valarray::operator<<=valarray::operator>>=
非成員函式
swap(std::valarray) (C++11) begin(std::valarray) (C++11)   end(std::valarray) (C++11) abs exp log log10 pow sqrt sin cos tan asin acos atan atan2 sinh cosh tanh	operator*operator/operator%operator+operator-operator^operator&operator|operator<<operator>>operator&&operator|| operator==operator!=operator<operator>operator<=operator>=
輔助類
slice_array gslice_array indirect_array	slice gslice mask_array
推導指南 (C++17 起)

 

valarray<T>& operator=( const valarray<T>& other );	(1)
valarray<T>& operator=( valarray<T>&& other ) noexcept;	(2)	(C++11 起)
valarray<T>& operator=( const T& val );	(3)
valarray<T>& operator=( const std::slice_array<T>& other );	(4)
valarray<T>& operator=( const std::gslice_array<T>& other );	(5)
valarray<T>& operator=( const std::mask_array<T>& other );	(6)
valarray<T>& operator=( const std::indirect_array<T>& other );	(7)
valarray<T>& operator=( std::initializer_list<T> il );	(8)	(C++11 起)

替換數值陣列的內容。

1) 複製賦值運算子。如果 size() != other.size()，首先像透過 resize(other.size()) 那樣調整 *this 的大小。將 *this 的每個元素賦值為 other 相應元素的值。

2) 移動賦值運算子。用 other 的內容替換 *this 的內容。操作後 other 的值未指定。如果 T 具有非平凡解構函式，此操作的複雜度可能是線性的，否則通常為常數。

3) 用 val 的副本替換 *this 中的每個值。

4-7) 用廣義下標操作的結果替換 *this 的內容。如果 size() 不等於 other 的長度，或者如果左側的任何值依賴於右側的值（例如 v = v[v > 2]），則行為未定義。

8) 賦值初始化列表 il 的內容。等價於 *this = valarray(il)。

引數

其他	-	要賦值的另一個數值陣列（或掩碼）
val	-	用於初始化每個元素的值
il	-	要賦值的初始化列表

返回值

*this

異常

1,3-8) 可能丟擲實現定義的異常。

示例

執行此程式碼

#include <iomanip>
#include <iostream>
#include <valarray>
 
void print(const char* rem, const std::valarray<int>& v)
{
    std::cout << std::left << std::setw(36) << rem << std::right;
    for (int n : v)
        std::cout << std::setw(3) << n;
    std::cout << '\n';
}
 
int main()
{
    std::valarray<int> v1(3);
    v1 = -1; // (3) from a scalar 
    print("assigned from scalar: ", v1);
 
    v1 = {1, 2, 3, 4, 5, 6}; // (8): from initializer list of different size
    print("assigned from initializer_list:", v1);
 
    std::valarray<int> v2(3);
    v2 = v1[std::slice(0, 3, 2)]; // (4): from slice array
    print("every 2nd element starting at pos 0:", v2);
 
    v2 = v1[v1 % 2 == 0]; // (6): from mask array
    print("values that are even:", v2);
 
    std::valarray<std::size_t> idx = {0, 1, 2, 4}; // index array
    v2.resize(4); // sizes must match when assigning from gen subscript
    v2 = v1[idx]; // (7): from indirect array
    print("values at positions 0, 1, 2, 4:", v2);
}

輸出

assigned from scalar:                -1 -1 -1
assigned from initializer_list:       1  2  3  4  5  6
every 2nd element starting at pos 0:  1  3  5
values that are even:                 2  4  6
values at positions 0, 1, 2, 4:       1  2  3  5

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 624	C++98	過載 (4-7) 的行為在以下情況下 如果 other 的長度不等於 size()，則不清楚	行為是 未定義的
LWG 630	C++98	複製賦值運算子的行為在以下情況下 如果 size() != other.size()，則未定義	調整 *this 的大小 在此情況下優先
LWG 2071	C++11	移動賦值運算子在以下情況下調整 *this 的大小，如果 size() != other.size()	不要求 在此情況下調整大小