CKTIS / C++
std::apply: wywołanie funkcji elementami krotki
std::apply rozwija elementy obiektu tuple-like do argumentów obiektu wywoływalnego i zwraca wynik tego wywołania.
Wersja: C++23
Składnia
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> wywołuje std::invoke(f, get<0>(t), ..., get<N-1>(t)). W C++23 parametr Tuple spełnia ekspozycyjne ograniczenie tuple-like biblioteki; obsługiwane są standardowe typy tuple-like, takie jak std::tuple, std::pair i std::array. Samo dodanie własnych specjalizacji tuple_size i get nie gwarantuje, że dowolny typ użytkownika będzie obsługiwany. Zwracany jest dokładny wynik wywołania, także void.
Użyj jej, gdy argumenty są już zapakowane w krotkę. Rozwijanie odbywa się według rozmiaru znanego w czasie kompilacji, a nie przez pętlę czasu działania. Kategorie wartości elementów są przekazywane zgodnie z kategorią przekazanej krotki.
Każdy element musi tworzyć poprawne wywołanie obiektu f; błędna liczba lub typ argumentów jest błędem kompilacji. Przeniesienie krotki może przekazać jej elementy jako r-wartości. Wyjątki z wywoływanej funkcji nie są przechwytywane.
Przykłady
#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';
}
Wynik
7
std::apply → 7