Routines to Edit Rows or Columns

1

Insert blank rows into an ASCII or binary table. All the rows following row FROW are shifted down by NROWS rows. If FROW = 0 then the blank rows are inserted at the beginning of the table. This routine updates 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)

2

Delete rows from an ASCII or binary table (in the CDU). The NROWS number of rows are deleted, starting with row FROW. Any remaining rows in the table are shifted up to fill in the space. This routine modifies the NAXIS2 keyword to reflect the new number of rows in the table. The physical size of the FITS file may not be reduced by this operation, in which case the empty FITS blocks if anyat the end of the file will be padded with zeros.  

  int fits_delete_rows / ffdrow
      (fitsfile *fptr, long firstrow, long nrows, > int *status)

3

Delete a list of rows from an ASCII or binary table (in the CDU). rowlist is an array of row numbers to be deleted from the table. (The first row in the table is 1 not 0). The list of row numbers must be sorted in ascending order. nrows is the number of row numbers in the list. The physical size of the FITS file may not be reduced by this operation, in which case the empty FITS blocks if any at the end of the file will be padded with zeros.  

  int fits_delete_rowlist / ffdrws
      (fitsfile *fptr, long *rowlist, long nrows, > int *status)

4

Insert a blank column (or columns) into an ASCII or binary table. 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 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)

5

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)

6

Delete a column from an ASCII or binary table (in the CDU). The index number of all the keywords listed above will be decremented if necessary to reflect the new position of the column(s) in the table. The physical size of the FITS file may not be reduced by this operation, and the empty FITS blocks if any at the end of the file will be padded with zeros.  

  int fits_delete_col / ffdcol(fitsfile *fptr, int colnum, > int *status)

7

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);