Added helper methods

Author: linkdotnet

CHANGELOG.md

@@ -7,6 +7,7 @@ All notable changes to **ValueStringBuilder** will be documented in this file. T
 ## [Unreleased]
 
 ### Added
+ - New easy API for concatenating smaller strings or objects via `ValueStringBuilder.Concat("Hello", " ", "World");` 
  - Smaller performance improvements in internal API's
 
 ## [1.4.1] - 2022-11-04

src/LinkDotNet.StringBuilder/ValueStringBuilder.Helper.cs

@@ -0,0 +1,22 @@
+namespace LinkDotNet.StringBuilder;
+
+public ref partial struct ValueStringBuilder
+{
+    /// <summary>
+    /// Concatenates multiple objects together.
+    /// </summary>
+    /// <param name="values">Values, which will be concatenated together.</param>
+    /// <typeparam name="T">Any given type, which can be translated to string.</typeparam>
+    /// <returns>Concatenated string or an empty string if <see cref="values"/> is empty.</returns>
+    public static string Concat<T>(params T[] values)
+    {
+        if (values.Length == 0)
+        {
+            return string.Empty;
+        }
+
+        using var sb = new ValueStringBuilder();
+        sb.AppendJoin(string.Empty, values);
+        return sb.ToString();
+    }
+}

tests/LinkDotNet.StringBuilder.UnitTests/ValueStringBuilderTests.cs

@@ -344,4 +344,12 @@ public void ShouldReturnRentedArrayBuffer()
 
         builder.Dispose();
     }
+
+    [Fact]
+    public void ShouldConcatStringsTogether()
+    {
+        var result = ValueStringBuilder.Concat("Hello", " ", "World");
+
+        result.Should().Be("Hello World");
+    }
 }