curl_url - Man Page
returns a new URL handle
Synopsis
#include <curl/curl.h> CURLU *curl_url();
Description
This function will allocates and returns a pointer to a fresh CURLU handle, to be used for further use of the URL API.
Example
CURLUcode rc; CURLU *url = curl_url(); rc = curl_url_set(url, CURLUPART_URL, "https://example.com", 0); if(!rc) { char *scheme; rc = curl_url_get(url, CURLUPART_SCHEME, &scheme, 0); if(!rc) { printf("the scheme is %s\n", scheme); curl_free(scheme); } curl_url_cleanup(url); }
Availability
Added in 7.62.0
Return Value
Returns a CURLU * if successful, or NULL if out of memory.
See Also
curl_url_cleanup(3), curl_url_get(3), curl_url_set(3), curl_url_dup(3), curl_url_strerror(3), CURLOPT_CURLU(3)
Referenced By
CURLOPT_CURLU(3), curl_url_cleanup(3), curl_url_dup(3), curl_url_get(3), curl_url_set(3), libcurl-security(3), libcurl-url(3).
April 26, 2023 libcurl 8.1.1