| 1234567891011121314151617181920212223242526272829303132333435363738394041 |
- .\" generated by cd2nroff 0.1 from curl_url_dup.md
- .TH curl_url_dup 3 "2025-01-17" libcurl
- .SH NAME
- curl_url_dup \- duplicate a URL handle
- .SH SYNOPSIS
- .nf
- #include <curl/curl.h>
- CURLU *curl_url_dup(const CURLU *inhandle);
- .fi
- .SH DESCRIPTION
- Duplicates the URL object the input \fICURLU\fP \fIinhandle\fP identifies and
- returns a pointer to the copy as a new \fICURLU\fP handle. The new handle also
- needs to be freed with \fIcurl_url_cleanup(3)\fP.
- .SH PROTOCOLS
- This functionality affects all supported protocols
- .SH EXAMPLE
- .nf
- int main(void)
- {
- CURLUcode rc;
- CURLU *url = curl_url();
- CURLU *url2;
- rc = curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
- if(!rc) {
- url2 = curl_url_dup(url); /* clone it! */
- curl_url_cleanup(url2);
- }
- curl_url_cleanup(url);
- }
- .fi
- .SH AVAILABILITY
- Added in curl 7.62.0
- .SH RETURN VALUE
- Returns a new handle or NULL if out of memory.
- .SH SEE ALSO
- .BR CURLOPT_CURLU (3),
- .BR curl_url (3),
- .BR curl_url_cleanup (3),
- .BR curl_url_get (3),
- .BR curl_url_set (3)
|
