Search…
Get a URL
The CURLU * handle represents a URL, or at parts of a URL, and you can easily extract that URL at any point:
1
char *url;
2
rc = curl_url_get(h, CURLUPART_URL, &url, CURLU_NO_DEFAULT_PORT);
3
curl_free(url);
Copied!
If the handle does not have enough information to extra a full URL, it will return error.
The returned string must be freed with curl_free() after you are done with it.
The zero in the function call's forth argument is a flag bitmask for changing specific features.

CURLU_DEFAULT_PORT

If the URL handle has no port number stored, this option will make curl_url_get() return the default port for the used scheme.

CURLU_DEFAULT_SCHEME

If the handle has no scheme stored, this option will make curl_url_get() return the default scheme instead of error.

CURLU_NO_DEFAULT_PORT

Instructs curl_url_get() to not use a port number in the generated URL if that port number matches the default port used for the scheme. For example, if port number 443 is set and the scheme is https, the extracted URL will not include the port number.

CURLU_URLENCODE

If set, will make curl_url_get() URL encode the host name part when a full URL is retrieved. If not set (default), libcurl returns the URL with the host name "raw" to support IDN names to appear as-is. IDN host names are typically using non-ASCII bytes that otherwise will be percent-encoded.
Note that even when not asking for URL encoding, the % (byte 37) will be URL encoded in host names to make sure the host name remains valid.
Last modified 1mo ago