std::pow(std::valarray)
Von cppreference.com
| Definiert in der Header-Datei <valarray> |
||
| template< class T > std::valarray<T> pow( const std::valarray<T>& base, const std::valarray<T>& exp ); |
(1) | |
| template< class T > std::valarray<T> pow( const std::valarray<T>& base, |
(2) | |
| template< class T > std::valarray<T> pow( const typename std::valarray<T>::value_type& vbase, |
(3) | |
Hebt einen Wert auf eine Potenz.
1) Berechnet die Werte jedes Elements im numerischen Array base, erhoben auf die Potenz, die durch das entsprechende Element des numerischen Arrays exp spezifiziert wird.
Das Verhalten ist undefiniert, wenn base.size() != exp.size().
2) Berechnet die Werte jedes Elements im numerischen Array base, erhoben auf die Potenz vexp.
3) Berechnet die Werte von vbase, erhoben auf die Potenz, die durch die Elemente des numerischen Arrays exp definiert wird.
Inhalt |
[bearbeiten] Parameter
| base | - | Numerisches Array, das die Basiswerte enthält |
| exp | - | Numerisches Array, das die Exponentenwerte enthält |
| vbase | - | Ein Wert, der die Basis definiert |
| vexp | - | Ein Wert, der den Exponenten definiert |
[bearbeiten] Rückgabewert
Ein numerisches Array, das die Ergebnisse der Potenzierung enthält.
[bearbeiten] Hinweise
Die nicht qualifizierte Funktion (pow) wird zur Durchführung der Berechnung verwendet. Wenn eine solche Funktion nicht verfügbar ist, wird std::pow aufgrund von Argument-abhängiger Suche 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.
[bearbeiten] Beispiel
Führen Sie diesen Code aus
#include <cmath> #include <cstddef> #include <iomanip> #include <iostream> #include <valarray> class show { friend std::ostream& operator<<(std::ostream& os, show const& r) { constexpr char const* sup[] { "\u2070", "\u00B9", "\u00B2", "\u00B3", "\u2074", "\u2075", "\u2076", "\u2077", "\u2078", "\u2079" }; for (std::size_t n = 0; n != r.bases.size(); ++n) { os << std::left << r.bases[n] << std::left; if (n < r.exponents.size()) os << sup[r.exponents[n] % 10] << ' '; else os << " "; } if (r.results.size() != 0) { os << '='; for (std::size_t n = 0; n != r.results.size(); ++n) os << ' ' << r.results[n]; } return os << '\n'; } public: std::valarray<int> bases{}, exponents{}, results{}; }; int main() { constexpr int base{2}; constexpr int exponent{5}; const std::valarray<int> bases{1, 2, 3, 4, 5, 6, 7}; const std::valarray<int> exponents{0, 1, 2, 3, 4, 5, 6}; const std::valarray<int> powers1 = std::pow(bases, exponents); const std::valarray<int> powers2 = std::pow(bases, exponent); const std::valarray<int> powers3 = std::pow(base, exponents); std::cout << "pow(const std::valarray<T>& base, const std::valarray<T>& exp); (1)\n" << "base : " << show{bases} << "exp : " << show{exponents} << "pow : " << show{bases, exponents, powers1} << '\n' << "pow(const std::valarray<T>& base, const value_type& vexp); (2)\n" << "base : " << show{bases} << "vexp : " << exponent << '\n' << "pow : " << show{bases, std::valarray<int>(exponent, bases.size()), powers2} << '\n' << "pow(const value_type& vbase, const std::valarray<T>& exp); (3)\n" << "vbase: " << base << '\n' << "exp : " << show{exponents} << "pow : " << show{std::valarray<int>(base, bases.size()), exponents, powers3}; }
Ausgabe
pow(const std::valarray<T>& base, const std::valarray<T>& exp); (1) base : 1 2 3 4 5 6 7 exp : 0 1 2 3 4 5 6 pow : 1⁰ 2¹ 3² 4³ 5⁴ 6⁵ 7⁶ = 1 2 9 64 625 7776 117649 pow(const std::valarray<T>& base, const value_type& vexp); (2) base : 1 2 3 4 5 6 7 vexp : 5 pow : 1⁵ 2⁵ 3⁵ 4⁵ 5⁵ 6⁵ 7⁵ = 1 32 243 1024 3125 7776 16807 pow(const value_type& vbase, const std::valarray<T>& exp); (3) vbase: 2 exp : 0 1 2 3 4 5 6 pow : 2⁰ 2¹ 2² 2³ 2⁴ 2⁵ 2⁶ = 1 2 4 8 16 32 64
[bearbeiten] 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 |
[bearbeiten] Siehe auch
| wendet die Funktion std::sqrt auf jedes Element des Valarrays an (function template) | |
| (C++11)(C++11) |
erhöht eine Zahl zur gegebenen Potenz (xy) (Funktion) |
| komplexe Potenz, ein oder beide Argumente können komplexe Zahlen sein (function template) |
