microPython的源码解析之 parsenumbase.c

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

---

microPython Python最小内核源码解析
NI-motion运动控制c语言示例代码解析
python编程示例系列 python编程示例系列二
python的Web神器Streamlit

---

这段代码是一个C语言函数，用于解析一个字符串表示的数字，并确定其基数（进制）。函数首先检查字符串的长度和内容，以识别是否有特定的前缀（如’0x’表示十六进制，'0o’表示八进制，'0b’表示二进制）。根据前缀，函数设置变量base的值为相应的进制数。如果没有识别出前缀，或者前缀不符合预期的格式，函数将默认数字的基数为十进制（即base设置为10）。函数最后返回已读取的前缀长度，以便后续处理数字的主体部分。

#include "py/mpconfig.h"
#include "py/misc.h"
#include "py/parsenumbase.h"

// 确定实际的基数，并去除前缀'0x', '0o'和'0b'
// 将基数放入*base，并返回要跳过的前缀字节数
size_t mp_parse_num_base(const char *str, size_t len, int *base) {
   
    const byte *p = (const byte *)str; // 将字符串转换为字节指针
    if (len <= 1) {
   
        goto no_prefix; // 如果字符串长度小于等于1，直接跳转到no_prefix标签
    }
    unichar c = *(p++); // 读取第一个字符
    if ((*base == 0 || *base == 16) && c == '0') {
    // 如果基数为0或16，并且第一个字符是'0'
        c = *(p++); // 读取下一个字符
        if ((c | 32) == 'x') {
    // 如果下一个字符是小写或大写的'x'
            *base = 16; // 设置基数为16
        } else if (*base == 0 && (c | 32) == 'o') {
    // 如果基数为0，并且下一个字符是小写或大写的'o'
            *base = 8; // 设置基数为8
        } else if (*base == 0 && (c | 32) == 'b') {
    // 如果基数为0，并且下一个字符是小写或大写的'b'
            *base = 2; // 设置基数为2
        } else {
   
            if (*base == 0) {
   
                *base = 10; // 如果基数仍为0，则默认设置为10
            }
            p -= 2; // 回退两个字符的位置
        }
    } else if (*base == 8 && c == '0') {
    // 如果基数为8，并且第一个字符是'0'
        c = *(p++); // 读取下一个字符
        if ((c | 32) != 'o') {
    // 如果下一个字符不是小写或大写的'o'
            p -= 2; // 回退两个字符的位置
        }
    } else if (*base == 2 && c == '0') {
    // 如果基数为2，并且第一个字符是'0'
        c = *(p++); // 读取下一个字符
        if ((c | 32) != 'b') {
    // 如果下一个字符不是小写或大写的'b'
            p -= 2; // 回退两个字符的位置
        }
    } else {
   
        p--; // 如果不满足以上情况，回退一个字符的位置
    }
no_prefix: // 无前缀标签
    if (*base == 0) {
   
        *base = 10; // 如果基数仍为0，则默认设置为10
    }
    return p - (const byte *)str; // 返回已经读取的前缀长度
}

函数名称：mp_parse_num_base
功能描述：该函数用于解析一个字符串表示的数字，并识别其基数（进制）。它处理可能的前缀，如0x（十六进制）、0o（八进制）和0b（二进制），并根据这些前缀来设置变量base的值。如果没有明确的进制前缀，或者前缀不符合预期，函数将默认数字的基数为十进制。

执行逻辑：

1. 函数接收三个参数：一个字符串str，字符串的长度len，和一个指向整数的指针base，用于存储识别出的基数。
2. 函数首先将字符串转换为字节指针，并检查字符串的长度。如果长度小于等于1，直接跳转到标签no_prefix。
3. 读取字符串的第一个字符，并根据当前已设置的基数（通过参数base传入）和字符内容，决定是否进入特定的进制识别流程。
4. 如果第一个字符是'0'，并且当前基数为0或16，继续读取下一个字符以识别是否为'x'（十六进制）、'o'（八进制）或'b'（二进制）。
5. 根据识别出的进制，设置base的值，并相应地调整指针位置，以跳过已识别的前缀。
6. 如果第一个字符是'0'，并且当前基数为8或2，同样读取下一