return 语句

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

日期和时间工具

字符串库

算法

数值

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

C 语言

 

语句

标号

label : statement

表达式语句

expression ;

复合语句

{ statement... }

选择语句

if

switch

迭代语句

while

do-while

for

跳转语句

break

continue

return

goto

 

终止当前函数并返回指定值给调用方函数。

语法

属性说明符序列(可选) return 表达式 ;	(1)
属性说明符序列(可选) return ;	(2)

表达式	-	用于初始化函数返回值的表达式
属性说明符序列	-	(C23)可选的属性列表，应用到 return 语句

解释

1) 求值 表达式 ，终止当前函数，并返回 表达式 的结果给调用方（返回值成为函数调用表达式的值）。仅对函数返回类型非 void 的情形合法。

2) 终止当前函数。仅对函数返回类型为 void 的情形合法。

若 表达式 的类型异于函数的返回类型，则如同赋值一般转换其值为对象，对象类型为函数的返回类型，除了容许对象表示间的重叠：

struct s { double i; } f(void); // 函数返回 struct s
union { struct { int f1; struct s f2; } u1;
        struct { struct s f3; int f4; } u2; } g;
struct s f(void)
{
    return g.u1.f2;
}
int main(void)
{
// g.u2.f3 = g.u1.f2; // 未定义行为（赋值中重叠）
   g.u2.f3 = f();     // 良好定义
}

若返回类型是实浮点类型，则结果可能拥有比新类型所隐含者更大的范围和精度的表示。

抵达返回 void 的函数的末尾等价于 return;。若函数结果用于表达式，则抵达任何其他返回值的函数的结尾为未定义行为（允许舍弃这种返回值）。对于 main，见 main 函数。

在不返回函数中执行 return 语句是未定义行为。

(C11 起)

关键词

return

示例

运行此代码

#include <stdio.h>
 
void fa(int i)
{
    if (i == 2)
       return;
    printf("fa():   %d\n", i);
} // 隐含return;
 
int fb(int i)
{
    if (i > 4)
       return 4;
    printf("fb():   %d\n", i);
    return 2;
}
 
int main(void)
{
    fa(2);
    fa(1);
    int i = fb(5);   // 返回值 4 用于初始化 i
    i = fb(i);       // 返回值 2 用作赋值的右运算数
    printf("main(): %d\n", i);
}

输出：

fa():   1
fb():   4
main(): 2

引用

• C17 标准（ISO/IEC 9899:2018）：

• 6.8.6.4 The return statement (p: 111-112)

• C11 标准（ISO/IEC 9899:2011）：

• 6.8.6.4 The return statement (p: 154)

• C99 标准（ISO/IEC 9899:1999）：

• 6.8.6.4 The return statement (p: 139)

• C89/C90 标准（ISO/IEC 9899:1990）：

• 3.6.6.4 The return statement