headline - print the column headline of a starbase data table.
SYNOPSYS
headline [-i input] [-o output] [column]
OPTIONS
Program Options
- -a
- Output all the columns in the table. This is useful when adding
columns to a table.
- -b
- Print only the body (rows) of the table.
- -hv
- Print out only the header values.
- -hV
- Print out only the header values as a value table.
- -hl
- Print out only the headline.
- -hd
- Print out only the dashline.
- -i file
- Read input from file instead of the standard input. This
option is supplied specifically to avoid the use of the
standard input within the IRAF cl. Other users may use it
if they like.
- -k
- Check the validity of the input table. Exit with status is 1 if the
table is not ok.
- -o file
- Write output to file instead of the standard input.
- -t template
- Only the tables whose table names (first line in the table
header) match template are output. Care should be taken with
this option, unnamed tables are skipped. This is the primary
mechanism for selecting a table from a multi-table file.
- -u
- Read the standard input in unbuffered mode. This is a very useful
option for taking the header part off of a starbase table and passing
the rest to another unix program filter. See the source of headtable
as an example.
- -v
- Verbose error checking. Print messages about offending rows to the
standard output. If check is being run the entire table is checked.
If only -k is specified the program exits when it finds the first
error.
- -2
- Print each row in the table twice. This option is useful with
sortable to eliminate or select duplicate rows. This is the
underlying mechanism of diffrtable and intertable.
- column=newcol
- rename a column. Columns may be renamed by any of the column
programs. Before the rename option the column must be referenced
by its old name, after by its new one. Renaming a column does
not select it for output.
Justification Options
The use of any justification flags implies that all the columns will be
justified. If a justification type is not given for a column with the a flag
or sticky option that column will be default justified. The default
justification is left for strings and right for numbers. Justification flags
that are given as options are sticky and effect all the following columns
until additional flags are given. Flags may also be suffixed to the column
names to change the justification of a particular column. A justification
flag on a column is indicated by a ":". The output width of a column may be
appended to a column name with a ".".
- -d
- Justify the column with its default justification. Numeric values are
right justified and text is left justified.
- -l
- Left justify.
- -c
- Center justify.
- -r
- Right justify.
- -e
- Expand the column.
- -w width
- Set the output column width. Care should be taken with
the width option, data column will be truncated if they are
width than the width specification.
- -x
- Delete the column.
- -p
- Pass the column through with no justification.
SEE ALSO
- column
- project columns from a starbase data table.
- project
- project columns from a starbase data table.
- justify
- justify columns of a starbase data table.
- trim
- trim columns of an starbase data table.
- check
- check the format of a starbase data table.
- header
- print the header of a table file.
- headoff
- print the body (data rows) of a starbase data table file wo/ the header.
- headline
- print the column headline of a starbase data table.
- dashline
- print the dashline from a starbase data table.
- starbase.1
- starbase data tables introduction.
- starbase.3
- starbase data table C library.
- starbase.5
- starbase data table file format.