mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-23 03:04:29 +08:00
fb14d7122c
- 将所有小写的命名空间导入更正为首字母大写格式 - 统一 GFramework 框架的命名空间引用规范 - 修复 core、ecs、godot 等模块的命名空间导入错误 - 标准化文档示例代码中的 using 语句格式 - 确保所有文档中的命名空间引用保持一致性 - 更新 global using 语句以匹配正确的命名空间格式
74 lines
2.6 KiB
C#
74 lines
2.6 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);
|
||
}
|
||
} |