std::left,std::right,std::internal(3)

NAME
std::left,std::right,std::internal - std::left,std::right,std::internal

Synopsis
   Defined in header <ios>
   std::ios_base& left( std::ios_base& str ); (1)
   std::ios_base& right( std::ios_base& str ); (2)
   std::ios_base& internal( std::ios_base& str ); (3)
   Modifies the positioning of the fill characters in an output stream. left and right
   apply to any type being output, internal applies to integer, floating-point, and
   monetary output. Has no effect on input.
   1) Sets the adjustfield of the stream str to left as if by calling
   str.setf(std::ios_base::left, std::ios_base::adjustfield).
   2) Sets the adjustfield of the stream str to right as if by calling
   str.setf(std::ios_base::right, std::ios_base::adjustfield).
   3) Sets the adjustfield of the stream str to internal as if by calling
   str.setf(std::ios_base::internal, std::ios_base::adjustfield).
   The initial default for standard streams is equivalent to right.
   This is an I/O manipulator. It may be called with an expression such as out <<
   std::left for any out of type std::basic_ostream or with an expression such as in >>
   std::left 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
// Run this code
 #include <iomanip>
 #include <iostream>
 #include <locale>
 int main()
 {
     std::cout.imbue(std::locale("en_US.utf8"));
     std::cout << "Default positioning:\n" << std::setfill('*')
               << std::setw(12) << -1.23 << '\n'
               << std::setw(12) << std::hex << std::showbase << 42 << '\n'
               << std::setw(12) << std::put_money(123, true) << "\n\n";
     std::cout << "Left positioning:\n" << std::left
               << std::setw(12) << -1.23 << '\n'
               << std::setw(12) << 42 << '\n'
               << std::setw(12) << std::put_money(123, true) << "\n\n";
     std::cout << "Internal positioning:\n" << std::internal
               << std::setw(12) << -1.23 << '\n'
               << std::setw(12) << 42 << '\n'
               << std::setw(12) << std::put_money(123, true) << "\n\n";
     std::cout << "Right positioning:\n" << std::right
               << std::setw(12) << -1.23 << '\n'
               << std::setw(12) << 42 << '\n'
               << std::setw(12) << std::put_money(123, true) << '\n';
 }

Output:
 Default positioning:
 *******-1.23
 ********0x2a
 ***USD *1.23
 Left positioning:
 -1.23*******
 0x2a********
 USD *1.23***
 Internal positioning:
 -*******1.23
 0x********2a
 USD ****1.23
 Right positioning:
 *******-1.23
 ********0x2a
 ***USD *1.23

See also
   setw changes the width of the next input/output field
              (function)
   setfill changes the fill character
              (function template)
   showbase controls whether prefix is used to indicate numeric base
   noshowbase (function)