pythoin pypinyin汉字转拼音库使用
image.png
pypinyin
将汉字转为拼音。可以用于汉字注音、排序、检索 。
- Documentation: http://pypinyin.rtfd.io
- GitHub: https://github.com/mozillazg/python-pinyin
特性
- 根据词组智能匹配最正确的拼音。
- 支持多音字。
- 简单的繁体支持, 注音支持。
- 支持多种不同拼音风格。
安装
$ pip install pypinyin验证是否安装成功：
image.png
使用说明
>>> from pypinyin import pinyin, lazy_pinyin, Style
>>> pinyin('音乐')
[['yīn'], ['yuè']]
>>> pinyin('音乐', heteronym=True) #多音字
[['yīn'], ['yuè']]
>>> pinyin('乐', heteronym=True) #多音字
[['lè', 'yuè']]
>>> pinyin('乐')
[['lè']]
>>> lazy_pinyin('中心') #忽略多音字
['zhong', 'xin']拼音风格
class pypinyin.Style定义拼音风格
风格 | 含义 |
|---|---|
NORMAL = 0 | 普通风格，不带声调。如： 中国 -> zhong guo |
TONE = 1 | 标准声调风格，拼音声调在韵母第一个字母上（默认风格）。如： 中国 -> zhōng guó |
TONE2 = 2 | 声调风格2，即拼音声调在各个韵母之后，用数字 [1-4] 进行表示。如： 中国 -> zho1ng guo2 |
TONE3 = 8 | 声调风格3，即拼音声调在各个拼音之后，用数字 [1-4] 进行表示。如： 中国 -> zhong1 guo2 |
INITIALS = 3 | 声母风格，只返回各个拼音的声母部分（注：有的拼音没有声母，详见 #27_）。如： 中国 -> zh g |
FIRST_LETTER = 4 | 首字母风格，只返回拼音的首字母部分。如： 中国 -> z g |
FINALS = 5 | 韵母风格，只返回各个拼音的韵母部分，不带声调。如： 中国 -> ong uo |
FINALS_TONE = 6 | 标准韵母风格，带声调，声调在韵母第一个字母上。如：中国 -> ōng uó |
FINALS_TONE2 = 7 | 韵母风格2，带声调，声调在各个韵母之后，用数字 [1-4] 进行表示。如： 中国 -> o1ng uo2 |
FINALS_TONE3 = 9 | 韵母风格3，带声调，声调在各个拼音之后，用数字 [1-4] 进行表示。如： 中国 -> ong1 uo2 |
BOPOMOFO = 10 | 注音风格，带声调，阴平（第一声）不标。如： 中国 -> ㄓㄨㄥ ㄍㄨㄛˊ |
BOPOMOFO_FIRST = 11 | 注音风格，仅首字母。如： 中国 -> ㄓ ㄍ |
CYRILLIC = 12 | 汉语拼音与俄语字母对照风格，声调在各个拼音之后，用数字 [1-4] 进行表示。如： 中国 -> чжун1 го2 |
CYRILLIC_FIRST = 13 | 汉语拼音与俄语字母对照风格，仅首字母。如： 中国 -> ч г |
API函数
汉字转拼音
pinyin
pypinyin.pinyin(hans, style=<Style.TONE: 1>, heteronym=False, errors='default', strict=True)将汉字转换为拼音，返回汉字的拼音列表。
参数 | 说明 |
|---|---|
hans | 汉字字符串 |
style | 指定拼音风格，默认是 TONE风格 |
errors | 指定如何处理没有拼音的字符 |
heteronym | 指定是否启用多音字 |
strict | 指定是否严格遵照《汉语拼音方案》来处理声母和韵母 |
lazy_pinyin
pypinyin.lazy_pinyin(hans, style=<Style.NORMAL: 0>, errors='default', strict=True)将汉字转换为拼音，返回不包含多音字结果的拼音列表.
参数 | 说明 |
|---|---|
hans | 汉字字符串 |
style | 指定拼音风格，默认是 TONE风格 |
errors | 指定如何处理没有拼音的字符 |
strict | 指定是否严格遵照《汉语拼音方案》来处理声母和韵母 |
自定义拼音库
load_single_dict
pypinyin.load_single_dict(pinyin_dict, style='default'载入用户自定义的单字拼音库
参数 | 说明 |
|---|---|
pinyin_dict (dict) | 单字拼音库。比如： {0x963F: u"ā,ē"} |
style | pinyin_dict 参数值的拼音库风格. 支持 ‘default’, ‘tone2’ |
load_phrases_dict
pypinyin.load_phrases_dict(phrases_dict, style='default')载入用户自定义的词语拼音库
参数 | 说明 |
|---|---|
phrases_dict (dict) | 词语拼音库。比如： {u"阿爸": [[u"ā"], [u"bà"]]} |
style | phrases_dict 参数值的拼音库风格. 支持 ‘default’, ‘tone2’ |