Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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 constraint

std::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

Źródła