xref: /curl/docs/libcurl/curl_url_cleanup.md (revision e3fe0200)
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: curl_url_cleanup
5Section: 3
6Source: libcurl
7See-also:
8  - CURLOPT_CURLU (3)
9  - curl_url (3)
10  - curl_url_dup (3)
11  - curl_url_get (3)
12  - curl_url_set (3)
13Protocol:
14  - All
15---
16
17# NAME
18
19curl_url_cleanup - free the URL handle
20
21# SYNOPSIS
22
23~~~c
24#include <curl/curl.h>
25
26void curl_url_cleanup(CURLU *handle);
27~~~
28
29# DESCRIPTION
30
31Frees all the resources associated with the given *CURLU* handle!
32
33Passing in a NULL pointer in *handle* makes this function return
34immediately with no action.
35
36# EXAMPLE
37
38~~~c
39int main(void)
40{
41  CURLU *url = curl_url();
42  curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
43  curl_url_cleanup(url);
44}
45~~~
46
47# AVAILABILITY
48
49Added in 7.62.0
50
51# RETURN VALUE
52
53none
54