Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::apply : appeler une fonction avec les éléments d’un tuple

std::apply développe un objet de type tuple en arguments d’un appelable et renvoie le résultat de cet appel.

Version : 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 de <tuple> effectue std::invoke(f, get<0>(t), ..., get<N-1>(t)). En C++23, Tuple satisfait la contrainte tuple-like d’exposition de la bibliothèque ; les types standard pris en charge comprennent std::tuple, std::pair et std::array. Ajouter seulement des spécialisations personnalisées de tuple_size et get ne garantit pas la prise en charge d’un type utilisateur arbitraire. Le résultat exact, y compris void, est renvoyé.

Utilise-le lorsque les arguments sont déjà regroupés dans un tuple. Le développement suit une taille connue à la compilation, pas une boucle d’exécution. Les catégories de valeurs suivent celle du tuple transmis.

Tous les éléments doivent former un appel valide de f ; un nombre ou type incorrect est une erreur de compilation. Déplacer le tuple peut fournir des rvalues. Les exceptions de la fonction appelée se propagent.

Exemples

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

Résultat

7

std::apply → 7

Sources