PureBasic

Append Text Content to a Remote FTP File

Demonstrates the Chilkat Ftp2.AppendFileFromTextData method, which appends text (encoded with a charset) to a remote file. The arguments are the remote filename, the text, and the charset.

Background: This is the append equivalent of PutFileFromTextData — the simplest way to add a line or record to a remote log or data file directly from a string, with no local file involved. The charset controls the encoding of the appended content; the remote filename's own encoding is handled separately.

Chilkat PureBasic Downloads

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkFtp2.pb"

Procedure ChilkatExample()

    success.i = 0

    ;  Demonstrates the Ftp2.AppendFileFromTextData method, which appends text (encoded with a
    ;  charset) to a remote file.  The 1st argument is the remote filename, the 2nd is the text, and
    ;  the 3rd is the charset.

    ftp.i = CkFtp2::ckCreate()
    If ftp.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkFtp2::setCkHostname(ftp, "ftp.example.com")
    CkFtp2::setCkUsername(ftp, "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.
    CkFtp2::setCkPassword(ftp, "myPassword")

    success = CkFtp2::ckConnect(ftp)
    If success = 0
        Debug CkFtp2::ckLastErrorText(ftp)
        CkFtp2::ckDispose(ftp)
        ProcedureReturn
    EndIf

    ;  Append a log line directly, with no local file involved.
    line.s = "2026-07-27 12:00:00  server started" + Chr(10)
    success = CkFtp2::ckAppendFileFromTextData(ftp,"logs/app.log",line,"utf-8")
    If success = 0
        Debug CkFtp2::ckLastErrorText(ftp)
        CkFtp2::ckDispose(ftp)
        ProcedureReturn
    EndIf

    Debug "Appended a log line."

    success = CkFtp2::ckDisconnect(ftp)
    If success = 0
        Debug CkFtp2::ckLastErrorText(ftp)
        CkFtp2::ckDispose(ftp)
        ProcedureReturn
    EndIf



    CkFtp2::ckDispose(ftp)


    ProcedureReturn
EndProcedure