FindFirst - C++ Builder

C++ Builder 参考手册 ➙ System::Sysutils ➙ FindFirst

查找第一个符合条件的文件

头文件：#include
命名空间：System::Sysutils
函数原型：

int __fastcall FindFirst(const System::UnicodeString Path, int Attr, TSearchRec &F);

参数：

Path：路径和文件名，支持通配符 * 和 ?，例如 "C:\\Windows\\*.exe"
Attr：要查找的文件或文件夹的属性，faAnyFile 为没有限制，匹配任何属性的文件；
F：返回第一个符合条件的文件或文件夹，TSearchRec 类型的结构体：
• Name 文件名
• Size 文件大小 (字节数)
• Attr 文件属性
• ExcludeAttr 返回本次查找不包含的属性，可能包含 faHidden、faSysFile 和 faDirectory，原因是参数 Attr 没有包含这些属性，查找的时候就没包含这样属性的文件；
• TimeStamp 文件的修改时间
• FindData 由操作系统返回的查找数据
• FindHandle 由操作系统返回的查找句柄

返回值：

0：找到符合条件的文件或文件夹，通过参数 F 返回找到的文件；
不等于 0：没找到符合条件的文件夹或文件夹
可以用函数 FindNext 继续查找下一个符合条件的文件
查找结束时，必须用函数 FindClose 结束查找，释放占用的资源

属性	描述
faInvalid	无效的文件，文件不会有这个属性值，是在获取属性时表示出错的
faReadOnly	只读
faHidden	隐藏
faSysFile	系统
faVolumeID	卷标 (过时的属性)
faDirectory	文件夹
faArchive	归档，如果文件被修改这个属性会被置位。新创建的文件一般都有这个属性，把这个属性清掉之后，如果发现这个属性被置位了，可以认为这个文件被修改了
faNormal	文件没有其他属性，这个属性独立存在
faTemporary	临时文件
faSymLink	符号链接
faCompressed	压缩
faEncrypted	加密
faVirtual	虚拟文件
faAnyFile	文件不会有这个属性值，这是在查找文件时使用的值，表示任何属性的文件

例子：把 C:\Windows 文件夹里面的内容显示在 TStringGrid 里面

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    StringGrid1->RowCount = 2;
    StringGrid1->Cells[0][0] = L"文件名";
    StringGrid1->Cells[1][0] = L"大小";
    StringGrid1->Cells[2][0] = L"时间";
    StringGrid1->Cells[3][0] = L"属性";

    int iRowNo = 1;
    TSearchRec sr;
    if(FindFirst(L"C:\\Windows\\*.*", faAnyFile, sr) == 0)
    {
        do{
            UnicodeString sAttr;
            sAttr += sr.Attr & faReadOnly ? L"r" : L"-";
            sAttr += sr.Attr & faArchive  ? L"a" : L"-";
            sAttr += sr.Attr & faHidden   ? L"h" : L"-";
            sAttr += sr.Attr & faSysFile  ? L"s" : L"-";
            StringGrid1->RowCount = iRowNo + 1;
            StringGrid1->FixedRows = 1;
            StringGrid1->Cells[0][iRowNo] = sr.Name;
            StringGrid1->Cells[1][iRowNo] = sr.Attr & faDirectory ? String(L"<文件夹>") : IntToStr(sr.Size);
            StringGrid1->Cells[2][iRowNo] = FormatDateTime(L"yyyy/mm/dd hh:nn:ss.zzz",sr.TimeStamp);
            StringGrid1->Cells[3][iRowNo] = sAttr;
            iRowNo++;
        } while(FindNext(sr) == 0);
        FindClose(sr);
    }
}

运行结果

FindFirst - C++ Builder

你可能感兴趣的:(FindFirst - C++ Builder)