73 lines
3.0 KiB
C#
73 lines
3.0 KiB
C#
using RoadFlow.Pinyin.data;
|
||
using RoadFlow.Pinyin.exception;
|
||
using System.Linq;
|
||
using RoadFlow.Pinyin.format;
|
||
|
||
namespace RoadFlow.Pinyin
|
||
{
|
||
/// <summary>
|
||
/// 处理姓名专用
|
||
/// </summary>
|
||
public static class Pinyin4Name
|
||
{
|
||
#region // 获取单字拼音
|
||
/// <summary>
|
||
/// 获取姓的拼音，如果是复姓则由空格分隔
|
||
/// </summary>
|
||
/// <param name="firstName">要查询拼音的姓</param>
|
||
/// <returns>返回姓的拼音，若未找到姓，则返回null</returns>
|
||
/// <exception cref="UnsupportedUnicodeException">当要获取拼音的字符不是汉字时抛出此异常</exception>
|
||
public static string GetPinyin(string firstName)
|
||
{
|
||
if (firstName.All(PinyinUtil.IsHanzi))
|
||
{
|
||
return NameDB.Instance.GetPinyin(firstName);
|
||
}
|
||
// 不是汉字
|
||
throw new UnsupportedUnicodeException("不支持的字符: 请输入汉字字符");
|
||
}
|
||
|
||
/// <summary>
|
||
/// 获取姓的首字母，如果是复姓则由空格分隔首字母
|
||
/// </summary>
|
||
/// <param name="firstName">要查询拼音的姓</param>
|
||
/// <returns>返回姓的拼音首字母，若未找到姓，则返回null</returns>
|
||
/// <exception cref="UnsupportedUnicodeException">当要获取拼音的字符不是汉字时抛出此异常</exception>
|
||
public static string GetFirstLetter(string firstName)
|
||
{
|
||
var pinyin = GetPinyin(firstName);
|
||
if (pinyin == null)
|
||
{
|
||
return null;
|
||
}
|
||
return string.Join(" ", pinyin.Split(' ').Select(py => py[0]));
|
||
}
|
||
|
||
/// <summary>
|
||
/// 获取格式化后的拼音
|
||
/// </summary>
|
||
/// <param name="firstName">要查询拼音的姓</param>
|
||
/// <param name="format">输出拼音格式化参数</param>
|
||
/// <see cref="PinyinOutputFormat"/>
|
||
/// <seealso cref="PinyinFormatter"/>
|
||
/// <returns>返回格式化后的拼音，若未找到姓，则返回null</returns>
|
||
/// <exception cref="UnsupportedUnicodeException">当要获取拼音的字符不是汉字时抛出此异常</exception>
|
||
public static string GetPinyinWithFormat(string firstName, PinyinOutputFormat format)
|
||
{
|
||
return string.Join(" ", GetPinyin(firstName).Split(' ').Select(item => PinyinFormatter.Format(item, format)));
|
||
}
|
||
#endregion
|
||
|
||
/// <summary>
|
||
/// 根据拼音查询匹配的姓
|
||
/// </summary>
|
||
/// <param name="pinyin"></param>
|
||
/// <param name="matchAll">是否全部匹配，为true时，匹配整个拼音，否则匹配开头字符，此参数用于告知传入的拼音是完整拼音还是仅仅是声母</param>
|
||
/// <returns>匹配的姓数组</returns>
|
||
public static string[] GetHanzi(string pinyin, bool matchAll)
|
||
{
|
||
return NameDB.Instance.GetHanzi(pinyin.ToLower(), matchAll);
|
||
}
|
||
}
|
||
}
|