1.1.1 • Published 2 years ago

@sihuaguofen/base-converter v1.1.1

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

Base converter

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

Installation

if you are using yarn:

yarn add @sihuaguofen/base-converter

if you are using npm:

npm install @sihuaguofen/base-converter

Usage

Initialize

import { BaseConverter } from '@sihuaguofen/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 2748
baseConverter.convertFromBaseNToDecimal('101.11', 2) // returns 5.75

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

Convert 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)

Converts a number in 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