(Unicode C) URL Encoding Charset in POST Query Params

Demonstrates how to control the URL encoding charset in POST query params.

Note: This example requires Chilkat v11.0.0 or greater.

Chilkat C/C++ Library Downloads
MS Visual C/C++ C++ Builder Linux C/C++ Alpine Linux C/C++	MacOS C/C++ iOS C/C++ Android C/C++ MinGW C/C++

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

void ChilkatSample(void)
    {
    BOOL success;
    const wchar_t *nameWin1252Encoded;
    HCkStringBuilderW sb;
    HCkHttpW http;
    HCkHttpRequestW req;
    HCkHttpResponseW resp;

    success = FALSE;

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

    // We have the string "MÆRSK".
    nameWin1252Encoded = L"M%E6RSK";

    sb = CkStringBuilderW_Create();
    success = CkStringBuilderW_DecodeAndAppend(sb,nameWin1252Encoded,L"url",L"windows-1252");

    http = CkHttpW_Create();

    // We're setting the session log filename so we can see the exact request sent.
    CkHttpW_putSessionLogFilename(http,L"qa_output/sessionLog.txt");

    // First demonstrate a simple application/x-www-form-urlencoded POST

    req = CkHttpRequestW_Create();

    // Set the Charset = "utf-8" to cause URL encoding to use utf-8.
    CkHttpRequestW_putCharset(req,L"utf-8");

    CkHttpRequestW_AddParam(req,L"name",CkStringBuilderW_getAsString(sb));

    CkHttpRequestW_putHttpVerb(req,L"POST");
    CkHttpRequestW_putHttpVerb(req,L"POST");
    CkHttpRequestW_putContentType(req,L"application/x-www-form-urlencoded");

    resp = CkHttpResponseW_Create();
    success = CkHttpW_HttpReq(http,L"https://www.chilkatsoft.com/something",req,resp);
    if (success == FALSE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkStringBuilderW_Dispose(sb);
        CkHttpW_Dispose(http);
        CkHttpRequestW_Dispose(req);
        CkHttpResponseW_Dispose(resp);
        return;
    }

    // This is the request that is sent:
    // Notice that utf-8 is used in the query param (the letter 'Æ' is %C3%A6)

    // 	POST /something HTTP/1.1
    // 	Host: www.chilkatsoft.com
    // 	Content-Type: application/x-www-form-urlencoded
    // 	Content-Length: 15
    // 
    // 	name=M%C3%A6RSK

    // ---------------------------------------------------------------
    // Switch to windows-1252

    CkHttpRequestW_putCharset(req,L"windows-1252");
    CkHttpRequestW_putHttpVerb(req,L"POST");
    CkHttpRequestW_putContentType(req,L"application/x-www-form-urlencoded");

    success = CkHttpW_HttpReq(http,L"https://www.chilkatsoft.com/something",req,resp);
    if (success == FALSE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkStringBuilderW_Dispose(sb);
        CkHttpW_Dispose(http);
        CkHttpRequestW_Dispose(req);
        CkHttpResponseW_Dispose(resp);
        return;
    }

    // This is the request that is sent:
    // Notice that windows-1252 is used in the query param (the letter 'Æ' is %E6)

    // 	POST /something HTTP/1.1
    // 	Host: www.chilkatsoft.com
    // 	Content-Type: application/x-www-form-urlencoded
    // 	Content-Length: 12
    // 
    // 	name=M%E6RSK

    // ---------------------------------------------------------------
    // Let's do the same with HttpSReq, switching back to utf-8

    CkHttpRequestW_putPath(req,L"/something");
    CkHttpRequestW_putHttpVerb(req,L"POST");
    CkHttpRequestW_putContentType(req,L"application/x-www-form-urlencoded");

    CkHttpRequestW_putCharset(req,L"utf-8");
    success = CkHttpW_HttpSReq(http,L"www.chilkatsoft.com",443,TRUE,req,resp);
    if (success == FALSE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkStringBuilderW_Dispose(sb);
        CkHttpW_Dispose(http);
        CkHttpRequestW_Dispose(req);
        CkHttpResponseW_Dispose(resp);
        return;
    }

    // This is the request that is sent:
    // Notice that utf-8 is used in the query param (the letter 'Æ' is %C3%A6)

    // 	POST /something HTTP/1.1
    // 	Host: www.chilkatsoft.com
    // 	Content-Type: application/x-www-form-urlencoded
    // 	Content-Length: 15
    // 
    // 	name=M%C3%A6RSK

    // ---------------------------------------------------------------
    // Let's do a PostXml where the query params are in the HTTP request start line, 
    // and the Content-Type is text/xml where the body of the request is XML.

    CkHttpRequestW_putPath(req,L"/something");
    CkHttpRequestW_putHttpVerb(req,L"POST");
    CkHttpRequestW_putContentType(req,L"text/xml");
    success = CkHttpRequestW_LoadBodyFromString(req,L"<test>123</test>",L"utf-8");
    CkHttpRequestW_putCharset(req,L"utf-8");

    // Remember... our request object still contains the query param added in the above call to AddParam.new HttpResponse resp;
    success = CkHttpW_HttpSReq(http,L"www.chilkatsoft.com",443,TRUE,req,resp);
    if (success == FALSE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkStringBuilderW_Dispose(sb);
        CkHttpW_Dispose(http);
        CkHttpRequestW_Dispose(req);
        CkHttpResponseW_Dispose(resp);
        return;
    }

    // This is the request that is sent:
    // Notice that utf-8 is used in the query param (the letter 'Æ' is %C3%A6)

    // 	POST /something?name=M%C3%A6RSK HTTP/1.1
    // 	Host: www.chilkatsoft.com
    // 	Content-Type: text/xml
    // 	Content-Length: 16
    // 
    // 	<test>123</test>


    CkStringBuilderW_Dispose(sb);
    CkHttpW_Dispose(http);
    CkHttpRequestW_Dispose(req);
    CkHttpResponseW_Dispose(resp);

    }