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
Défini dans l'en-tête <math.h>
float cosf ( float arg ) ;
(1) (depuis C99)
double cos ( double arg ) ;
(2)
long double cosl ( long double arg ) ;
(3) (depuis C99)
_Decimal32  cosd32 ( _Decimal32 arg ) ;
(4) (depuis C23)
_Decimal64  cosd64 ( _Decimal64 arg ) ;
(5) (depuis C23)
_Decimal128 cosd128 ( _Decimal128 arg ) ;
(6) (depuis C23)
Défini dans l'en-tête <tgmath.h>
#define cos( arg )
(7) (depuis C99)
1-6) Calcule le cosinus de arg (mesuré en radians).
7) Macro générique de type : Si l'argument a le type long double , (3) ( cosl ) est appelé. Sinon, si l'argument a un type entier ou le type double , (2) ( cos ) est appelé. Sinon, (1) ( cosf ) est appelé. Si l'argument est complexe, alors la macro appelle la fonction complexe correspondante ( ccosf , ccos , ccosl ).

Les fonctions (4-6) sont déclarées si et seulement si l'implémentation prédéfinit __STDC_IEC_60559_DFP__ (c'est-à-dire que l'implémentation prend en charge les nombres à virgule flottante décimale).

(depuis C23)

Table des matières

Paramètres

arg - valeur en virgule flottante représentant l'angle en radians

Valeur de retour

Si aucune erreur ne se produit, le cosinus de arg ( cos(arg) ) dans l'intervalle [-1 ; +1] , est retourné.

Le résultat peut avoir peu ou pas de signification si l'amplitude de arg est grande.

(until C99)

Si une erreur de domaine se produit, une valeur définie par l'implémentation est retournée (NaN là où supporté).

Si une erreur de plage se produit en raison d'un dépassement inférieur, le résultat correct (après arrondi) est retourné.

Gestion des erreurs

Les erreurs sont signalées comme spécifié dans math_errhandling .

Si l'implémentation prend en charge l'arithmétique à virgule flottante IEEE (IEC 60559) :

  • si l'argument est ±0, le résultat est 1.0 ;
  • si l'argument est ±∞, NaN est retourné et FE_INVALID est déclenché ;
  • si l'argument est NaN, NaN est retourné.

Notes

Le cas où l'argument est infini n'est pas spécifié comme une erreur de domaine en C, mais il est défini comme une erreur de domaine dans POSIX .

Exemple

Exécuter ce code 
#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);
    // utilisation typique
    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));
    // valeurs spéciales
    printf("cos(+0) = %f\n", cos(0.0));
    printf("cos(-0) = %f\n", cos(-0.0));
    // gestion des erreurs
    feclearexcept(FE_ALL_EXCEPT);
    printf("cos(INFINITY) = %f\n", cos(INFINITY));
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID raised");
}

Sortie possible : 

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

Références

  • Norme C23 (ISO/CEI 9899:2024) :
  • 7.12.4.5 Les fonctions cos (p: TBD)
  • 7.25 Mathématiques génériques de type <tgmath.h> (p: TBD)
  • F.10.1.5 Les fonctions cos (p: TBD)
  • Norme C17 (ISO/CEI 9899:2018) :
  • 7.12.4.5 Les fonctions cos (p : 174)
  • 7.25 Mathématiques génériques de type <tgmath.h> (p : 272-273)
  • F.10.1.5 Les fonctions cos (p : 378)
  • Norme C11 (ISO/IEC 9899:2011) :
  • 7.12.4.5 Les fonctions cos (p: 239)
  • 7.25 Mathématiques génériques de type <tgmath.h> (p: 373-375)
  • F.10.1.5 Les fonctions cos (p: 519)
  • Norme C99 (ISO/CEI 9899:1999) :
  • 7.12.4.5 Les fonctions cos (p. 220)
  • 7.22 Mathématiques génériques de type <tgmath.h> (p. 335-337)
  • F.9.1.5 Les fonctions cos (p. 456)
  • Norme C89/C90 (ISO/CEI 9899:1990) :
  • 4.5.2.5 La fonction cos

Voir aussi

(C99) (C99)
calcule le sinus ( sin(x) )
(fonction)
(C99) (C99)
calcule la tangente ( tan(x) )
(fonction)
(C99) (C99)
calcule l'arc cosinus ( arccos(x) )
(fonction)
(C99) (C99) (C99)
calcule le cosinus complexe
(fonction)
Documentation C++ pour cos