std::tan, std::tanf, std::tanl

Определено в заголовке `<cmath>`
	(1)
float tan ( float num ); double tan ( double num ); long double tan ( long 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)
Дополнительные перегрузки (с C++11)
Определено в заголовке `<cmath>`
template< class Integer > double tan ( Integer num );	(A)	(constexpr с C++26)

1-3) Вычисляет тангенс угла num (в радианах). Библиотека предоставляет перегрузки std::tan для всех типов с плавающей точкой без квалификаторов cv в качестве типа параметра.(с C++23)

A) Дополнительные перегрузки предоставляются для всех целочисленных типов, которые обрабатываются как double.

(с C++11)

Параметры

num

значение с плавающей точкой или целое число, представляющее угол в радианах

Возвращаемое значение

Если ошибки не возникли, возвращается тангенс угла num (tan(num)).

Результат может иметь малое или нулевое значение, если абсолютное значение num велико.

(до C++11)

Если возникает ошибка области определения, возвращается определённое реализацией значение (NaN, если поддерживается).

Если возникает ошибка диапазона из-за подпотока, возвращается правильный результат (после округления).

Обработка ошибок

Ошибки сообщаются в соответствии со спецификацией math_errhandling.

Если реализация поддерживает арифметику с плавающей точкой IEEE (IEC 60559),

если аргумент равен ±0, он возвращается без изменений.
если аргумент равен ±∞, возвращается NaN, и поднимается FE_INVALID.
если аргумент равен NaN, возвращается NaN.

Примечания

Случай, когда аргумент является бесконечным, не определён как ошибка области определения в C (от которого C++ унаследован), но он определён как ошибка области определения в 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()
{
    // typical usage
    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°
 
    // special values
    std::cout << "tan(+0) = " << std::tan(0.0) << '\n'
              << "tan(-0) = " << std::tan(-0.0) << '\n';
 
    // error handling
    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

См. также

sinsinfsinl (C++11)(C++11)	вычисляет синус (\({\small\sin{x}}\)sin(x)) (функция)
coscosfcosl (C++11)(C++11)	вычисляет косинус (\({\small\cos{x}}\)cos(x)) (функция)
atanatanfatanl (C++11)(C++11)	вычисляет арктангенс (\({\small\arctan{x}}\)arctan(x)) (функция)
tan(std::complex)	вычисляет тангенс комплексного числа (\({\small\tan{z}}\)tan(z)) (шаблон функции)
tan(std::valarray)	применяет функцию `std::tan` к каждому элементу valarray (шаблон функции)
C документация для `tan`

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/numeric/math/tan