summaryrefslogtreecommitdiffstats
path: root/perl/perl-Net-LibIDN/README
blob: b437dffdf55a8615b4d0603a9a8ab4ee1058f8c6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Net::LibIDN - Perl bindings for GNU Libidn

Provides bindings for GNU Libidn, a C library for handling
Internationalized Domain Names according to IDNA (RFC 3490), in a way
very much inspired by Turbo Fredriksson's PHP-IDN. There is currently
no support for Perl's unicode capabilities (man perlunicode). All input
strings are assumed to be octet strings, all output strings are generated
as octet strings. Thus, if you require Perl's unicode features, you will
have to convert your strings manually. For example:

 use Encode;
 use Data::Dumper;
 print Dumper(Net::LibIDN::idn_to_unicode('xn--uro-j50a.com', 'utf-8'));
 print Dumper(decode(
       'utf-8', Net::LibIDN::idn_to_unicode('xn--uro-j50a.com', 'utf-8')));