any_base

Description:

any base

Any Base #
Convert numbers from any base (radix) to any other base using any
alphabet of digits.
Example #
// Flickr Base 58 alphabet.
const flickr58 = '123456789abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ';
const dec2hex = AnyBase(AnyBase.dec, AnyBase.hex);
const dec2flickr = AnyBase(AnyBase.dec, flickr58);

dec2hex.convert('123456'); // returns '1e240'.
dec2flickr.convert('1234567890'); // returns '2T6u2h'.
dec2flickr.revert('2T6u2h'); // returns '1234567890'.
copied to clipboard
API #
AnyBase() #

Returns an AnyBase object that can be used to convert input from the
source alphabet to the destination alphabet, extrapolating the radices
from the lengths of the alphabets.
Example
const anyBase = const AnyBase(sourceAlphabet, destinationAlphabet);
copied to clipboard
Parameters

String sourceAlphabet digits in ascending order.
String destinationAlphabet digits in ascending order.

Ascending order meaning from lowest value to highest. For example
'0123456789' in decimal.
AnyBase.convert() #

Returns the input value mapped from the source alphabet to the
destination alphabet. For example, if the input value was '10' and the
input alphabet was AnyBase.dec (for decimal) and the output alphabet
was AnyBase.hex (for hexadecimal) the return value would be 'a';
Example
const anyBase = const AnyBase(sourceAlphabet, destinationAlphabet);
anyBase.convert(source);
copied to clipboard
Parameters

String source Input value as String. For example '10'.

AnyBase.revert() #

Performs the converse action of convert.
Example
const anyBase = const AnyBase(sourceAlphabet, destinationAlphabet);
anyBase.revert(source);
copied to clipboard
Parameters

String source Input value as String. For example 'a'.

Static Members #


String AnyBase.dec Predefined alphabet for decimal numbers.
String AnyBase.hex Predefined alphabet for hexadecimal numbers.
String AnyBase.bin Predefined alphabet for binary numbers.
String AnyBase.oct Predefined alphabet for octal numbers.

Attributions #
The original algorithm was converted from Kamil Harasimowicz's
any-base npm project. A
copy of the project's license can be found in the LICENSE
file under the section any-base algorithm.