Everything
7.5.1 Stream Input/Output Class Library

The header files for stream input/output class libraries are as follows:

-

<ios>

Defines data members and function members that specify input/output formats and manage the input/output states. The <ios> header file also defines the Init and ios_base classes in addition to the ios class.

-

<streambuf>

Defines functions for the stream buffer.

-

<istream>

Defines input functions from the input stream.

-

<ostream>

Defines output functions to the output stream.

-

<iostream>

Defines input/output functions.

-

<iomanip>

Defines manipulators with parameters.

The following shows the inheritance relation of the above classes. An arrow (->) indicates that a derived class references a base class. The streambuf class has no inheritance relation.

 

The following types are used by stream input/output class libraries.

Type

Definition Name

Description

Type

streamoff

Defined as long type.

streamsize

Defined as size_t type.

int_type

Defined as int type.

pos_type

Defined as long type.

off_type

Defined as long type.

 

(a)

ios_base::Init Class

Type

Definition Name

Description

Variable

init_cnt

Static data member that counts the number of stream input/output objects. The data must be initialized to 0 by a low-level interface.

Function

Init()

Constructor.

~Init()

Destructor.

 

ios_base::Init::Init()

Constructor of class Init.

Increments init_cnt.

 

ios_base::Init::~Init()

Destructor of class Init.

Decrements init_cnt.

 

(b)

ios_base Class

Type

Definition Name

Description

Type

fmtflags

Type that indicates the format control information.

iostate

Type that indicates the stream buffer input/output state.

openmode

Type that indicates the open mode of the file.

seekdir

Type that indicates the seek state of the stream buffer.

Variable

fmtfl

Format flag.

wide

Field width.

prec

Precision (number of decimal point digits) at output.

fillch

Fill character.

Function

void _ec2p_init_base()

Initializes the base class.

void _ec2p_copy_base(
ios_base&ios_base_dt)

Copies ios_base_dt.

ios_base()

Constructor.

~ios_base()

Destructor.

fmtflags flags() const

References the format flag (fmtfl).

fmtflags flags(fmtflags fmtflg)

Sets fmtflg&format flag (fmtfl) to the format flag (fmtfl).

fmtflags setf(fmtflags fmtflg)

Sets fmtflg to format flag (fmtfl).

fmtflags setf(
fmtflags fmtflg,
fmtflags mask)

Sets mask&fmtflg to the format flag (fmtfl).

void unsetf(fmtflags mask)

Sets ~mask&format flag (fmtfl) to the format flag (fmtfl).

char fill() const

References the fill character (fillch).

char fill(char ch)

Sets ch as the fill character (fillch).

int precision() const

References the precision (prec).

streamsize precision(
streamsize preci)

Sets preci as precision (prec).

streamsize width() const

References the field width (wide).

streamsize width(streamsize wd)

Sets wd as field width (wide).

 

ios_base::fmtflags

Defines the format control information relating to input/output processing.

The definition for each bit mask of fmtflags is as follows:

const ios_base::fmtflags ios_base::boolalpha

= 0x0000;

const ios_base::fmtflags ios_base::skipws

= 0x0001;

const ios_base::fmtflags ios_base::unitbuf

= 0x0002;

const ios_base::fmtflags ios_base::uppercase

= 0x0004;

const ios_base::fmtflags ios_base::showbase

= 0x0008;

const ios_base::fmtflags ios_base::showpoint

= 0x0010;

const ios_base::fmtflags ios_base::showpos

= 0x0020;

const ios_base::fmtflags ios_base::left

= 0x0040;

const ios_base::fmtflags ios_base::right

= 0x0080;

const ios_base::fmtflags ios_base::internal

= 0x0100;

const ios_base::fmtflags ios_base::adjustfield

= 0x01c0;

const ios_base::fmtflags ios_base::dec

= 0x0200;

const ios_base::fmtflags ios_base::oct

= 0x0400;

const ios_base::fmtflags ios_base::hex

= 0x0800;

const ios_base::fmtflags ios_base::basefield

= 0x0e00;

const ios_base::fmtflags ios_base::scientific

= 0x1000;

const ios_base::fmtflags ios_base::fixed

= 0x2000;

const ios_base::fmtflags ios_base::floatfield

= 0x3000;

const ios_base::fmtflags ios_base::_fmtmask

= 0x3fff;

 

ios_base::iostate

Defines the input/output state of the stream buffer.

The definition for each bit mask of iostate is as follows:

const ios_base::iostate ios_base::goodbit

= 0x0;

const ios_base::iostate ios_base::eofbit

= 0x1;

const ios_base::iostate ios_base::failbit

= 0x2;

const ios_base::iostate ios_base::badbit

= 0x4;

const ios_base::iostate ios_base::_statemask

= 0x7;

 

ios_base::openmode

Defines open mode of the file.

The definition for each bit mask of openmode is as follows:

const ios_base::openmode ios_base::in

= 0x01;

Opens the input file.

const ios_base::openmode ios_base::out

= 0x02;

Opens the output file.

const ios_base::openmode ios_base::ate

= 0x04;

Seeks for eof only once after the file has been opened.

const ios_base::openmode ios_base::app

= 0x08;

Seeks for eof each time the file is written to.

const ios_base::openmode ios_base::trunc

= 0x10;

Opens the file in overwrite mode.

const ios_base::openmode ios_base::binary

= 0x20;

Opens the file in binary mode.

 

ios_base::seekdir

Defines the seek state of the stream buffer.

Determines the position in a stream to continue the input/output of data.

The definition for each bit mask of seekdir is as follows:

const ios_base::seekdir ios_base::beg

= 0x0;

const ios_base::seekdir ios_base::cur

= 0x1;

const ios_base::seekdir ios_base::end

= 0x2;

 

void ios_base::_ec2p_init_base()

The initial settings are as follows:
fmtfl = skipws | dec;
wide = 0;
prec = 6;
fillch = ’ ’;

 

void ios_base::_ec2p_copy_base(ios_base& ios_base_dt)

Copies ios_base_dt.

 

ios_base::ios_base()

Constructor of class ios_base.

Calls Init::Init().

 

ios_base::~ios_base()

Destructor of class ios_base.

 

ios_base::fmtflags ios_base::flags() const

References the format flag (fmtfl).

Return value: Format flag (fmtfl).

 

ios_base::fmtflags ios_base::flags(fmtflags fmtflg)

Sets fmtflg&format flag (fmtfl) to the format flag (fmtfl).

Return value: Format flag (fmtfl) before setting.

 

ios_base::fmtflags ios_base::setf(fmtflags fmtflg)

Sets fmtflg to the format flag (fmtfl).

Return value: Format flag (fmtfl) before setting.

 

