{
    "content": [
        {
            "type": "text",
            "text": "# URI::Heuristic (perldoc)\n\n**Summary:** URI::Heuristic - Expand URI using heuristics\n\n**Synopsis:** use URI::Heuristic qw(ufuristr);\n$u = ufuristr(\"example\");          # http://www.example.com\n$u = ufuristr(\"www.sol.no/sol\");   # http://www.sol.no/sol\n$u = ufuristr(\"aas\");              # http://www.aas.no\n$u = ufuristr(\"ftp.funet.fi\");     # ftp://ftp.funet.fi\n$u = ufuristr(\"/etc/passwd\");      # file:/etc/passwd\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (7 lines)\n- **DESCRIPTION** (20 lines)\n- **ENVIRONMENT** (25 lines)\n- **COPYRIGHT** (5 lines)\n\n## Full Content\n\n### NAME\n\nURI::Heuristic - Expand URI using heuristics\n\n### SYNOPSIS\n\nuse URI::Heuristic qw(ufuristr);\n$u = ufuristr(\"example\");          # http://www.example.com\n$u = ufuristr(\"www.sol.no/sol\");   # http://www.sol.no/sol\n$u = ufuristr(\"aas\");              # http://www.aas.no\n$u = ufuristr(\"ftp.funet.fi\");     # ftp://ftp.funet.fi\n$u = ufuristr(\"/etc/passwd\");      # file:/etc/passwd\n\n### DESCRIPTION\n\nThis module provides functions that expand strings into real absolute\nURIs using some built-in heuristics. Strings that already represent\nabsolute URIs (i.e. that start with a \"scheme:\" part) are never modified\nand are returned unchanged. The main use of these functions is to allow\nabbreviated URIs similar to what many web browsers allow for URIs typed\nin by the user.\n\nThe following functions are provided:\n\nufuristr($str)\nTries to make the argument string into a proper absolute URI string.\nThe \"uf\" prefix stands for \"User Friendly\". Under MacOS, it assumes\nthat any string with a common URL scheme (http, ftp, etc.) is a URL\nrather than a local path. So don't name your volumes after common\nURL schemes and expect ufuristr() to construct valid file: URL's on\nthose volumes for you, because it won't.\n\nufuri($str)\nWorks the same way as ufuristr() but returns a \"URI\" object.\n\n### ENVIRONMENT\n\nIf the hostname portion of a URI does not contain any dots, then certain\nqualified guesses are made. These guesses are governed by the following\nenvironment variables:\n\nCOUNTRY   The two-letter country code (ISO 3166) for your location. If\nthe domain name of your host ends with two letters, then it is\ntaken to be the default country. See also Locale::Country.\n\nHTTPACCEPTLANGUAGE, LCALL, LANG\nIf COUNTRY is not set, these standard environment variables\nare examined and country (not language) information possibly\nfound in them is used as the default country.\n\nURLGUESSPATTERN\nContains a space-separated list of URL patterns to try. The\nstring \"ACME\" is for some reason used as a placeholder for the\nhost name in the URL provided. Example:\n\nURLGUESSPATTERN=\"www.ACME.no www.ACME.se www.ACME.com\"\nexport URLGUESSPATTERN\n\nSpecifying URLGUESSPATTERN disables any guessing rules based\non country. An empty URLGUESSPATTERN disables any guessing\nthat involves host name lookups.\n\n### COPYRIGHT\n\nCopyright 1997-1998, Gisle Aas\n\nThis library is free software; you can redistribute it and/or modify it\nunder the same terms as Perl itself.\n\n"
        }
    ],
    "structuredContent": {
        "command": "URI::Heuristic",
        "section": "",
        "mode": "perldoc",
        "summary": "URI::Heuristic - Expand URI using heuristics",
        "synopsis": "use URI::Heuristic qw(ufuristr);\n$u = ufuristr(\"example\");          # http://www.example.com\n$u = ufuristr(\"www.sol.no/sol\");   # http://www.sol.no/sol\n$u = ufuristr(\"aas\");              # http://www.aas.no\n$u = ufuristr(\"ftp.funet.fi\");     # ftp://ftp.funet.fi\n$u = ufuristr(\"/etc/passwd\");      # file:/etc/passwd",
        "flags": [],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 7,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 20,
                "subsections": []
            },
            {
                "name": "ENVIRONMENT",
                "lines": 25,
                "subsections": []
            },
            {
                "name": "COPYRIGHT",
                "lines": 5,
                "subsections": []
            }
        ]
    }
}