构造器
语法:
fstream( const char *filename, openmode mode ); ifstream( const char *filename, openmode mode ); ofstream( const char *filename, openmode mode ); |
Tstream, ifstream, 和ofstream对象用于文件输入/输出. 可选择模式通过使用ios stream mode flags定义了一个文件如何打开。filename 指定被打开的文件并与流相关联。例如，下面的代码读取输入的数据并追加结果到一个输出文件中.
ifstream fin( "/tmp/data.txt" );
ofstream fout( "/tmp/results.txt", ios::app );
while( fin >> temp )
fout << temp + 2 << endl;
fin.close();
fout.close();
输入和输出文件流可以相似的方式被使用在C++预定义I/O流，cin 和 cout.
bad
语法:
bool bad(); |
如果当前的流发生致命的错误，bad()函数返回true，否则返回false。
相关主题: good()
clear
语法:
void clear( iostate flags = goodbit ); |
函数clear()清除与当前流相关联的标志。默认标志是goodbit它清除所有标志.否则只有指定的标志被清除。
相关主题: rdstate()
close
语法:
void close(); |
Tclose()函数关闭相关的文件流。
相关主题: open()
eof
语法:
bool eof(); |
如果到达相关联的输入文件的末尾，eof()函数返回true，否则返回false。例如：
char ch;
ifstream fin( "temp.txt" );
while( !fin.eof() ) {
fin >> ch;
cout << ch;
}
fin.close();
相关主题: bad(), fail(), good(), rdstate(), clear()
fail
语法:
bool fail(); |
如果当前流发生错误fail()函数返回true ，否则返回false 。
相关主题: good(), eof(), bad(), clear(), rdstate()
fill
语法:
char fill(); char fill( char ch ); |
函数fill()可以返回当前填充字符，或者设置当前填充字符为ch 。填充字符被定义为用来填充字符，当一个数字比较指定宽度T小时。默认的填充字符是空格。
相关主题: precision(), width()
flags
语法:
fmtflags flags(); fmtflags flags( fmtflags f ); |
flags()函数或者返回当前流的格式标志，或者为当前流设置标志为f。
flush
语法:
ostream &flush(); |
flush()函数可以引起当把前流的缓冲区写出到附属设备中去。这个函数对于打印调试信息很用处，因为当程序有机会把缓冲区内容写出到屏幕之前，程序会被中断。灵活地使用flush()可以保证你所有的调试状态都实在的打印出来。
gcount
语法:
streamsize gcount(); |
函数gcount()被用于输入流，并返回上一次输入操作被读入的字符的数目。
相关主题: get(), getline(), read()
get
语法:
int get(); istream &get( char &ch ); istream &get( char *buffer, streamsize num ); istream &get( char *buffer, streamsize num, char delim ); istream &get( streambuf &buffer ); istream &get( streambuf &buffer, char delim ); |
get()函数被用于输入流，和以下这些:
- 读入一个字符并返回它的值，
- 读入一个字符并把它存储在ch，
- 读取字符到buffer直到num - 1个字符被读入, 或者碰到EOF或换行标志，
- 读取字符到buffer直到已读入num - 1 个字符，或者碰到EOF或delim(delim直到下一次不会被读取)，
- 读取字符到buffer中，直到碰到换行或EOF，
- 或是读取字符到buffer中，直到碰到换行，EOF或delim。(相反, delim直到下一个get()不会被读取 ).
例如，下面的代码一个字符一个字符的显示文件temp.txt中的内容：
char ch;
ifstream fin( "temp.txt" );
while( fin.get(ch) )
cout << ch;
fin.close();
相关主题: put(), read(), getline()
getline
语法:
istream &getline( char *buffer, streamsize num ); istream &getline( char *buffer, streamsize num, char delim ); |
getline()函数用于输入流，读取字符到buffer中，直到下列情况发生：
- num - 1个字符已经读入,
- 碰到一个换行标志，
- 碰到一个EOF，
- 或者，任意地读入，直到读到字符delim。delim字符不会被放入buffer中。
good
语法:
bool good(); |
如果当前流没有发生错误，函数good()返回true ，否则返回false。
相关主题: bad(), fail(), eof(), clear(), rdstate()
ignore
语法:
istream &ignore( streamsize num=1, int delim=EOF ); |
ignore()函数用于输入流。它读入字符，直到已经读了num 个字符(默认为1)或是直到字符delim 被读入(默认为EOF).
open
语法:
void open( const char *filename ); void open( const char *filename, openmode mode ); |
函数open()用于文件流。它打开filename 并将其与当前的流相关联。可以选择的模式有：
| 模式 | 含义 | ||
|---|---|---|---|
| ios::app | 添加输出 | ||
| ios::ate | 当已打开时寻找到EOF | ||
| ios::binary | 以二进制模式打开文件 | ||
| ios::in | 为读取打开文件 | ||
| ios::out | 为写入打开文件 | ios::trunc | 覆盖存在的文件 |
如果open()失败，当用于一个布尔表达式中时，作为结果的流会给出对错误的评估。例如：
ifstream inputStream("file.txt");
if( !inputStream ) {
cerr << "Error opening input stream" << endl;
return;
}
相关主题: close(), fstream(), ifstream(), ofstream(),
peek
语法:
int peek(); |
函数peek()用于输入流中，并返回在流中的下一个字符或如果是处于被入的文件的结尾处返回EOF。peek()不会把字符从流中移除。
precision
语法:
streamsize precision(); streamsize precision( streamsize p ); |
precision()函数设置或返回当前要被显示的浮点变量的位数。例如，下面的代码：
float num = 314.15926535;
cout.precision( 5 );
cout << num;
displays
314.16
put
语法:
ostream &put( char ch ); |
函数put()用于输出流，并把字符ch写入流中。
putback
语法:
istream &putback( char ch ); |
putback()函数用于输入流，并且返回以前读的字符ch到输入流中。
相关主题: peek()
rdstate
语法:
iostate rdstate(); |
rdstate()函数返回当前流的状态。iostate 对象有下面这些标志：
| 标志 | 含义 |
|---|---|
| badbit | 发生致命的错误 |
| eofbit | 已经发现EOF |
| failbit | 一个非致命性错误已经发生 |
| goodbit | 没有发生错误 |
相关主题: eof(), good(), bad(), clear(), fail()
read
语法:
istream &read( char *buffer, streamsize num ); |
函数read()用于输入流，在将字符放入buffer 之前从流中读取num 个字节。如果碰到EOF，read()中止，丢弃不论多少个字节已经放入。例如：
struct {
int height;
int width;
} rectangle;
input_file.read( (char *)(&rectangle), sizeof(rectangle) );
if( input_file.bad() ) {
cerr << "Error reading data" << endl;
exit( 0 );
}
相关主题: gcount(), get(), getline(), write()
seekg
语法:
istream &seekg( off_type offset, ios::seekdir origin ); istream &seekg( pos_type position ); |
函数seekg()用于输入流，并且它将重新设置"get"指针到当前流的从origin偏移offset个字节的位置上，或是置"get"指针在position位置。
相关主题: seekp(), tellg(), tellp()
seekp
语法:
ostream &seekp( off_type offset, ios::seekdir origin ); ostream &seekp( pos_type position ); |
seekp()函数用于输出流，但在其它方面和seekg()很类似。
相关主题: seekg(), tellg(), tellp()
setf
语法:
fmtflags setf( fmtflags flags ); fmtflags setf( fmtflags flags, fmtflags needed ); |
函数setf()设置当前流的格式化标志为flags。可选标志needed 只允许flags标志和needed标志都被设置。返回值是前面设置的标志。 例如：
int number = 0x3FF;
cout.setf( ios::dec );
cout << "Decimal: " << number << endl;
cout.unsetf( ios::dec );
cout.setf( ios::hex );
cout << "Hexadecimal: " << number << endl;
提示，上面的代码和下面的代码的功能是一致的:
int number = 0x3FF;
cout << "Decimal: " << number << endl << hex << "Hexadecimal: " << number << dec << endl;
参考 manipulators.
sync_with_stdio
语法:
static bool sync_with_stdio( bool sync=true ); |
sync_with_stdio()函数有打开或关闭使用C++风格I/O系统混合C风格的I/O系统的功能。
tellg
语法:
pos_type tellg(); |
tellg()函数用于输入流，并返回流中"get"指针的当前位置。
相关主题: seekg(), seekp(), tellp()
tellp
语法:
pos_type tellp(); |
tellp()函数用于输出流中，并返回在流中当前"put"指针的位置。 例如，下面的代码显示了当一个文件指针写入一个流的时候的情形：
string s("In Xanadu did Kubla Khan...");
ofstream fout("output.txt");
for( int i=0; i < s.length(); i++ ) {
cout << "File pointer: " << fout.tellp();
fout.put( s[i] );
cout << " " << s[i] << endl;
}
fout.close();
相关主题: seekg(), seekp(), tellg()
unsetf
语法:
void unsetf( fmtflags flags ); |
函数unsetf()用于清除与当前流相关的给定的标志flags。什么标志呢?
width
语法:
int width(); int width( int w ); |
函数 width()返回当前的宽度。可选择参数w用于设定宽度大小。宽度是指每一次输出中显示的字符的最小数目。例如：
cout.width( 5 );
cout << "2";
displays
2
(在一个'2'的后面紧跟着四个空格)
相关主题: precision(), fill()
write
语法:
ostream &write( const char *buffer, streamsize num ); |
write()函数用于输出流，从buffer中写num个字节到当前输出流中。