Windows程序设计11：文件的查找与遍历

---

前言

Windows程序设计11：文件的查找与遍历。

---

一、文件的遍历和查找FindFirstFile和FindNextFile

1.FindFirstFile

根据文件名称查找文件，该函数到一个文件夹（包含子文件夹）去搜索指定文件，如果使用附加属性去搜索文件的话，可以使用FindFirstFileEx函数。FindFirstFile的函数原型为

HANDLE FindFirstFile(
  LPCTSTR            lpFileName,  // 查找的文件名或路径
  LPWIN32_FIND_DATA  lpFindFileData // 接收文件信息的结构
);

参数LPCTSTR lpFileName为要查找的文件名或路径。可以使用通配符* 或 ? 来匹配多个文件。
例如："C:\example\* " 查找 C:\example 目录中的所有文件和子目录。“C:\example\*.txt”：查找 C:\example 目录中的所有 .txt 文件。

参数LPWIN32_FIND_DATA lpFindFileData为指向 WIN32_FIND_DATA 结构的指针，用于接收找到的文件或目录的信息。
WIN32_FIND_DATA 结构包含找到的文件或目录的详细信息。以下是其定义：

typedef struct _WIN32_FIND_DATA {
  DWORD    dwFileAttributes;  // 文件属性
  FILETIME ftCreationTime;    // 创建时间
  FILETIME ftLastAccessTime;  // 最后访问时间
  FILETIME ftLastWriteTime;   // 最后修改时间
  DWORD    nFileSizeHigh;     // 文件大小（高 32 位）
  DWORD    nFileSizeLow;      // 文件大小（低 32 位）
  DWORD    dwReserved0;       // 保留
  DWORD    dwReserved1;       // 保留
  TCHAR    cFileName[MAX_PATH]; // 文件名
  TCHAR    cAlternateFileName[14]; // 8.3 格式的文件名
} WIN32_FIND_DATA;

返回值：如果函数执行成功，返回一个查找句柄，用于后续调用 FindNextFile 或 FindClose。注意：搜索/遍历完成后，必须要用FindClose函数关闭这个句柄。如果函数执行失败，返回 INVALID_HANDLE_VALUE。可以通过 GetLastError 获取错误代码。

2.FindNextFile

可以用来遍历目录或文件，判断当前目录下是否有下一个文件，函数原型为

BOOLFindNextFile(
HANDLE hFindFile, //searchhandle
LPWIN32_FIND_DATA lpFindFileData //databuffer
);

参数HANDLE hFindFile为上一次查找返回的搜索文件句柄。
参数LPWIN32_FIND_DATA lpFindFileData用于装载与找到的文件有关的信息，该结构可用于后续的遍历与搜索。

返回值：布尔类型，函数执行成功返回TRUE；函数执行失败返回FALSE，可调用GetLastError返回错误码。

二、如何使用FindFirstFile和FindNextFile实现文件的遍历

首先，由于要使用cout进行输出查找到的文件名，而桌面应用程序中无法使用cout进行输出，要将其改为控制台应用，具体如下图

此时编译会报错

这是由于桌面应用程序的入口点函数为WinMain，而控制台应用程序的入口点函数为main，将入口点函数进行一下更改

遍历如下文件夹内的文件

程序如下

#include<windows.h>
#include<tchar.h>
#include<iostream>
using namespace std;
#define	str_len 32

// 封装一个函数,第一个参数为文件夹的路径；第二个参数为要查找的文件类型
BOOL EnumFiles(LPCTSTR lpPath, LPCTSTR lptype)
{
	TCHAR path[MAX_PATH] = { 0 };// 初始化用于组合两个参数的字符串
	_stprintf_s(path, _countof(path), _T("%s\\%s"), lpPath, lptype);
	WIN32_FIND_DATA FindData = { 0 };
	HANDLE handle1= FindFirstFile(path, &FindData);
	if (handle1 == INVALID_HANDLE_VALUE) // 如果FindFirstFile没有调用成功
	{
		return FALSE;
	}
	//如果FindFirstFile调用成功
	BOOL bret;
	do 
	{
		bret = FindNextFile(handle1, &FindData);
		if (!bret) break; // 如果bret为0则跳出循环

		wcout << FindData.cFileName << endl;
		
	} while (bret);
	return TRUE;
}

