Library: FTP support (OMFTP) Include: omftp.xin

Return type: String Returns: A directory listing.

Declaration

define external stream function FTPConnectionListDir
                        value FTPConnection this-FTPConnection
                    dir value string dir optional
                   full value switch full optional initial {false}

Argument definitions

this-FTPConnection

is an OMX component of type FTPConnection

dir

allows you to specify a different directory for which the contents should be listed.

full

is a switch value that, when true, will cause this function to return a full UNIX-style directory listing (including file permissions, and so forth). When set to false, only the filenames will be returned.

This function lists the entries in the current directory or another specified directory.

To use this function, you must include the following line near the start of your program:

  include "omftp.xin"

Examples:

  ; list directory contents with full listing
  output FTPConnectionListDir MyCon full true

  ; list the contents of the subdirectory "test-dir"
  output FTPConnectionListDir MyCon dir "test-dir" full true

Other Library Functions    FTPConnection    FTPConnectionChangeDir    FTPConnectionClose    FTPConnectionDelete    FTPConnectionDeleteDir    FTPConnectionGetStatusReport    FTPConnectionGetWorkingDir    FTPConnectionIsInError    FTPConnectionIsOpen    FTPConnectionListDir    FTPConnectionMakeDir    FTPConnectionOpen    FTPConnectionRemoteInputFile    FTPConnectionRemoteOutputFile    FTPConnectionSetASCII    FTPConnectionSetBinary    FTPIsVersionCompatible    FTPLibraryVersion

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]