Espacios de nombres
Variantes
Acciones

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

De cppreference.com
< cpp‎ | numeric‎ | math
 
 
 
Funciones matemáticas comunes
Funciones
Operaciones básicas
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
Funciones exponenciales
(C++11)
(C++11)
(C++11)
(C++11)
Funciones de potencias
(C++11)
(C++11)
Funciones trigonométricas e hiperbólicas
(C++11)
(C++11)
(C++11)
Funciones de error y gamma
(C++11)
(C++11)
(C++11)
(C++11)
Operaciones de punto flotante del entero más cercano
(C++11)(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
Funciones de manipulación de punto flotante
(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)
(C++11)
Clasificación/comparación
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Constantes de macro
(C++11)(C++11)(C++11)(C++11)(C++11)
 
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

#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) [editar]
(C++11)(C++11)
Calcula el arco tangente (arctan(x))
(función) [editar]
(C++11)(C++11)
El arco tangente, usando signos para determinar cuadrantes.
(función) [editar]
(C++11)(C++11)
Calcula el coseno (cos(x))
(función) [editar]
Calcula el arco coseno de un número complejo (arccos(z)).
(plantilla de función) [editar]
Se aplica la función std::acos a cada elemento de valarray.
(plantilla de función) [editar]