PureBasic

Send a Raw FTP Command (Quote)

Demonstrates the Chilkat Ftp2.Quote method, which sends a raw FTP command and returns a success/failure result rather than the reply text. The only argument is the command, which must not contain CR or LF. The full reply is available in the LastReply property.

Background: Quote and SendCommand do the same thing — send an arbitrary control-connection command — and differ only in what they return: Quote gives a boolean keyed on the reply code and leaves the text in LastReply, while SendCommand returns the reply string directly. Choose Quote when you mainly care whether the command succeeded.

Chilkat PureBasic Downloads

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkFtp2.pb"

Procedure ChilkatExample()

    success.i = 0

    ;  Demonstrates the Ftp2.Quote method, which sends a raw FTP command to the server.  The only
    ;  argument is the command text.  Unlike SendCommand, it returns a success/failure bool rather
    ;  than the reply text.

    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")

    ;  Connect and log in (Connect performs both).
    success = CkFtp2::ckConnect(ftp)
    If success = 0
        Debug CkFtp2::ckLastErrorText(ftp)
        CkFtp2::ckDispose(ftp)
        ProcedureReturn
    EndIf

    ;  The command must not contain CR or LF characters.  Here we send a NOOP as an example.
    success = CkFtp2::ckQuote(ftp,"NOOP")
    If success = 0
        Debug CkFtp2::ckLastErrorText(ftp)
        CkFtp2::ckDispose(ftp)
        ProcedureReturn
    EndIf

    ;  The full server reply to the last command is available in the LastReply property.
    Debug CkFtp2::ckLastReply(ftp)

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



    CkFtp2::ckDispose(ftp)


    ProcedureReturn
EndProcedure