第 7 章 函数

        函数是 C 语言中的重要组成部分，它可以将程序分解为模块，提高代码的可读性和可维护性。函数由函数头和函数体组成，函数头包括函数名、返回值类型和参数列表，函数体包括函数执行的语句块。

---

7.1 函数的定义和调用

        函数是一组一起执行一个任务的语句。每个C程序都至少有一个函数，即主函数main()，所有简单的程序都可以定义其他额外的函数。您可以把代码划分到不同的函数中。如何划分代码到不同的函数中是由您来决定的，但在逻辑上，划分通常是根据每个函数执行一个特定的任务来进行的。

        在C语言中，函数是一种用于执行特定任务的独立代码块。函数可以接受参数并返回一个值。关于函数的定义，有以下几个注意事项：

• 函数由函数头、函数体和返回语句组成。
• 函数头包含函数的返回类型、函数名和参数列表。
• 函数体是一系列的语句，用于实现函数的功能。
• 返回语句用于将函数的结果返回给调用函数。

        使用函数的优点：

• 提高代码的可读性和可维护性：将代码分割成函数，每个函数负责特定的任务，使得代码更加清晰、可读性更高。
• 代码复用：可以在多个地方调用同一个函数，避免了重复编写相同的代码。
• 模块化开发：将程序分割成多个函数，每个函数负责一个具体的功能，便于模块化的开发和维护。

        C语言中的函数通常包括以下几个部分：

7.1.1 函数声明

        在调用函数之前，需要在代码中进行函数声明。函数声明包括函数的名称、返回值类型和参数列表。对于嵌入式C来说，我们一般习惯将函数的声明放在.h文件中，如LCD驱动文件中，lcd.h中可以看到。见下图7-1。

图7-1  函数声明示例

7.1.2 函数定义

        函数定义是实现函数功能的代码块。它包括函数的名称、返回值类型、参数列表和函数体。这里我们以lcd.c文件中lcd_init()函数为例，见下图7-2。

图7-2  lcd_init()函数定义

7.1.3 函数调用

        要使用函数，需要在代码中调用它。函数调用时，会将参数的值传递给函数，并执行函数体中的代码。若函数定义时没有参数，那么可以不用传递参数。这里依然以lcd_init()函数的调用为例，首先我们需要在main.c文件中包含lcd_init()函数声明的文件，即lcd.h，具体示例见下图7-3。

图7-3  函数调用

---

7.2 函数的参数与返回值

7.2.1 参数

        C 语言中的参数传递方式有两种：值传递和引用传递。值传递是指将实参的值传递给形参，形参是实参的副本，在函数内部对形参的修改不会影响实参的值。

        引用传递是指将实参的地址传递给形参，形参是实参的别名，在函数内部对形参的修改会影响实参的值。见下图7-4。

图7-4  函数传参方式

        默认情况下，C 使用传值调用来传递参数。一般来说，这意味着函数内的代码不能改变用于调用函数的实际参数。

• 函数的形式参数：如果函数要使用参数，则必须声明接收参数值的变量。这些变量称为函数的形式参数。形式参数就像函数内的其他局部变量，在进入函数时被创建，退出函数时被销毁。
• 函数的实际参数：当函数被调用时，您向参数传递一个值，这个值被称为实际参数。参数列表包括函数参数的类型、顺序、数量。参数是可选的，即函数可能不包含参数。

        例如，下图7-5为一个使用引用调用方式传递参数的示例。其定义了一个函数 swap，它的作用是交换两个整数的值。

图7-5  swap函数定义

        在调用 swap 函数时，可以传递两个变量的地址作为实参，这样在函数内部就可以通过指针修改变量的值。见下图7-6所示。

图7-6  swap函数调用

7.2.2 返回值

        一个函数可以有返回值，也可以没有返回值。有返回值的函数可以使用return语句返回一个值，没有返回值的函数可以省略return语句。例如：下图7-7定义了一个名为max的函数，它的作用是返回两个整数中较大的一个：

图7-7  max函数定义

        在调用max函数时，可以将返回值赋给一个变量，并使用printf函数输出。见图7-8。

图7-8  max函数调用

---

7.3 可变参数函数

        C 语言中的可变参数函数是指可以接受任意数量和任意类型参数的函数，其参数列表使用省略号 (...) 表示。可变参数函数是通过<stdarg.h>标准库中的一些宏和函数来实现的。这允许你编写接受不定数量参数的函数。

        可变参数函数的参数传递方式是通过栈来实现的。具体来说，当调用可变参数函数时，函数的第一个参数是格式化字符串，它指定了参数的类型和数量。可变参数函数通过 va_start 宏获取可变参数列表的起始地址，并根据格式化字符串逐个获取参数的值。

        以下是在C语言中定义和使用可变参数函数的一般步骤和说明：

7.3.1 包含头文件

        首先需要包含<stdarg.h>头文件，以便能够使用可变参数函数所需的宏和函数。见下图7-9示。

图7-9  包含<stdarg.h>头文件

7.3.2 使用va_list和相关宏定义函数参数列表

        在函数中，我们需要定义一个va_list类型的变量来处理可变参数。然后使用一系列宏来初始化和遍历这个va_list。常用的宏包括：

表1 常见的宏名称及对应宏说明

宏名称	宏说明
va_start	初始化va_list，将其指向参数列表的起始位置。
va_arg	用于获取下一个参数的值。
va_end	清理va_list，确保资源释放。

