内联函数的前向声明

Question

我有一个头文件，其中将包含大量（30+）内联函数。

我不想让读者滚动或搜索内联函数的定义（实现），而是希望有一个前向声明部分来声明函数声明以及描述该函数的注释。本节将允许读者了解如何使用函数或查找函数，而无需向下滚动到实现。

另外，我希望读者养成使用函数的习惯，而无需查看其实现。

独立函数的前向声明的语法是什么？

{这适用于 C99 和 C++}

仅供参考，我正在使用 IAR Workbench C 编译器设置为使用 C99。

Answer 1

与非内联函数没有什么不同：

void func();       // "forward" declaration

// ...

inline void func() // definition
{
    // impl
}

通常，用于向库使用者“隐藏”定义的模式是将声明放在一个标头 (ah) 中，并将定义放在第二个标头 (< code>a_def.h)，然后让前者 #include 后者（为简洁起见，省略了包含防护）：

// a.h
void func();
#include "a_def.h"

// a_def.h
inline void func()
{
    // impl
}

库使用者只需 #include.

Answer 2

您不需要“转发声明”它（该术语通常仅适用于类型，因为我们通常在首先声明它们的同一位置定义它们）。

只需像平常一样声明它即可：

#include <iostream>

void foo();            // Declaration

inline void foo() {    // Defining declaration
   std::cout << "!";
}

// ---------------------------------------------

int main() {
   foo();              // Output: foo()
}

现场演示。

Answer 3

要同时使用 C++ 和 C99，请将声明也设为内联，如下所示：

// declaration
inline void foo(void);

// implementation 
inline void foo(void) {
    print("foo");
}