List

$FTP->List([pattern, listmode])

$FTP->Ls([pattern, listmode])

$FTP->Dir([pattern, listmode])

• Returns a list containing the files found in the current directory, matching the given pattern, if specified. The content of the returned list depends on the listmode parameter, which can have the following values:
  • 1 (default)
  • The list contains the names of the files found.
  • 2
  • The list contains seven values for each file:
    • The file name
    • The DOS short file name, a.k.a. 8.3
    • The size
    • The attributes
    • The creation time
    • The last access time
    • The last modified time
  • 3
  • The list contains a reference to a hash for each found file. Each hash contains the following key/value pairs:
    
    

    name => file name altname => DOS short file name, a.k.a. 8.3 size => size attr => attributes ctime => creation time atime => last access time mtime => last modified time
    

    
    
    

  All times are reported as strings of the following format: second, hour, minute, day, month, year. For example:

  $file->{'mtime'} == "0,10,58,9,12,1996" # stands for 09 Dec 1996 at 10:58:00