LBinarySerializer 0.0.1

LBinarySerializer

LBinarySerializer is a fast and efficient binary serializer for .NET.

Usage

public class TestClass : ILBinarySerializable
{
    public string Name { get; set; }
    public int Age { get; set; }

    public void Serialize(LBinarySerializer serializer)
    {
        serializer.Write(Name);
        serializer.Write(Age);
    }

    public void Deserialize<T>(LBinaryDeserializer deserializer)
    {
        Name = deserializer.ReadString();
        Age = deserializer.ReadInt();
    }
}

public static class Converter
{
    public static byte[] Serialize(T object) where T : ILBinarySerializable
    {
        using var serializer = new LBinarySerializer();
        object.Serialize(serializer);
        return serializer.GetData();
    }

    public static T Deserialize<T>(byte[] rawData) where T : class, ILBinarySerializable, new()
    {
        var deserializer = new Deserializer(rawData);
        return deserializer.Deserialize<T>();
    }
}

The maximum size of serialized data is 2,147,483,647 bytes.

Array (List) structure

---
Array (List) structure
---
packet-beta
0-4: "Number of items"
5-12: "Item 1"
13-20: "Item 2"

Dictionary structure

Header size is 4 bytes. -1 in the header means that the dictionary is null. 0 in the header means that the dictionary is empty. The size of key and value can be any number of bytes. If the key is integer, it is serialized as Int32 and contains 4 bytes. The key can be any unmanaged type or string. The value can be any unmanaged type, string or ILBinarySerializable object.

---
Dictionary structure
---
packet-beta
0-4: "Number of elements"
5-8: "Key"
9-12: "Value"
13-16: "Key"
17-20: "Value"

String structure

Header size is 4 bytes. -1 in the header means that the string is null. 0 in the header means that the string is empty.

---
String structure
---
packet-beta
0-4: "String length"
5-20: "Data"

Object structure

Header size is 4 bytes. -1 in the header means that the object is null. Supports ILBinarySerializable objects that represent a class.

---
Object structure
---
packet-beta
0-4: "Object size"
5-104: "Data"

Struct structure

Header size is always 0 or greater. Supports only unmanaged types as fields. Strings, some structures or any ILBinarySerializable objects can't be used as fields. The deserializer supports only unmanged types.

---
Struct structure
---
packet-beta
0-4: "Structure size"
5-104: "Data"

DateTime structure

The DateTime structure is represented in Ticks 8 bytes. First 4 bytes describe its kind: UTC, Local or Unspecified.

---
DateTime structure
---
packet-beta
0-4: "DateTime Kind"
5-12: "Ticks"

DateTimeOffset structure

The DateTimeOffset structure has 2 parts: time in Ticks and its offset in TimeSpan.

---
DateTimeOffset structure
---
packet-beta
0-8: "Ticks"
9-16: "Offset"

Supported structure types

Performance tests and comparison

BenchmarkDotNet v0.14.0, macOS Sequoia 15.5 (24F74) [Darwin 24.5.0]
Apple M1 Max, 1 CPU, 10 logical and 10 physical cores
.NET SDK 8.0.401
  [Host]     : .NET 8.0.13 (8.0.1325.6609), Arm64 RyuJIT AdvSIMD
  DefaultJob : .NET 8.0.13 (8.0.1325.6609), Arm64 RyuJIT AdvSIMD

Small objects

Large objects