Python根据阿拉伯数字生成圆圈数字的完整实现教程详解

def num_to_circle_char(n: int) -> str:
    """
    阿拉伯数字 1~20 转换为圆圈数字 ①②③…⑳
    :param n: 输入整数，范围 1 ~ 20
    :return: 圆圈单个字符，例 1→①，15→⑮
    """
    # 类型校验
    if not isinstance(n, int):
        raise TypeError("输入必须为整数类型")
    # 范围校验
    if not 1 <= n <= 20:
        raise ValueError("当前仅支持 1 ~ 20 的数字转换圆圈序号")
    # 计算Unicode偏移并转为字符
    code_point = 0x2460 + n - 1
    return chr(code_point)


# 测试代码
if __name__ == "__main__":
    test_list = [1, 5, 10, 13, 18, 20]
    for num in test_list:
        res = num_to_circle_char(num)
        print(f"{num} → {res}")

def num_to_circle_char_safe(n: int, default: str = "") -> str:
    """
    安全版数字转圆圈序号，不抛异常，越界返回默认值
    :param n: 目标数字
    :param default: 超出范围/类型错误时返回内容
    :return: 圆圈字符 / 默认值
    """
    try:
        if not isinstance(n, int):
            return default
        if 1 <= n <= 20:
            code_point = 0x2460 + n - 1
            return chr(code_point)
        return default
    except Exception:
        return default

# 测试越界、非法参数
print(num_to_circle_char_safe(21))      # 空
print(num_to_circle_char_safe(0, "无")) # 无
print(num_to_circle_char_safe("abc"))   # 空
print(num_to_circle_char_safe(12))      # ⑫

class ChapterNumUtil:
    digits = ["", "一", "二", "三", "四", "五", "六", "七", "八", "九"]

    @classmethod
    def num_to_plain_chinese(cls, n: int) -> str:
        """纯中文数字：1→一、15→十五、100→一百"""
        if not isinstance(n, int) or n < 1 or n > 100:
            raise ValueError("仅支持1~100整数")
        if n == 100:
            return "一百"
        ten = n // 10
        unit = n % 10
        if ten == 0:
            return cls.digits[unit]
        elif ten == 1:
            return "十" if unit == 0 else f"十{cls.digits[unit]}"
        else:
            return f"{cls.digits[ten]}十" if unit == 0 else f"{cls.digits[ten]}十{cls.digits[unit]}"

    @classmethod
    def num_to_chinese_article_title(cls, n: int) -> str:
        """第X篇：1→第一篇"""
        return f"第{cls.num_to_plain_chinese(n)}篇"

    @classmethod
    def num_to_chinese_part_title(cls, n: int) -> str:
        """第X部分：1→第一部分"""
        return f"第{cls.num_to_plain_chinese(n)}部分"

    @classmethod
    def num_to_circle_char(cls, n: int) -> str:
        """圆圈序号：1→①，上限20"""
        if not isinstance(n, int) or not 1 <= n <= 20:
            raise ValueError("圆圈序号仅支持1~20")
        return chr(0x2460 + n - 1)

    @classmethod
    def num_to_circle_char_safe(cls, n: int, default="") -> str:
        """无异常安全版圆圈序号"""
        try:
            return cls.num_to_circle_char(n)
        except (TypeError, ValueError):
            return default


# 统一调用示例
if __name__ == "__main__":
    util = ChapterNumUtil
    print(util.num_to_chinese_article_title(3))   # 第三篇
    print(util.num_to_chinese_part_title(12))      # 第十二部分
    print(util.num_to_circle_char(7))              # ⑦
    print(util.num_to_circle_char(19))             # ⑲
    print(util.num_to_circle_char_safe(99, "超出范围")) # 超出范围

article = ChapterNumUtil.num_to_chinese_article_title(2)
circle = ChapterNumUtil.num_to_circle_char(2)
print(f"{article}\n    4.1 管理要求\n        {circle} 业务办理流程")

circle_list = [num_to_circle_char(i) for i in range(1, 21)]
print(circle_list)
# ['①', '②', '③', '④', '⑤', '⑥', '⑦', '⑧', '⑨', '⑩', '⑪', '⑫', '⑬', '⑭', '⑮', '⑯', '⑰', '⑱', '⑲', '⑳']