PureBasic

Get a Raw Text Directory Listing (LIST)

Demonstrates the Chilkat Ftp2.GetTextDirListing method, which sends a legacy LIST request and returns the server's raw textual listing. The only argument is appended literally as a server-side listing argument; an empty string lists the current remote directory.

Background: This returns exactly what the server's LIST command produces — usually a Unix ls -l-style block, but the format is server-defined and not standardized. That makes it handy for display or debugging, but fragile to parse; prefer GetXmlDirListing or the index-based accessors when you need structured data. Since the argument is appended literally to LIST, it can carry server-specific options as well as a wildcard.

Chilkat PureBasic Downloads

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkFtp2.pb"

Procedure ChilkatExample()

    success.i = 0

    ;  Demonstrates the Ftp2.GetTextDirListing method, which sends a legacy LIST request and returns
    ;  the server's raw textual listing.  The only argument is appended literally as a server-side
    ;  listing argument; an empty string lists the current remote directory.

    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

    success = CkFtp2::ckChangeRemoteDir(ftp,"public_html")
    If success = 0
        Debug CkFtp2::ckLastErrorText(ftp)
        CkFtp2::ckDispose(ftp)
        ProcedureReturn
    EndIf

    ;  Get the raw listing text.  The format is server-defined (often Unix "ls -l" style).
    listing.s = CkFtp2::ckGetTextDirListing(ftp,"")
    If CkFtp2::ckLastMethodSuccess(ftp) = 0
        Debug CkFtp2::ckLastErrorText(ftp)
        CkFtp2::ckDispose(ftp)
        ProcedureReturn
    EndIf

    Debug listing

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



    CkFtp2::ckDispose(ftp)


    ProcedureReturn
EndProcedure