return statement

Beendet die aktuelle Funktion und gibt den angegebenen Wert (falls vorhanden) an den Aufrufer zurück.

Syntax

Erklärung

Der Ausdruck oder die braced-init-list (seit C++11) (falls vorhanden) wird als Operand der return -Anweisung bezeichnet.

Wenn die Steuerung das Ende von

• eine Funktion mit dem Rückgabetyp (möglicherweise cv-qualifiziert) void ,
• ein Konstruktor,
• ein Destruktor, oder
• ein Funktion try Block für eine Funktion mit dem Rückgabetyp (möglicherweise cv-qualifiziert) void

ohne auf eine return -Anweisung zu stoßen, wird return ; ausgeführt.

Wenn die Steuerung das Ende der main -Funktion erreicht, wird return 0 ; ausgeführt.

Das Verlassen des Endes einer wertrückgebenden Funktion, außer der main -Funktion und spezifischen Coroutinen (seit C++20) , ohne eine return -Anweisung ist undefiniertes Verhalten.

In einer Funktion, die (möglicherweise cv-qualifiziertes) void zurückgibt, kann die return -Anweisung mit Ausdruck verwendet werden, wenn der Ausdruckstyp (möglicherweise cv-qualifiziert) void ist.

Hinweise

Die Rückgabe als Wert kann die Konstruktion und Kopie/Verschiebung eines temporären Objekts beinhalten, es sei denn, Copy Elision wird verwendet. Insbesondere gelten folgende Bedingungen für Kopie/Verschiebung:

Schlüsselwörter

return , co_return

Beispiel

#include <iostream>
#include <string>
#include <utility>
void fa(int i)
{
    if (i == 2)
        return;
    std::cout << "fa("<< i << ")\n";
} // implizite Rückgabe;
int fb(int i)
{
    if (i > 4)
        return 4;
    std::cout << "fb(" << i << ")\n";
    return 2;
}
std::pair<std::string, int> fc(const char* p, int x)
{
    return {p, x};
}
void fd()
{
    return fa(10); // fa(10) ist ein void-Ausdruck
}
int main()
{
    fa(1); // gibt Argument aus, dann Rückgabe
    fa(2); // macht nichts wenn i == 2, nur Rückgabe
    int i = fb(5); // gibt 4 zurück
    i = fb(i);     // gibt Argument aus, gibt 2 zurück
    std::cout << "i = " << i << '\n'
              << "fc(~).second = " << fc("Hello", 7).second << '\n';
    fd();
}
struct MoveOnly
{
    MoveOnly() = default;
    MoveOnly(MoveOnly&&) = default;
};
MoveOnly move_11(MoveOnly arg)
{
    return arg; // OK. impliziter Move
}
MoveOnly move_11(MoveOnly&& arg)
{
    return arg; // OK seit C++20. impliziter Move
}
MoveOnly&& move_23(MoveOnly&& arg)
{
    return arg; // OK seit C++23. impliziter Move
}

fa(1)
fb(4)
i = 2
fc(~).second = 7
fa(10)

Fehlerberichte

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

Siehe auch

• Copy Elision