BCB 內建檔案操作庫函數詳解 (三大類：檔名、管理、I/O)

前言

C++ Builder 提供一組緊密整合 VCL/RTL 的檔案操作函數，支援 AnsiString，使用最便利。分為三類：

一、檔名/路徑處理函數

範例：ExpandFileName

extern PACKAGE AnsiString __fastcall ExpandFileName(const AnsiString FileName);
// 回傳完整路徑
ShowMessage(ExpandFileName(Application->ExeName)); // 顯示如 C:\MyBCB\Sample1.EXE

二、檔案管理函數

• FileExists, DirectoryExists
• ForceDirectories (遞迴建立目錄)
• DeleteFile, RenameFile
• FileCopy (支援覆蓋選項)
• FileAge (取得修改時間, -1 表不存在)
• FileGetAttr/SetAttr (屬性: 隱藏、唯讀、系統、存檔)
• DiskFree/Size (磁碟剩餘/總空間)

三、檔案 I/O 函數 (低階 Handle)

• FileOpen (mode: fmOpenRead, fmOpenWrite, fmOpenReadWrite, fmShareExclusive...)
• FileCreate
• FileRead/Write (Handle, Buffer, Count)
• FileSeek (Handle, Offset, Origin)
• FileClose

回傳值：Handle (>=0 成功), -1 失敗。需自行管理緩衝區與錯誤檢查。

進階：TFileStream (推薦)

封裝上述 Handle 操作，支援 RAII、例外安全、流式讀寫 (ReadBuffer/WriteBuffer、Seek、Position、Size)、可掛接 TStream 衍生類。範例：

TFileStream *fs = new TFileStream("data.bin", fmCreate | fmShareDenyWrite);
try {
    fs->WriteBuffer(&myStruct, sizeof(myStruct));
} __finally { delete fs; }

總結：簡單路徑操作用檔名函數；管理用管理函數；資料讀寫優先用 TFileStream，僅在需精細控制共享模式或極致效能時用低階 FileOpen/Read/Write。