CFileFind类

一、注意：
 
    1、CFileFind类的声明文件保存在afx.h头文件中。
 
    2、CFileFind类实现的功能：执行本地文件的查找(查找某个具体的文件，查找某类文件x*.x*，查找所有文件*.*)
 
    3、CFileFind类是CGopherFileFind和CFtpFileFind类的基类。
 
    4、CFileFind类的构造函数::CFileFind()和关闭函数::Close()成对使用。
 
    5、CFileFind类中成员函数使用顺序：在创建了CFileFind对象后，先执行::FindFile()函数，然后执行::FindNextFile()，然后选择执行（获得文件属性类）的函数或者（判断文件属性类）函数。
 
二、CFileFind类的成员函数根据其操作特性划分为３类：查找操作、获得文件属性、判断文件属性。
 
    查找操作：
    ::FindFile();
    ::FindNextFile();
 
    获得文件属性：
    ::GetCreationTime();
    ::GetLastAccessTime();
    ::GetLastWriteTime();
    ::GetFileName();
    ::GetRoot();
    ::GetFilePath();
    ::GetFileTitle();
    ::GetFileURL();
    ::GetLength();
 
    判断文件属性：
    ::IsArchived();
    ::IsCompressed();
    ::IsDirectory();
    ::IsDots();
    ::IsHidden();
    ::IsNormal();
    ::IsReadOnly();
    ::IsSystem();
    ::IsTemporary();
    ::MatchesMask();
 
三、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：临时文件
        FILE_ATTRIBUTE_HIDDEN：隐藏文件
 
四、CFileFind类的使用方法：
 
    1、遍历一个目录：
 
    void Operate(const CString& csDir)
    {
        CString strDir = csDir;
        CFileFind ff;
        if(_T("\\") != strDir.Right(1))
        {
            strDir += _T("\\");
        }
        strDir += _T("*.*"); 
        BOOL res = ff.FindFile(strDir);
        while(res)
        {
            res = ff.FindNextFile();
            // 遍历子目录
            if (!ff.IsDots())
            {
                if(ff.IsDirectory())
                {
                    Operate();
                }
                else
                {
                    // 代码
                }
            } 
        }
        ff.Close(); // 不要忘记关闭
    }    
 
    2、成员函数的使用
 
    GetfilePath()和GetFileName()函数得到的值区别，即返回结果：
 
    l_strFilePath = ff.GetFilePath();
    l_strFileName = ff.GetFileName();
 
    l_nPoint = l_strFileName.ReverseFind(_T('.')); // 因为文件名中可能出现多个'.'所以用  ReverseFind而不用Find
    l_nLength = l_strFileName.GetLength();   
    l_strFileExt = l_strFileName.Right(l_nLength - l_nPoint - 1);
 
    l_strFileTitle = ff.GetFileTitle();
    l_strFileUrl = ff.GetFileURL();
    l_strFileRoot = ff.GetRoot();
    l_dwLength = ff.GetLength();
 
    得到的结果：
    Filepath: f:\test.doc
    FileName: test.doc
 
    FileExe: doc
 
    nFileTitle: test
    FileUrl: file://f:\test.doc
    FileRoot: f:\
    FileLength: 23456
            
    3、文件复制 
    try
    {
        CopyFile(strFullName, strBackDir + strFileName, FALSE); // copy file
        DeleteFile(strFullName); // delete source file
    }
    catch (CFileExceptione){}   
 
    4、例子           
 
    void Operate(const CString& csDir, CString& strResult)
    {
        CFileFind ff;
        CString l_strFilePath;
        CString l_strFileName;
        CString l_strFileExt;
        CString l_strFileTitle;
        CString l_strFileUrl;
        CString l_strFileRoot;
        DWORD l_dwLength;
        CString l_strResult;
 
        int l_nPoint;
        int l_nLength;
 
        strResult.Empty();
        CString l_strDir = csDir; // m_strDir = "f:\\";
        if(_T("\\") != l_strDir.Right(1))
        {
            l_strDir += _T("\\"); 
        }
        l_strDir += _T("*.*"); 
        BOOL res = ff.FindFile(l_strDir);
        while(res)
        {
            res = ff.FindNextFile();
            // 遍历子目录
            if (!ff.IsDots())
            {
                if(ff.IsDirectory())
                {
                    Operate();
                }
                else
                {
                    l_strFilePath = ff.GetFilePath();
                    l_strFileName = ff.GetFileName();
 
                    l_nPoint = l_strFileName.ReverseFind(_T('.')); // 因为文件名中可能出现多个'.'所以用ReverseFind而不用Find
                    l_nLength = l_strFileName.GetLength();   
                    l_strFileExt = l_strFileName.Right(l_nLength - l_nPoint - 1);
 
                    l_strFileTitle = ff.GetFileTitle();
                    l_strFileUrl = ff.GetFileURL();
                    l_strFileRoot = ff.GetRoot();
                    l_dwLength = ff.GetLength();
                    l_strResult.Format(_T("Filepath: %s\r\nFileName: %s\r\nFileExe: %s\r\nnFileTitle: %s\r\nFileUrl: %s\r\nFileRoot: %s\r\nFileLength: %d\r\n\r\n", l_strFilePath, l_strFileName, l_strFileExt, l_strFileTitle, l_strFileUrl, l_strFileRoot, l_dwLength));
                    strResult = l_strResult;  
                }
            }             
        }
        ff.Close(); 
    } 

from:http://blog.csdn.net/zhangmiaoping23/archive/2009/03/25/4023705.aspx