Windows API——CFile, read, write,typeBinary函数

简介: Windows API——CFile, read, write,typeBinary函数

文件操作API和CFile类


在VC中,操作文件的方法有两种,一是利用一些API函数来创建,打开,读写文件,另外一个是利用MFC的CFile类,CFile封装了对文件的一般操作。下面酒主要介绍如何利用这两种方法操作文件。


1.创建或打开一个文件


API函数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函数。


文件的关闭用:

BOOL CloseHandle(
HANDLE hObject // handle to object to close
);


例子1在当前目录下面创建一个文件:


HANDLE handle;
DWORD Num;
handle= ::CreateFile("new.tmp",GENERIC_READ|GENERIC_WRITE,0,NULL,OPEN_ALWAYS,FILE_FLAG_DELETE_ON_CLOSE,NULL);
if(INVALID_HANDLE_VALUE!= handle )
{
  ::SetFilePointer(handle,0,0,FILE_BEGIN);
  char Buffer[] = "这是个刚创建的文件";
  ::WriteFile(handle,Buffer,sizeof(Buffer),&Num,NULL);
  ZeroMemory(Buffer,sizeof(Buffer));
  ::SetFilePointer(handle,0,0,FILE_BEGIN);
  ::ReadFile(handle,Buffer,sizeof(Buffer),&Num,NULL);
  MessageBox(Buffer);
  ::CloseHandle(handle); 
}


可以改变上面的创建文件的属性和操作看下不同效果。


CFile创建和打开一个文件:


创建文件和打开文件的方法有很多种,下面简单介绍下几个构造函数:

CFile( LPCTSTR lpszFileName, UINT nOpenFlags );throw( CFileException );
CFile( );
BOOL Open( LPCTSTR lpszFileName, UINT nOpenFlags, CFileException* pError = NULL );


lpszFileName:文件名称,可以是相对路径,绝对路径或网络路径


nOpenFlags:打开方式有:


CFile::modeCreate 调用构造函数构造一个新文件,如果文件已存在,则长度变成0。


CFile::modeNoTruncate 此值与modeCreate组合使用。如果所创建的文件已存在则其长度不变为0。因而此文件被打开,或者作为一个新文件或者作为一个已存在的文件。这将是很有用的,例如当打开一个可能存在也可能不存在的文件时。


  • 打开文件属性:


CFile::modeRead 打开文件仅供读。


CFile::modeReadWrite 打开文件供读写。


CFile::modeWrite 打开文件仅供写。


CFile::modeNoInherit 阻止文件被子进程继承。


CFile::ShareDenyNone 不禁止其它进程读或写访问,打开文件。如果文件已被其它进程以兼容模式打开,则Create失败。


CFile::ShareDenyRead 打开文件,禁止其它进程读此文件。如果文件已被其它进程以兼容模式打开,或被其它进程读,则Create失败


CFile::ShareDenyWrite 打开文件,禁止其它进程写此文件。如果文件已被其它进程以兼容模式打开,或被其它进程写,则Create失败。


CFile::ShareExclusive 以独占模式打开文件,禁止其它进程对文件的读写。如果文件已经以其它模式打开读写(即使被当前进程),则构造失败。


CFile::ShareCompat 此标志在32位MFC中无效。此标志在使用CFile:: Open时映射为CFile::ShareExclusive。


CFile::typeText 对回车换行设置特殊进程(仅用于派生类)。


CFile::typeBinary 设置二进制模式(仅用于派生类)。


下面给出MSDN中的一个例子:


char* pFileName = "test.dat";
TRY
{
CFile f( pFileName, CFile::modeCreate | CFile::modeWrite );
}
CATCH( CFileException, e )
{
#ifdef _DEBUG
afxDump << "File could not be opened " << e->m_cause << "\n";
#endif
}
END_CATCH
CFile fileTest;
char* pFileName = "test.dat";
TRY
{
fileTest.Open(pFileName, CFile::modeCreate |CFile::modeWrite);
}
CATCH_ALL(e)
{
fileTest.Abort( );
THROW_LAST ( );
}
END_CATCH_ALL


2.文件的读写定位:


定位文件中的数据是很重要的,这决定了写入的数据在文件中的位置。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.


BOOL SetEndOfFile(


HANDLE hFile //文件的句柄


);


CFile类的文件数据定位函数有:


LONG Seek(LONG lOff,UINT nFrom);throw(CFileException);


如果要求的位置合法,则Seek返回从文件开始起的新字节偏移量


lOff:指针移动的字节数。


nFrom:指针移动的模式。可以是CFile::begin,CFile::current,CFile::end

void SeekToBegin( );


DWORD SeekToEnd( );//返回文件长度(字节数)。


下面是一个读取位图文件的信息的例子:


