.\" generated by cd2nroff 0.1 from curl_url_cleanup.md
.TH curl_url_cleanup 3 "2024-11-18" libcurl
.SH NAME
curl_url_cleanup \- free the URL handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>

void curl_url_cleanup(CURLU *handle);
.fi
.SH DESCRIPTION
Frees all the resources associated with the given \fICURLU\fP handle!

Passing in a NULL pointer in \fIhandle\fP makes this function return
immediately with no action.

Any use of the \fBhandle\fP after this function has been called and have
returned, is illegal.
.SH PROTOCOLS
This functionality affects all supported protocols
.SH EXAMPLE
.nf
int main(void)
{
  CURLU *url = curl_url();
  curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
  curl_url_cleanup(url);
}
.fi
.SH AVAILABILITY
Added in curl 7.62.0
.SH RETURN VALUE
none
.SH SEE ALSO
.BR CURLOPT_CURLU (3),
.BR curl_url (3),
.BR curl_url_dup (3),
.BR curl_url_get (3),
.BR curl_url_set (3)