NAME

       Net::IDN::Nameprep - A Stringprep Profile for Internationalized Domain Names (RFCA 3491)

SYNOPSIS

         use Net::IDN::Nameprep;
         $output = nameprep $input;

DESCRIPTION

       This module implements the nameprep specification, which describes how to prepare
       internationalized domain name (IDN) labels in order to increase the likelihood that name
       input and name comparison work in ways that make sense for typical users throughout the
       world.  Nameprep is a profile of the stringprep protocol and is used as part of a suite of
       on-the-wire protocols for internationalizing the Domain Name System (DNS).

FUNCTIONS

       This module implements a single function, "nameprep", which is exported by default.

       nameprep( $input [, AllowUnassigned => 1 ] )
           Processes $input according to the nameprep specification and returns the result.

           If $input contains characters not allowed for nameprep, it throws an exception (so use
           "eval" if necessary).

           This function takes the following optional parameter:

           AllowUnassigned
               (boolean) If set to a false value, unassigned code points in $input are not
               allowed.

               False MUST be used for stored strings.

               True MAY be used for queries.

               The default is true (backwards compatibility).

AUTHOR

       Claus Faerber <CFAERBER@cpan.org>

       Previous versions written by Tatsuhiko Miyagawa <miyagawa@bulknews.net>

LICENSE

       Copyright 2007-2010 Claus Faerber.

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

SEE ALSO

       Unicode::Stringprep, RFC 3491 (<http://www.ietf.org/rfc/rfc3491.txt>)