std::acos, std::acosf, std::acosl
De cppreference.com
<tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
| Definido en el archivo de encabezado <cmath>
|
||
| (1) | ||
float acos ( float arg ); |
||
float acosf( float arg ); |
(desde C++11) | |
double acos ( double arg ); |
(2) | |
| (3) | ||
long double acos ( long double arg ); |
||
long double acosl( long double arg ); |
(desde C++11) | |
double acos ( TipoEntero arg ); |
(4) | (desde C++11) |
1-3) Calcula el valor principal del arco coseno de
arg.4) Un conjunto de sobrecargas o una plantilla de función que acepta un argumento de cualquier tipo entero. Equivalente a (2) (el argumento se convierte a
double).Parámetros
| arg | - | Valor de un tipo de punto flotante o un tipo entero. |
Valor de retorno
Si no se producen errores, se devuelve el arco coseno de arg (arccos(arg)) en el rango [0 , π].
Si se produce un error de dominio, se devuelve un valor definido por la implementación (NaN donde se dé apoyo).
Si se produce un error debido a subdesbordamiento, se devuelve el resultado correcto (después del redondeo).
Manejo de errores
Los errores se informan como se especifica en math_errhandling.
Se produce un error de dominio si arg está fuera del rango [-1.0, 1.0].
Si la implementación admite la aritmética de punto flotante IEEE (IEC 60559):
- Si el argumento es +1, se devuelve el valor
+0. - Si |arg| > 1, se produce un error de dominio y se devuelve NaN.
- Si el argumento es NaN, se devuelve NaN.
Ejemplo
Ejecuta este código
#include <cmath>
#include <iostream>
#include <cerrno>
#include <cfenv>
#include <cstring>
#pragma STDC FENV_ACCESS ON
int main()
{
std::cout << "acos(-1) = " << acos(-1) << '\n'
<< "acos(0.0) = " << acos(0.0) << " 2*acos(0.0) = " << 2*acos(0) << '\n'
<< "acos(0.5) = " << acos(0.5) << " 3*acos(0.5) = " << 3*acos(0.5) << '\n'
<< "acos(1) = " << acos(1) << '\n';
// manejo de errores
errno = 0;
std::feclearexcept(FE_ALL_EXCEPT);
std::cout << "acos(1.1) = " << acos(1.1) << '\n';
if (errno == EDOM)
std::cout << " errno == EDOM: " << std::strerror(errno) << '\n';
if (std::fetestexcept(FE_INVALID))
std::cout << " Se generó FE_INVALID" << '\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: Argumento numérico fuera de dominio
Se generó FE_INVALID
Véase también
(C++11)(C++11) |
Calcula el arco seno (arcsen(x)) (función) |
(C++11)(C++11) |
Calcula el arco tangente (arctan(x)) (función) |
(C++11)(C++11) |
El 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) |
| Se aplica la función std::acos a cada elemento de valarray. (plantilla de función) | |
Documentación de C para acos
| |