1Convert::Base32(3)    User Contributed Perl Documentation   Convert::Base32(3)
2
3
4

NAME

6       Convert::Base32 - Encoding and decoding of base32 strings
7

SYNOPSIS

9         use Convert::Base32;
10
11         $encoded = encode_base32("\x3a\x27\x0f\x93");
12         $decoded = decode_base32($encoded);
13

DESCRIPTION

15       This module provides functions to convert string from / to Base32
16       encoding, specified in RACE internet-draft. The Base32 encoding is
17       designed to encode non-ASCII characters in DNS-compatible host name
18       parts.
19
20       See http://tools.ietf.org/html/draft-ietf-idn-race-03 for more details.
21

FUNCTIONS

23       Following functions are provided; like "MIME::Base64", they are in
24       @EXPORT array. See Exporter for details.
25
26       encode_base32($str)
27           Encode data by calling the encode_base32() function. This function
28           takes a string of bytes to encode and returns the encoded base32
29           string.
30
31       decode_base32($str)
32           Decode a base32 string by calling the decode_base32() function.
33           This function takes a string to decode and returns the decoded
34           string.
35
36           This function might throw the exceptions such as "Data contains
37           non-base32 characters", "Length of data invalid" and "Padding bits
38           at the end of output buffer are not all zero".
39
40           decode_base32 differs from the specification in that upper case
41           letters are treated as their lower case equivalent rather than
42           producing an error.
43

AUTHOR

45       Tatsuhiko Miyagawa <miyagawa@bulknews.net>
46
47       Eric Brine <ikegami@adaelis.com>
48
49       This library is free software; you can redistribute it and/or modify it
50       under the same terms as Perl itself.
51

SEE ALSO

53       http://www.ietf.org/internet-drafts/draft-ietf-idn-race-03.txt,
54       MIME::Base64, Convert::RACE.
55
56
57
58perl v5.36.0                      2022-07-22                Convert::Base32(3)
Impressum