bitwise

JavaScript/TypeScript library to manipulate bits, nibbles, bytes, and buffers.

Example

importbitwisefrom'bitwise'constbits=bitwise.byte.read(42)// [0, 0, 1, 0, 1, 0, 1, 0]bitwise.bits.toString(bits,4)// '0010 1010'bitwise.byte.write(bits)// 42bitwise.bits.and([0,0,1,1],[0,1,0,1])// [0, 0, 0, 1]bitwise.bits.xor([0,0,1,1],[0,1,0,1])// [0, 1, 1, 0]// cherry-pick parts of bitwiseimportbytefrom'bitwise/byte'byte.read(42)// [0, 0, 1, 0, 1, 0, 1, 0]

Installation

yarn add bitwise

or

npm i bitwise

bits
- operations (and, circularShiftLeft, circularShiftRight, nand, nor, not, or, xnor, xor)
- reduce operations (reduceAnd, reduceNand, reduceNor, reduceOr, reduceXnor, reduceXor)
- toString
buffer
- create
- modify
- operations (and, nand, nor, not, or, xnor, xor)
- read
- readInt
- readUInt
byte
- read
- write
integer
nibble
- read
- write
string
- toBits

bits

// cherry-pickimportandfrom'bitwise/bits/and'importbitsfrom'bitwise/bits'importtoStringfrom'bitwise/bits/to-string'

bits.and

(bits1: Array<0|1>,bits2: Array<0|1>): Array<0|1>

Applies the bitwise AND operation, expects two arrays of the same size and returns a new one.

bitwise.bits.and([1,0,0,0,1,1,0,1],[0,1,1,0,0,1,0,0])// [0, 0, 0, 0, 0, 1, 0, 0]

bits.circularShiftLeft

(bits: Array<0|1>,amount: number): Array<0|1>

Applies the bitwise ROL operation, expects two arrays of the same size and a shift amount and returns a new one.

bitwise.bits.circularShiftLeft([0,0,0,1,1,1,1,1],1)// [0, 0, 1, 1, 1, 1, 1, 0]

bits.circularShiftRight

(bits: Array<0|1>,amount: number): Array<0|1>

Applies the bitwise ROR operation, expects two arrays of the same size and a shift amount and returns a new one.

bitwise.bits.circularShiftRight([0,0,0,1,1,1,1,1],1)// [1, 0, 0, 0, 1, 1, 1, 1]

bits.nand

(bits1: Array<0|1>,bits2: Array<0|1>): Array<0|1>

Applies the bitwise NAND operation, expects two arrays of the same size and returns a new one.

bitwise.bits.nand([1,0,0,0,1,1,0,1],[0,1,1,0,0,1,0,0])// [1, 1, 1, 0, 1, 0, 0, 1]

bits.nor

(bits1: Array<0|1>,bits2: Array<0|1>): Array<0|1>

Applies the bitwise NOR operation, expects two arrays of the same size and returns a new one.

bitwise.bits.nor([1,0,0,0,1,1,0,1],[0,1,1,0,0,1,0,0])// [1, 1, 1, 0, 1, 0, 0, 1]

bits.not

(bits: Array<0|1>): Array<0|1>

Flips all given bits and returns the flipped bits.

bitwise.bits.not([1,0,1,1,0,1])// [0, 1, 0, 0, 1, 0]

bits.or

(bits1: Array<0|1>,bits2: Array<0|1>): Array<0|1>

Applies the bitwise OR operation, expects two arrays of the same size and returns a new one.

bitwise.bits.or([1,0,0,0,1,1,0,1],[0,1,1,0,0,1,0,0])// [1, 1, 1, 0, 1, 1, 0, 1]

bits.xnor

(bits1: Array<0|1>,bits2: Array<0|1>): Array<0|1>

Applies the bitwise exclusive NOR operation, expects two arrays of the same size and returns a new one.

bitwise.bits.xnor([1,0,0,0,1,1,0,1],[0,1,1,0,0,1,0,0])// [1, 1, 1, 0, 1, 0, 0, 1]

bits.xor

(bits1: Array<0|1>,bits2: Array<0|1>): Array<0|1>

Applies the bitwise exclusive OR operation, expects two arrays of the same size and returns a new one.

bitwise.bits.xor([1,0,0,0,1,1,0,1],[0,1,1,0,0,1,0,0])// [1, 1, 1, 0, 1, 0, 0, 1]

bits.reduceAnd

(bits: Array<0|1>): 0|1

Applies the bitwise AND operation on the given bits. Returns one bit. Throws if less than 2 bits are given.

bitwise.bits.reduceAnd([1,0,0,0,1,1,0,1])// 0

bits.reduceNand

(bits: Array<0|1>): 0|1

Applies the NAND operation on the given bits. Returns one bit. Throws if less than 2 bits are given.

bitwise.bits.reduceNand([1,0,0,0,1,1,0,1])// 0

bits.reduceNor

(bits: Array<0|1>): 0|1

Applies the NOR operation on the given bits. Returns one bit. Throws if less than 2 bits are given.

bitwise.bits.reduceNor([1,0,0,0,1,1,0,1])// 0

