WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::apply: eine Funktion mit Tupelelementen aufrufen

std::apply erweitert ein tuple-artiges Objekt zu Argumenten eines aufrufbaren Objekts und liefert dessen Ergebnis.

Version: C++23

Syntax

template<class F, tuple-like Tuple>
constexpr decltype(auto) apply(F&& function, Tuple&& tuple);

// tuple-like is an exposition-only C++23 library constraint

std::apply aus <tuple> führt std::invoke(f, get<0>(t), ..., get<N-1>(t)) aus. In C++23 erfüllt Tuple die nur zur Beschreibung dienende tuple-like-Beschränkung der Bibliothek; unterstützt werden Standardtypen wie std::tuple, std::pair und std::array. Eigene Spezialisierungen von tuple_size und get garantieren nicht, dass ein beliebiger Benutzertyp unterstützt wird. Das genaue Aufrufergebnis, auch void, wird geliefert.

Nutze die Funktion, wenn Argumente bereits in einem Tupel stecken. Die Erweiterung folgt einer zur Compilezeit bekannten Größe und ist keine Laufzeitschleife. Wertkategorien der Elemente werden entsprechend dem Tupelargument weitergereicht.

Alle Elemente müssen einen gültigen Aufruf von f bilden; falsche Anzahl oder Typen sind Compilefehler. Ein verschobenes Tupel kann Elemente als R-Werte liefern. Ausnahmen des Aufrufs werden weitergegeben.

Beispiele

#include <iostream>
#include <tuple>

int main() {
    const auto values = std::tuple{2, 5};
    const int sum = std::apply([](int left, int right) { return left + right; }, values);
    std::cout << sum << '\n';
}

Ergebnis

7

std::apply → 7

Quellen