CKTIS / C++
std::apply: chamar uma função com elementos de um tuplo
std::apply expande um objeto tuple-like como argumentos de um objeto chamável e devolve o resultado da chamada.
Versão: C++23
Sintaxe
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, de <tuple>, efetua std::invoke(f, get<0>(t), ..., get<N-1>(t)). Em C++23, Tuple cumpre a restrição tuple-like apenas expositiva da biblioteca; os tipos padrão suportados incluem std::tuple, std::pair e std::array. Acrescentar apenas especializações próprias de tuple_size e get não garante suporte para um tipo de utilizador arbitrário. É devolvido o resultado exato, incluindo void.
Usa-o quando os argumentos já estão agrupados. A expansão segue um tamanho conhecido na compilação, não um ciclo em execução. As categorias de valor seguem a categoria do tuplo passado.
Todos os elementos devem formar uma chamada válida a f; quantidade ou tipos errados falham na compilação. Mover o tuplo pode passar rvalues. As exceções da função são propagadas.
Exemplos
#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';
}
Resultado
7
std::apply → 7