std::atan2(std::valarray)

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

数値ライブラリ

共通の数学関数
数学特殊関数 (C++17)
数学定数 (C++20)
基本的な線形代数アルゴリズム (C++26)
データ並列型 (SIMD) (C++26)
浮動小数点環境 (C++11)
複素数
数値配列 (valarray)
擬似乱数生成
ビット操作 (C++20)
因数操作
gcd (C++17)	lcm (C++17)
補間
midpoint (C++20)	lerp (C++20)
飽和演算
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
汎用数値演算
iota (C++11) ranges::iota (C++23) accumulate inner_product adjacent_difference    partial_sum	reduce (C++17) transform_reduce (C++17) inclusive_scan (C++17) exclusive_scan (C++17) transform_inclusive_scan (C++17) transform_exclusive_scan (C++17)

 

std::valarray

メンバ関数
valarray::valarray valarray::~valarray valarray::operator= valarray::operator[] valarray::swap valarray::size valarray::resize valarray::sum valarray::min valarray::max valarray::shift valarray::cshift valarray::apply	valarray::operator+valarray::operator-valarray::operator~valarray::operator! valarray::operator+=valarray::operator-=valarray::operator*=valarray::operator/=valarray::operator%=valarray::operator&=valarray::operator|=valarray::operator^=valarray::operator<<=valarray::operator>>=
非メンバ関数
swap(std::valarray) (C++11) begin(std::valarray) (C++11)   end(std::valarray) (C++11) abs exp log log10 pow sqrt sin cos tan asin acos atan atan2 sinh cosh tanh	operator*operator/operator%operator+operator-operator^operator&operator|operator<<operator>>operator&&operator|| operator==operator!=operator<operator>operator<=operator>=
ヘルパークラス
slice_array gslice_array indirect_array	slice gslice mask_array
推論補助 (C++17)

 

ヘッダ <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 とは異なる戻り値型で実装される場合があります。その場合、代替型は以下のプロパティを持ちます。

• std::valarray のすべての const メンバ関数が提供されます。
• std::valarray、std::slice_array、std::gslice_array、std::mask_array、および std::indirect_array は、代替型から構築できます。
• 2つの const std::valarray<T>& 引数を受け取るすべての関数について、代替型を受け取る同一の関数が追加されます（begin() および end() を除く）。
• 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	（2,3）では、スカラーとvalarrayの両方からTが推論されるため、混合型呼び出しは許可されません。	valarrayからのみTを推論します。

関連項目

asin(std::valarray)	valarrayの各要素に関数std::asinを適用する (function template)
acos(std::valarray)	valarrayの各要素に関数std::acosを適用する (function template)
atan(std::valarray)	valarrayの各要素に関数std::atanを適用する (function template)
atan2atan2fatan2l (C++11)(C++11)	符号を用いて象限を決定する逆正接 (関数)
arg	偏角を返す (関数テンプレート)