std:: cos, std:: cosf, std:: cosl
|
Défini dans l'en-tête
<cmath>
|
||
| (1) | ||
|
float
cos
(
float
num
)
;
double
cos
(
double
num
)
;
|
(jusqu'à C++23) | |
|
/*floating-point-type*/
cos ( /*floating-point-type*/ num ) ; |
(depuis C++23)
(constexpr depuis C++26) |
|
|
float
cosf
(
float
num
)
;
|
(2) |
(depuis C++11)
(constexpr depuis C++26) |
|
long
double
cosl
(
long
double
num
)
;
|
(3) |
(depuis C++11)
(constexpr depuis C++26) |
|
Surcharge SIMD
(depuis C++26)
|
||
|
Défini dans l'en-tête
<simd>
|
||
|
template
<
/*math-floating-point*/
V
>
constexpr
/*deduced-simd-t*/
<
V
>
|
(S) | (depuis C++26) |
|
Surcharges supplémentaires
(depuis C++11)
|
||
|
Défini dans l'en-tête
<cmath>
|
||
|
template
<
class
Integer
>
double cos ( Integer num ) ; |
(A) | (constexpr depuis C++26) |
std::cos
pour tous les types à virgule flottante non qualifiés cv comme type du paramètre.
(depuis C++23)
|
S)
La surcharge SIMD effectue un calcul
std::cos
élément par élément sur
v_num
.
|
(depuis C++26) |
|
A)
Des surcharges supplémentaires sont fournies pour tous les types entiers, qui sont traités comme
double
.
|
(depuis C++11) |
Table des matières |
Paramètres
| num | - | valeur à virgule flottante ou entière représentant l'angle en radians |
Valeur de retour
Si aucune erreur ne se produit, le cosinus de
num
(
cos(num)
) dans l'intervalle
[
-
1.0
,
+
1.0
]
, est retourné.
|
Le résultat peut avoir peu ou pas de signification si l'amplitude de num est grande. |
(until C++11) |
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 .
Les surcharges supplémentaires ne sont pas tenues d'être fournies exactement comme (A) . Elles doivent seulement être suffisantes pour garantir que pour leur argument num de type entier, std :: cos ( num ) ait le même effet que std :: cos ( static_cast < double > ( num ) ) .
Exemple
#include <cerrno> #include <cfenv> #include <cmath> #include <iomanip> #include <iostream> #include <numbers> // #pragma STDC FENV_ACCESS ON constexpr double pi = std::numbers::pi; // ou std::acos(-1) avant C++20 constexpr double your_cos(double x) { double cos{1}, pow{x}; for (auto fac{1ull}, n{1ull}; n != 19; fac *= ++n, pow *= x) if ((n & 1) == 0) cos += (n & 2 ? -pow : pow) / fac; return cos; } int main() { std::cout << std::setprecision(10) << std::showpos << "Utilisation typique :\n" << "std::cos(pi/3) = " << std::cos(pi / 3) << '\n' << "your cos(pi/3) = " << your_cos(pi / 3) << '\n' << "std::cos(pi/2) = " << std::cos(pi / 2) << '\n' << "your cos(pi/2) = " << your_cos(pi / 2) << '\n' << "std::cos(-3*pi/4) = " << std::cos(-3 * pi / 4) << '\n' << "your cos(-3*pi/4) = " << your_cos(-3 * pi / 4) << '\n' << "Valeurs spéciales :\n" << "std::cos(+0) = " << std::cos(0.0) << '\n' << "std::cos(-0) = " << std::cos(-0.0) << '\n'; // gestion des erreurs std::feclearexcept(FE_ALL_EXCEPT); std::cout << "cos(INFINITY) = " << std::cos(INFINITY) << '\n'; if (std::fetestexcept(FE_INVALID)) std::cout << " FE_INVALID levée\n"; }
Sortie possible :
Utilisation typique :
std::cos(pi/3) = +0.5
your cos(pi/3) = +0.5
std::cos(pi/2) = +6.123233996e-17
your cos(pi/2) = -3.373452105e-15
std::cos(-3*pi/4) = -0.7071067812
your cos(-3*pi/4) = -0.7071067812
Valeurs spéciales :
std::cos(+0) = +1
std::cos(-0) = +1
cos(INFINITY) = -nan
FE_INVALID levée
Voir aussi
|
(C++11)
(C++11)
|
calcule le sinus (
sin(x)
)
(fonction) |
|
(C++11)
(C++11)
|
calcule la tangente (
tan(x)
)
(fonction) |
|
(C++11)
(C++11)
|
calcule l'arc cosinus (
arccos(x)
)
(fonction) |
|
calcule le cosinus d'un nombre complexe (
cos(z)
)
(modèle de fonction) |
|
|
applique la fonction
std::cos
à chaque élément du valarray
(modèle de fonction) |
|
|
Documentation C
pour
cos
|
|