最終更新日時(UTC): 2026年03月21日 14時12分53秒
Raclamusi が更新

履歴 編集

function template
<valarray>

# std::pow

    namespace std {
      template <class T>
      ValOrProxy<T> pow(const ValOrProxy<T>& xs,
                        const ValOrProxy<T>& ys);                     // (1)

      template <class T>
      ValOrProxy<T> pow(const ValOrProxy<T>& xs,
                        const T& y);                                  // (2) C++17 まで
      template <class T>
      ValOrProxy<T> pow(const ValOrProxy<T>& xs,
                        const typename valarray<T>::value_type& y);   // (2) C++20 から

      template <class T>
      ValOrProxy<T> pow(const T& x,
                        const ValOrProxy<T>& ys);                     // (3) C++17 まで
      template <class T>
      ValOrProxy<T> pow(const typename valarray<T>::value_type& x,
                        const ValOrProxy<T>& ys);                     // (3) C++20 から
    }

## 概要

累乗を得る。pow は power（累乗、指数）の略。

## 戻り値

- (1) : 以下のコードと等価のことを行う：

    std::valarray<T> result(xs.size());
    for (std::size_t i = 0; i < result.size(); ++i) {
      result[i] = std::pow(xs[i], ys[i]);
    }
    return result;

- (2) : 以下のコードと等価のことを行う：

    std::valarray<T> result(xs.size());
    for (std::size_t i = 0; i < result.size(); ++i) {
      result[i] = std::pow(xs[i], y);
    }
    return result;

- (3) : 以下のコードと等価のことを行う：

    std::valarray<T> result(ys.size());
    for (std::size_t i = 0; i < result.size(); ++i) {
      result[i] = std::pow(x, ys[i]);
    }
    return result;

## 備考

- 引数、および、戻り値の型 `ValOrProxy` は、`valarray`、あるいは、その代理となる型である。
  `<valarray>` の概要も参照のこと。
- (1) : `xs` と `ys` の要素数が異なる場合、未定義動作を引き起こす。
- C++20における(2)と(3)に対する変更は、`std::valarray<double>{} * 2` のような式が型推論に失敗しないようにするためである。
  なお、この変更は規格の誤り修正とみなされているため、処理系によっては C++17 以前でも使用可能となる。

## 例

    #include <iostream>
    #include <valarray>

    template <class T>
    void print(const char* name, const std::valarray<T>& va)
    {
      std::cout << name << " : {";
      bool first = true;

      for (const T& x : va) {
        if (first) {
          first = false;
        }
        else {
          std::cout << ',';
        }
        std::cout << x;
      }
      std::cout << "}" << std::endl;
    }

    int main()
    {
      const std::valarray<float> xs = {2.0f, 3.0f, 4.0f};
      const std::valarray<float> ys = {3.0f, 4.0f, 5.0f};

      std::valarray<float> result1 = std::pow(xs, ys);
      ::print("valarray-valarray", result1);

      std::valarray<float> result2 = std::pow(xs, 3.0f);
      ::print("valarray-float", result2);

      std::valarray<float> result3 = std::pow(3.0f, ys);
      ::print("float-valarray", result3);
    }

### 出力

    valarray-valarray : {8,81,1024}
    valarray-float : {8,27,64}
    float-valarray : {27,81,243}

## 参照

- LWG Issue 3074. Non-member functions for `valarray` should only deduce from the `valarray`