CFile file;
BITMAPINFOHEADER bmpinfo;
try
{
file.Open("D:\\ToolBar.bmp",CFile::modeRead);
file.Seek(sizeof(BITMAPFILEHEADER),CFile::begin);
file.Read(&bmpinfo,sizeof(BITMAPINFOHEADER ));
CString str;
str.Format("位图文件的长是%d,高%d",bmpinfo.biWidth,bmpinfo.biHeight);
MessageBox(str);
file.Close();
}
catch(CFileException *e)
{
CString str;
str.Format("读取数据失败的原因是:%d",e->m_cause);
MessageBox("str");
file.Abort();
e->Delete();
}


读取数据:


BOOL ReadFile(


HANDLE hFile, //文件的句柄


LPVOID lpBuffer, //用于保存读入数据的一个缓冲区


DWORD nNumberOfBytesToRead, //要读入的字符数


LPDWORD lpNumberOfBytesRead, //从文件中实际读入的字符数


LPOVERLAPPED lpOverlapped //如文件打开时指定了FILE_FLAG_OVERLAPPED,那么必须,用这个参数引用一个特殊的结构。该结构定义了一次异步读取操作。否则,应将这个参数设为NULL


);


CFile的成员函数有:


UINT Read (void* lpBuf,UINT nCount); throw(CFileException);// 返回值是传输到缓冲区的字节数。


写入数据:


BOOL WriteFile(


HANDLE hFile, //文件的句柄


LPCVOID lpBuffer, //要写入的一个数据缓冲区


DWORD nNumberOfBytesToWrite, //要写入数据的字节数量。如写入零字节,表示什么都不写入,但会更新文件的“上一次修改时间”。


LPDWORD lpNumberOfBytesWritten, //实际写入文件的字节数量


LPOVERLAPPED lpOverlapped // OVERLAPPED,倘若在指FILE_FLAG_OVERLAPPED的前提下打开文件,这个参数就必须引用一个特殊的结构。该结构定义了一次异步写操作。否则,该参数应置为NULL


);


void Write(const void* lpBuf,UINT nCount);throw (CFileException);


lpBuf:指向用户提供的缓冲区,包含将写入文件中的数据


nCount:从缓冲区内传输的字节数。对文本模式的文件,回车换行作为一个字符。


下面是象一个文件中写入数据的例子:


CFile file;
try
{
  file.Open("d:/my.dat",CFile::modeCreate|CFile::modeWrite);
  file.SeekToBegin();
  char Data[] = "111111111\n1111111111";
  file.Write(Data,sizeof(Data));
  file.Flush();
  file.Close();
}
catch(CFileException *e)
{
  CString str;
  str.Format("读取数据失败的原因是:%d",e->m_cause);
  MessageBox("str");
  file.Abort();
  e->Delete();
}


3.取得和设置文件的创建时间、最后访问时间、最后写时间


BOOL GetFileTime(
HANDLE hFile, // 文件句柄
LPFILETIME lpCreationTime, // 创建时间
LPFILETIME lpLastAccessTime, // 最后访问时间
LPFILETIME lpLastWriteTime // 最后写时间
);
BOOL SetFileTime(
HANDLE hFile, 
CONST FILETIME *lpCreationTime, 
CONST FILETIME *lpLastAccessTime, 
CONST FILETIME *lpLastWriteTime 
);
typedef struct _FILETIME { 
DWORD dwLowDateTime; 
DWORD dwHighDateTime; 
} FILETIME;


取得三个参数都是FILETIME结构,得到的都是UTC时间,可以通过API函数FileTimeToLocalFileTime()和FileTimeToSystemTime()将他们转换为本地时间和系统时间格式,也可以通过LocalFileTimeToFileTime和SystemTimeToFileTime()转换回来,通过SetFileTime设置文件的创建时间、最后访问时间、最后写时间。由于使用的时候要先打开文件,而且取得的最后访问时间就是当前时间,没有多大意义,且比较麻烦,下面介绍CFile类中的静态方法。


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);
}


4.取得和设置文件的属性


DWORD GetFileAttributes(
LPCTSTR lpFileName //文件或文件夹路经
);
BOOL SetFileAttributes(
LPCTSTR lpFileName, // 文件名
DWORD dwFileAttributes // 要设置的属性
);


取得的文件属性包括:FILE_ATTRIBUTE_ARCHIVE,FILE_ATTRIBUTE_HIDDEN,FILE_ATTRIBUTE_NORMAL,FILE_ATTRIBUTE_OFFLINE,FILE_ATTRIBUTE_READONLY,FILE_ATTRIBUTE_SYSTEM,FILE_ATTRIBUTE_TEMPORARY


不能设置的文件属性包括有:FILE_ATTRIBUTE_COMPRESSED,FILE_ATTRIBUTE_DIRECTORY,FILE_ATTRIBUTE_ENCRYPTED,FILE_ATTRIBUTE_REPARSE_POINT,FILE_ATTRIBUTE_SPARSE_FILE,FILE_ATTRIBUTE_SYSTEM。


CFileStatus中也定义了一组属性:


enum Attribute {


normal,


readOnly,


hidden,


system,


volume,


directory,


archive


};


可以通过if((status. m_attribute& readOnly) = =FILE_ATTRIBUTE_READONLY)来判断,这里利用另外的API来实现获得文件的详细信息:


HANDLE FindFirstFile(


LPCTSTR lpFileName, //文件或文件夹路经r


LPWIN32_FIND_DATA lpFindFileData


);


BOOL FindNextFile(


HANDLE hFindFile,


LPWIN32_FIND_DATA lpFindFileData


);


BOOL FindClose(


HANDLE hFindFile );


取得的是一个WIN32_FIND_DATA结构;


typedef struct _WIN32_FIND_DATA {


DWORD dwFileAttributes; //文件属性


FILETIME ftCreationTime; // 文件创建时间


FILETIME ftLastAccessTime; // 文件最后一次访问时间


FILETIME ftLastWriteTime; // 文件最后一次修改时间


DWORD nFileSizeHigh; // 文件长度高32位


DWORD nFileSizeLow; // 文件长度低32位


DWORD dwReserved0; // 系统保留


DWORD dwReserved1; // 系统保留


TCHAR cFileName[ MAX_PATH ]; // 长文件名


TCHAR cAlternateFileName[ 14 ]; // 8.3格式文件名


} WIN32_FIND_DATA, *PWIN32_FIND_DATA;


也可以利用另外一个函数来取得文件的信息:


BOOL GetFileInformationByHandle(


HANDLE hFile, // 文件的句柄


LPBY_HANDLE_FILE_INFORMATION lpFileInformation


);


函数填充的是BY_HANDLE_FILE_INFORMATION结构体:


typedef struct _BY_HANDLE_FILE_INFORMATION {


DWORD dwFileAttributes;


FILETIME ftCreationTime;


FILETIME ftLastAccessTime;


FILETIME ftLastWriteTime;


DWORD dwVolumeSerialNumber; // 文件所在的磁盘的序列号


DWORD nFileSizeHigh;


DWORD nFileSizeLow;


DWORD nNumberOfLinks; //链接的数目


DWORD nFileIndexHigh;


DWORD nFileIndexLow;


} BY_HANDLE_FILE_INFORMATION;


下面就举一个例子来实现:


HANDLE handle;


WIN32_FIND_DATA find_data;


handle = :: FindFirstFile(“D:\VSS”,&find_data);


FindClose(handle);


find_data.dwFileAttributes =

find_data.dwFileAttributes|FILE_ATTRIBUTE_READONLY;

::SetFileAttributes(“D:\VSS”,find_data.dwFileAttributes);


在上面的介绍中,除了可以设置文件的属性之外,在操作的过程当中也可以取得文件的其他一些信息,可以根据具体的需要来实现。


5.获取文件名,文件类型,文件长度,文件路径


用利用CFile打开一个文件时,可以在利用成员函数


virtual CString GetFileName( ) const, 
virtual CString GetFileTitle( ) const, 
virtual CString GetFilePath( ) const, 
virtual DWORD GetLength( ) const;throw( CFileException );


来取得相关信息,如果一个文件的全路经是: c:\windows\write\myfile.wri,则每个函数取得的是: myfile.wri, myfile, c:\windows\write\myfile.wri. GetLength取得文件大小是按字节为单位的.


也可以利用:


virtual void SetLength( DWORD dwNewLen );throw( CFileException );

virtual void SetFilePath( LPCTSTR lpszNewName );


来设置文件的长度和路径。


在当前的文件下面新建一个Text.txt文件,在里面写点东西,然后运行下面程序:


CFile file("Text.txt",CFile::modeReadWrite);
ULONGLONG length;
CString strFilePath;
length = file.GetLength();
length = length + 1024*10;
file.SetLength(length);
file.SetFilePath("D:\\Text.txt");
strFilePath = file.GetFilePath();
MessageBox(strFilePath);
file.Close();


最后发现文件的路径变了,但是在D盘下面并没有找到Text.txt,原因是SetFilePath只能指定一个路径给文件,SetFilePath并不能做为移动文件来使用。


CFile并没有给出取得文件类型的函数,有了上面基础,这个很容易实现。


API函数中也有获得文件路径的操作,这里只是做简单介绍,可以参照MSDNN的说明:GetFileSize可以获得文件的大小,GetFullPathName 函数获取文件的完整路径名,只有当该文件在当前目录下,结果才正确。GetModuleFileName函数获取文件的完整路径名,这些函数有些用到文件句柄的。


用CFileDialog打开的文件,可以使用它的成员变量m_ofn,或者成员函数GetFileName, GetFileTitle, GetFilePath,GetFileExt来取得相关信息.


CFileDialog( BOOL bOpenFileDialog, LPCTSTR lpszDefExt = NULL, LPCTSTR lpszFileName = NULL, DWORD dwFlags = OFN_HIDEREADONLY | OFN_OVERWRITEPROMPT, LPCTSTR lpszFilter = NULL, CWnd* pParentWnd = NULL );


各个参数如下:


bOpenFileDialog 为TRUE为打开对话框,为FALSE为保存对话文件对话框


lpszDefExt 指定默认的文件扩展名。


lpszFileName 指定默认的文件名。


dwFlags 指明一些特定风格。


lpszFilter它指明可供选择的文件类型和相应的扩展名。参数格式如:


“Chart Files (.xlc)|.xlc|Worksheet Files (.xls)|.xls|Data Files (.xlc;.xls)|.xlc; .xls|All Files (.)|.||”;文件类型说明和扩展名间用 | 分隔,同种类型文件的扩展名间可以用 ; 分割,每种文件类型间用 | 分隔,末尾用 || 指明。


pParentWnd 为父窗口指针


CString FileFilter = “所有文件(.)|.||”;


CFileDialog FileDialog(true,NULL,NULL,OFN_HIDEREADONLY,FileFilter,NULL);

FileDialog.DoModal();


MessageBox(FileDialog.GetFileName());


6.小结:


在实际中还有很多其他操作文件的方法,上面介绍的只是简单的几种,希望通过上面的简单介绍,在加上具体实践,能够找到解决问题的最好办法!


相关文章
|
2月前
|
Linux C++ Windows
【Azure 应用服务】Azure App Service(Windows)环境中如何让.NET应用调用SAP NetWeaver RFC函数
【Azure 应用服务】Azure App Service(Windows)环境中如何让.NET应用调用SAP NetWeaver RFC函数
【Azure 应用服务】Azure App Service(Windows)环境中如何让.NET应用调用SAP NetWeaver RFC函数
|
2月前
|
JSON 前端开发 API
构建前端防腐策略问题之更新getMemoryUsagePercent函数以适应新的API返回格式的问题如何解决
构建前端防腐策略问题之更新getMemoryUsagePercent函数以适应新的API返回格式的问题如何解决
构建前端防腐策略问题之更新getMemoryUsagePercent函数以适应新的API返回格式的问题如何解决
|
11天前
|
网络协议 API Windows
MASM32编程调用 API函数RtlIpv6AddressToString,windows 10 容易,Windows 7 折腾
MASM32编程调用 API函数RtlIpv6AddressToString,windows 10 容易,Windows 7 折腾
|
13天前
|
存储 程序员 API
【收藏】非API函数检测操作系统类型
【收藏】非API函数检测操作系统类型
|
1月前
|
网络安全 虚拟化 Windows
windows 11安装openSSH server 遇到的"kex_exchange_identification: read: Connection reset"问题
windows 11安装openSSH server 遇到的"kex_exchange_identification: read: Connection reset"问题
|
2月前
|
Linux API
Linux源码阅读笔记07-进程管理4大常用API函数
Linux源码阅读笔记07-进程管理4大常用API函数
|
2月前
|
API 开发工具 图形学
PicoVR Unity SDK⭐️五、常用API接口函数一览
PicoVR Unity SDK⭐️五、常用API接口函数一览
|
3月前
|
API 运维
开发与运维函数问题之filter操作符在Gather API中的实现方式如何解决
开发与运维函数问题之filter操作符在Gather API中的实现方式如何解决
18 1
|
3月前
|
API 运维
开发与运维函数问题之Gather API与Stream Collector的区别如何解决
开发与运维函数问题之Gather API与Stream Collector的区别如何解决
23 1
|
3月前
|
自然语言处理 PyTorch API
`transformers`库是Hugging Face提供的一个开源库,它包含了大量的预训练模型和方便的API,用于自然语言处理(NLP)任务。在文本生成任务中,`transformers`库提供了许多预训练的生成模型,如GPT系列、T5、BART等。这些模型可以通过`pipeline()`函数方便地加载和使用,而`generate()`函数则是用于生成文本的核心函数。
`transformers`库是Hugging Face提供的一个开源库,它包含了大量的预训练模型和方便的API,用于自然语言处理(NLP)任务。在文本生成任务中,`transformers`库提供了许多预训练的生成模型,如GPT系列、T5、BART等。这些模型可以通过`pipeline()`函数方便地加载和使用,而`generate()`函数则是用于生成文本的核心函数。