table_header - read the table header from a file.
SYNOPSYS
#include "table.h"
TableHead table_header(file, mode)
PARAMETERS
- File file
- file to read header from.
- int mode
- parse mode.
DESCRIPTION
table_header reads in a header from file and allocates the header data
structures. The mode parameter indicates how the table rows will be
treated in later operations. TAB_PARSE will cause table_row() to
trim extra spaces and record width and numeric precision of rows
as they are read. TAB_JUSTIFY will cause table_put() to output the
rows with column justifications.
- mode == 0
- the rows of a table will pass through a program
calling table_row() and table_put() without modification. This
is the behavoir of column with no argumants.
- mode == TAB_PARSE
- the rows of a table will pass through a
program calling table_row() and table_put()
with all extra spaces trimmed. This is the
behavoir ot trim with no arguments.
- mode == TAB_PARSE | TAB_JUSTIFY
- the rows of a table will pass
through a program calling table_row()
and table_put() with default
justifications. This is the behavoir
of justify with no arguments.
RETURNS
table_header returns a pointer to a table header data structure.