std::valarray<T>::apply

 

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> apply( T func(T) ) const;
valarray<T> apply( T func(const T&) ) const;

返回一個新的相同大小的valarray，其值透過對元素的前一個值應用函式func獲得。

引數

func

-

要應用於值的函式

返回值

透過應用函式func獲得值的結果valarray。

注意

該函式可以使用與 std::valarray 不同的返回型別實現。在這種情況下，替換型別具有以下屬性：

• 提供 std::valarray 的所有 const 成員函式。
• std::valarray、std::slice_array、std::gslice_array、std::mask_array 和 std::indirect_array 可以從替換型別構造。
• 對於每個接受 const std::valarray<T>& 引數的函式 （除了 begin() 和 end()）(C++11 起)，應新增接受替換型別的相同函式；
• 對於每個接受兩個 const std::valarray<T>& 引數的函式，應新增接受 const std::valarray<T>& 和替換型別的各種組合的相同函式。
• 返回型別不會在最深層巢狀的引數型別之上增加超過兩個模板巢狀級別。

可能的實現

以下直接的實現可以被表示式模板替換以獲得更高的效率。

template<class T> valarray<T> valarray<T>::apply(T func(T)) const { valarray<T> other = *this; for (T& i : other) i = func(i); return other; }   template<class T> valarray<T> valarray<T>::apply(T func(const T&)) const { valarray<T> other = *this; for (T& i : other) i = func(i); return other; }

示例

計算並列印前 10 個階乘。

執行此程式碼

#include <cmath>
#include <iostream>
#include <valarray>
 
int main()
{
    std::valarray<int> v = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};
    v = v.apply([](int n) -> int
                {
                    return std::round(std::tgamma(n + 1));
                });
    for (auto n : v)
        std::cout << n << ' ';
    std::cout << '\n';
}

輸出

1 2 6 24 120 720 5040 40320 362880 3628800

參閱

for_each	對範圍中的元素應用一元函式物件 (函式模板)
ranges::for_each (C++20)	對範圍中的元素應用一元函式物件 (演算法函式物件)