std::ws

 

C++

Language

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Input/output library

I/O manipulators

C-style I/O

Buffers

basic_streambuf

basic_filebuf

basic_stringbuf

strstreambuf (deprecated)

Streams

Abstractions

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

File I/O

basic_ifstream

basic_ofstream

basic_fstream

String I/O

basic_istringstream

basic_ostringstream

basic_stringstream

Array I/O

istrstream (deprecated)

ostrstream (deprecated)

strstream (deprecated)

Types

streamoff

streamsize

fpos

Error category interface

iostream_category (C++11)

io_errc (C++11)

 

Input/output manipulators

Floating-point formatting
showpoint noshowpoint setprecision	fixed scientific hexfloat defaultfloat (C++11) (C++11)
Integer formatting
setbase showbase noshowbase	dec hex oct
Boolean formatting
boolalpha noboolalpha
Field width and fill control
setfill setw	internal left right
Other formatting
showpos noshowpos	uppercase nouppercase
Whitespace processing
ws ends	skipws noskipws
Output flushing
flush endl	unitbuf nounitbuf
Status flags manipulation
resetiosflags	setiosflags
Time and money I/O
get_money (C++11) get_time (C++11)	put_money (C++11) put_time (C++11)

 

Defined in header <istream>
template< class CharT, class Traits > std::basic_istream<CharT,Traits>& ws( std::basic_istream<CharT, Traits>& is );

Discards leading whitespace from an input stream.

First, constructs a std::basic_istream::sentry object with noskipws set to true. Afterwards, if good()==false, calls setstate(failbit) and returns. Otherwise, extracts characters from the stream and discards them until any one of the following conditions occurs:

• end of file condition occurs in the input sequence (in which case the function calls setstate(eofbit) but does not set failbit.

• the next available character c in the input sequence is not whitespace as determined by std::isspace(c, is.getloc()). The non-whitespace character is not extracted.

This is an input-only I/O manipulator, it may be called with an expression such as in << std::ws for any in of type std::basic_istream.

Parameters

is

-

reference to input stream

Return value

is (reference to the stream after extraction of consecutive whitespace)

Example

#include <iostream>
#include <sstream>
int main()
{
    std::istringstream s("     this is a test");
    std::string line;
    s >> std::ws;
    getline(s, line);
    std::cout << "ws + getline returns: \"" << line << "\"\n";
}

Output:

ws + getline returns: "this is a test"

See also

ignore	extracts and discards characters until the given character is found (public member function of std::basic_istream)