Stream Buffers - .NET's BinaryReader facsimile for Node.js
This library wraps most of Buffer's methods. The difference with Buffer is that with streambuf you don't have to specify an offset each read/write operation, it uses an internal cursor.
If you're looking for a library that is more high-level and built on top of
streambuf, check out node-structor.
$ npm install streambuf
const fs = require('fs'); const StreamBuffer = require('streambuf'); let buffer = StreamBuffer.from(fs.readFileSync('hiscore.dat')); let nameLength = buffer.readUInt32LE(); let name = buffer.readString(nameLength); buffer.skip(-nameLength); // go back to the beginning of the name buffer.writeString(name.toUpperCase()); // overwrite the name in the buffer with something else
Refer to Buffer for a list of available read and write methods supported by StreamBuffer (omit the offset param).
Constructor: initialize with a Buffer object.
Constructor: initialize with another StreamBuffer object's underlying Buffer.
StreamBuffer numeric methods
readInt8, readInt16LE, readInt16BE, readInt32LE, readInt32BE, readUInt8, readUInt16LE, readUInt16BE, readUInt32LE, readUInt32BE, readFloatLE, readFloatBE, readDoubleLE, readDoubleBE writeInt8, writeInt16LE, writeInt16BE, writeInt32LE, writeInt32BE, writeUInt8, writeUInt16LE, writeUInt16BE, writeUInt32LE, writeUInt32BE, writeFloatLE, writeFloatBE, writeDoubleLE, writeDoubleBE
StreamBuffer BigInt methods
readBigInt64LE, readBigInt64BE, readBigUInt64LE, readBigUInt64BE, writeBigInt64LE, writeBigInt64BE, writeBigUInt64LE, writeBigUInt64BE
Provides raw access to the underlying Buffer object (read-only)
Returns a new StreamBuffer that references the same Buffer as the original, but cropped by offset and offset + numBytes.
Writes the contents of another Buffer.
Alias for .readUInt8()
Alias for .readInt8()
Alias for .writeUInt8()
Alias for .writeInt8()
Reads a 7 bit encoded integer, like those used by .NET
Writes a 7 bit encoded integer, like those used by .NET
Reads a single character from the buffer according to the specified character encoding. 'encoding' defaults to utf8.
Writes a single character to the buffer according to the specified character encoding. Multi-byte characters are not written - use
writeString for that instead.
'encoding' defaults to utf8.
Decodes to a string according to the specified character encoding in encoding and length. 'encoding' defaults to utf8. 'length' is optional. If left undefined, it will use the first occuring zero (0) byte as the end of the string.
Functions the same way as .readString(), but does not update the offset.
Writes a string to the underlying buffer with the specified encoding. 'encoding' defaults to utf8.
A specialized version of readString(), it first reads a 7 bit encoded integer and uses that as the length of the to be read string. Can be used to read strings written by .NET's BinaryWriter.
A specialized version of writeString(), it first writes a 7 bit encoded integer representing the length of the string, followed by the string.
Skips the specified number of bytes. A negative number can be used to rewind.
.setPos(pos) / .seek(pos)
Moves the offset to the specified pos.
.getPos() / .tell()
Returns the current offset.
Moves the offset back to 0.
Returns true if the end of the buffer is reached. (offset >= buffer.length)