Skip to content

A library to convert to and from any base, including custom character sets. No dependencies.

License

Notifications You must be signed in to change notification settings

nvitaterna/bconvert

Repository files navigation

bconvert

CircleCI dependencies npm GitHub license

import bconvert from 'bconvert';

const hexCharset = '0123456789ABCDEF';

bconvert.convertTo(30, hexCharset);
// 1E

This is a library to convert to and from any base, including custom character sets. No dependencies.

Install

bconvert is a Node.js module available through the npm registry. You can install bconvert in your project's directory like any other package:

NPM
npm i bconvert

Yarn
yarn add bconvert

Documentation

import bconvert from 'bconvert';

or

const bconvert = require('bconvert');

After requiring or importing bconvert you have access to the following:

Converting via base10

Convert to any base

const charset = '01';

console.log(bconvert.convertTo(5, charset));
// 101

Convert from any base

const charset = bconvert.base64.charset;
// built in base64 charset

console.log(bconvert.convertFrom('U5', charset));
// 1337

Converting between bases

const Converter = bconvert.Converter;

const charsetTo = '0123456789ABCDEF';

const charsetFrom = '01';

const binaryHexConverter = new Converter(charsetTo, charsetFrom);

console.log(binaryHexConverter.convertTo('101101'));
// 2D

console.log(binaryHexConverter.convertFrom('FFE1'));
// 1111111111100001

Built-in Bases

The following number base systems are included in this package:

binary
octal
hexadecimal
base32
base32hex
base57
base60
base60new
base62
base64
base64url

To use these builtins, you may import/require them directly or access them at bconvert[builtinName]. All builtins export their charset, as well as convertTo and convertFrom:

import * as hexadecimal from 'bconvert/dist/builtins/hexadecimal';
// or
import bconvert from 'bconvert';
hexadecimal = bconvert.hexadecimal;

hexadecimal.charset;
// 0123456789ABCDEF

hexadecimal.convertTo(28);
// 1C

hexadecimal.convertFrom('1337');
// 4919

About

A library to convert to and from any base, including custom character sets. No dependencies.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages