Namespaces
Variants

std::function<R(Args...)>:: operator=

From cppreference.net
C++
Utilities library
Function objects
Function invocation
(C++17) (C++23)
Identity function object
(C++20)
Old binders and adaptors
( until C++17* )
( until C++17* )
( until C++17* )
( until C++17* )
( until C++17* )
( until C++17* )
( until C++17* ) ( until C++17* ) ( until C++17* ) ( until C++17* )
( until C++20* )
( until C++20* )
( until C++17* ) ( until C++17* )
( until C++17* ) ( until C++17* )

( until C++17* )
( until C++17* ) ( until C++17* ) ( until C++17* ) ( until C++17* )
( until C++20* )
( until C++20* )
std::function
function & operator = ( const function & other ) ;
(1) (seit C++11)
function & operator = ( function && other ) ;
(2) (seit C++11)
function & operator = ( std:: nullptr_t ) noexcept ;
(3) (seit C++11)
template < class F >
function & operator = ( F && f ) ;
(4) (seit C++11)
template < class F >
function & operator = ( std:: reference_wrapper < F > f ) noexcept ;
(5) (seit C++11)

Weist ein neues Ziel für std::function zu.

1) Weist eine Kopie des target von other zu, als ob durch Ausführung von function ( other ) . swap ( * this ) ;
2) Verschiebt das Ziel von other zu * this . other befindet sich in einem gültigen Zustand mit einem nicht spezifizierten Wert.
3) Lässt das aktuelle target fallen. * this ist nach dem Aufruf empty .
4) Setzt das target von * this auf das aufrufbare Objekt f , als ob durch Ausführung von function ( std:: forward < F > ( f ) ) . swap ( * this ) ; . Dieser Operator nimmt nicht an der Überladungsauflösung teil, es sei denn f ist Callable für die Argumenttypen Args... und den Rückgabetyp R .
5) Setzt das Ziel von * this auf eine Kopie von f , als ob durch Ausführung von function ( f ) . swap ( * this ) ;

Inhaltsverzeichnis

Parameter

other - ein weiteres std::function Objekt, von dem das Ziel kopiert wird
f - ein Aufrufbares zum Initialisieren des Ziels
Typanforderungen
-
F muss die Anforderungen von Callable erfüllen.

Rückgabewert

* this

Hinweise

Selbst bevor die Allokatorunterstützung in C++17 aus std::function entfernt wurde, verwenden diese Zuweisungsoperatoren den Standardallokator anstelle des Allokators von * this oder des Allokators von other (siehe LWG issue 2386 ).

Beispiel

Diesen Code ausführen 
#include <cassert>
#include <functional>
#include <utility>
int inc(int n) { return n + 1; }
int main()
{
    std::function<int(int)> f1;
    std::function<int(int)> f2(inc);
    assert(f1 == nullptr and f2 != nullptr);
    f1 = f2; // Überladung (1)
    assert(f1 != nullptr and f1(1) == 2);
    f1 = std::move(f2); // Überladung (2)
    assert(f1 != nullptr and f1(1) == 2);
    // f2 befindet sich in gültigem aber unspezifiziertem Zustand
    f1 = nullptr; // Überladung (3)
    assert(f1 == nullptr);
    f1 = inc; // Überladung (4)
    assert(f1 != nullptr and f1(1) == 2);
    f1 = [](int n) { return n + n; }; // Überladung (4)
    assert(f1 != nullptr and f1(2) == 4);
    std::reference_wrapper<int(int)> ref1 = std::ref(inc);
    f1 = ref1; // Überladung (5)
    assert(f1 != nullptr and f1(1) == 2);
}

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR Angewendet auf Veröffentlichtes Verhalten Korrigiertes Verhalten
LWG 2132 C++11 die Überladung ( 4 ) mit einem Callable Objekt könnte mehrdeutig sein eingeschränkt
LWG 2401 C++11 Zuweisungsoperator ( 3 ) von std::nullptr_t nicht als noexcept gefordert gefordert

Siehe auch

ersetzt oder zerstört das Zielobjekt
(öffentliche Elementfunktion von std::move_only_function )
(entfernt in C++17)
weist ein neues Zielobjekt zu
(öffentliche Elementfunktion)