FITSIO Home
Next: Read and Write Column
Up: ASCII and Binary Table
Previous: Column Information Routines
  Contents
- 1
- Insert or delete rows in an ASCII or binary table. When inserting rows
all the rows following row FROW are shifted down by NROWS rows and if
FROW = 0 then the blank rows are inserted at the beginning of the
table. The first delete routine deletes nrows consecutive rows, whereas
the second delete routine deletes a specified list of row number, where
the list must be sorted in ascending order.
These routines update the NAXIS2 keyword to reflect the new
number of rows in the table.
int fits_insert_rows / ffirow
(fitsfile *fptr, long firstrow, long nrows, > int *status)
int fits_delete_rows / ffdrow
(fitsfile *fptr, long firstrow, long nrows, > int *status)
int fits_delete_rowlist / ffdrws
(fitsfile *fptr, long *rowlist, long nrows, > int *status)
- 2
- Insert or delete column(s) in an ASCII or binary
table. When inserting, COLNUM specifies the column number that the
(first) new column should occupy in the table. NCOLS specifies how
many columns are to be inserted. Any existing columns from this
position and higher are shifted over to allow room for the new
column(s). The index number on all the following keywords will be
incremented or decremented if necessary to reflect the new position
of the column(s) in the table: TBCOLn, TFORMn, TTYPEn, TUNITn,
TNULLn, TSCALn, TZEROn, TDISPn, TDIMn, TLMINn, TLMAXn, TDMINn,
TDMAXn, TCTYPn, TCRPXn, TCRVLn, TCDLTn, TCROTn,
and TCUNIn.
int fits_insert_col / fficol
(fitsfile *fptr, int colnum, char *ttype, char *tform,
> int *status)
int fits_insert_cols / fficls
(fitsfile *fptr, int colnum, int ncols, char **ttype,
char **tform, > int *status)
int fits_delete_col / ffdcol(fitsfile *fptr, int colnum, > int *status)
- 3
- Copy a column from one HDU to another (or to the same HDU). If
create_col = TRUE, then a new column will be inserted in the output
table, at position `outcolumn', otherwise the existing output column will
be overwritten (in which case it must have a compatible datatype).
Note that the first column in a table is at colnum = 1.
int fits_copy_col / ffcpcl
(fitsfile *infptr, fitsfile *outfptr, int incolnum, int outcolnum,
int create_col, > int *status);
- 4
- Modify the vector length of a binary table column (e.g.,
change a column from TFORMn = '1E' to '20E'). The vector
length may be increased or decreased from the current value.
int fits_modify_vector_len / ffmvec
(fitsfile *fptr, int colnum, long newveclen, > int *status)
FITSIO Home
Next: Read and Write Column
Up: ASCII and Binary Table
Previous: Column Information Routines
  Contents