编辑“︁C++ 函数声明”︁

= C++函数声明 =

== 介绍 ==
'''函数声明'''（Function Declaration）是C++编程中的基础概念，它告诉编译器函数的名称、返回类型以及参数列表（如果有的话）。函数声明也被称为'''函数原型'''（Function Prototype），它允许在函数定义之前调用函数，从而增强代码的可读性和模块化。

函数声明的基本语法如下：
<syntaxhighlight lang="cpp">
返回类型 函数名(参数列表);
</syntaxhighlight>

其中：
* '''返回类型'''：函数执行后返回的数据类型（如 <code>int</code>、<code>double</code>、<code>void</code> 等）。
* '''函数名'''：函数的标识符，遵循C++命名规则。
* '''参数列表'''：可选的输入参数，每个参数由类型和名称组成，多个参数用逗号分隔。

== 为什么需要函数声明？ ==
在C++中，编译器需要知道函数的签名（名称、返回类型和参数）才能正确编译调用该函数的代码。如果函数定义出现在调用之后，编译器会因为找不到函数而报错。函数声明解决了这个问题，它可以在函数定义之前提供必要的信息。

=== 示例：没有函数声明的问题 ===
<syntaxhighlight lang="cpp">
#include <iostream>

int main() {
    int result = add(3, 4); // 错误：编译器不知道 'add' 是什么
    std::cout << "Result: " << result << std::endl;
    return 0;
}

int add(int a, int b) { // 函数定义
    return a + b;
}
</syntaxhighlight>
上述代码会编译失败，因为 <code>add</code> 在调用时尚未声明。

=== 示例：使用函数声明 ===
<syntaxhighlight lang="cpp">
#include <iostream>

int add(int a, int b); // 函数声明

int main() {
    int result = add(3, 4); // 正确：编译器知道 'add' 的签名
    std::cout << "Result: " << result << std::endl;
    return 0;
}

int add(int a, int b) { // 函数定义
    return a + b;
}
</syntaxhighlight>
现在代码可以正常编译和运行，输出：
<pre>
Result: 7
</pre>

== 函数声明的组成部分 ==
函数声明包含以下关键部分：

=== 1. 返回类型 ===
* 可以是基本数据类型（<code>int</code>, <code>double</code>, <code>char</code> 等）、自定义类型或 <code>void</code>（表示不返回任何值）。
* C++11 引入了 <code>auto</code> 和 <code>decltype</code> 用于自动推导返回类型。

=== 2. 函数名 ===
* 遵循C++标识符规则（字母、数字、下划线，不能以数字开头）。
* 建议使用描述性名称（如 <code>calculateAverage</code> 而不是 <code>func1</code>）。

=== 3. 参数列表 ===
* 可以为空（<code>void</code> 或留空），表示函数不接受参数。
* 参数可以有默认值（默认参数必须在声明中指定）。

=== 示例：带默认参数的函数声明 ===
<syntaxhighlight lang="cpp">
#include <iostream>

void printMessage(const char* message = "Hello, World!"); // 声明带默认参数

int main() {
    printMessage(); // 使用默认参数
    printMessage("Custom message"); // 覆盖默认参数
    return 0;
}

void printMessage(const char* message) { // 定义
    std::cout << message << std::endl;
}
</syntaxhighlight>
输出：
<pre>
Hello, World!
Custom message
</pre>

== 函数声明的作用域 ==
函数声明的作用域决定了它在程序中的可见性：
* 在文件顶部声明：全局作用域，整个文件可见。
* 在命名空间或类中声明：受命名空间或类的作用域限制。

=== 示例：命名空间中的函数声明 ===
<syntaxhighlight lang="cpp">
#include <iostream>

namespace Math {
    int add(int a, int b); // 声明在命名空间中
}

int main() {
    int result = Math::add(3, 4); // 通过命名空间访问
    std::cout << "Result: " << result << std::endl;
    return 0;
}

