ZeroAlloc.Results

ZeroAlloc.Results

ZeroAlloc.Results is a zero-allocation, no-boxing Result<T, E> library for .NET 9. All types are readonly struct — no heap allocation, no boxing, no GC pressure.

Install

dotnet add package ZeroAlloc.Results

Quick Example

using ZeroAlloc.Results;
using ZeroAlloc.Results.Extensions;

// Create
Result<int, string> ok = Result<int, string>.Success(42);
Result<int, string> fail = Result<int, string>.Failure("not found");

// Or via implicit conversion
Result<int, string> r = 42;       // success
Result<int, string> e = "error";  // failure

// Chain with Map, Bind, Ensure
var result = GetUser(id)
    .Ensure(u => u.IsActive, "user is inactive")
    .Map(u => u.Email)
    .Bind(email => SendWelcome(email));

// Match to extract
string message = result.Match(
    onSuccess: email => $"Sent to {email}",
    onFailure: err  => $"Failed: {err}");

// LINQ query syntax
var greeting =
    from user    in GetUser(id)
    from profile in GetProfile(user)
    select $"Hello, {profile.Name}";

// Async pipelines with ValueTask
var response = await GetUser(id)
    .MapAsync(async u  => await LoadPermissions(u))
    .BindAsync(async p => await BuildToken(p));

Types

API

Performance

All core operations produce zero heap allocations (Windows 11, .NET 9.0.14, BenchmarkDotNet v0.13.12).

Head-to-head vs CSharpFunctionalExtensions 3.7.0 (Windows 11, .NET 9.0.14, BenchmarkDotNet v0.13.12):

See docs/performance.md for the full benchmark analysis and zero-allocation design explanation.

Documentation

License

MIT