# std::setfill

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

When used in an expression out << setfill(c) sets the fill character of the stream out to c.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <iomanip>

template< class CharT >
/*unspecified*/ setfill( CharT c );
```

When used in an expression `out << setfill(c)` sets the fill character of the stream `out` to `c`.

### Parameters

- `c` - new value for the fill character

### Return value

An object of unspecified type such that

- if `out` is an object of type `std::basic_ostream<CharT, Traits>`, the expression `out << setfill(c)`
  - has type `std::basic_ostream<CharT, Traits>&`
  - has value `out`
  - behaves as if it called `f(out, c)`

where the function `f` is defined as:

```cpp
template<class CharT, class Traits>
void f(std::basic_ios<CharT, Traits>& str, CharT c)
{
    // set fill character
    str.fill(c);
}
```

### Notes

The current fill character may be obtained with `std::ostream::fill`.

### Example

```cpp
#include <iomanip>
#include <iostream>

int main()
{
    std::cout << "default fill: [" << std::setw(10) << 42 << "]\n"
              << "setfill('*'): [" << std::setfill('*')
                                   << std::setw(10) << 42 << "]\n";
}
```

Output:

```text
default fill: [        42]
setfill('*'): [********42]
```

### Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

| DR | Applied to | Behavior as published | Correct behavior |
| --- | --- | --- | --- |
| LWG 183 | C++98 | `setbase` could only be used with streams of type `std::ostream` | usable with any output character stream |

### See also

- [`fill`](https://en.cppreference.com/w/cpp/io/basic_ios/fill): manages the fill character (public member function of `std::basic_ios<CharT,Traits>`)
- [`internal`](https://en.cppreference.com/w/cpp/io/manip/left), [`left`](https://en.cppreference.com/w/cpp/io/manip/left), [`right`](https://en.cppreference.com/w/cpp/io/manip/left): sets the placement of fill characters (function)
- [`setw`](https://en.cppreference.com/w/cpp/io/manip/setw): changes the width of the next input/output field (function)

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