str: The String being parsed into a Url.

An absolute URL starts with a scheme-name, followed by a colon: A valid URL varies with the scheme, but for http:, https:, file:, and some curl:, the special characters '%', '?', and '#' have special meaning, and must be encoded if they should not have these special meanings (see url-encode-filename), and the path components '.' and '..' are illegal.

For heuristic conversion from unstructured strings (such as user input) to Urls, see parse-url.

Resolving a relative URL can be accomplished by calling parse-url (specifying the relative keyword), working-url or url, Url.merge or Url.concat.

Throws