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

float       tan ( float num );
double      tan ( double num );
long double tan ( long double num );

/*floating-point-type*/
            tan ( /*floating-point-type*/ num );

float       tanf( float num );

long double tanl( long double num );

template< /*math-floating-point*/ V >
constexpr /*deduced-simd-t*/<V> 
            tan ( const V& v_num );

template< class Integer >
double      tan ( Integer num );

Параметры

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

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

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

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

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

Об ошибках сообщается в соответствии с math_errhandling.

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

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

Примечания

Случай, когда аргумент бесконечен, не определён в C как ошибка области определения (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

См. также