CFileFind类的使用总结(转)


CFileFind类的使用总结
2007-7-7
1、CFileFind类的声明文件保存在afx.h头文件中。
2、该类的实现的功能：执行本地文件的查找(查找某个具体的文件，查找某类文件x*.x*，查找所有文件*.*)
3、CFileFind类是CGopherFileFind和CFtpFileFind类的基类。
4、CFileFind类的构造函数::CFileFind()和关闭函数::Close()我会成对使用。
5、CFileFind类的成员函数我根据其操作特性划分为３类：查找操作类、获得文件属性类、判断文件属性类。(下面我先进行函数罗列并没有完整的描述函数的参数)
查找操作类
      ::FindFile();
      ::FindNextFile();
获得文件属性类
      ::GetCreationTime();
      ::GetLastAccessTime();
      ::GetLastWriteTime();
::GetFileName();
::GetRoot();
      ::GetFilePath();
      ::GetFileTitle();
      ::GetFileURL();
      ::GetLength();
     
判断文件属性类
      ::IsArchived();
      ::IsCompressed();
      ::IsDirectory();
      ::IsDots();
      ::IsHidden();
      ::IsNormal();
      ::IsReadOnly();
      ::IsSystem();
      ::IsTemporary();
      ::MatchesMask();
6、CFileFind类中成员函数使用应注意的顺序
      在创建了CFileFind对象后，先执行::FindFile()函数，然后执行::FindNextFile()，然后选择执行（获得文件属性类）的函数或者（判断文件属性类）函数。
7、CFileFind类成员函数的详细分析
virtual BOOL FindFile(LPCTSTR pstrName = null,DWORD dwUnused = 0);
该函数若返回非0 则表明执行成功，0 则表明执行不成功。
pstrName：需要查找的文件名，例：“E:\编程工具\VC++\MFC例子.rar”，“E:\编程工具\VC++\MFC*.rar”，“E:\编程工具\VC++\*.*”，也可以是NULL表示“*.*”。
dwUnused：必须为0
 
virtual BOOL FindNextFile();
该函数返回值非0 还有符合条件的文件， 0表示是最后一个文件。
 
virtual BOOL GetCreationTime(FILETIME *pFileTime) const;
virtual BOOL GetCreationTime(CTime& refTime) const;
该函数用来获得查找到的某个文件的创建时间，返回值非0 获得创建时间成功操作，0表示执行获得创建时间失败或者FindNextFile()没有被执行的时候。
FILETIME  *：容纳时间的结构指针
CTime&：容纳时间的对象地址
此处介绍：FILETIME和CTime相互转换的处理方法：
FILETIME转CTime的方法：
A、CTime对象在初始化时可以传递FILETIME结构
      FILETIME ft；
      CTime time(ft)；
B、将FILETIME转换为SYSTEMTIME，然后CTime对象在初始化时可以传递SYSTEMTIME结构
      FILETIME ft；
      SYSTEMTIME st；
      BOOL bSuccess ＝ ::FileTimeToSystemTime(&ft , &st);
      CTime time(st)；
CTime转FILETIME方法：
CTime time(CTime::GetCurrentTime());
SYSTEMTIME st;
time.GetAsSystemTime(st);
FILETIME ft;
::SystemTimeToFileTime(&st,&ft);
 
virtual BOOL GetLastAccessTime(FILETIME *pFileTime) const;
virtual BOOL GetLastAccessTime(CTime& refTime) const;
该函数用来获得某个文件最后被访问的时间，非0表示执行成功，0表示执行失败或者FindNextFile()函数没有执行的时候。
 
virtual BOOL GetLastWriteTime(FILETIME *pFileTime) const;
virtual BOOL GetLastWriteTime(CTime& refTime) const;
该函数用来获得某个文件最后被访问的时间，非0表示执行成功，0表示执行失败或者FindNextFile()函数没有执行的时候。
 
virtual CString GetFilePath() const;
该函数用来获得查找到的文件绝对路径，必须在执行了FindNextFile()后该函数才能执行成功。
返回的结果是CString对象，例“E:\编程工具\VC++\MFC.rar”
 
