TIdFTP.ExtListItem Method (TIdFTPListItems, String)

Implements support for the FTP MLST extension command.

Pascal

procedure ExtListItem(
    AFList: TIdFTPListItems; 
    const AItem: String = ''
); overload;

Parameters

Parameters	Description
AFList	Structured directory listing used to store the values for the command.
AItem	Named item to be be returned in the directory listing.

Description

ExtListItem is an overloaded procedure used to implement support for the FTP MLST extension command for servers supported the capability. The MLST command provides a defined format for directories and files appearing on the remote file system.

ExtListItem stores the textual response for the MLST command in a temporary variable. Values captured in LastCmdResult are added to the temporary variable when one or more semicolon-delimited facts are found in the textual response lines.

When AFList contains a value non-nil object instance, it is used to store the structured DirectoryListing items parsed from the textual response using the IdFTPListParseBase.ParseListing method.

AItem represents the file entry requested for the listing operation. AItem cannot contain a directory name. When AItem contains an empty string, the textual response contains only facts for the currently selected non-root directory.

The MLST response does not include any title, header, or summary lines, or any other formatting, and conforms to the facts indicated in the Capabilities for the FTP server.

Use ExtListDir to get a directory listing for a file or directory using the FTP MLSD command.