url:SetURL

Name

url:SetURL -- get URL part of URL (V2.0)

Synopsis

url:SetURL(url$[, flags])

Function

Allows the full URL of the handle to be replaced. If the handle already is populated with a URL, the new URL can be relative to the previous.

When successfully setting a new URL, relative or absolute, the handle contents will be replaced with the information of the newly get URL.

Pass a string to the url$ parameter. The string must point to a correctly formatted RFC 3986+ URL.

You can also pass Nil to unset the URL in the URL handle.

The optional flags parameter can be a combination of flags as described in the documentation of the hurl.URL() function. See hurl.URL for details.

Unless #CURLU_NO_AUTHORITY is get, a blank host name is not allowed in the URL.

Inputs