Data::Translate - Translate string data between a few patterns (binary,decimal,ascii,hex)

SYPNOSYS
use Data::Translate;
$data=new Translate;

# Example, translating from hex to Ascii # $s receives the status of the operation

@hh=qw(64 65 6e 61 6f);
($s,@ha)=$data->h2a(@hh);
print join('',@ha),"\n"; ## will output "denao"

DESCRIPTION

This module is intended to translate data between a few patterns. Basicly, it is a ease mode to pack/unpack stuff.

Imagine, you have a script that treats hex data, and you need to see the values, in other format, like decimal, binary or even ascii.

This module implements a symplistic way to Translate values smoothly returning the status of operation and values always on a string.

You may translate at this point:

• ascii to binary
• ascii to decimal
• ascii to hex
• decimal to ascii
• decimal to binary
• decimal to hex
• binary to ascii
• binary to decimal
• binary to hex
• hex to binary
• hex to decimal
• hex to ascii

Please, head to test.pl for additional examples. The functions you'll call, are defined as the first byte of each data type.
If you want to translate from binary to hex, you'll use the function b2h, and if you want to translate from ascii to decimal, you'll use a2d, and so on.

METHODS

->new

Creates a new instance of Translation.

eg.: $data=new Translate;

->a2b
Translate from ascii to binary
Ex.:

($s,$bin)=$data->a2b($str);

->a2d
Translate from ascii to decimal
Ex.:

($s,@dec)=$data->a2d($str);

->a2h
Translate from ascii to hexadecimal
Ex.:

($s,$hh)=$data->a2h($str);

->b2a
Translate from binary to ascii
Ex.:

($s,$asc)=$data->b2a($bin);

->b2d
Translate from binary to decimal
Ex.:

@t=unpack("A8" x (length($bin)/8),$bin); foreach $binary (@t) {

      ($s,$d)=$data->b2d($binary);
      print "--> $d\n";

}

->b2h
Translate from binary to hexadecimal
Ex.:

foreach $binary (@t) {

      ($s,$hx)=$data->b2h($binary);
      print "--> $hx\n";

}

->d2a
Translate from decimal to ascii
Ex.:

($s,@a)=$data->d2a(@dec);

->d2b
Translate from decimal to binary
Ex.:

($s,@b)=$data->d2b(@dec);

->d2h
Translate from decimal to hexadecimal
Ex.:

($s,@bh)=$data->d2h(@dec);

->h2a
Translate from hexadecimal to ascii
Ex.:

($s,@ha)=$data->h2a(@hh);

->h2b
Translate from hexadecimal to binary
Ex.:

($s,@hd)=$data->h2d(@hh);

->h2d
Translate from hexadecimal to decimal
Ex.:

($s,@hb)=$data->h2b(@hh);

INSTALLATION

perl Makefile.PL # build the Makefile

   make              # build the package
   make test         # test package
   make install      # Install package

AUTHOR
Denis Almeida Vieira Junior <davieira@uol.com.br>.

SEE ALSO

perl(1)