Updating to newest release

Author: LinkDotNet Bot

CHANGELOG.md

@@ -6,6 +6,12 @@ All notable changes to **ValueStringBuilder** will be documented in this file. T
 
 ## [Unreleased]
 
+## [1.22.0] - 2024-12-18
+
+### Added
+
+- `AppendSpan` method
+
 ## [1.21.1] - 2024-11-08
 
 ### Changed
@@ -412,7 +418,8 @@ This release brings extensions to the `ValueStringBuilder` API. For `v1.0` the `
 
 - Initial release
 
-[unreleased]: https://github.com/linkdotnet/StringBuilder/compare/1.21.1...HEAD
+[unreleased]: https://github.com/linkdotnet/StringBuilder/compare/1.22.0...HEAD
+[1.22.0]: https://github.com/linkdotnet/StringBuilder/compare/1.21.1...1.22.0
 [1.21.1]: https://github.com/linkdotnet/StringBuilder/compare/1.21.0...1.21.1
 [1.21.0]: https://github.com/linkdotnet/StringBuilder/compare/1.20.0...1.21.0
 [1.20.0]: https://github.com/linkdotnet/StringBuilder/compare/1.19.1...1.20.0

Directory.Build.props

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
 	<ItemGroup>
-      <PackageReference Include="SonarAnalyzer.CSharp" Version="9.32.0.97167">
+      <PackageReference Include="SonarAnalyzer.CSharp" Version="10.3.0.106239">
         <PrivateAssets>all</PrivateAssets>
         <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
       </PackageReference>

README.md

@@ -38,7 +38,7 @@ The blog goes into a bit more in detail about how it works with a simplistic ver
 The library is not meant as a general replacement for the `StringBuilder` shipped with the .net framework itself. You can head over to the documentation and read about the ["Known limitations"](https://linkdotnet.github.io/StringBuilder/articles/known_limitations.html).
 The library works best for a small to medium amount of strings (not multiple 100'000 characters, even though it can be still faster and uses fewer allocations). At any time, you can convert the `ValueStringBuilder` to a "normal" `StringBuilder` and vice versa.
 
-The normal use case is to add concatenate strings in a hot path where the goal is to put as minimal pressure on the GC as possible.
+The normal use case is to concatenate strings in a hot path where the goal is to put as minimal pressure on the GC as possible.
 
 ## Documentation
 More detailed documentation can be found [here](https://linkdotnet.github.io/StringBuilder/). It is really important to understand how the `ValueStringBuilder` works so that you did not run into weird situations where performance/allocations can even rise.

src/LinkDotNet.StringBuilder/LinkDotNet.StringBuilder.csproj

@@ -40,7 +40,7 @@
 	</PropertyGroup>
 
     <ItemGroup>
-      <PackageReference Include="Meziantou.Analyzer" Version="2.0.177">
+      <PackageReference Include="Meziantou.Analyzer" Version="2.0.182">
         <PrivateAssets>all</PrivateAssets>
         <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
       </PackageReference>

src/LinkDotNet.StringBuilder/ValueStringBuilder.Append.cs

@@ -136,6 +136,24 @@ public void AppendLine(scoped ReadOnlySpan<char> str)
         Append(string.Concat(str, Environment.NewLine));
     }
 
+    /// <summary>
+    /// Increases the size of the string builder returning a span of the length appended.
+    /// </summary>
+    /// <param name="length">Integer representing the length to be appended.</param>
+    /// <returns>A span with the characters appended.</returns>
+    [MethodImpl(MethodImplOptions.AggressiveInlining)]
+    public Span<char> AppendSpan(int length)
+    {
+        int origPos = bufferPosition;
+        if (origPos > buffer.Length - length)
+        {
+            Grow(length);
+        }
+
+        bufferPosition = origPos + length;
+        return buffer.Slice(origPos, length);
+    }
+
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     private void AppendSpanFormattable<T>(T value, ReadOnlySpan<char> format = default, int bufferSize = 36)
         where T : ISpanFormattable

tests/LinkDotNet.StringBuilder.UnitTests/LinkDotNet.StringBuilder.UnitTests.csproj

@@ -8,8 +8,8 @@
     </PropertyGroup>
 
     <ItemGroup>
-        <PackageReference Include="FluentAssertions" Version="6.12.1" />
-        <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.11.1" />
+        <PackageReference Include="FluentAssertions" Version="6.12.2" />
+        <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.12.0" />
         <PackageReference Include="xunit" Version="2.9.2" />
         <PackageReference Include="xunit.runner.visualstudio" Version="2.8.2">
             <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>

tests/LinkDotNet.StringBuilder.UnitTests/ValueStringBuilder.Append.Tests.cs

@@ -47,6 +47,18 @@ public void ShouldAppendLine()
         stringBuilder.ToString().Should().Contain("Hello").And.Contain(Environment.NewLine);
     }
 
+    [Fact]
+    public void ShouldAppendSpan()
+    {
+        using var stringBuilder = new ValueStringBuilder();
+
+        var returned = stringBuilder.AppendSpan(2);
+
+        stringBuilder.Length.Should().Be(2);
+
+        stringBuilder.ToString().Should().Be(returned.ToString());
+    }
+
     [Fact]
     public void ShouldOnlyAddNewline()
     {