C++文件相关函数CreateFile｜ReadFile｜WriteFile用法详解
目录
一、CreateFile
1.1 函数原型
CreateFile 函数是 Windows API 中用于创建文件、目录、管道、控制台输入/输出缓冲区或远程 IO 设备的函数。它位于
HANDLE CreateFile(
LPCTSTR lpFileName,
DWORD dwDesiredAccess,
DWORD dwShareMode,
LPSECURITY_ATTRIBUTES lpSecurityAttributes,
DWORD dwCreationDisposition,
DWORD dwFlagsAndAttributes,
HANDLE hTemplateFile
);
1.2 函数参数介绍
CreateFile 函数的参数说明如下：
lpFileName：指定文件名的字符串指针。
dwDesiredAccess：指定文件的访问模式。可以是下列值之一：
dwShareMode：指定文件的共享模式。可以是下列值之一：
lpSecurityAttributes：指定文件的安全属性。如果设为 NULL，则使用默认安全描述符。
dwCreationDisposition：指定如何创建文件。可以是下列值之一：
dwFlagsAndAttributes：指定文件的属性。可以是下列值之一：
hTemplateFile：指定用于创建文件的模板文件句柄。如果没有模板文件，则设为 NULL。
如果 CreateFile 函数调用成功，则返回一个文件句柄；如果调用失败，则返回一个特殊的值 INVALID_HANDLE_VALUE，并可以使用 GetLastError 函数获取错误代码。
1.3 示例代码
#include
#include
int main() {
// 指定文件名和访问模式
HANDLE hFile = CreateFile(L"test.txt",
GENERIC_WRITE,
0, // 不共享
NULL, // 默认安全描述符
CREATE_ALWAYS, // 如果文件存在，则覆盖
FILE_ATTRIBUTE_NORMAL, // 文件属性
NULL); // 没有模板文件
if (hFile == INVALID_HANDLE_VALUE) {
std::cerr << "Error creating file: " << GetLastError() << std::endl;
return 1;
}
std::cout << "File created successfully." << std::endl;
// 关闭文件句柄
CloseHandle(hFile);
return 0;
}
二、ReadFile
2.1 函数原型
在 C++ 中，可以使用 ReadFile 函数从文件中读取数据。这个函数位于
ReadFile 函数的函数原型如下：
BOOL ReadFile(
HANDLE hFile,
LPVOID lpBuffer,
DWORD nNumberOfBytesToRead,
LPDWORD lpNumberOfBytesRead,
LPOVERLAPPED lpOverlapped
);
2.2 函数参数介绍
ReadFile 函数的参数说明如下：
hFile：指定要读取的文件的句柄。
lpBuffer：指向存储读取数据的缓冲区的指针。
nNumberOfBytesToRead：指定要读取的字节数。
lpNumberOfBytesRead：指向一个变量的指针，用于返回实际读取的字节数。
lpOverlapped：指定用于异步 I/O 的数据结构的指针。如果不使用异步 I/O，则设为 NULL。
在使用完文件后，应调用 CloseHandle 函数来关闭文件句柄，以释放系统资源。
2.3 示例代码
在这个例子中，我们打开了一个名为 test.txt 的文件，并以读取模式打开了它。然后，我们调用 ReadFile 函数读取文件中的数据，并将其存储在缓冲区中。注意，ReadFile 函数的第四个参数是一个输出参数，用于返回实际读取的字节数。如果调用失败，则函数返回 FALSE 并可以使用 GetLastError 函数获取错误代码。
#include
#include
int main() {
// 打开文件
HANDLE hFile = CreateFile(L"test.txt",
GENERIC_READ,
0, // 不共享
NULL, // 默认安全描述符
OPEN_EXISTING, // 只能打开已存在的文件
FILE_ATTRIBUTE_NORMAL, // 文件属性
NULL); // 没有模板文件
if (hFile == INVALID_HANDLE_VALUE) {
std::cerr << "Error opening file: " << GetLastError() << std::endl;
return 1;
}
// 定义缓冲区和读取的字节数
char buffer[1024];
DWORD bytesRead;
// 从文件中读取数据
if (!ReadFile(hFile, buffer, sizeof(buffer), &bytesRead, NULL)) {
std::cerr << "Error reading file: " << GetLastError() << std::endl;
return 1;
}
std::cout << "Read " << bytesRead << " bytes from file." << std::endl;
// 关闭文件句柄
CloseHandle(hFile);
return 0;
}
三、WriteFile
在 C++ 中，可以使用 WriteFile 函数向文件中写入数据。这个函数位于
3.1 函数原型
BOOL WriteFile(
HANDLE hFile,
LPCVOID lpBuffer,
DWORD nNumberOfBytesToWrite,
LPDWORD lpNumberOfBytesWritten,
LPOVERLAPPED lpOverlapped
);
3.2 函数参数
WriteFile 函数的参数说明如下：
hFile：指定要写入的文件的句柄。
lpBuffer：指向包含要写入的数据的缓冲区的指针。
nNumberOfBytesToWrite：指定要写入的字节数。
lpNumberOfBytesWritten：指向一个变量的指针，用于返回实际写入的字节数。
lpOverlapped：指定用于异步 I/O 的数据结构的指针。如果不使用异步 I/O，则设为 NULL。
在使用完文件后，应调用 CloseHandle 函数来关闭文件句柄，以释放系统资源。
3.3 示例代码
下面是一个简单的例子，展示了如何使用 WriteFile 函数向文件中写入数据：
#include
#include
int main() {
// 打开文件
HANDLE hFile = CreateFile(L"test.txt",
GENERIC_WRITE,
0, // 不共享
NULL, // 默认安全描述符
CREATE_ALWAYS, // 如果文件存在，则覆盖
FILE_ATTRIBUTE_NORMAL, // 文件属性
NULL); // 没有模板文件
if (hFile == INVALID_HANDLE_VALUE) {
std::cerr << "Error opening file: " << GetLastError() << std::endl;
return 1;
}
// 定义缓冲区和写入的字节数
char buffer[] = "Hello, world!";
DWORD bytesWritten;
// 向文件中写入数据
if (!WriteFile(hFile, buffer, sizeof(buffer), &bytesWritten, NULL)) {
std::cerr << "Error writing to file: " << GetLastError() << std::endl;
return 1;
}
std::cout << "Wrote " << bytesWritten << " bytes to file." << std::endl;
// 关闭文件句柄
CloseHandle(hFile);
return 0;
}
在这个例子中，我们打开了一个名为 test.txt 的文件，并以写入模式打开了它。然后，我们调用 WriteFile 函数向文件中写入数据，并将数据存储在缓冲区中。
注意，WriteFile 函数的第四个参数是一个输出参数，用于返回实际写入的字节数。如果调用失败，则函数返回 FALSE 并可以使用 GetLastError 函数获取错误代码。
四、三个api一起用示例代码
#include
#include
int main() {
// 打开输入文件
HANDLE hInFile = CreateFile(L"in.txt",
GENERIC_READ,
0, // 不共享
NULL, // 默认安全描述符
OPEN_EXISTING, // 只能打开已存在的文件
FILE_ATTRIBUTE_NORMAL, // 文件属性
NULL); // 没有模板文件
if (hInFile == INVALID_HANDLE_VALUE) {
std::cerr << "Error opening input file: " << GetLastError() << std::endl;
return 1;
}
// 打开
HANDLE hOutFile = CreateFile(L"out.txt",
GENERIC_WRITE,
0, // 不共享
NULL, // 默认安全描述符
CREATE_ALWAYS, // 如果文件存在，则覆盖
FILE_ATTRIBUTE_NORMAL, // 文件属性
NULL); // 没有模板文件
if (hOutFile == INVALID_HANDLE_VALUE) {
std::cerr << "Error opening output file: " << GetLastError() << std::endl;
return 1;
}
// 定义缓冲区和读取/写入的字节数
char buffer[1024];
DWORD bytesRead, bytesWritten;
// 读取输入文件并写入输出文件
while (ReadFile(hInFile, buffer, sizeof(buffer), &bytesRead, NULL) && bytesRead > 0) {
if (!WriteFile(hOutFile, buffer, bytesRead, &bytesWritten, NULL)) {
std::cerr << "Error writing to output file: " << GetLastError() << std::endl;
return 1;
}
}
// 关闭文件句柄
CloseHandle(hInFile);
CloseHandle(hOutFile);
return 0;
}
提示
另外，windows api读取出来的字符是宽字节，某些情况下与C++标准输出可能不一致，这方面在字符加密、流化等操作上会出现问题，所以如果有兼容要求建议使用C++标准输入、输出。
如果要写入文本文件，可以使用 C++ 标准库中的 fstream 头文件中的流类型，例如 ofstream 和 wofstream。这些类型提供了较为方便的写入接口，可以直接使用运算符 << 写入数据。下面是一个示例代码，展示了如何使用 ofstream 类写入文本文件：
#include
#include
int main() {
// 打开文件
std::ofstream out("test.txt");
if (!out) {
std::cerr << "Error opening file." << std::endl;
return 1;
}
// 写入数据
out << "Hello, world!" << std::endl;
// 关闭文件
out.close();
return 0;
}
在这个例子中，我们打开了一个名为 test.txt 的文件，并使用运算符 << 向文件中写入了一行字符串。在使用完文件后，我们调用了 close 方法来关闭文件。
注意，如果要写入 Unicode 字符串，可以使用 wofstream 类。
最后，需要注意，在 Windows 系统中，文件名是区分大小写的。因此，在打开文件时，需要确保文件名正确。
以上就是C++文件相关函数CreateFile|ReadFile|WriteFile用法详解的详细内容，更多关于C++文件函数的资料请关注脚本之家其它相关文章！
您可能感兴趣的文章:
- .NET Core系列之MemoryCache 初识
- 007手机一键Root(安机网一键Root) v3.0 官方最新版 一键ROOT您的Android手机
- 12306密码被盗了怎么办？12306密码外泄解决方法
- 12个字的qq网名
- 150M迷你型无线路由器怎么设置？
- 192.168.1.1打不开怎么办？路由器192.168.1.1打不开的原因以及解决办法
- 2011年电子报合订本 电子报 编辑部 中文 PDF版 [84M]
- 2015年1月15日小米新旗舰发布会现场图文直播
- 2016.3.1vivo Xplay5新品发布会现场视频直播 优酷直播
- 2016华为P9发布会视频直播地址 4月15日华为P9国行发布会直播