Name: ZaString
Author: Corentin Giaufer Saubert

ZaString v0.1.1 — 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

Type	Traditional	ZaSpanStringBuilder	Improvement
Integer	15.9 ns	11.3 ns	29% faster
Double	100.6 ns	103.6 ns	Comparable
Float	85.2 ns	85.3 ns	Comparable
Long	9.7 ns	11.9 ns	Comparable
Integer (Formatted)	36.5 ns	37.4 ns	Comparable
Double (Formatted)	76.4 ns	77.2 ns	Comparable

// 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.1.1

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

Key Performance Benefits

Benchmark Example

🛠️ Use Cases

🔍 API Reference

Core Methods

Extension Methods

🧪 Testing

📝 Examples

🤝 Contributing

📄 License

🙏 Acknowledgments