# std::exp(std::valarray)

< cpp‎ | numeric‎ | valarray

定义于头文件 `<valarray>` |  |
template< class T > valarray<T> exp( const valarray<T>& va ); |  |

对 `va` 中每个元素，计算 e 的元素值次幂。

### 参数

va | - | 要应用操作到的值数组

### 返回值

含有 e 的 `va` 中值次幂的值数组。

### 注解

用无限定函数 (exp) 进行计算。若该函数不可用，则因参数依赖查找使用 std::exp 。

函数能实现为拥有不同于 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& 和替换类型的每种组合。
  - 返回类型添加不多于二层嵌套在最深层嵌套的参数类型上的模板。

### 可能的实现

    template< class T >
    valarray<T> exp( const valarray<T>& va )
    {
        valarray<T> other = va;
        for (T &i : other) {
            i = exp(i);
        }
        return other; // 亦可返回代理对象
    }

### 示例

此示例演示欧拉恒等式 eiπ
= -1 和相关的指数。

    #include <iostream>
    #include <complex>
    #include <valarray>

    int main()
    {
        const double pi = std::acos(-1);
        std::valarray<std::complex<double>> v = {
            {0, 0}, {0, pi/2}, {0, pi}, {0, 3*pi/2}, {0, 2*pi}
        };
        std::valarray<std::complex<double>> v2 = std::exp(v);
        for(auto n : v2) {
            std::cout << std::showpos << std::fixed << n << '\n';
        }
    }

输出：

    (+1.000000,+0.000000)
    (+0.000000,+1.000000)
    (-1.000000,+0.000000)
    (-0.000000,-1.000000)
    (+1.000000,-0.000000)

### 参阅

log(std::valarray) | 应用函数 std::log 到 valarray 的每个元素 (函数模板)
exp expf expl (C++11)(C++11) | 返回 e 的给定次幂（ \({\small e^x}\)ex ） (函数)
exp(std::complex) | 以 e 为底复数的指数 (函数模板)