Binary stream writing and reading classes compatible with CSharp's BinaryReader and BinaryWriter.
This library was written in TypeScript but will also work in projects written in JavaScript.
Add it to your project via:
npm i --save csharp-binary-stream
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");
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
readLongandreadUnsignedLongrisks losing precision with really big numbers because JavaScript only supportsdoubletype. - Using
writeLongandwriteUnsignedLongwith numbers instead of strings risks losing precision with really big numbers because JavaScript only supportsdoubletype.
This project is licensed under the MIT License - see the LICENSE.md file for details