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

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

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

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

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/cpp/numeric/math/asin