2300070/ezpinyin

拼音库：汉字转拼音、汉字转声母（首字母）。

EzPinyin

介绍

适用于.Net Framework及.Net Standard的汉字转拼音组件。主要的设计目是实现对字符串进行快速的拼音转换，从而帮助开发人员在做数据开发时可以简单快速的建立拼音索引。

提示

本项目处于不停迭代中，若你使用过程中发现问题，建议升级到最新版本或提交新的异常报告。

特性

• 极快的处理速度，具体请参考性能章节。
• 涵盖统一码平面A的基本汉字区及补充汉字区、汉字扩展区A的全部汉字，涵盖统一码平面B的汉字扩展区B、C、D、E、F、G的大部分汉字，总计约覆盖九万汉字。
• 通过引入高质量的词典，使得此项目对于多音字有着不错的识别能力。
• 除了支持在运行时重定义拼音之外，还可以用配置文件的方式自定义汉字或者词汇的拼音，从而达到修正或者补充的效果。
• 词典同时适配简体、繁体及繁简混合的词汇。
• 小巧简洁，包含字典、词典内容在内不超过1M，无其他项目依赖。

性能

对常见字符进行处理时，本项目的性能参考数据如下表所示：

项目	性能(字/秒)
检索拼音字符串	3000万
检索拼音首字母	4000万
检索拼音数组	6000万

兼容性

.Net Framework 2.0及以上 或者.Net Standard 2.0及以上。

线程安全性

如注释文档中没有额外说明，此项目中公开的方法都是线程安全的。

引用本项目

除了直接下载项目之外，还可以通过nuget来添加并使用本项目。本项目的nuget地址为 https://www.nuget.org/packages/EzPinyin/ 。
可以通过visual studio的界面来搜索“ezpinyin”来引用本项目，也可以在nuget管理控制台输入命令来添加项目引用：“Install-Package EzPinyin”。

示例

//获得拼音完整字符串
PinyinHelper.GetPinyin("重庆银行川藏大区成都分行朝阳区长厦路重工大厦行动处九楼董事长藏宝室");//chong qing yin hang chuan zang da qu cheng du fen hang chao yang qu chang xia lu zhong gong da sha xing dong chu jiu lou dong shi zhang cang bao shi

//中英混排
PinyinHelper.GetPinyin("世界你好!!Hello,World!!");//shi jie ni hao!!Hello,World!!

//获得拼音的首字母
PinyinHelper.GetInitial("㐀㲒䔤䶵𠀀𠧄𡎈𡵌𢜐𣃔𣪘𤑜𤸠𥟤𦆨𦭬𧔰𧻴𨢸𩉼𩱀𪜀𪻐𫜴𫝀𫠝𫠠𫿰𬟀𬺰𭡫𮈦𰀀𱍊");//qbpchgfcwdgzmlldjlkspdc𫜴wbyst𬺰𭡫lzc

//获得拼音信息的数组
PinyinHelper.GetArray(text);//string[]

//重新定义拼音信息
PinyinHelper.Define("𫜴", "lun");//拼音仅供演示
PinyinHelper.Define("𫜴吧", new[]{"lun", "biu"});//拼音仅供演示

//加载自定义的拼音配置文件
PinyinHelper.LoadFrom("custom_file.txt");//文件内容格式请参考自定义配置章节。

//跳过文件名称，直接加载自定义配置文件的内容
PinyinHelper.Load("𫜴 liu\n𫜴吧 lun biu");//内容格式请参考自定义配置章节。

更多请参考EzPinyin.UnitTest项目中的代码。

自定义配置

可以使用以下的方式来进行自定义的配置。

• 你可以自定义一个或者数个文件名称包含“dict”关键字的文本文件作为自定义字典文件，扩展名不一定必须是“.txt”，将这些文件置于应用程序集相同的目录即可发挥作用，配置文件可以定义字符或者词汇的拼音，定义已经存在的字符或者词汇将进行重写，定义简体词汇将同步更新其对应的繁体词汇，也可以单独定义繁体词的词汇（但不会同步更新对应的简体字词汇），如果多次定义相同的信息，以最后一次生效的为准，配置细节请参考dictionary.txt模板。使用这种配置需考虑应用程序是否具备相应的文件访问权限。

• 你可以自定义一个或者数个文件名称包含“dict”关键字的内嵌资源作为自定义配置，其余规则与配置文件一致。

• 你可以使用其它方式存储自定义的配置，并在运行时动态加载。

如无特别提示，本项目所有的文本文件支持的编码为UTF8。

免责声明

由于多音字在不同语义下的意涵十分复杂，因而这个项目在处理多音字时仍然会出现错误。任何使用本项目的开发人员应该理解这个问题并谨慎使用，此项目的开发者不对此项目的任何功能或者问题（或损失）提供任何（直接或间接）担保与承诺。

致谢

本项目的开发者仅贡献了核心的查询与优化算法，主要的汉字数据则自互联网收集，在此要特别感谢此项目的直接数据来源：

• 百度汉语 http://hanyu.baidu.com
• 汉典 http://zdic.net
• 叶典 http://yedict.com

以上数据来源又引用了以下工具书的内容，在此予以致谢：

• 《高级汉语词典》
• 《康熙字典》
• 《中华字海》
• 《汉语大字典》

此外，此项目也吸收了下列站点的部分内容作为参考，一并致谢：

• 词典网 http://cd.cidianwang.com
• 汉文学网 http://cd.hwxnet.com
• 国学大师 http://www.guoxuedashi.net/
• 必应词典 http://cn.bing.com/dict/
• 百度百科 http://baike.baidu.com

支持

此项目当前没有任何盈利计划，若你认为她对你有所帮助，可以考虑支持叶典(http://yedict.com/zhichi.htm) 或其他相关网站。

ezpinyin's Issues

拼音转汉字

可不可以拼音转汉字

测试了一下，初始加载速度似乎有点慢

AMD 5900x，大概要2秒左右。
另外中英文混合内容，英文会变成全角字符，不知道是否是这样设计的。如果希望对中英文混合内容做匹配，变成全角就没法处理了。

Xamarin android release下使用报The type initializer for 'EzPinyin.Common' threw an exception

你好 net

ySystem.Collections.Generic.List`1[System.Object]
Unhandled exception. System.TypeInitializationException: The type initializer for 'EzPinyin.Common' threw an exception.
---> System.ArgumentNullException: Value cannot be null. (Parameter 'path')
at System.IO.Directory.InternalEnumeratePaths(String path, String searchPattern, SearchTarget searchTarget, EnumerationOptions options)
at System.IO.Directory.GetFiles(String path, String searchPattern, EnumerationOptions enumerationOptions)
at System.IO.Directory.GetFiles(String path, String searchPattern)
at EzPinyin.Common..cctor()
--- End of inner exception stack trace ---
at EzPinyin.Common.AcquireBuffer()
at EzPinyin.PinyinHelper.GetInitial(String text, String separator)
at Program.<>c__DisplayClass0_1.<

$>b__5(String filepath, String softid) in G:.net\rongao-sim-zbtrain-server\RASimServer\CodeFirst\Program.cs:line 184
at Program.$(String[] args) in G:.net\rongao-sim-zbtrain-server\RASimServer\CodeFirst\Program.cs:line 264
PS N:\CodeFirst>