C++文件相關函數(shù)CreateFile|ReadFile|WriteFile用法詳解
一、CreateFile
1.1 函數(shù)原型
CreateFile 函數(shù)是 Windows API 中用于創(chuàng)建文件、目錄、管道、控制臺輸入/輸出緩沖區(qū)或遠程 IO 設備的函數(shù)。它位于 <windows.h> 頭文件中，函數(shù)原型如下：
HANDLE CreateFile( LPCTSTR lpFileName, DWORD dwDesiredAccess, DWORD dwShareMode, LPSECURITY_ATTRIBUTES lpSecurityAttributes, DWORD dwCreationDisposition, DWORD dwFlagsAndAttributes, HANDLE hTemplateFile );
1.2 函數(shù)參數(shù)介紹
CreateFile 函數(shù)的參數(shù)說明如下：
lpFileName：指定文件名的字符串指針。
dwDesiredAccess：指定文件的訪問模式。可以是下列值之一：
- GENERIC_READ：可以讀取文件。
- GENERIC_WRITE：可以寫入文件。
- GENERIC_EXECUTE：可以執(zhí)行文件。
dwShareMode：指定文件的共享模式?？梢允窍铝兄抵唬?/p>
- FILE_SHARE_READ：允許其他進程讀取文件。
- FILE_SHARE_WRITE：允許其他進程寫入文件。
- FILE_SHARE_DELETE：允許其他進程刪除文件。
lpSecurityAttributes：指定文件的安全屬性。如果設為 NULL，則使用默認安全描述符。
dwCreationDisposition：指定如何創(chuàng)建文件?？梢允窍铝兄抵唬?/p>
- CREATE_NEW：如果文件不存在，則創(chuàng)建新文件；否則，返回 ERROR_FILE_EXISTS 錯誤。
- TRUNCATE_EXISTING：如果文件存在，則截斷文件；否則，返回 ERROR_FILE_NOT_FOUND 錯誤。
dwFlagsAndAttributes：指定文件的屬性?？梢允窍铝兄抵唬?/p>
- FILE_ATTRIBUTE_NORMAL：普通文件。
- FILE_ATTRIBUTE_READONLY：只讀文件。
- FILE_ATTRIBUTE_HIDDEN：隱藏文件。
- FILE_ATTRIBUTE_SYSTEM：系統(tǒng)文件。
hTemplateFile：指定用于創(chuàng)建文件的模板文件句柄。如果沒有模板文件，則設為 NULL。
如果 CreateFile 函數(shù)調(diào)用成功，則返回一個文件句柄；如果調(diào)用失敗，則返回一個特殊的值 INVALID_HANDLE_VALUE，并可以使用 GetLastError 函數(shù)獲取錯誤代碼。
1.3 示例代碼
#include <windows.h>
#include <iostream>
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 函數(shù)原型
在 C++ 中，可以使用 ReadFile 函數(shù)從文件中讀取數(shù)據(jù)。這個函數(shù)位于 <windows.h> 頭文件中，并且需要提供文件句柄、緩沖區(qū)地址和要讀取的字節(jié)數(shù)。
ReadFile 函數(shù)的函數(shù)原型如下：
BOOL ReadFile( HANDLE hFile, LPVOID lpBuffer, DWORD nNumberOfBytesToRead, LPDWORD lpNumberOfBytesRead, LPOVERLAPPED lpOverlapped );
2.2 函數(shù)參數(shù)介紹
ReadFile 函數(shù)的參數(shù)說明如下：
hFile：指定要讀取的文件的句柄。
lpBuffer：指向存儲讀取數(shù)據(jù)的緩沖區(qū)的指針。
nNumberOfBytesToRead：指定要讀取的字節(jié)數(shù)。
lpNumberOfBytesRead：指向一個變量的指針，用于返回實際讀取的字節(jié)數(shù)。
lpOverlapped：指定用于異步 I/O 的數(shù)據(jù)結構的指針。如果不使用異步 I/O，則設為 NULL。
在使用完文件后，應調(diào)用 CloseHandle 函數(shù)來關閉文件句柄，以釋放系統(tǒng)資源。
2.3 示例代碼
在這個例子中，我們打開了一個名為 test.txt 的文件，并以讀取模式打開了它。然后，我們調(diào)用 ReadFile 函數(shù)讀取文件中的數(shù)據(jù)，并將其存儲在緩沖區(qū)中。注意，ReadFile 函數(shù)的第四個參數(shù)是一個輸出參數(shù)，用于返回實際讀取的字節(jié)數(shù)。如果調(diào)用失敗，則函數(shù)返回 FALSE 并可以使用 GetLastError 函數(shù)獲取錯誤代碼。
#include <windows.h>
#include <iostream>
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;
}
// 定義緩沖區(qū)和讀取的字節(jié)數(shù)
char buffer[1024];
DWORD bytesRead;
// 從文件中讀取數(shù)據(jù)
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 函數(shù)向文件中寫入數(shù)據(jù)。這個函數(shù)位于 <windows.h> 頭文件中，并且需要提供文件句柄、緩沖區(qū)地址和要寫入的字節(jié)數(shù)。
3.1 函數(shù)原型
BOOL WriteFile( HANDLE hFile, LPCVOID lpBuffer, DWORD nNumberOfBytesToWrite, LPDWORD lpNumberOfBytesWritten, LPOVERLAPPED lpOverlapped );
3.2 函數(shù)參數(shù)
WriteFile 函數(shù)的參數(shù)說明如下：
hFile：指定要寫入的文件的句柄。
lpBuffer：指向包含要寫入的數(shù)據(jù)的緩沖區(qū)的指針。
nNumberOfBytesToWrite：指定要寫入的字節(jié)數(shù)。
lpNumberOfBytesWritten：指向一個變量的指針，用于返回實際寫入的字節(jié)數(shù)。
lpOverlapped：指定用于異步 I/O 的數(shù)據(jù)結構的指針。如果不使用異步 I/O，則設為 NULL。
在使用完文件后，應調(diào)用 CloseHandle 函數(shù)來關閉文件句柄，以釋放系統(tǒng)資源。
3.3 示例代碼
下面是一個簡單的例子，展示了如何使用 WriteFile 函數(shù)向文件中寫入數(shù)據(jù)：
#include <windows.h>
#include <iostream>
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;
}
// 定義緩沖區(qū)和寫入的字節(jié)數(shù)
char buffer[] = "Hello, world!";
DWORD bytesWritten;
// 向文件中寫入數(shù)據(jù)
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 的文件，并以寫入模式打開了它。然后，我們調(diào)用 WriteFile 函數(shù)向文件中寫入數(shù)據(jù)，并將數(shù)據(jù)存儲在緩沖區(qū)中。
注意，WriteFile 函數(shù)的第四個參數(shù)是一個輸出參數(shù)，用于返回實際寫入的字節(jié)數(shù)。如果調(diào)用失敗，則函數(shù)返回 FALSE 并可以使用 GetLastError 函數(shù)獲取錯誤代碼。
四、三個api一起用示例代碼
#include <windows.h>
#include <iostream>
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;
}
// 定義緩沖區(qū)和讀取/寫入的字節(jié)數(shù)
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讀取出來的字符是寬字節(jié)，某些情況下與C++標準輸出可能不一致，這方面在字符加密、流化等操作上會出現(xiàn)問題，所以如果有兼容要求建議使用C++標準輸入、輸出。
如果要寫入文本文件，可以使用 C++ 標準庫中的 fstream 頭文件中的流類型，例如 ofstream 和 wofstream。這些類型提供了較為方便的寫入接口，可以直接使用運算符 << 寫入數(shù)據(jù)。下面是一個示例代碼，展示了如何使用 ofstream 類寫入文本文件：
#include <fstream>
#include <iostream>
int main() {
// 打開文件
std::ofstream out("test.txt");
if (!out) {
std::cerr << "Error opening file." << std::endl;
return 1;
}
// 寫入數(shù)據(jù)
out << "Hello, world!" << std::endl;
// 關閉文件
out.close();
return 0;
}在這個例子中，我們打開了一個名為 test.txt 的文件，并使用運算符 << 向文件中寫入了一行字符串。在使用完文件后，我們調(diào)用了 close 方法來關閉文件。
注意，如果要寫入 Unicode 字符串，可以使用 wofstream 類。
最后，需要注意，在 Windows 系統(tǒng)中，文件名是區(qū)分大小寫的。因此，在打開文件時，需要確保文件名正確。
以上就是C++文件相關函數(shù)CreateFile|ReadFile|WriteFile用法詳解的詳細內(nèi)容，更多關于C++文件函數(shù)的資料請關注腳本之家其它相關文章！
相關文章
這篇文章主要介紹了C++ vector擴容解析noexcept應用場景,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-09-09
c語言標準庫中字符轉(zhuǎn)換函數(shù)和數(shù)字轉(zhuǎn)換函數(shù)
這篇文章主要介紹了c標準庫中字符轉(zhuǎn)換函數(shù)和數(shù)字轉(zhuǎn)換函數(shù),需要的朋友可以參考下2014-04-04
今天小編就為大家分享一篇opencv3/C++視頻中疊加透明圖片的實現(xiàn)，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2019-12-12
這篇文章主要為大家詳細介紹了C99中的新語法——柔性數(shù)組的使用以及優(yōu)缺點，文中的示例代碼講解詳細，具有一定的學習價值，感興趣的可以了解一下2023-04-04
C++實現(xiàn)LeetCode(166.分數(shù)轉(zhuǎn)循環(huán)小數(shù))
