Unicode C

HTTP HEAD Request

See more HTTP Examples

Sends an HTTP HEAD request and gets the response.

Note: The response to an HTTP HEAD request is always just the response header. The reponse body is always 0 length (thus the reason it's called a "HEAD" request..)

Unicode C

#include <C_CkHttpW.h>
#include <C_CkHttpResponseW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpW http;
    HCkHttpResponseW resp;
    int numHeaderFields;
    int i;

    success = FALSE;

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    http = CkHttpW_Create();

    // If the URL uses "https://", then the connection will be TLS.
    // Otherwise it will be TCP.

    // A failure is when we don't get any response.  It could be a timeout, an inability to connect, etc.
    // For example, a "404 Not Found" response is still a response, and thus deemed success in terms of the API..

    resp = CkHttpResponseW_Create();
    success = CkHttpW_HttpNoBody(http,L"HEAD",L"https://example-code.com/",resp);
    if (success == FALSE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        return;
    }

    // Examine the response.
    wprintf(L"Status Code = %d\n",CkHttpResponseW_getStatusCode(resp));
    wprintf(L"Status Line = %s\n",CkHttpResponseW_statusLine(resp));
    wprintf(L"Status Text = %s\n",CkHttpResponseW_statusText(resp));
    wprintf(L"Full Response Header:\n");
    wprintf(L"%s\n",CkHttpResponseW_header(resp));
    wprintf(L"----\n");
    numHeaderFields = CkHttpResponseW_getNumHeaderFields(resp);
    wprintf(L"Num Header Fields: %d\n",numHeaderFields);

    for (i = 0; i <= numHeaderFields - 1; i++) {
        wprintf(L"%s: %s\n",CkHttpResponseW_getHeaderName(resp,i),CkHttpResponseW_getHeaderValue(resp,i));
    }



    CkHttpW_Dispose(http);
    CkHttpResponseW_Dispose(resp);

    }