std::acos, std::acosf, std::acosl
De cppreference.com
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).
Contenido |
[editar] Parámetros
arg | - | Valor de un tipo de punto flotante o un tipo entero. |
[editar] 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).
[editar] 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.
[editar] 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
[editar] 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
|