#pinyin

#介绍

#特性

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

#软件架构

#源码目录

.
├── data
│   ├── chinese_dict.mbt
│   ├── mutil_pinyin_dict.mbt
│   ├── pinyin_dict.mbt
│   └── tongyong_pinyin_dict.mbt
├── examples
│   ├── chinese_helper_example.mbt
│   ├── pinyin_helper_example.mbt
│   ├── pinyin_array_example.mbt
│   └── custom_dict_example.mbt
├── docs
│   ├── roadmap.md
│   ├── architecture.md
│   ├── api.md
│   └── testing.md
├── chinese_helper.mbt
├── pinyin_dicts.mbt
├── pinyin_error.mbt
├── pinyin_format.mbt
├── pinyin_helper.mbt
├── tone_conversion.mbt
├── scripts
│   └── gen_pinyin_dict.py
├── moon.mod
├── moon.pkg
├── CHANGELOG.md
├── LICENSE
├── README.md
└── README.mbt.md

• data/ 纯数据包，零依赖，存放字典字面量（由生成脚本从源库转写）
• examples/ 示例包，依赖根包，14 个示例测试覆盖所有公开 API
• docs/ 开发文档（roadmap / architecture / api / testing）
• 根目录为库源码包（walkzzz/pinyin），含核心 API 与测试
• scripts/ 存放字典生成脚本

#使用说明

#编译构建

moon check
moon test

#功能示例

#繁体转简体

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

#简体转繁体

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

#词、句转换成拼音

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

#自定义输出格式

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

#多音字转拼音集合

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

#繁简体转通用拼音

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

#首字母格式

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

#多音字检测

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

#汉字判断

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

#字典条目数

#字典生成

python scripts/gen_pinyin_dict.py

#约束与限制

#开源协议