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