std::atan2(std::valarray)

 

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)

 

std::valarray

Memberfunktionen
valarray::valarray valarray::~valarray valarray::operator= valarray::operator[] valarray::swap valarray::size valarray::resize valarray::sum valarray::min valarray::max valarray::shift valarray::cshift valarray::apply	valarray::operator+valarray::operator-valarray::operator~valarray::operator! valarray::operator+=valarray::operator-=valarray::operator*=valarray::operator/=valarray::operator%=valarray::operator&=valarray::operator|=valarray::operator^=valarray::operator<<=valarray::operator>>=
Nicht-Member-Funktionen
swap(C++11) begin(C++11)   end(C++11) abs exp log log10 pow sqrt sin cos tan asin acos atan atan2 sinh cosh tanh	operator*operator/operator%operator+operator-operator^operator&operator|operator<<operator>>operator&&operator|| operator==operator!=operator<operator>operator<=operator>=
Hilfsklassen
slice_array gslice_array indirect_array	slice gslice mask_array
Deduktionsanleitungen (seit C++17)

 

Definiert in der Header-Datei <valarray>
template< class T > std::valarray<T> atan2( const std::valarray<T>& y, const std::valarray<T>& x );	(1)
template< class T > std::valarray<T> atan2( const std::valarray<T>& y,                         const typename std::valarray<T>::value_type& vx );	(2)
template< class T > std::valarray<T> atan2( const typename std::valarray<T>::value_type& vy,                         const std::valarray<T>& x );	(3)

Berechnet den Arkustangens von y / x unter Verwendung der Vorzeichen der Argumente, um den Quadranten korrekt zu bestimmen.

1) Berechnet den Arkustangens jedes Paares von entsprechenden Werten aus y und x.

Das Verhalten ist undefiniert, wenn x.size() != y.size().

2) Berechnet den Arkustangens von vx und jedem Wert im numerischen Array y.

3) Berechnet den Arkustangens von vy und jedem Wert im numerischen Array x.

Parameter

x, y	-	numerische Arrays, für die der Arkustangens berechnet werden soll
vy, vx	-	Werte, für die der Arkustangens berechnet werden soll

Rückgabewert

Ein numerisches Array, das die Ergebnisse der Arkustangensberechnung enthält.

Anmerkungen

Die nicht qualifizierte Funktion (atan2) wird zur Durchführung der Berechnung verwendet. Wenn eine solche Funktion nicht verfügbar ist, wird aufgrund von argumentabhängiger Suche std::atan2 verwendet.

Die Funktion kann mit einem anderen Rückgabetyp als std::valarray implementiert werden. In diesem Fall hat der Ersatztyp die folgenden Eigenschaften

• Alle const-Mitgliedsfunktionen von std::valarray sind vorhanden.
• std::valarray, std::slice_array, std::gslice_array, std::mask_array und std::indirect_array können aus dem Ersatztyp konstruiert werden.
• Für jede Funktion, die ein const std::valarray<T>& als Argument nimmt (außer begin() und end())(seit C++11), werden identische Funktionen hinzugefügt, die die Ersatztypen nehmen;
• Für jede Funktion, die zwei Argumente vom Typ const std::valarray<T>& annimmt, werden identische Funktionen hinzugefügt, die jede Kombination aus const std::valarray<T>& und Ersatztypen annehmen.
• Der Rückgabetyp fügt nicht mehr als zwei Ebenen von Template-Verschachtelung über den am tiefsten verschachtelten Argumenttyp hinaus hinzu.

Beispiel

Führen Sie diesen Code aus

#include <algorithm>
#include <cmath>
#include <iomanip>
#include <iostream>
#include <valarray>
 
void show(char const* title, const std::valarray<double>& va)
{
    std::cout << title << ' ';
    std::for_each(std::begin(va), std::end(va), [](const double x)
    { 
        std::cout << ' ' << std::right << std::setw(4) << x << "°";
    });
    std::cout << '\n';
}
 
const double pi = std::acos(-1.0); // C++20: std::numbers::pi
 
int main()
{
    auto degrees_to_radians = [](double const& x) { return (pi * x / 180); };
    auto radians_to_degrees = [](double const& x) { return (180 * x / pi); };
 
    const std::valarray<double> degrees{-90, -60, -45, -30, 0, 30, 45, 60, 90};
    const std::valarray<double> radians = degrees.apply(degrees_to_radians);
 
    const auto sin = std::sin(radians);
    const auto cos = std::cos(radians);
 
    show("(1)", std::atan2(sin, cos).apply(radians_to_degrees));
    show("(2)", std::atan2(sin/cos, 1.0).apply(radians_to_degrees));
    show("(3)", std::atan2(1.0, cos/sin).apply(radians_to_degrees));
}

Ausgabe

(1)   -90°  -60°  -45°  -30°    0°   30°   45°   60°   90°
(2)   -90°  -60°  -45°  -30°    0°   30°   45°   60°   90°
(3)    90°  120°  135°  150°    0°   30°   45°   60°   90°

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 3074	C++98	T wird sowohl aus dem Skalar als auch aus dem valarray für (2,3) abgeleitet, was Aufrufe mit gemischten Typen ausschließt	nur T aus dem valarray ableiten

Siehe auch

asin(std::valarray)	wendet die Funktion std::asin auf jedes Element des Valarrays an (function template)
acos(std::valarray)	wendet die Funktion std::acos auf jedes Element des Valarrays an (function template)
atan(std::valarray)	wendet die Funktion std::atan auf jedes Element des Valarrays an (function template)
atan2atan2fatan2l (C++11)(C++11)	Arkustangens, verwendet Vorzeichen zur Bestimmung der Quadranten (Funktion)
arg	gibt den Phasenwinkel zurück (function template)