CKTIS / C++
std::apply: volání funkce prvky n-tice
std::apply rozbalí objekt podobný n-tici do argumentů volatelného objektu a vrátí výsledek volání.
Verze: C++23
Syntaxe
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 z <tuple> provede std::invoke(f, get<0>(t), ..., get<N-1>(t)). V C++23 splňuje Tuple pouze expoziční omezení tuple-like knihovny; podporované standardní typy zahrnují std::tuple, std::pair a std::array. Pouhé přidání vlastních specializací tuple_size a get nezaručuje podporu libovolného uživatelského typu. Vrací se přesný výsledek včetně void.
Použij jej, když jsou argumenty již zabalené. Rozbalení sleduje velikost známou při překladu, nejde o běhovou smyčku. Kategorie hodnot prvků se předají podle kategorie n-tice.
Všechny prvky musí vytvořit platné volání f; chybný počet nebo typ je chyba překladu. Přesun n-tice může předat r-hodnoty. Výjimky volané funkce se šíří dál.
Příklady
#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';
}
Výsledek
7
std::apply → 7