|
<istream>
istream& ws ( istream& is );
Extract whitespaces
Extracts as many whitespace characters as possible from the current position in the input sequence. The extraction stops as soon as a non-whitespace character is found. These whitespace characters extracted are not stored in any variable.
Notice that most istream objects have the skipws flag set by default, and therefore already skip all whitespaces before all extraction operations.
Parameters
- is
- Input stream object where to apply.
Because this function is a manipulator, it is designed to be used alone with no arguments in conjunction with the extraction (>>) operations on streams (see example below).
Return Value
The same stream object (is).
Example
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
// ws manipulator example
#include <iostream>
#include <sstream>
using namespace std;
int main () {
char a[10], b[10];
istringstream iss ("one \n \t two");
iss >> noskipws;
iss >> a >> ws >> b;
cout << a << "," << b << endl;
return 0;
}
|
Basic template declaration
1
2
|
template <class charT, class traits>
basic_istream<charT,traits>& ws (basic_istream<charT,traits>& is);
|
See also
| skipws | Skip whitespaces (manipulator function) |
| noskipws | Do not skip whitespaces (manipulator function) |
|