#介绍

#特性

• 🚀 支持词、句转换成拼音

• 💪 支持常用简体/繁体中文字符转换成拼音

• 🛠️ 支持常见多音字符转换成拼音

• 🌍 支持 Unicode 格式的字符 ü、支持声调符号、支持首字母格式

• 💪 支持常用简体、繁体中文字符互转

• 🚀 支持添加自定义字典

• 🛠️ 支持常用简体/繁体中文字符转换成通用拼音

#软件架构

#源码目录

.
├── src
│   ├── data
│   │   ├── chinese_dict.mbt           # 繁→简码点映射（2533 条）
│   │   ├── mutil_pinyin_dict.mbt      # 词组拼音（843 条）
│   │   ├── pinyin_dict.mbt            # 单字拼音（20903 条）
│   │   └── tongyong_pinyin_dict.mbt  # 通用拼音（82 条）
│   ├── examples                      # 功能示例
│   │   ├── chinese_helper_example.mbt
│   │   ├── pinyin_helper_example.mbt
│   │   ├── pinyin_array_example.mbt
│   │   └── custom_dict_example.mbt
│   ├── chinese_helper.mbt             # ChineseHelper：繁简转换、汉字判断
│   ├── pinyin_dicts.mbt              # 四张字典视图常量
│   ├── pinyin_error.mbt              # PinyinError 错误类型
│   ├── pinyin_format.mbt             # PinyinFormat 格式枚举
│   ├── pinyin_helper.mbt             # PinyinHelper：拼音转换核心 API
│   └── tone_conversion.mbt           # 声调转换内部逻辑
├── doc
│   └── feature_api.md                # API 文档
├── scripts
│   └── gen_pinyin_dict.py            # 字典生成脚本
├── moon.mod                           # 模块元数据
├── CHANGELOG.md                       # 变更日志
├── LICENSE                            # MIT 协议
└── README.md

• src/data 存放字典字面量（由生成脚本从源库转写）
• src/examples 存放功能示例（对应 README 中的 10 个示例）
• src 是库源码目录
• doc 存放库的特性文档
• scripts 存放字典生成脚本

#接口说明

#使用说明

#编译构建

moon check     # 类型检查
moon test      # 运行测试
moon fmt       # 格式化
moon info      # 生成接口文件

#功能示例

#繁体转简体

let pinyin = ChineseHelper::convert_to_simplified_chinese("臺，喪，麗")
println(pinyin)
// 输出: 台，丧，丽

#简体转繁体

let pinyin = ChineseHelper::convert_to_traditional_chinese("我是中国人")
println(pinyin)
// 输出: 我是中國人

#词、句转换成拼音

let pinyin = PinyinHelper::convert_to_pinyin_string("我是中国人", " ")
println(pinyin)
// 输出: wǒ shì zhōng zhòng guó rén

#自定义输出格式

let pinyin = PinyinHelper::convert_to_pinyin_string("中国", " ", format=PinyinFormat::WithToneNumber)
println(pinyin)
// 输出: zhong1 zhong4 guo2

#添加自定义拼音字典

let map : Map[String, String] = { "上": "shǎng" }
PinyinHelper::add_pinyin_dict_resource(map)
let pinyin = PinyinHelper::convert_to_pinyin_string("上午", " ")
println(pinyin)
// 输出: shǎng wǔ

#添加自定义拼音组合字典

let map : Map[String, String] = { "阿弥陀佛": "ā,mí,tuó,fó" }
PinyinHelper::add_mutil_pinyin_dict_resource(map)
let pinyin = PinyinHelper::convert_to_pinyin_string("阿弥陀佛", " ")
println(pinyin)
// 输出: ā mí tuó fó

#添加自定义中文字典

let map : Map[Int, Int] = { 0x7691: 0x75C7 }  // 癥 → 症
ChineseHelper::add_chinese_dict_resource(map)
let pinyin = ChineseHelper::convert_to_simplified_chinese("癥")
println(pinyin)
// 输出: 症

#多音字转拼音集合

let pinyin = PinyinHelper::convert_to_pinyin_array('长')
println(pinyin)
// 输出: ["cháng", "zhǎng"]

