Function:     CFTSI_GETI

Purpose:      Gets integer data from a FITS tape.

Category:     FITS

File:         cfts_io.c

Author:       Do Kester

Use:          INTEGER CFTSI_GETI( MTID,          Input          INTEGER
                                  ARRAY,         Output         INTEGER
                                  ARRLEN,        Input          INTEGER
                                  TID )          Input/Output   INTEGER
              CFTSI_GETI Returns:
                          >0 - number of integers transferred to ARRAY.
                       =<-10 - tape error (see MTIODEV.DC2)
                         -11 - not a FITS file.
                         -12 - found and skipped tape label
                         -13 - double tape mark found, tape skipped back to
                               before second tape mark.
                         -20 - could not get enough memory for internal ftsbuf.
                         -22 - conversion error
                         -30 - Unknown mtid
                         -31 - Only forward skipping allowed.
              MTID      A device unit number as obtained from MTOPEN.
              ARRAY     Target array for the data.
              ARRLEN    Length of ARRAY
              TID       Tranfer ID from CFTSD_GETH.
                        If non zero on output more data is left on
                        tape, thus subsequent calls of CFTSI_GETI are
                        nessecary. TID=0 ends a series of calls.
                        TID=0 occurs at the end of file mark. After
                        TID=0 the tape is positioned befor end of file.

Description:

       CFTSI_GETI is functionally equivalent to FTSI_GETI, both for
       compressed as for normal fits files.


Updates:
	07 Mar 1991 DK document creation