如何使用findfirstfile函数来搜索并显示文件列表

在进行文件操作时，我们常常需要搜索并展示当前目录下的文件列表。而Windows SDK提供了一个非常方便的函数——findfirstfile，它可以帮助我们完成这个任务。在本文中，我们将从多个方面对使用findfirstfile函数进行文件搜索和展示做出详细的阐述。

一、文件搜索基础

在开始介绍findfirstfile函数之前，我们先来了解一下文件搜索的基础原理。在Windows操作系统中，每个目录下都有一个目录文件，我们通常把它叫做“.（点）”文件。这个文件包含了当前目录下所有文件的信息，我们可以通过访问这个文件来获取当前目录下的文件列表。在Windows中，这个”.（点）”文件的名称是“*.*”，它代表了当前目录下的所有文件类型。

二、使用findfirstfile函数进行搜索

findfirstfile函数是Windows SDK提供的一个非常方便的函数，它可以用来搜索指定目录下的文件并返回它们的信息，包括文件名、文件大小、文件创建时间等等。下面是一个使用findfirstfile函数搜索并展示文件列表的示例：

    
#include <windows.h>
#include <stdio.h>

void ListFiles(char *path)
{
    WIN32_FIND_DATAA findData;
    HANDLE hFind = INVALID_HANDLE_VALUE;
    char folderPath[MAX_PATH];

    if(strlen(path) > (MAX_PATH - 3))
        return;

    strcpy(folderPath, path);
    strcat(folderPath, "\\*");

    hFind = FindFirstFileA(folderPath, &findData);
    if(hFind == INVALID_HANDLE_VALUE)
    {
        printf("Failed to find file: %s.\n", path);
        return;
    }

    do
    {
        printf("%s\n", findData.cFileName);
    }while(FindNextFileA(hFind, &findData));

    FindClose(hFind);
}

int main()
{
    char *path = "C:\\test";
    ListFiles(path);
    return 0;
}
    

在这个示例中，我们定义了一个ListFiles函数，这个函数接受一个路径参数，并使用findfirstfile函数来搜索并展示该路径下的所有文件。在函数中，我们先构造了一个表示路径的字符串并拼接了一个“*”字符，获得了搜索该路径下所有文件的表达式，然后调用findfirstfile来搜索所有符合表达式的文件并依次展示文件名。

三、搜索特定类型的文件

除了“*.*”之外，我们也可以使用findfirstfile函数来搜索指定类型的文件，例如搜索所有的jpg图片文件。要实现这个功能，我们只需将文件类型添加到表达式中即可。下面是一个示例代码：

    
#include <windows.h>
#include <stdio.h>

void ListFiles(char *path, char *fileExt)
{
    char folderPath[MAX_PATH];
    sprintf(folderPath, "%s\\*.%s", path, fileExt);

    WIN32_FIND_DATAA findData;
    HANDLE hFind = FindFirstFileA(folderPath, &findData);
    if(hFind == INVALID_HANDLE_VALUE)
    {
        printf("Failed to find file: %s.\n", path);
        return;
    }

    do
    {
        printf("%s\n", findData.cFileName);
    }while(FindNextFileA(hFind, &findData));

    FindClose(hFind);
}

int main()
{
    char *path = "C:\\test";
    char *fileExt = "jpg";
    ListFiles(path, fileExt);
    return 0;
}
    

在这个示例中，我们增加了一个字符串参数来表示需要搜索的文件类型。我们通过sprintf函数将路径和文件类型拼接为一个字符串，并传递给findfirstfile函数进行搜索。

四、使用递归方式搜索文件

有时候，我们需要搜索一个目录的所有子目录中的文件以及本身所在目录中的文件。这时候，我们可以递归调用findfirstfile函数来实现这个功能。下面是一个示例代码：

    
#include <windows.h>
#include <stdio.h>

void ListFiles(char *path)
{
    WIN32_FIND_DATAA findData;
    HANDLE hFind = INVALID_HANDLE_VALUE;
    char folderPath[MAX_PATH];

    if(strlen(path) > (MAX_PATH - 3))
        return;

    strcpy(folderPath, path);
    strcat(folderPath, "\\*");

    hFind = FindFirstFileA(folderPath, &findData);
    if(hFind == INVALID_HANDLE_VALUE)
    {
        printf("Failed to find file: %s.\n", path);
        return;
    }

    do
    {
        if(strcmp(findData.cFileName, "..") == 0 || strcmp(findData.cFileName, ".") == 0)
            continue;

        if((findData.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY) == FILE_ATTRIBUTE_DIRECTORY)
        {
            char subPath[MAX_PATH];
            sprintf(subPath, "%s\\%s", path, findData.cFileName);
            ListFiles(subPath);
        }
        else
        {
            printf("%s\\%s\n", path, findData.cFileName);
        }
    }while(FindNextFileA(hFind, &findData));

    FindClose(hFind);
}

int main()
{
    char *path = "C:\\test";
    ListFiles(path);
    return 0;
}
    

在这个示例中，我们使用了递归的方式来实现对目录和子目录的搜索。当我们遇到一个目录时，我们先递归调用ListFiles函数来搜索该目录下的所有文件，然后回到上一级目录，继续搜索其他目录或文件。当我们遇到一个文件时，我们直接输出其路径和文件名。