table_header - read the table header from a file.

SYNOPSIS

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

 TableHead table_header(File file, int mode);
 

• File file - file to read header from.
• int mode - parse mode.

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.

table_header returns a pointer to a table header data structure.

SEE ALSO

table_colval , table_colvals , table_colvali , table_colvald , table_search , table_srange , table_svalue , 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_hdrval , table_hdrvaln , table_hdrvali , table_hdrvald , table_hdrvals , table_hdrfind , table_extract , table_load , table_loadva , table_mode , table_ncol , table_ofs , table_ors

[Previous] [Next] [Up] [Top] [Edit]