Namespaces
Variants

    std::binder1st, std::binder2nd

    Depuis fr.cppreference.net
     
    C++
    Support du compilateur
    Autonome et hébergé
    Langage
    Bibliothèque standard
    En-têtes de la bibliothèque standard
    Exigences nommées
    Macros de test de fonctionnalités (C++20)
    Bibliothèque de support du langage
    Bibliothèque de concepts (C++20)
    Bibliothèque de diagnostics
    Bibliothèque de gestion de la mémoire
    Bibliothèque de métaprogrammation (C++11)
    Bibliothèque d'utilitaires généraux
    Bibliothèque de conteneurs
    Bibliothèque d'itérateurs
    Bibliothèque de plages (C++20)
    Bibliothèque d'algorithmes
    Bibliothèque de chaînes
    Bibliothèque de traitement de texte
    Bibliothèque numérique
    Bibliothèque de date et d'heure
    Bibliothèque d'entrée/sortie
    Bibliothèque du système de fichiers (C++17)
    Bibliothèque de support de la concurrence (C++11)
    Bibliothèque de contrôle d'exécution (C++26)
    Spécifications techniques
    Index des symboles
    Bibliothèques externes
     
    Bibliothèque d'utilitaires
    Support du langage
    Support des types (types de base, RTTI)
    Macros de test de fonctionnalités de la bibliothèque (C++20)
    Utilitaires de programme
    Fonctions variadiques
    (C++11)
    (C++20)
    (C++26)
    (C++20)
    Support des coroutines (C++20)
    Support des contrats (C++26)
    Comparaison à trois voies
    (C++20)(C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)    
    (C++20)(C++20)(C++20)    
    (C++20)(C++20)(C++20)

    Utilitaires généraux
    Opérateurs relationnels (obsolète en C++20)
     
    Foncteurs
    Invocation de fonction
    (C++17)(C++23)
    Foncteur identité
    (C++20)
    Enveloppes d'opérateurs transparentes
    (C++14)
    (C++14)
    (C++14)
    (C++14)  
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)

    Anciens binders et adaptateurs
    (jusqu'à C++17*)
    (jusqu'à C++17*)
    (jusqu'à C++17*)
    (jusqu'à C++17*)
    (jusqu'à C++17*)  
    (jusqu'à C++17*)
    (jusqu'à C++17*)(jusqu'à C++17*)(jusqu'à C++17*)(jusqu'à C++17*)
    (jusqu'à C++20*)
    (jusqu'à C++20*)
    (jusqu'à C++17*)(jusqu'à C++17*)
    (jusqu'à C++17*)(jusqu'à C++17*)

    (jusqu'à C++17*)
    (jusqu'à C++17*)(jusqu'à C++17*)(jusqu'à C++17*)(jusqu'à C++17*)
    (jusqu'à C++20*)
    (jusqu'à C++20*)
     
    Défini dans l'en-tête <functional> 
    template< class Fn >
class binder1st
    : public std::unary_function<typename Fn::second_argument_type, 
                                 typename Fn::result_type> {
protected:
    Fn op;
    typename Fn::first_argument_type value;
public:
    binder1st( const Fn& fn, 
               const typename Fn::first_argument_type& value );

    typename Fn::result_type 
        operator()(const typename Fn::second_argument_type& x) const;

    typename Fn::result_type 
        operator()(typename Fn::second_argument_type& x) const;
};
    		(1) (obsolète en C++11)
    (supprimé en C++17) 
    template< class Fn >
class binder2nd
    : public std::unary_function<typename Fn::first_argument_type,
                                 typename Fn::result_type> {
protected:
    Fn op;
    typename Fn::second_argument_type value;
public:
    binder2nd( const Fn& fn, 
               const typename Fn::second_argument_type& value );

    typename Fn::result_type 
        operator()(const typename Fn::first_argument_type& x) const;

    typename Fn::result_type 
        operator()(typename Fn::first_argument_type& x) const;
};
    		(2) (obsolète en C++11)
    (supprimé en C++17)

    Un foncteur qui lie un argument à une fonction binaire.

    La valeur du paramètre est passée à l'objet au moment de sa construction et stockée dans l'objet. Lorsque le foncteur est invoqué via operator(), la valeur stockée est passée comme l'un des arguments, l'autre argument étant passé comme argument de operator(). Le foncteur résultant est une fonction unaire.

    1) Lie le premier paramètre à la valeur value donnée lors de la construction de l'objet.
    2) Lie le deuxième paramètre à la valeur value donnée lors de la construction de l'objet.

    Exemple

    Exécuter ce code 
    #include <cmath>
#include <functional>
#include <iostream>
#include <vector>
const double pi = std::acos(-1); // utiliser std::numbers::pi en C++20
int main()
{
    // déprécié en C++11, supprimé en C++17
    auto f1 = std::bind1st(std::multiplies<double>(), pi / 180.0);
    // remplacement C++11
    auto f2 = [](double a) { return a * pi / 180.0; };
    for (double n : {0, 30, 45, 60, 90, 180})
        std::cout << n << "°\t" << std::fixed << "= "
                  << f1(n) << " rad (using binder)\t= "
                  << f2(n) << " rad (using lambda)\n"
                  << std::defaultfloat;
}

    Sortie : 

    0°	= 0.000000 rad (using binder)	= 0.000000 rad (using lambda)
30°	= 0.523599 rad (using binder)	= 0.523599 rad (using lambda)
45°	= 0.785398 rad (using binder)	= 0.785398 rad (using lambda)
60°	= 1.047198 rad (using binder)	= 1.047198 rad (using lambda)
90°	= 1.570796 rad (using binder)	= 1.570796 rad (using lambda)
180°	= 3.141593 rad (using binder)	= 3.141593 rad (using lambda)

    Rapports de défauts

    Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

    DR Appliqué à Comportement tel que publié Comportement correct
    LWG 109 C++98 operator() ne pouvait pas modifier l'argument qui lui était passé surcharges ajoutées pour gérer ce cas

    Voir aussi

    (obsolète en C++11) (supprimé en C++17)
    		lie un argument à une fonction binaire
    (modèle de fonction)