Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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 constraint

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

Zdroje