std:: cos, std:: cosf, std:: cosl
|
헤더 파일에 정의됨
<cmath>
|
||
| (1) | ||
|
float
cos
(
float
num
)
;
double
cos
(
double
num
)
;
|
(C++23 이전) | |
|
/*floating-point-type*/
cos ( /*floating-point-type*/ num ) ; |
(C++23 이후)
(C++26부터 constexpr) |
|
|
float
cosf
(
float
num
)
;
|
(2) |
(C++11 이후)
(C++26부터 constexpr) |
|
long
double
cosl
(
long
double
num
)
;
|
(3) |
(C++11 이후)
(C++26부터 constexpr) |
|
SIMD 오버로드
(C++26 이후)
|
||
|
헤더 파일에 정의됨
<simd>
|
||
|
template
<
/*math-floating-point*/
V
>
constexpr
/*deduced-simd-t*/
<
V
>
|
(S) | (C++26 이후) |
|
추가 오버로드
(C++11 이후)
|
||
|
헤더 파일에 정의됨
<cmath>
|
||
|
template
<
class
Integer
>
double cos ( Integer num ) ; |
(A) | (C++26부터 constexpr) |
std::cos
오버로드를 제공합니다.
(C++23 이후)
|
S)
SIMD 오버로드는
v_num
에 대해 요소별(element-wise)
std::cos
연산을 수행합니다.
|
(C++26부터) |
|
A)
모든 정수 타입에 대해 추가 오버로드가 제공되며, 이들은
double
로 처리됩니다.
|
(since C++11) |
목차 |
매개변수
| num | - | 라디안 단위의 각도를 나타내는 부동 소수점 또는 정수 값 |
반환값
오류가 발생하지 않으면,
num
의 코사인(
cos(num)
) 값이
[
-
1.0
,
+
1.0
]
범위 내에서 반환됩니다.
|
num 의 크기가 큰 경우 결과가 거의 의미가 없거나 전혀 의미가 없을 수 있습니다. |
(until C++11) |
도메인 오류가 발생하면 구현에서 정의한 값이 반환됩니다(NaN이 지원되는 경우).
언더플로우로 인해 범위 오류가 발생하면, 올바른 결과(반올림 후)가 반환됩니다.
오류 처리
오류는 math_errhandling 에 명시된 대로 보고됩니다.
구현이 IEEE 부동 소수점 연산(IEC 60559)을 지원하는 경우,
- 인수가 ±0인 경우, 결과는 1.0 입니다.
- 인수가 ±∞인 경우, NaN이 반환되고 FE_INVALID 이 발생합니다.
- 인수가 NaN인 경우, NaN이 반환됩니다.
참고 사항
인수가 무한대인 경우는 C에서는 도메인 오류로 명시되어 있지 않지만, POSIX에서는 도메인 오류 로 정의되어 있습니다.
추가 오버로드는 반드시 (A) 와 정확히 동일하게 제공될 필요는 없습니다. 정수 타입의 인수 num 에 대해 std :: cos ( num ) 가 std :: cos ( static_cast < double > ( num ) ) 와 동일한 효과를 가지도록 보장하기에 충분하기만 하면 됩니다.
예제
#include <cerrno> #include <cfenv> #include <cmath> #include <iomanip> #include <iostream> #include <numbers> // #pragma STDC FENV_ACCESS ON constexpr double pi = std::numbers::pi; // or std::acos(-1) before C++20 constexpr double your_cos(double x) { double cos{1}, pow{x}; for (auto fac{1ull}, n{1ull}; n != 19; fac *= ++n, pow *= x) if ((n & 1) == 0) cos += (n & 2 ? -pow : pow) / fac; return cos; } int main() { std::cout << std::setprecision(10) << std::showpos << "일반적인 사용법:\n" << "std::cos(pi/3) = " << std::cos(pi / 3) << '\n' << "your cos(pi/3) = " << your_cos(pi / 3) << '\n' << "std::cos(pi/2) = " << std::cos(pi / 2) << '\n' << "your cos(pi/2) = " << your_cos(pi / 2) << '\n' << "std::cos(-3*pi/4) = " << std::cos(-3 * pi / 4) << '\n' << "your cos(-3*pi/4) = " << your_cos(-3 * pi / 4) << '\n' << "특수 값:\n" << "std::cos(+0) = " << std::cos(0.0) << '\n' << "std::cos(-0) = " << std::cos(-0.0) << '\n'; // 오류 처리 std::feclearexcept(FE_ALL_EXCEPT); std::cout << "cos(INFINITY) = " << std::cos(INFINITY) << '\n'; if (std::fetestexcept(FE_INVALID)) std::cout << " FE_INVALID 발생\n"; }
가능한 출력:
일반적인 사용법:
std::cos(pi/3) = +0.5
your cos(pi/3) = +0.5
std::cos(pi/2) = +6.123233996e-17
your cos(pi/2) = -3.373452105e-15
std::cos(-3*pi/4) = -0.7071067812
your cos(-3*pi/4) = -0.7071067812
특수 값:
std::cos(+0) = +1
std::cos(-0) = +1
cos(INFINITY) = -nan
FE_INVALID 발생
참고 항목
|
(C++11)
(C++11)
|
사인을 계산함 (
sin(x)
)
(함수) |
|
(C++11)
(C++11)
|
탄젠트를 계산함 (
tan(x)
)
(함수) |
|
(C++11)
(C++11)
|
아크 코사인을 계산함 (
arccos(x)
)
(함수) |
|
복소수의 코사인을 계산함 (
cos(z)
)
(함수 템플릿) |
|
|
함수
std::cos
를 valarray의 각 요소에 적용함
(함수 템플릿) |
|
|
C 문서
for
cos
|
|