microPython的源码解析之 modcmath.c

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

microPython Python最小内核源码解析
以下是您提供的代码，我已经将其翻译为中文，并添加了一些额外的注释以帮助理解代码的功能和结构。

#include "py/builtin.h"

#if MICROPY_PY_BUILTINS_FLOAT && MICROPY_PY_BUILTINS_COMPLEX && MICROPY_PY_CMATH

#include <math.h>

// phase(z): 返回复数z的相位，范围在(-π, +π]之间
static mp_obj_t mp_cmath_phase(mp_obj_t z_obj) {
   
    mp_float_t real, imag;
    // 从复数对象z_obj中获取实部和虚部
    mp_obj_get_complex(z_obj, &real, &imag);
    // 使用atan2函数计算相位，返回值在(-π, +π]之间
    return mp_obj_new_float(MICROPY_FLOAT_C_FUN(atan2)(imag, real));
}
static MP_DEFINE_CONST_FUN_OBJ_1(mp_cmath_phase_obj, mp_cmath_phase);

// polar(z): 返回复数z的极坐标形式，结果为一个元组
static mp_obj_t mp_cmath_polar(mp_obj_t z_obj) {
   
    mp_float_t real, imag;
    mp_obj_get_complex(z_obj, &real, &imag);
    mp_obj_t tuple[2] = {
   
        // 计算复数的模
        mp_obj_new_float(MICROPY_FLOAT_C_FUN(sqrt)(real * real + imag * imag)),
        // 计算复数的相位
        mp_obj_new_float(MICROPY_FLOAT_C_FUN(atan2)(imag, real)),
    };
    return mp_obj_new_tuple(2, tuple);
}
static MP_DEFINE_CONST_FUN_OBJ_1(mp_cmath_polar_obj, mp_cmath_polar);

// rect(r, phi): 返回具有模r和相位phi的复数
static mp_obj_t mp_cmath_rect(mp_obj_t r_obj, mp_obj_t phi_obj) {
   
    mp_float_t r = mp_obj_get_float(r_obj);
    mp_float_t phi = mp_obj_get_float(phi_obj);
    // 使用cos和sin函数构造复数
    return mp_obj_new_complex(r * MICROPY_FLOAT_C_FUN(cos)(phi), r * MICROPY_FLOAT_C_FUN(sin)(phi));
}
static MP_DEFINE_CONST_FUN_OBJ_2(mp_cmath_rect_obj, mp_cmath_rect);

// exp(z): 返回复数z的指数函数
static mp_obj_t mp_cmath_exp(mp_obj_t z_obj) {
   
    mp_float_t real, imag;
    mp_obj_get_complex(z_obj, &real, &imag);
    mp_float_t exp_real = MICROPY_FLOAT_C_FUN(exp)(real);
    // 利用欧拉公式计算指数函数
    return mp_obj_new_complex(exp_real * MICROPY_FLOAT_C_FUN(cos)(imag), exp_real *