Zig Requires Chilkat v11.0.0+

URL Encoding Charset in POST Query Params

See more HTTP Examples

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

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

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

    // We have the string "MÆRSK".
    const name_win1252_encoded = "M%E6RSK";

    const sb = try chilkat.StringBuilder.init();
    defer sb.deinit();
    try sb.decodeAndAppend(name_win1252_encoded, "url", "windows-1252");

    const http = try chilkat.Http.init();
    defer http.deinit();

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

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

    const req = try chilkat.HttpRequest.init();
    defer req.deinit();

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

    req.addParam("name", try sb.getAsString(alloc));

    req.setHttpVerb("POST");
    req.setContentType("application/x-www-form-urlencoded");

    const resp = try chilkat.HttpResponse.init();
    defer resp.deinit();
    http.httpReq("https://www.chilkatsoft.com/something", req, resp) catch {
        std.debug.print("{s}\n", .{try http.getLastErrorText(alloc)});
        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

    req.setCharset("windows-1252");
    req.setHttpVerb("POST");
    req.setContentType("application/x-www-form-urlencoded");

    http.httpReq("https://www.chilkatsoft.com/something", req, resp) catch {
        std.debug.print("{s}\n", .{try http.getLastErrorText(alloc)});
        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

    req.setPath("/something");
    req.setHttpVerb("POST");
    req.setContentType("application/x-www-form-urlencoded");

    req.setCharset("utf-8");
    http.httpSReq("www.chilkatsoft.com", 443, true, req, resp) catch {
        std.debug.print("{s}\n", .{try http.getLastErrorText(alloc)});
        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 POST with XML body 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.

    req.setPath("/something");
    req.setHttpVerb("POST");
    req.setContentType("text/xml");
    try req.loadBodyFromString("<test>123</test>", "utf-8");
    req.setCharset("utf-8");

    // Remember... our request object still contains the query param added in the above call to AddParam.
    http.httpSReq("www.chilkatsoft.com", 443, true, req, resp) catch {
        std.debug.print("{s}\n", .{try http.getLastErrorText(alloc)});
        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>
}