bits.reduceOr

(bits: Array<0|1>): 0|1

Applies the OR operation on the given bits. Returns one bit. Throws if less than 2 bits are given.

bitwise.bits.reduceOr([1,0,0,0,1,1,0,1])// 1

bits.reduceXnor

(bits: Array<0|1>): 0|1

Applies the XNOR operation on the given bits. Returns one bit. Throws if less than 2 bits are given.

bitwise.bits.reduceXnor([1,0,0,0,1,1,0,1])// 1

bits.reduceXor

(bits: Array<0|1>): 0|1

Applies the XOR operation on the given bits. Returns one bit. Throws if less than 2 bits are given.

bitwise.bits.reduceXor([1,0,0,0,1,1,0,1])// 0

bits.toBoolean

(bits: Array<0|1>): Array<boolean>

Converts a bit array to a boolean array.

bitwise.bits.toBoolean([0,1])// [false, true]

bits.toString

(bits: Array<0|1>,spacing: number=0,spacer: string=' '): string

Converts a bit Array to a String. If defined, inserts spacer every spacing characters, but never inserts it as the last substring.

bitwise.bits.toString([1,0,1,0,1,0],2,'_')// '10_10_10'

buffer

// cherry-pickimportandfrom'bitwise/buffer/and'importbufferfrom'bitwise/buffer'importcreatefrom'bitwise/buffer/create'

buffer.create

(bits: Array<0|1>): Buffer

Creates a new buffer and writes the given bits.

constbuffer=bitwise.buffer.create([1,1,1,1,0,0,0,1,1,0,1,0])// Buffer(1111 0001 1010 0000)

buffer.modify

(buffer: Buffer,newBits: Array<0|1>,bitOffset: number=0): void

Modifies the buffer's bits to equal newBits starting at bitOffset.

constbuffer=Buffer.from('A43A','hex')bitwise.buffer.modify(buffer,[0,0,0,1,0,0,1],3)// Buffer(1010 1001 0011 1010)

buffer.and

(buffer1: Buffer,buffer2: Buffer,isLooping=false): Buffer

Applies a bitwise AND with buffer2 to every value in buffer1. Returns a new buffer. If isLooping is set, buffer1 may be read multiple times in case it's shorter than buffer2.

bitwise.buffer.and(buffer1,buffer2,false)// Buffer(buffer1 AND buffer2)

buffer.nand

(buffer1: Buffer,buffer2: Buffer,isLooping=false): Buffer

Applies a bitwise NAND with buffer2 to every value in buffer1. Returns a new buffer. If isLooping is set, buffer1 may be read multiple times in case it's shorter than buffer2.

bitwise.buffer.nand(buffer1,buffer2,false)// Buffer(buffer1 NAND buffer2)

buffer.nor

(buffer1: Buffer,buffer2: Buffer,isLooping=false): Buffer

Applies a bitwise NOR with buffer2 to every value in buffer1. Returns a new buffer. If isLooping is set, buffer1 may be read multiple times in case it's shorter than buffer2.

bitwise.buffer.nor(buffer1,buffer2,false)// Buffer(buffer1 NOR buffer2)

buffer.not

(buffer: Buffer): Buffer

Flips all bits in the given buffer.

bitwise.buffer.not(buffer,false)// Buffer(NOT buffer)

buffer.or

(buffer1: Buffer,buffer2: Buffer,isLooping=false): Buffer

Applies a bitwise OR with buffer2 to every value in buffer1. Returns a new buffer. If isLooping is set, buffer1 may be read multiple times in case it's shorter than buffer2.

bitwise.buffer.or(buffer1,buffer2,false)// Buffer(buffer1 OR buffer2)

buffer.xnor

(buffer1: Buffer,buffer2: Buffer,isLooping=false): Buffer

Applies a bitwise XNOR with buffer2 to every value in buffer1. Returns a new buffer. If isLooping is set, buffer1 may be read multiple times in case it's shorter than buffer2.

bitwise.buffer.xnor(buffer1,buffer2,false)// Buffer(buffer1 XNOR buffer2)

buffer.xor

(buffer1: Buffer,buffer2: Buffer,isLooping=false): Buffer

Applies a bitwise XOR with buffer2 to every value in buffer1. Returns a new buffer. If isLooping is set, buffer1 may be read multiple times in case it's shorter than buffer2.

bitwise.buffer.xor(buffer1,buffer2,false)// Buffer(buffer1 XOR buffer2)

buffer.read

(buffer: Buffer,bitOffset: number=0,bitLength?: number): Array<0|1>

Returns an Array containing bitLength bits starting at bitOffset. If no bitLength is given, it's assumed to be the rest of the buffer.

constbuffer=Buffer.from('ED743E17','hex')bitwise.buffer.read(buffer,12)// [0, 1, 0, 0, 0, 0, 1, 1, 1, 1, 1, 0, 0, 0, 0, 1, 0, 1, 1, 1]

buffer.readInt

(buffer: Buffer,bitOffset: number=0,bitLength: number=8): number

Converts a section of a buffer to a signed integer.

