std::asin, std::asinf, std::asinl

ヘッダー `<cmath>` で定義
	(1)
float asin ( float num ); double asin ( double num ); long double asin ( long double num );			(C++23まで)
/浮動小数点数型/ asin ( /浮動小数点型/ num );			(C++23から) (C++26 以降 constexpr)
float asinf( float num );		(2)	(C++11以降) (C++26 以降 constexpr)
long double asinl( long double num );		(3)	(C++11以降) (C++26 以降 constexpr)
SIMDオーバーロード (C++26以降)
ヘッダー `<simd>` で定義
template< /math-floating-point/ V > constexpr /deduced-simd-t/<V> asin ( const V& v_num );		(S)	(C++26以降)
追加のオーバーロード (C++11以降)
ヘッダー `<cmath>` で定義
template< class Integer > double asin ( Integer num );		(A)	(C++26 以降 constexpr)

1-3)

num

の逆正弦 (arc sine) の主値を計算します。ライブラリは、パラメータの型としてすべての cv-unqualified な浮動小数点型に対する std::asin のオーバーロードを提供します。(C++23 以降)

S) SIMD オーバーロードは、v_num に対して要素ごとの std::asin を実行します。

(定義については、math-floating-point および deduced-simd-t を参照してください。)

(C++26以降)

A) すべての整数型に対する追加のオーバーロードが提供されます。これらは double として扱われます。

(C++11以降)

追加のオーバーロードは、(A) とまったく同じように提供される必要はありません。整数型の引数 num に対して、std::asin(num) が std::asin(static_cast<double>(num)) と同じ効果を持つことを保証するのに十分なものであればよいのです。

[編集] Example

このコードを実行

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
 
// #pragma STDC FENV_ACCESS ON
 
int main()
{
    std::cout << "asin(1.0) = " << asin(1) << '\n'
              << "2*asin(1.0) = " << 2 * asin(1) << '\n'
              << "asin(-0.5) = " << asin(-0.5) << '\n'
              << "6*asin(-0.5) =" << 6 * asin(-0.5) << '\n';
 
    // special values
    std::cout << "asin(0.0) = " << asin(0) << " asin(-0.0)=" << asin(-0.0) << '\n';
 
    // error handling
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "asin(1.1) = " << asin(1.1) << '\n';
 
    if (errno == EDOM)
        std::cout << "    errno == EDOM: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID raised" << '\n';
}

実行結果の例

asin(1.0) = 1.5708
2*asin(1.0) = 3.14159
asin(-0.5) = -0.523599
6*asin(-0.5) = -3.14159
asin(0.0) = 0 asin(-0.0)=-0
asin(1.1) = nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised

[編集] See also

acosacosfacosl (C++11)(C++11)	逆余弦を計算する (${\small\arccos{x}}$ $arccos(x)$ ) (関数) [編集]
atanatanfatanl (C++11)(C++11)	逆正接を計算する (${\small\arctan{x}}$ $arctan(x)$ ) (関数) [編集]
atan2atan2fatan2l (C++11)(C++11)	符号を用いて象限を決定する逆正接 (関数) [編集]
sinsinfsinl (C++11)(C++11)	正弦を計算する (${\small\sin{x}}$ $sin(x)$ ) (関数) [編集]
asin(std::complex) (C++11)	複素数の逆正弦 (アークサイン) を計算する (${\small\arcsin{z}}$ $arcsin(z)$ ) (関数テンプレート) [編集]
asin(std::valarray)	valarray の各要素に std::asin 関数を適用します (function template) [編集]
asin の C ドキュメント

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

cppreference.com

名前空間

変種

表示

操作

std::asin, std::asinf, std::asinl

目次

[編集] Parameters

[編集] Return value

[編集] Error handling

[編集] Notes

[編集] Example

[編集] See also

ナビゲーション

ツールボックス

acosacosfacosl (C++11)(C++11)	逆余弦を計算する (\({\small\arccos{x}}\) $arccos(x)$ ) (関数) [編集]
atanatanfatanl (C++11)(C++11)	逆正接を計算する (\({\small\arctan{x}}\) $arctan(x)$ ) (関数) [編集]
atan2atan2fatan2l (C++11)(C++11)	符号を用いて象限を決定する逆正接 (関数) [編集]
sinsinfsinl (C++11)(C++11)	正弦を計算する (\({\small\sin{x}}\) $sin(x)$ ) (関数) [編集]
asin(std::complex) (C++11)	複素数の逆正弦 (アークサイン) を計算する (\({\small\arcsin{z}}\) $arcsin(z)$ ) (関数テンプレート) [編集]
asin(std::valarray)	valarray の各要素に std::asin 関数を適用します (function template) [編集]
asin の C ドキュメント