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’

参考

pypinyin 0.37.0 文档