Namespaces
Variants

casinhf, casinh, casinhl

From cppreference.net
Определено в заголовочном файле <complex.h>
float complex casinhf ( float complex z ) ;
(1) (начиная с C99)
double complex casinh ( double complex z ) ;
(2) (начиная с C99)
long double complex casinhl ( long double complex z ) ;
(3) (начиная с C99)
Определено в заголовочном файле <tgmath.h>
#define asinh( z )
(4) (начиная с C99)
1-3) Вычисляет комплексный гиперболический арксинус z с разрезами ветвей вне интервала [−i; +i] вдоль мнимой оси.
4) Тип-независимый макрос: Если z имеет тип long double complex , casinhl вызывается. Если z имеет тип double complex , casinh вызывается. Если z имеет тип float complex , casinhf вызывается. Если z является вещественным или целочисленным, то макрос вызывает соответствующую вещественную функцию ( asinhf , asinh , asinhl ). Если z является мнимым, то макрос вызывает соответствующую вещественную версию функции asin , реализуя формулу asinh(iy) = i asin(y) , и возвращаемый тип является мнимым.

Содержание

Параметры

z - комплексный аргумент

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

Если ошибок не возникает, возвращается комплексный гиперболический арксинус z , в диапазоне полосы, математически неограниченной вдоль действительной оси и в интервале [−iπ/2; +iπ/2] вдоль мнимой оси.

Обработка ошибок и специальные значения

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

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

  • casinh ( conj ( z ) ) == conj ( casinh ( z ) )
  • casinh ( - z ) == - casinh ( z )
  • Если z равно +0+0i , результат равен +0+0i
  • Если z равно x+∞i (для любого положительного конечного x), результат равен +∞+π/2
  • Если z равно x+NaNi (для любого конечного x), результат равен NaN+NaNi и может быть возбуждено FE_INVALID
  • Если z равно +∞+yi (для любого положительного конечного y), результат равен +∞+0i
  • Если z равно +∞+∞i , результат равен +∞+iπ/4
  • Если z равно +∞+NaNi , результат равен +∞+NaNi
  • Если z равно NaN+0i , результат равен NaN+0i
  • Если z равно NaN+yi (для любого конечного ненулевого y), результат равен NaN+NaNi и может быть возбуждено FE_INVALID
  • Если z равно NaN+∞i , результат равен ±∞+NaNi (знак действительной части не определен)
  • Если z равно NaN+NaNi , результат равен NaN+NaNi

Примечания

Хотя стандарт C называет эту функцию "комплексный гиперболический арксинус", обратные функции гиперболических функций являются ареа-функциями. Их аргумент представляет собой площадь гиперболического сектора, а не дугу. Правильное название - "комплексный обратный гиперболический синус", и, менее распространенное, "комплексный ареа-гиперболический синус".

Обратный гиперболический синус является многозначной функцией и требует разреза ветви на комплексной плоскости. Разрез ветви традиционно проводится по отрезкам (- i ∞,- i ) и ( i , i ∞) мнимой оси.

Математическое определение главного значения обратного гиперболического синуса: asinh z = ln(z + 1+z 2
)

For any z, asinh(z) =
asin(iz)
i

Пример

#include <stdio.h>
#include <complex.h>
int main(void)
{
    double complex z = casinh(0+2*I);
    printf("casinh(+0+2i) = %f%+fi\n", creal(z), cimag(z));
    double complex z2 = casinh(-conj(2*I)); // или casinh(CMPLX(-0.0, 2)) в C11
    printf("casinh(-0+2i) (the other side of the cut) = %f%+fi\n", creal(z2), cimag(z2));
    // для любого z, asinh(z) = asin(iz)/i
    double complex z3 = casinh(1+2*I);
    printf("casinh(1+2i) = %f%+fi\n", creal(z3), cimag(z3));
    double complex z4 = casin((1+2*I)*I)/I;
    printf("casin(i * (1+2i))/i = %f%+fi\n", creal(z4), cimag(z4));
}

Вывод:

casinh(+0+2i) = 1.316958+1.570796i
casinh(-0+2i) (the other side of the cut) = -1.316958+1.570796i
casinh(1+2i) = 1.469352+1.063440i
casin(i * (1+2i))/i =  1.469352+1.063440i

Ссылки

  • Стандарт C11 (ISO/IEC 9899:2011):
  • 7.3.6.2 Функции casinh (стр. 192-193)
  • 7.25 Обобщённая математика <tgmath.h> (стр. 373-375)
  • G.6.2.2 Функции casinh (стр. 540)
  • G.7 Обобщённая математика <tgmath.h> (стр. 545)
  • Стандарт C99 (ISO/IEC 9899:1999):
  • 7.3.6.2 Функции casinh (стр. 174-175)
  • 7.22 Обобщённая математика <tgmath.h> (стр. 335-337)
  • G.6.2.2 Функции casinh (стр. 475)
  • G.7 Обобщённая математика <tgmath.h> (стр. 480)

Смотрите также

(C99) (C99) (C99)
вычисляет комплексный гиперболический арккосинус
(функция)
(C99) (C99) (C99)
вычисляет комплексный гиперболический арктангенс
(функция)
(C99) (C99) (C99)
вычисляет комплексный гиперболический синус
(функция)
(C99) (C99) (C99)
вычисляет обратный гиперболический синус ( arsinh(x) )
(функция)