Added format overload

Author: linkdotnet

CHANGELOG.md

@@ -10,6 +10,7 @@ All notable changes to **ValueStringBuilder** will be documented in this file. T
 
 - `ToString(startIndex, length)` to get a substring from the builder
 - `Append(Guid guid)` and `Insert(Guid guid)` as new overload
+- Added optional format string for `Append` and `Insert`
 
 ## [1.6.2] - 2022-11-11
 

src/LinkDotNet.StringBuilder/ValueStringBuilder.Append.cs

@@ -15,71 +15,81 @@ public ref partial struct ValueStringBuilder
     /// Appends the string representation of the character to the builder.
     /// </summary>
     /// <param name="value">Integer to add.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Append(char value) => AppendSpanFormattable(value);
+    public void Append(char value, ReadOnlySpan<char> format = default) => AppendSpanFormattable(value, format);
 
     /// <summary>
     /// Appends the string representation of the signed byte to the builder.
     /// </summary>
     /// <param name="value">Signed byte to add.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Append(sbyte value) => AppendSpanFormattable(value);
+    public void Append(sbyte value, ReadOnlySpan<char> format = default) => AppendSpanFormattable(value, format);
 
     /// <summary>
     /// Appends the string representation of the byte to the builder.
     /// </summary>
     /// <param name="value">Byte to add.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Append(byte value) => AppendSpanFormattable(value);
+    public void Append(byte value, ReadOnlySpan<char> format = default) => AppendSpanFormattable(value, format);
 
     /// <summary>
     /// Appends the string representation of the short to the builder.
     /// </summary>
     /// <param name="value">Short to add.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Append(short value) => AppendSpanFormattable(value);
+    public void Append(short value, ReadOnlySpan<char> format = default) => AppendSpanFormattable(value, format);
 
     /// <summary>
     /// Appends the string representation of the integer to the builder.
     /// </summary>
     /// <param name="value">Integer to add.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Append(int value) => AppendSpanFormattable(value);
+    public void Append(int value, ReadOnlySpan<char> format = default) => AppendSpanFormattable(value, format);
 
     /// <summary>
     /// Appends the string representation of the long integer to the builder.
     /// </summary>
     /// <param name="value">Long integer to add.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Append(long value) => AppendSpanFormattable(value);
+    public void Append(long value, ReadOnlySpan<char> format = default) => AppendSpanFormattable(value, format);
 
     /// <summary>
     /// Appends the string representation of the float to the builder.
     /// </summary>
     /// <param name="value">Float to add.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Append(float value) => AppendSpanFormattable(value);
+    public void Append(float value, ReadOnlySpan<char> format = default) => AppendSpanFormattable(value, format);
 
     /// <summary>
     /// Appends the string representation of the double to the builder.
     /// </summary>
     /// <param name="value">Double to add.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Append(double value) => AppendSpanFormattable(value);
+    public void Append(double value, ReadOnlySpan<char> format = default) => AppendSpanFormattable(value, format);
 
     /// <summary>
     /// Appends the string representation of the decimal to the builder.
     /// </summary>
     /// <param name="value">Decimal to add.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Append(decimal value) => AppendSpanFormattable(value);
+    public void Append(decimal value, ReadOnlySpan<char> format = default) => AppendSpanFormattable(value, format);
 
     /// <summary>
     /// Appends the string representation of the Guid to the builder.
     /// </summary>
     /// <param name="value">Guid to add.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Append(Guid value) => AppendSpanFormattable(value, "D");
+    public void Append(Guid value, ReadOnlySpan<char> format = default) => AppendSpanFormattable(value, format);
 
     /// <summary>
     /// Appends a string to the string builder.

src/LinkDotNet.StringBuilder/ValueStringBuilder.Insert.cs

@@ -17,80 +17,90 @@ public ref partial struct ValueStringBuilder
     /// </summary>
     /// <param name="index">Index where <paramref name="value"/> should be inserted.</param>
     /// <param name="value">Character to insert into this builder.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Insert(int index, char value) => InsertSpanFormattable(index, value);
