curl_url_cleanup(3) Introduction to Library Functions curl_url_cleanup(3)

NAME

curl_url_cleanup - free the URL handle

SYNOPSIS

#include <curl/curl.h>

void curl_url_cleanup(CURLU *handle);

DESCRIPTION

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

EXAMPLE

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

AVAILABILITY

Added in curl 7.62.0

RETURN VALUE

none

SEE ALSO

CURLOPT_CURLU(3), curl_url(3), curl_url_dup(3), curl_url_get(3),
curl_url_set(3)

libcurl 2026-01-08 curl_url_cleanup(3)