Java汉字转拼音类库Pinyin4j详细使用方法与实例
汉字转拼音类库Pinyin4j一般用法
pinyin4j的使用很方便,一般转换只需要使用PinyinHelper类的静态工具方法即可:
String[]pinyin=PinyinHelper.toHanyuPinyinStringArray(‘刘'); //该类还有其他的拼音转换形式,但是基本上用不到,就不介绍了
返回的数组即是该字符的拼音,如上例就是pinyin[0]=liu2,后面的数字代表声调,声调为5表示轻读,无声调。之所谓返回数组,是因为被判定的汉字有可能有多个读音。如果输入的参数不是汉字,则返回null。
拼音格式化
如果对于拼音转换后的结果有一些特定的格式要求目前pinyin4j支持:
声调格式化。例如:“刘”字的格式化后为“liu2”或“liu”或“liú”
对特殊拼音ü的的显示格式。例如“u:”或“v”或“ü”
大小写的转换。例如:“liu2”或“LIU2”
以上这些格式可以混合使用,下面就来介绍具体的使用方法,首先需要创建格式化对象HanyuPinyinOutputFormat,例如:
HanyuPinyinOutputFormatoutputFormat=newHanyuPinyinOutputFormat();
然后分别调用outputFormat的set方法设置上述一些格式要求:
设置声调格式:
outputFormat.setToneType(HanyuPinyinToneType);
方法参数HanyuPinyinToneType有以下常量对象:
HanyuPinyinToneType.WITH_TONE_NUMBER用数字表示声调,例如:liu2
HanyuPinyinToneType.WITHOUT_TONE无声调表示,例如:liu
HanyuPinyinToneType.WITH_TONE_MARK用声调符号表示,例如:liú
设置特殊拼音ü的显示格式:
outputFormat.setVCharType(HanyuPinyinVCharType);
方法参数HanyuPinyinVCharType有以下常量对象:
HanyuPinyinVCharType.WITH_U_AND_COLON以U和一个冒号表示该拼音,例如:lu:
HanyuPinyinVCharType.WITH_V以V表示该字符,例如:lv
HanyuPinyinVCharType.WITH_U_UNICODE以ü表示
设置大小写格式
outputFormat.setCaseType(HanyuPinyinCaseType);
HanyuPinyinCaseType.LOWERCASE转换后以全小写方式输出
HanyuPinyinCaseType.UPPERCASE转换后以全大写方式输出
设置好格式对象后还是利用上述的工具类方法进行拼音转换,只不过需要将格式化对象当成方法参数传入转换方法,告知要转换的格式要求:
String[]pinyin=PinyinHelper.toHanyuPinyinStringArray(‘刘',outputFormat);
但该方法会有异常抛出,注意处理。
示例
importnet.sourceforge.pinyin4j.PinyinHelper;
importnet.sourceforge.pinyin4j.format.HanyuPinyinCaseType;
importnet.sourceforge.pinyin4j.format.HanyuPinyinOutputFormat;
importnet.sourceforge.pinyin4j.format.HanyuPinyinToneType;
importnet.sourceforge.pinyin4j.format.HanyuPinyinVCharType;
importnet.sourceforge.pinyin4j.format.exception.BadHanyuPinyinOutputFormatCombination;
publicclassTest{
publicstaticvoidmain(String[]args){
importnet.sourceforge.pinyin4j.PinyinHelper;
importnet.sourceforge.pinyin4j.format.HanyuPinyinCaseType;
importnet.sourceforge.pinyin4j.format.HanyuPinyinOutputFormat;
importnet.sourceforge.pinyin4j.format.HanyuPinyinToneType;
importnet.sourceforge.pinyin4j.format.HanyuPinyinVCharType;
importnet.sourceforge.pinyin4j.format.exception.BadHanyuPinyinOutputFormatCombination;
publicclassTest{
publicstaticvoidmain(String[]args){
HanyuPinyinOutputFormatoutputFormat=newHanyuPinyinOutputFormat();
outputFormat.setToneType(HanyuPinyinToneType.WITH_TONE_MARK);
outputFormat.setVCharType(HanyuPinyinVCharType.WITH_U_UNICODE);
outputFormat.setCaseType(HanyuPinyinCaseType.UPPERCASE);
try{
System.out.println(concatPinyinStringArray(PinyinHelper.toHanyuPinyinStringArray('刘',outputFormat)));
}catch(BadHanyuPinyinOutputFormatCombinatione){
//TODOAuto-generatedcatchblock
e.printStackTrace();
}
}
privatestaticStringconcatPinyinStringArray(String[]pinyinArray)
{
StringBufferpinyinStrBuf=newStringBuffer();
if((null!=pinyinArray)&&(pinyinArray.length>0))
{
for(inti=0;i
输出结果为:LIú
其他
PinyinHelper还有其他的静态方法,但示例和讲解中使用的方法是常见的拼音格式,因此其他静态方法我没有调研其含义。
貌似支持生僻字,我试过很怪异的字,都可以将其读音拼写出来,因此这个工具包还是很强的。
拼音工具
packagecn.itcast.bos.utils;
importjava.util.Arrays;
importnet.sourceforge.pinyin4j.PinyinHelper;
importnet.sourceforge.pinyin4j.format.HanyuPinyinCaseType;
importnet.sourceforge.pinyin4j.format.HanyuPinyinOutputFormat;
importnet.sourceforge.pinyin4j.format.HanyuPinyinToneType;
importnet.sourceforge.pinyin4j.format.exception.BadHanyuPinyinOutputFormatCombination;
publicclassPinYin4jUtils{
/**
*将字符串转换成拼音数组
*
*@paramsrc
*@return
*/
publicstaticString[]stringToPinyin(Stringsrc){
returnstringToPinyin(src,false,null);
}
/**
*将字符串转换成拼音数组
*
*@paramsrc
*@return
*/
publicstaticString[]stringToPinyin(Stringsrc,Stringseparator){
returnstringToPinyin(src,true,separator);
}
/**
*将字符串转换成拼音数组
*
*@paramsrc
*@paramisPolyphone
*是否查出多音字的所有拼音
*@paramseparator
*多音字拼音之间的分隔符
*@return
*/
publicstaticString[]stringToPinyin(Stringsrc,booleanisPolyphone,
Stringseparator){
//判断字符串是否为空
if("".equals(src)||null==src){
returnnull;
}
char[]srcChar=src.toCharArray();
intsrcCount=srcChar.length;
String[]srcStr=newString[srcCount];
for(inti=0;i128){
try{
//转换得出结果
String[]strs=PinyinHelper.toHanyuPinyinStringArray(src,
defaultFormat);
//是否查出多音字,默认是查出多音字的第一个字符
if(isPolyphone&&null!=separator){
for(inti=0;i
更多关于Java汉字转拼音类库Pinyin4j详细使用方法与实例请查看下面的相关链接
声明:本文内容来源于网络,版权归原作者所有,内容由互联网用户自发贡献自行上传,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任。如果您发现有涉嫌版权的内容,欢迎发送邮件至:czq8825#qq.com(发邮件时,请将#更换为@)进行举报,并提供相关证据,一经查实,本站将立刻删除涉嫌侵权内容。