starbase

table_header - read the table header from a file.

SYNOPSIS

#include <../tablelib/table.h>

 TableHead table_header(File file, int 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. SEE ALSO ——– table_colval , table_colvals , table_colvali , table_colvald , table_rowloc , table_parsline , table_colpad , table_coladd , table_colarg , table_colnum , table_colnam , table_hdrfree , table_hdrnth , table_rowfree , table_rowput , table_hdrput , table_rowget , table_rowtrim , table_hdrget , table_hdrgetn , table_hdrgeti , table_hdrgetd , table_hdrgets , table_hdrfind , table_extract , table_load , table_loadva , table_mode , table_ncol , table_ofs , table_ors