SUBROUTINE ADI2_UNMAPCOL( HDUID, BCOL, TYPE, MODE, PTR, STATUS )
*+
* Name:
* ADI2_UNMAPCOL
* Purpose:
* Unmap the BINTABLE column with specified type and mode
* Language:
* Starlink Fortran
* Invocation:
* CALL ADI2_UNMAPCOL( HDUID, BCOL, TYPE, MODE, PTR, STATUS )
* Description:
* {routine_description}
* Arguments:
* HDUID = INTEGER (given)
* ADI identifier of FITShdu object
* BCOL = INTEGER (given)
* Binary column number holding data
* TYPE = CHARACTER*(*) (given)
* Type for mapping
* MODE = CHARACTER*(*) (given)
* Mapping access mode
* PTR = INTEGER (given)
* The mapped memory address
* STATUS = INTEGER (given and returned)
* The global status.
* Examples:
* {routine_example_text}
* {routine_example_description}
* Pitfalls:
* {pitfall_description}...
* Notes:
* {routine_notes}...
* Prior Requirements:
* {routine_prior_requirements}...
* Side Effects:
* {routine_side_effects}...
* Algorithm:
* {algorithm_description}...
* Accuracy:
* {routine_accuracy}
* Timing:
* {routine_timing}
* External Routines Used:
* {name_of_facility_or_package}:
* {routine_used}...
* Implementation Deficiencies:
* {routine_deficiencies}...
* References:
* ADI Subroutine Guide : http://www.sr.bham.ac.uk/asterix-docs/Programmer/Guides/adi.html
* Keywords:
* package:adi, usage:private
* Copyright:
* Copyright (C) University of Birmingham, 1995
* Authors:
* DJA: David J. Allan (Jet-X, University of Birmingham)
* {enter_new_authors_here}
* History:
* 11 Sep 1995 (DJA):
* Original version.
* {enter_changes_here}
* Bugs:
* {note_any_bugs_here}
*-
* Type Definitions:
IMPLICIT NONE ! No implicit typing
* Global Constants:
INCLUDE 'SAE_PAR' ! Standard SAE constants
INCLUDE 'PRM_PAR'
* Arguments Given:
INTEGER HDUID, BCOL, PTR
CHARACTER*(*) TYPE, MODE
* Status:
INTEGER STATUS ! Global status
* Local Variables:
INTEGER DIM ! # data elements
INTEGER FSTAT ! FITSIO status code
INTEGER LUN ! Logical i/o unit
LOGICAL ANYF ! Any null values?
*.
* Check inherited global status.
IF ( STATUS .NE. SAI__OK ) RETURN
* Get number of rows in table
CALL ADI2_HGKYI( HDUID, 'NAXIS2', DIM, STATUS )
* Locate logical unit
CALL ADI2_HDULUN( HDUID, LUN, STATUS )
* Write column data back to file
IF ( MODE .NE. 'READ' ) THEN
FSTAT = 0
IF ( TYPE .EQ. 'BYTE' ) THEN
CALL FTGCVB( LUN, BCOL, 1, 1, DIM, VAL__BADB, %VAL(PTR), ANYF,
: FSTAT )
ELSE IF ( TYPE .EQ. 'WORD' ) THEN
CALL FTGCVI( LUN, BCOL, 1, 1, DIM, VAL__BADW, %VAL(PTR), ANYF,
: FSTAT )
ELSE IF ( TYPE .EQ. 'INTEGER' ) THEN
CALL FTGCVJ( LUN, BCOL, 1, 1, DIM, VAL__BADI, %VAL(PTR), ANYF,
: FSTAT )
ELSE IF ( TYPE .EQ. 'REAL' ) THEN
CALL FTGCVE( LUN, BCOL, 1, 1, DIM, VAL__BADR, %VAL(PTR), ANYF,
: FSTAT )
ELSE IF ( TYPE .EQ. 'DOUBLE' ) THEN
CALL FTGCVD( LUN, BCOL, 1, 1, DIM, VAL__BADD, %VAL(PTR), ANYF,
: FSTAT )
ELSE IF ( TYPE .EQ. 'LOGICAL' ) THEN
CALL FTGCL( LUN, BCOL, 1, 1, DIM, %VAL(PTR), FSTAT )
END IF
END IF
* Release the mapped data
CALL DYN_UNMAP( PTR, STATUS )
* Report any errors
IF ( STATUS .NE. SAI__OK ) THEN
CALL AST_REXIT( 'ADI2_UNMAPCOL', STATUS )
END IF
END