// 前两个参数用的不多，后两个参数用的较多，
//第一个参数为当前程序的实例句柄；第二个参数为上一个程序的实例句柄；第三个参数为命令行参数(字符串类型)；第四个参数为显示方式
//int WINAPI _tWinMain(HINSTANCE hInstance, HINSTANCE hPreInstance, LPTSTR lpCmdLine, INT nShowCmd) // 通用字节类型的入口点函数
int _tmain()
{
	EnumFiles(_T("D:\\Multisim"), _T("*"));
	return 0;
}

得到的结果如下

可以正常将文件全部遍历

此时显示中文可能会存在问题，这是由于wcout没有正确处理宽字符造成的，这里通过在主函数中添加如下代码解决了中文显示的问题（造成中文不正常显示的原因有很多，网上的资料也很多，大家可以自行查询，可能就算添加了如下代码有的编译器还是不会正常显示，那就是其他的原因。）

std::locale::global(std::locale(""));
// 输出宽字符字符串
std::wcout.imbue(std::locale()); // 将 wcout 的区域设置与全局区域设置同

例如没有添加上述代码之前，遍历如下文件夹的结果为


中文文件无法显示，但其实是遍历到了的
添加后显示如下

同时，还可以利用文件的属性区分文件夹和文件，整体代码如下

#include<windows.h>
#include<tchar.h>
#include<iostream>
using namespace std;
#define	str_len 32

// 封装一个函数,第一个参数为文件夹的路径；第二个参数为要查找的文件类型
BOOL EnumFiles(LPCTSTR lpPath, LPCTSTR lptype)
{
	TCHAR path[MAX_PATH] = { 0 };// 初始化用于组合两个参数的字符串
	_stprintf_s(path, _countof(path), _T("%s\\%s"), lpPath, lptype);
	WIN32_FIND_DATA FindData = { 0 };
	HANDLE handle1= FindFirstFile(path, &FindData);
	if (handle1 == INVALID_HANDLE_VALUE) // 如果FindFirstFile没有调用成功
	{
		return FALSE;
	}
	//如果FindFirstFile调用成功
	BOOL bret;
	do 
	{
		bret = FindNextFile(handle1, &FindData);
		if (!bret) break; // 如果bret为0则跳出循环

		if (FindData.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY) // 文件属性
		{
			cout << "文件夹：";// 文件夹
		}
		else //文件
		{
			cout << "文件：";
		}

		wcout << FindData.cFileName << endl;
		
	} while (bret);
	return TRUE;
}

// 前两个参数用的不多，后两个参数用的较多，
//第一个参数为当前程序的实例句柄；第二个参数为上一个程序的实例句柄；第三个参数为命令行参数(字符串类型)；第四个参数为显示方式
//int WINAPI _tWinMain(HINSTANCE hInstance, HINSTANCE hPreInstance, LPTSTR lpCmdLine, INT nShowCmd) // 通用字节类型的入口点函数
int _tmain()
{
	locale::global(std::locale(""));

	// 输出宽字符字符串
	wcout.imbue(std::locale()); // 将 wcout 的区域设置与全局区域设置同
	EnumFiles(_T("D:\\qq"), _T("*"));
	return 0;
}

可以看到区分了文件和文件夹

这里的FILE_ATTRIBUTE_DIRECTORY标识文件夹属性，文件属性还有很多，大家可以自行尝试。

此外需要说明的是，文件夹…表示上一层目录。

---

总结

Windows程序设计11：文件的查找与遍历。