[](https://travis-ci.org/Kaiepi/p6-Net-LibIDN)
NAME
====
Net::LibIDN - Perl 6 bindings for GNU LibIDN
SYNOPSIS
========
use Net::LibIDN;
my $idna := Net::LibIDN.new;
my $domain := "m\xFC\xDFli.de";
my Int $code;
my $ace := $idna.to_ascii_8z($domain, 0, $code);
say "$ace $code"; # xn--mssli-kva.de 0
my $domain2 := $idna.to_unicode_8z8z($domain, 0, $code);
say "$domain2 $code"; # müssli.de 0
DESCRIPTION
===========
Net::LibIDN is a wrapper for the GNU LibIDN library. It provides bindings for its IDNA, Punycode, stringprep, and TLD functions. See Net::LibIDN::Punycode, Net::LibIDN::StringPrep, and Net::LibIDN::TLD for more documentation.
METHODS
=======
* **Net::LibIDN.to_ascii_8z**(Str *$input* --> Str)
* **Net::LibIDN.to_ascii_8z**(Str *$input*, Int *$flags* --> Str)
* **Net::LibIDN.to_ascii_8z**(Str *$input*, Int *$flags*, Int *$code* is rw --> Str)
Converts a UTF8 encoded string *$input* to ASCII and returns the output. *$code*, if provided, is assigned to *IDNA_SUCCESS* on success, or another error code otherwise.
* **Net::LibIDN.to_unicode_8z8z**(Str *$input* --> Str)
* **Net::LibIDN.to_unicode_8z8z**(Str *$input*, Int *$flags* --> Str)
* **Net::LibIDN.to_unicode_8z8z**(Str *$input*, Int *$flags*, Int *$code* is rw --> Str)
Converts an ACE encoded domain name *$input* to UTF8 and returns the output. *$code*, if provided, is assigned to *IDNA_SUCCESS* on success, or another error code otherwise.
CONSTANTS
=========
* Int **IDNA_ACE_PREFIX**
String containing the official IDNA prefix, "xn--".
FLAGS
-----
* Int **IDNA_ALLOW_UNASSIGNED**
Allow unassigned Unicode codepoints.
* Int **IDNA_USE_STD3_ASCII_RULES**
Check output to ensure it is a STD3 conforming hostname.
ERRORS
------
* Int **IDNA_SUCCESS**
Successful operation.
* Int **IDNA_STRINGPREP_ERROR**
Error during string preparation.
* Int **IDNA_PUNYCODE_ERROR**
Error during punycode operation.
* Int **IDNA_CONTAINS_NON_LDH**
*IDNA_USE_STD3_ASCII_RULES* flag was passed, but the given string contained non-LDH ASCII characters.
* Int **IDNA_CONTAINS_MINUS**
*IDNA_USE_STD3_ASCII_RULES* flag was passed, but the given string contained a leading or trailing hyphen-minus (u002D).
* Int **IDNA_INVALID_LENGTH**
The final output string is not within the range of 1 to 63 characters.
* Int **IDNA_NO_ACE_PREFIX**
The string does not begin with *IDNA_ACE_PREFIX* (for ToUnicode).
* Int **IDNA_ROUNDTRIP_VERIFY_ERROR**
The ToASCII operation on the output string does not equal the input.
* Int **IDNA_CONTAINS_ACE_PREFIX**
The input string begins with *IDNA_ACE_PREFIX* (for ToASCII).
* Int **IDNA_ICONV_ERROR**
Could not convert string to locale encoding.
* Int **IDNA_MALLOC_ERROR**
Could not allocate buffer (this is typically a fatal error).
* Int **IDNA_DLOPEN_ERROR**
Could not dlopen the libcidn DSO (only used internally in LibC).
AUTHOR
======
Ben Davies <kaiepi@outlook.com>
COPYRIGHT AND LICENSE
=====================
Copyright 2018 Ben Davies
This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.