<istream> functions

Visual Studio 2015
 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at <istream> functions.

lt;istream> swap](#istream_swap)|ws|

Exchanges the elements of two stream objects.

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

Skips white space in the stream.

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

<istream>

Show: