{
    "content": [
        {
            "type": "text",
            "text": "# URI::ldap (perldoc)\n\n## NAME\n\nURI::ldap - LDAP Uniform Resource Locators\n\n## SYNOPSIS\n\nuse URI;\n$uri = URI->new(\"ldap:$uristring\");\n$dn     = $uri->dn;\n$filter = $uri->filter;\n@attr   = $uri->attributes;\n$scope  = $uri->scope;\n%extn   = $uri->extensions;\n$uri = URI->new(\"ldap:\");  # start empty\n$uri->host(\"ldap.itd.umich.edu\");\n$uri->dn(\"o=University of Michigan,c=US\");\n$uri->attributes(qw(postalAddress));\n$uri->scope('sub');\n$uri->filter('(cn=Babs Jensen)');\nprint $uri->asstring,\"\\n\";\n\n## DESCRIPTION\n\n\"URI::ldap\" provides an interface to parse an LDAP URI into its constituent parts and also to\nbuild a URI as described in RFC 2255.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **METHODS**\n- **SEE ALSO**\n- **AUTHOR**\n- **COPYRIGHT**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "URI::ldap",
        "section": "",
        "mode": "perldoc",
        "summary": "URI::ldap - LDAP Uniform Resource Locators",
        "synopsis": "use URI;\n$uri = URI->new(\"ldap:$uristring\");\n$dn     = $uri->dn;\n$filter = $uri->filter;\n@attr   = $uri->attributes;\n$scope  = $uri->scope;\n%extn   = $uri->extensions;\n$uri = URI->new(\"ldap:\");  # start empty\n$uri->host(\"ldap.itd.umich.edu\");\n$uri->dn(\"o=University of Michigan,c=US\");\n$uri->attributes(qw(postalAddress));\n$uri->scope('sub');\n$uri->filter('(cn=Babs Jensen)');\nprint $uri->asstring,\"\\n\";",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 17,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "METHODS",
                "lines": 31,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "COPYRIGHT",
                "lines": 3,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "URI::ldap - LDAP Uniform Resource Locators\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "use URI;\n\n$uri = URI->new(\"ldap:$uristring\");\n$dn     = $uri->dn;\n$filter = $uri->filter;\n@attr   = $uri->attributes;\n$scope  = $uri->scope;\n%extn   = $uri->extensions;\n\n$uri = URI->new(\"ldap:\");  # start empty\n$uri->host(\"ldap.itd.umich.edu\");\n$uri->dn(\"o=University of Michigan,c=US\");\n$uri->attributes(qw(postalAddress));\n$uri->scope('sub');\n$uri->filter('(cn=Babs Jensen)');\nprint $uri->asstring,\"\\n\";\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "\"URI::ldap\" provides an interface to parse an LDAP URI into its constituent parts and also to\nbuild a URI as described in RFC 2255.\n",
                "subsections": []
            },
            "METHODS": {
                "content": "\"URI::ldap\" supports all the generic and server methods defined by URI, plus the following.\n\nEach of the following methods can be used to set or get the value in the URI. The values are\npassed in unescaped form. None of these return undefined values, but elements without a default\ncan be empty. If arguments are given, then a new value is set for the given part of the URI.\n\n$uri->dn( [$newdn] )\nSets or gets the *Distinguished Name* part of the URI. The DN identifies the base object of\nthe LDAP search.\n\n$uri->attributes( [@newattrs] )\nSets or gets the list of attribute names which are returned by the search.\n\n$uri->scope( [$newscope] )\nSets or gets the scope to be used by the search. The value can be one of \"base\", \"one\" or\n\"sub\". If none is given in the URI then the return value defaults to \"base\".\n\n$uri->scope( [$newscope] )\nSame as scope(), but does not default to anything.\n\n$uri->filter( [$newfilter] )\nSets or gets the filter to be used by the search. If none is given in the URI then the\nreturn value defaults to \"(objectClass=*)\".\n\n$uri->filter( [$newfilter] )\nSame as filter(), but does not default to anything.\n\n$uri->extensions( [$etype => $evalue,...] )\nSets or gets the extensions used for the search. The list passed should be in the form\netype1 => evalue1, etype2 => evalue2,... This is also the form of list that is returned.\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "<http://tools.ietf.org/html/rfc2255>\n",
                "subsections": []
            },
            "AUTHOR": {
                "content": "Graham Barr <gbarr@pobox.com>\n\nSlightly modified by Gisle Aas to fit into the URI distribution.\n",
                "subsections": []
            },
            "COPYRIGHT": {
                "content": "Copyright (c) 1998 Graham Barr. All rights reserved. This program is free software; you can\nredistribute it and/or modify it under the same terms as Perl itself.\n",
                "subsections": []
            }
        }
    }
}