# std::cos(std::valarray)

< cpp‎ | numeric‎ | valarray

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

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

### 参数

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

### 返回值

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

### 注解

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

函数能实现为拥有不同于 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> cos(const valarray<T>& va)
    {
        valarray<T> other = va;
        for (T &i : other) {
            i = cos(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 sin = std::sin(x);
        const auto cos = std::cos(x);
        const auto z = (sin * sin) + (cos * cos);

        show("x"     , x  );
        show("sin(x)", sin);
        show("cos(x)", cos);
        show("z"     , z  );
    }

输出：

            x |       0.1 |       0.2 |       0.3 |       0.4 |
       sin(x) | 0.0998334 |  0.198669 |   0.29552 |  0.389418 |
       cos(x) |  0.995004 |  0.980067 |  0.955337 |  0.921061 |
            z |         1 |         1 |         1 |         1 |

### 参阅

sin(std::valarray) | 对 valarray 的每个元素应用std::sin函数 (函数模板)
tan(std::valarray) | 应用函数 std::tan 到 valarray 的每个元素 (函数模板)
acos(std::valarray) | 应用函数 std::acos 到 valarray 的每个元素 (函数模板)
cos cosf cosl (C++11)(C++11) | 计算余弦（ \({\small\cos{x} }\)cos(x) ） (函数)
cos(std::complex) | 计算复数的余弦（ \({\small\cos{z} }\)cos(z) ） (函数模板)