Namespaces
Variants

acos, acosf, acosl

From cppreference.net
< c ‎ | numeric ‎ | math
C
Numerics
Common mathematical functions
Functions
Basic operations
(C99)
(C99)
(C99)
(C99)
(C99) (C99) (C99) (C23)
Maximum/minimum operations
Exponential functions
Power functions
Trigonometric and hyperbolic functions
Nearest integer floating-point
(C99)
(C99) (C99) (C99)
(C23) (C23) (C23) (C23)
Floating-point manipulation
Narrowing operations
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
Quantum and quantum exponent
Decimal re-encoding functions
Total order and payload functions
Classification
Error and gamma functions
(C99)
(C99)
(C99)
(C99)
Types
Macro constants
Special floating-point values
Arguments and return values
Error handling
Fast operation indicators
ヘッダー <math.h> で定義
float acosf ( float arg ) ;
(1) (C99以降)
double acos ( double arg ) ;
(2)
long double acosl ( long double arg ) ;
(3) (C99以降)
_Decimal32  acosd32 ( _Decimal32 arg ) ;
(4) (C23以降)
_Decimal64  acosd64 ( _Decimal64 arg ) ;
(5) (C23以降)
_Decimal128 acosd128 ( _Decimal128 arg ) ;
(6) (C23以降)
ヘッダー <tgmath.h> で定義
#define acos( arg )
(7) (C99以降)
1-6) arg の逆余弦の主値を計算します。
7) 型総称マクロ: 引数の型が long double の場合、 (3) ( acosl )が呼び出される。それ以外の場合、引数が整数型または double 型を持つ場合、 (2) ( acos )が呼び出される。それ以外の場合、 (1) ( acosf )が呼び出される。引数が複素数の場合、マクロは対応する複素数関数( cacosf 、 cacos 、 cacosl )を呼び出す。

関数 (4-6) は、実装が __STDC_IEC_60559_DFP__ を事前定義する場合にのみ宣言される（すなわち、実装が十進浮動小数点数をサポートする場合）。

(C23以降)

目次

パラメータ

arg - 浮動小数点値

戻り値

エラーが発生しない場合、 arg の逆余弦値（ arccos(arg) ）が範囲 [0 ; π] 内で返されます。

定義域エラーが発生した場合、実装定義の値が返されます（NaNがサポートされている場合はNaN）。

アンダーフローによる範囲エラーが発生した場合、正しい結果（丸め後）が返されます。

エラー処理

エラーは math_errhandling で指定された通りに報告されます。

ドメインエラーは、 arg が範囲 [-1.0; 1.0] の外側にある場合に発生します。

IEEE浮動小数点演算（IEC 60559）がサポートされている場合：

  • 引数が +1 の場合、値 +0 が返される;
  • |arg| > 1 の場合、定義域エラーが発生しNaNが返される;
  • 引数がNaNの場合、NaNが返される。

例

このコードを実行 
#include <errno.h>
#include <fenv.h>
#include <math.h>
#include <stdio.h>
#include <string.h>
#ifndef __GNUC__
#pragma STDC FENV_ACCESS ON
#endif
int main(void)
{
    printf("acos(-1) = %f\n", acos(-1));
    printf("acos(0.0) = %f 2*acos(0.0) = %f\n", acos(0), 2 * acos(0));
    printf("acos(0.5) = %f 3*acos(0.5) = %f\n", acos(0.5), 3 * acos(0.5));
    printf("acos(1) = %f\n", acos(1));
    // エラーハンドリング
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("acos(1.1) = %f\n", acos(1.1));
    if (errno == EDOM)
        perror("    errno == EDOM");
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID raised");
}

出力例: 

acos(-1) = 3.141593
acos(0.0) = 1.570796 2*acos(0.0) = 3.141593
acos(0.5) = 1.047198 3*acos(0.5) = 3.141593
acos(1) = 0.000000
acos(1.1) = nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised

参考文献

  • C23規格 (ISO/IEC 9899:2024):
  • 7.12.4.1 acos関数群 (p: TBD)
  • 7.25 総称数学 <tgmath.h> (p: TBD)
  • F.10.1.1 acos関数群 (p: TBD)
  • C17規格 (ISO/IEC 9899:2018):
  • 7.12.4.1 acos関数群 (p: 173)
  • 7.25 総称数学 <tgmath.h> (p: 272-273)
  • F.10.1.1 acos関数群 (p: 378)
  • C11規格 (ISO/IEC 9899:2011):
  • 7.12.4.1 acos関数群 (p: 238)
  • 7.25 総称数学 <tgmath.h> (p: 373-375)
  • F.10.1.1 acos関数群 (p: 518)
  • C99規格 (ISO/IEC 9899:1999):
  • 7.12.4.1 acos関数群 (p: 218)
  • 7.22 総称数学 <tgmath.h> (p: 335-337)
  • F.9.1.1 acos関数群 (p: 455)
  • C89/C90標準 (ISO/IEC 9899:1990):
  • 4.5.2.1 acos関数

関連項目

(C99) (C99)
アークサインを計算する ( arcsin(x) )
(関数)
(C99) (C99)
アークタンジェントを計算する ( arctan(x) )
(関数)
(C99) (C99)
符号を使用して象限を決定するアークタンジェントを計算する
(関数)
(C99) (C99)
コサインを計算する ( cos(x) )
(関数)
(C99) (C99) (C99)
複素数のアークコサインを計算する
(関数)
C++ documentation for acos