1.0.3 • Published 3 years ago

easy-base-converter v1.0.3

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

Easy Base Converter

badge

Base converter is a NPM Package useful for converting numbers from one base to another.

Installation

if you are using yarn:

yarn add easy-base-converter

if you are using npm

npm install easy-base-converter

Usage

Initialize

import { BaseConverter } from 'easy-base-converter';

const baseConverter = new BaseConverter();

API

convertFromBaseNToDecimal(numberToConvert: string, fromBase: number): number

Converts a number in base N to a decimal number. numberToConvert needs to be a string because when N is greater than or equal to 10, we need to use letters.

baseConverter.convertFromBaseNToDecimal('101', 2); //returns 5
baseConverter.convertFromBaseNToDecimal('ABC', 16); //returns 274
baseConverter.convertFromBaseNToDecimal('101.11', 2); //returns 5.75

convertFromDecimalToBaseN(numberToConvert: number, toBase: number, precision = 2): string

Converts a decimal number to a number in base N.

baseConverter.convertFromDecimalToBaseN(173, 16); //returns 'AD'
baseConverter.convertFromDecimalToBaseN(17.6, 3); //returns '122.12'

convert(numberToConvert: string, convertOptions: object): string

Converts a number from base N to a number in base M. The convertOptions contains the following properties:

convertOptions = {
  fromBase: number;
  toBase: number;
  precision: number = 2;
}
baseConverter.convert('78', { fromBase: 11, toBase: 6 }); // returns '221'
baseConverter.convert('45.5', { fromBase: 14, toBase: 2 }); // returns '111101.01'

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT