std::atan2(std::valarray)
ja.cppreference.net より
| ヘッダ <valarray>
|
||
template< class T >
std::valarray<T> atan2( const std::valarray<T>& y, const std::valarray<T>& x );
|
(1) | |
template< class T >
std::valarray<T> atan2( const std::valarray<T>& y,
const typename std::valarray<T>::value_type& vx );
|
(2) | |
template< class T >
std::valarray<T> atan2( const typename std::valarray<T>::value_type& vy,
const std::valarray<T>& x );
|
(3) | |
引数の符号を使用して象限を正しく判断し、y / x の逆正接を計算します。
1)対応する値のペアごとに、
y と x から逆正接を計算します。動作は、x.size() != y.size() の場合、未定義です。
2)
vx と数値配列 y の各値の逆正接を計算します。3)数値配列
vy の各値と x の逆正接を計算します。パラメータ
| x, y | - | 逆正接を計算する数値配列 |
| vy, vx | - | 逆正接を計算する値 |
戻り値
逆正接の計算結果を含む数値配列。
注記
未修飾関数（atan2）が計算を実行するために使用されます。そのような関数が利用できない場合、std::atan2が使用されます（引数依存の名前検索）。
関数は戻り値の型がstd::valarrayと異なる場合に実装されても構いません。その場合、置換型には以下のプロパティがあります:
- すべての
constメンバ関数のstd::valarrayが提供されています。 - std::valarray、std::slice_array、std::gslice_array、std::mask_array、およびstd::indirect_arrayは置換型から構築できます。
- 次の関数を取るすべての関数について、
const std::valarray<T>&ただし、begin()、およびend()(C++11以降)、置換型を取る同じ関数が追加されるものとします; - 次の2つの引数を取るすべての関数について、
const std::valarray<T>&引数について、次のすべての組み合わせを取る同じ関数がconst std::valarray<T>&と置換型の組み合わせが追加されるものとします。 - 戻り値の型は、最も深くネストされた引数型に対してテンプレートのネストを2レベル以上追加しません。
例
このコードを実行
#include <algorithm> #include <cmath> #include <iomanip> #include <iostream> #include <valarray> void show(char const* title, const std::valarray<double>& va) { std::cout << title << ' '; std::for_each(std::begin(va), std::end(va), [](const double x) { std::cout << ' ' << std::right << std::setw(4) << x << "°"; }); std::cout << '\n'; } const double pi = std::acos(-1.0); // C++20: std::numbers::pi int main() { auto degrees_to_radians = [](double const& x) { return (pi * x / 180); }; auto radians_to_degrees = [](double const& x) { return (180 * x / pi); }; const std::valarray<double> degrees{-90, -60, -45, -30, 0, 30, 45, 60, 90}; const std::valarray<double> radians = degrees.apply(degrees_to_radians); const auto sin = std::sin(radians); const auto cos = std::cos(radians); show("(1)", std::atan2(sin, cos).apply(radians_to_degrees)); show("(2)", std::atan2(sin/cos, 1.0).apply(radians_to_degrees)); show("(3)", std::atan2(1.0, cos/sin).apply(radians_to_degrees)); }
出力:
(1) -90° -60° -45° -30° 0° 30° 45° 60° 90° (2) -90° -60° -45° -30° 0° 30° 45° 60° 90° (3) 90° 120° 135° 150° 0° 30° 45° 60° 90°
不具合報告
以下の動作変更欠陥報告書は、以前に公開されたC++標準に対して遡及的に適用されました。
| DR | 適用対象 | 公開時の動作 | 正しい動作 |
|---|---|---|---|
| LWG 3074 | C++98 |
T
がスカラーと
valarray
の両方から推論され、
(2,3)
で異なる型の呼び出しが許可されない
|
T
は
valarray
からのみ推論
|
関連項目
|
valarrayの各要素に関数
std::asin
を適用する
(関数テンプレート) |
|
|
valarrayの各要素に関数
std::acos
を適用する
(関数テンプレート) |
|
|
valarrayの各要素に関数
std::atan
を適用する
(関数テンプレート) |
|
|
(C++11)
(C++11)
|
符号を使用して象限を決定する逆正接
(関数) |
|
位相角を返す
(関数テンプレート) |