Snowberry.IO 2.0.0

A binary reader and writer that supports different endian types.

Usage

Features

• Reader

  • Read different endian types for supported data types.
  • Custom analyzer that can be used to analyze bytes when they were filled into a buffer.
  • Read zero terminated strings (ReadCString).
  • Read sized zero terminated strings (ReadSizedCString).
  • Read size prefixed strings (ReadString).
  • Read lines (ReadLine).
  • Read custom Sha1 type.
  • Read padding.
  • Enable custom region view.

• Writer

  • Write different endian types for supported data types.
  • Write zero terminated strings (WriteCString).
  • Write sized zero terminated string (WriteSizedCString).
  • Write custom Sha1 type.
  • Write padding.
  • Write lines (WriteLine).
  • Write size prefixed strings.

• Custom Sha1 type based on SHA-1.

Most used types

Reader and writer

var stream = new MemoryStream();
using var writer = new EndianStreamWriter(stream, keepStreamOpen: true);

writer.Write(10,  EndianType.BIG)
      .Write(20L, EndianType.BIG)
      .Write(30F, EndianType.BIG)
      .Write(40u, EndianType.BIG)
      .Write(50d, EndianType.BIG);
      
writer.BaseStream.Position = 0;

using var reader = new EndianStreamReader(stream);

_ = reader.ReadInt32(EndianType.BIG);
_ = reader.ReadLong(EndianType.BIG);
_ = reader.ReadFloat(EndianType.BIG);
_ = reader.ReadUInt32(EndianType.BIG);
_ = reader.ReadDouble(EndianType.BIG);

Custom analyzer

The Analyzer abstract type can be inherited and used to monitor each buffer fill operation.

This is useful if a binary file is or has encrypted content.

Endian converter

The BinaryEndianConverter type can be used to convert data in a Span<byte> to all supported data types and also accepts an offset.

var buffer = new byte[] { ... };
int offset = ...;
var endianType = EndianType.BIG;

_ = BinaryEndianConverter.ToLong(buffer, endianType);
_ = BinaryEndianConverter.ToLong(buffer, offset, endianType);

Supported data types