249. URL

Manipulate and Parse URLs

249.1. Summary of Module Globals

List of Global Functions

  • Build - Build URL from tokens as parsed with Parse

  • Check - Check URL

  • EscapeString - Escape reserved characters in string used as a part of URL (e.g. '%' => '%25', '@' => '%40'...)

  • Parse - Tokenize URL

  • UnEscapeString - Escape reserved characters in string used as a part of URL (e.g. '%' => '%25', '@' => '%40'...)

List of Global Variables

  • transform_map_filename - Transform map used for (un)escaping characters in file location part of an URL. It doesn't contain '%' because this character must be used in a particular order (the first or the last) during processing

  • transform_map_passwd - Transform map used for (un)escaping characters in username/password part of an URL. It doesn't contain '%' because this character must be used in a particular order (the first or the last) during processing

  • transform_map_query - Transform map used for (un)escaping characters in query part of a URL. It doesn't contain '%' because this character must be used in a particular order (the first or the last) during processing

249.2. Global Functions

249.2.1. Build

Build URL from tokens as parsed with Parse

Function parameters

  • map tokens

Return value

  • string - url, empty string if invalid data is used to build the url.

249.2.2. Check

Check URL

Function parameters

  • string url

Return value

  • boolean - true if correct

249.2.3. EscapeString

Escape reserved characters in string used as a part of URL (e.g. '%' => '%25', '@' => '%40'...)

Function parameters

  • string in

  • map<string,string> transform

Return value

  • string - escaped string

249.2.4. Parse

Tokenize URL

Function parameters

  • string url

Return value

  • map - URL split to tokens

Example 73. 

 Parse("http://name:pass@www.suse.cz:80/path/index.html?question#part") ->
     $[
         "scheme"  : "http",
         "host"    : "www.suse.cz"
         "port"    : "80",
         "path"    : /path/index.html",
         "user"    : "name",
         "pass"    : "pass",
         "query"   : "question",
         "fragment": "part"
     ]


249.2.5. UnEscapeString

Escape reserved characters in string used as a part of URL (e.g. '%' => '%25', '@' => '%40'...)

Function parameters

  • string in

  • map<string,string> transform

Return value

  • string - escaped string

249.3. Global Variables

249.3.1. transform_map_filename

Transform map used for (un)escaping characters in file location part of an URL. It doesn't contain '%' because this character must be used in a particular order (the first or the last) during processing

249.3.2. transform_map_passwd

Transform map used for (un)escaping characters in username/password part of an URL. It doesn't contain '%' because this character must be used in a particular order (the first or the last) during processing

249.3.3. transform_map_query

Transform map used for (un)escaping characters in query part of a URL. It doesn't contain '%' because this character must be used in a particular order (the first or the last) during processing

249.4. Module Requirements

249.4.1. Module Imports

  • Hostname
  • IP
  • String

249.4.2. Module Includes