Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/syohex/p5-text-unicodetable-simple
Create character table(Support full width font)
https://github.com/syohex/p5-text-unicodetable-simple
Last synced: about 2 months ago
JSON representation
Create character table(Support full width font)
- Host: GitHub
- URL: https://github.com/syohex/p5-text-unicodetable-simple
- Owner: syohex
- License: other
- Created: 2011-06-25T10:13:27.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2020-06-27T02:28:25.000Z (over 4 years ago)
- Last Synced: 2024-06-18T23:58:02.373Z (7 months ago)
- Language: Perl
- Homepage:
- Size: 78.1 KB
- Stars: 4
- Watchers: 4
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: Changes
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/syohex/p5-Text-UnicodeTable-Simple)
# NAME
Text::UnicodeTable::Simple - Create a formatted table using characters.
# SYNOPSIS
use Text::UnicodeTable::Simple;
$t = Text::UnicodeTable::Simple->new();
$t->set_header(qw/Subject Score/);
$t->add_row('English', '78');
$t->add_row('Mathematics', '91');
$t->add_row('Chemistry', '64');
$t->add_row('Physics', '95');
$t->add_row_line();
$t->add_row('Total', '328');
print "$t";
# Result:
.-------------+-------.
| Subject | Score |
+-------------+-------+
| English | 78 |
| Mathematics | 91 |
| Chemistry | 64 |
| Physics | 95 |
+-------------+-------+
| Total | 328 |
'-------------+-------'
# DESCRIPTION
Text::UnicodeTable::Simple creates character table.
There are some modules for creating a text table at CPAN, [Text::ASCIITable](https://metacpan.org/pod/Text::ASCIITable),
[Text::SimpleTable](https://metacpan.org/pod/Text::SimpleTable), [Text::Table](https://metacpan.org/pod/Text::Table) etc. But those module deal with only ASCII,
don't deal with full width characters. If you use them with full width
characters, a table created may be bad-looking.
Text::UnicodeTable::Simple resolves problem of full width characters.
So you can use Japansese Hiragana, Katakana, Korean Hangeul, Chinese Kanji
characters. See `eg/` directory for examples.
# INTERFACE
## Methods
### new(%args)
Creates and returns a new table instance with _%args_.
_%args_ might be
- header :ArrayRef
Table header. If you set table header with constructor,
you can omit `set_header` method.
- border :Bool = True
Table has no border if `border` is False.
- ansi\_color :Bool = False
Ignore ANSI color escape sequence
- alignment :Int = 'left' or 'right'
Alignment for each columns. Every columns are aligned by this if you
specify this parameter.
### set\_header() \[alias: setCols \]
Set the headers for the table. (compare with in HTML).
You must call `set_header` firstly. If you call other methods
without calling `set_header`, then you fail.
Input strings should be **string**, not **octet stream**.
### add\_row(@list\_of\_columns | \\@list\_of\_columns) \[alias: addRow \]
Add one row to the table.
Input strings should be **string**, not **octet stream**.
### add\_rows(@list\_of\_columns)
Add rows to the table. You can add row at one time.
Each `@collists` element should be ArrayRef.
### add\_row\_line() \[alias: addRowLine \]
Add a line after the current row. If 'border' parameter is false,
add a new line.
### draw()
Return the table as string.
Text::UnicodeTable::Simple overload stringify operator,
so you can omit `->draw()` method.
# AUTHOR
Syohei YOSHIDA
# COPYRIGHT
Copyright 2011- Syohei YOSHIDA
# SEE ALSO
[Text::ASCIITable](https://metacpan.org/pod/Text::ASCIITable)
[Text::SimpleTable](https://metacpan.org/pod/Text::SimpleTable)
[Text::Table](https://metacpan.org/pod/Text::Table)
# LICENSE
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.