curl_url_cleanup(3)

curl_url_cleanup3

Free the url handle

Usage

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

Overview

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

This functionality affects all supported protocols

Examples

int main(void)
{
  CURLU *url = curl_url();
  curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
  curl_url_cleanup(url);
}

Return value

none

Releases

5 releases since Debian 10 (Buster); the text changed 4 times.

  1. 10
  2. 11
  3. 12
  4. 13
  5. Arch

Availability

Added in curl 7.62.0

From curl 8.23.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.