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