/// <summary> /// 获取格式化后的唯一拼音(单音字)或者第一个拼音(多音字) /// </summary> /// <param name="hanzi">要查询拼音的汉字字符</param> /// <param name="format">拼音输出格式化参数</param> /// <see cref="PinyinFormat"/> /// <seealso cref="PinyinUtil"/> /// <returns>格式化后的唯一拼音(单音字)或者第一个拼音(多音字)</returns> /// <exception cref="UnsupportedUnicodeException">当要获取拼音的字符不是汉字时抛出此异常</exception> public static string GetFirstPinyin(char hanzi, PinyinFormat format = PinyinFormat.None) { var pinyin = GetPinyin(hanzi)[0]; if (format == PinyinFormat.None) { return(pinyin); } return(PinyinUtil.Format(pinyin, format)); }
/// <summary> /// 获取汉字的拼音数组 /// </summary> /// <param name="hanzi">要查询拼音的汉字字符</param> /// <param name="format">设置输出拼音的格式</param> /// <returns>汉字的拼音数组,若未找到汉字拼音,则返回空数组</returns> /// <exception cref="UnsupportedUnicodeException">当要获取拼音的字符不是汉字时抛出此异常</exception> public static string[] GetPinyin(char hanzi, PinyinFormat format = PinyinFormat.None) { if (!PinyinUtil.IsHanzi(hanzi)) { // 不是汉字 throw new UnsupportedUnicodeException("不支持的字符: 请输入汉字"); } var pinyin = PinyinDB.Instance.GetPinyin(hanzi); if (format == PinyinFormat.None) { return(pinyin); } return(pinyin.Select(item => PinyinUtil.Format(item, format)).ToArray()); }
/// <summary> /// 获取姓的拼音,如果是复姓则由空格分隔 /// </summary> /// <param name="firstName">要查询拼音的姓</param> /// <param name="format">输出拼音格式化参数</param> /// <returns>返回姓的拼音,若未找到姓,则返回null</returns> /// <exception cref="UnsupportedUnicodeException">当要获取拼音的字符不是汉字时抛出此异常</exception> public static string GetPinyin(string firstName, PinyinFormat format = PinyinFormat.None) { if (!firstName.All(PinyinUtil.IsHanzi)) { // 不是汉字 throw new UnsupportedUnicodeException("不支持的字符: 请输入汉字字符"); } var pinyin = NameDB.Instance.GetPinyin(firstName); if (format == PinyinFormat.None) { return(pinyin); } return(string.Join(" ", pinyin.Split(' ').Select(item => PinyinUtil.Format(item, format)))); }