CKTIS / C++
std::apply: een functie met tuple-elementen aanroepen
std::apply vouwt een tuple-achtig object uit tot argumenten van een aanroepbaar object en geeft het aanroepresultaat terug.
Versie: 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 constraintstd::apply uit <tuple> voert std::invoke(f, get<0>(t), ..., get<N-1>(t)) uit. In C++23 voldoet Tuple aan de alleen voor specificatie gebruikte tuple-like-beperking van de bibliotheek; ondersteunde standaardtypen zijn onder meer std::tuple, std::pair en std::array. Alleen eigen specialisaties van tuple_size en get toevoegen garandeert geen ondersteuning voor een willekeurig gebruikerstype. Het exacte resultaat, ook void, wordt teruggegeven.
Gebruik dit wanneer argumenten al in een tuple zitten. Uitvouwing volgt een tijdens compilatie bekende grootte, niet een runtimelus. Waardecategorieën worden volgens die van het tuple-argument doorgegeven.
Alle elementen moeten een geldige aanroep van f vormen; een verkeerd aantal of type is een compileerfout. Een verplaatste tuple kan rvalues leveren. Uitzonderingen worden doorgegeven.
Voorbeelden
#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';
}
Resultaat
7
std::apply → 7