# std::valarray<T>::apply

< cpp‎ | numeric‎ | valarray

valarray<T> apply( T func(T) ) const; |  |
valarray<T> apply( T func(const T&) ) const; |  |

返回同大小的新 valarray ，拥有通过应用 `func` 函数到元素先前值取得的值。

### 参数

func | - | 应用到值的函数

### 返回值

作为结果的 valarray ，拥有通过应用 `func` 取得的值

### 注意

函数能实现为拥有不同于 std::valarray 的返回类型。此情况下，替换类型拥有下列属性：

  - 提供 std::valarray 的所有 const 成员函数。
  - 能从替换类型构造 std::valarray 、 std::slice_array 、 std::gslice_array 、 std::mask_array 和 std::indirect_array 。
  - 所有接受一个 const std::valarray& 类型参数的函数，除了 `begin()` 和 `end()` (C++11 起)也应该接受替换类型。
  - 所有接受二个 const std::valarray& 类型参数的函数都应该接受 const std::valarray& 和替换类型的每种组合。
  - 返回类型添加不多于二层嵌套在最深层嵌套的参数类型上的模板。

### 示例

计算并打印前 10 个正整数的阶乘

    #include <iostream>
    #include <valarray>
    #include <cmath>

    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

### See also

for_each | 应用函数到范围中的元素 (函数模板)