int Math::add(int a, int b) { // 定义
    return a + b;
}
</syntaxhighlight>

== 函数声明 vs 函数定义 ==
初学者容易混淆这两个概念：
* '''函数声明'''：提供函数的签名，不包含实现。
* '''函数定义'''：提供函数的完整实现（包括函数体）。

=== 对比示例 ===
{| class="wikitable"
|-
! 函数声明 !! 函数定义
|-
| <code>int add(int a, int b);</code> || <code>int add(int a, int b) { return a + b; }</code>
|-
| <code>void print();</code> || <code>void print() { std::cout << "Hello"; }</code>
|}

== 高级主题 ==
=== 函数重载 ===
C++允许'''函数重载'''（Function Overloading），即多个函数可以同名但参数列表不同。函数声明必须明确每个重载版本的签名。

<syntaxhighlight lang="cpp">
#include <iostream>

void print(int i); // 重载1
void print(double d); // 重载2
void print(const char* s); // 重载3

int main() {
    print(5); // 调用 print(int)
    print(3.14); // 调用 print(double)
    print("Hello"); // 调用 print(const char*)
    return 0;
}

// 定义
void print(int i) { std::cout << "Integer: " << i << std::endl; }
void print(double d) { std::cout << "Double: " << d << std::endl; }
void print(const char* s) { std::cout << "String: " << s << std::endl; }
</syntaxhighlight>
输出：
<pre>
Integer: 5
Double: 3.14
String: Hello
</pre>

=== 函数指针的声明 ===
函数也可以作为指针传递，声明函数指针的语法如下：
<syntaxhighlight lang="cpp">
返回类型 (*指针名)(参数列表);
</syntaxhighlight>

示例：
<syntaxhighlight lang="cpp">
#include <iostream>

int add(int a, int b) { return a + b; }
int subtract(int a, int b) { return a - b; }

int main() {
    int (*operation)(int, int); // 函数指针声明
    operation = add; // 指向 add
    std::cout << "Add: " << operation(5, 3) << std::endl;
    operation = subtract; // 指向 subtract
    std::cout << "Subtract: " << operation(5, 3) << std::endl;
    return 0;
}
</syntaxhighlight>
输出：
<pre>
Add: 8
Subtract: 2
</pre>

== 实际应用案例 ==
=== 案例1：数学库中的函数声明 ===
数学库（如 <code><cmath></code>）广泛使用函数声明来提供各种数学运算：
<syntaxhighlight lang="cpp">
#include <iostream>
#include <cmath>

int main() {
    double x = 2.0;
    std::cout << "Square root: " << sqrt(x) << std::endl; // sqrt 已声明在 <cmath>
    std::cout << "Power: " << pow(x, 3) << std::endl; // pow 已声明
    return 0;
}
</syntaxhighlight>

=== 案例2：回调机制 ===
函数声明在事件处理或回调机制中非常有用：
<syntaxhighlight lang="cpp">
#include <iostream>

void eventHandler(int eventId); // 声明事件处理函数

void processEvent(void (*handler)(int), int id) { // 接受函数指针
    handler(id); // 调用回调函数
}

int main() {
    processEvent(eventHandler, 1001); // 传递函数指针
    return 0;
}

void eventHandler(int eventId) { // 定义
    std::cout << "Handling event #" << eventId << std::endl;
}
</syntaxhighlight>
输出：
<pre>
Handling event #1001
</pre>

== 总结 ==
* 函数声明是C++中告知编译器函数签名的机制。
* 它包含返回类型、函数名和参数列表。
* 允许在定义前调用函数，支持模块化编程。
* 与函数定义不同，声明不包含实现。
* 高级特性包括重载、默认参数和函数指针。

通过理解函数声明，你可以更好地组织代码并利用C++的强大功能。

[[Category:编程语言]]
[[Category:C++]]
[[Category:C++ 函数]]