Edit

<istream> functions

  • Article

swap
ws

swap

Exchanges the elements of two stream objects.

template <class Elem, class Tr>
void swap(
    basic_istream<Elem, Tr>& left,
    basic_istream<Elem, Tr>& right);

template <class Elem, class Tr>
void swap(
    basic_iostream<Elem, Tr>& left,
    basic_iostream<Elem, Tr>& right);

Parameters

left
A stream.

right
A stream.

ws

Skips white space in the stream.

template class<Elem, Tr> basic_istream<Elem, Tr>& ws(basic_istream<Elem, Tr>& _Istr);

Parameters

_Istr
A stream.

Return Value

The stream.

Remarks

The manipulator extracts and discards any elements ch for which use_facet< ctype< Elem> >( getloc). is( ctype< Elem>:: space, ch) is true.

The function calls setstate( eofbit) if it encounters end of file while extracting elements. It returns _Istr.

Example

See operator>> for an example of using ws.

See also

<istream>