curl_url_cleanup.3 908 B

123456789101112131415161718192021222324252627282930313233343536373839
  1. .\" generated by cd2nroff 0.1 from curl_url_cleanup.md
  2. .TH curl_url_cleanup 3 "2025-01-17" libcurl
  3. .SH NAME
  4. curl_url_cleanup \- free the URL handle
  5. .SH SYNOPSIS
  6. .nf
  7. #include <curl/curl.h>
  8. void curl_url_cleanup(CURLU *handle);
  9. .fi
  10. .SH DESCRIPTION
  11. Frees all the resources associated with the given \fICURLU\fP handle!
  12. Passing in a NULL pointer in \fIhandle\fP makes this function return
  13. immediately with no action.
  14. Any use of the \fBhandle\fP after this function has been called and have
  15. returned, is illegal.
  16. .SH PROTOCOLS
  17. This functionality affects all supported protocols
  18. .SH EXAMPLE
  19. .nf
  20. int main(void)
  21. {
  22. CURLU *url = curl_url();
  23. curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
  24. curl_url_cleanup(url);
  25. }
  26. .fi
  27. .SH AVAILABILITY
  28. Added in curl 7.62.0
  29. .SH RETURN VALUE
  30. none
  31. .SH SEE ALSO
  32. .BR CURLOPT_CURLU (3),
  33. .BR curl_url (3),
  34. .BR curl_url_dup (3),
  35. .BR curl_url_get (3),
  36. .BR curl_url_set (3)