microPython的源码解析之 modmath.c

MicroPython 是一种适用于微控制器和其他受限环境的 Python 编程语言的实现。它旨在提供与 Python 3 语言的紧密兼容，同时考虑到内存和计算资源的限制。MicroPython 库是这门语言的核心组成部分，提供了一系列的模块和函数，使得开发者能够在硬件上执行各种任务。
下面将通过系列文章,逐一解读microPython,以便让读者了解掌握microPython的整个核心逻辑.,以便读者可以透过这个Python的最小内核,掌握Python解析器的核心实现逻辑,学习世界上最优秀的源码设计之一.

microPython Python最小内核源码解析

在这段代码中，我们定义了MicroPython的math模块，其中包括了许多数学函数的绑定，如sqrt、pow、exp、log等，以及一些特殊的数学函数和角度转换函数。我们还定义了如何处理无穷大和NaN的情况，并且提供了一些优化的算法实现。
最后，我们创建了一个模块字典并将其注册到MicroPython中，以便在Python代码中使用这些数学函数。

#include "py/builtin.h" // 导入MicroPython的内置对象和函数定义
#include "py/runtime.h" // 导入MicroPython的运行时环境定义

#if MICROPY_PY_BUILTINS_FLOAT && MICROPY_PY_MATH // 如果启用了浮点数和数学模块

#include <math.h> // 引入C标准库中的数学函数

// M_PI不是math.h标准的一部分，可能未定义
// 通过定义我们自己的常量，确保使用正确的const格式
#define MP_PI MICROPY_FLOAT_CONST(3.14159265358979323846) // 定义圆周率常量
#define MP_PI_4 MICROPY_FLOAT_CONST(0.78539816339744830962) // 定义圆周率的四分之一常量
#define MP_3_PI_4 MICROPY_FLOAT_CONST(2.35619449019234492885) // 定义圆周率的四分之三常量

static NORETURN void math_error(void) {
    // 定义一个数学错误处理函数，不返回
    mp_raise_ValueError(MP_ERROR_TEXT("math domain error")); // 抛出数学域错误
}

// 定义一个通用的一元数学函数调用宏
#define MATH_FUN_1(py_name, c_name) \
    static mp_obj_t mp_math_##py_name(mp_obj_t x_obj) {
      \
        return math_generic_1(x_obj, MICROPY_FLOAT_C_FUN(c_name)); \
    } \
    static MP_DEFINE_CONST_FUN_OBJ_1(mp_math_##py_name##_obj, mp_math_##py_name);

// 定义一个通用的一元数学函数调用宏，返回布尔值
#define MATH_FUN_1_TO_BOOL(py_name, c_name) \
    static mp_obj_t mp_math_##py_name(mp_obj_t x_obj) {
      return mp_obj_new_bool(c_name(mp_obj_get_float(x_obj))); } \
    static MP_DEFINE_CONST_FUN_OBJ_1(mp_math_##py_name##_obj, mp_math_##py_name);

// 定义一个通用的一元数学函数调用宏，返回整数
#define MATH_FUN_1_TO_INT(py_name, c_name) \
    static mp_obj_t mp_math_##py_name(mp_obj_t x_obj) {
      return mp_obj_new_int_from_float(MICROPY_FLOAT_C_FUN(c_name)(mp_obj_get_float(x_obj))); } \
    static MP_DEFINE_CONST_FUN_OBJ_1(mp_math_##py_name##_obj, mp_math_##py_name);

// 定义一个通用的二元数学函数调用宏
#define MATH_FUN_2(py_name, c_name) \
    static mp_obj_t mp_math_##py_name(mp_obj_t x_obj, mp_obj_t y_obj) {
      \
        return math_generic_2(x_obj, y_obj, MICROPY_FLOAT_C_FUN(c_name)); \
    } \
    static MP_DEFINE_CONST_FUN_OBJ_2(mp_math_##py_name##_obj, mp_math_##py_name);

// 定义一个通用的二元数学函数调用宏，接受浮点数和整数参数
#define MATH_FUN_2_FLT_INT(py_name, c_name) \
    static mp_obj_t mp_math_##py_name<