Introduction
Il est souvent utile de savoir rechercher l'existence d'un ou de plusieurs fichiers sur un disque, par exemple pour implanter au sein d'un programme la possibilité de lister les fichiers présents dans un répertoire. Cet article explique comment implanter une telle fonction, et pour ceux qui veulent aller plus loin, détaille la méthode pour faire la même chose avec une connexion FTP afin de lister les fichiers présents sur un serveur FTP.
Les fonctions API
Windows® fournit plusieurs fonctions utiles pour rechercher des fichiers sur un disque donné, en fonctions de critères (attributs de fichiers,...). Ces fonctions sont :
HANDLE FindFirstFile(LPCTSTR lpFileName, LPWIN32_FIND_DATA lpFindFileData);
BOOL FindNextFile(HANDLE hFindFile, LPWIN32_FIND_DATA lpFindFileData);
BOOL FindClose(HANDLE hFindFile);
La première fonction, FindFirstFile permet d'initialiser la recherche. Cette fonction renvoie une valeur (hFindFile) qui pourra être utilisée pour accéder aux fichiers suivants qui correspondent aux critères donnés. Si vous souahitez rechercher plusieurs fichiers, la fonction FindNextFile est utilisée ensuite pour accéder succesivement aux autres fichiers répondant aux critères. Enfin, la fonction FindClose permet de cloturer la recherche en libérant la mémoire allouée à la recherche.
La structure lpFindFileData contient de nombreux renseignements sur le fichier trouvé : son nom, ses attribtus, ...
Lorsque vous spécifiez "*.*" dans le paramètre lpFileName de la fonction FindFirstFile, Windows® envoie la liste de tous les fichiers du répertoire courant ainsi que tous les dossiers contenus dans ce dossier, ce qui peut être utile pour lister uniquement les dossiers.
Lister le contenu d'un dossier
L'exemple qui suit affiche la liste de tous les fichiers contenus dans un dossier donné :
void AfficherListeFichiers (char Dossier[MAX_PATH])
{
HANDLE hFind;
WIN32_FIND_DATA FindData;
// Change de dossier
SetCurrentDirectory (Dossier);
// Début de la recherche
hFind=FindFirstFile ("*.*", &FindData);
if (hFind!=INVALID_HANDLE_VALUE)
{
// Si le fichier trouvé n'est pas un dossier mais bien un fichier, on affiche son nom
if (!(FindData.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY))
{
MessageBox (NULL, FindData.cFileName, "Fichier", MB_ICONINFORMATION);
}
// Fichiers suivants
while (FindNextFile (hFind, &FindData))
{
if (!(FindData.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY))
{
MessageBox (NULL, FindData.cFileName, "Fichier", MB_ICONINFORMATION);
}
}
}
// Fin de la recherche
FindClose (hFind);
}
Remarque : en supprimant les deux '!' dans le code précédent, vous obtiendrez la liste des dossiers inclus dans le dossier courant.
Les classes MFC
MFC facilite encore davantage le code pour rechercher des fichiers, avec la classe CFileFind.
Le code ci-dessous reprend les mêmes fonctionnalités que le précédent, mais en utilisant les classes MFC :
void AfficherListeFichiers (CString Dossier)
{
CFileFind Find;
// Change de répertoire
SetCurrentDirectory (Dossier);
// Début de la recherche
if (Find.FindFile ("*.*"))
{
// Si le fichier trouvé n'est pas un dossier mais bien un fichier, on affiche son nom
while (Find.FindNextFile ())
{
if (!Find.IsDirectory ())
{
AfxMessageBox (Find.GetFileName ());
}
}
}
// Fin de la recherche
Find.Close ();
}
Comme vous pouvez le constater, les variables hFind et FindData précédemment définies sont ici automatiquement prises en charge par la classe CFileFind, ce qui nous facilite la tâche !
Remarque : la classe CFileFind suppose que vous avez appelé au moins une fois la fonction FindNextFile avant d'appeler la fonction GetFileName, donc la différence dans la boucle while par rapport au code précédent.
Pour aller plus loin
Si vous utilisez les classes MFC, sachez qu'une classe presque similaire à la classe CFileFind existe pour effectuer les même opérations sur des fichiers et dossiers stockés sur un serveur FTP.
La classe CFtpFileFind s'utilise de la même façon que CFileFind !
Le code ci-dessous liste les fichiers contenu dans un dossier d'un serveur FTP :
void AfficherListeFichiers ()
{
CFtpConnection * pFtpConnection;
CInternetSession Session;
// Connexion FTP
pFtpConnection = NULL;
try
{
pFtpConnection = Session.GetFtpConnection("ftp.club-internet.fr","Anonymous","anomymous@",INTERNET_INVALID_PORT_NUMBER);
}
catch(CInternetException *pEx)
{
pEx->ReportError(MB_ICONEXCLAMATION);
pFtpConnection = NULL;
pEx->Delete();
return;
}
CFtpFileFind Find(pFtpConnection);
// Change de répertoire
pFtpConnection->SetCurrentDirectory ("pub/unix/linux/Mandrake/iso/");
// Début de la recherche
if (Find.FindFile ("*.*"))
{
while (Find.FindNextFile ())
{
if (!Find.IsDirectory ())
{
AfxMessageBox (Find.GetFileName ());
}
}
}
// Fin de la recherche
Find.Close ();
// Fin connexion FTP
Session.Close();
pFtpConnection->Close();
if(pFtpConnection!=NULL)
delete pFtpConnection;
}
Source / Exemple :
void AfficherListeFichiers (char Dossier[MAX_PATH])
{
HANDLE hFind;
WIN32_FIND_DATA FindData;
// Change de dossier
SetCurrentDirectory (Dossier);
// Début de la recherche
hFind=FindFirstFile ("*.*", &FindData);
if (hFind!=INVALID_HANDLE_VALUE)
{
// Si le fichier trouvé n'est pas un dossier mais bien un fichier, on affiche son nom
if (!(FindData.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY))
{
MessageBox (NULL, FindData.cFileName, "Fichier", MB_ICONINFORMATION);
}
// Fichiers suivants
while (FindNextFile (hFind, &FindData))
{
if (!(FindData.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY))
{
MessageBox (NULL, FindData.cFileName, "Fichier", MB_ICONINFORMATION);
}
}
}
// Fin de la recherche
FindClose (hFind);
}
Conclusion :
Pour un article plus complet :
http://www.atlence.com/programs/cpp_search.php
Pour nous faire part de vos remarques : programmation@atlence.com
Pour un exemple d'utilitaire fourni avec ses sources utilisant ce principe :
http://www.atlence.com/programs/sources.php
3 juil. 2005 à 16:57
1 juil. 2005 à 16:57
comment lister les disque dur
A+
31 mai 2005 à 17:41
La fct "FindFirstFile" est ambigüe car elle ne permet pas de traverser un dossier sur lequel vous n'avez pas de droit de lecture ou de "listage". Pourtant, même sans avoir aucun droit sur le dossier il est possible de lister son contenu avec la fonction CreateFile (à condition qu'il y ait au moins un fichier accessible en lecture dans le dossier).
Par conséquent, contrairement à ce qui est dit en début d'article, il ne faut pas utiliser cette fct pour tester l'existence de fichiers, il faut utiliser "CreateFile".
exemple: c:\dossier1\test.txt
- dossier1: aucun droit (NTFS)
- test.txt: tous les droits (non héritage des droits de "dossier1" donc)
Essayez la fct CreateFile et vous constaterez que vous pourrez lire le fichier, écrire dedans, le copier dans un autre dossier, etc...
17 mai 2005 à 20:54
Vérifie d'abord que tu as une connexion Internet active, sinon ça risque de planter. Et de spécifier également une adresse IP valide !! Peut-être que l'adresse que j'ai donné dans l'exemple n'est plus valide !!!
9 mai 2005 à 16:57
Vous n'êtes pas encore membre ?
inscrivez-vous, c'est gratuit et ça prend moins d'une minute !
Les membres obtiennent plus de réponses que les utilisateurs anonymes.
Le fait d'être membre vous permet d'avoir un suivi détaillé de vos demandes et codes sources.
Le fait d'être membre vous permet d'avoir des options supplémentaires.