{
    "content": [
        {
            "type": "text",
            "text": "# Net::DNS::Domain (perldoc)\n\n## NAME\n\nNet::DNS::Domain - DNS domains\n\n## SYNOPSIS\n\nuse Net::DNS::Domain;\n$domain = Net::DNS::Domain->new('example.com');\n$name   = $domain->name;\n\n## DESCRIPTION\n\nThe Net::DNS::Domain module implements a class of abstract DNS domain objects with associated\nclass and instance methods.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **METHODS**\n- **BUGS**\n- **COPYRIGHT**\n- **LICENSE**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "Net::DNS::Domain",
        "section": "",
        "mode": "perldoc",
        "summary": "Net::DNS::Domain - DNS domains",
        "synopsis": "use Net::DNS::Domain;\n$domain = Net::DNS::Domain->new('example.com');\n$name   = $domain->name;",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 5,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 12,
                "subsections": []
            },
            {
                "name": "METHODS",
                "lines": 68,
                "subsections": []
            },
            {
                "name": "BUGS",
                "lines": 5,
                "subsections": []
            },
            {
                "name": "COPYRIGHT",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "LICENSE",
                "lines": 12,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 2,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "Net::DNS::Domain - DNS domains\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "use Net::DNS::Domain;\n\n$domain = Net::DNS::Domain->new('example.com');\n$name   = $domain->name;\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "The Net::DNS::Domain module implements a class of abstract DNS domain objects with associated\nclass and instance methods.\n\nEach domain object instance represents a single DNS domain which has a fixed identity throughout\nits lifetime.\n\nInternally, the primary representation is a (possibly empty) list of ASCII domain name labels,\nand optional link to an origin domain object topologically closer to the DNS root.\n\nThe computational expense of Unicode character-set conversion is partially mitigated by use of\ncaches.\n",
                "subsections": []
            },
            "METHODS": {
                "content": "new\n$object = Net::DNS::Domain->new('example.com');\n\nCreates a domain object which represents the DNS domain specified by the character string\nargument. The argument consists of a sequence of labels delimited by dots.\n\nA character preceded by \\ represents itself, without any special interpretation.\n\nArbitrary 8-bit codes can be represented by \\ followed by exactly three decimal digits.\nCharacter code points are ASCII, irrespective of the character coding scheme employed by the\nunderlying platform.\n\nArgument string literals should be delimited by single quotes to avoid escape sequences being\ninterpreted as octal character codes by the Perl compiler.\n\nThe character string presentation format follows the conventions for zone files described in\nRFC1035.\n\nUsers should be aware that non-ASCII domain names will be transcoded to NFC before encoding,\nwhich is an irreversible process.\n\nname\n$name = $domain->name;\n\nReturns the domain name as a character string corresponding to the \"common interpretation\" to\nwhich RFC1034, 3.1, paragraph 9 alludes.\n\nCharacter escape sequences are used to represent a dot inside a domain name label and the escape\ncharacter itself.\n\nAny non-printable code point is represented using the appropriate numerical escape sequence.\n\nfqdn\n@fqdn = $domain->fqdn;\n\nReturns a character string containing the fully qualified domain name, including the trailing\ndot.\n\nxname\n$xname = $domain->xname;\n\nInterprets an extended name containing Unicode domain name labels encoded as Punycode A-labels.\n\nIf decoding is not possible, the ACE encoded name is returned.\n\nlabel\n@label = $domain->label;\n\nIdentifies the domain by means of a list of domain labels.\n\nstring\n$string = $object->string;\n\nReturns a character string containing the fully qualified domain name as it appears in a zone\nfile.\n\nCharacters which are recognised by RFC1035 zone file syntax are represented by the appropriate\nescape sequence.\n\norigin\n$create = Net::DNS::Domain->origin( $ORIGIN );\n$result = &$create( sub{ Net::DNS::RR->new( 'mx MX 10 a' ); } );\n$expect = Net::DNS::RR->new( \"mx.$ORIGIN. MX 10 a.$ORIGIN.\" );\n\nClass method which returns a reference to a subroutine wrapper which executes a given\nconstructor in a dynamically scoped context where relative names become descendents of the\nspecified $ORIGIN.\n",
                "subsections": []
            },
            "BUGS": {
                "content": "Coding strategy is intended to avoid creating unnecessary argument lists and stack frames. This\nimproves efficiency at the expense of code readability.\n\nPlatform specific character coding features are conditionally compiled into the code.\n",
                "subsections": []
            },
            "COPYRIGHT": {
                "content": "Copyright (c)2009-2011,2017 Dick Franks.\n\nAll rights reserved.\n",
                "subsections": []
            },
            "LICENSE": {
                "content": "Permission to use, copy, modify, and distribute this software and its documentation for any\npurpose and without fee is hereby granted, provided that the original copyright notices appear\nin all copies and that both copyright notice and this permission notice appear in supporting\ndocumentation, and that the name of the author not be used in advertising or publicity\npertaining to distribution of the software without specific prior written permission.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING\nBUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\nNONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,\nDAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "perl, Net::DNS, Net::LibIDN2, RFC1034, RFC1035, RFC5891, Unicode TR#16\n",
                "subsections": []
            }
        }
    }
}