# std::sin(std::valarray)

< cpp‎ | numeric‎ | valarray

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

对于每个 `va` 中的元素，计算元素的正弦值。

### 参数

va | - | 要应用运算的值数组

### 返回值

包含 `va` 中的值的正弦的值数组。

### 注意

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

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

### 示例

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

    const double pi = std::acos(-1);
    int main()
    {
        std::valarray<double> v1 = {0, 0.25, 0.5, 0.75, 1};
        std::valarray<double> v2 = std::sin(v1 * pi);

        for(double n : v2)
            std::cout << std::fixed << n << ' ';
        std::cout << '\n';
    }

输出：

    0.000000 0.707107 1.000000 0.707107 0.000000

### 参阅

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