1Net::IDN::Nameprep(3) User Contributed Perl DocumentationNet::IDN::Nameprep(3)
2
3
4

NAME

6       Net::IDN::Nameprep - A Stringprep Profile for Internationalized Domain
7       Names (RFC 3491)
8

SYNOPSIS

10         use Net::IDN::Nameprep;
11         $output = nameprep $input;
12

DESCRIPTION

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

FUNCTIONS

23       This module implements a single function, "nameprep", which is exported
24       by default.
25
26       nameprep( $input [, AllowUnassigned => 1 ] )
27           Processes $input according to the nameprep specification and
28           returns the result.
29
30           If $input contains characters not allowed for nameprep, it throws
31           an exception (so use "eval" if necessary).
32
33           This function takes the following optional parameter:
34
35           AllowUnassigned
36               (boolean) If set to a false value, unassigned code points in
37               $input are not allowed.
38
39               False MUST be used for stored strings.
40
41               True MAY be used for queries.
42
43               The default is true (backwards compatibility).
44

AUTHOR

46       Claus Faerber <CFAERBER@cpan.org>
47
48       Previous versions written by Tatsuhiko Miyagawa <miyagawa@bulknews.net>
49

LICENSE

51       Copyright 2007-2015 Claus Faerber.
52
53       This library is free software; you can redistribute it and/or modify it
54       under the same terms as Perl itself.
55

SEE ALSO

57       Unicode::Stringprep, RFC 3491 (<http://www.ietf.org/rfc/rfc3491.txt>)
58
59
60
61perl v5.34.0                      2021-07-22             Net::IDN::Nameprep(3)
Impressum