(Windows編程 文件專題)打開,讀取,寫入和關(guān)閉文件
關(guān)鍵詞
C++ CreateFile CloseHandle ReadFile WriteFile API 文件句柄
◆CreateFile
HANDLE CreateFile(
LPCTSTR lpName,
DWORD dwAccess,
DWORD dwShareMode,
LPSECURITY_ATTRIBUTES lpSecurityAttributes,
DWORD dwCreate,
DWORD dwAttrsAndFlags,
HANDLE hTemplateFile)
返回值:所創(chuàng)建文件對象的句柄,如果文件創(chuàng)建失敗則返回
INVALID_HANDLE_VALUE
lpName 是以null結(jié)尾的對文件,管道或其他打開和創(chuàng)建的命名對象進(jìn)行命名的字符串的指針.
dwAccess 使用 GENERIC_READ 和 GENERIC_WRITE 來指定讀寫訪問(見WINNT.H中宏定義),允許使用位操作符(或)合并
dwShareMode是以下二進(jìn)制方式的(或)操作
● 0——文件不能共享,甚至該進(jìn)程不能打開該文件的第二個句柄
● FILE_SHARE_READ——其他進(jìn)程包括調(diào)用進(jìn)程可以打開該文件進(jìn)行并發(fā)讀訪問
● FILE_SHARE_WRITE——它允許對文件進(jìn)行并發(fā)寫操作
lpSecurityAttributes 指向了 SECRITY_ATTRIBUTES 結(jié)構(gòu)。
dwCreate指定了是否創(chuàng)建一個新的文件,是否重寫現(xiàn)有的文件等等,允許(或)操作
● CREATE_NEW——如果指定的文件已經(jīng)存在,操作失敗,否則創(chuàng)建新的文件
● CREATE_ALWAYS ——現(xiàn)有的文件將被改寫
● OPEN_EXISTING——如果文件不存在,操作失敗
● OPEN_ALWAYS——打開文件,如果文件不存在則創(chuàng)建
● TRUNCATE_EXISTING——文件長度設(shè)為零,需要dwCreate指定GENERIC_WRITE,
如果文件已存在,所有內(nèi)容將會破壞
dwAttrsAndFlags 指定了文件屬性和標(biāo)記。有16個標(biāo)記和屬性
● FILE_ATTRIBUTE_NORMAL 該屬性只有在其他屬性沒有設(shè)置時(shí)才有用
● FILE_ATTRIBUTE_READONLY 程序不能改寫也不能刪除文件
● FILE_FLAG_DELETE_ON_CLOSE 對于臨時(shí)文件很有用。
當(dāng)最后一個HANDLE關(guān)閉時(shí),文件就被刪除
● FILE_FLAG_OVERLAPPED 該屬性標(biāo)記對于異步I/O很重要
● FILE_FLAG_WRITE_THROUGH 直接對磁盤文件進(jìn)行中間緩存寫操作
● FILE_FLAG_NO_BUFFERING 沒有中間緩存,數(shù)據(jù)傳輸直接在程序中由 ReadFile和
WriteFile 調(diào)用指定的數(shù)據(jù)緩存上實(shí)現(xiàn)。相應(yīng)地,在扇區(qū)地邊界處也需要緩存,而且完
整地扇區(qū)必須被傳輸。在使用該標(biāo)記時(shí),通過調(diào)用函數(shù) GetDiskFreeSpace 來決定扇
區(qū)的大小
● FILE_FLAG_RANDOM_ACCESS 主要用于隨機(jī)訪問,而 Windows 也會盡量優(yōu)化文件
緩存
● FILE_FLAG_SEQUENTIAL_SCAN 主要用于順序訪問,而 Windows也會對文件緩存作
相應(yīng)優(yōu)化
hTemplateFile 是打開的 GENERIC_READ 文件的句柄,該文件指定了用于新創(chuàng)建的文件的擴(kuò)展屬性,并忽略了 dwAttrsAndFlags。通常參數(shù)是NULL,當(dāng)現(xiàn)有的文件已打開時(shí),hTemplateFile 被忽略。該參數(shù)可用來將新文件的屬性設(shè)置成跟現(xiàn)有文件的屬性相同
如果文件共享屬性和安全性允許,文件會有許多打開的句柄。打開的句柄可以由相同或不同的進(jìn)程所擁有
◆關(guān)閉文件
BOOL CloseHandle(HANDLE hObject)
返回值:如果本函數(shù)成功執(zhí)行,返回TRUE,否則返回FALSE。
一個萬能的函數(shù)關(guān)閉,句柄會銷毀,所有對象的系統(tǒng)資源也會釋放。當(dāng)然也會有異常情況。關(guān)閉句柄也減少了對象的句柄引用計(jì)數(shù),這樣非永久的對象比如臨時(shí)文件和事件將被刪除。系統(tǒng)在退出時(shí)會關(guān)閉所有打開句柄,但是在程序終止前關(guān)閉其句柄是個很好的習(xí)慣。
關(guān)閉一個無效的句柄或?qū)ν粋€句柄關(guān)閉兩次將會引起異常,而關(guān)閉標(biāo)準(zhǔn)設(shè)備句柄是不必要的或不適宜的
◆讀取文件
BOOL ReadFile(
HANDLE hFile,
LPVOID lpBuffer,
DWORD nNumberOfBytesToRead,
LPDWORD lpNumberOfBytesRead,
LPOVERLAPPED lpOverlapped)
返回值:如果文件讀取操作成功執(zhí)行,則返回TRUE(即使試圖讀取文件末尾后的內(nèi)容,未能讀取到任何字節(jié),仍舊返回TRUE)。
hFile 是具有GENERIC_READ 訪問權(quán)限的文件句柄。
lpBuffer指向接受輸入數(shù)據(jù)的內(nèi)存緩存
nNumberOfBytesToRead 是從文件中讀取的字節(jié)數(shù),如果句柄位于文件的末尾處或有錯誤時(shí),其值可以是零。消息模式的命名管道允許0長度的消息。
lpOverlapped 指向了OVERLAPPED結(jié)構(gòu),現(xiàn)在使用NULL
如果dwAttrsAndFlags中沒有設(shè)置選項(xiàng) FILE_FLAG_OVERLAPPED。那么ReadFile從句柄的當(dāng)前文件位置開始,隨著傳輸字節(jié)數(shù)往前移動位置。
如果句柄或任何其它參數(shù)無效,函數(shù)失敗并返回FALSE,如果文件句柄位于文件末尾處,函數(shù)不會失敗,取而代之,讀取字節(jié)數(shù) (*lpNumberOfBytesRead)被設(shè)為0。
◆寫文件
BOOL WriteFile(
HANDLE hFile,
LPCVOID lpBuffer,
DWORD nNumberOfBytesToWrite,
LPDWORD lpNumberOfBytesWritten,
LPOVERLAPPED lpOverlapped)
返回值:如果本函數(shù)成功執(zhí)行,則返回TRUE,否則返回FALSE
注意一個成功的寫操作不能確保數(shù)據(jù)真正被寫入硬盤中,除非在CreateFile中指定FILE_FLAG_WRITE_THROUGH。如果句柄位于文件的末尾,Windows會擴(kuò)展現(xiàn)有的文件的長度。
ReadFileGather 和WriteFileGather 允許使用不同大小的緩存來進(jìn)行讀寫操作。
附:
示例文件(CPW.cpp)
/* 使用Windows API 實(shí)現(xiàn)文件復(fù)制???? */
/* cpw.cpp?????? */
#include <windows.h>
#include <stdio.h>
#define BUF_SIZE 256
int main(int argc,LPTSTR argv[]){
HANDLE hIn,hOut;
DWORD nIn,nOut;
CHAR Buffer[BUF_SIZE];
if(argc != 3){
???? printf("Usage:cpw file1 file2\n");
???? return 1;
}
hIn = CreateFile(argv[1],GENERIC_READ,0,NULL,OPEN_EXISTING,0,NULL);
if (hIn == INVALID_HANDLE_VALUE){
???? printf("Can't open input file.Error:%x\n",GetLastError());
???? return 2;
}
hOut = CreateFile(argv[2],GENERIC_WRITE,0,NULL,CREATE_ALWAYS,FILE_ATTRIBUTE_NORMAL,NULL);
if (hOut == INVALID_HANDLE_VALUE){
???? printf("Can't open output file.Error:%x\n",GetLastError());
???? return 3;
}
while(ReadFile(hIn,Buffer,BUF_SIZE,&nIn,NULL) && nIn>0){
???? WriteFile(hOut,Buffer,nIn,&nOut,NULL);
???? if(nIn != nOut){
????? printf("Fatal write error:%x\n",GetLastError());
????? return 4;
???? }
}
CloseHandle(hIn);
CloseHandle(hOut);
return 0;
}