mirror of
https://github.com/curl/curl.git
synced 2025-01-12 13:55:11 +08:00
e3fe020089
Remove the PROTOCOLS section from the source files completely and instead generate them based on the header data in the curldown files. It also generates TLS backend information for options marked for TLS as protocol. Closes #13175
59 lines
997 B
Markdown
59 lines
997 B
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Title: curl_url_dup
|
|
Section: 3
|
|
Source: libcurl
|
|
See-also:
|
|
- CURLOPT_CURLU (3)
|
|
- curl_url (3)
|
|
- curl_url_cleanup (3)
|
|
- curl_url_get (3)
|
|
- curl_url_set (3)
|
|
Protocol:
|
|
- All
|
|
---
|
|
|
|
# NAME
|
|
|
|
curl_url_dup - duplicate a URL handle
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#include <curl/curl.h>
|
|
|
|
CURLU *curl_url_dup(const CURLU *inhandle);
|
|
~~~
|
|
|
|
# DESCRIPTION
|
|
|
|
Duplicates the URL object the input *CURLU* *inhandle* identifies and
|
|
returns a pointer to the copy as a new *CURLU* handle. The new handle also
|
|
needs to be freed with curl_url_cleanup(3).
|
|
|
|
# EXAMPLE
|
|
|
|
~~~c
|
|
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);
|
|
}
|
|
~~~
|
|
|
|
# AVAILABILITY
|
|
|
|
Added in 7.62.0
|
|
|
|
# RETURN VALUE
|
|
|
|
Returns a new handle or NULL if out of memory.
|