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

Name	Description
Reader
BaseEndianReader	The abstract base type that implements the IEndianReader interface.
EndianStreamReader	Used for reading from streams, inherits the BaseEndianReader type.
Writer
EndianStreamWriter	Used for writing into streams, inherits the BinaryWriter type and implements the IEndianWriter interface.

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

Type	Endian type(s)
Int8	-
UInt8	-
Int16	Little, Big
UInt16	Little, Big
Int32	Little, Big
UInt32	Little, Big
Int64	Little, Big
UInt64	Little, Big
Float	Little, Big
Double	Little, Big
Guid	Little, Big
Sha1	Little