microPython的源码解析之 objbool.c

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

microPython Python最小内核源码解析

#include <stdlib.h>  // 引入标准库，提供内存分配等函数

#include "py/runtime.h"  // 引入MicroPython运行时环境的头文件

// 如果定义了MICROPY_OBJ_IMMEDIATE_OBJS，表示布尔值可以直接作为对象处理，不需要额外的表示结构
#if MICROPY_OBJ_IMMEDIATE_OBJS
#define BOOL_VALUE(o) ((o) == mp_const_false ? 0 : 1)  // 定义布尔值的获取方式，如果是mp_const_false对象，则返回0，否则返回1
#else  // 如果没有定义MICROPY_OBJ_IMMEDIATE_OBJS，需要定义布尔对象的结构体
#define BOOL_VALUE(o) (((mp_obj_bool_t *)MP_OBJ_TO_PTR(o))->value)  // 定义布尔值的获取方式，通过对象指针转换获取其内部的值

// 定义布尔对象的结构体
typedef struct _mp_obj_bool_t {
   
    mp_obj_base_t base;  // 继承自基础对象类型
    bool value;  // 布尔值
} mp_obj_bool_t;
#endif

// 定义布尔对象的打印函数
static void bool_print(const mp_print_t *print, mp_obj_t self_in, mp_print_kind_t kind) {
   
    bool value = BOOL_VALUE(self_in);  // 获取布尔值
    // 根据是否启用了MICROPY_PY_JSON宏以及打印类型，决定打印的格式
    if (MICROPY_PY_JSON && kind == PRINT_JSON) {
   
        if (value) {
   
            mp_print_str(print, "true");  // 如果是JSON打印，且值为真，则打印"true"
        } else {
   
            mp_print_str(print, "false");  // 如果是JSON打印，且值为假，则打印"false"
        }
    } else {
   
        if (value) {
   
            mp_print_str(print, "True");  // 如果不是JSON打印，且值为真，则打印"True"
        } else {
   
            mp_print_str(print, "False");  // 如果不是JSON打印，且值为假，则打印"False"
        }
    }
}

// 定义布尔对象的构造函数
static mp_obj_t bool_make_new(const mp_obj_type_t *type_in, size_t n_args, size_t n_kw, const mp_obj_t *args) {
   
    (void)type_in;  // 不使用type_in参数
    mp_arg_check_num(n_args, n_kw, 0, 1, false);  // 检查参数数量，0到1个位置参数，0个关键字参数

    if (n_args == 0) {
   
        return mp_const_false;  // 如果没有参数，则返回假的布尔对象
    } else {
   
        // 根据第一个参数是否为真，创建新的布尔对象
        return