Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 constraint

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

Fontes