Pinyin4j 使用手册
一般用法
pinyin4j 的使用很方便,一般转换只需要使用 PinyinHelper 类的静态工具方法即可:
String[] pinyin = PinyinHelper.toHanyuPinyinStringArray(‘刘’);
//该类还有其他的拼音转换形式,但是基本上用不到,就不介绍了
返回的数组即是该字符的拼音,如上例就是 pinyin[0]=liu2,后面的数字代表声调,声调为 5
表示轻读,无声调。之所谓返回数组,是因为被判定的汉字有可能有多个读音。如果输入
的参数不是汉字,则返回 null。
拼音格式化
如果对于拼音转换后的结果有一些特定的格式要求目前 pinyin4j 支持:
声调格式化。例如:“刘”字的格式化后为“liu2”或“liu”或“liú”
对特殊拼音 ü 的的显示格式。例如“u:”或“v”或“ü”
大小写的转换。例如:“liu2”或“LIU2”
以上这些格式可以混合使用,下面就来介绍具体的使用方法,首先需要创建格式化对象
HanyuPinyinOutputFormat,例如:
HanyuPinyinOutputFormat outputFormat = new HanyuPinyinOutputFormat();
然后分别调用 outputFormat 的 set 方法设置上述一些格式要求:
设置声调格式:
outputFormat.setToneType(HanyuPinyinToneType);
方法参数 HanyuPinyinToneType 有以下常量对象:
HanyuPinyinToneType.WITH_TONE_NUMBER 用数字表示声调,例如:liu2
HanyuPinyinToneType.WITHOUT_TONE 无声调表示,例如:liu
HanyuPinyinToneType.WITH_TONE_MARK 用声调符号表示,例如:liú
设置特殊拼音 ü 的显示格式:
outputFormat.setVCharType(HanyuPinyinVCharType);