std:: acos, std:: acosf, std:: acosl
|
Definido en el encabezado
<cmath>
|
||
| (1) | ||
|
float
acos
(
float
num
)
;
double
acos
(
double
num
)
;
|
(hasta C++23) | |
|
/*floating-point-type*/
acos ( /*floating-point-type*/ num ) ; |
(desde C++23)
(constexpr desde C++26) |
|
|
float
acosf
(
float
num
)
;
|
(2) |
(desde C++11)
(constexpr desde C++26) |
|
long
double
acosl
(
long
double
num
)
;
|
(3) |
(desde C++11)
(constexpr desde C++26) |
|
Sobrecarga SIMD
(desde C++26)
|
||
|
Definido en el encabezado
<simd>
|
||
|
template
<
/*math-floating-point*/
V
>
constexpr
/*deduced-simd-t*/
<
V
>
|
(S) | (desde C++26) |
|
Sobrecargas adicionales
(desde C++11)
|
||
|
Definido en el encabezado
<cmath>
|
||
|
template
<
class
Integer
>
double acos ( Integer num ) ; |
(A) | (constexpr desde C++26) |
std::acos
para todos los tipos de punto flotante sin calificación cv como el tipo del parámetro.
(desde C++23)
|
S)
La sobrecarga SIMD realiza un
std::acos
elemento por elemento en
v_num
.
|
(desde C++26) |
|
A)
Se proporcionan sobrecargas adicionales para todos los tipos enteros, los cuales son tratados como
double
.
|
(since C++11) |
Contenidos |
Parámetros
| num | - | valor de punto flotante o entero |
Valor de retorno
Si no ocurren errores, se devuelve el arcocoseno de num ( arccos(num) ) en el rango [0, π] .
Si ocurre un error de dominio, se devuelve un valor definido por la implementación (NaN donde esté soportado).
Si ocurre un error de rango debido a desbordamiento inferior, se devuelve el resultado correcto (después del redondeo).
Manejo de errores
Los errores se reportan como se especifica en math_errhandling .
Error de dominio ocurre si
num
está fuera del rango
[
-
1.0
,
1.0
]
.
Si la implementación soporta aritmética de punto flotante IEEE (IEC 60559),
-
Si el argumento es
+1
, se devuelve el valor
+0. - Si |num| > 1 , ocurre un error de dominio y se devuelve NaN.
- Si el argumento es NaN, se devuelve NaN.
Notas
Las sobrecargas adicionales no están obligadas a proporcionarse exactamente como (A) . Solo necesitan ser suficientes para garantizar que para su argumento num de tipo entero, std :: acos ( num ) tenga el mismo efecto que std :: acos ( static_cast < double > ( num ) ) .
Ejemplo
#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'; // manejo de errores 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'; }
Salida:
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
Véase también
|
(C++11)
(C++11)
|
calcula el arco seno (
arcsin(x)
)
(función) |
|
(C++11)
(C++11)
|
calcula el arco tangente (
arctan(x)
)
(función) |
|
(C++11)
(C++11)
|
arco tangente, usando signos para determinar cuadrantes
(función) |
|
(C++11)
(C++11)
|
calcula el coseno (
cos(x)
)
(función) |
|
(C++11)
|
calcula el arco coseno de un número complejo (
arccos(z)
)
(plantilla de función) |
|
aplica la función
std::acos
a cada elemento del valarray
(plantilla de función) |
|
|
Documentación C
para
acos
|
|