Zig

Write Text at a String Offset in a Remote SFTP File

Demonstrates the Chilkat SFtp.WriteFileText64s method, which is like WriteFileText64 but takes the byte offset as a decimal string. The arguments are the handle, the offset string, the charset, and the text.

Background: Some programming languages Chilkat targets lack a native 64-bit integer type, or make large integer literals awkward. Passing the offset as a decimal string sidesteps that entirely — the value is parsed by the library — while addressing the same large-file positions as the int64 form.

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 SFtp.WriteFileText64s method, which is like WriteFileText64 but takes the
    // byte offset as a decimal string.  The 1st argument is the handle, the 2nd is the offset string,
    // the 3rd is the charset, and the 4th is the text.

    const sftp = try chilkat.SFtp.init();
    defer sftp.deinit();

    // Connect, authenticate, and initialize the SFTP subsystem.
    const port = 22;
    sftp.connect("sftp.example.com", port) catch {
        std.debug.print("{s}\n", .{try sftp.getLastErrorText(alloc)});
        return;
    };

    // Normally you would not hard-code the password in source.  You should instead obtain it
    // from an interactive prompt, environment variable, or a secrets vault.
    const password = "mySshPassword";

    sftp.authenticatePw("mySshLogin", password) catch {
        std.debug.print("{s}\n", .{try sftp.getLastErrorText(alloc)});
        return;
    };

    sftp.initializeSftp() catch {
        std.debug.print("{s}\n", .{try sftp.getLastErrorText(alloc)});
        return;
    };

    const handle = sftp.openFile(alloc, "subdir/hugefile.dat", "readWrite", "openOrCreate") catch {
        std.debug.print("{s}\n", .{try sftp.getLastErrorText(alloc)});
        return;
    };

    // Supplying the offset as a string is convenient in languages without a native 64-bit integer.
    const offset = "5000000000";
    sftp.writeFileText64s(handle, offset, "utf-8", "MARKER") catch {
        std.debug.print("{s}\n", .{try sftp.getLastErrorText(alloc)});
        return;
    };

    sftp.closeHandle(handle) catch {
        std.debug.print("{s}\n", .{try sftp.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("Wrote at the string offset.\n", .{});

    sftp.disconnect();
}