Namespaces
Variants

cos, cosf, cosl

From cppreference.net
< c ‎ | numeric ‎ | math
C
Numerics
Common mathematical functions
Functions
Basic operations
(C99)
(C99)
(C99)
(C99)
(C99) (C99) (C99) (C23)
Maximum/minimum operations
Exponential functions
Power functions
Trigonometric and hyperbolic functions
Nearest integer floating-point
(C99)
(C99) (C99) (C99)
(C23) (C23) (C23) (C23)
Floating-point manipulation
Narrowing operations
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
Quantum and quantum exponent
Decimal re-encoding functions
Total order and payload functions
Classification
Error and gamma functions
(C99)
(C99)
(C99)
(C99)
Types
Macro constants
Special floating-point values
Arguments and return values
Error handling
Fast operation indicators
Definido en el encabezado <math.h>
float cosf ( float arg ) ;
(1) (desde C99)
double cos ( double arg ) ;
(2)
long double cosl ( long double arg ) ;
(3) (desde C99)
_Decimal32  cosd32 ( _Decimal32 arg ) ;
(4) (desde C23)
_Decimal64  cosd64 ( _Decimal64 arg ) ;
(5) (desde C23)
_Decimal128 cosd128 ( _Decimal128 arg ) ;
(6) (desde C23)
Definido en el encabezado <tgmath.h>
#define cos( arg )
(7) (desde C99)
1-6) Calcula el coseno de arg (medido en radianes).
7) Macro genérico de tipos: Si el argumento tiene tipo long double , (3) ( cosl ) es llamado. De lo contrario, si el argumento tiene tipo entero o el tipo double , (2) ( cos ) es llamado. De lo contrario, (1) ( cosf ) es llamado. Si el argumento es complejo, entonces el macro invoca la función compleja correspondiente ( ccosf , ccos , ccosl ).

Las funciones (4-6) se declaran si y solo si la implementación predefine __STDC_IEC_60559_DFP__ (es decir, la implementación admite números de punto flotante decimales).

(desde C23)

Contenidos

Parámetros

arg - valor de punto flotante que representa el ángulo en radianes

Valor de retorno

Si no ocurren errores, el coseno de arg ( cos(arg) ) en el rango [-1 ; +1] , es devuelto.

El resultado puede tener poca o ninguna significancia si la magnitud de arg es grande.

(until C99)

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 .

Si la implementación soporta aritmética de punto flotante IEEE (IEC 60559):

  • si el argumento es ±0, el resultado es 1.0 ;
  • si el argumento es ±∞, se retorna NaN y FE_INVALID se activa;
  • si el argumento es NaN, se retorna NaN.

Notas

El caso donde el argumento es infinito no está especificado como un error de dominio en C, pero está definido como un error de dominio en POSIX .

Ejemplo

Ejecutar este código 
#include <errno.h>
#include <fenv.h>
#include <math.h>
#include <stdio.h>
#ifndef __GNUC__
#pragma STDC FENV_ACCESS ON
#endif
int main(void)
{
    const double pi = acos(-1);
    // uso típico
    printf("cos(pi/3) = %f\n", cos(pi / 3));
    printf("cos(pi/2) = %f\n", cos(pi / 2));
    printf("cos(-3*pi/4) = %f\n", cos(-3 * pi / 4));
    // valores especiales
    printf("cos(+0) = %f\n", cos(0.0));
    printf("cos(-0) = %f\n", cos(-0.0));
    // manejo de errores
    feclearexcept(FE_ALL_EXCEPT);
    printf("cos(INFINITY) = %f\n", cos(INFINITY));
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID raised");
}

Salida posible: 

cos(pi/3) = 0.500000
cos(pi/2) = 0.000000
cos(-3*pi/4) = -0.707107
cos(+0) = 1.000000
cos(-0) = 1.000000
cos(INFINITY) = -nan
    FE_INVALID raised

Referencias

  • Estándar C23 (ISO/IEC 9899:2024):
  • 7.12.4.5 Las funciones cos (p: TBD)
  • 7.25 Matemáticas genéricas de tipos <tgmath.h> (p: TBD)
  • F.10.1.5 Las funciones cos (p: TBD)
  • Estándar C17 (ISO/IEC 9899:2018):
  • 7.12.4.5 Las funciones cos (p: 174)
  • 7.25 Matemáticas genéricas de tipos <tgmath.h> (p: 272-273)
  • F.10.1.5 Las funciones cos (p: 378)
  • Estándar C11 (ISO/IEC 9899:2011):
  • 7.12.4.5 Las funciones cos (p: 239)
  • 7.25 Matemáticas genéricas de tipos <tgmath.h> (p: 373-375)
  • F.10.1.5 Las funciones cos (p: 519)
  • Estándar C99 (ISO/IEC 9899:1999):
  • 7.12.4.5 Las funciones cos (p: 220)
  • 7.22 Matemáticas genéricas de tipo <tgmath.h> (p: 335-337)
  • F.9.1.5 Las funciones cos (p: 456)
  • Estándar C89/C90 (ISO/IEC 9899:1990):
  • 4.5.2.5 La función cos

Véase también

(C99) (C99)
calcula el seno ( sin(x) )
(función)
(C99) (C99)
calcula la tangente ( tan(x) )
(función)
(C99) (C99)
calcula el arco coseno ( arccos(x) )
(función)
(C99) (C99) (C99)
calcula el coseno complejo
(función)
Documentación de C++ para cos