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

Определено в заголовочном файле `<cmath>`
float tanh ( float num ); double tanh ( double num ); long double tanh ( long double num );	(1)	(до C++23)
/floating-point-type/ tanh ( /floating-point-type/ num );	(1)		(с 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)
Перегрузка SIMD (с C++26)
Определено в заголовочном файле `<simd>`
template< /math-floating-point/ V > constexpr /deduced-simd-t/<V> tanh ( const V& v_num );	(S)	(с C++26)
Дополнительные перегрузки (с C++11)
Определено в заголовочном файле `<cmath>`
template< class Integer > double tanh ( Integer num );	(A)	(constexpr с C++26)

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

S) Перегрузка SIMD выполняет поэлементное std::tanh над v_num. (Определения см. в math-floating-point и deduced-simd-t.) (с C++26)

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)-cosh(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)-cosh(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/cpp/numeric/math/tanh