7.3.3 定义函数签名

        在函数定义中，你可以将一个或多个固定参数放在函数签名中，然后在其中包含可变参数。

void my_printf(const char *format, ...);

        注意：可变参数函数在类型安全性方面容易出现问题，因此在使用时要小心确保参数的数量和类型与函数的期望一致，否则可能会导致运行时错误。

        例如，下图7-10定义了一个可变参数函数 my_printf，它可以按照格式化字符串输出任意类型的参数。

图7-10  可变参数函数示例

在调用 my_printf 函数时，可以按照格式化字符串的要求传递参数。具体实现见下图7-11。

图7-11  格式化字符串传递参数

---

7.4 回调函数

        回调函数是一种在C语言中常用的编程技术，它允许我们将一个函数作为参数（函数指针）传递给另一个函数，并在需要的时候被调用。回调函数通常用于在一个程序中动态地调用另一个程序中的函数。

        在 C 语言中，回调函数通常用于实现事件驱动模型或异步编程模型。例如，当某个事件发生时，可以调用回调函数来处理事件。在回调函数中，可以访问一些全局变量或参数，从而实现对事件的处理。关于回调函数的详细说明如下：

        回调函数需要使用函数指针来声明和定义。函数指针是一个变量，指向函数的内存地址。通过函数指针，我们可以将函数作为参数传递给其他函数。函数指针的声明形式如下：

returnType (*functionPointerName)(parameterType1, parameterType2, ...);

        其中returnType 是函数的返回类型，parameterType1、parameterType2 等是函数的参数类型。

• 回调函数的定义

        要使用回调函数，首先需要定义一个函数，该函数的参数列表中包括一个函数指针，用于接受回调函数的地址。通常，回调函数的原型应该与函数指针的原型匹配。示例如下：

void callbackFunction(int data);

• 函数指针作为参数

        在调用函数时，我们可以将一个函数指针作为参数传递给该函数。这样函数在执行过程中可以调用该函数指针所指向的函数。其示例如下：

void process(int data, void (*callback)(int)) {
    // 执行一些操作
    // 调用回调函数
    callback(data);
}

• 传递回调函数

        接着就可以将回调函数传递给接受回调函数的函数。这样就可以在 process 函数内部调用 callbackFunction。示例如下：

int main()
{
    int data = 42;
    process(data, callbackFunction);
    return 0;
}

• 回调函数的使用场景

        回调函数常用于事件处理、异步编程、排序算法等场景。它使得程序可以根据不同的需求，动态地改变函数的行为。例如，在事件处理中将一个处理用户输入的函数作为回调函数传递给一个事件监听器，当特定事件发生时，监听器会调用回调函数来处理事件。

        回调函数是C语言中强大的工具，可以使代码更模块化和可重用。它允许你将不同的功能分离开来，并以可配置的方式将它们组合在一起。在使用回调函数时，要确保函数指针的原型匹配，以避免类型不匹配的问题。

        下图7-12是一个简单的示例，演示了回调函数的用法：

图7-12  回调函数示例

        在上面的示例中，我们定义了一个回调函数callback，它接收一个整数作为参数，并在控制台打印出这个参数。然后，我们定义了一个接收回调函数作为参数的函数process，它在执行过程中调用了传递进来的回调函数。在main函数中，我们定义了一个整数变量num，然后调用process函数，并将callback函数和num作为参数传递给它。

        这个示例演示了如何使用回调函数，在实际开发中，你可以根据具体的需求来定义自己的回调函数和处理函数。

---

7.5 递归函数

        在C语言中，递归是一种在编程中常用的技术，它允许函数调用自身以解决问题，它可以使问题的解决过程更加简洁和直观。在C语言中，递归函数是一种特殊类型的函数，其主要特征是在函数体内部调用自身，但需要注意递归函数必须包含终止条件，避免程序无限递归。以下是关于C语言递归函数的详细说明：

7.5.1 基本概念

        递归是一种自相似的过程，其中一个问题被分解成一个或多个类似于原问题的子问题。每次递归调用都将问题规模减小，直到达到某个终止条件，这时递归停止并开始返回结果。

7.5.2 递归函数的结构

        递归函数通常包含两个部分：

        1. 递归部分：在函数内部调用自身以解决更小规模的问题；

        2. 终止条件：定义递归结束的条件，即问题规模变得足够小以便直接求解不再递归的条件。

7.5.3 递归函数的示例

        下图7-13是一个计算阶乘的递归函数的示例：

图7-13  计算阶乘的递归函数

        代码解读：在这个示例中，递归部分：函数递归地调用自身；终止条件：n的值减小到1或0，返回1。

7.5.4 递归的使用场景        递归在解决具有自相似结构的问题时非常有用，例如树和图的遍历、搜索和排序算法（如快速排序和归并排序）、数学问题（如斐波那契数列和汉诺塔问题）等。

        注意：在使用递归函数时，必须确保递归过程能够最终收敛到终止条件，否则会导致无限递归，最终引发栈溢出错误。因为每次递归调用都需要保存函数的状态信息，因此递归函数的效率可能较低。

        下图7-14是一个简单的例子，展示了递归函数的使用。

图7-14  递归函数示例

        在上面的例子中，factorial函数用于计算给定数的阶乘。在函数内部，我们首先检查是否达到了终止条件，如果是，则返回1。否则通过调用factorial函数来计算n-1的阶乘，并将结果与n相乘。这样递归会一直进行下去，直到达到终止条件。