VC知识库文章 - 一个CFileFind的扩展类CFileFindExt(update)

一个CFileFind的扩展类CFileFindExt
----搜索或处理指定目录下的所有文件

作者/

一、类CfileFindExt功能说明
大家经常需要对指定目录下的所有文件进行搜索或其它相同操作。若文件数很多，逐一对每个文件手工操作，很费时。作者用基于层次遍历的非递归算法（以减少运行时的时间和空间开销）实现了一个CFileFind的扩展类CFileFindExt，该类可以对指定目录下的所有文件进行搜索或相同的批处理操作，同时也可根据搜索后得到的文件名对每个文件分别进行处理。

二、类 CFileFindExt 的接口说明及用法示例：
1、头文件、处理函数、以及类的声明:

#include "stdafx.h.h"
#include "FileFindExt.h"

//①一个参数型处理函数：
BOOL ProcessFile1(CString SrcFile)  //文件名可自定义
{ 
    //自定义函数体
}

//②两个参数型处理函数：
BOOL ProcessFile2(CString SrcFile, CString DstFile)  //文件名可自定义
{
    //自定义函数体
}

//③类的声明 
CFileFindExt ProcessDir;

2、调用说明及示例：

① 对所有文件进行一个参数型函数批处理

调用示例：BOOL ret=ProcessDir. DoProcess(DirName, ProcessFile1, FileExtName);
功能说明：对指定目录下、指定文件扩展名的所有文件，调用一个参数型处理函数进行批处理，
参数说明：DirName：指定目录名
         ProcessFile1：一个参数型处理函数批针PROFUN1
         FileExtName：指定扩展名，缺省为所有类型文件
输出说明：1、对所有文件处理都成功，则返回true；
          2、某一文件处理出错（函数ProcessFile1 ()返回false），或分配内存不足时，则终止搜索，返回false

② 对所有文件进行两个参数型函数批处理

调用示例：BOOL ret=ProcessDir.DoProcess(DirName, ProcessFile2, , DstDir, SrcFileExt, DstFileExt);
功能说明：对指定目录下、指定文件扩展名的所有文件，调用两个参数型处理函数ProcessFile2进行批处理，
参数说明：DirName： 指定目录名
          ProcessFile2：两个参数型处理函数批针PROFUN2
          DstDir：目标文件存放根目录名
          SrcFileExt：源文件扩展名，缺省为所有类型文件
          DstFileExt：目标文件扩展名，缺省为所有类型文件
输出说明：1、对所有文件处理都成功，则返回true；
          2、某一文件处理出错（函数process()返回false），或分配内存不足时，则终止搜索，返回false
  

③ 搜索所有文件名

调用示例：BOOL ret=ProcessDir.SearchFiles(DirName, FileExtName);
功能说明：搜索指定目录下、指定扩展名的所有文件
参数说明：DirName： 指定目录名
          FileExtName：指定扩展名，缺省为所有类型文件
输出说明：1、所有文件的相对路径文件名（相对于起始搜索路径）保存在成员变量数组m_FileNames中；
          2、成功返回true，分配内存不足时返回false

④ 获取文件总数

调用示例：int iFiles=ProcessDir.GetSize();
功能说明: 获取文件总数
参数说明: 无
输出说明: 返回文件名成员变量数组m_FileNames的大小

⑤ 获取文件名

调用示例：CString FileName=ProcessDir.GetAt(nFileIndex); 
功能说明: 获取文件名
参数说明: nFileIndex：要获取的文件名在成员变量数组中的位置
输出说明: 返回成员变量数组m_FileNames中的第nFileIndex个文件名

说明：以上五个成员函数中，第一二个函数①②是对指定目录下的所有文件进行相同的批处理操作。结合后三个函数③④⑤， 便可对每个文件分别进行处理，具体用法如下：

CFileFindExt ProcessDir;		
BOOL ret=ProcessDir.SearchFiles(Dir, "*.*");
if (!ret)
{
	//错误处理
}    
int iFiles=ProcessDir.GetSize();
for (int j=0;j
      
三、示例工程说明

为简要地说明CFileFindExt类的用法，作者做了一个简单的示例工程，分别对该工程下TestDir目录的所有子目录中的文本文件进行：

1、统计该目录下所有文件字节数，以说明成员函数DoProcess如何对用一个参数型函数指针进行批处理操作；
2、拷贝该目录下的所有文件到同层次下的DstDir目录下，以说明成员函数DoProcess如何对用两个参数型函数指针进行批处理操作；
3、拼接该定目录下的所有文件，以说明如何结合后函数③④⑤，对每个文件分别进行处理。

为简便起见，本示例工程均假设所有文件长度不是太大。


      


       四、欢迎大家使用。

      今后大家根据需要还可增加返回所有子目录名函数，以及增加其它多参数（大于2）处理函数功能。如有问题，欢迎与作者联系：[e-mail]
   
    
--------------------next---------------------