std::atan2(std::valarray)

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

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

正規表現ライブラリ(C++11)

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

数値演算ライブラリ

一般的な数学関数

数学の特殊関数(C++17)

数学定数(C++20)

浮動小数点環境(C++11)

複素数

数値配列

擬似乱数生成

コンパイル時有理数算術(C++11)

数値演算アルゴリズム

gcd (C++17)

lcm (C++17)

補間

midpoint (C++20)

lerp (C++20)

汎用の数値演算

iota (C++11)

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)

ビット操作

bit_cast (C++20)

has_single_bit (C++20)

bit_ceil (C++20)

bit_floor (C++20)

bit_width (C++20)

rotl (C++20)

rotr (C++20)

countl_zero (C++20)

countl_one (C++20)

countr_zero (C++20)

countr_one (C++20)

popcount (C++20)

endian (C++20)

 

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 (C++11) begin (C++11) end (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(conststd::valarray<T>& y, conststd::valarray<T>& x );	(1)
template<class T > std::valarray<T> atan2(conststd::valarray<T>& y,                         consttypenamestd::valarray<T>::value_type& vx );	(2)
template<class T > std::valarray<T> atan2(consttypenamestd::valarray<T>::value_type& vy,                         conststd::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 が構築できます。
• 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

関連項目

asin(std::valarray)	valarray の各要素に関数 std::asin を適用します (関数テンプレート)
acos(std::valarray)	valarray の各要素に関数 std::acos を適用します (関数テンプレート)
atan(std::valarray)	valarray の各要素に関数 std::atan を適用します (関数テンプレート)
atan2atan2fatan2l (C++11)(C++11)	象限を判断するために符号を使用して逆正接を計算します (関数)
arg	複素数の偏角を返します (関数テンプレート)