Contents

= Synopsis

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.

  expect ArgumentError do
    255.to_s(37)
  end

Radix provides the means of converting to and from any base.

  require 'radix'

For example, a number in base 256 can be represented by the array [100, 10]
(ie. 100**256 + 10**1) and easily converted to base 10.

  [100,10].b(256).to_i  #=> 25610

We can get an Array representation as well.

  [100,10].b(256).to_a(10)  #=> [2,5,6,1,0]
  [100,10].b(256).to_a(62)  #=> [6,41,4]
  [100,10].b(256).to_a(64)  #=> [6,16,10]

To get a String representation for any base use #to_s.

  [100,10].b(256).to_s(10)  #=> "25610"
  [100,10].b(256).to_s(62)  #=> "6 41 4"
  [100,10].b(256).to_s(64)  #=> "6 16 10"

Notice that anything above base 10 is seperated by a space divider. The divider
can be changed by providing a second argument.

  [100,10].b(256).to_s(64, ':')  #=> "6:16:10"

A string representation of a number can be converted upto base 62 (B62).

  "10".b(62).to_s(10)  #=> "62"
  "zz".b(62).to_s(10)  #=> "3843"

To encode a number with a base greater than 10, use an Array base. Radix
provides a built-in set of these, such as `BASE::B62`.

  [100,10].b(256).to_s(Radix::BASE::B62)  #=> "6f4"

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 but useing a different encoding.

  base = %w[Q W E R T Y U I O U]

  "10".b(10).to_a(base)  #=> ["W", "Q"]

  "10".b(10).to_s(base)  #=> "WQ"

All of the above holds equally for floating point numbers.

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
radix-2.0.0	doc/01_synopsis.rdoc