.TH "FBB::lm" "3bobcat" "2005\-2023" "libbobcat\-dev_6\&.04\&.00" "OFoldStream manipulator"

.PP 
.SH "NAME"
FBB::lm \- Manipulator setting left margins of OFoldStream objects
.PP 
.SH "SYNOPSIS"
\fB#include <bobcat/ofoldstream>\fP or 
.br 
\fB#include <bobcat/ofoldbuf>\fP 
.br 
Linking option: \fI\-lbobcat\fP
.PP 
.SH "DESCRIPTION"

.PP 
The \fIlm\fP class implements a manipulator that can be inserted into
\fIOFoldStream\fP objects to set the stream\(cq\&s left margin to a requested
value\&.
.PP 
Depending on the tab\-setting of the \fIOFoldStream\fP the inserted value
represents the number of blank space characters or the number of
tab\-characters that will be used for the left margin\&.
.PP 
The request will be processed at the next newline character or \fIstd::flush\fP
or \fIstd::endl\fP manipulator that is inserted into the stream\&. If a line is
still once an \fIlm\fP object and a \fIflush\fP 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)\&.
.PP 
A \fIbad_cast\fP exception is thrown when the manipulator is inserted into an
\fIostream\fP that is not using a \fIOFoldBuf\fP buffer\&.
.PP 
.SH "NAMESPACE"
\fBFBB\fP
.br 
All constructors, members, operators and manipulators, mentioned in this
man\-page, are defined in the namespace \fBFBB\fP\&.
.PP 
.SH "INHERITS FROM"
\-
.PP 
.SH "CONSTRUCTOR"
.IP o 
\fBlm(size_t newValue)\fP:
.br 

.PP 
Copy and move constructors (and assignment operators) are available\&.
.PP 
.SH "MEMBER FUNCTIONS"

.PP 
.IP o 
\fBstd::ostream &modify(std::ostream &out) const\fP:
.br 
This member is normally not directly called from
user\-programs\&. Instead, it is called by the insertion operator when inserting
the \fIlm\fP manipulator\&.

.PP 
.SH "EXAMPLE"
.nf 

    #include <iostream>
    #include <bobcat/ofoldstream>

    using namespace std;
    using namespace FBB;

    int main()
    {
        OFoldStream out(cout, 0, 80);
        out << \(dq\&hello world (left margin is 0)\(dq\& << lm(4) << \(dq\&\en\(dq\&
               \(dq\&this uses a 4 character wide left margin\en\(dq\& <<
               lm(0) << flush << \(dq\&at column 0 again\en\(dq\&;
    }
        
.fi 

.PP 
.SH "FILES"
\fIbobcat/lm\fP \- defines the class interface
.PP 
.SH "SEE ALSO"
\fBbobcat\fP(7), \fBmanipulators\fP(3bobcat), \fBmlm\fP(3bobcat),
\fBofoldstream\fP(3bobcat)
.PP 
.SH "BUGS"
None Reported\&.
.PP 
.SH "BOBCAT PROJECT FILES"

.PP 
.IP o 
\fIhttps://fbb\-git\&.gitlab\&.io/bobcat/\fP: gitlab project page;
.IP o 
\fIbobcat_6\&.04\&.00\-x\&.dsc\fP: detached signature;
.IP o 
\fIbobcat_6\&.04\&.00\-x\&.tar\&.gz\fP: source archive;
.IP o 
\fIbobcat_6\&.04\&.00\-x_i386\&.changes\fP: change log;
.IP o 
\fIlibbobcat1_6\&.04\&.00\-x_*\&.deb\fP: debian package containing the
libraries;
.IP o 
\fIlibbobcat1\-dev_6\&.04\&.00\-x_*\&.deb\fP: debian package containing the
libraries, headers and manual pages;

.PP 
.SH "BOBCAT"
Bobcat is an acronym of `Brokken\(cq\&s Own Base Classes And Templates\(cq\&\&.
.PP 
.SH "COPYRIGHT"
This is free software, distributed under the terms of the
GNU General Public License (GPL)\&.
.PP 
.SH "AUTHOR"
Frank B\&. Brokken (\fBf\&.b\&.brokken@rug\&.nl\fP)\&.
.PP