# NAME

Term::FormatColumns - Format lists of data into columns across the terminal's width

# VERSION

version 0.007

# STATUS

<a href="https://travis-ci.org/preaction/Term-FormatColumns"><img src="https://travis-ci.org/preaction/Term-FormatColumns.svg?branch=master"></a><a href="https://coveralls.io/r/preaction/Term-FormatColumns"><img src="https://coveralls.io/repos/preaction/Term-FormatColumns/badge.png" alt="Coverage Status" /></a>

# SYNOPSIS

    use Term::FormatColumns qw( format_columns );
    my @list = 0..1000;
    print format_columns @list;

# DESCRIPTION

This module will take a list and format it into columns that stretch across the
current terminal's width, much like the output of ls(1).

If the filehandle is not attached to a tty, will simply write one column of output
(again, like ls(1)).

# SUBROUTINES

## format\_columns

    my $string = format_columns @array;

Format the list of data for STDOUT. Returns a single string formatted and ready for output.

## format\_columns\_for\_fh

    my $string = format_columns_for_fh $fh, @array;
    my $string = format_columns_for_fh STDOUT, @array;

Format the given data for the given filehandle. If the filehandle is attached to a tty,
will get the tty's width to determine how to format the data.

## format\_columns\_for\_width

    my $string = format_columns_for_width 78, @array;

Format the given data for the given width. This allows you to use this module without
being attached to a known/knowable terminal.

# AUTHOR

Doug Bell <preaction@cpan.org>

# CONTRIBUTOR

Marius Gavrilescu <marius@ieval.ro>

# COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Doug Bell.

This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
