Radix is a very easy to use Ruby library for converting numbers to and from any base. It supports both integers and rational numbers, as well as representational string-notations that need not be in ASCII order.
Convert to and from any base.
Convert Integers, Floats and Rational numbers.
Define custom encodings and character sets.
Can be used to encode/decode bytecode strings.
Very intuitive API.
Please see the HISTORY.rdoc file.
Base conversions with ASCII ordered notations are easy in Ruby.
255.to_s(16) #=> "FF" "FF".to_i(16) #=> 255
But Ruby reaches it’s limit at base 36.
255.to_s(37) #=> Error
Radix provides the means of converting to and from any base.
For example, a number in base 256 can be represented by the array [100, 10] (ie. 100**256 + 10**1) and can be convert to base 10.
[100,10].b(256).to_a(10) #=> [2,5,6,1,0]
Or, to get a string representation for any base upto 62.
[100,10].b(256).to_s(10) #=> "25610"
A string representation of anumber can be converted too, again, upto base 62.
"10".b(62).to_s(10) #=> "62"
To use a custom character set, use an array of characters as the base rather than an integer. For example we can convert a base 10 number to another base 10 number using a different encoding.
base = [:Q, :W, :E, :R, :T, :Y, :U, :I, :O, :U] "10".b(10).to_a(base) #=> [:W, :Q]
To learn more have a look at the QED.
To install with RubyGems simply open a console and type:
$ gem install radix
Radix follows Ruby Setup package standard.
Copyright © 2009 Thomas Sawyer
This program is ditributed unser the terms of the Apache 2.0 license.
See LICENSE file for details.