// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。
//
// 本项目主要遵循 MIT 许可证和 Apache 许可证（版本 2.0）进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。
//
// 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动！任何基于本项目二次开发而产生的一切法律纠纷和责任，我们不承担任何责任！
namespace Admin.NET.Core;
///
/// 字符串扩展方法
///
public static class StringExtension
{
///
/// 字符串截断
///
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;
}
///
/// 单词首字母全部大写
///
public static string ToTitleCase(this string str)
{
return string.IsNullOrWhiteSpace(str) ? str : System.Globalization.CultureInfo.CurrentCulture.TextInfo.ToTitleCase(str.ToLower());
}
///
/// 检查是否包含子串，忽略大小写
///
public static bool ContainsIgnoreCase(this string str, string substring)
{
if (string.IsNullOrWhiteSpace(str) || string.IsNullOrWhiteSpace(substring)) return false;
return str.Contains(substring, StringComparison.OrdinalIgnoreCase);
}
///
/// 判断是否是 JSON 数据
///
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("]"));
}
///
/// 判断是否是 HTML 数据
///
public static bool IsHtml(this string str)
{
if (string.IsNullOrWhiteSpace(str)) return false;
str = str.Trim();
// 检查是否以 或 开头
if (str.StartsWith("", StringComparison.OrdinalIgnoreCase) || str.StartsWith("", StringComparison.OrdinalIgnoreCase))
{
return true;
}
// 检查是否包含 HTML 标签
return Regex.IsMatch(str, @"<\s*[^>]+>.*<\s*/\s*[^>]+>|<\s*[^>]+\s*/>", RegexOptions.Singleline | RegexOptions.IgnoreCase);
}
///
/// 字符串反转
///
public static string Reverse(this string str)
{
if (string.IsNullOrEmpty(str)) return str;
// 使用 Span 提高性能
Span charSpan = stackalloc char[str.Length];
for (int i = 0; i < str.Length; i++)
{
charSpan[str.Length - 1 - i] = str[i];
}
return new string(charSpan);
}
///
/// 转首字母小写
///
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..];
}
///
/// 渲染字符串，替换占位符
///
/// 模板内容
/// 参数对象
///
public static string Render(this string template, object parameters)
{
if (string.IsNullOrWhiteSpace(template)) return template;
// 将参数转换为字典（忽略大小写）
var paramDict = new Dictionary(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;
});
}
}