Convert Binary

An NPM package to convert various data types to and from binary representation. Easily convert numbers, strings, hex, octal, and more to and from binary format.

Features

✅ Convert numbers, strings, hex, and more to binary
✅ Convert binary back to readable formats
✅ Supports floats, booleans, and bitwise operations
✅ No dependencies – lightweight and fast!

---

Installation

Install the package via npm:

npm install convert-binary

---

Importing

For CommonJS (Node.js Default)

const convert = require('convert-binary');

For ES Modules (ECMAScript Imports)

import convert from 'convert-binary';

---

Usage

Convert a number to binary

const { toBinaryFromNumber } = require('convert-binary');

console.log(toBinaryFromNumber(10));  
// Output: '1010'

Convert a string to binary

const { toBinaryFromString } = require('convert-binary');

console.log(toBinaryFromString("Hello"));  
// Output: '0100100001100101011011000110110001101111'

Convert binary to a number

const { binaryToNumber } = require('convert-binary');

console.log(binaryToNumber("1010"));  
// Output: 10

Convert binary to a string

const { binaryToString } = require('convert-binary');

console.log(binaryToString("0100100001100101011011000110110001101111"));  
// Output: 'Hello'

---

API Reference

Conversion Functions

Function	Description	Example Input	Example Output
toBinaryFromNumber(num)	Converts a number to binary.	10	"1010"
toBinaryFromString(str, encoding="utf-8")	Converts a string to binary.	"A"	"01000001"
toBinaryFromHex(hexStr)	Converts a hex string to binary.	"A"	"1010"
toBinaryFromOctal(octalStr)	Converts an octal string to binary.	"12"	"1010"
toBinaryFromBoolean(bool)	Converts a boolean to binary.	true	"1"
toBinaryFromFloat(floatNum)	Converts a floating point number to binary.	5.75	"01000000101110000000000000000000"

Binary to Other Formats

Function	Description	Example Input	Example Output
binaryToNumber(binStr)	Converts a binary string to a number.	"1010"	10
binaryToString(binStr, encoding="utf-8")	Converts binary to a string.	"01000001"	"A"
binaryToHex(binStr)	Converts binary to hex.	"1010"	"A"
binaryToOctal(binStr)	Converts binary to octal.	"1010"	"12"
binaryToBoolean(binStr)	Converts binary to a boolean.	"1"	true
binaryToFloat(binStr)	Converts binary to a float.	"01000000101110000000000000000000"	5.75

Binary Utility Functions

Function	Description	Example Input	Example Output
padBinary(binStr, length)	Pads a binary string with leading zeros.	"101", 8	"00000101"
chunkBinary(binStr, chunkSize)	Splits a binary string into chunks.	"11001100", 4	["1100", "1100"]
invertBinary(binStr)	Inverts (flips) binary bits.	"1010"	"0101"
xorBinary(bin1, bin2)	Performs XOR operation on two binary strings.	"1100", "1010"	"0110"
andBinary(bin1, bin2)	Performs AND operation on two binary strings.	"1100", "1010"	"1000"
orBinary(bin1, bin2)	Performs OR operation on two binary strings.	"1100", "1010"	"1110"
notBinary(binStr)	Performs NOT operation (bit inversion).	"1010"	"0101"
shiftBinaryLeft(binStr, places)	Shifts a binary string left by n places.	"1010", 2	"101000"
shiftBinaryRight(binStr, places)	Shifts a binary string right by n places.	"1010", 2	"10"

Contributing

Want to improve convert-binary? Follow these steps:

1. Fork the repo
2. Create a new branch
3. Commit your changes
4. Push to your branch
5. Submit a pull request!