ZZYDOP
/
AiDOPWarehouse


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128
							// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。
//
// 本项目主要遵循 MIT 许可证和 Apache 许可证（版本 2.0）进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。
//
// 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动！任何基于本项目二次开发而产生的一切法律纠纷和责任，我们不承担任何责任！

namespace Admin.NET.Core;

/// <summary>
/// 字符串扩展方法
/// </summary>
public static class StringExtension
{
    /// <summary>
    /// 字符串截断
    /// </summary>
    public static string Truncate(this string str, int maxLength, string ellipsis = "...")
    {
        if (string.IsNullOrWhiteSpace(str)) return str;
        if (maxLength <= 0) return string.Empty;
        if (str.Length <= maxLength) return str;

        // 确保省略号不会导致字符串超出最大长度
        int ellipsisLength = ellipsis?.Length ?? 0;
        int truncateLength = Math.Min(maxLength, str.Length - ellipsisLength);
        return str[..truncateLength] + ellipsis;
    }

    /// <summary>
    /// 单词首字母全部大写
    /// </summary>
    public static string ToTitleCase(this string str)
    {
        return string.IsNullOrWhiteSpace(str) ? str : System.Globalization.CultureInfo.CurrentCulture.TextInfo.ToTitleCase(str.ToLower());
    }

    /// <summary>
    /// 检查是否包含子串，忽略大小写
    /// </summary>
    public static bool ContainsIgnoreCase(this string str, string substring)
    {
        if (string.IsNullOrWhiteSpace(str) || string.IsNullOrWhiteSpace(substring)) return false;
        return str.Contains(substring, StringComparison.OrdinalIgnoreCase);
    }

    /// <summary>
    /// 判断是否是 JSON 数据
    /// </summary>
    public static bool IsJson(this string str)
    {
        if (string.IsNullOrWhiteSpace(str)) return false;
        str = str.Trim();
        return (str.StartsWith("{") && str.EndsWith("}")) || (str.StartsWith("[") && str.EndsWith("]"));
    }

    /// <summary>
    /// 判断是否是 HTML 数据
    /// </summary>
    public static bool IsHtml(this string str)
    {
        if (string.IsNullOrWhiteSpace(str)) return false;
        str = str.Trim();

        // 检查是否以 <!DOCTYPE html> 或 <html> 开头
        if (str.StartsWith("<!DOCTYPE html>", StringComparison.OrdinalIgnoreCase) || str.StartsWith("<html>", StringComparison.OrdinalIgnoreCase))
        {
            return true;
        }

        // 检查是否包含 HTML 标签
        return Regex.IsMatch(str, @"<\s*[^>]+>.*<\s*/\s*[^>]+>|<\s*[^>]+\s*/>", RegexOptions.Singleline | RegexOptions.IgnoreCase);
    }

    /// <summary>
    /// 字符串反转
    /// </summary>
    public static string Reverse(this string str)
    {
        if (string.IsNullOrEmpty(str)) return str;

        // 使用 Span<char> 提高性能
        Span<char> charSpan = stackalloc char[str.Length];
        for (int i = 0; i < str.Length; i++)
        {
            charSpan[str.Length - 1 - i] = str[i];
        }
        return new string(charSpan);
    }

    /// <summary>
    /// 转首字母小写
    /// </summary>
    public static string ToFirstLetterLowerCase(this string input)
    {
        if (string.IsNullOrWhiteSpace(input)) return input;
        if (input.Length == 1) return input.ToLower(); // 处理单字符字符串

        return char.ToLower(input[0]) + input[1..];
    }

    /// <summary>
    /// 渲染字符串，替换占位符
    /// </summary>
    /// <param name="template">模板内容</param>
    /// <param name="parameters">参数对象</param>
    /// <returns></returns>
    public static string Render(this string template, object parameters)
    {
        if (string.IsNullOrWhiteSpace(template)) return template;

        // 将参数转换为字典（忽略大小写）
        var paramDict = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
        if (parameters != null)
        {
            foreach (var prop in parameters.GetType().GetProperties())
            {
                paramDict[prop.Name] = prop.GetValue(parameters)?.ToString() ?? string.Empty;
            }
        }

        // 使用正则表达式替换占位符
        return Regex.Replace(template, @"\{(\w+)\}", match =>
        {
            string key = match.Groups[1].Value; // 获取占位符中的 key
            return paramDict.TryGetValue(key, out string value) ? value : string.Empty;
        });
    }
}