{
    "mode": "perldoc",
    "parameter": "Net::IDN::Overview",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AIDN%3A%3AOverview/json",
    "generated": "2026-06-15T14:44:41Z",
    "sections": {
        "NAME": {
            "content": "Net::IDN::Overwiew - Internationalized Domain Names for Applications (IDNA)\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "The \"Net::IDN::*\" modules provide a framework for the handling of Internationalized Domain Names\nfor Applications (IDNA) in perl programmes.\n\nThis document provides an overview of the available modules in order to allow you to choose the\nbest module for the task at hand.\n\nAVAILABLE MODULES\nHIGH-LEVEL (USE THIS)\nNet::IDN::Encode\nprovides a high-level interface for converting domain names (and for convenience, email\naddresses).\n\nUse this module if you just want to convert domain names and don't care about how this is\ndone internally.\n\nCurrently, this module uses Net::IDN::UTS46. However, this might change in the future if\nanother specification (e.g. a revision of IDNA2008) becomes more appropriate.\n\nThe author aims for Net::IDN::Encode to always use the specification that will provide the\n\"least surprising\" results.\n\nSTANDARD-SPECIFIC\nThese modules implement different versions of the the IDNA specifications. Use one of these\nmodules only if you require compatibility with a specific incarnation of IDNA.\n\nNet::IDN::IDNA2003\nimplements the original IDNA specification, released in 2003 (IDNA2003), which is now\nobsolete.\n\nIDNA2003 is defined in RFC 3490 <http://tools.ietf.org/rfc/3490> and related documents.\n\nNet::IDN::UTS46\nimplements Unicode Technical Standard #46 (UTS #46 <http://unicode.org/reports/tr46/>),\nUnicode IDNA Compatibility Processing. This specification supports all domain names allowed\nunder either IDNA2003 or IDNA2008.\n\nENCODING\nNet::IDN::Punycode\nperforms the actual conversion between the ASCII and Unicode form of strings. Punycode is\ndefined in RFC 3492 <http://tools.ietf.org/rfc/3492> and related documents.\n\nUsually, it is not a good idea to use this module directly. If you convert domain labels (or\nother strings) without proper preparation, you may end up with an ASCII encoding that is not\ninteroperable or poses security issues due to spoofing.\n\nEven if you think that your domain names are valid and in already-mapped format, you might\nbe fooled by different Unicode normalization forms (for example, some environments might\nautomatically convert your data to NFD, which breaks IDNA).\n\nDEPRECATED/COMPATIBILITY\nThese modules are only maintained in order to not break applications that might rely on them\n\nEncode::Punycode\nprovides an Encode plugin for Punycode. As Punycode is not a general-purpose encoding, there\nare limited applications.\n\nIDNA::Punycode\nhas an API depending on global variables. Don't use this module.\n\nDISTRIBUTIONS\nNet-IDN-Encode\nis the main distribution covering the most common cases for converting domain names between\nASCII and Unicode.\n\nThe author tries to keep the dependency chain as small as possible; currently this\ndistribution only depends on perl 5.8.5 (including the core module Unicode::Normalize ).\n\nNet-IDN-IDNA2003\nprovides the Net::IDN::IDNA2003 module. This is separate because it has an dependency on\nUnicode::Stringprep (through Net::IDN::Nameprep).\n\nEncode-Punycode\nIDNA-Punycode\nare separate because they are of limited use to the average user/perl programmer.\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Claus Färber <CFAERBER@cpan.org>\n",
            "subsections": []
        }
    },
    "summary": "Net::IDN::Overwiew - Internationalized Domain Names for Applications (IDNA)",
    "flags": [],
    "examples": [],
    "see_also": []
}