binary-numbers

Classes that make working with binary numbers easy!

Allows one to easily work with many different types of binary formats, from standard integer binary numbers to IEEE 754 floating point binary numbers. Also supports numbers which can either grow in size or remain fixed. Includes five different explicitly sizes fixed-length integer classes: Int8, Int16, Int32, Int64, and Int128.

This package is still in early development, and I'd like to make it as good as possible. If you have any suggestions, please open a pull request!

Usage

Bit Manipulation

1import { FixedInt } from 'binary-numbers';
2
3const int = new FixedInt(94)       // 0b1011110
4                    .clearBit(1)   // 0b1011100
5                    .clearBit(3)   // 0b1010100
6                    .setBit(5)     // 0b1110100
7                    .and(0x1F)     // 0b0010100
8                    .shiftLeft(2); // 0b1010000
9
10console.log(int.toDecimal); // 80

Arithmetic

1import { Int8 } from 'binary-numbers';
2
3// 12 + 48 + 61
4const i1 = new Int8(12);
5const i2 = new Int8('0b00110000'); // 48
6const i3 = new Int8([1, 0, 1, 1, 1, 1, 0, 0]); // 60, note the
7                                               // lsb -> msb convention
8
9const result = i1.add(i2).add(i3);
10
11console.log(result.toString()); // Int8[0b01111001]
12console.log(result.bits); // [1, 0, 0, 1, 1, 1, 1, 0]
13console.log(result.toDecimal) // 121

Floating Point

TODO

API

See the API Documentation

Install

With npm installed, run

$ npm install binary-numbers

License

MIT