Sample code for 30+ languages & platforms
Lua

Write Text at a String Offset in a Remote SFTP File

See more SFTP Examples

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 Lua Downloads

Lua
local chilkat = require("chilkat")

-- 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.

local sftp = chilkat.SFtp.new()

-- Connect, authenticate, and initialize the SFTP subsystem.
local port = 22
local success = sftp:connect("sftp.example.com", port)
if not success then
    print(sftp.last_error_text)
    return
end

-- 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.
local password = "mySshPassword"

success = sftp:authenticate_pw("mySshLogin", password)
if not success then
    print(sftp.last_error_text)
    return
end

success = sftp:initialize_sftp()
if not success then
    print(sftp.last_error_text)
    return
end

local handle = sftp:open_file("subdir/hugefile.dat", "readWrite", "openOrCreate")
if not sftp.last_method_success then
    print(sftp.last_error_text)
    return
end

-- Supplying the offset as a string is convenient in languages without a native 64-bit integer.
local offset = "5000000000"
success = sftp:write_file_text64s(handle, offset, "utf-8", "MARKER")
if not success then
    print(sftp.last_error_text)
    return
end

success = sftp:close_handle(handle)
if not success then
    print(sftp.last_error_text)
    return
end

print("Wrote at the string offset.")

sftp:disconnect()