next up previous 231
Next: HDR_MOD- Open an image allowing modification of any header items
Up: HDR Fortran subroutines
Previous: HDR_DELET- Delete a header item


HDR_IN[x]- Read a header item

Description:
This subroutine returns the value of a header item.

The [x] part of the name is optional. If used [x] indicates the data type (one of R, D, I, L or C, the default is C) the item is to be returned in. So for instance if you want an item with type REAL, the subroutine that you should call is HDR_INR.


Invocation:
CALL HDR_IN[x]( PARAM, XNAME, ITEM, COMP, VALUE, STATUS )

Arguments:

PARAM = CHARACTER * ( * ) (Given)
Parameter name of the image (case insensitive).
XNAME = CHARACTER * ( * ) (Given)
Source of the header information ('FITS' or ' ' for FITS headers).
ITEM = CHARACTER * ( * ) (Given)
Name of the header item.
COMP = INTEGER (Given)
The component of a multiple FITS header item ('HISTORY' and 'COMMENT' items often have many occurrences). The number of occurrences may be queried using the HDR_NUMB subroutine.
VALUE = ? (Given and Returned)
The value. This is unmodified if the item doesn't exist.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:



next up previous 231
Next: HDR_MOD- Open an image allowing modification of any header items
Up: HDR Fortran subroutines
Previous: HDR_DELET- Delete a header item

IMG Simple Image Data Access
Starlink User Note 160
P.W. Draper
R.F. Warren-Smith
3 March 2003
E-mail:P.W.Draper@durham.ac.uk

Copyright © 2000-2003 Council for the Central Laboratory of the Research Councils