left

 

Causes text that is not as wide as the output width to appear in the stream flush with the left margin.

Syntax

      ios
      _
      base& left(
   ios_base& _Str
);

Parameters

  • _Str
    A reference to an object of type ios_base, or to a type that inherits from ios_base.

Return Value

A reference to the object from which _Str is derived.

Remarks

The manipulator effectively calls _Str.setf(ios_base::left, ios_base::adjustfield), and then returns _Str.

Example

// ios_left.cpp
// compile with: /EHsc
#include <iostream>

int main( ) 
{
   using namespace std;
   double f1= 5.00;
   cout.width( 20 ); 
   cout << f1 << endl;
   cout << left << f1 << endl;
}
                   5
5

Requirements

Header: <ios>

Namespace: std

See Also

iostream Programming
iostreams Conventions