curl\_url\_cleanup(3) Library Functions Manual curl\_url\_cleanup(3)

# [NAME](#NAME)

curl\_url\_cleanup - free the URL handle

# [SYNOPSIS](#SYNOPSIS)

```
#include <curl/curl.h>
void curl_url_cleanup(CURLU *handle);
```

# [DESCRIPTION](#DESCRIPTION)

Frees all the resources associated with the given *CURLU* handle.

Passing in a NULL pointer in *handle* makes this function return immediately with no action.

Any use of the **handle** after this function has been called and have returned, is illegal.

# [PROTOCOLS](#PROTOCOLS)

This functionality affects all supported protocols

# [EXAMPLE](#EXAMPLE)

```
int main(void)
{


  CURLU *url = curl_url();


  curl_url_set(url, CURLUPART_URL, "https://example.com", 0);


  curl_url_cleanup(url);
}
```

# [AVAILABILITY](#AVAILABILITY)

Added in curl 7.62.0

# [RETURN VALUE](#RETURN_VALUE)

none

# [SEE ALSO](#SEE_ALSO)

[**CURLOPT\_CURLU**(3)](/man/os/curl/CURLOPT_CURLU.3), [**curl\_url**(3)](/man/os/curl/curl_url.3), [**curl\_url\_dup**(3)](/man/os/curl/curl_url_dup.3), [**curl\_url\_get**(3)](/man/os/curl/curl_url_get.3), [**curl\_url\_set**(3)](/man/os/curl/curl_url_set.3)

2026-10-31 libcurl

---

Document: curl_url_cleanup(3) from curl 8.23.0-r3 (Chainguard OS)
Source: https://github.com/curl/curl.git