# std::skipws, std::noskipws

> C++ Atlas: `cppatlas.com/w/cpp/io/manip/skipws` | Source: https://en.cppreference.com/w/cpp/io/manip/skipws | Domain: Input/output

Enables or disables skipping of leading whitespace by the formatted input functions (enabled by default). Has no effect on output.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <ios>
std::ios_base& skipws( std::ios_base& str ); // (1)
std::ios_base& noskipws( std::ios_base& str ); // (2)
```

Enables or disables skipping of leading whitespace by the formatted input functions (enabled by default). Has no effect on output.

1) Enables the `skipws` flag in the stream `str` as if by calling `str.setf(std::ios_base::skipws)`.

2) Disables the `skipws` flag in the stream `str` as if by calling `str.unsetf(std::ios_base::skipws)`.

The whitespace skipping is performed by the constructor of `std::basic_istream::sentry`, which reads and discards the characters classified as whitespace by the `std::ctype` facet of the stream's imbued locale.

This is an I/O manipulator, it may be called with an expression such as `out << std::noskipws` for any `out` of type `std::basic_ostream` or with an expression such as `in >> std::noskipws` for any `in` of type `std::basic_istream`.

### Parameters

- `str` - reference to I/O stream

### Return value

`str` (reference to the stream after manipulation).

### Example

```cpp
#include <iostream>
#include <sstream>

int main()
{
    char c1, c2, c3;
    std::istringstream("a b c") >> c1 >> c2 >> c3;
    std::cout << "Default  behavior:"
                 " c1 = " << c1 <<
                 " c2 = " << c2 <<
                 " c3 = " << c3 << '\n';
    std::istringstream("a b c") >> std::noskipws >> c1 >> c2 >> c3;
    std::cout << "noskipws behavior:"
                 " c1 = " << c1 <<
                 " c2 = " << c2 <<
                 " c3 = " << c3 << '\n';
}
```

Output:

```text
Default  behavior: c1 = a c2 = b c3 = c
noskipws behavior: c1 = a c2 =   c3 = b
```

### See also

- [`resetiosflags`](https://en.cppreference.com/w/cpp/io/manip/resetiosflags): clears the specified ios_base flags (function)
- [`setiosflags`](https://en.cppreference.com/w/cpp/io/manip/setiosflags): sets the specified `ios_base` flags (function)
- [`ws`](https://en.cppreference.com/w/cpp/io/manip/ws): consumes whitespace (function template)

---
Attribution: content from https://en.cppreference.com/w/cpp/io/manip/skipws (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.