Linux Certif

Toute la documentation sur la certification Linux LPI

Text::Wrapper.3pm

NAME

Text::Wrapper - Simple word wrapping routine

SYNOPSIS

     require Text::Wrapper;
     $wrapper = Text::Wrapper->new(columns => 60, body_start => '    ');
     print $wrapper->wrap($text);
 
 

DESCRIPTION

Text::Wrapper provides simple word wrapping. It breaks long lines, but does not alter spacing or remove existing line breaks. If you're looking for more sophisticated text formatting, try the Text::Format module.

Reasons to use Text::Wrapper instead of Text::Format:

•

Text::Wrapper is significantly smaller.

•

It does not alter existing whitespace or combine short lines. It only breaks long lines.

Again, if Text::Wrapper doesn't meet your needs, try Text::Format.

Methods

$wrapper = Text::Wrapper->new( [options] )

Constructs a new Text::Wrapper object. The options are specified by key and value. The keys are:

  body_start  The text that begins the second and following lines of
              a paragraph.  (Default '')
 
 

  columns     The number of columns to use.  This includes any text
              in body_start or par_start.  (Default 70)
 
 

  par_start   The text that begins the first line of each paragraph.
              (Default '')
 
 

$wrapper->body_start( [$value] )

$wrapper->columns( [$value] )

$wrapper->par_start( [$value] )

If $value is supplied, sets the option and returns the previous value. If omitted, just returns the current value.

$wrapper->wrap($text)

Returns a word wrapped copy of $text. The original is not altered.

BUGS

Does not handle tabs (they're treated just like spaces).

Does not break words that can't fit on one line.

LICENSE

Text::Wrapper is distributed under the same terms as Perl itself.

This means it is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. See the GNU General Public License or the Artistic License for more details.

AUTHOR

Christopher J. Madsen <perl AT cjmweb.net>

Please send bug reports to bug-Text-Wrapper AT rt.cpan.org, or use the web interface at <http://rt.cpan.org/Public/Bug/Report.html?Queue=Text-Wrapper>