  ftp Library Package 2.1 for Tcl/Tk Manual Pages

  COMMAND
    ftp::List handle ?directory?
    The ftp::List command lists the contents of the current remote directory or if the directory parameter is specified a directory or other group of files. Also wildcard expression, such as "*.tcl", can be specified. The directory or file name must be fully qualified, otherwise the it takes entries in the current remote directory.

    The listing includes any system-dependent information that the server chooses to include; for example, most UNIX systems produce output from the command "ls -l". ftp::List returns these information as a tcl list with one line for every entry. Empty lines and UNIX's "total" lines are ignored. So it should offer only usable informations.

    If the command fails an empty list is returned.

  EXAMPLE

        # list current directory
        foreach line [ftp::List $conn]
        	puts $line
        }

        # list only tcl files
        foreach line [ftp::List $conn *.tcl]
        	puts $line
        }

        # list specified directory
        set dir_list [ftp::List $conn /pub/usr/lib]

        # list if directory exist
        if {[ftp::Cd $conn /pub/usr/lib]} {
        	set dir_list [ftp::List $conn]
        } else {
        	puts "Directory doesn't exist!"
        }

[Contents] [Previous: ftp::Type] [Next: ftp::NList]

© 1999 Steffen Traeger