Zig

Get a Related Item as Text

Demonstrates the Chilkat Email.GetRelatedString method, which returns the text of a related item (with CR line-endings), interpreting the item's bytes using the supplied charset. It is intended for text-based related items such as style sheets. The first argument is the zero-based related-item index and the second is the charset. This example reads an embedded CSS style sheet as text.

Background: Not every related item is a binary image — some are text, like a CSS style sheet embedded so the HTML renders consistently offline. For those, GetRelatedString decodes the bytes back to characters using the charset you specify (typically utf-8). For binary related items such as images, read the raw data via the BinData-based accessor instead. This variant normalizes line endings to bare CR; use GetRelatedStringCrLf when you need CRLF.

Chilkat Zig Downloads

Download Chilkat for Zig

Zig

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

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

    // Demonstrates the GetRelatedString method, which returns the text of a related item (with
    // CR line-endings), interpreting the bytes using the specified charset.  This is intended
    // for text-based related items such as style sheets.  The index is zero-based.

    const email = try chilkat.Email.init();
    defer email.deinit();
    email.setSubject("GetRelatedString example");

    // The HTML references a related style sheet by name (Content-Location).
    email.setHtmlBody("<html><head><link rel=\"stylesheet\" href=\"styles.css\"/></head><body>Styled.</body></html>");

    // Add the related style sheet (index 0).
    email.addRelatedString2("styles.css", "body { color: navy; }", "utf-8");

    // Get the first related item (index 0) as text, interpreting the bytes as utf-8.
    const content = try email.getRelatedString(alloc, 0, "utf-8");
    std.debug.print("Related item 0 text: {s}\n", .{content});
}