/ 
Text-Table-Boxed-0.001
/ Text::Table::Boxed::Pager

NAME

Text::Table::Boxed::Pager - Display table on terminal ala 'more'

SYNOPSIS

use Text::Table::Boxed;
use Text::Table::Boxed::Pager qw/view_table/;

my $tb = Text::Table::Boxed->new({
  columns => [ ... ],
  style   => "boxrule",
});
$tb->load( ... );

$rows_before_quit = view_table($tb);

$rows_before_quit = view_table($tb, $num_terminal_rows);

DESCRIPTION

This displays a table on the terminal, pausing after each screen-full for the user to press ENTER (or q to stop).

The titles are re-displayed on every screen so they are always visible.

Multi-line rows are kept together on the same screen if possible.

If the size of the terminal is not specified, it is obtained from the OS.

This is basically a demo of using the "rows" feature of Text::Table::Boxed. See the code.

view_table($tb)

Call this to display the table.

Undef is returned if the user paged through the entire table, otherwise the number of rows which were displayed before the user entered 'q' to quit.

AUTHOR

Jim Avera (jim.avera at gmail)

LICENSE

CC0 or Public Domain. However your application is likely subject to the more restrictive licenses of Text::Table and other modules.