Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

return — ukončení funkce a vrácení výsledku

Příkaz return ukončí aktuální volání funkce a předá řízení volajícímu. Může také inicializovat vracenou hodnotu nebo referenci. Není ekvivalentem break: uvnitř cyklu opustí celou funkci.

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

Syntaxe

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

return předává řízení z aktuální funkce jejímu volajícímu. Operand v return expression; nebo return { initializer-list }; inicializuje vracenou referenci či objekt výsledku podle návratového typu funkce; nemusí to znamenat kopírování. Na rozdíl od break opustí return uvnitř cyklu celou funkci.

return; je povoleno ve funkci void, konstruktoru nebo destruktoru. Funkce void může použít také return expression;, pokud má výraz typ void. Funkce vracející hodnotu vyžaduje odpovídající operand, nikoli pouze return;.

Výsledek se inicializuje před zničením lokálních objektů. Při opuštění rozsahů se vytvořené automatické objekty ničí v opačném pořadí, než byly vytvořeny. Nevracejte ukazatel ani referenci na lokální automatický objekt: po jeho zničení bude výsledek visící.

Dosažení konce běžné funkce void, konstruktoru nebo destruktoru se chová jako return;. V běžné funkci vracející hodnotu způsobuje nedefinované chování; výjimkou je main, kde odpovídá return 0;. Korutiny používají co_return, nikoli return.

Tento záznam se vztahuje k C++23. Dodaný zdroj je průběžně vyvíjený pracovní návrh, nikoli neměnné vydání C++23; pozdější změny se do tohoto režimu nesmějí automaticky přenášet. Příznak kompilátoru v repozitáři nedokládá chování za běhu v produkci.

Příklady

#include <iostream>

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

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

Výsledek

0 7

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje