# operator+,-,*,/,%,&,|,^,<<,>>,&&,|| (std::valarray)

< cpp‎ | numeric‎ | valarray

定义于头文件 `<valarray>` |  |
template <class T> std::valarray<T> operator+ (const std::valarray<T>& lhs, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator- (const std::valarray<T>& lhs, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator* (const std::valarray<T>& lhs, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator/ (const std::valarray<T>& lhs, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator% (const std::valarray<T>& lhs, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator& (const std::valarray<T>& lhs, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator| (const std::valarray<T>& lhs, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator^ (const std::valarray<T>& lhs, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator<<(const std::valarray<T>& lhs, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator>>(const std::valarray<T>& lhs, const std::valarray<T>& rhs); template <class T> std::valarray<bool> operator&&(const std::valarray<T>& lhs, const std::valarray<T>& rhs); template <class T> std::valarray<bool> operator||(const std::valarray<T>& lhs, const std::valarray<T>& rhs); | (1) |
template <class T> std::valarray<T> operator+ (const typename std::valarray<T>::value_type & val, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator- (const typename std::valarray<T>::value_type & val, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator* (const typename std::valarray<T>::value_type & val, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator/ (const typename std::valarray<T>::value_type & val, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator% (const typename std::valarray<T>::value_type & val, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator& (const typename std::valarray<T>::value_type & val, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator| (const typename std::valarray<T>::value_type & val, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator^ (const typename std::valarray<T>::value_type & val, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator<<(const typename std::valarray<T>::value_type & val, const std::valarray<T>& rhs); template <class T> std::valarray<T> operator>>(const typename std::valarray<T>::value_type & val, const std::valarray<T>& rhs); template <class T> std::valarray<bool> operator&&(const typename std::valarray<T>::value_type & val, const std::valarray<T>& rhs); template <class T> std::valarray<bool> operator||(const typename std::valarray<T>::value_type & val, const std::valarray<T>& rhs); | (2) |
template <class T> std::valarray<T> operator+ (const std::valarray<T>& lhs, const typename std::valarray<T>::value_type & val); template <class T> std::valarray<T> operator- (const std::valarray<T>& lhs, const typename std::valarray<T>::value_type & val); template <class T> std::valarray<T> operator* (const std::valarray<T>& lhs, const typename std::valarray<T>::value_type & val); template <class T> std::valarray<T> operator/ (const std::valarray<T>& lhs, const typename std::valarray<T>::value_type & val); template <class T> std::valarray<T> operator% (const std::valarray<T>& lhs, const typename std::valarray<T>::value_type & val); template <class T> std::valarray<T> operator& (const std::valarray<T>& lhs, const typename std::valarray<T>::value_type & val); template <class T> std::valarray<T> operator| (const std::valarray<T>& lhs, const typename std::valarray<T>::value_type & val); template <class T> std::valarray<T> operator^ (const std::valarray<T>& lhs, const typename std::valarray<T>::value_type & val); template <class T> std::valarray<T> operator<<(const std::valarray<T>& lhs, const typename std::valarray<T>::value_type & val); template <class T> std::valarray<T> operator>>(const std::valarray<T>& lhs, const typename std::valarray<T>::value_type & val); template <class T> std::valarray<bool> operator&&(const std::valarray<T>& lhs, const typename std::valarray<T>::value_type & val); template <class T> std::valarray<bool> operator||(const std::valarray<T>& lhs, const typename std::valarray<T>::value_type & val); | (3) |

应用二元运算符到二个 valarray 的对应元素，或一个 valarray 和一个值。

1) 运算符作用于拥有同样大小的 valarray 并返回大小等于参数的 valarray ，将运算应用到二个参数的每个元素。
2,3) 在 valarray 的每个元素和标量间应用运算符。

### 参数

rhs | - | 数值数组
lhs | - | 数值数组
val | - | 类型 `T` 的值

### 返回值

大小等于参数的 valarray 。

### 注解

若二个参数是不同大小的 valarray 则行为未定义。

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

### 示例

寻找多个二次方程的实根。

    #include <cstddef>
    #include <valarray>
    #include <iostream>

    int main()
    {
        std::valarray<double> a(1, 8);
        std::valarray<double> b{1, 2, 3, 4, 5, 6, 7, 8};
        std::valarray<double> c = -b;
        // LWG3074 前字面量亦必须拥有 T 类型（此情况下为 double ）
        std::valarray<double> d = std::sqrt(b * b - 4.0 * a * c);
        std::valarray<double> x1 = (-b - d) / (2.0 * a);
        std::valarray<double> x2 = (-b + d) / (2.0 * a);
        std::cout << "quadratic equation    root 1,  root 2" << "\n";
        for (std::size_t i = 0; i < a.size(); ++i) {
            std::cout << a[i] << "x\u00B2 + " << b[i] << "x + " << c[i] << " = 0   ";
            std::cout << std::fixed << x1[i] << ", " << x2[i] << std::defaultfloat << "\n";
        }
    }

输出：

    quadratic equation    root 1,  root 2
    1x² + 1x + -1 = 0   -1.618034, 0.618034
    1x² + 2x + -2 = 0   -2.732051, 0.732051
    1x² + 3x + -3 = 0   -3.791288, 0.791288
    1x² + 4x + -4 = 0   -4.828427, 0.828427
    1x² + 5x + -5 = 0   -5.854102, 0.854102
    1x² + 6x + -6 = 0   -6.872983, 0.872983
    1x² + 7x + -7 = 0   -7.887482, 0.887482
    1x² + 8x + -8 = 0   -8.898979, 0.898979

### 缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

DR | 应用于 | 出版时的行为 | 正确行为
--- | --- | --- | ---
LWG 3074 | C++98 | (2-3) 从标量和 `valarray` 两者推导 `T` ，禁止混合类型的调用 | 仅从 `valarray` 推导 `T`