#繁简体转拼音

let pinyin = PinyinHelper::convert_to_pinyin_array('嚴')
println(pinyin)
// 输出: ["yán"]

#繁简体转通用拼音

let simplePinyin = PinyinHelper::to_tongyong_pinyin_string_array('傳')
let traditionalPinyin = PinyinHelper::to_tongyong_pinyin_string_array('传')
println(simplePinyin)
println(traditionalPinyin)
// 输出: ["chuan2", "jhuan4"]
//       ["chuan2", "jhuan4"]

#字典条目数

#字典生成

python scripts/gen_pinyin_dict.py

#约束与限制

#移植说明

#开源协议

#参与贡献

#pinyin

#介绍

#特性

• 支持词、句转换成拼音
• 支持常用简体/繁体中文字符转换成拼音
• 支持常见多音字符转换成拼音
• 支持 Unicode 格式的字符 ü、支持声调符号、支持首字母格式
• 支持常用简体、繁体中文字符互转
• 支持添加自定义字典
• 支持常用简体/繁体中文字符转换成通用拼音

#软件架构

#源码目录

.
├── src
│   ├── data
│   │   ├── chinese_dict.mbt
│   │   ├── mutil_pinyin_dict.mbt
│   │   ├── pinyin_dict.mbt
│   │   └── tongyong_pinyin_dict.mbt
│   ├── chinese_helper.mbt
│   ├── pinyin_dicts.mbt
│   ├── pinyin_error.mbt
│   ├── pinyin_format.mbt
│   ├── pinyin_helper.mbt
│   └── tone_conversion.mbt
├── doc
│   └── feature_api.md
├── scripts
│   └── gen_pinyin_dict.py
├── moon.mod
├── CHANGELOG.md
├── LICENSE
└── README.md

• src/data 存放字典字面量（由生成脚本从源库 resource/pinyin.dict.txt 转写）
• src 是库源码目录
• doc 存放库的特性文档
• scripts 存放字典生成脚本

#使用说明

#编译构建

moon check
moon test

#功能示例

#繁体转简体

///|
test "readme_convert_to_simplified" {
  inspect(
    ChineseHelper::convert_to_simplified_chinese("臺，喪，麗"),
    content="台，丧，丽",
  )
}

#简体转繁体

///|
test "readme_convert_to_traditional" {
  inspect(
    ChineseHelper::convert_to_traditional_chinese("我是中国人"),
    content="我是中國人",
  )
}

#词、句转换成拼音

///|
test "readme_convert_to_pinyin_string" {
  inspect(
    PinyinHelper::convert_to_pinyin_string("我是中国人", " "),
    content="wǒ shì zhōng zhòng guó rén",
  )
}

#自定义输出格式

///|
test "readme_with_tone_number" {
  inspect(
    PinyinHelper::convert_to_pinyin_string(
      "中国",
      " ",
      format=PinyinFormat::WithToneNumber,
    ),
    content="zhong1 zhong4 guo2",
  )
}

#多音字转拼音集合

///|
test "readme_convert_to_pinyin_array" {
  debug_inspect(
    PinyinHelper::convert_to_pinyin_array('长'),
    content="[\"cháng\", \"zhǎng\"]",
  )
}

#繁简体转通用拼音

///|
test "readme_tongyong_pinyin" {
  debug_inspect(
    PinyinHelper::to_tongyong_pinyin_string_array('传'),
    content="[\"chuan2\", \"jhuan4\"]",
  )
}

#首字母格式

///|
test "readme_get_short_pinyin" {
  inspect(PinyinHelper::get_short_pinyin("中国"), content="z z g")
}

#多音字检测

///|
test "readme_has_multi_pinyin" {
  inspect(PinyinHelper::has_multi_pinyin('中'), content="true")
}

#汉字判断

///|
test "readme_is_chinese" {
  inspect(ChineseHelper::is_chinese('中'), content="true")
  inspect(ChineseHelper::contains_chinese("abc中"), content="true")
}

#字典条目数

#字典生成

python scripts/gen_pinyin_dict.py

#约束与限制

#开源协议