函数声明

来自cppreference.com
< c‎ | language

函数声明引入指代函数的标识符,并可选地指定该函数的参数类型(原型)。函数声明(不同于定义)可以出现于块作用域和文件作用域中。

语法

在函数声明的声明文法中, 类型说明符 序列,可选择地由声明器修饰,指代返回类型(可以是任何异于函数和数组的类型),而 声明符 有三种形式:

非指针声明符 ( 形参列表 ) 属性说明符序列(可选) (1)
非指针声明符 ( 标识符列表 ) 属性说明符序列(可选) (2) (C23 前)
非指针声明符 ( ) 属性说明符序列(可选) (3)

其中

非指针声明符 - 任何无括号指针声明器以外的声明器。包含于此声明器中的标识符是成为函数指代器的标识符。
形参列表 - 为单一关键词 void参数的逗号分隔列表,可以以省略号参数结尾。
标识符列表 - 标识符的逗号分隔列表,仅在声明器被用作旧式函数定义的一部分的情况下可能
属性说明符序列 - (C23)可选的属性列表,应用到函数类型
1) 新式 (C89) 函数声明。此声明不仅引入函数指代器自身,而且还为任何将来的函数调用表达式提供函数原型,强制将使用参数表达式转换成声明参数类型,还有编译时的参数数量检查。
int max(int a, int b); // 声明
int n = max(12.01, 3.14); // OK :从 double 转换到 int
2) (C23 前) 旧式 (K&R) 函数定义。此声明不引入函数原型,且任何将来的函数调用表达式都将进行默认参数提升,而且若实参数量不匹配形参数量则引起未定义行为。
int max();
int max(a, b) 
int a, b; { return a>b?a:b; } // 定义期待 int ;第二个调用是未定义行为
int n = max(true, (char)'a'); // 以二个 int 参数调用 max (提升后)
int n = max(12.01f, 3.14); // 以二个 double 参数调用 max (提升后)
3) 无原型函数声明。此声明不引入原型,除非作为函数定义的一部分,其中它等价于 形参列表 void (C23 起)

解释

函数的返回类型,由 说明符与限定符 中的类型说明符确定,并且像在声明中一样可以由 声明符 修改,它必须是非数组对象类型或类型 void 。若该函数声明不是定义,则返回类型可以为不完整。返回类型不能有 cvr 限定:为构造函数类型的目的,调整任何有限定返回类型为其无限定版本。

void f(char *s);                    // 返回类型为 void
int sum(int a, int b);              // sum 的返回类型为 int.
int (*foo(const void *p))[3];       // 返回类型是指向 3 个 int 的数组的指针
 
double const bar(void);             // 声明 double(void) 类型函数
double (*barp)(void) = bar;         // OK : foop 是指向 double(void) 的指针
double const (*barpc)(void) = barp; // OK : foopc 亦为指向 double(void) 的指针

函数声明器可以与其他声明器联合,只要他们共享其类型说明符和限定符。

int f(void), *fip(), (*pfi)(), *ap[3]; // 声明二个函数和二个对象
inline int g(int), n; // 错误: inline 说明符仅用于函数
typedef int array_t[3];
array_t a, h(); // 错误:数组类型不能作为函数返回类型

若函数声明器出现于任何函数外,则其引入的标识符拥有文件作用域外部链接,除非使用 static 或较前的 static 声明可见。若声明出现于另一函数内,则标识符拥有块作用域(且亦拥有外部或内部链接)。

int main(void)
{
    int f(int); // 外部链接,文件作用域
    f(1); // 定义需要程序的某处可用
}

不是函数定义的一部分的声明中, (C23 前)参数不需要命名:

int f(int, int); // 声明
// int f(int, int) { return 7; } // 错误,参数在定义中必须命名
// C23 中允许此定义。

形参列表 中的每个参数是引入单个变量的声明,变量拥有下列额外属性:

  • 声明器中的标识符是可选的(除非此函数声明是函数定义的一部分) (C23 前)
int f(int, double); // OK
int g(int a, double b); // 也 OK
int f(int, double) { return 1; } // 错误:定义必须命名参数
// C23 中允许此定义。
  • 仅有的得到允许的存储类说明符register ,而在非定义的函数声明中忽略它
int f(static int x); // 错误
int f(int [static 10]); // OK (数组下标的 static 不是存储类说明符)
  • 任何数组类型的参数都被调整到对应的指针类型,若数组声明器的方括号内有限定符,则它具有限定 (C99 起)
int f(int[]); // 声明 int f(int*)
int g(const int[10]); // 声明 int g(const int*)
int h(int[const volatile]); // 声明 int h(int * const volatile)
int x(int[*]); // 声明 int x(int*)
  • 任何函数类型的参数都被调整到对应的指针类型
int f(char g(double)); // 声明 int f(char (*g)(double))
int h(int(void)); // 声明 int h(int (*)(void))
int f(int, ...);
  • 参数不能拥有 void 类型(但可以拥有指向 void 指针类型)。完全由关键词 void 组成的特殊参数列表用于声明不接收参数的函数。
int f(void); // OK
int g(void x); // 错误
  • 任何出现于参数列表中,能被当成 typedef 名或参数名的标识符,都会被当做 typedef 名: int f(size_t, uintptr_t) 被分析成新式声明器,声明一个函数,它接收二个 size_tuintptr_t 类型的未命名参数,而非开始定义接收二个名为“ size_t ”和“ uintptr_t ”的函数的旧式声明器。
  • 参数列表可以拥有不完整类型而且可以用 VLA 记法 [*] (C99 起)(除了在函数定义中,在数组到指针和函数到指针调整后,参数类型必须完整)

属性说明符序列亦能应用到函数参数。

(C23 起)

其他函数调用机制上的细节见函数调用运算符,关于从函数返回,见 return

注解

不同于 C++ 与函数定义 (C23 起),声明器 f()f(void) 拥有不同含义:声明符 f(void) 是新式(原型)声明符,声明函数不接收参数。声明符 f() 是声明函数接收未指定数量的参数的声明符(除非用于函数定义) (C23 起)

int f(void); // 声明:不接收参数
int g(); // 声明:接收未知参数
 
int main(void) {
    f(1); // 编译时错误
    g(2); // 未定义行为
}
 
int f(void) { return 1; ) // 实际定义
int g(a,b,c,d) int a,b,c,d; { return 2; } // 实际定义

和在函数定义中不同,形参列表可以从 typedef 继承

typedef int p(int q, int r); // p 是函数类型 int(int, int)
p f; // 声明 int f(int, int)

C89 中, 说明符与限定符 是可选的,且若省略它,则函数的返回类型默认为 int (可以由 声明符 修改)。

*f() { // 返回 int* 的函数
   return NULL;
}
(C99 前)

缺陷报告

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

缺陷报告 应用于 出版时的行为 正确行为
DR 423 C89 返回类型可以有限定 返回类型被隐式除去限定

引用

  • C17 标准(ISO/IEC 9899:2018):
  • 6.7.6.3 Function declarators (including prototypes) (第 96-98 页)
  • C11 标准(ISO/IEC 9899:2011):
  • 6.7.6.3 Function declarators (including prototypes) (第 133-136 页)
  • C99 标准(ISO/IEC 9899:1999):
  • 6.7.5.3 Function declarators (including prototypes) (第 118-121 页)
  • C89/C90 标准(ISO/IEC 9899:1990):
  • 3.5.4.3 Function declarators (including prototypes)

参阅