| Defined in header <istream> | ||||
|---|---|---|---|---|
|
Discards leading whitespace from an input stream.
Behaves as an UnformattedInputFunction, except that is.gcount() is not modified. After constructing and checking the sentry object, 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 setfailbit. - the next available character
cin the input sequence is not whitespace as determined bystd::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
1 2 3 4 5 6 7 8 9 10 | #include <iostream>#include <sstream> int main(){ std::istringstream s(" this is a test"); std::string line; getline(s >> std::ws, line); std::cout << "ws + getline returns: \"" << line << "\"\n";} |
Output:
1 | ws + getline returns: "this is a test" |
See also
| extracts and discards characters until the given character is found (public member function of std::basic_istream) |
Please login to continue.