# std::cosh(std::valarray)

< cpp‎ | numeric‎ | valarray

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

对 `va` 中每个元素计算元素值的双曲余弦。

### 参数

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

### 返回值

含有 `va` 中值的双曲余弦的值数组。

### 注解

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

函数能实现为拥有不同于 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> cosh(const valarray<T>& va)
    {
        valarray<T> other = va;
        for (T &i : other) {
            i = cosh(i);
        }
        return other;
    }

### 示例

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

    void show(const char* title, const std::valarray<float>& data)
    {
        const int w { 9 };
        std::cout << std::setw(w) << title << " | ";
        for (float x : data)
            std::cout << std::setw(w) << x << " | ";
        std::cout << '\n';
    }

    int main()
    {
        const std::valarray<float> x { .1, .2, .3, .4 };
        const auto sinh = std::sinh(x);
        const auto cosh = std::cosh(x);
        const auto z = (cosh * cosh) - (sinh * sinh);

        show("x"      , x   );
        show("sinh(x)", sinh);
        show("cosh(x)", cosh);
        show("z"      , z   );
    }

输出：

            x |       0.1 |       0.2 |       0.3 |       0.4 |
      sinh(x) |  0.100167 |  0.201336 |   0.30452 |  0.410752 |
      cosh(x) |     1.005 |   1.02007 |   1.04534 |   1.08107 |
            z |         1 |         1 |         1 |         1 |

### 参阅

sinh(std::valarray) | 在 valarray 的每个元素上调用 std::sinh 函数 (函数模板)
tanh(std::valarray) | 在 valarray 的每个元素上调用 std::tanh 函数 (函数模板)
cosh coshf coshl (C++11)(C++11) | 计算双曲余弦（ \({\small\cosh{x} }\)cosh(x) ） (函数)
cosh(std::complex) | 计算复数的双曲余弦（ \({\small\cosh{z} }\)cosh(z) ） (函数模板)