URL Handle Reference

The url_handle provides structured access to individual components of a URL without manual string building or encoding. This reference lists the core methods which operate on a url_handle, their primary function, and links to the official libcurl documentation.

Official libcurl Reference

• libcurl URL API

Lifecycle

Method	Description	libcurl Reference
UrlInit()	Creates a new URL handle.	curl_url
UrlCleanup(url_handle?)	Releases the URL handle.	curl_url_cleanup
DupeUrl(url_handle?)	Creates a copy of an existing URL handle.	curl_url_dup

Part Manipulation

Method	Description	libcurl Reference
UrlSet(part, content, flags := [], url_handle?)	Writes a value to a named URL part.	curl_url_set
UrlGet(part, flags := [], url_handle?)	Reads a named URL part back as a string.	curl_url_get

Configuration

Method	Description	libcurl Reference
UrlPartReturnsNull(behavior := true, url_handle?)	Controls whether unset parts return Null() or an empty string.	—

Diagnostics

Method	Description	libcurl Reference
GetUrlErrorString(incomingValue)	Resolves a URL-specific error code to its string description.	curl_url_strerror

Where to Go Next

• Easy Handle Reference — single transfer lifecycle
• MIME Handle Reference — multipart form encoding
• Utility Methods Reference — standalone helper functions