FBB::lm - Manipulator setting left margins of OFoldStream objects
SYNOPSIS
#include <bobcat/ofoldstream> or #include <bobcat/ofoldstreambuf>
Linking option: -lbobcat
DESCRIPTION
The lm class implements a manipulator that can be inserted into
OFoldStream objects to set the stream's left margin to a requested
value.
Depending on the tab-setting of the OFoldStream the inserted value
represents the number of blank space characters or the number of
tab-characters that will be used for the left margin.
The request will be processed at the next newline character or std::flush
or std::endl manipulator that is inserted into the stream. If a line is
still once an lm object and a flush manipulator are inserted into the
stream then the new left margin will be effective at the next word inserted
into that line (cf., the example section below).
A bad_cast exception is thrown when the manipulator is inserted into an
ostream that is not using a OFoldStreambuf buffer.
NAMESPACE
FBB
All constructors, members, operators and manipulators, mentioned in this
man-page, are defined in the namespace FBB.
INHERITS FROM
-
CONSTRUCTOR
lm(size_t newValue):
The standard copy constructor is available.
MEMBER FUNCTIONS
There are no public or protected member functions in this class.
EXAMPLE
#include <iostream>
#include <bobcat/ofoldstream>
using namespace std;
using namespace FBB;
int main()
{
OFoldStream out(cout, 0, 80);
out << "hello world (left margin is 0)" << lm(4) << "\n"
"this uses a 4 character wide left margin\n" <<
lm(0) << flush << "at column 0 again\n";
return 0;
}