Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

return — terminar uma função e devolver um resultado

A instrução return termina a chamada à função atual e transfere o controlo para quem a chamou. Também pode inicializar um valor ou uma referência devolvidos. Não equivale a break: dentro de um ciclo, sai de toda a função.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

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

return transfere o controlo da função atual para quem a chamou. O operando de return expression; ou return { initializer-list }; inicializa a referência devolvida ou o objeto resultado de acordo com o tipo de retorno da função; isto não implica necessariamente uma cópia. Ao contrário de break, return dentro de um ciclo sai de toda a função.

return; é permitido numa função void, num construtor ou num destrutor. Uma função void também pode usar return expression; se a expressão for do tipo void. Uma função que devolve um valor requer um operando compatível, e não apenas return;.

O resultado é inicializado antes de os objetos locais serem destruídos. Ao sair dos âmbitos, os objetos automáticos construídos são destruídos pela ordem inversa à da construção. Não devolva um ponteiro nem uma referência para um objeto automático local: depois de esse objeto ser destruído, o resultado fica pendente.

Atingir o fim de uma função void normal, de um construtor ou de um destrutor equivale a return;. Numa função normal que devolve um valor, provoca comportamento indefinido; main é uma exceção, sendo nesse caso equivalente a return 0;. As corrotinas usam co_return, não return.

Esta entrada diz respeito a C++23. A fonte fornecida é um projeto de trabalho em evolução, não uma publicação C++23 definitiva; as alterações posteriores não devem ser aplicadas automaticamente a este modo. Uma opção do compilador no repositório não atesta o comportamento em execução no ambiente de produção.

Exemplos

#include <iostream>

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

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

Resultado

0 7

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes