NAME
Math::NumberBase - Number converter from one base to another base
SYNOPSIS
use Math::NumberBase;
# base 16 numbers: hexadecimal
my $base_16 = Math::NumberBase->new(16);
# base 4 numbers, but with custom symbols:
# 'w' = 0
# 'x' = 1
# 'y' = 2
# 'z' = 3
my $base_4 = Math::NumberBase->new(4, 'wxyz');
print $base_16->to_decimal('1ac2'), "\n";
print $base_16->from_decimal(325), "\n";
print $base_16->convert_to('1ac2', $base_4), "\n";
print $base_16->convert_from('yzxw', $base_4), "\n";DESCRIPTION
This class can convert a number from one base to another base.
By default, this class will use a subset of (0..9,'a'..'z') as the symbols. That means for base-16 numbers, the default symbols are 0,1,2,3,4,5,6,7,8,9,'a','b','c','d','e','f'. But you can always specify your own symbols by passing a string to the constructor.
METHODS
new(<integer>, <string>)
The constructor.
Receives 2 optional parameters: $base and $symbols.
If no paramteres passed to constructor, the base would be 10, and the symbols would be 0,1,2,3,4,5,6,7,8,9, thus it makes a normal decimal number system.
If only $base is passed to constructor, the $symbols would be a subset of (0..9,'a'..'z'). That means if you pass a number greater than 36 to the constructor you have to define the symbols you want to use to represent the number.
$base has to be an integer >= 2.
$symbols should be a string.
get_base( )
Returns the base.
get_symbols( )
Returns an arrayref of symbols.
my $base_3 = Math::NumberBase->new(3, 'abc');
my $symbols = $base_3->get_symbols();
# $symbols = ['a', 'b', 'c'];get_symbol_value_map( )
Returns a hashref of symbol => value map.
my $base_3 = Math::NumberBase->new(3, 'abc');
my $symbol_map = $base_3->get_symbol_value_map();
# $symbol_map = {
# 'a' => 0,
# 'b' => 1,
# 'c' => 2
# };to_decimal(<string>)
Convert to decimal.
my $base_3 = Math::NumberBase->new(3, 'abc');
# convert 'cab' in base 3 to a decimal number
my $in_decimal = $base_3->to_decimal('cab');
# $in_decimal = 19;from_decimal(<integer>)
Convert from decimal.
my $base_3 = Math::NumberBase->new(3, 'abc');
# convert 19 decimal to a base 3 number
my $in_base_3 = $base_3->from_decimal(19);
# $in_base_3 = 'cab';convert_to(<string>, <Math::NumberBase object>)
Convert a number from this base to another base.
my $base_3 = Math::NumberBase->new(3, 'abc');
my $base_4 = Math::NumberBase->new(4);
# convert 'cab' in base 3 to a base 4 number
my $in_base_4 = $base_3->convert_to('cab', $base_4);
# $in_base_4 = '103';convert_from(<string>, <Math::NumberBase object>)
Convert a number from another base to this base.
my $base_3 = Math::NumberBase->new(3, 'abc');
my $base_4 = Math::NumberBase->new(4);
# convert 'cab' in base 3 to a base 4 number
my $in_base_4 = $base_4->convert_from('cab', $base_3);
# $in_base_4 = '103';AUTHOR
Yehezkiel Syamsuhadi <yehezkielbs@gmail.com>
COPYRIGHT AND LICENSE
Copyright (C) 2009 by Yehezkiel Syamsuhadi
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.0 or, at your option, any later version of Perl 5 you may have available.