Base32768

Base32768 is a binary encoding optimised for UTF-16-encoded text.

C# port of Base32768

Installation

Install-Package Base32768

Usage

using System;
using System.IO;
using Kzrnm.Convert.Base32768;

var byteArray = new byte[] { 104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100 };
var str = Base32768.Encode(byteArray);
Console.WriteLine(str);
//// 6 code points, "媒腻㐤┖ꈳ埳"

var byteArray2 = Base32768.Decode(str);
Console.WriteLine(string.Join(", ", byteArray2));
//// [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100]

// .NET Standard 2.1
str = Base32768.Encode(stackalloc byte[] { 104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100 });
Console.WriteLine(str);
//// 6 code points, "媒腻㐤┖ꈳ埳"

byteArray2 = Base32768.Decode(str.AsSpan());
Console.WriteLine(string.Join(", ", byteArray2));
//// [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100]


// Stream API
{
    using var textWriter = new StringWriter();
    using (var stream = new Base32768Stream(textWriter))
    {
        stream.Write(stackalloc byte[] { 104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100 });
    }
    textWriter.ToString();
//// 6 code points, "媒腻㐤┖ꈳ埳"
}
{
    using var ms = new MemoryStream();
    using var textReader = new StringReader("媒腻㐤┖ꈳ埳");
    using (var stream = new Base32768Stream(textReader))
    {
        stream.CopyTo(ms);
    }
    Console.WriteLine(string.Join(", ", ms.ToArray()));
//// [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100]
}

Benchmark

BenchmarkDotNet=v0.13.1, OS=Windows 10.0.19043.1348 (21H1/May2021Update)
Intel Core i7-4790 CPU 3.60GHz (Haswell), 1 CPU, 8 logical and 4 physical cores
.NET SDK=6.0.100
  [Host]   : .NET 6.0.0 (6.0.21.52210), X64 RyuJIT
  ShortRun : .NET 6.0.0 (6.0.21.52210), X64 RyuJIT

Job=ShortRun  IterationCount=3  LaunchCount=1  
WarmupCount=3  

Method	Toolchain	ByteSize	Mean	Error	StdDev	Gen 0	Gen 1	Gen 2	Allocated
Encode	.NET 6.0	100000	185.0 μs	53.21 μs	2.92 μs	66.6504	66.6504	66.6504	209 KB
Encode	.NET 6.0	10000000	23,642.9 μs	5,502.80 μs	301.63 μs	187.5000	187.5000	187.5000	20,834 KB
Decode	.NET 6.0	100000	128.4 μs	5.55 μs	0.30 μs	31.0059	31.0059	31.0059	98 KB
Decode	.NET 6.0	10000000	14,592.5 μs	19,429.76 μs	1,065.01 μs	125.0000	125.0000	125.0000	9,766 KB
Encode	.NET Framework 4.7.2	100000	222.5 μs	41.89 μs	2.30 μs	66.6504	66.6504	66.6504	209 KB
Encode	.NET Framework 4.7.2	10000000	28,494.2 μs	22,460.30 μs	1,231.12 μs	187.5000	187.5000	187.5000	20,834 KB
Decode	.NET Framework 4.7.2	100000	165.2 μs	10.74 μs	0.59 μs	31.0059	31.0059	31.0059	98 KB
Decode	.NET Framework 4.7.2	10000000	17,969.7 μs	13,166.46 μs	721.70 μs	125.0000	125.0000	125.0000	9,766 KB