Zig Requires Chilkat v11.0.0+

Mark IMAP Email as Read/Unread (Seen/Unseen)

Demonstrates how to mark emails as read or unread. 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 API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    const imap = try chilkat.Imap.init();
    defer imap.deinit();

    // Connect to an IMAP server.
    // Use TLS
    imap.setSsl(true);
    imap.setPort(993);
    imap.connect("imap.example.com") catch {
        std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
        return;
    };

    // Login
    imap.login("myLogin", "myPassword") catch {
        std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
        return;
    };

    // Select an IMAP mailbox
    imap.selectMailbox("Inbox") catch {
        std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
        return;
    };

    // Set PeekMode so that downloaded messages are not
    // automatically marked as seen.
    imap.setPeekMode(true);

    // The NumMessages property contains the number of messages
    // in the currently selected mailbox.
    const num_msgs = imap.getNumMessages();
    if (num_msgs == 0) {
        return;
    }

    const email = try chilkat.Email.init();
    defer email.deinit();
    var i: i32 = 0;
    i = 1;
    while (i <= num_msgs) : (i += 1) {
        // Download each email by sequence number (not UID)
        imap.fetchEmail(false, @as(u32, @intCast(i)), false, email) catch {
            std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
            return;
        };

        // If desired, mark the email as SEEN.  There are two
        // ways to do it:

        // 1) Set the flag directly by using the sequence number
        // Indicate that we are passing a sequence number and
        // not a UID:
        const b_is_uid = false;
        // Set the SEEN flag = 1 to mark the email as SEEN,
        // or set it to 0 to mark it as not-seen.
        imap.setFlag(@as(u32, @intCast(i)), b_is_uid, "SEEN", 1) catch {
            std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
            return;
        };

        // 2) Alternatively, we can use the email object.
        // When an email is downloaded from the IMAP server
        // Chilkat will add a "ckx-imap-uid" header to the email.
        // This makes it possible to know the UID associated with
        // the email.  (This is not the sequence number, which may change
        // from session to session, but the UID which does not change.
        // The SetMailFlag method is identical to SetFlag, except
        // it gets the UID from the ckx-imap-uid header.
        // For example:
        imap.setMailFlag(email, "SEEN", 1) catch {
            std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
            return;
        };
    }

    // Disconnect from the IMAP server.
    try imap.disconnect();
}