asinのヘルプ・マニュアル
日本語 英語
asin --help
man asin
ASIN(3) Linux Programmer’s Manual ASIN(3)
名前
asin, asinf, asinl - 逆正弦(arc sine)関数
書式
#include
double asin(double x);
float asinf(float x);
long double asinl(long double x);
-lm でリンクする。
glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):
asinf(), asinl(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600
|| _ISOC99_SOURCE; or cc -std=c99
説明
asin() 関数は x の逆正弦(arc sine) の主値を計算する。すなわち、その 正
弦(sine)が x となるような値である。
返り値
成功すると、これらの関数は x の逆正弦の主値をラジアン単位で返す。返り値
は [-pi/2, pi/2] の範囲となる。
x が NaN の場合、NaN が返される。
x が +0 (-0) の場合、+0 (-0) が返される。
x が [-1, 1] の範囲に入っていない場合、領域エラー (domain error) が発生
し、NaN が返される。
エラー
こ れらの関数を呼び出した際にエラーが発生したかの判定方法についての情報
は math_error(7) を参照のこと。
以下のエラーが発生する可能性がある。
領域エラー (domain error): x が [-1, 1] の範囲に入っていない
errno に EDOM が設定される。無効 (invalid) 浮 動 小 数 点 例 外
(FE_INVALID) が上がる。
準拠
C99, POSIX.1-2001. double 版の関数は SVr4, 4.3BSD, C89 にも準拠してい
る。
関連項目
acos(3), atan(3), atan2(3), casin(3), cos(3), sin(3), tan(3)
2008-08-05 ASIN(3)
ASIN(3) Linux Programmer’s Manual ASIN(3)
NAME
asin, asinf, asinl - arc sine function
SYNOPSIS
#include
double asin(double x);
float asinf(float x);
long double asinl(long double x);
Link with -lm.
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
asinf(), asinl(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600
|| _ISOC99_SOURCE; or cc -std=c99
DESCRIPTION
The asin() function calculates the principal value of the arc sine of
x; that is the value whose sine is x.
RETURN VALUE
On success, these functions return the principal value of the arc sine
of x in radians; the return value is in the range [-pi/2, pi/2].
If x is a NaN, a NaN is returned.
If x is +0 (-0), +0 (-0) is returned.
If x is outside the range [-1, 1], a domain error occurs, and a NaN is
returned.
ERRORS
See math_error(7) for information on how to determine whether an error
has occurred when calling these functions.
The following errors can occur:
Domain error: x is outside the range [-1, 1]
errno is set to EDOM. An invalid floating-point exception
(FE_INVALID) is raised.
CONFORMING TO
C99, POSIX.1-2001. The variant returning double also conforms to SVr4,
4.3BSD, C89.
SEE ALSO
acos(3), atan(3), atan2(3), casin(3), cos(3), sin(3), tan(3)
COLOPHON
This page is part of release 3.22 of the Linux man-pages project. A
description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
2008-08-05 ASIN(3)