Zig Requires Chilkat v11.0.0+

HTTP GET with Non-USASCII Query Params

See more HTTP Examples

This example illustrates how query parameters in a URL are typically encoded and transmitted. Zig

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

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

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

    // First, let's load the string "Grünhöfer GmbH" from a file.  (This is a fictitious company name.)
    // The file uses the utf-8 charset encoding.
    const sb_company_name = try chilkat.StringBuilder.init();
    defer sb_company_name.deinit();
    try sb_company_name.loadFile("qa_data/txt/companyName.txt", "utf-8");
    // Assuming success for this example...

    // We'll send an HTTP GET request to https://chilkatsoft.com/example?company_name={company name}

    // When sending an HTTP GET request with query parameters that contain accented characters
    // (e.g., umlauts: ä, ö, ü), they must be percent-encoded (URL encoded) to ensure proper transmission and
    // interpretation by the server.  This is based on their UTF-8 byte values.
    const sb_url = try chilkat.StringBuilder.init();
    defer sb_url.deinit();
    sb_url.append("https://chilkatsoft.com/example?company_name=") catch {};
    sb_url.append(try sb_company_name.getEncoded(alloc, "url", "utf-8")) catch {};

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

    // Send the following HTTP GET request:

    // GET /example?company_name=Gr%C3%BCnh%C3%B6fer%20GmbH HTTP/1.1
    // Host: chilkatsoft.com
    // Accept: */*
    // Accept-Encoding: gzip

    const sb_response = try chilkat.StringBuilder.init();
    defer sb_response.deinit();
    http.quickGetSb(try sb_url.getAsString(alloc), sb_response) catch {
        std.debug.print("{s}\n", .{try http.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("response status code: {d}\n", .{http.getLastStatus()});
    std.debug.print("{s}\n", .{try sb_response.getAsString(alloc)});
}