std::forward

 

C++

Sprache

Concepts

Utilities-Bibliothek

Strings Bibliothek

Container-Bibliothek

Algorithmen-Bibliothek

Iteratoren Bibliothek

Numerik-Bibliothek

Input / Output-Bibliothek

Lokalisierungen Bibliothek

Reguläre Ausdrücke Bibliothek(C++11)

Atomare Operationen Bibliothek(C++11)

Thread Support-Bibliothek(C++11)

 

Utilities-Bibliothek

Typen Unterstützung (basic types, RTTI, type traits)

Dynamische Speicherverwaltung

Fehlerbehandlung

Programm Unterstützung

Variadic Funktionen

Datum und Uhrzeit

Funktionsobjekte

initializer_list (C++11)

bitset

hash (C++11)

Relationale Operatoren

rel_ops::operator!= rel_ops::operator> rel_ops::operator<= rel_ops::operator>=

Paare und Tupel

pair

tuple (C++11)

piecewise_construct_t (C++11)

piecewise_construct (C++11)

Swap, forward und move

swap

forward (C++11)

move (C++11)

move_if_noexcept (C++11)

declval (C++11)

 

definiert in Header <utility>
template<class T > T&& forward(typenamestd::remove_reference<T>::type& t );	(1)	(seit C++11)
template<class T > T&& forward(typenamestd::remove_reference<T>::type&& t );	(2)	(seit C++11)

Wenn nach dem folgenden Rezept in einer Funktions-Template, leitet das Argument einer anderen Funktion genau wie an die aufrufende Funktion übergeben wurde verwendet .

Original:

When used according to the following recipe in a function template, forwards the argument to another function exactly as it was passed to the calling function.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

template<typename T> wrapper(T&& arg){ foo(std::forward<T>(arg));}

• Wenn ein Aufruf an wrapper() übergibt ein rvalue std::string, dann T wird std::string (nicht std::string&, const std::string& oder std::string&&) abgeleitet und std::forward sichergestellt, dass ein R-Wert auf foo übergeben wird .

  Original:

  If a call to wrapper() passes an rvalue std::string, then T is deduced to std::string (not std::string&, const std::string&, or std::string&&), and std::forward ensures that an rvalue reference is passed to foo.

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• Wenn ein Aufruf an wrapper() übergibt einen const lvalue std::string, dann T wird const std::string& abgeleitet und std::forward sichergestellt, dass ein const lvalue Verweis auf foo übergeben wird .

  Original:

  If a call to wrapper() passes a const lvalue std::string, then T is deduced to const std::string&, and std::forward ensures that a const lvalue reference is passed to foo.

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• Wenn ein Aufruf an wrapper() übergibt eine nicht konstante Lvalue std::string, dann wird Tstd::string& abgeleitet und std::forward sichergestellt, dass ein nicht-const Lvalue Bezugnahme auf foo geleitet wird .

  Original:

  If a call to wrapper() passes a non-const lvalue std::string, then T is deduced to std::string&, and std::forward ensures that a non-const lvalue reference is passed to foo.

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.

Notes

Der Versuch, einen rvalue als Lvalue, wie durch Instanziieren der Form 2) mit lvalue Referenz-Typ T weiterzuleiten, ist ein Compiler-Fehler .

Original:

Attempting to forward an rvalue as an lvalue, such as by instantiating the form 2) with lvalue reference type T, is a compile-time error.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Parameter

t

-

das Objekt weitergeleitet werden soll Original: the object to be forwarded The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

Rückgabewert

static_cast<T&&>(t)

Ausnahmen

noexcept specification:  

noexcept

  (seit C++11)

Beispiel

Dieses Beispiel demonstriert perfekte Weiterleitung der Parameter der Funktion make_unique (), um das Argument des Konstruktors der Klasse T

Original:

This example demonstrates perfect forwarding of the parameter of the function make_unique() to the argument of the constructor of class T

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

#include <iostream>#include <memory>#include <utility>   struct A { A(int&& n){std::cout<<"rvalue overload, n="<< n <<"\n";} A(int& n){std::cout<<"lvalue overload, n="<< n <<"\n";}};   template<class T, class U>std::unique_ptr<T> make_unique(U&& u){returnstd::unique_ptr<T>(new T(std::forward<U>(u)));}   int main(){std::unique_ptr<A> p1 = make_unique<A>(2);// rvalueint i =1;std::unique_ptr<A> p2 = make_unique<A>(i);// lvalue}

Output:

rvalue overload, n=2 lvalue overload, n=1

Komplexität

Constant

Original:

Constant

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Siehe auch

move (C++11)	erhält einen rvalue Referenz Original: obtains an rvalue reference The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (Funktions-Template)
move_if_noexcept (C++11)	erhält eine rvalue Referenz, wenn der Umzug Konstruktor nicht werfen wird Original: obtains an rvalue reference if the move constructor does not throw The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (Funktions-Template)