acos

Section: C Library Functions (3)
Updated: 2026-02-08
Index JM Home Page roff page
 

名前

acos, acosf, acosl - 逆余弦(arc cosine)関数  

ライブラリ

数学ライブラリ (libm,~-lm)  

書式

#include <math.h>

double acos(double x);
float acosf(float x);
long double acosl(long double x);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

acosf(), acosl():

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Since glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
 

説明

これらの関数は x の逆余弦(arc cosine) を計算する。 すなわち、その余弦 (cosine) が x となる値である。  

返り値

成功すると、これらの関数は x の逆余弦をラジアン単位で返す。 返り値は [0, pi] の範囲となる。

x が NaN の場合、NaN が返される。

x が +1 の場合、+0 が返される。

x が正の無限大か負の無限大の場合、 領域エラー (domain error) が発生し、NaN が返される。

x が [-1, 1] の範囲に入っていない場合、 領域エラー (domain error) が発生し、NaN が返される。  

エラー

これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は math_error(7) を参照のこと。

以下のエラーが発生する可能性がある。

Domain error: x is outside the range [-1, 1]
errno に EDOM が設定される。 不正 (invalid) 浮動小数点例外 (FE_INVALID) が上がる。
 

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース属性値
acos(), acosf(), acosl() Thread safetyMT-Safe
 

標準規格

C11, POSIX.1-2008.  

歴史

C99, POSIX.1-2001.

The variant returning double also conforms to C89, SVr4, 4.3BSD.  

関連項目

asin(3), atan(3), atan2(3), cacos(3), cos(3), sin(3), tan(3)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
属性
標準規格
歴史
関連項目

This document was created by man2html, using the manual pages.