std::tanh, std::tanhf, std::tanhl

Определено в заголовке `<cmath>`
	(1)
float tanh ( float num ); double tanh ( double num ); long double tanh ( long double num );		(до C++23)
/* floating-point-type / tanh ( / floating-point-type */ num );		(с C++23) (constexpr с C++26)
float tanhf( float num );	(2)	(с C++11) (constexpr с C++26)
long double tanhl( long double num );	(3)	(с C++11) (constexpr с C++26)
Дополнительные перегрузки (с C++11)
Определено в заголовке `<cmath>`
template< class Integer > double tanh ( Integer num );	(A)	(constexpr с C++26)

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

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

(с C++11)

Параметры

num

значение с плавающей точкой или целое число

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

Если ошибки не произошли, возвращается гиперболический тангенс от num (tanh(num), или enum-e-num/enum+e-num).

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

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

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

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

если аргумент равен ±0, возвращается ±0.
если аргумент равен ±∞, возвращается ±1.
если аргумент равен NaN, возвращается NaN.

Примечания

POSIX определяет, что в случае подпорогового значения, num возвращается без изменений, а если это не поддерживается, возвращается значение, определённое реализацией, не превышающее DBL_MIN, FLT_MIN и LDBL_MIN.

Дополнительные перегрузки не обязаны быть предоставлены точно как (A). Они должны быть достаточными, чтобы для аргумента num целочисленного типа, std::tanh(num) имело тот же эффект, что и std::tanh(static_cast<double>(num)).

Пример

#include <cmath>
#include <iostream>
#include <random>
 
double get_random_between(double min, double max)
{
    std::random_device rd;
    std::mt19937 gen(rd());
    return std::uniform_real_distribution<>(min, max)(gen);
}
 
int main()
{
    const double x = get_random_between(-1.0, 1.0);
 
    std::cout << std::showpos
              << "tanh(+1) = " << std::tanh(+1) << '\n'
              << "tanh(-1) = " << std::tanh(-1) << '\n'
              << "tanh(x)*sinh(2*x)-cos(2*x) = "
              << std::tanh(x) * std::sinh(2 * x) - std::cosh(2 * x) << '\n'
              // special values:
              << "tanh(+0) = " << std::tanh(+0.0) << '\n'
              << "tanh(-0) = " << std::tanh(-0.0) << '\n';
}

Вывод:

tanh(+1) = +0.761594
tanh(-1) = -0.761594
tanh(x)*sinh(2*x)-cos(2*x) = -1
tanh(+0) = +0
tanh(-0) = -0

См. также

sinhsinhfsinhl (C++11)(C++11)	вычисляет гиперболический синус (\({\small\sinh{x}}\)sinh(x)) (функция)
coshcoshfcoshl (C++11)(C++11)	вычисляет гиперболический косинус (\({\small\cosh{x}}\)cosh(x)) (функция)
atanhatanhfatanhl (C++11)(C++11)(C++11)	вычисляет обратный гиперболический тангенс (\({\small\operatorname{artanh}{x}}\)artanh(x)) (функция)
tanh(std::complex)	вычисляет гиперболический тангенс комплексного числа (\({\small\tanh{z}}\)tanh(z)) (функция-шаблон)
tanh(std::valarray)	применяет функцию `std::tanh` к каждому элементу valarray (функция-шаблон)
Документация на C для `tanh`

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