add: New api

Author: linkdotnet

src/LinkDotNet.StringBuilder/ValueStringBuilder.cs

@@ -101,6 +101,12 @@ public void AppendLine(ReadOnlySpan<char> str)
     /// <returns>True, if the copy was successful, otherwise false.</returns>
     public bool TryCopyTo(Span<char> destination) => buffer[..bufferPosition].TryCopyTo(destination);
 
+    public void Clear()
+    {
+        buffer.Clear();
+        bufferPosition = 0;
+    }
+
     private void Grow(int capacity = 0)
     {
         var currentSize = buffer.Length;

src/LinkDotNet.StringBuilder/ValueStringBuilderExtensions.cs

@@ -10,7 +10,7 @@ public static class ValueStringBuilderExtensions
     /// </summary>
     /// <param name="builder">The builder from which the new instance is derived.</param>
     /// <returns>A new <see cref="System.Text.StringBuilder"/> instance with the string represented
-    /// by this <see cref="builder"/>.
+    /// by this <paramref name="builder"/>.
     /// </returns>
     public static System.Text.StringBuilder ToStringBuilder(ref this ValueStringBuilder builder)
     {
@@ -20,11 +20,11 @@ public static System.Text.StringBuilder ToStringBuilder(ref this ValueStringBuil
     }
 
     /// <summary>
-    /// Creates a new <see cref="ValueStringBuilder"/> from the given <see cref="builder"/>.
+    /// Creates a new <see cref="ValueStringBuilder"/> from the given <paramref name="builder"/>.
     /// </summary>
     /// <param name="builder">The builder from which the new instance is derived.</param>
     /// <returns>A new <see cref="ValueStringBuilder"/> instance with the string represented by this <see cref="builder"/>.</returns>
-    /// <exception cref="ArgumentNullException">Throws if <see cref="builder"/> is null.</exception>
+    /// <exception cref="ArgumentNullException">Throws if <paramref name="builder"/> is null.</exception>
     public static ValueStringBuilder ToValueStringBuilder(this System.Text.StringBuilder? builder)
     {
         if (builder == null)

tests/LinkDotNet.StringBuilder.UnitTests/ValueStringBuilderTests.cs

@@ -120,4 +120,24 @@ public void ShouldReturnLength()
 
         length.Should().Be(5);
     }
+
+    [Fact]
+    public void ShouldClear()
+    {
+        var stringBuilder = new ValueStringBuilder();
+        stringBuilder.Append("Hello");
+
+        stringBuilder.Clear();
+
+        stringBuilder.Length.Should().Be(0);
+        stringBuilder.ToString().Should().Be(string.Empty);
+    }
+
+    [Fact]
+    public void ShouldReturnEmptyStringWhenInitialized()
+    {
+        var stringBuilder = new ValueStringBuilder();
+
+        stringBuilder.ToString().Should().Be(string.Empty);
+    }
 }