C++

Reference

<ios>

ios_base

public member function
<ios> <iostream>

std::ios_base::width

get (1)
streamsize width() const;
set (2)
streamsize width (streamsize wide);
Get/set field width
The first form (1) returns the current value of the field width.
The second form (2) also sets a new field width for the stream.

The field width determines the minimum number of characters to be written in some output representations. If the standard width of the representation is shorter than the field width, the representation is padded with fill characters at a point determined by the format flag adjustfield (one of left, right or internal).

The fill character can be retrieved or changed by calling the member function fill.

The format flag adjustfield can be modified by calling the member functions flags or setf, by inserting one of the following manipulators: left, right and internal, or by inserting the parameterized manipulator setiosflags.

The field width can also be modified using the parameterized manipulator setw.

Parameters

wide
New value for the stream's field width.
streamsize in signed integral type.

Return Value

The value of the field width before the call.

Example

1
2
3
4
5
6
7
8
9
10
11
12
 
// field width
#include <iostream>     // std::cout, std::left

int main () {
  std::cout << 100 << '\n';
  std::cout.width(10);
  std::cout << 100 << '\n';
  std::cout.fill('x');
  std::cout.width(15);
  std::cout << std::left << 100 << '\n';
  return 0;
}

Output:

100
       100
100xxxxxxxxxxxx


Data races

Accesses (1) or modifies (2) the stream object.
Concurrent access to the same stream object may cause data races.

Exception safety

Basic guarantee: if an exception is thrown, the stream is in a valid state.

See also

setw
Set field width (function)
ios_base::flags
Get/set format flags (public member function)
ios_base::setf
Set specific format flags (public member function)
ios::fill
Get/set fill character (public member function)