CLASS IO.Url @public

summary

Uniform Resource Locator

string	$protocol @file
string	$domain @file
int	$port @file
string	$path @file
dict<string, string>	$params @file
string	$fragment @file

	NEW(url) @public	Create a new Url from a string.
	NEW(domain, path) @public	Create a new Url for domain and path.
	$getProtocol() string @public	Return the protocol.
	$setProtocol(protocol) @public	Set the protocol to protocol.
	$getDomain() string @public	Returns the domain.
	$setDomain(domain) @public	Set the domain.
	$getPort() int @public	Returns the port.
	$setPort(port) @public	Set the port.
	$getPath() string @public	Returns the path.
	$setPath(path) @public	Set the path.
	$hasParameter(name) bool @public	Returns TRUE if parameter name is present.
	$getParameter(name) string @public	Returns the value parameter of name.
	$getAllParameters() dict<string, string> @public	Returns a dictionary with all parameters.
	$setParameter(name, value) @public	Set parameter name to value.
	$removeParameter(name) @public	Remove parameter name.
	$getFragment() string @public	Returns the value of the fragment, what comes after "#".
	$setFragment(value) @public	Set the value of the fragment, what comes after "#".
	$ToString() string @public	Return all values put together as a string.

members (alphabetically)

string $domain @file

string $fragment @file

dict<string, string> $params @file

string $path @file

int $port @file

string $protocol @file

PROC NEW(string url) @public

Create a new Url from a string.

This splits the url into parts, so that it can be changed.

Example:

 ZUT.Url url = NEW("http://zimbu.org/docs?fmt=nice")
 url.setParameter("hl", "de")
 IO.print(url.ToString())  # prints http://zimbu.org/docs?fmt=nice&hl=de

PROC NEW(string domain, string path) @public

Create a new Url for domain and path.

$ToString() would return "http://domain/path"

When path is NIL then $ToString() would return "http://domain", without the trailing slash. When path is an empty string the trailing slash gets added.

path should not start with a slash to avoid double slashes.

FUNC $ToString() string @public

Return all values put together as a string.

With all values set: "protocol://domain:port/path?param=value#fragment".

FUNC $getAllParameters() dict<string, string> @public

Returns a dictionary with all parameters.

Returns NIL if there are no parameters.

FUNC $getDomain() string @public

Returns the domain.

FUNC $getFragment() string @public

Returns the value of the fragment, what comes after "#".

Return NIL if there is no frament, an empty string means only a "#" is added.