std:: tan, std:: tanf, std:: tanl
|
Определено в заголовочном файле
<cmath>
|
||
| (1) | ||
|
float
tan
(
float
num
)
;
double
tan
(
double
num
)
;
|
(до C++23) | |
|
/*floating-point-type*/
tan ( /*floating-point-type*/ num ) ; |
(начиная с C++23)
(constexpr начиная с C++26) |
|
|
float
tanf
(
float
num
)
;
|
(2) |
(начиная с C++11)
(constexpr начиная с C++26) |
|
long
double
tanl
(
long
double
num
)
;
|
(3) |
(начиная с C++11)
(constexpr начиная с C++26) |
|
Перегрузка SIMD
(начиная с C++26)
|
||
|
Определено в заголовочном файле
<simd>
|
||
|
template
<
/*math-floating-point*/
V
>
constexpr
/*deduced-simd-t*/
<
V
>
|
(S) | (начиная с C++26) |
|
Дополнительные перегрузки
(начиная с C++11)
|
||
|
Определено в заголовочном файле
<cmath>
|
||
|
template
<
class
Integer
>
double tan ( Integer num ) ; |
(A) | (constexpr начиная с C++26) |
std::tan
для всех cv-неквалифицированных типов с плавающей запятой в качестве типа параметра.
(since C++23)
|
S)
Перегрузка SIMD выполняет поэлементное вычисление
std::tan
для
v_num
.
|
(since C++26) |
|
A)
Дополнительные перегрузки предоставляются для всех целочисленных типов, которые трактуются как
double
.
|
(since C++11) |
Содержание |
Параметры
| num | - | значение с плавающей точкой или целое число, представляющее угол в радианах |
Возвращаемое значение
Если ошибок не возникает, возвращается тангенс num ( tan(num) ).
|
Результат может иметь незначительный или нулевой смысл, если величина num велика. |
(until C++11) |
Если происходит ошибка области определения, возвращается значение, определяемое реализацией (NaN, если поддерживается).
Если происходит ошибка диапазона из-за потери значимости (underflow), возвращается корректный результат (после округления).
Обработка ошибок
Ошибки сообщаются, как указано в math_errhandling .
Если реализация поддерживает арифметику с плавающей запятой IEEE (IEC 60559),
- если аргумент равен ±0, он возвращается без изменений.
- если аргумент равен ±∞, возвращается NaN и FE_INVALID устанавливается.
- если аргумент равен NaN, возвращается NaN.
Примечания
Случай, когда аргумент бесконечен, не указан как domain error в C (на что ссылается C++), но он определён как domain error в POSIX .
Функция имеет математические полюсы в точках π(1/2 + n) ; однако ни одно распространённое представление с плавающей запятой не может точно представить π/2, поэтому не существует значения аргумента, при котором возникает ошибка полюса.
Дополнительные перегрузки не обязаны быть предоставлены в точности как (A) . Они должны быть лишь достаточными для обеспечения того, чтобы для их аргумента num целочисленного типа, std :: tan ( num ) имел тот же эффект, что и std :: tan ( static_cast < double > ( num ) ) .
Пример
#include <cerrno> #include <cfenv> #include <cmath> #include <iostream> // #pragma STDC FENV_ACCESS ON const double pi = std::acos(-1); // or C++20's std::numbers::pi int main() { // типичное использование std::cout << "tan(1*pi/4) = " << std::tan(1*pi/4) << '\n' // 45° << "tan(3*pi/4) = " << std::tan(3*pi/4) << '\n' // 135° << "tan(5*pi/4) = " << std::tan(5*pi/4) << '\n' // -135° << "tan(7*pi/4) = " << std::tan(7*pi/4) << '\n'; // -45° // специальные значения std::cout << "tan(+0) = " << std::tan(0.0) << '\n' << "tan(-0) = " << std::tan(-0.0) << '\n'; // обработка ошибок std::feclearexcept(FE_ALL_EXCEPT); std::cout << "tan(INFINITY) = " << std::tan(INFINITY) << '\n'; if (std::fetestexcept(FE_INVALID)) std::cout << " FE_INVALID raised\n"; }
Возможный вывод:
tan(1*pi/4) = 1
tan(3*pi/4) = -1
tan(5*pi/4) = 1
tan(7*pi/4) = -1
tan(+0) = 0
tan(-0) = -0
tan(INFINITY) = -nan
FE_INVALID raised
Смотрите также
|
(C++11)
(C++11)
|
вычисляет синус (
sin(x)
)
(функция) |
|
(C++11)
(C++11)
|
вычисляет косинус (
cos(x)
)
(функция) |
|
(C++11)
(C++11)
|
вычисляет арктангенс (
arctan(x)
)
(функция) |
|
вычисляет тангенс комплексного числа (
tan(z)
)
(шаблон функции) |
|
|
применяет функцию
std::tan
к каждому элементу valarray
(шаблон функции) |
|
|
Документация C
для
tan
|
|