debian man page for convert::base32

Convert::Base32(3pm)					User Contributed Perl Documentation				      Convert::Base32(3pm)

NAME
       Convert::Base32 - Encoding and decoding of base32 strings

SYNOPSIS
	 use Convert::Base32;

	 $encoded = encode_base32("x3ax27x0fx93");
	 $decoded = decode_base32($encoded);

DESCRIPTION
       This module provides functions to convert string from / to Base32 encoding, specified in RACE internet-draft. The Base32 encoding is
       designed to encode non-ASCII characters in DNS-compatible host name parts.

       See http://tools.ietf.org/html/draft-ietf-idn-race-03 for more details.

FUNCTIONS
       Following functions are provided; like "MIME::Base64", they are in @EXPORT array. See Exporter for details.

       encode_base32($str)
	   Encode data by calling the encode_base32() function. This function takes a string of bytes to encode and returns the encoded base32
	   string.

       decode_base32($str)
	   Decode a base32 string by calling the decode_base32() function. This function takes a string to decode and returns the decoded string.

	   This function might throw the exceptions such as "Data contains non-base32 characters", "Length of data invalid" and "Padding bits at
	   the end of output buffer are not all zero".

	   decode_base32 differs from the specification in that upper case letters are treated as their lower case equivalent rather than
	   producing an error.

AUTHOR
       Tatsuhiko Miyagawa <miyagawa@bulknews.net>

       Eric Brine <ikegami@adaelis.com>

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO
       http://www.ietf.org/internet-drafts/draft-ietf-idn-race-03.txt, MIME::Base64, Convert::RACE.

perl v5.14.2							    2012-03-31						      Convert::Base32(3pm)