std::acos, std::acosf, std::acosl

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

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

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

(с C++11)

Параметры

num

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

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

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

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

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

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

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

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

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

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

Примечания

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

Пример

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
 
// #pragma STDC FENV_ACCESS ON
 
int main()
{
    std::cout << "acos(-1) = " << std::acos(-1) << '\n'
              << "acos(0.0) = " << std::acos(0.0) << '\n'
              << "2*acos(0.0) = " << 2 * std::acos(0) << '\n'
              << "acos(0.5) = " << std::acos(0.5) << '\n'
              << "3*acos(0.5) = " << 3 * std::acos(0.5) << '\n'
              << "acos(1) = " << std::acos(1) << '\n';
 
    // error handling
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "acos(1.1) = " << std::acos(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';
}

Вывод:

acos(-1) = 3.14159
acos(0.0) = 1.5708
2*acos(0.0) = 3.14159
acos(0.5) = 1.0472
3*acos(0.5) = 3.14159
acos(1) = 0
acos(1.1) = nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised

См. также

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

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