Features:
- tree-like output (see lsblk(8) or findmnt(8))
- table-like output (see lslocks(8))
- formatting sensitive to terminal width
- fully supports UTF8 (correctly truncate data in cells, tree lines, ...)
- dynamic or fixed columns width
- truncate data in cell on demand
- raw (no formatting) output mode
- NAME=value output mode
- custom cells and lines delimiters (for example for CSV output)
- built-in ASCII, UTF8 or custom symbols to draw trees
- per column, line or cell colors
- colors specified by words (e.g. "red") or ESC sequences
- sort lines
- enable/disable heading
- output to FILE stream (default stdout), or to string
- all columns, lines and cells accessible by iterators (no callbacks)
- output data specified by strings (no crazy unions or to-string conversion functions in the library)
- reference counting
- integrated debug output (sensitive to LIBSMARTCOLS_DEBUG env)
- usable to keep parent<->child relationship
- library symbols versioning (no soname changes)
See bellow a trivial (so no errors handling, etc.) example.
int main(void)
{
struct libscols_table *tb;
struct libscols_line *ln, *dad, *gdad;
enum { COL_NAME, COL_AGE };
setlocale(LC_ALL, "");
tb = scols_new_table();
scols_table_new_column(tb, "NAME", 0.1, SCOLS_FL_TREE);
scols_table_new_column(tb, "AGE", 2, SCOLS_FL_RIGHT);
ln = gdad = scols_table_new_line(tb, NULL);
scols_line_set_data(ln, COL_NAME, "Grandfather Bob");
scols_line_set_data(ln, COL_AGE, "61");
ln = dad = scols_table_new_line(tb, ln);
scols_line_set_data(ln, COL_NAME, "Father Adam");
scols_line_set_data(ln, COL_AGE, "38");
ln = scols_table_new_line(tb, dad);
scols_line_set_data(ln, COL_NAME, "Baby Val");
scols_line_set_data(ln, COL_AGE, "9");
ln = scols_table_new_line(tb, dad);
scols_line_set_data(ln, COL_NAME, "Baby Dilbert");
scols_line_set_data(ln, COL_AGE, "5");
ln = scols_table_new_line(tb, gdad);
scols_line_set_data(ln, COL_NAME, "Aunt Gaga");
scols_line_set_data(ln, COL_AGE, "35");
scols_print_table(tb);
scols_unref_table(tb);
return 0;
}
... and output:
NAME AGE Grandfather Bob 61 ├─Father Adam 38 │ ├─Baby Val 9 │ └─Baby Dilbert 5 └─Aunt Gaga 35
