mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 08:44:29 +08:00
a7a3eca40d
- 修复 PR #288 中经本地复核后仍成立的 Core、Game 与测试建议 - 更新 WSL 标准 dotnet build 验证路径并确认 Release 构建可通过 - 补充 analyzer-warning-reduction 跟踪文档记录本轮结论与恢复点
79 lines
2.7 KiB
C#
79 lines
2.7 KiB
C#
namespace GFramework.Core.Extensions;
|
||
|
||
/// <summary>
|
||
/// 字符串扩展方法
|
||
/// </summary>
|
||
public static class StringExtensions
|
||
{
|
||
/// <summary>
|
||
/// 如果字符串为空，则返回 null；否则返回原字符串
|
||
/// </summary>
|
||
/// <param name="str">要检查的字符串</param>
|
||
/// <returns>如果字符串为空则返回 null，否则返回原字符串</returns>
|
||
/// <example>
|
||
/// <code>
|
||
/// string text = "";
|
||
/// var result = text.NullIfEmpty(); // 返回 null
|
||
/// </code>
|
||
/// </example>
|
||
public static string? NullIfEmpty(this string? str)
|
||
{
|
||
return string.IsNullOrEmpty(str) ? null : str;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 截断字符串到指定的最大长度，并可选地添加后缀
|
||
/// </summary>
|
||
/// <param name="str">要截断的字符串</param>
|
||
/// <param name="maxLength">最大长度（包括后缀）</param>
|
||
/// <param name="suffix">截断时添加的后缀，默认为 "..."</param>
|
||
/// <returns>截断后的字符串</returns>
|
||
/// <exception cref="ArgumentNullException">当 str 为 null 时抛出</exception>
|
||
/// <exception cref="ArgumentOutOfRangeException">当 maxLength 小于后缀长度时抛出</exception>
|
||
/// <example>
|
||
/// <code>
|
||
/// var text = "Hello World";
|
||
/// var truncated = text.Truncate(8); // "Hello..."
|
||
/// </code>
|
||
/// </example>
|
||
public static string Truncate(this string str, int maxLength, string suffix = "...")
|
||
{
|
||
ArgumentNullException.ThrowIfNull(str);
|
||
ArgumentNullException.ThrowIfNull(suffix);
|
||
|
||
if (maxLength < suffix.Length)
|
||
{
|
||
throw new ArgumentOutOfRangeException(nameof(maxLength),
|
||
$"最大长度必须至少为后缀长度 ({suffix.Length})");
|
||
}
|
||
|
||
if (str.Length <= maxLength)
|
||
{
|
||
return str;
|
||
}
|
||
|
||
return string.Concat(str.AsSpan(0, maxLength - suffix.Length), suffix);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 使用指定的分隔符连接字符串集合
|
||
/// </summary>
|
||
/// <param name="values">要连接的字符串集合</param>
|
||
/// <param name="separator">分隔符</param>
|
||
/// <returns>连接后的字符串</returns>
|
||
/// <exception cref="ArgumentNullException">当 values 或 separator 为 null 时抛出</exception>
|
||
/// <example>
|
||
/// <code>
|
||
/// var words = new[] { "Hello", "World" };
|
||
/// var result = words.Join(", "); // "Hello, World"
|
||
/// </code>
|
||
/// </example>
|
||
public static string Join(this IEnumerable<string> values, string separator)
|
||
{
|
||
ArgumentNullException.ThrowIfNull(values);
|
||
ArgumentNullException.ThrowIfNull(separator);
|
||
|
||
return string.Join(separator, values);
|
||
}
|
||
}
|