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

创建一个新文件

头文件：#include <System.SysUtils.hpp>
命名空间：System::Sysutils
函数原型：

NativeUInt __fastcall FileCreate(const System::UnicodeString FileName);
NativeUInt __fastcall FileCreate(const System::UnicodeString FileName, int Rights);
NativeUInt __fastcall FileCreate(const System::UnicodeString FileName, unsigned Mode, int Rights);

参数：

• FileName：路径和文件名；
• Rights：权限，
  • Windows 不使用这个参数，
  • Android 和 MAC / IOS 使用这个参数，如果没有这个参数，使用全局变量 System::FileAccessRights，这个全局变量的默认值是 S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP | S_IROTH | S_IWOTH；
• Mode：文件读写和共享方式，如果没有这个参数，认为是 fmOpenRead | fmShareExclusive，这个参数值由读写和共享两部分按位或得到，其中：
  • 读写方式：fmOpenRead、fmOpenWrite、fmOpenReadWrite；
  • 共享方式：fmShareCompat、fmShareExclusive、fmShareDenyWrite、fmShareDenyRead、fmShareDenyNone；
• 如果要使用 Mode 参数，就必须使用三个参数的函数，在 Windows 里面第三个参数可以用 0 ( Windows 不使用第三个参数， 也没有 System::FileAccessRights 这个全局变量)
• 如果要两个程序代码同时访问一个文件 (无论是在同一个进程还是不同的进程)，打开文件的读写方式和共享方式不能矛盾，否则后打开的文件不能成功，例如先以 fmOpenReadWrite|fmShareDenyWrite 方式打开，并且在关闭之前，另一段代码同时再以 fmOpenRead|fmShareDenyWrite 方式打开会失败，虽然前面代码允许这段代码读文件，但是这段代码不允许其他代码写，这与先打开的文件矛盾了，所以会失败。

返回值：

• 新创建文件的句柄，如果文件创建成功；
• INVALID_HANDLE_VALUE，如果文件创建失败；

例：创建一个 UTF-8 文本文件，写入一行文字

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    NativeUInt hFile = FileCreate(L"D:\\HsuanluFileTest.txt", fmOpenReadWrite|fmShareDenyWrite, 0);
    if(hFile == (NativeUInt)INVALID_HANDLE_VALUE)
    {
        ShowMessage(L"创建文件失败");
        return;
    }
    UTF8String s = L"测试 FileCreate / FileWrite / FileClose - 玄坴";
    FileWrite(hFile, "\xEF\xBB\xBF", 3); // UTF-8 BOM
    FileWrite(hFile, s.c_str(), s.Length());
    FileClose(hFile);
}

相关：

• System::Sysutils::FileOpen
• System::Sysutils::FileCreate
• System::Sysutils::FileRead
• System::Sysutils::FileWrite
• System::Sysutils::FileSeek
• System::Sysutils::FileClose
• System::Sysutils

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