csharp-binary-stream

Library compatible with C#'s BinaryReader class

Usage no npm install needed!

<script type="module">
  import csharpBinaryStream from 'https://cdn.skypack.dev/csharp-binary-stream';
</script>

README

CSharp Binary Stream

Build Status

Binary stream writing and reading classes compatible with CSharp's BinaryReader and BinaryWriter.

Getting Started

This library was written in TypeScript but will also work in projects written in JavaScript.

Installing

Add it to your project via:

npm i --save csharp-binary-stream

Documentation

The full documentation can be found here.

The reader can be used like this:

import {BinaryReader, Encoding} from `csharp-binary-stream`;

const reader = new BinaryReader(existingArrayBuffer);
// or
const reader = new BinaryReader(existingUint8Array);
// or
const reader = new BinaryReader(new Uint8Array(otherTypedArray.buffer, otherTypedArray.byteOffset, otherTypedArray.byteLength));
console.log(reader.readByte());
console.log(reader.readChar(Encoding.Utf8));
console.log(reader.readFloat());

While the writer like this:

import {BinaryWriter, Encoding} from `csharp-binary-stream`;

const writer = new BinaryWriter();
// or
const writer = new BinaryWriter(existingNumberArray);
//or
const writer = new BinaryWriter(existingUint8Array);
writer.writeByte(7);
writer.writeChars("Writing some text", Encoding.Utf8);
writer.writeLong("12345678900012");

Details

The validity of the compatibility with C# is achieved by comparing the data against fixtures generated in C#. Specifically, the file test/fixtureSource.cs is responsible for generating all the files in the directory test/fixture/*. Then the tests in test/BinaryReader.fixtures.*.test.ts attempt to read the files and compare the value provideded with static values stored in the test file.

There are some small well-document quirks to be aware of:

  • Using readLong and readUnsignedLong risks losing precision with really big numbers because JavaScript only supports double type.
  • Using writeLong and writeUnsignedLong with numbers instead of strings risks losing precision with really big numbers because JavaScript only supports double type.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Links