return 文 - cppreference.com

現在の関数を終了し、指定された値 (もしあれば) を呼び出し元に返します。

構文

説明

1) expression を評価し、現在の関数を終了し、その expression の結果を、関数の戻り値の型に暗黙に変換した後、呼び出し元に返します。 戻り値の型が void (または cv 修飾された void) の関数では、 expression はオプショナルです。 コンストラクタおよびデストラクタでは、 expression は使用できません。

3,4) コルーチンでは、最終中断点に対して return の代わりにキーワード co_return を使用しなければなりません (詳細についてはコルーチンを参照してください)。

ノート

制御が return 文に遭遇せずに戻り値の型が void (または cv 修飾された void) の関数の終わり、コンストラクタの終わり、デストラクタの終わり、または戻り値の型が void (または cv 修飾された void) の関数の関数 try ブロックの終わりに達した場合は、 return; が実行されます。

制御が main 関数の終わりに達した場合は、 return 0; が実行されます。

return 文なしに値を返す関数 (main を除く) の終わりに達した場合、動作は未定義です。

void を返す関数では、式の型が void であれば、 expression 付きの return 文を使用することができます。

コピー省略が用いられない場合、値の返却は一時オブジェクトの構築とコピー/ムーブが発生することがあります。 具体的には、コピー/ムーブの条件は以下の通りです。

キーワード

return, co_return

例

#include <iostream>
#include <string>
#include <utility>

void fa(int i)
{
    if (i == 2)
         return;
    std::cout << i << '\n';
} // 暗黙の return;

int fb(int i)
{
    if (i > 4)
         return 4;
    std::cout << 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) は void 型の式です。
}

int main()
{
    fa(2); // i==2 の場合は何もせずに return します。
    fa(1); // 引数を表示して return します。
    int i = fb(5); // 4 を return します。
    i = fb(i); // 引数を表示し、 2 を return します。
    std::cout << i << '\n'
              << fc("Hello", 7).second << '\n';
    fd();
}

欠陥報告

以下の動作変更欠陥報告は以前に発行された C++ 標準に遡って適用されました。

関連項目