arcsecond-binary
v1.2.0
Published
arcsecond parsers for binary data
Downloads
10,524
Readme
Arcsecond Binary
Binary parsers for arcsecond v3!
Before opening an issue, check to see if your question has been answered in the FAQ!
Parser Input
The input for an arcsecond-binary
parser can be a DataView, ArrayBuffer, TypedArray, or string.
If you have a Node Buffer
Although the underlying representation of a node Buffer
is an ArrayBuffer
, when accessing the the ArrayBuffer
through the .buffer
property, the data may not be as expected. If the buffer size is smaller than node's default pool size, then the ArrayBuffer
will be created with the pool size, and the actual data will be somewhere inside the ArrayBuffer
, with seemingly random data surrounding it. To avoid these issues, it's best to first cast a node Buffer
to a Uint8Array
, will will ensure that the ArrayBuffer
properly correlates to the expected data.
const asUint8Array = new Uint8Array(nodeBuffer);
new DataView(asUint8Array.buffer);
API
Click here for the main arcsecond
API docs. As arcsecond-binary is just a supplementary library, all of the parsers from both arcsecond and arcsecond binary can be used together.
u8
u8 :: Parser String Number a
u8
consumes exactly one byte, and returns a match that interprets the result as an unsigned integer in the range [0, 255].
Example
const input = new Uint8Array([0x48, 0x45, 0x4c, 0x4c, 0x4f]);
u8.run(input);
// -> {
// isError: false,
// result: 72,
// index: 1,
// data: null
// }
s8
s8 :: Parser String Number a
s8
consumes exactly one byte, and returns a match that interprets the result as a signed integer in the range [-128, 127].
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
s8.run(input);
// -> {
// isError: false,
// result: -106,
// index: 1,
// data: null
// }
u16LE
u16LE :: Parser String Number a
u16LE
consumes exactly two bytes, read in little endian order, and returns a match that interprets the result as an unsigned integer in the range [0, 65535].
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
u16LE.run(input);
// -> {
// isError: false,
// result: 17814,
// index: 2,
// data: null
// }
u16BE
u16BE :: Parser String Number a
u16BE
consumes exactly two bytes, read in big endian order, and returns a match that interprets the result as an unsigned integer in the range [0, 65535].
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
u16BE.run(input);
// -> {
// isError: false,
// result: 38469,
// index: 2,
// data: null
// }
s16LE
s16LE :: Parser String Number a
s16LE
consumes exactly two bytes, read in little endian order, and returns a match that interprets the result as a signed integer in the range [-32768, 32767].
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
s16LE.run(input);
// -> {
// isError: false,
// result: 17814,
// index: 2,
// data: null
// }
s16BE
s16BE :: Parser String Number a
s16BE
consumes exactly two bytes, read in big endian order, and returns a match that interprets the result as a signed integer in the range [-32768, 32767].
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
s16BE.run(input);
// -> {
// isError: false,
// result: -27067,
// index: 2,
// data: null
// }
u32LE
u32LE :: Parser String Number a
u32LE
consumes exactly four bytes, read in little endian order, and returns a match that interprets the result as an unsigned integer in the range [0, 4294967295].
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
u32LE.run(input);
// -> {
// isError: false,
// result: 1280066966,
// index: 4,
// data: null
// }
u32BE
u32BE :: Parser String Number a
u32BE
consumes exactly four bytes, read in big endian order, and returns a match that interprets the result as an unsigned integer in the range [0, 4294967295].
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
u32BE.run(input);
// -> {
// isError: false,
// result: 2521123916,
// index: 4,
// data: null
// }
s32LE
s32LE :: Parser String Number a
s32LE
consumes exactly four bytes, read in little endian order, and returns a match that interprets the result as a signed integer in the range [-2147483648, 2147483647].
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
s32LE.run(input);
// -> {
// isError: false,
// result: 1280066966,
// index: 4,
// data: null
// }
s32BE
s32BE :: Parser String Number a
s32BE
consumes exactly four bytes, read in big endian order, and returns a match that interprets the result as a signed integer in the range [-2147483648, 2147483647].
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
s32BE.run(input);
// -> {
// isError: false,
// result: -1773843380,
// index: 4,
// data: null
// }
exactU8
exactU8 :: UnsignedByte -> Parser String Number a
exactU8
takes an unsigned byte b
, and consumes exactly one byte, matching a value equal to b
, when interpreted as an unsigned integer.
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
exactU8(0x96).run(input);
// -> {
// isError: false,
// result: 150,
// index: 1,
// data: null
// }
exactS8
exactS8 :: SignedByte -> Parser String Number a
exactS8
takes a signed byte b
, and consumes exactly one byte, matching a value equal to b
, when interpreted as a signed integer.
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
exactS8(-106).run(input);
// -> {
// isError: false,
// result: -106,
// index: 1,
// data: null
// }
exactU16LE
exactU16LE :: UnsignedU16 -> Parser String Number a
exactU16LE
takes an unsigned 16-bit number b
, and consumes exactly two bytes, matching a value equal to b
, when interpreted as an unsigned integer in little endian order.
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
exactU16LE(0x4596).run(input);
// -> {
// isError: false,
// result: 17814,
// index: 1,
// data: null
// }
exactU16BE
exactU16BE :: UnsignedU16 -> Parser String Number a
exactU16BE
takes an unsigned 16-bit number b
, and consumes exactly two bytes, matching a value equal to b
, when interpreted as an unsigned integer in big endian order.
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
exactU16BE(0x9645).run(input);
// -> {
// isError: false,
// result: 38469,
// index: 1,
// data: null
// }
exactS16LE
exactS16LE :: SignedU16 -> Parser String Number a
exactS16LE
takes an signed 16-bit number b
, and consumes exactly two bytes, matching a value equal to b
, when interpreted as a signed integer in little endian order.
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
exactS16LE(17814).run(input);
// -> {
// isError: false,
// result: 17814,
// index: 1,
// data: null
// }
exactS16BE
exactS16BE :: SignedU16 -> Parser String Number a
exactS16BE
takes an signed 16-bit number b
, and consumes exactly two bytes, matching a value equal to b
, when interpreted as a signed integer in big endian order.
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
exactS16BE(-27067).run(input);
// -> {
// isError: false,
// result: -27067,
// index: 1,
// data: null
// }
exactU32LE
exactU32LE :: UnsignedU32 -> Parser String Number a
exactU32LE
takes an unsigned 32-bit number b
, and consumes exactly four bytes, matching a value equal to b
, when interpreted as an unsigned integer in little endian order.
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
exactU32LE(0x4c4c4596).run(input);
// -> {
// isError: false,
// result: 1280066966,
// index: 1,
// data: null
// }
exactU32BE
exactU32BE :: UnsignedU32 -> Parser String Number a
exactU32BE
takes an unsigned 32-bit number b
, and consumes exactly four bytes, matching a value equal to b
, when interpreted as an unsigned integer in big endian order.
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
exactU32BE(0x96454c4c).run(input);
// -> {
// isError: false,
// result: 2521123916,
// index: 1,
// data: null
// }
exactS32LE
exactS32LE :: SignedU32 -> Parser String Number a
exactS32LE
takes an signed 32-bit number b
, and consumes exactly four bytes, matching a value equal to b
, when interpreted as a signed integer in little endian order.
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
exactS32LE(1280066966).run(input);
// -> {
// isError: false,
// result: 1280066966,
// index: 1,
// data: null
// }
exactS32BE
exactS32BE :: SignedU32 -> Parser String Number a
exactS32BE
takes an signed 32-bit number b
, and consumes exactly four bytes, matching a value equal to b
, when interpreted as a signed integer in big endian order.
Example
const input = new Uint8Array([0x96, 0x45, 0x4c, 0x4c, 0x4f]);
exactS32BE(-1773843380).run(input);
// -> {
// isError: false,
// result: -1773843380,
// index: 1,
// data: null
// }
nullTerminatedString
nullTerminatedString :: Parser String String a
nullTerminatedString
consumes as much input as possible until it matches a null byte (0x00
), matching a string made from the bytes interpreted as string data.
Example
const input = new Uint8Array([0x48, 0x45, 0x4c, 0x4c, 0x4f, 0x2e, 0x2e, 0x2e, 0x00]);
nullTerminatedString.run(input);
// -> {
// isError: false,
// result: 'HELLO...',
// index: 1,
// data: null
// }