Skip to content

libcURL.cURLClient.Head

Andrew Lambert edited this page Jan 25, 2023 · 13 revisions

Method Signatures

 Function Head(URL As String) As Boolean
 Function Head(URL As libcURL.URLParser) As Boolean
 Sub Head(URL As String)
 Sub Head(URL As libcURL.URLParser)

Parameters

Name Type Comment
URL String or URLParser The RFC 3986 URI to get headers for. In libcurl 7.62.0 and newer, you may also pass an instance of URLParser.

Return value

The synchronous version of this method returns True on success. Check cURLClient.LastError if this method returns False.

Remarks

Performs a header-only operation using protocol-appropriate semantics (http HEAD, etc.) Once the transfer completes, you may access the headers by calling cURLClient.ResponseHeaders.

If the URL parameter is empty ("") then the previous URL is reused; if there is no previous URL then the transfer will fail with error code CURLE_URL_MALFORMAT(3). If the previous transfer involved any sort of redirection then the "previous URL" is the URL enclosed in the final redirect.

See also

Clone this wiki locally