2 * ASCII table generator.
3 * Copyright (C) 2017 Cumulus Networks
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License as published by the Free
8 * Software Foundation; either version 2 of the License, or (at your option)
11 * This program is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
16 * You should have received a copy of the GNU General Public License along
17 * with this program; see the file COPYING; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
36 struct ttable_border
{
48 /* cell style and cell */
49 struct ttable_cellstyle
{
52 enum ttable_align align
;
53 struct ttable_border border
;
58 struct ttable_cellstyle style
;
61 /* table style and table */
63 char corner
; /* intersection */
64 int indent
; /* left table indent */
65 bool rownums_on
; /* show row numbers; unimplemented */
67 struct ttable_border border
;
68 struct ttable_cellstyle cell
;
72 int nrows
; /* number of rows */
73 int ncols
; /* number of cols */
74 struct ttable_cell
**table
; /* table, row x col */
75 size_t size
; /* size */
76 struct ttable_style style
; /* style */
79 /* some predefined styles */
80 #define TTSTYLE_ASCII 0
81 #define TTSTYLE_BLANK 1
83 extern const struct ttable_style ttable_styles
[2];
86 * Creates a new table with the default style, which looks like this:
88 * +----------+----------+
89 * | column 1 | column 2 |
90 * +----------+----------+
91 * | data... | data!! |
92 * +----------+----------+
94 * +----------+----------+
96 * @return the created table
98 struct ttable
*ttable_new(const struct ttable_style
*tts
);
101 * Deletes a table and releases all associated resources.
103 * @param tt the table to destroy
105 void ttable_del(struct ttable
*tt
);
108 * Inserts a new row at the given index.
110 * The row contents are determined by a format string. The format string has
111 * the same form as a regular printf format string, except that columns are
112 * delimited by '|'. For example, to make the first column of the table above,
115 * ttable_insert_row(<tt>, <n>, "%s|%s", "column 1", "column 2");
117 * All features of printf format strings are permissible here.
120 * - At present you cannot insert '|' into a cell's contents.
121 * - If there are N columns, '|' must appear n-1 times or the row will not be
124 * @param tt table to insert row into
125 * @param row the row number (begins at 0)
126 * @param format column-separated format string
127 * @param ... arguments to format string
129 * @return pointer to the first cell in the created row, or NULL if not enough
130 * columns were specified
132 struct ttable_cell
*ttable_insert_row(struct ttable
*tt
, unsigned int row
,
133 const char *format
, ...) PRINTFRR(3, 4);
135 * Inserts a new row at the end of the table.
137 * The row contents are determined by a format string. The format string has
138 * the same form as a regular printf format string, except that columns are
139 * delimited by '|'. For example, to make the first column of the table above,
142 * ttable_add_row(<tt>, "%s|%s", "column 1", "column 2");
144 * All features of printf format strings are permissible here.
147 * - At present you cannot insert '|' into a cell's contents.
148 * - If there are N columns, '|' must appear n-1 times or the row will not be
151 * @param tt table to insert row into
152 * @param format column-separated format string
153 * @param ... arguments to format string
155 * @return pointer to the first cell in the created row, or NULL if not enough
156 * columns were specified
158 struct ttable_cell
*ttable_add_row(struct ttable
*tt
, const char *format
, ...)
162 * Removes a row from the table.
164 * @param tt table to delete row from
165 * @param row the row number (begins at 0)
167 void ttable_del_row(struct ttable
*tt
, unsigned int row
);
170 * Sets alignment for a range of cells.
172 * Available alignments are LEFT and RIGHT. Cell contents will be aligned
173 * accordingly, while respecting padding (if any). Suppose a cell has:
180 * The cell would look like:
182 * +-------------------+
184 * +-------------------+
193 * +-------------------+
195 * +-------------------+
197 * The default alignment is LEFT.
199 * @param tt the table to set alignment on
200 * @param srow starting row index
201 * @param scol starting column index
202 * @param nrow # rows to align
203 * @param ncol # cols to align
204 * @param align the alignment to set
206 void ttable_align(struct ttable
*tt
, unsigned int srow
, unsigned int scol
,
207 unsigned int erow
, unsigned int ecol
,
208 enum ttable_align align
);
211 * Sets padding for a range of cells.
213 * Available padding options are LEFT and RIGHT (the alignment enum is reused).
214 * Both options may be set. Padding is treated as though it is stuck to the
215 * walls of the cell. Suppose a cell has:
222 * The cell padding, marked by '.', would look like:
228 * If the column is wider than the cell, the cell contents are aligned in an
229 * additional padded field according to the cell alignment.
231 * +--------------------+
232 * | Data!!!11!~~~~~:-) |
233 * +--------------------+
235 * +--------------------+
237 * @param tt the table to set padding on
238 * @param srow starting row index
239 * @param scol starting column index
240 * @param nrow # rows to pad
241 * @param ncol # cols to pad
242 * @param align LEFT or RIGHT
243 * @param pad # spaces to pad with
245 void ttable_pad(struct ttable
*tt
, unsigned int srow
, unsigned int scol
,
246 unsigned int nrow
, unsigned int ncol
, enum ttable_align align
,
250 * Restyle all cells according to table.cell.style.
252 * @param tt table to restyle
254 void ttable_restyle(struct ttable
*tt
);
257 * Turn left/right column separators on or off for specified column.
260 * @param col column index
261 * @param align left or right separators
262 * @param on true/false for on/off
263 * @param sep character to use
265 void ttable_colseps(struct ttable
*tt
, unsigned int col
,
266 enum ttable_align align
, bool on
, char sep
);
269 * Turn bottom row separators on or off for specified row.
272 * @param row row index
273 * @param align left or right separators
274 * @param on true/false for on/off
275 * @param sep character to use
277 void ttable_rowseps(struct ttable
*tt
, unsigned int row
,
278 enum ttable_align align
, bool on
, char sep
);
281 * Dumps a table to a heap-allocated string.
283 * Caller must free this string after use with
285 * XFREE (MTYPE_TMP, str);
287 * @param tt the table to dump
288 * @param newline the desired newline sequence to use, null terminated.
289 * @return table in text form
291 char *ttable_dump(struct ttable
*tt
, const char *newline
);
297 #endif /* _TERMTABLE_H */