Name: ZaString
Author: Corentin Giaufer Saubert

ZaString v0.2.0 — nugetz

using ZaString.Core;
using ZaString.Extensions;

// Create a stack-allocated buffer
Span<char> buffer = stackalloc char[100];
var builder = ZaSpanStringBuilder.Create(buffer);

// Build strings with fluent API
builder.Append("Hello, ")
       .Append("World!")
       .Append(" Number: ")
       .Append(42)
       .Append(" Pi: ")
       .Append(Math.PI, "F2");

// Access result as span (zero allocation)
var result = builder.AsSpan();
Console.WriteLine(result); // "Hello, World! Number: 42 Pi: 3.14"

Span<char> buffer = stackalloc char[64];
var builder = ZaSpanStringBuilder.Create(buffer);

builder.Append("User: ")
       .Append("John Doe")
       .Append(", Age: ")
       .Append(25)
       .Append(", Active: ")
       .Append(true);

// Access as ReadOnlySpan<char> (zero allocation)
var userInfo = builder.AsSpan();

using var builder = ZaPooledStringBuilder.Rent(128);
builder.Append("Pooled string building")
       .Append(" with automatic cleanup");

var result = builder.ToString();
// Buffer automatically returned to pool when disposed

Span<byte> buffer = stackalloc byte[256];
var writer = ZaUtf8SpanWriter.Create(buffer);

writer.Append("Hello, UTF-8 World!")
      .Append(" Number: ")
      .Append(123);

var utf8Bytes = writer.AsSpan();

var name = "Alice";
var age = 30;
var pi = Math.PI;

builder.Append($"User: {name}, Age: {age}, Pi: {pi:F2}");

builder.Append("Currency: ")
       .Append(1234.56, "C")           // "$1,234.56"
       .Append(", Number: ")
       .Append(12345, "N0")            // "12,345"
       .Append(", Percentage: ")
       .Append(0.85, "P2");            // "85.00%"

var fr = new CultureInfo("fr-FR");
builder.Append(1234.56, "C", fr);      // "1 234,56 €"

var isActive = true;
builder.Append("Status: ")
       .AppendIf(isActive, "Active", "Inactive");

// JSON escaping
builder.AppendJsonEscaped("Line1\nLine2\t\"Quote\"");

// HTML escaping
builder.AppendHtmlEscaped("<script>alert('xss')</script>");

// URL encoding
builder.AppendUrlEncoded("Hello World!");

// CSV escaping
builder.AppendCsvEscaped("Value,with,commas");

builder.AppendPathSegment("api")
       .AppendPathSegment("v1")
       .AppendPathSegment("users")
       .AppendQueryParam("q", "search term", isFirst: true)
       .AppendQueryParam("page", "1");
// Result: "api/v1/users?q=search%20term&page=1"

Span<char> smallBuffer = stackalloc char[10];
var builder = ZaSpanStringBuilder.Create(smallBuffer);

if (builder.TryAppend("Hello, World!"))
{
    Console.WriteLine("Successfully appended");
}
else
{
    Console.WriteLine("Buffer too small");
}

Method	Mean Time	Memory Allocations	Performance Ratio
`StringBuilder` (Baseline)	146.1 ns	480 B	1.00x
`String` concatenation	116.3 ns	248 B	0.80x
`String` interpolation	116.9 ns	136 B	0.80x
ZaSpanStringBuilder	115.2 ns	0 B	0.79x

Case	Builder Mean	Builder Alloc	ZaSpan Mean
Double	128.70 ns	176 B	104.26 ns
Double (Formatted F2)	94.20 ns	160 B	73.33 ns
Float	105.12 ns	168 B	88.40 ns
Long	27.51 ns	176 B	12.58 ns
Integer (Formatted N0)	59.43 ns	168 B	38.28 ns

// Traditional approach - 146.1 ns, 480 B allocated
var sb = new StringBuilder();
sb.Append("Name: ").Append("John").Append(", Age: ").Append(25);
var result = sb.ToString();

// ZaString approach - 115.2 ns, 0 B allocated
Span<char> buffer = stackalloc char[50];
var builder = ZaSpanStringBuilder.Create(buffer);
builder.Append("Name: ").Append("John").Append(", Age: ").Append(25);
var result = builder.AsSpan(); // Zero allocation

dotnet test

cd tests/ZaString.Benchmarks
dotnet run -c Release

CorentinGS/ZaStringv0.2.0

Get Started

Readme

ZaString

🚀 Key Features

📦 Installation

🎯 Quick Start

🔧 Core Components

ZaSpanStringBuilder

ZaPooledStringBuilder

ZaUtf8SpanWriter

🎨 Advanced Features

String Interpolation

Number Formatting

Culture-Specific Formatting

Conditional Appending

Escape Helpers

URL Building

TryAppend Methods

📊 Performance

Basic String Building Performance

Detailed Benchmark Results

Number Formatting Performance using Builder

Key Performance Benefits

Benchmark Example

🛠️ Use Cases

🔍 API Reference

Core Methods

Extension Methods

🧪 Testing

📝 Examples

🤝 Contributing

📄 License

🙏 Acknowledgments