using GFramework.Core.Extensions;
using NUnit.Framework;
namespace GFramework.Core.Tests.Extensions;
///
/// 测试 StringExtensions 扩展方法的功能
///
[TestFixture]
public class StringExtensionsTests
{
///
/// 测试IsNullOrEmpty方法在字符串为null时返回true
///
[Test]
public void IsNullOrEmpty_Should_Return_True_When_String_Is_Null()
{
// Arrange
string? text = null;
// Act
var result = text.IsNullOrEmpty();
// Assert
Assert.That(result, Is.True);
}
///
/// 测试IsNullOrEmpty方法在字符串为空时返回true
///
[Test]
public void IsNullOrEmpty_Should_Return_True_When_String_Is_Empty()
{
// Arrange
var text = string.Empty;
// Act
var result = text.IsNullOrEmpty();
// Assert
Assert.That(result, Is.True);
}
///
/// 测试IsNullOrEmpty方法在字符串有内容时返回false
///
[Test]
public void IsNullOrEmpty_Should_Return_False_When_String_Has_Content()
{
// Arrange
var text = "Hello";
// Act
var result = text.IsNullOrEmpty();
// Assert
Assert.That(result, Is.False);
}
///
/// 测试IsNullOrWhiteSpace方法在字符串为null时返回true
///
[Test]
public void IsNullOrWhiteSpace_Should_Return_True_When_String_Is_Null()
{
// Arrange
string? text = null;
// Act
var result = string.IsNullOrWhiteSpace(text);
// Assert
Assert.That(result, Is.True);
}
///
/// 测试IsNullOrWhiteSpace方法在字符串为空白时返回true
///
[Test]
public void IsNullOrWhiteSpace_Should_Return_True_When_String_Is_WhiteSpace()
{
// Arrange
var text = " ";
// Act
var result = string.IsNullOrWhiteSpace(text);
// Assert
Assert.That(result, Is.True);
}
///
/// 测试IsNullOrWhiteSpace方法在字符串有内容时返回false
///
[Test]
public void IsNullOrWhiteSpace_Should_Return_False_When_String_Has_Content()
{
// Arrange
var text = "Hello";
// Act
var result = string.IsNullOrWhiteSpace(text);
// Assert
Assert.That(result, Is.False);
}
///
/// 测试NullIfEmpty方法在字符串为空时返回null
///
[Test]
public void NullIfEmpty_Should_Return_Null_When_String_Is_Empty()
{
// Arrange
var text = string.Empty;
// Act
var result = text.NullIfEmpty();
// Assert
Assert.That(result, Is.Null);
}
///
/// 测试NullIfEmpty方法在字符串为null时返回null
///
[Test]
public void NullIfEmpty_Should_Return_Null_When_String_Is_Null()
{
// Arrange
string? text = null;
// Act
var result = text.NullIfEmpty();
// Assert
Assert.That(result, Is.Null);
}
///
/// 测试NullIfEmpty方法在字符串有内容时返回原字符串
///
[Test]
public void NullIfEmpty_Should_Return_String_When_String_Has_Content()
{
// Arrange
var text = "Hello";
// Act
var result = text.NullIfEmpty();
// Assert
Assert.That(result, Is.EqualTo("Hello"));
}
///
/// 测试Truncate方法在字符串长度小于最大长度时返回原字符串
///
[Test]
public void Truncate_Should_Return_Original_String_When_Length_Is_Less_Than_MaxLength()
{
// Arrange
var text = "Hello";
// Act
var result = text.Truncate(10);
// Assert
Assert.That(result, Is.EqualTo("Hello"));
}
///
/// 测试Truncate方法在字符串长度超过最大长度时截断并添加后缀
///
[Test]
public void Truncate_Should_Truncate_String_And_Add_Suffix()
{
// Arrange
var text = "Hello World";
// Act
var result = text.Truncate(8);
// Assert
Assert.That(result, Is.EqualTo("Hello..."));
}
///
/// 测试Truncate方法使用自定义后缀
///
[Test]
public void Truncate_Should_Use_Custom_Suffix()
{
// Arrange
var text = "Hello World";
// Act
var result = text.Truncate(8, "~");
// Assert
Assert.That(result, Is.EqualTo("Hello W~"));
}
///
/// 测试Truncate方法在字符串为null时抛出ArgumentNullException
///
[Test]
public void Truncate_Should_Throw_ArgumentNullException_When_String_Is_Null()
{
// Arrange
string? text = null;
// Act & Assert
Assert.Throws(() => text!.Truncate(10));
}
///
/// 测试Truncate方法在最大长度小于后缀长度时抛出ArgumentOutOfRangeException
///
[Test]
public void Truncate_Should_Throw_ArgumentOutOfRangeException_When_MaxLength_Is_Less_Than_Suffix_Length()
{
// Arrange
var text = "Hello";
// Act & Assert
Assert.Throws(() => text.Truncate(2, "..."));
}
///
/// 测试Join方法使用分隔符连接字符串数组
///
[Test]
public void Join_Should_Join_Strings_With_Separator()
{
// Arrange
var words = new[] { "Hello", "World" };
// Act
var result = words.Join(", ");
// Assert
Assert.That(result, Is.EqualTo("Hello, World"));
}
///
/// 测试Join方法在集合为空时返回空字符串
///
[Test]
public void Join_Should_Return_Empty_String_When_Collection_Is_Empty()
{
// Arrange
var words = Array.Empty();
// Act
var result = words.Join(", ");
// Assert
Assert.That(result, Is.EqualTo(string.Empty));
}
///
/// 测试Join方法在集合为null时抛出ArgumentNullException
///
[Test]
public void Join_Should_Throw_ArgumentNullException_When_Collection_Is_Null()
{
// Arrange
IEnumerable? words = null;
// Act & Assert
Assert.Throws(() => words!.Join(", "));
}
///
/// 测试Join方法在分隔符为null时抛出ArgumentNullException
///
[Test]
public void Join_Should_Throw_ArgumentNullException_When_Separator_Is_Null()
{
// Arrange
var words = new[] { "Hello", "World" };
// Act & Assert
Assert.Throws(() => words.Join(null!));
}
}