4D Doc Center : FTP

4D Internet Commands v14

FTP_GetDirList


FTP_GetDirList ( ftp_ID ; cheminServeur ; tabNoms ; tailles ; types ; datesModif ; heuresModif ) -> Résultat

Paramètre	Type	Description
ftp_ID	Entier long	Référence d'une connexion FTP
cheminServeur	Texte	Chemin d'accès à un répertoire Unix sur le serveur FTP
		Répertoire de travail courant (CWD)
tabNoms	Tableau chaîne	Liste de noms
tailles	Tableau entier long	Liste de tailles
types	Tableau entier	Liste de types 0 = fichier normal, 1 = répertoire, 2 = fichier spécial de type bloc, 3 = fichier spécial de type caractère, 4 = lien symbolique, 5 = fichier spécial FIFO, 6 = porte d'accès de la famille d'adresses AF_UNIX
datesModif	Tableau date	Liste des dates de modification
heuresModif	Tableau entier long	Liste des heures de modification
Résultat	Entier	Code d'erreur

Description

La commande FTP_GetDirList retourne la liste des objets présents dans le répertoire cheminServeur de la session FTP identifiée par ftp_ID. Le nom, la taille, le type, la date et, facultativement, l'heure de modification des éléments du répertoire cheminServeur sont renvoyés dans des tableaux. Une connexion au site FTP doit avoir déjà été ouverte par FTP_Login et être toujours valide (FTP_VerifyID). La commande FTP_GetDirList remplace le répertoire de travail courant (ou CWD, Current Working Directory) par celui défini dans le paramètre cheminServeur.

ftp_ID est l'identifiant de la session FTP établie avec FTP_Login.

Le paramètre cheminServeur contient un chemin d'accès au format Unix référençant un répertoire FTP. Il est fortement recommandé de passer une variable ou un champ 4D dans ce paramètre car le répertoire de travail courant résultant lui sera retourné après l'exécution de la commande. Généralement, la valeur renvoyée sera identique à celle qui a été passée. Toutefois, dans certains cas (par exemple des restrictions d'accès), le changement de répertoire a échoué. Le paramètre cheminServeur contient alors le chemin d'accès du répertoire courant du serveur pour la session.
Si vous passez une chaîne vide dans ce paramètre, les tableaux sont remplis avec la liste des fichiers du répertoire courant et le chemin d'accès du répertoire courant du serveur (CWD) est retourné dans le paramètre cheminServeur.

noms est un tableau de type alphanumérique ou texte recevant le nom de chaque objet présent dans le répertoire cheminServeur spécifié.

tailles est un tableau de type entier long recevant la taille des objets du répertoire cheminServeur.

types est un tableau de type entier recevant les valeurs de type de chaque objet du répertoire cheminServeur. Voici les valeurs possibles et les types correspondants :

Type	Fichier
0	fichier ordinaire
1	répertoire
2	fichier spécial de type bloc
3	fichier spécial de type caractère
4	lien symbolique (alias vers des fichiers ou des dossiers)
5	fichier spécial FIFO
6	porte d'accès de la famille AF_UNIX

Note : Dans le cas d’un lien symbolique (type=4), le serveur FTP retourne un chemin d’accès particulier (Nom d’alias + symbole + chemin d’accès au fichier ou dossier source). Si vous tentez d’utiliser ce chemin pour accéder au fichier ou dossier source, une erreur sera retournée. Vous devez extraire le chemin d’accès du fichier ou du dossier à partir de la chaîne retournée par FTP_GetDirList. Ce chemin d’accès débute immédiatement après le caractère symbole. Sinon, les commandes telles que FTP_GetFileInfo retourneront l’erreur -10085 puisque le fichier ou le dossier ne sera pas trouvé.

datesModif est un tableau de type date recevant la date de dernière modification de chaque objet du répertoire cheminServeur.

heuresModif est un tableau de type entier long recevant l'heure de dernière modification de chaque objet du répertoire cheminServeur.

Rappel : Dans 4D, le type de tableau entier long est utilisé pour manipuler les données de type heure. Chaque élément du tableau représente un nombre de secondes. Utilisez la commande Chaine heure pour convertir ces valeurs au format HH:MM:SS.