(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_CkStringBuilder.h>
#include <C_CkHttp.h>
#include <C_CkHttpRequest.h>
#include <C_CkHttpResponse.h>

void ChilkatSample(void)
    {
    BOOL success;
    const char *nameWin1252Encoded;
    HCkStringBuilder sb;
    HCkHttp http;
    HCkHttpRequest req;
    HCkHttpResponse 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 = "M%E6RSK";

    sb = CkStringBuilder_Create();
    success = CkStringBuilder_DecodeAndAppend(sb,nameWin1252Encoded,"url","windows-1252");

    http = CkHttp_Create();

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

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

    req = CkHttpRequest_Create();

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

    CkHttpRequest_AddParam(req,"name",CkStringBuilder_getAsString(sb));

    CkHttpRequest_putHttpVerb(req,"POST");
    CkHttpRequest_putHttpVerb(req,"POST");
    CkHttpRequest_putContentType(req,"application/x-www-form-urlencoded");

    resp = CkHttpResponse_Create();
    success = CkHttp_HttpReq(http,"https://www.chilkatsoft.com/something",req,resp);
    if (success == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkStringBuilder_Dispose(sb);
        CkHttp_Dispose(http);
        CkHttpRequest_Dispose(req);
        CkHttpResponse_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

    CkHttpRequest_putCharset(req,"windows-1252");
    CkHttpRequest_putHttpVerb(req,"POST");
    CkHttpRequest_putContentType(req,"application/x-www-form-urlencoded");

    success = CkHttp_HttpReq(http,"https://www.chilkatsoft.com/something",req,resp);
    if (success == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkStringBuilder_Dispose(sb);
        CkHttp_Dispose(http);
        CkHttpRequest_Dispose(req);
        CkHttpResponse_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

    CkHttpRequest_putPath(req,"/something");
    CkHttpRequest_putHttpVerb(req,"POST");
    CkHttpRequest_putContentType(req,"application/x-www-form-urlencoded");

    CkHttpRequest_putCharset(req,"utf-8");
    success = CkHttp_HttpSReq(http,"www.chilkatsoft.com",443,TRUE,req,resp);
    if (success == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkStringBuilder_Dispose(sb);
        CkHttp_Dispose(http);
        CkHttpRequest_Dispose(req);
        CkHttpResponse_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.

    CkHttpRequest_putPath(req,"/something");
    CkHttpRequest_putHttpVerb(req,"POST");
    CkHttpRequest_putContentType(req,"text/xml");
    success = CkHttpRequest_LoadBodyFromString(req,"<test>123</test>","utf-8");
    CkHttpRequest_putCharset(req,"utf-8");

    // Remember... our request object still contains the query param added in the above call to AddParam.new HttpResponse resp;
    success = CkHttp_HttpSReq(http,"www.chilkatsoft.com",443,TRUE,req,resp);
    if (success == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkStringBuilder_Dispose(sb);
        CkHttp_Dispose(http);
        CkHttpRequest_Dispose(req);
        CkHttpResponse_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>


    CkStringBuilder_Dispose(sb);
    CkHttp_Dispose(http);
    CkHttpRequest_Dispose(req);
    CkHttpResponse_Dispose(resp);

    }