std::cos, std::cosf, std::cosl

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Numerik-Bibliothek

Allgemeine mathematische Funktionen
Mathematische Spezialfunktionen (C++17)
Mathematische Konstanten (C++20)
Grundlegende lineare Algebra-Algorithmen (C++26)
Datenparallele Typen (SIMD) (C++26)
Gleitkomma-Umgebung (C++11)
Komplexe Zahlen
Numerische Arrays (valarray)
Pseudozufallszahlengenerierung
Bit-Manipulation (C++20)
Faktoroperationen
gcd (C++17)	lcm (C++17)
Interpolationen
midpoint (C++20)	lerp (C++20)
Sättigungsarithmetik
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
Generische numerische Operationen
iota (C++11) ranges::iota (C++23) accumulate inner_product adjacent_difference    partial_sum	reduce (C++17) transform_reduce (C++17) inclusive_scan (C++17) exclusive_scan (C++17) transform_inclusive_scan (C++17) transform_exclusive_scan (C++17)

 

Allgemeine mathematische Funktionen

Funktionen
Grundlegende Operationen
abs(int)labsllabsimaxabs (C++11)   abs(float)fabs divldivlldivimaxdiv (C++11)	fmod remainder (C++11)   remquo (C++11) fma (C++11) fmax (C++11) fmin (C++11) fdim (C++11) nannanfnanl (C++11)(C++11)(C++11)
Exponentialfunktionen
exp exp2 (C++11) expm1 (C++11)	log log10 log1p (C++11) log2 (C++11)
Potenzfunktionen
sqrt cbrt (C++11)	hypot (C++11) pow
Trigonometrische und hyperbolische Funktionen
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C++11) acosh (C++11) atanh (C++11)
Fehler- und Gammafunktionen
erf (C++11) erfc (C++11)	lgamma (C++11) tgamma (C++11)

Rundungsoperationen für Gleitkommazahlen
ceil floor roundlroundllround (C++11)(C++11)(C++11)	trunc (C++11) nearbyint (C++11) rintlrintllrint (C++11)(C++11)(C++11)
Gleitkomma-Manipulationsfunktionen
ldexp scalbnscalbln (C++11)(C++11) ilogb (C++11) logb (C++11)	frexp modf nextafternexttoward (C++11)(C++11) copysign (C++11)
Klassifizierung und Vergleich
fpclassify (C++11) isfinite (C++11) isinf (C++11) isnan (C++11) isnormal (C++11) signbit (C++11)	isgreater (C++11) isgreaterequal (C++11) isless (C++11) islessequal (C++11) islessgreater (C++11) isunordered (C++11)
Typen
div_t ldiv_t lldiv_t (C++11)	imaxdiv_t (C++11) float_t (C++11) double_t (C++11)
Makrokonstanten
HUGE_VALFHUGE_VALHUGE_VALL (C++11)(C++11) math_errhandlingMATH_ERRNOMATH_ERREXCEPT (C++11)   INFINITY (C++11) NAN (C++11)	Klassifizierung FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C++11)(C++11)(C++11)(C++11)(C++11)

 

Definiert in der Header-Datei <cmath>
	(1)
float       cos ( float num ); double      cos ( double num ); long double cos ( long double num );			(bis C++23)
/* Gleitkommazahl-Typ */             cos ( /*Gleitkommazahl-Typ*/ num );			(seit C++23) (constexpr seit C++26)
float       cosf( float num );		(2)	(seit C++11) (constexpr seit C++26)
long double cosl( long double num );		(3)	(seit C++11) (constexpr seit C++26)
SIMD-Überladung (seit C++26)
Definiert im Header <simd>
template< /*math-floating-point*/ V > constexpr /*deduzierter-simd-t*/<V>             cos ( const V& v_num );		(S)	(seit C++26)
Zusätzliche Überladungen (seit C++11)
Definiert in der Header-Datei <cmath>
template< class Integer > double      cos ( Integer num );		(A)	(constexpr seit C++26)

1-3) Berechnet den Kosinus von num (gemessen in Radiant). Die Bibliothek stellt Überladungen von std::cos für alle cv-unqualifizierten Gleitkommazahltypen als Parametertyp bereit.(seit C++23)

S) Die SIMD-Überladung führt eine elementweise std::cos auf v_num durch. (Siehe math-floating-point und deduced-simd-t für ihre Definitionen.)

(seit C++26)

A) Zusätzliche Überladungen werden für alle ganzzahligen Typen bereitgestellt, die als double behandelt werden.

(seit C++11)

Parameter

num

-

Gleitkomma- oder Ganzzahlwert, der den Winkel in Radiant darstellt

Rückgabewert

Wenn keine Fehler auftreten, wird der Kosinus von num (cos(num)) im Bereich [-1.0, +1.0] zurückgegeben.

Das Ergebnis hat möglicherweise wenig oder keine Bedeutung, wenn die Magnitude von num groß ist.

(bis C++11)

Wenn ein Domänenfehler auftritt, wird ein implementierungsabhängiger Wert zurückgegeben (NaN, wo unterstützt).

Wenn ein Bereichsfehler aufgrund eines Unterlaufs auftritt, wird das korrekte Ergebnis (nach Rundung) zurückgegeben.

Fehlerbehandlung

Fehler werden wie in math_errhandling beschrieben gemeldet.

Wenn die Implementierung IEEE-Gleitkomma-Arithmetik (IEC 60559) unterstützt,

• Wenn das Argument ±0 ist, ist das Ergebnis 1.0.
• Wenn das Argument ±∞ ist, wird NaN zurückgegeben und FE_INVALID wird ausgelöst.
• Wenn das Argument NaN ist, wird NaN zurückgegeben.

Anmerkungen

Der Fall, dass das Argument unendlich ist, ist in C nicht als Domänenfehler spezifiziert, aber er ist als Domänenfehler in POSIX definiert.

Die zusätzlichen Überladungen müssen nicht genau als (A) bereitgestellt werden. Sie müssen nur ausreichend sein, um sicherzustellen, dass für ihr Argument num vom Ganzzahltyp std::cos(num) denselben Effekt hat wie std::cos(static_cast<double>(num)).

Beispiel

Führen Sie diesen Code aus

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <iomanip>
#include <iostream>
#include <numbers>
 
// #pragma STDC FENV_ACCESS ON
 
constexpr double pi = std::numbers::pi; // or std::acos(-1) before 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
              << "Typical usage:\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'
              << "Special values:\n"
              << "std::cos(+0) = " << std::cos(0.0) << '\n'
              << "std::cos(-0) = " << std::cos(-0.0) << '\n';
 
    // error handling
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "cos(INFINITY) = " << std::cos(INFINITY) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID raised\n";
}

Mögliche Ausgabe

Typical usage:
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
Special values:
std::cos(+0) = +1
std::cos(-0) = +1
cos(INFINITY) = -nan
    FE_INVALID raised

Siehe auch

sinsinfsinl (C++11)(C++11)	berechnet Sinus (\({\small\sin{x}}\)sin(x)) (Funktion)
tantanftanl (C++11)(C++11)	berechnet Tangens (\({\small\tan{x}}\)tan(x)) (Funktion)
acosacosfacosl (C++11)(C++11)	berechnet Arkuskosinus (\({\small\arccos{x}}\)arccos(x)) (Funktion)
cos(std::complex)	berechnet den Kosinus einer komplexen Zahl (\({\small\cos{z}}\)cos(z)) (function template)
cos(std::valarray)	wendet die Funktion std::cos auf jedes Element von valarray an (function template)
C-Dokumentation für cos