ios_base::fmtflags ios_base::setf((fmtflags fmtflg, fmtflags mask)

Sets the mask&fmtflg value to the format flag (fmtfl).

Return value: Format flag (fmtfl) before setting.

 

void ios_base::unsetf(fmtflags mask)

Sets ~mask&format flag (fmtfl) to the format flag (fmtfl).

 

char ios_base::fill() const

References the fill character (fillch).

Return value: Fill character (fillch).

 

char ios_base::fill(char ch)

Sets ch as the fill character (fillch).

Return value: Fill character (fillch) before setting.

 

int ios_base::precision() const

References the precision (prec).

Return value: Precision (prec).

 

streamsize ios_base::precision(streamsize preci)

Sets preci as the precision (prec).

Return value: Precision (prec) before setting.

 

streamsize ios_base::width() const

References the field width (wide).

Return value: Field width (wide).

 

streamsize ios_base::width(streamsize wd)

Sets wd as the field width (wide).

Return value: Field width (wide) before setting.

 

(c)

ios Class

Type

Definition Name

Description

Variable

sb

Pointer to the streambuf object.

tiestr

Pointer to the ostream object.

state

State flag of streambuf.

Function

ios()

Constructor.

ios(streambuf* sbptr)

void init(streambuf* sbptr)

Performs initial setting.

virtual ~ios()

Destructor.

operator void*() const

Tests whether an error has been generated (!state&(badbit | failbit).

bool operator!() const

Tests whether an error has been generated (state&(badbit | failbit)).

iostate rdstate() const

References the state flag (state).

void clear(iostate st = goodbit)

Clears the state flag (state) except for the specified state (st).

void setstate(iostate st)

Specifies st as the state flag (state).

bool good() const

Tests whether an error has been generated (state==goodbit).

bool eof() const

Tests for the end of an input stream (state&eofbit).

bool bad() const

Tests whether an error has been generated (state&badbit).

bool fail() const

Tests whether the input text matches the requested pattern (state&(badbit | failbit)).

ostream* tie() const

References the pointer to the ostream object (tiestr).

ostream* tie(ostream* tstrptr)

Sets tstrptr as the pointer to the ostream object (tiestr).

streambuf* rdbuf() const

References the pointer to the streambuf object (sb).

streambuf* rdbuf(streambuf* sbptr)

Sets sbptr as the pointer to the streambuf object (sb).

ios& copyfmt(const ios& rhs)

Copies the state flag (state) of rhs.

 

ios::ios()

Constructor of class ios.

Calls init(0) and sets the initial value to the member object.

 

ios::ios(streambuf* sbptr)

Constructor of class ios.

Calls init(sbptr) and sets the initial value to the member object.

 

void ios::init(streambuf* sbptr)

Sets sbptr to sb.

Sets state and tiestr to 0.

 

virtual ios::~ios()

Destructor of class ios.

 

ios::operator void*() const

Tests whether an error has been generated (!state&(badbit | failbit)).

Return value: An error has been generated: false

No error has been generated: true

 

bool ios::operator!() const

Tests whether an error has been generated (state&(badbit | failbit)).

Return value: An error has been generated: true

No error has been generated: false

 

iostate ios::rdstate() const

References the state flag (state).

Return value: State flag (state).

 

void ios::clear(iostate st = goodbit)

Clears the state flag (state) except for the specified state (st).

If the pointer to the streambuf object (sb) is 0, badbit is set to the state flag (state).

 

void ios::setstate(iostate st)

Sets st to the state flag (state).

 

bool ios::good() const

Tests whether an error has been generated (state==goodbit).

Return value: An error has been generated: false

No error has been generated: true

 

bool ios::eof() const

Tests for the end of the input stream (state&eofbit).

Return value: End of the input stream has been reached: true

End of the input stream has not been reached: false

 

bool ios::bad() const

Tests whether an error has been generated (state&badbit).

Return value: An error has been generated: true

No error has been generated: false

 

bool ios::fail() const

Tests whether the input text matches the requested pattern (state&(badbit | failbit)).

Return value: Does not match the requested pattern: true

Matches the requested pattern: false

 

ostream* ios::tie() const

References the pointer (tiestr) to the ostream object.

Return value: Pointer to the ostream object (tiestr).

 

ostream* ios::tie(ostream* tstrptr)

Sets tstrptr as the pointer (tiestr) to the ostream object.

Return value: Pointer to the ostream object (tiestr) before setting.

 

streambuf* ios::rdbuf() const

References the pointer to the streambuf object (sb).

Return value: Pointer to the streambuf object (sb).

 

streambuf* ios::rdbuf(streambuf* sbptr)

Sets sbptr as the pointer to the streambuf object (sb).

Return value: Pointer to the streambuf object (sb) before setting.

 

ios& ios::copyfmt(const ios& rhs)

Copies the state flag (state) of rhs.

Return value: *this

 

(d)

ios Class Manipulators

Type

Definition Name

Description

Function

ios_base& showbase(ios_base& str)

Specifies the radix display prefix mode.

ios_base& noshowbase(ios_base& str)

Clears the radix display prefix mode.

ios_base& showpoint(ios_base& str)

Specifies the decimal-point generation mode.

ios_base& noshowpoint(ios_base& str)

Clears the decimal-point generation mode.

ios_base& showpos(ios_base& str)

Specifies the + sign generation mode.

ios_base& noshowpos(ios_base& str)

Clears the + sign generation mode.

ios_base& skipws(ios_base& str)

Specifies the space skipping mode.

ios_base& noskipws (ios_base& str)

Clears the space skipping mode.

ios_base& uppercase(ios_base& str)

Specifies the uppercase letter conversion mode.

ios_base& nouppercase(ios_base& str)

Clears the uppercase letter conversion mode.

ios_base& internal(ios_base& str)

Specifies the internal fill mode.

ios_base& left(ios_base& str)

Specifies the left side fill mode.

ios_base& right(ios_base& str)

Specifies the right side fill mode.

ios_base& dec(ios_base& str)

Specifies the decimal mode.

ios_base& hex(ios_base& str)

Specifies the hexadecimal mode.

ios_base& oct(ios_base& str)

Specifies the octal mode.

ios_base& fixed(ios_base& str)

Specifies the fixed-point mode.

ios_base& scientific(ios_base& str)

Specifies the scientific description mode.

 

ios_base& showbase(ios_base& str)

Specifies an output mode of prefixing a radix at the beginning of data.

For a hexadecimal, 0x is prefixed. For a decimal, nothing is prefixed. For an octal, 0 is prefixed.

Return value: str

 

ios_base& noshowbase(ios_base& str)

Clears the output mode of prefixing a radix at the beginning of data.

Return value: str

 

ios_base& showpoint(ios_base& str)

Specifies the output mode of showing the decimal point.

If no precision is specified, six decimal-point (fraction) digits are displayed.

Return value: str

 

ios_base& noshowpoint(ios_base& str)

Clears the output mode of showing the decimal point.

Return value: str

 

ios_base& showpos(ios_base& str)

Specifies the output mode of generating the + sign (adds a + sign to a positive number).

Return value: str

 

ios_base& noshowpos(ios_base& str)

Clears the output mode of generating the + sign.

Return value: str

 

ios_base& skipws(ios_base& str)

Specifies the input mode of skipping spaces (skips consecutive spaces).

Return value: str

 

ios_base& noskipws(ios_base& str)

Clears the input mode of skipping spaces.

Return value: str

 

ios_base& uppercase(ios_base& str)

Specifies the output mode of converting letters to uppercases.

In hexadecimal, the radix will be uppercase letters 0X, and the numeric value letters will be uppercase letters. The exponential representation of a floating-point value will also use uppercase letter E.

Return value: str

 

ios_base& nouppercase(ios_base& str)

Clears the output mode of converting letters to uppercases.

Return value: str

 

ios_base& internal(ios_base& str)

When data is output in the field width (wide) range, it is output in the order of

Sign and radix
Fill character (fill)
Numeric value

Return value: str

 

ios_base& left(ios_base& str)

When data is output in the field width (wide) range, it is aligned to the left.

Return value: str

 

ios_base& right(ios_base& str)

When data is output in the field width (wide) range, it is aligned to the right.

Return value: str

 

ios_base& dec(ios_base& str)

Specifies the conversion radix to the decimal mode.

Return value: str

 

ios_base& hex(ios_base& str)

Specifies the conversion radix to the hexadecimal mode.

Return value: str

 

ios_base& oct(ios_base& str)

Specifies the conversion radix to the octal mode.

Return value: str

 

ios_base& fixed(ios_base& str)

Specifies the fixed-point output mode.

Return value: str

 

ios_base& scientific(ios_base& str)

Specifies the scientific description output mode (exponential description).

Return value: str

 

(e)

streambuf Class

Type

Definition Name

Description

Constant

eof

Indicates the end of the file.

Variable

_B_cnt_ptr

Pointer to the length of valid data in the buffer.

B_beg_ptr

Pointer to the base pointer of the buffer.

_B_len_ptr

Pointer to the length of the buffer.

B_next_ptr

Pointer to the next position of the buffer from which data is to be read.

B_end_ptr

Pointer to the end position of the buffer.

B_beg_pptr

Pointer to the start position of the control buffer.

B_next_pptr

Pointer to the next position of the buffer from which data is to be read.

C_flg_ptr

Pointer to the input/output control flag of the file.

Function

char* _ec2p_getflag() const

References the pointer for the file input/output control flag.

char*& _ec2p_gnptr()

References the pointer to the next position of the buffer from which data is to be read.

char*& _ec2p_pnptr()

References the pointer to the next position of the buffer where data is to be written.

void _ec2p_bcntplus()

Increments the valid data length of the buffer.

void _ec2p_bcntminus()

Decrements the valid data length of the buffer.

void _ec2p_setbPtr(
char** begptr,
char** curptr,
long* cntptr,
long* lenptr,
char* flgptr)

Sets the pointers of streambuf.

streambuf()

Constructor.

virtual ~streambuf()

Destructor.

streambuf* pubsetbuf(char* s,
streamsize n)

Allocates the buffer for stream input/output.

This function calls setbuf (s,n)*1.

pos_type pubseekoff(
off_type off,
ios_base::seekdir way,
ios_base::openmode
which = ios_base::in | ios_base::out)

Moves the position to read or write data in the input/output stream by using the method specified by way.

This function calls seekoff(off,way,which)*1.

pos_type pubseekpos(
pos_type sp,
ios_base::openmode
which = ios_base::in | ios_base::out)

Calculates the offset from the beginning of the stream to the current position.

This function calls seekpos(sp,which)*1.

int pubsync()

Flushes the output stream.

This function calls sync()*1.

streamsize in_avail()

Calculates the offset from the end of the input stream to the current position.

int_type snextc()

Reads the next character.

int_type sbumpc()

Reads one character and sets the pointer to the next character.

int_type sgetc()

Reads one character.

int sgetn(char* s, streamsize n)

Reads n characters and sets them in the memory area specified by s.

int_type sputbackc(char c)

Puts back the read position.

int sungetc()

Puts back the read position.

int sputc(char c)

Inserts character c.

int_type sputn(const char* s,
streamsize n)

Inserts n characters at the position pointed to by the amount specified by s.

char* eback() const

Reads the start pointer of the input stream.

Function

char* gptr() const

Reads the next pointer of the input stream.

char* egptr() const

Reads the end pointer of the input stream.

void gbump(int n)

Moves the next pointer of the input stream by the amount specified by n.

void setg(
char* gbeg,
char* gnext,
char* gend)

Assigns each pointer of the input stream.

char* pbase() const

Calculates the start pointer of the output stream.

char* pptr() const

Calculates the next pointer of the output stream.

char* epptr() const

Calculates the end pointer of the output stream.

void pbump(int n)

Moves the next pointer of the output stream by the amount specified by n.

void setp(char* pbeg, char* pend)

Assigns each pointer of the output stream.

virtual streambuf* setbuf(char* s,
streamsize n)*1

For each derived class, a defined operation is executed.

virtual pos_type seekoff(
off_type off,
ios_base::seekdir way,
ios_base::openmode = (ios_base::openmode)
(ios_base::in | ios_base::out))*1

Changes the stream position.

virtual pos_type seekpos(
pos_type sp,
ios_base::openmode = (ios_base::openmode)
(ios_base::in | ios_base::out))*1

Changes the stream position.

virtual int sync()*1

Flushes the output stream.

virtual int showmanyc()*1

Calculates the number of valid characters in the input stream.

virtual streamsize xsgetn(char* s, streamsize n)

Sets n characters in the memory area specified by s.

virtual int_type underflow()*1

Reads one character without moving the stream position.

virtual int_type uflow()*1

Reads one character of the next pointer.

virtual int_type pbackfail(int type c = eof)*1

Puts back the character specified by c.

virtual streamsize xsputn(const char* s,
streamsize n)

Inserts n characters in the position specified by s.

virtual int_type overflow(int type c = eof)*1

Inserts character c in the output stream.

Notes 1.

This class does not define the processing.

 

char* streambuf::_ec2p_getflag() const

References the pointer for the file input/output control flag.

 

char*& streambuf::_ec2p_gnptr()

References the pointer to the next position of the buffer from which data is to be read.

 

char*& streambuf::_ec2p_pnptr()

References the pointer to the next position of the buffer where data is to be written.

 

void streambuf::_ec2p_bcntplus()

Increments the valid data length of the buffer.

 

void streambuf::_ec2p_bcntminus()

Decrements the valid data length of the buffer.

 

void _ec2p_setbPtr(char** begptr, char** curptr, long* cntptr, long* lenptr, char* flgptr)

Sets the pointers of streambuf.

 

streambuf::streambuf()

Constructor.

The initial settings are as follows:

_B_cnt_ptr = B_beg_ptr = B_next_ptr = B_end_ptr = C_flg_ptr = _B_len_ptr = 0
B_beg_pptr = &B_beg_ptr
B_next_pptr = &B_next_ptr

 

virtual streambuf::~streambuf()

Destructor.

 

streambuf* streambuf::pubsetbuf(char* s, streamsize n)

Allocates the buffer for stream input/output.

This function calls setbuf (s,n).

Return value: *this

 

pos_type streambuf::pubseekoff(off_type off, ios_base::seekdir way, ios_base::openmode which =

(ios_base::openmode)(ios_base::in | ios_base::out))

Moves the read or write position for the input/output stream by using the method specified by way.

This function calls seekoff(off,way,which).

Return value: The stream position newly specified.

 

pos_type streambuf::pubseekpos(pos_type sp, ios_base::openmode which = (ios_base::openmode)(ios_base::in | ios_base::out))

Calculates the offset from the beginning of the stream to the current position.

Moves the current stream pointer by the amount specified by sp.

This function calls seekpos(sp,which).

Return value: The offset from the beginning of the stream.

 

int streambuf::pubsync()

Flushes the output stream.

This function calls sync().

Return value: 0

 

streamsize streambuf::in_avail()

Calculates the offset from the end of the input stream to the current position.

Return value:

If the position where data is read is valid: The offset from the end of the stream to the current position.

If the position where data is read is invalid: 0 (showmanyc() is called).

 

int_type streambuf::snextc()

Reads one character. If the character read is not eof, the next character is read.

Return value: If the character read is not eof: The character read

If the character read is eof: eof

 

int_type streambuf::sbumpc()

Reads one character and moves forward the pointer to the next.

Return value: If the position where data is read is valid: The character read

If the position where data is read is invalid: eof

 

int_type streambuf::sgetc()

Reads one character.

Return value: If the position where data is read is valid: The character read

If the position where data is read is invalid: eof

 

int streambuf::sgetn(char* s, streamsize n)

Sets n characters in the memory area specified by s. If an eof is found in the string read, setting is stopped.

Return value: The specified number of characters.

 

int_type streambuf::sputbackc(char c)

If the data read position is correct and the put back data of the position is the same as c, the read position is put back.

Return value: If the read position was put back: The value of c

If the read position was not put back: eof

 

int streambuf::sungetc()

If the data read position is correct, the read position is put back.

Return value: If the read position was put back: The value that was put back

If the read position was not put back: eof

 

int streambuf::sputc(char c)

Inserts character c.

Return value: If the write position is correct: The value of c

If the write position is incorrect: eof

 

int_type streambuf::sputn(const char* s, streamsize n)

Inserts n characters at the position specified by s.

If the buffer is smaller than n, the number of characters for the buffer is inserted.

Return value: The number of characters inserted.

 

char* streambuf::eback() const

Calculates the start pointer of the input stream.

Return value: Start pointer.

 

char* streambuf::gptr() const

Calculates the next pointer of the input stream.

Return value: Next pointer.

 

char* streambuf::egptr() const

Calculates the end pointer of the input stream.

Return value: End pointer.

 

void streambuf::gbump(int n)

Moves forward the next pointer of the input stream by the amount specified by n.

 

void streambuf::setg(char* gbeg, char* gnext, char* gend)

Sets each pointer of the input stream as follows:

*B_beg_pptr = gbeg;
*B_next_pptr = gnext;
B_end_ptr = gend;
*_B_cnt_ptr = gend-gnext;
*_B_len_ptr = gend-gbeg;

 

char* streambuf::pbase() const

Calculates the start pointer of the output stream.

Return value: Start pointer.

 

char* streambuf::pptr() const

Calculates the next pointer of the output stream.

Return value: Next pointer.

 

char* streambuf::epptr() const

Calculates the end pointer of the output stream.

Return value: End pointer.

 

void streambuf::pbump(int n)

Moves forward the next pointer of the output stream by the amount specified by n.

 

void streambuf::setp(char* pbeg, char* pend)

The settings for each pointer of the output stream are as follows:

*B_beg_pptr = pbeg;
*B_next_pptr = pbeg;
B_end_ptr = pend;
*_B_cnt_ptr = pend-pbeg;
*_B_len_ptr = pend-pbeg;

 

virtual streambuf* streambuf::setbuf(char* s, streamsize n)

For each derived class from streambuf, a defined operation is executed.

Return value: *this (This class does not define the processing.)

 

virtual pos_type streambuf::seekoff(off_type off, ios_base::seekdir way, ios_base::openmode =

(ios_base::openmode)(ios_base::in | ios_base::out))

Changes the stream position.

Return value: -1 (This class does not define the processing.)

 

virtual pos_type streambuf::seekpos(pos_type sp, ios_base::openmode = (ios_base::openmode)(ios_base::in | ios_base::out))

Changes the stream position.

Return value: -1 (This class does not define the processing.)

 

virtual int streambuf::sync()

Flushes the output stream.

Return value: 0 (This class does not define the processing.)

 

virtual int streambuf::showmanyc()

Calculates the number of valid characters in the input stream.

Return value: 0 (This class does not define the processing.)

 

virtual streamsize streambuf::xsgetn(char* s, streamsize n)

Sets n characters in the memory area specified by s.

If the buffer is smaller than n, the number of characters for the buffer is inserted.

Return value: The number of characters input.

 

virtual int_type streambuf::underflow()

Reads one character without moving the stream position.

Return value: eof (This class does not define the processing.)

 

virtual int_type streambuf::uflow()

Reads one character of the next pointer.

Return value: eof (This class does not define the processing.)

 

virtual int_type streambuf::pbackfail(int_type c = eof)

Puts back the character specified by c.

Return value: eof (This class does not define the processing.)

 

virtual streamsize streambuf::xsputn(const char* s, streamsize n)

Inserts n characters specified by s in to the stream position.

If the buffer is smaller than n, the number of characters for the buffer is inserted.

Return value: The number of characters inserted.

 

virtual int_type streambuf::overflow(int_type c = eof)

Inserts character c in the output stream.

Return value: eof (This class does not define the processing.)

 

(f)

istream::sentry Class

Type

Definition Name

Description

Variable

ok_

Whether the current state is input-enabled.

Function

sentry(istream& is, bool noskipws = false)

Constructor.

~sentry()

Destructor.

operator bool()

References ok_.

 

istream::sentry::sentry(istream& is, bool noskipws = _false)

Constructor of internal class sentry.

If good() is non-zero, enables input with or without a format.

If tie() is non-zero, flushes the related output stream.

 

istream::sentry::~sentry()

Destructor of internal class sentry.

 

istream::sentry::operator bool()

References ok_.

Return value: ok_

 

(g)

istream Class

Type

Definition Name

Description

Variable

chcount

The number of characters extracted by the input function called last.

Function

int _ec2p_getistr(char* str, unsigned int dig, int mode)

Converts str with the radix specified by dig.

istream(streambuf* sb)

Constructor.

virtual ~istream()

Destructor.

istream& operator>>(bool& n)

Stores the extracted characters in n.

istream& operator>>(short& n)

istream& operator>>(unsigned short& n)

istream& operator>>(int& n)

istream& operator>>(unsigned int& n)

istream& operator>>(long& n)

istream& operator>>(unsigned long& n)

istream& operator>>(long long& n)

istream& operator>>(unsigned long long& n)

istream& operator>>(float& n)

istream& operator>>(double& n)

istream& operator>>(long double& n)

istream& operator>>(void*& p)

Converts the extracted characters to a pointer to void and stores them in p.

istream& operator >>(streambuf* sb)

Extracts characters and stores them in the memory area specified by sb.

streamsize gcount() const

Calculates chcount (number of characters extracted).

int_type get()

Extracts a character

istream& get(char& c)

Extracts characters and stores them in c.

istream& get(signed char& c)

istream& get(unsigned char& c)

istream& get(char* s, streamsize n)

Extracts strings with size n-1 and stores them in the memory area specified by s.

istream& get(signed char* s, streamsize n)

istream& get(unsigned char* s, streamsize n)

Function

istream& get(char* s, streamsize n, char delim)

Extracts strings with size n-1 and stores them in the memory area specified by s. If delim is found in the string, input is stopped.

istream& get(
signed char* s,
streamsize n,
char delim)

istream& get(
unsigned char* s,
streamsize n,
char delim)

istream& get(streambuf& sb)

Extracts strings and stores them in the memory area specified by sb.

istream& get(streambuf& sb, char delim)

Extracts strings and stores them in the memory area specified by sb. If delim is found in the string, input is stopped.

istream& getline(char* s, streamsize n)

Extracts strings with size n-1 and stores them in the memory area specified by s.

istream& getline(signed char* s, streamsize n)

istream& getline(unsigned char* s, streamsize n)

istream& getline(char* s, streamsize n, char delim)

Extracts strings with size n-1 and stores them in the memory area specified by s. If delim is found in the string, input is stopped.

istream& getline(
signed char* s,
streamsize n,
char delim)

istream& getline(
unsigned char* s,
streamsize n,
char delim)

istream& ignore(
streamsize n = 1,
int_type delim = streambuf::eof)

Skips reading the number of characters specified by n. If delim is found in the string, skipping is stopped.

int_type peek()

Seeks for input characters that can be acquired next.

istream& read(char* s, streamsize n)

Extracts strings with size n and stores them in the memory area specified by s.

istream& read(signed char* s, streamsize n)

istream& read(unsigned char* s, streamsize n)

streamsize readsome(char* s, streamsize n)

Extracts strings with size n and stores them in the memory area specified by s.

streamsize readsome(signed char* s, streamsize n)

streamsize readsome(
unsigned char* s,
streamsize n)

Function

istream& putback(char c)

Puts back a character to the input stream.

istream& unget()

Puts back the position of the input stream.

int sync()

Checks the existence of the input stream.
This function calls streambuf::pubsync().

pos_type tellg()

Finds the input stream position.
This function calls streambuf::pubseekoff(0,cur,in).

istream& seekg(pos_type pos)

Moves the current stream pointer by the amount specified by pos.
This function calls streambuf::pubseekpos(pos).

istream& seekg(off_type off, ios_base::seekdir dir)

Moves the position to read the input stream by using the method specified by dir.
This function calls streambuf::pubseekoff(off,dir).

 

int istream::_ec2p_getistr(char* str, unsigned int dig, int mode)

Converts str to the radix specified by dig.

Return value: The converted radix.

 

istream::istream(streambuf* sb)

Constructor of class istream.

Calls ios::init(sb).

Specifies chcount=0.

 

virtual istream::~istream()

Destructor of class istream.

 

istream& istream::operator>>(bool& n)

Stores the extracted characters in n.

Return value: *this

 

istream& istream::operator>>(short& n)

Stores the extracted characters in n.

Return value: *this

 

istream& istream::operator>>(unsigned short& n)

Stores the extracted characters in n.

Return value: *this

 

istream& istream::operator>>(int& n)

Stores the extracted characters in n.

Return value: *this

 

istream& istream::operator>>(unsigned int& n)

Stores the extracted characters in n.

Return value: *this

 

istream& istream::operator>>(long& n)

Stores the extracted characters in n.

Return value: *this

 

istream& istream::operator>>(unsigned long& n)

Stores the extracted characters in n.

Return value: *this

 

istream& istream::operator>>(long long& n)

Stores the extracted characters in n.

Return value: *this

istream& istream::operator>>(unsigned long long& n)

Stores the extracted characters in n.

Return value: *this

 

istream& istream::operator>>(float& n)

Stores the extracted characters in n.

Return value: *this

 

istream& istream::operator>>(double& n)

Stores the extracted characters in n.

Return value: *this

 

istream& istream::operator>>(long double& n)

Stores the extracted characters in n.

Return value: *this

 

istream& istream::operator>>(void*& p)

Converts the extracted characters to a void* type and stores them in the memory specified by p.

Return value: *this

 

istream& istream::operator>>(streambuf* sb)

Extracts characters and stores them in the memory area specified by sb.

If there are no extracted characters, setstate(failbit) is called.

Return value: *this

 

streamsize istream::gcount() const

References chcount (number of extracted characters).

Return value: chcount

 

int_type istream::get()

Extracts characters.

Return value: If characters are extracted: Extracted characters.

If no characters are extracted: Calls setstate(failbit) and becomes streambuf::eof.

 

istream& istream::get(char& c)

Extracts characters and stores them in c. If the extracted character is streambuf::eof, failbit is set.

Return value: *this

 

istream& istream::get(signed char& c)

Extracts characters and stores them in c. If the extracted character is streambuf::eof, failbit is set.

Return value: *this

 

istream& istream::get(unsigned char& c)

Extracts characters and stores them in c. If the extracted character is streambuf::eof, failbit is set.

Return value: *this

 

istream& istream::get(char* s, streamsize n)

Extracts a string with size n-1 and stores it in the memory area specified by s. If ok_==false or no character has been extracted, failbit is set.

Return value: *this

 

istream& istream::get(signed char* s, streamsize n)

Extracts a string with size n-1 and stores it in the memory area specified by s. If ok_==false or no character has been extracted, failbit is set.

Return value: *this

 

istream& istream::get(unsigned char* s, streamsize n)

Extracts a string with size n-1 and stores it in the memory area specified by s. If ok_==false or no character has been extracted, failbit is set.

Return value: *this

 

istream& istream::get(char* s, streamsize n, char delim)

Extracts a string with size n-1 and stores it in the memory area specified by s.

If delim is found in the string, input is stopped.

If ok_==false or no character has been extracted, failbit is set.

Return value: *this

 

istream& istream::get(signed char* s, streamsize n, char delim)

Extracts a string with size n-1 and stores it in the memory area specified by s.

If delim is found in the string, input is stopped.

If ok_==false or no character has been extracted, failbit is set.

Return value: *this

 

istream& istream::get(unsigned char* s, streamsize n, char delim)

Extracts a string with size n-1 and stores it in the memory area specified by s.

If delim is found in the string, input is stopped.

If ok_==false or no character has been extracted, failbit is set.

Return value: *this

 

istream& istream::get(streambuf& sb)

Extracts a string and stores it in the memory area specified by sb.

If ok_==false or no character has been extracted, failbit is set.

Return value: *this

 

istream& istream::get(streambuf& sb, char delim)

Extracts a string and stores it in the memory area specified by sb.

If delim is found in the string, input is stopped.

If ok_==false or no character has been extracted, failbit is set.

Return value: *this

 

istream& istream::getline(char* s, streamsize n)

Extracts a string with size n-1 and stores it in the memory area specified by s.

If ok_==false or no character has been extracted, failbit is set.

Return value: *this

 

istream& istream::getline(signed char* s, streamsize n)

Extracts a string with size n-1 and stores it in the memory area specified by s.

If ok_==false or no character has been extracted, failbit is set.

Return value: *this

 

istream& istream::getline(unsigned char* s, streamsize n)

Extracts a string with size n-1 and stores it in the memory area specified by s.

If ok_==false or no character has been extracted, failbit is set.

Return value: *this

 

istream& istream::getline(char* s, streamsize n, char delim)

Extracts a string with size n-1 and stores it in the memory area specified by s.

If character delim is found, input is stopped.

If ok_==false or no character has been extracted, failbit is set.

Return value: *this

 

istream& istream::getline(signed char* s, streamsize n, char delim)

Extracts a string with size n-1 and stores it in the memory area specified by s.

If character delim is found, input is stopped.

If ok_==false or no character has been extracted, failbit is set.

Return value: *this

 

istream& istream::getline(unsigned char* s, streamsize n, char delim)

Extracts a string with size n-1 and stores it in the memory area specified by s.

If character delim is found, input is stopped.

If ok_==false or no character has been extracted, failbit is set.

Return value: *this

 

istream& istream::ignore(streamsize n = 1, int_type delim = streambuf::eof)

Skips reading the number of characters specified by n.

If character delim is found, skipping is stopped.

Return value: *this

 

int_type istream::peek()

Seeks input characters that will be available next.

Return value: If ok_==false: streambuf::eof
If ok_!=false: rdbuf()->sgetc()

 

istream& istream::read(char* s, streamsize n)

If ok_!=false, extracts a string with size n and stores it in the memory area specified by s. If the number of extracted characters does not match with the number of n, eofbit is set.

Return value: *this

 

istream& istream::read(signed char* s, streamsize n)

If ok_!=false, extracts a string with size n and stores it in the memory area specified by s. If the number of extracted characters does not match with the number of n, eofbit is set.

Return value: *this

 

istream& istream::read(unsigned char* s, streamsize n)

If ok_!=false, extracts a string with size n and stores it in the memory area specified by s. If the number of extracted characters does not match with the number of n, eofbit is set.

Return value: *this

 

streamsize istream::readsome(char* s, streamsize n)

Extracts a string with size n and stores it in the memory area specified by s.

If the number of characters exceeds the stream size, only the number of characters equal to the stream size is stored.

Return value: The number of extracted characters.

 

streamsize istream::readsome(signed char* s, streamsize n)

Extracts a string with size n and stores it in the memory area specified by s.

If the number of characters exceeds the stream size, only the number of characters equal to the stream size is stored.

Return value: The number of extracted characters.

 

streamsize istream::readsome(unsigned char* s, streamsize n)

Extracts a string with size n and stores it in the memory area specified by s.

If the number of characters exceeds the stream size, only the number of characters equal to the stream size is stored.

Return value: The number of extracted characters.

 

istream& istream::putback(char c)

Puts back character c to the input stream.

If the characters put back are streambuf::eof, badbit is set.

Return value: *this

 

istream& istream::unget()

Puts back the pointer of the input stream by one.

If the extracted characters are streambuf::eof, badbit is set.

Return value: *this

 

int istream::sync()

Checks for an input stream.

This function calls streambuf::pubsync().

Return value: If there is no input stream: streambuf::eof

If there is an input stream: 0

 

pos_type istream::tellg()

Checks for the position of the input stream.

This function calls streambuf::pubseekoff(0,cur,in).

Return value: Offset from the beginning of the stream

If an error occurs during the input processing, -1 is returned.

 

istream& istream::seekg(pos_type pos)

Moves the current stream pointer by the amount specified by pos.

This function calls streambuf::pubseekpos(pos).

Return value: *this

 

istream& istream::seekg(off_type off, ios_base::seekdir dir)

Moves the position to read the input stream using the method specified by dir.

This function calls streambuf::pubseekoff(off,dir). If an error occurs during the input processing, this processing is not performed.

Return value: *this

 

(h)

istream Class Manipulator

Type

Definition Name

Description

Function

istream& ws(istream& is)

Skips reading the spaces.

 

istream& ws(istream& is)

Skips reading white spaces.

Return value: is

 

(i)

istream Non-Member Function

Type

Definition Name

Description

Function

istream& operator>>(istream& in, char* s)

Extracts a string and stores it in the memory area specified by s.

istream& operator>>(istream& in, signed char* s)

istream& operator>>(istream& in, unsigned char* s)

istream& operator>>(istream& in, char& c)

Extracts a character and stores it in c.

istream& operator>>(istream& in, signed char& c)

istream& operator>>(istream& in, unsigned char& c)

 

istream& operator>>(istream& in, char* s)

Extracts a string and stores it in the memory area specified by s.

Processing is stopped if

the number of characters stored is equal to field width – 1

streambuf::eof is found in the input stream

the next available character c satisfies isspace(c)==1

If no characters are stored, failbit is set.

Return value: in

 

istream& operator>>(istream& in, signed char* s)

Extracts a string and stores it in the memory area specified by s.

Processing is stopped if

the number of characters stored is equal to field width – 1

streambuf::eof is found in the input stream

the next available character c satisfies isspace(c)==1

If no characters are stored, failbit is set.

Return value: in

 

istream& operator>>(istream& in, unsigned char* s)

Extracts a string and stores it in the memory area specified by s.

Processing is stopped if

the number of characters stored is equal to field width – 1

streambuf::eof is found in the input stream

the next available character c satisfies isspace(c)==1

If no characters are stored, failbit is set.

Return value: in

 

istream& operator>>(istream& in, char& c)

Extracts a character and stores it in c. If no character is stored, failbit is set.

Return value: in

 

istream& operator>>(istream& in, signed char& c)

Extracts a character and stores it in c. If no character is stored, failbit is set.

Return value: in

 

istream& operator>>(istream& in, unsigned char& c)

Extracts a character and stores it in c. If no character is stored, failbit is set.

Return value: in

 

(j)

ostream::sentry Class

Type

Definition Name

Description

Variable

ok_

Whether or not the current state allows output.

_ _ec2p_os

Pointer to the ostream object.

Function

sentry(ostream& os)

Constructor.

~sentry()

Destructor.

operator bool()

References ok_.

 

ostream::sentry::sentry(ostream& os)

Constructor of the internal class sentry.

If good() is non-zero and tie() is non-zero, flush() is called.

Specifies os to _ _ec2p_os.

 

ostream::sentry::~sentry()

Destructor of internal class sentry.

If (_ _ec2p_os->flags() & ios_base::unitbuf) is true, flush() is called.

 

ostream::sentry::operator bool()

References ok_.

Return value: ok_

 

(k)

ostream Class

Type

Definition Name

Description

Function

ostream(streambuf* sbptr)

Constructor.

virtual ~ostream()

Destructor.

ostream& operator<<(bool n)

Inserts n in the output stream.

ostream& operator<<(short n)

ostream& operator<<(unsigned short n)

ostream& operator<<(int n)

ostream& operator<<(unsigned int n)

ostream& operator<<(long n)

ostream& operator<<(unsigned long n)

ostream& operator<<(long long n)

ostream& operator<<(unsigned long long n)

ostream& operator<<(float n)

ostream& operator<<(double n)

ostream& operator<<(long double n)

ostream& operator<<(void* n)

ostream& operator<<(streambuf* sbptr)

Inserts the output string of sbptr into the output stream.

ostream& put(char c)

Inserts character c into the output stream.

ostream& write(
const char* s,
streamsize n)

Inserts n characters from s into the output stream.

ostream& write(
const signed char* s,
streamsize n)

ostream& write(
const unsigned char* s,
streamsize n)

ostream& flush()

Flushes the output stream.
This function calls streambuf::pubsync().

pos_type tellp()

Calculates the current write position.
This function calls streambuf::pubseekoff(0,cur,out).

ostream& seekp(pos_type pos)

Calculates the offset from the beginning of the stream to the current position.
Moves the current stream pointer by the amount specified by pos.
This function calls streambuf::pubseekpos(pos).

ostream& seekp(off_type off, seekdir dir)

Moves the stream write position by the amount specified by off, from dir.
This function calls streambuf::pubseekoff(off,dir).

 

ostream::ostream(streambuf* sbptr)

Constructor.

Calls ios(sbptr).

 

virtual ostream::~ostream()

Destructor.

 

ostream& ostream::operator<<(bool n)

If sentry::ok_==true, n is inserted into the output stream.

If sentry::ok_==false, failbit is set.

Return value: *this

 

ostream& ostream::operator<<(short n)

If sentry::ok_==true, n is inserted into the output stream.

If sentry::ok_==false, failbit is set.

Return value: *this

 

ostream& ostream::operator<<(unsigned short n)

If sentry::ok_==true, n is inserted into the output stream.

If sentry::ok_==false, failbit is set.

Return value: *this

 

ostream& ostream::operator<<(int n)

If sentry::ok_==true, n is inserted into the output stream.

If sentry::ok_==false, failbit is set.

Return value: *this

 

ostream& ostream::operator<<(unsigned int n)

If sentry::ok_==true, n is inserted into the output stream.

If sentry::ok_==false, failbit is set.

Return value: *this

 

ostream& ostream::operator<<(long n)

If sentry::ok_==true, n is inserted into the output stream.

If sentry::ok_==false, failbit is set.

Return value: *this

 

ostream& ostream::operator<<(unsigned long n)

If sentry::ok_==true, n is inserted into the output stream.

If sentry::ok_==false, failbit is set.

Return value: *this

 

ostream& ostream::operator<<(long long n)

If sentry::ok_==true, n is inserted into the output stream.

If sentry::ok_==false, failbit is set.

Return value: *this

 

ostream& ostream::operator<<(unsigned long long n)

If sentry::ok_==true, n is inserted into the output stream.

If sentry::ok_==false, failbit is set.

Return value: *this

 

ostream& ostream::operator<<(float n)

If sentry::ok_==true, n is inserted into the output stream.

If sentry::ok_==false, failbit is set.

Return value: *this

 

ostream& ostream::operator<<(double n)

If sentry::ok_==true, n is inserted into the output stream.

If sentry::ok_==false, failbit is set.

Return value: *this

 

ostream& ostream::operator<<(long double n)

If sentry::ok_==true, n is inserted into the output stream.

If sentry::ok_==false, failbit is set.

Return value: *this

 

ostream& ostream::operator<<(void* n)

If sentry::ok_==true, n is inserted into the output stream.

If sentry::ok_==false, failbit is set.

Return value: *this

 

ostream& ostream::operator<<(streambuf* sbptr)

If sentry::ok_==true, the output string of sbptr is inserted into the output stream.

If sentry::ok_==false, failbit is set.

Return value: *this

 

ostream& ostream::put(char c)

If (sentry::ok_==true) and (rdbuf()->sputc(c)!=streambuf::eof), c is inserted into the output stream.

Otherwise badbit is set.

Return value: *this

 

ostream& ostream::write(const char* s, streamsize n)

If (sentry::ok_==true) and (rdbuf()->sputn(s, n)==n), n characters specified by s are inserted into the output stream.

Otherwise badbit is set.

Return value: *this

 

ostream& ostream::write(const signed char* s, streamsize n)

If (sentry::ok_==true) and (rdbuf()->sputn(s, n)==n), n characters specified by s are inserted into the output stream.

Otherwise badbit is set.

Return value: *this

 

ostream& ostream::write(const unsigned char* s, streamsize n)

If (sentry::ok_==true) and (rdbuf()->sputn(s, n)==n), n characters specified by s are inserted into the output stream.

Otherwise badbit is set.

Return value: *this

 

ostream& ostream::flush()

Flushes the output stream.

This function calls streambuf::pubsync().

Return value: *this

 

pos_type ostream::tellp()

Calculates the current write position.

This function calls streambuf::pubseekoff(0,cur,out).

Return value: The current stream position
If an error occurs during processing, -1 is returned.

 

ostream& ostream::seekp(pos_type pos)

If no error occurs, the offset from the beginning of the stream to the current position is calculated.

Moves the current stream pointer by the amount specified by pos.

This function calls streambuf::pubseekpos(pos).

Return value: *this

 

ostream& ostream::seekp(off_type off, seekdir dir)

If no error occurs, the stream write position is moved by the amount specified by off, from dir.

This function calls streambuf::pubseekoff(off,dir).

Return value: *this

 

(l)

ostream Class Manipulator

Type

Definition Name

Description

Function

ostream& endl(ostream& os)

Inserts a new line and flushes the output stream.

ostream& ends(ostream& os)

Inserts a NULL code.

ostream& flush(ostream& os)

Flushes the output stream.

 

ostream& endl(ostream& os)

Inserts a new line code and flushes the output stream.

This function calls flush().

Return value: os

 

ostream& ends(ostream& os)

Inserts a NULL code into the output line.

Return value: os

 

ostream& flush(ostream& os)

Flushes the output stream.

This function calls streambuf::sync().

Return value: os

 

(m)

ostream Non-Member Function

Type

Definition Name

Description

Function

ostream& operator<<(ostream& os, char s)

Inserts s into the output stream.

ostream& operator<<(ostream& os, signed char s)

ostream& operator<<(ostream& os, unsigned char s)

ostream& operator<<(ostream& os, const char* s)

ostream& operator<<(ostream& os, const signed char* s)

ostream& operator<<(ostream& os, const unsigned char* s)

 

ostream& operator<<(ostream& os, char s)

If (sentry::ok_==true) and an error does not occur, s is inserted into the output stream. Otherwise failbit is set.

Return value: os

 

ostream& operator<<(ostream& os, signed char s)

If (sentry::ok_==true) and an error does not occur, s is inserted into the output stream. Otherwise failbit is set.

Return value: os

 

ostream& operator<<(ostream& os, unsigned char s)

If (sentry::ok_==true) and an error does not occur, s is inserted into the output stream. Otherwise failbit is set.

Return value: os

 

ostream& operator<<(ostream& os, const char* s)

If (sentry::ok_==true) and an error does not occur, s is inserted into the output stream. Otherwise failbit is set.

Return value: os

 

ostream& operator<<(ostream& os, const signed char* s)

If (sentry::ok_==true) and an error does not occur, s is inserted into the output stream. Otherwise failbit is set.

Return value: os

 

ostream& operator<<(ostream& os, const unsigned char* s)

If (sentry::ok_==true) and an error does not occur, s is inserted into the output stream. Otherwise failbit is set.

Return value: os

(n)

smanip Class Manipulator

Type

Definition Name

Description

Function

smanip resetiosflags(ios_base::fmtflags mask)

Clears the flag specified by the mask value.

smanip setiosflags(ios_base::fmtflags mask)

Specifies the format flag (fmtfl).

smanip setbase(int base)

Specifies the radix used at output.

smanip setfill(char c)

Specifies the fill character (fillch).

smanip setprecision(int n)

Specifies the precision (prec).

smanip setw(int n)

Specifies the field width (wide).

 

smanip resetiosflags(ios_base::fmtflags mask)

Clears the flag specified by the mask value.

Return value: Target object of input/output.

 

smanip setiosflags(ios_base::fmtflags mask)

Specifies the format flag (fmtfl).

Return value: Target object of input/output.

 

smanip setbase(int base)

Specifies the radix used at output.

Return value: Target object of input/output.

 

smanip setfill(char c)

Specifies the fill character (fillch).

Return value: Target object of input/output.

 

smanip setprecision(int n)

Specifies the precision (prec).

Return value: Target object of input/output.

 

smanip setw(int n)

Specifies the field width (wide).

Return value: Target object of input/output.

 

(o)

Example of Using EC++ Input/Output Libraries

The input/output stream can be used if a pointer to an object of the mystrbuf class is used instead of streambuf at the initialization of the istream and ostream objects.

The following shows the inheritance relationship of the above classes. An arrow (->) indicates that a derived class references a base class.

 

Type

Definition Name

Description

Variable

_file_Ptr

File pointer.

Function

mystrbuf()

Constructor.
Initializes the streambuf buffer.

mystrbuf(void* ptr)

virtual ~mystrbuf()

Destructor.

void* myfptr() const

Returns a pointer to the FILE type structure.

mystrbuf* open(const char* filename,
int mode)

Specifies the file name and mode, and opens the file.

mystrbuf* close()

Closes the file.

virtual streambuf* setbuf(char* s,
streamsize n)

Allocates the stream input/output buffer.

virtual pos_type seekoff(
off_type off,
ios_base::seekdir way,
ios_base::openmode =
(ios_base::openmode)
(ios_base::in | ios_base::out))

Changes the position of the stream pointer.

virtual pos_type seekpos(
pos_type sp,
ios_base::openmode =
(ios_base::openmode)
(ios_base::in | ios_base::out))

Changes the position of the stream pointer.

virtual int sync()

Flushes the stream.

virtual int showmanyc()

Returns the number of valid characters in the input stream.

virtual int_type underflow()

Reads one character without moving the stream position.

virtual int_type pbackfail(int type c =
streambuf::eof)

Puts back the character specified by c.

virtual int_type overflow(int type c =
streambuf::eof)

Inserts the character specified by c.

void _Init(_f_type* fp)

Initialization.

 

<Example>
#include <istream>
#include <ostream>
#include <mystrbuf>
#include <string>
#include <new>
#include <stdio.h>
void main(void)
{
    mystrbuf myfin(stdin);
    mystrbuf myfout(stdout);
    istream mycin(&myfin);
    ostream mycout(&myfout);
    int i;
    short s;
    long l;
    char c;
    string str;
    mycin >> i >> s >> l >> c >> str;
    mycout << "This is EC++ Library." << endl << i << s << l << c << str << endl;
    return;
}