C++ uses a set of input/output (I/O) stream class libraries for input and output. Objects defined in these classes can be overloaded and extended just as any other C++ objects. Although you may still use the <stdio.h> function calls in the ANSI C library, you should probably get use to using streams. The following figure is the class hierarchy for C++ I/O classes and a brief description of the class names:
ios
|
___________
| |
istream ostream
| |
__________ ____________
| | | |
ifstream iostream ofstream
|
fstream
Generally, you'll be using the iostream class for standard I/O, and the fstream class for file I/O. In addition, the iomanip.h header file is frequently used and contains parameterized stream manipulators which are function-like calls which are used to change various I/O settings.
The following snippet shows how to use the basics of using C++ I/O streams. The insert operator '<<' and extraction operator '>>' are used to send and get data from the screen and keyboard.
// io.cp
#include <iostream.h>
#include <iomanip.h>
main()
{
int i;
float f;
char c;
cout << "Enter an integer: ";
cin >> i;
cout << "Enter a float: ";
cin >> f;
cout << "Enter a character: ";
cin >> c;
cout << endl;
cout << "Default formats" << endl;
cout << i << endl;
cout << f << endl;
cout << c << endl;
cout << endl << "Other formats" << endl;
cout << hex << i << endl;
cout << setprecision(2) << f << endl;
cout << setiosflags( ios::scientific ) << f << endl;
Predefined input stream is cin (standard input). The >> operator is overloaded for input streams.
GCOUNT
int gcount()
Returns number of characters read by last unformatted read.
GET
int get()
istream &get( char & )
istream &get( unsigned char & )
istream &get( char *buf, int limit, char delim='\n' )
istream &get( unsigned char *buf, int limit, char delim='\n' )
Gets single character or series of characters (until end-of-file is reached). Delimiter, if read, is not included in characters read and is left in stream.
GETLINE
istream &getline( char *buf, int limit, char delim='\n' )
istream &getline( unsigned char *buf, int limit, char delim='\n' )
Reads characters until delimiter is read or limit-1 characters are read (or until end-of-file). The delimiter, if read, is included in character sequence.
IGNORE
istream &ignore( int limit=1, int delim=EOF )
Discards number of characters or until delimiter is encountered.
PEEK
int peek()
Look at next character to be read without reading it.
PUTBACK
istream &putback( char )
Puts character back onto stream. Can safely put one character back between successive calls to get().
READ
istream &read( char *buf, int count )
istream &read( unsigned char *buf, int count )
Reads a string of characters from stream. Sets "failbit" if end-of-file encountered.
SEEKG
istream &seekg( streampos, seek_dir=ios::beg )
Moves position of "get" pointer. The type streampos is an alias for type long.
TELLG
streampos tellg()
Returns current position of "get" pointer in file stream.
Many format statements require the inclusion of the standard <iomanip.h> header file. These statements are identified as such. The following are a list of format flags and bitfields used by streams:
skipws Skips whitespace on input.
left, Sets justification within field.
right,
internal
dec, Set base for insertion/extraction of integral types.
oct, Comprise static member ios::basefield.
hex
showbase Display 0 before octal and 0x before hexadecimal values.
showpoint Show decimal point and trailing zeros.
showpos Insert + sign before positive values.
scientific, Sets floating point notation. Comprise static member
fixed ios::floatfield.
uppercase Use uppercase for hexadecimal X and exponential E.
The following is a list of format statements. Those statements which have a return type of ios& are stream manipulators (placed into stream with << and >> operators).
DEC
ios& dec( ios & )
Sets decimal base.
FILL
char fill()
char fill( char )
Sets fill character (if provided), returns previous fill character.
FLAGS
long flags()
long flags( long )
Returns current flags, or if flags provided returns previous flags.
HEX
ios &hex( ios & )
Sets hexidecimal base.
OCT
ios &oct( ios & )
Sets octal base.
PRECISION
int precision()
int precision( int )
Sets number of significant digits (if provided), returns current/previous value.
RESETIOSFLAGS
ios &resetiosflags( long ) -- requires <iomanip.h>
Turns off specified flags.
SETBASE
ios &setbase( int ) -- requires <iomanip.h>
Sets numerical base based on integer provided.
SETF
long setf( long bitFlags )
long setf( long bitFlags, long bitField )
Clears bitField and sets format flags, returns previous flags.
SETFILL
ostream &setfill( char ) -- requires <iomanip.h>
Sets fill character.
SETIOSFLAGS
ios &setiosflags( long ) -- requires <iomanip.h>
Sets format flags.
SETPRECISION
ios &setprecision( int ) -- requires <iomanip.h>
Sets number of significant digits.
SETW
ios &setw( int size ) -- requires <iomanip.h>
Sets size (width) of line buffer.
UNSETF
long unsetf( long )
Turns off specified flags and returns previous flags.
WIDTH
int width()
int width( int minimum )
Sets minimum field width if provided (zero = no minimum). Returns current width. Reset to zero after each insertion/extraction.
