在VC中,大多数情况对文件的操作都使用系统提供的 API 函数,以下提供一些文件操作 API 函数介绍:
1、一般文件操作 API
CreateFile
打开文件
函数CreateFile可打开和创建文件、管道、邮槽、通信服务、设备以及控制台,但是在此时只是介绍用这个函数怎么实现创建和打开一个文件。
HANDLE CreateFile(
LPCTSTR lpFileName, // 要打开的文件名
DWORD dwDesiredAccess, // 文件的操作属性
DWORD dwShareMode, // 文件共享属性
LPSECURITY_ATTRIBUTES lpSecurityAttributes,// 文件安全特性
DWORD dwCreationDisposition, //文件操作
DWORD dwFlagsAndAttributes, // 文件属性
HANDLE hTemplateFile // 如果不为零,则指定一个文件句柄。新文件将从这个文件中复制扩展属性
);
文件的操作属性:如果为零,表示只允许获取与一个设备有关的信息,GENERIC_READ 表示允许对设备进行读访问;如果为 GENERIC_WRITE 表示允许对设备进行写访问(可组合使用);
文件的共享属性:零表示不共享; FILE_SHARE_READ 或 FILE_SHARE_WRITE 表示允许对文件进行读/写共享访问;
文件的操作有:
·CREATE_NEW:创建文件;如文件存在则会出错
·CREATE_ALWAYS:创建文件,会改写前一个文件
·OPEN_EXISTING:文件必须已经存在。 由设备提出要求
·OPEN_ALWAYS:如文件不存在则创建它
·TRUNCATE_EXISTING:将现有文件缩短为零长度
文件属性有:
·FILE_ATTRIBUTE_ARCHIVE:标记归档属性
·FILE_ATTRIBUTE_COMPRESSED:将文件标记为已压缩,或者标记为文件在目录中的默认压缩方式
·FILE_ATTRIBUTE_NORMAL:默认属性
·FILE_ATTRIBUTE_HIDDEN:隐藏文件或目录
·FILE_ATTRIBUTE_READONLY:文件为只读
·FILE_ATTRIBUTE_SYSTEM:文件为系统文件
·FILE_FLAG_WRITE_THROUGH:操作系统不得推迟对文件的写操作
·FILE_FLAG_OVERLAPPED:允许对文件进行重叠操作
·FILE_FLAG_NO_BUFFERING:禁止对文件进行缓冲处理。文件只能写入磁盘卷的扇区块
·FILE_FLAG_RANDOM_ACCESS:针对随机访问对文件缓冲进行优化
·FILE_FLAG_SEQUENTIAL_SCAN:针对连续访问对文件缓冲进行优化
·FILE_FLAG_DELETE_ON_CLOSE:关闭了上一次打开的句柄后,将文件删除。特别适合临时文件
可以组合的属性有:FILE_FLAG_WRITE_THROUGH,FILE_FLAG_OVERLAPPED,FILE_FLAG_NO_BUFFERING,FILE_FLAG_RANDOM_ACCESS,FILE_FLAG_SEQUENTIAL_SCAN,FILE_FLAG_DELETE_ON_CLOSE,FILE_FLAG_BACKUP_SEMANTICS,FILE_FLAG_POSIX_SEMANTICS,FILE_FLAG_OPEN_REPARSE_POINT,FILE_FLAG_OPEN_NO_RECALL
如果成功返回一个打开文件得句柄,如果调用函数之前文件存在,文件操作属性为:CREATE_ALWAYS 或OPEN_ALWAYS,使用GetLastError函数返回的是ERROR_ALREADY_EXISTS(包括函数操作成功),如果之前函数不存在,则返回0。使用失败返回INVALID_HANDLE_VALUE,要取得更多的信息,使用GetLastError函数。
ReadFile
从文件中读取字节信息。 在打开文件获得了文件句柄之后,则可以通过该函数读取数据。
BOOL ReadFile(
HANDLE hFile, //文件的句柄
LPVOID lpBuffer, //用于保存读入数据的一个缓冲区
DWORD nNumberOfBytesToRead, //要读入的字符数
LPDWORD lpNumberOfBytesRead, //从文件中实际读入的字符数
LPOVERLAPPED lpOverlapped //如文件打开时指定了FILE_FLAG_OVERLAPPED,那么必须,用这个参数引用一个特殊的结构。该结构定义了一次异步读取操作。否则,应将这个参数设为NULL
);
WriteFile
向文件写入字节信息。 同样可以将文件句柄传给该函数,从而实现对文件数据的写入。
BOOL WriteFile(
HANDLE hFile, //文件的句柄
LPCVOID lpBuffer, //要写入的一个数据缓冲区
DWORD nNumberOfBytesToWrite, //要写入数据的字节数量。如写入零字节,表示什么都不写入,但会更新文件的"上一次修改时间"。
LPDWORD lpNumberOfBytesWritten, //实际写入文件的字节数量
LPOVERLAPPED lpOverlapped // OVERLAPPED,倘若在指FILE_FLAG_OVERLAPPED的前提下打开文件,这个参数就必须引用一个特殊的结构。该结构定义了一次异步写操作。否则,该参数应置为NULL
);
CloseHandle
关闭文件句柄。
打开门之后,自然要记得关上。
GetFileTime
获取文件时间。
有三个文件时间可供获取:创建时间、最后访问时间、最后写时间。
该函数同样需要文件句柄作为入口参数。
GetFileSize
获取文件大小。
由于文件大小可以高达上数G(1G需要30位),因此一个32位的双字节类型无法对其精确表达,因此返回码表示低32位,还有一个出口参数可以传出高32位。
该函数同样需要文件句柄作为入口参数。
GetStatus
得到文件状态。
static BOOL PASCAL GetStatus( LPCTSTR lpszFileName, CFileStatus& rStatus );
static void SetStatus( LPCTSTR lpszFileName, const CFileStatus& status );
throw( CFileException );
返回的是一个CfileStatus对象,这个结构的具体的成员变量包括:
struct CFileStatus
{
CTime m_ctime; // 文件创建时间
CTime m_mtime; // 文件最近一次修改时间
CTime m_atime; // 文件最近一次访问时间
LONG m_size; // 文件大小
BYTE m_attribute; // 文件属性
BYTE _m_padding; // 没有实际含义,用来增加一个字节
TCHAR m_szFullName[_MAX_PATH]; //绝对路径
#ifdef _DEBUG
//实现Dump虚拟函数,输出文件属性
void Dump(CDumpContext& dc) const;
#endif
};
下面就举一个例子来实现:
CFileStatus status;
char *path = "D://VSS";
if(CFile::GetStatus( path, status ))
{
CString cTime,mTime,aTime;
cTime = status.m_ctime.Format("文件建立时间:%Y年%m月%d日 %H时%M分%S秒");
mTime = status.m_mtime.Format("文件最近修改时间:%Y年%m月%d日 %H时%M分%S秒");
aTime = status.m_atime.Format("文件最近访问时间:%Y年%m月%d日 %H时%M分%S秒");
CString str;
str = cTime + "/n" + mTime +"/n" + aTime ;
MessageBox(str);
}
GetFileAttributes
获取文件属性。
可以获取文件的存档、只读、系统、隐藏等属性。
该函数只需一个文件路径作为参数。
SetFileAttributes
设置文件属性。
能获取,自然也应该能设置。
可以设置文件的存档、只读、系统、隐藏等属性。
该函数只需一个文件路径作为参数。
GetFileInformationByHandle
获取所有文件信息
该函数能够获取上面所有函数所能够获取的信息,如大小、属性等,同时还包括一些其他地方无法获取的信息,比如:文件卷标、索引和链接信息。
该函数需要文件句柄作为入口参数。
GetFullPathName
获取文件路径,该函数获取文件的完整路径名。
需要提醒的是:只有当该文件在当前目录下,结果才正确。如果要得到真正的路径。应该用GetModuleFileName函数。
CopyFile
复制文件
注意:只能复制文件,而不能复制目录
MoveFileEx
移动文件
既可以移动文件,也可以移动目录,但不能跨越盘符。(Window2000下设置移动标志可以实现跨越盘符操作)
DeleteFile
删除文件
GetTempPath
获取Windows临时目录路径
GetTempFileName
在Windows临时目录路径下创建一个唯一的临时文件
SetFilePoint
移动文件指针。
该函数用于对文件进行高级读写操作时。定位文件中的数据是很重要的,这决定了写入的数据在文件中的位置。API函数
DWORD SetFilePointer(
HANDLE hFile, //文件的句柄
LONG lDistanceToMove, //字节偏移量r
PLONG lpDistanceToMoveHigh, //指定一个长整数变量,其中包含了要使用的一个高双字偏移(一般用来操作大型文件)。可设为零,表示只使用lDistanceToMove
DWORD dwMoveMethod //文件定位
);
dwMoveMethod文件定位的方式有三种:
·FILE_BEGIN:从文件开始处。
·FILE_CURRENT:从当前位置。
·FILE_END:从文件的末尾。
此函数可以用来定位大型文件,lpDistanceToMoveHigh是高32位,lDistanceToMove是低32位。如果lpDistanceToMoveHigh为NULL时,函数操作成功,返回的是当前文件数据的偏移量,如果lpDistanceToMoveHigh不NULL,则返回数据的偏移量高32位放在 lpDistanceToMoveHigh中,函数调用失败返回的是0xffffffff.
2、文件的锁定和解锁
LockFile
UnlockFile
LockFileEx
UnlockFileEx
以上四个函数用于对文件进行锁定和解锁。这样可以实现文件的异步操作。可同时对文件的不同部分进行各自的操作。
3、文件的压缩和解压缩
LZOpenFile
打开压缩文件以读取
LZSeek
查找压缩文件中的一个位置
LZRead
读一个压缩文件
LZClose
关闭一个压缩文件
LZCopy
复制压缩文件并在处理过程中展开
GetExpandedName
从压缩文件中返回文件名称。
以上六个函数为32位 API 中的一个小扩展库,文件压缩扩展库中的函数。文件压缩可以用命令 compress 创建。
4、文件内核对象
32位 API 提供一个称为文件映像的特性,它允许将文件直接映射为一个应用的虚拟内存空间,这一技术可用于简化和加速文件访问。
CreateFileMapping
创建和命名映射
MapViewOfFile
把文件映射装载如内存
UnmapViewOfFile
释放视图并把变化写回文件
FlushViewOfFile
将视图的变化刷新写入磁盘