std::asin, std::asinf, std::asinl

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

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

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

(с C++11)

Параметры

num

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

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

Если ошибки не возникли, возвращается арксинус num (arcsin(num)) в диапазоне [- π/2 , +π/2].

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

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

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

Ошибки сообщаются, как указано в math_errhandling.

Ошибка области определения возникает, если num находится за пределами диапазона [-1.0, 1.0].

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

Если аргумент равен ±0, он возвращается без изменений.
Если |num| > 1, возникает ошибка области определения, и возвращается NaN.
Если аргумент равен NaN, возвращается NaN.

Примечания

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

Пример

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
 
// #pragma STDC FENV_ACCESS ON
 
int main()
{
    std::cout << "asin(1.0) = " << asin(1) << '\n'
              << "2*asin(1.0) = " << 2 * asin(1) << '\n'
              << "asin(-0.5) = " << asin(-0.5) << '\n'
              << "6*asin(-0.5) =" << 6 * asin(-0.5) << '\n';
 
    // special values
    std::cout << "asin(0.0) = " << asin(0) << " asin(-0.0)=" << asin(-0.0) << '\n';
 
    // error handling
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "asin(1.1) = " << asin(1.1) << '\n';
 
    if (errno == EDOM)
        std::cout << "    errno == EDOM: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID raised" << '\n';
}

Возможный вывод:

asin(1.0) = 1.5708
2*asin(1.0) = 3.14159
asin(-0.5) = -0.523599
6*asin(-0.5) = -3.14159
asin(0.0) = 0 asin(-0.0)=-0
asin(1.1) = nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised

См. также

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

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