feat: 😀扩展常用字符串方法

2025-01-17 09:29:45 +08:00 · 2025-01-17 09:29:45 +08:00 · 007cddb34c
commit 007cddb34c
parent fbfb5281eb
1 changed files with 128 additions and 0 deletions
--- a/Admin.NET/Admin.NET.Core/Extension/StringExtension.cs
+++ b/Admin.NET/Admin.NET.Core/Extension/StringExtension.cs
@ -0,0 +1,128 @@
+// 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 ToFirstLower(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;
+        });
+    }
+}