feat: Added Equals comparison with Span

Author: linkdotnet

CHANGELOG.md

@@ -6,6 +6,10 @@ All notable changes to **ValueStringBuilder** will be documented in this file. T
 
 ## [Unreleased]
 
+### Added
+
+- Added `Equals(ReadOnlySpan<char>)` overload
+
 ### Changed
 
 - Slight improvement when appending nullable types to the string builder

src/LinkDotNet.StringBuilder/ValueStringBuilder.cs

@@ -273,6 +273,13 @@ public readonly int LastIndexOf(ReadOnlySpan<char> word, int startIndex)
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     public readonly bool Contains(ReadOnlySpan<char> word) => IndexOf(word) != -1;
 
+    /// <summary>
+    /// Returns a value indicating whether the characters in this instance are equal to the characters in a specified read-only character span.
+    /// </summary>
+    /// <param name="span">The character span to compare with the current instance.</param>
+    /// <returns><c>true</c> if the characters are equal to this instance, otherwise <c>false</c>.</returns>
+    public readonly bool Equals(ReadOnlySpan<char> span) => span.SequenceEqual(AsSpan());
+
     /// <summary>
     /// Disposes the instance and returns rented buffer from an array pool if needed.
     /// </summary>

tests/LinkDotNet.StringBuilder.UnitTests/ValueStringBuilderTests.cs

@@ -440,4 +440,16 @@ public void ConcatBooleanWithNumber()
 
         result.Should().Be("True1");
     }
+
+    [Theory]
+    [InlineData("Hello", true)]
+    [InlineData("Hallo", false)]
+    public void GivenReadOnlySpan_WhenCallingEquals_ThenReturningWhenEqual(string input, bool expected)
+    {
+        using var builder = new ValueStringBuilder("Hello");
+
+        var isEqual = builder.Equals(input);
+
+        isEqual.Should().Be(expected);
+    }
 }