// buffer 11110110bitwise.buffer.readInt(buffer,3,5)// -10

buffer.readUInt

(buffer: Buffer,bitOffset: number=0,bitLength: number=8): number

Converts a section of a buffer to an unsigned integer.

// buffer 11110110bitwise.buffer.readUInt(buffer,3,5)// 22

byte

// cherry-pickimportbytefrom'bitwise/byte'importreadfrom'bitwise/byte/read'

byte.read

(byte: UInt8): Array<0|1>

Returns an Array of length 8 containing the read bits.

bitwise.byte.read(42)// [0, 0, 1, 0, 1, 0, 1, 0]bitwise.byte.read(256)// RangeError('invalid size')

byte.write

(bits: Array<0|1>): UInt8

Returns a Byte (0-255) which represents the given bits.

bitwise.byte.write([0,0,1,0,1,0,1,0])// 42bitwise.byte.write([0,0,1,0,1,0,1,0,0])// RangeError('invalid array length')

integer

// cherry-pickimportintegerfrom'bitwise/integer'

integer.getBit

(number: number,position: number): 0|1

Gets the value of a specific bit.

bitwise.integer.getBit(128,7)// 1

integer.setBit

(number: number,position: number,value: 0|1): Array<0|1>

Sets the value of a specific bit.

bitwise.integer.setBit(128,7,0)// 0

integer.toggleBit

(number: number,position: number): Array<0|1>

Toggles the value of a specific bit.

bitwise.integer.toggleBit(128,7)// 0

nibble

// cherry-pickimportnibblefrom'bitwise/nibble'importreadfrom'bitwise/nibble/read'

nibble.read

(nibble: UInt4): Array<0|1>

Returns an Array of length 4 containing the read bits.

bitwise.nibble.read(15)// [1, 1, 1, 1]bitwise.nibble.read(42)// RangeError('invalid size')

nibble.write

(nibble: [<0|1>,<0|1>,<0|1>,<0|1>]): UInt4

Returns a Nibble (0-15) which represents the given bits.

bitwise.nibble.write([0,0,1,0])// 2bitwise.nibble.write([0,0,1,0,1])// RangeError('invalid array length')

string

// cherry-pickimportstringfrom'bitwise/string'importtoBitsfrom'bitwise/string/to-bits'

string.toBits

(string: string): Array<0|1>

Converts a string into an array of bits. Ignores all characters except 1 and 0.

bitwise.string.toBits('10 10 12$%_.0')// [1, 0, 1, 0, 1, 0]

History

2.1.0

Add bits.circularShiftLeft (#44 / #49) via @0xflotus
Add bits.circularShiftRight (#44 / #49) via @0xflotus

2.0.2–2.0.3

Add Support for Tree Shaking

2.0.1

Readme/package.json updates

2.0.0

refactor to typescript
remove bitwise.buffer.readCInt()

1.4.0

improve require() support

1.3.0

add bits.toBoolean

1.2.0

add bits.reduceAnd
add bits.reduceNand
add bits.reduceNor
add bits.reduceOr
add bits.reduceXnor
add bits.reduceXor

1.1.2

split up buffer.operations

1.1.1

split up bits.operations

1.1.0

add integer.getBit
add integer.setBit
add integer.toggleBit

1.0.0

rewrite in ES6
improve utilization of bitwise operators
improve API (breaking change)

0.2.0

Added buffer bitwise operations

0.1.2

Added nor, xnor, nand
Fixed bitwise operations modifying original array

0.1.0

Re-ordered the arguments in readInt, readCInt, readUInt
Added not, and, or, xor
Renamed flipBits to not

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
.vscode		.vscode
.yarn		.yarn
source		source
.codeclimate.yml		.codeclimate.yml
.gitignore		.gitignore
.npmignore		.npmignore
.pnp.js		.pnp.js
.yarnrc.yml		.yarnrc.yml
license.md		license.md
package.json		package.json
readme.md		readme.md
tsconfig.json		tsconfig.json
tsconfig.treeshake.json		tsconfig.treeshake.json
yarn.lock		yarn.lock

Latest commit

History

Folders and files

Repository files navigation

bitwise

Example

Installation

Table of Contents

bits

bits.and

bits.circularShiftLeft

bits.circularShiftRight

bits.nand

bits.nor

bits.not

bits.or

bits.xnor

bits.xor

bits.reduceAnd

bits.reduceNand

bits.reduceNor

bits.reduceOr

bits.reduceXnor

bits.reduceXor

bits.toBoolean

bits.toString

buffer

buffer.create

buffer.modify

buffer.and

buffer.nand

buffer.nor

buffer.not

buffer.or

buffer.xnor

buffer.xor

buffer.read

buffer.readInt

buffer.readUInt

byte

byte.read

byte.write

integer

integer.getBit

integer.setBit

integer.toggleBit

nibble

nibble.read

nibble.write

string

string.toBits

History

2.1.0

2.0.2–2.0.3

2.0.1

2.0.0

1.4.0

1.3.0

1.2.0

1.1.2

1.1.1

1.1.0

1.0.0

0.2.0

0.1.2

0.1.0

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages