C S tdioFile

一个 CStdioFile 对象代表一个用运行时函数 fopen 打开的 C 运行时流式文件。

文本方式提供对硬回车 — 换行符对的特殊处理。当你将一个换行符（ 0x0A ）写入一个文本方式的 CStdioFile 对象时，字节对（ 0x0A ， 0x0D ）被发送给该文件。当你读一个文件时，字节对（ 0x0A ， 0x0D ）被翻译为一个字节（ 0x0A ）。

CStdioFile 不支持 Duplicate ， LockRange ，和 UnlockRange 这几个 CFile 函数。如果在 CStdioFile 中调用了这几个函数，将会出现 CNoSupported 异常。

有关使用 CStdioFile 的更多信息，参见“ V isual C++ 程序员指南 ”中的文章“ MFC 文件 ” ，和 “ M icrosoft Visual C++ 库参考 ” 中的 “ M icrosoft Visual C++ 6.0 运行库参考 ” 。

#include <afx.h>

请参阅 CFile, CFile::Duplicate, CFile::LockRange, CFile::UnlockRange, CNotSupportedException

CStdioFile 类成员

Data Members

m_pStream 包含了一个指向打开文件的指针

Construction

CstdioFile 从一个路径或文件指针构造一个 CStdioFile 对象

Text Read/Write

ReadString 读取一行文本

W riteString 写一行文本

成员函数

CStdioFile::CStdioFile

CStdioFile( );

CStdioFile( FILE* pOpenStream );

CStdioFile( LPCTSTR lpszFileNam e, UINT nOpenFlags ); throw( CFileException );

参数

pOpenStream

指定由 C 运行时函数 fopen 调用返回的文件指针。

lpszFileName

指定表示需要文件的路径的字符串。该路径可以是相对路径，也可以是绝对路径。

nOpenFlags

共享和访问方式。指定当文件打开时要进行的动作。可以通过使用位或O R （ |）操作符来组合选项。需要一个访问允许和一个文本 — 二进制标识符； create 和 noInherit 方式是可选的。参见 CFile::CFile 可以获得方式选项和其它标志的列表。在 MFC 3.0 及以后版本中，共享标志是允许的。

说明

此构造函数的缺省版本与 CFile::Open 成员函数联合工作以测试错误。

一个参数的构造函数版本从一个已经打开的文件的指针构造一个 CStdioFile 对象。允许指针值包括预定义的输入 /输出文件指针 stdin ， stdout，和 stderr 。

两个参数的构造函数版本构造一个 CStdioFile 对象并根据给定的路径打开相应的操作系统文件。

如果不能被打开或创建则抛出 CFileException 。

示例

// CStdioFile::CStdioFile 示例char* pFileName = "test.dat"; CStdioFile f1;

if( !f1.Open( pFileName, CFile::modeCreate

| CFile::modeWrite | CFile::typeText ) ) { #ifdef _DEBUG

afxDump << "Unable to open file" << "\n"; #endif

exit( 1 );

}

CStdioFile f2( stdout ); TRY

{

CStdioFile f3( pFileName,

CFile::modeCreate | CFile::modeWrite | CFile::typeText );

}

CATCH( CFileException, e )

{

#ifdef _DEBUG

afxDump << "File could not be opened "

<< e->m_cause << "\n"; #endif

}

END_CATCH

CStdioFile::ReadString

virtual LPTSTR ReadString( LPTSTR lpsz , UINT nMax ); throw( CFileException );

BOOL ReadString(CString& rString ); throw( CFileException );

返回值

返回一个指向包含文本数据的缓存的指针。如果在到达文件结尾后没有读到任何数据，则返回 NULL ；或者是返回布尔值 FALSE 。

参数

lpsz

指定一个指向用户提供的缓冲区的指针；该缓冲区将接收一个以空字符结尾的文本字符串。

nMax

指定要读取的最大字符数，不计算结尾的空字符。

rString

是一个对 CString 对象的引用，当函数返回时，该对象将包含了所读取的字符串。

说明

此成员函数用来从与 CStdioFile 对象关联的文件中将文本数据读入一个缓冲区，读取的字符数不超过 nMax -1 。在碰到第一个换行符时停止读取。在这种情况下，如果读取的字符数小于 nMax -1 ，则将一个换行符保存在缓冲区中。在任何情况下，都在最后添加一个空字符（ “ 0 ” ）。

对于文本方式的输入， CFile::Read 也是可用的，但它不会在一个回车换行符处停止。

注意这个函数的 CString 版本将 “ /n ” 删除（如果有的话）； LPTSTR 版本则不删除。

示例

// example for C S tdioFile::readString extern C S tdioFile f;

char buf[100]; f.ReadString(buf,99);

请参阅 CStdioFile::WriteString, CFile::Read

CStdioFile:: W riteString

virtual void WriteString( LPCTSTR lpsz ); throw( CFileException );

lpsz

指定一个指向存放了以空字符结尾的文本字符串的缓冲区的指针。

说明

此成员函数将一个缓冲区中的数据写入与 CStdioFile 对象关联的文件中。结束的空字符（ “ \0 ” ）不被写入该文件。 lpsz 中的所有换行符都被以一个硬回车

— 换行符对写入该文件。

在响应某些条件（如磁盘已满条件）时， W irteString 抛出一个异常。

这是一个面向文本的写函数，它对 CStdioFile 及其后代，以及 CArchive 来说是可用的。 CFile::Write 也是可用的，但是它不是在一个空字符处终止，而是将要求的字节数写入文件中。

// example for C S tdioFile::WriteString extern C S tdioFile f;

char buf [ ] = “ test string ” ; f.WriteString(buf);

请参阅 CArchive::ReadString, CFile::Write

数据成员

CStdioFile::m_pStream

说明

m_pStream 数据成员是指向一个打开文件的指针，该文件是由 C 运行时函数

C S tdioFile

C S tdioFile

CStdioFile 类 成 员

成 员 函 数

数 据 成 员

CStdioFile 类成员

成员函数

数据成员