virtual CString GetFileName() const;
该函数用来获得查找到的文件的全称，必须在执行了FindNextFile()后该函数才能执行成功。
返回的结果是CString对象，例“MFC.rar”
 
virtual CString GetFileTitle() const;
该函数用来获得查找到的文件的名称，必须在执行了FindNextFile()后该函数才能执行成功。
返回的结果是CString对象，例“MFC”
 
virtual CString GetRoot() const;
该函数用来获得查找到的文件的根目录，必须在执行了FindNextFile()后该函数才能执行成功。
返回的结果是CString对象，例“E:\编程工具\VC++\”
 
virtual CString GetFileURL() const;
该函数用来获得查找到的文件的URL路径，必须在执行了FindNextFile()后该函数才能执行成功。
返回的结果是CString对象，例“file://E:\编程工具\VC++\MFC.rar”
 
DWORD GetLength() const;
该函数返回值获得查找到的文件的长度，必须在执行了FindNextFile()后该函数才能执行成功。
 
BOOL IsArchived() const;
该函数用来判断查找的文件属性是否是档案文件，非0表示是，0表示不是。必须在执行了FindNextFile()后该函数才能执行成功
 
BOOL  IsCompressed() const;
该函数用来判断查找的文件属性是否是压缩文件，非0表示是，0表示不是。必须在执行了FindNextFile()后该函数才能执行成功
 
BOOL IsDirectory() const;
该函数用来判断查找的文件属性是否是路径文件，非0表示是，0表示不是。必须在执行了FindNextFile()后该函数才能执行成功
 
BOOL IsDots() const;
该函数用来判断查找的文件属性是否是“.”，“..”，非0表示是，0表示不是。必须在执行了FindNextFile()后该函数才能执行成功
 
BOOL IsHidden() const;
该函数用来判断查找的文件属性是否隐藏文件，非0表示是，0表示不是。必须在执行了FindNextFile()后该函数才能执行成功
 
BOOL IsNormal() const;
该函数用来判断查找的文件属性是否正常文件，非0表示是，0表示不是。必须在执行了FindNextFile()后该函数才能执行成功
 
BOOL IsReadOnly() const;
该函数用来判断查找的文件属性是否只读文件，非0表示是，0表示不是。必须在执行了FindNextFile()后该函数才能执行成功
 
BOOL IsSystem() const;
该函数用来判断查找的文件属性是否系统文件，非0表示是，0表示不是。必须在执行了FindNextFile()后该函数才能执行成功
 
BOOL IsTemporary() const;
该函数用来判断查找的文件属性是否临时文件，非0表示是，0表示不是。必须在执行了FindNextFile()后该函数才能执行成功
 
BOOL MatchesMask(DWORD dwMask) const;
该函数用来判断查找的文件的综合属性，非0表示是，0表示不是。必须在执行了FindNextFile()后该函数才能执行成功
dwMask参数的使用方法：几种文件属性采用或运算（|）
文件属性的结构定义：
      FILE_ATTRIBUTE_ARCHIVE：档案文件
      FILE_ATTRIBUTE_COMPRESSED：压缩文件
      FILE_ATTRIBUTE_DIRECTORY：路径文件
      FILE_ATTRIBUTE_NORMAL：正常文件
      FILE_ATTRIBUTE_READONLY：只读文件
      FILE_ATTRIBUTE_SYSTEM：系统文件
      FILE_ATTRIBUTE_TEMPORARY：临时文件

    




例子：

//判断文件夹是否为空
	CFileFind finder;

	CString isFileName = m_Distric + _T("\\*.exe");//m_Distric是一个文件夹路径
	BOOL bWorking = finder.FindFile(isFileName);
	/*while (bWorking)
	{
		bWorking = finder.FindNextFile();
		if (finder.IsDots())//是否存在  点。
		{
			continue;
		}

		if (finder.IsDirectory())
		{
			count_file++;
		}
	}*/
	if (bWorking == 0)
	{
		AfxMessageBox("This folder does not have an executable file");
		return;
	}//end