I/O Input and Output

<iostream>库自动定义了一些标准对象:


cout, ostream类的一个对象，可以将数据显示在标准输出设备上.
cerr, ostream类的另一个对象，它无缓冲地向标准错误输出设备输出数据.
clog, 类似cerr,但是它使用缓冲输出.
cin, istream类的一个对象,它用于从标准输入设备读取数据.
<fstream>库允许编程人员利用ifstream和ofstream类进行文件输入和输出.


一些C++ I/O流(精度，判断等)的行为可以通过操作不同的标志来修改。


Constructors 构造器
bad() 如果出现错误则返回true
clear() 清除状态标志
close() 关闭一个流
eof() 如果处于文件结尾处则返回true
fail() 如果出现错误则返回true
fill() 控制默认填充字符
flags() 操作flags
flush() 清空缓冲区
gcount() 返回读取的最后一次输入的字符数
get() 读取字符
getline() 读取一行字符
good() 如果没有出现过错误则返回true
ignore() 读取字符并忽略指定字符
open() 创建一个输入流
peek() 检查下一个输入的字符
precision() 设置精度
put() 写字符
putback() 返回字符给一个流
rdstate() 返回流的状态
read() 读取字条符
seekg() 在一个输入流中进行随机访问
seekp() 在一个输出流中进行随机访问
setf() 设置格式标志
sync_with_stdio() 同标准I/O同步
tellg() 使用输入流读取流指针
tellp() 使用输出流读取流指针
unsetf() 清除格式标志
width() 操作域宽度
write() 写字符
--------------------------------------------------------------------------------


构造器


语法:   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.


相关主题:


close(), open()


--------------------------------------------------------------------------------


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。


相关主题:


unsetf(), setf()


--------------------------------------------------------------------------------


flush


语法:   ostream &flush();


flush()函数可以引起当把前流的缓冲区写出到附属设备中去。这个函数对于打印调试信息很用处，因为当程序有机会把缓冲区内容写出到屏幕之前，程序会被中断。灵活地使用flush()可以保证你所有的调试状态都实在的打印出来。


相关主题:


put(), write()


--------------------------------------------------------------------------------


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中。


相关主题:


get(), read()


--------------------------------------------------------------------------------


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).


相关主题:


get(), getline()


--------------------------------------------------------------------------------


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()不会把字符从流中移除。


相关主题:


get(), putback()


--------------------------------------------------------------------------------


precision


语法:   streamsize precision();


streamsize precision( streamsize p );


precision()函数设置或返回当前要被显示的浮点变量的位数。例如，下面的代码：


    float num = 314.15926535;


    cout.precision( 5 );


    cout << num;


displays


    314.16


相关主题:


width(), fill()


--------------------------------------------------------------------------------


put


语法:   ostream &put( char ch );


函数put()用于输出流，并把字符ch写入流中。


相关主题:


write(), get()


--------------------------------------------------------------------------------


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.


相关主题:


flags(), unsetf()


--------------------------------------------------------------------------------


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。什么标志呢?


相关主题:


setf(), 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个字节到当前输出流中。