std::asin(std::valarray)

template< class T >
valarray<T> asin( const valarray<T>& va );

Für jedes Element in va wird der Arkussinus des Werts des Elements berechnet.

Parameter

Rückgabewert

Wertearray, das die Arkussinus-Werte der Werte in va enthält.

Hinweise

Unqualifizierte Funktion (asin) wird zur Durchführung der Berechnung verwendet. Falls eine solche Funktion nicht verfügbar ist, wird std::asin aufgrund von argumentabhängiger Namenssuche verwendet.

Die Funktion kann mit einem Rückgabetyp implementiert werden, der sich von std::valarray unterscheidet. In diesem Fall hat der Ersatztyp die folgenden Eigenschaften:

• Alle const Memberfunktionen von std::valarray werden bereitgestellt.
• 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>& nimmt, mit Ausnahme von begin() und end()(seit C++11), sollen identische Funktionen hinzugefügt werden, die die Ersatztypen nehmen;
• Für jede Funktion, die zwei const std::valarray<T>& Argumente nimmt, sollen identische Funktionen hinzugefügt werden, die jede Kombination aus const std::valarray<T>& und Ersatztypen nehmen.
• Der Rückgabetyp fügt nicht mehr als zwei Ebenen von Template-Verschachtelung über dem am tiefsten verschachtelten Argumenttyp hinzu.

Mögliche Implementierung

template<class T>
valarray<T> asin(const valarray<T>& va)
{
    valarray<T> other = va;
    for (T& i : other)
        i = asin(i);
    return other; // Proxy-Objekt kann zurückgegeben werden
}

Beispiel

#include <cmath>
#include <iostream>
#include <numbers>
#include <valarray>
int main()
{
    // verwende gemeinsame y-Werte vom Einheitskreis
    const double s22 = std::sqrt(2.0) / 2.0;
    const double s32 = std::sqrt(3.0) / 2.0;
    const std::valarray<double> v1 =
        {-1.0, -s32, -s22, -0.5,  0.0,  0.5, s22,  s32,  1.0};
    // fülle mit Ergebnissen der Bogenmaß-zu-Grad-Konvertierung
    const std::valarray<double> v2 = 
        std::asin(v1) * 180.0 / std::numbers::pi;
    for (std::cout << std::showpos; double n : v2)
        std::cout << n << "° ";
    std::cout << '\n';
}

-90° -60° -45° -30° +0° +30° +45° +60° +90°

Siehe auch