+    public void Insert(int index, char value, ReadOnlySpan<char> format = default) => InsertSpanFormattable(index, value, format);
 
     /// <summary>
     /// Insert the string representation of the signed byte to the builder at the given index.
     /// </summary>
     /// <param name="index">Index where <paramref name="value"/> should be inserted.</param>
     /// <param name="value">Signed byte to insert into this builder.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Insert(int index, sbyte value) => InsertSpanFormattable(index, value);
+    public void Insert(int index, sbyte value, ReadOnlySpan<char> format = default) => InsertSpanFormattable(index, value, format);
 
     /// <summary>
     /// Insert the string representation of the byte to the builder at the given index.
     /// </summary>
     /// <param name="index">Index where <paramref name="value"/> should be inserted.</param>
     /// <param name="value">Byte to insert into this builder.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Insert(int index, byte value) => InsertSpanFormattable(index, value);
+    public void Insert(int index, byte value, ReadOnlySpan<char> format = default) => InsertSpanFormattable(index, value, format);
 
     /// <summary>
     /// Insert the string representation of the short to the builder at the given index.
     /// </summary>
     /// <param name="index">Index where <paramref name="value"/> should be inserted.</param>
     /// <param name="value">Short to insert into this builder.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Insert(int index, short value) => InsertSpanFormattable(index, value);
+    public void Insert(int index, short value, ReadOnlySpan<char> format = default) => InsertSpanFormattable(index, value, format);
 
     /// <summary>
     /// Insert the string representation of the integer to the builder at the given index.
     /// </summary>
     /// <param name="index">Index where <paramref name="value"/> should be inserted.</param>
     /// <param name="value">Integer to insert into this builder.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Insert(int index, int value) => InsertSpanFormattable(index, value);
+    public void Insert(int index, int value, ReadOnlySpan<char> format = default) => InsertSpanFormattable(index, value, format);
 
     /// <summary>
     /// Insert the string representation of the long to the builder at the given index.
     /// </summary>
     /// <param name="index">Long where <paramref name="value"/> should be inserted.</param>
     /// <param name="value">String to insert into this builder.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Insert(int index, long value) => InsertSpanFormattable(index, value);
+    public void Insert(int index, long value, ReadOnlySpan<char> format = default) => InsertSpanFormattable(index, value, format);
 
     /// <summary>
     /// Insert the string representation of the float to the builder at the given index.
     /// </summary>
     /// <param name="index">Index where <paramref name="value"/> should be inserted.</param>
     /// <param name="value">Float to insert into this builder.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Insert(int index, float value) => InsertSpanFormattable(index, value);
+    public void Insert(int index, float value, ReadOnlySpan<char> format = default) => InsertSpanFormattable(index, value, format);
 
     /// <summary>
     /// Insert the string representation of the double to the builder at the given index.
     /// </summary>
     /// <param name="index">Index where <paramref name="value"/> should be inserted.</param>
     /// <param name="value">Double to insert into this builder.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Insert(int index, double value) => InsertSpanFormattable(index, value);
+    public void Insert(int index, double value, ReadOnlySpan<char> format = default) => InsertSpanFormattable(index, value, format);
 
     /// <summary>
     /// Insert the string representation of the decimal to the builder at the given index.
     /// </summary>
     /// <param name="index">Index where <paramref name="value"/> should be inserted.</param>
     /// <param name="value">Decimal to insert into this builder.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Insert(int index, decimal value) => InsertSpanFormattable(index, value);
+    public void Insert(int index, decimal value, ReadOnlySpan<char> format = default) => InsertSpanFormattable(index, value, format);
 
     /// <summary>
     /// Insert the string representation of the Guid to the builder at the given index.
     /// </summary>
     /// <param name="index">Index where <paramref name="value"/> should be inserted.</param>
     /// <param name="value">Guid to insert into this builder.</param>
+    /// <param name="format">Optional formatter. If not provided the default of the given instance is taken.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public void Insert(int index, Guid value) => InsertSpanFormattable(index, value);
+    public void Insert(int index, Guid value, ReadOnlySpan<char> format = default) => InsertSpanFormattable(index, value, format);
 
     /// <summary>
     /// Appends the string representation of the boolean to the builder.