std::pow(std::valarray)
提供: cppreference.com
ヘッダ <valarray> で定義 | ||
template<class T > std::valarray<T> pow(conststd::valarray<T>& base, conststd::valarray<T>& exp ); | (1) | |
template<class T > std::valarray<T> pow(conststd::valarray<T>& base, | (2) | |
template<class T > std::valarray<T> pow(consttypenamestd::valarray<T>::value_type& vbase, | (3) | |
値に指数を乗じます。
1) 数値配列
base
内のそれぞれの要素の値に数値配列 exp
内の対応する要素によって指定される指数を乗じた値を計算します。base.size()!= exp.size() の場合、動作は未定義です。
2) 数値配列
base
内のそれぞれの要素の値に vexp
を乗じた値を計算します。3)
vbase
の値に数値配列 exp
内の要素によって定義される指数を乗じた値を計算します。目次 |
[編集]引数
base | - | 底の値を格納する数値配列 |
exp | - | 指数の値を格納する数値配列 |
vbase | - | 底を定義する値 |
vexp | - | 指数を定義する値 |
[編集]戻り値
累乗の結果を格納する数値配列。
[編集]ノート
計算を行うために非修飾名の関数 (pow) が使用されます。 そのような関数が利用可能でない場合は、実引数依存の名前探索により std::pow が使用されます。
関数は std::valarray と異なる戻り値の型を使用して実装することができます。 この場合、その置換型は以下の性質を持ちます。
- std::valarray のすべての const メンバ関数が提供されます。
- 置換型から std::valarray、 std::slice_array、 std::gslice_array、 std::mask_array および std::indirect_array が構築できます。
- conststd::valarray& 型の引数を取るすべての関数 ( begin() と end() を除く)(C++11以上) は置換型も受理するべきです。
- conststd::valarray& 型の引数を2つ取るすべての関数は conststd::valarray& と置換型のすべての組み合わせを受理するべきです。
- 戻り値の型は最も深くネストした引数型より3段以上ネストしたテンプレートを追加しません。
[編集] 欠陥報告
以下の動作変更欠陥報告は以前に発行された C++ 標準に遡って適用されました。
DR | 適用先 | 発行時の動作 | 正しい動作 |
---|---|---|---|
LWG 3074 | C++98 | T is deduced from both the scalar and the valarray for (2-3), disallowing mixed-type calls | only deduce T from the valarray |
[編集]例
This section is incomplete Reason: no example |
[編集]関連項目
valarray の各要素に関数 std::sqrt を適用します (関数テンプレート) | |
(C++11)(C++11) | x の y 乗 (xy) を計算します (関数) |
片方または両方の引数が複素数かもしれない複素冪関数 (関数テンプレート) |