number-system

A number system conversion library. Supports binary, octal, decimal and hexadecimal.

Installation

$ npm install --save number-system

Usage

Creating Instance (TypeScript/JavaScript)

import NumberSystem from 'number-system';

// Creates a NumberSystem object that converts from decimal (base 10) to a target base
const ns = new NumberSystem(10);

Supported Bases

• 2 - Binary
• 8 - Octal
• 10 - Decimal
• 16 - Hexadecimal

Basic Conversion

// Assuming ns is initialized as new NumberSystem(10)

// Returns '1100011'
ns.bin(99);

// Returns '1100011'
ns.bin('99');

Available Conversion Methods

| Method | Description | Parameter | | :----- | :---------- | :-------- | | bin | Converts argument to binary | number or string value | | oct | Converts argument to octal | number or string value | | dec | Converts argument to decimal | number or string value | | hex | Converts argument to hexadecimal | number or string value |

Note: Use string arguments when converting hexadecimal values with alpha characters (e.g., '0xff').

Changing Base

// Assuming ns is initialized as new NumberSystem(10)

// Returns 10
console.log(ns.base);

// Changes the original base to hexadecimal (base 16)
ns.base = 16;

// Returns 16
console.log(ns.base);

// Returns '0143' (63 in octal)
ns.oct('0x63'); // Input is hexadecimal '0x63' (decimal 99), converted to octal

// Returns '99' (99 in decimal)
ns.dec('0x63'); // Input is hexadecimal '0x63' (decimal 99), converted to decimal

Development

Setup

1. Clone the repository:

   git clone https://github.com/patzj/number-system.git
   cd number-system

2. Install dependencies:

   npm install

Building

To compile the TypeScript source code into JavaScript and generate type definitions:

npm run build

The compiled output will be in the dist/ directory.

Testing

To run the test suite:

npm test

License

MIT