Lua

Upload Text to an FTP Server (StringBuilder)

Demonstrates the Chilkat Ftp2.PutFileSb method, which encodes the text in a StringBuilder and uploads it to a remote path. The arguments are the StringBuilder, the charset, whether to include a byte-order mark, and the remote file path.

Background: The text-oriented upload: assemble a document — CSV, config, JSON — in a StringBuilder and the method handles encoding as it writes. The charset governs the bytes actually stored, and the byte-order-mark flag is useful when a consuming Windows application expects a BOM.

Chilkat Lua Downloads

Download Chilkat for Lua

Lua

local chilkat = require("chilkat")

-- Demonstrates the Ftp2.PutFileSb method, which encodes the text in a StringBuilder and uploads
-- it to a remote path.  The 1st argument is the StringBuilder, the 2nd is the charset, the 3rd
-- selects whether a byte-order mark is included, and the 4th is the remote file path.

local ftp = chilkat.Ftp2.new()

ftp.hostname = "ftp.example.com"
ftp.username = "myFtpLogin"

-- 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.
ftp.password = "myPassword"

local success = ftp:connect()
if not success then
    print(ftp.last_error_text)
    return
end

-- Build the text to upload.
local sb = chilkat.StringBuilder.new()
sb:append("name,quantity\n")
sb:append("widgets,42\n")

-- Upload as UTF-8 without a byte-order mark.
local includeBom = false
success = ftp:put_file_sb(sb, "utf-8", includeBom, "public_html/inventory.csv")
if not success then
    print(ftp.last_error_text)
    return
end

print("Uploaded text file.")

success = ftp:disconnect()
if not success then
    print(ftp.last_error_text)
    return
end