WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

return — eine Funktion beenden und ein Ergebnis zurückgeben

Die return-Anweisung beendet den aktuellen Funktionsaufruf und übergibt die Steuerung an den Aufrufer. Sie kann außerdem einen zurückgegebenen Wert oder eine Referenz initialisieren. Sie ist nicht mit break gleichzusetzen: Innerhalb einer Schleife verlässt sie die gesamte Funktion.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

return;
return expression;
return { initializer-list };

return übergibt die Steuerung von der aktuellen Funktion an ihren Aufrufer. Der Operand in return expression; oder return { initializer-list }; initialisiert entsprechend dem Rückgabetyp der Funktion die zurückgegebene Referenz oder das Ergebnisobjekt; dabei muss nicht notwendigerweise eine Kopie erstellt werden. Anders als break verlässt return innerhalb einer Schleife die gesamte Funktion.

return; ist in einer void-Funktion, einem Konstruktor oder einem Destruktor zulässig. Eine void-Funktion kann auch return expression; verwenden, wenn der Ausdruck den Typ void hat. Eine Funktion mit Rückgabewert benötigt einen passenden Operanden und nicht lediglich return;.

Das Ergebnis wird initialisiert, bevor lokale Objekte zerstört werden. Beim Verlassen von Gültigkeitsbereichen werden konstruierte automatische Objekte in umgekehrter Reihenfolge ihrer Konstruktion zerstört. Gib keinen Zeiger und keine Referenz auf ein lokales automatisches Objekt zurück: Nach dessen Zerstörung ist das Ergebnis ungültig.

Das Erreichen des Endes einer gewöhnlichen void-Funktion, eines Konstruktors oder eines Destruktors wirkt wie return;. In einer gewöhnlichen Funktion mit Rückgabewert führt es zu undefiniertem Verhalten; main ist eine Ausnahme, dort entspricht es return 0;. Coroutinen verwenden co_return und nicht return.

Dieser Eintrag bezieht sich auf C++23. Die bereitgestellte Quelle ist ein fortlaufend bearbeiteter Standardentwurf und keine endgültige C++23-Veröffentlichung; spätere Änderungen dürfen nicht automatisch auf diesen Modus übertragen werden. Ein Compiler-Flag im Repository belegt nicht das Laufzeitverhalten in der Produktionsumgebung.

Beispiele

#include <iostream>

int clampNonnegative(int value) {
    if (value < 0) {
        return 0;
    }
    return value;
}

int main() {
    std::cout << clampNonnegative(-3) << ' '
              << clampNonnegative(7) << '\n';
    return 0;
}

Ergebnis

0 7

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen