终止当前函数并返回指定值（若存在）给调用方函数。

语法

解释

1) 对 表达式 求值，终止当前函数，并将 表达式 隐式转换到函数返回类型后的结果返回给调用方。表达式 在返回类型为（可有 cv 限定的）void 的函数中、构造函数中和析构函数中可选。

2) 使用复制列表初始化对函数的返回值进行构造。

3,4) 在协程中，对于最终暂停点，必须用关键字 co_return 取代 return（细节见协程）。

注解

若控制流抵达返回 void（可有 cv 限定）的函数结尾，构造函数结尾，析构函数结尾，或返回 void（可有 cv 限定）的函数的函数 try 块结尾，则执行 return;。

若控制流抵达 main 函数的结尾，则执行 return 0;。

控制流出有返回值的函数（除了 main）的结尾而不经过 return 语句是未定义行为。

在返回 void 的函数中，当表达式类型为 void 时，可以使用带 表达式 的 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 时无动作
    fa(1); // 打印其实参，然后返回
    int i = fb(5); // 返回 4
    i = fb(i); // 打印其实参，返回 2
    std::cout << i << '\n'
              << fc("Hello", 7).second << '\n';
    fd();
}

输出：

1
4
2
7
10

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。