Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::apply: chiamare una funzione con gli elementi di una tupla

std::apply espande un oggetto tuple-like negli argomenti di un callable e restituisce il risultato della chiamata.

Versione: C++23

Sintassi

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 di <tuple> esegue std::invoke(f, get<0>(t), ..., get<N-1>(t)). In C++23, Tuple soddisfa il vincolo tuple-like solo espositivo della libreria; i tipi standard supportati includono std::tuple, std::pair e std::array. Aggiungere soltanto specializzazioni personalizzate di tuple_size e get non garantisce il supporto di un tipo utente arbitrario. Viene restituito il risultato esatto, incluso void.

Usalo quando gli argomenti sono già impacchettati. L’espansione segue una dimensione nota a compile time, non un ciclo runtime. Le categorie di valore seguono quella della tupla passata.

Tutti gli elementi devono formare una chiamata valida a f; numero o tipi errati sono errori di compilazione. Spostare la tupla può passare rvalue. Le eccezioni della funzione vengono propagate.

Esempi

#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';
}

Risultato

7

std::apply → 7

Fonti