math_acos
math_acos (아크 코사인)
std::acos는 num의 아크 코사인(역코사인)의 주값을 라디안으로 계산하는 함수예요. 결과 범위는 [0, π]예요.
출처: cppreference
본문
<cmath> 헤더에 정의되어 있고, 시그니처는 다음과 같아요.
float acos ( float num );
double acos ( double num );
long double acos ( long double num );
(1) (until C++23)
/*floating-point-type*/
acos ( /*floating-point-type*/ num );
(since C++23) (constexpr since C++26)
float acosf( float num );
(2) (since C++11) (constexpr since C++26)
long double acosl( long double num );
(3) (since C++11) (constexpr since C++26)
SIMD 오버로드 (since C++26): <simd> 헤더에 정의돼요.
template< /*math-floating-point*/ V >
constexpr /*deduced-simd-t*/<V>
acos ( const V& v_num );
(S) (since C++26)
추가 오버로드 (since C++11): <cmath> 헤더에 정의돼요.
template< class Integer >
double acos ( Integer num );
(A) (constexpr since C++26)
- 1-3) num의 아크 코사인의 주값을 계산해요. 라이브러리는 매개변수의 타입으로 모든 cv 한정되지 않은 부동소수점 타입에 대한
std::acos오버로드를 제공해요. (C++23부터) - S) SIMD 오버로드는 v_num에 요소별
std::acos를 수행해요. (math-floating-point와 deduced-simd-t의 정의 참고) - A) 모든 정수 타입에 대해 추가 오버로드가 제공되는데, double로 취급돼요.
(C++11부터)
매개변수 (Parameters)
- num — 부동소수점 또는 정수 값
반환값 (Return value)
오류가 없다면 범위 [0, π]의 num의 아크 코사인(arccos(num))을 반환해요.
도메인 오류가 발생하면 구현 정의 값을 반환해요 (NaN 지원 시 NaN).
언더플로로 인한 범위 오류가 발생하면 (반올림 후의) 올바른 결과를 반환해요.
오류 처리 (Error handling)
오류는 math_errhandling에 지정된 대로 보고돼요.
num이 범위 [-1.0, 1.0] 밖이면 도메인 오류가 발생해요.
구현이 IEEE 부동소수점 연산(IEC 60559)을 지원한다면:
- 인자가 +1이면 값 +0을 반환해요.
- |num| > 1이면 도메인 오류가 발생하고 NaN을 반환해요.
- 인자가 NaN이면 NaN을 반환해요.
참고 (Notes)
추가 오버로드는 정확히 (A) 형태로 제공될 필요는 없어요. 정수 타입의 인자 num에 대해 std::acos(num)이 std::acos(static_cast<double>(num))과 같은 효과만 있으면 충분해요.
예제 (Example)
이 코드를 실행해 봐요.
#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
#pragma STDC FENV_ACCESS ON
int main()
{
std::cout << std::showpos
<< "acos(1.0) = " << std::acos(1.0) << '\n'
<< "2*acos(0) = " << 2 * std::acos(0) << '\n'
<< "acos(0.5) = " << std::acos(0.5) << '\n'
<< "acos(-0.5) = " << std::acos(-0.5) << '\n'
<< "acos(-1) = " << std::acos(-1) << '\n';
// errno 및 FE_INVALID 검사
std::feclearexcept(FE_ALL_EXCEPT);
errno = 0;
std::cout << "acos(1.1) = " << std::acos(1.1) << '\n';
if (errno == EDOM)
std::cout << " errno == EDOM\n";
if (std::fetestexcept(FE_INVALID))
std::cout << " FE_INVALID raised\n";
}