可重入函数

可重入函数（Reentrant Function）是指该函数能够被多个任务或线程安全地调用，即使这些调用是并发执行的。一个可重入函数在任何时刻都可以被中断，然后由另一个任务或线程安全地执行，执行完成后，原来的任务或线程可以继续执行，而不会出现数据错误或不一致的情况。

可重入函数的特点包括：

• 不使用全局和静态数据结构，或者确保对这些数据的访问是安全的。
• 不调用不可重入的函数。
• 在函数执行过程中不持有会导致其他线程或任务阻塞的锁。

可重入函数对于实时操作系统（RTOS）和多线程环境非常重要，因为它们有助于避免并发执行时的数据冲突和不一致性问题。

编写一个可重入函数需要遵循一些基本原则，以确保函数的安全性和稳定性，特别是在多线程或中断驱动的环境中。

1. 避免使用全局或静态变量

全局或静态变量的使用会导致函数在并发环境中共享状态，从而引发数据一致性问题。如果必须使用它们，确保通过互斥锁或其他同步机制来保护它们的访问。

2. 不调用不可重入的函数

确保你调用的任何外部函数也是可重入的。不可重入的函数调用可能会导致数据竞争或死锁。

3. 使用局部变量

局部变量存储在栈上，每个线程或函数调用都有自己的栈，因此局部变量是线程安全的。尽量使用局部变量来保持函数的独立性和重入性。

4. 参数传递

通过参数传递所有需要的数据给函数，而不是依赖于外部的或静态的数据结构。这样可以确保函数的行为只依赖于输入参数，增强了函数的独立性和可重用性。

5. 注意线程安全的库函数

即使是标准库函数，也不一定都是可重入的。在使用时要特别注意，比如strtok()就是一个著名的非可重入函数，而strtok_r()是它的可重入版本。

示例

下面是一个简单的可重入函数示例，该函数计算两个整数的最大公约数（GCD）：

int gcd(int a, int b) {
    if (b == 0) return a;
    return gcd(b, a % b);
}

这个函数是可重入的，因为它只依赖于输入参数，不使用全局或静态变量，也没有调用其他不可重入的函数。