next up previous 231
Next: HDR_OUT[x]- Write a header item
Up: HDR Fortran subroutines
Previous: HDR_NAME- Return a header item name


HDR_NUMB- Return a header item count

Description:
This subroutine returns the number of header items or the number of occurrences of a specific item. The numbers returned can be used as limits when indexing using HDR_NAME or when deleting/reading items with more than one occurrence (such as FITS 'HISTORY' or 'COMMENTS') or to test the existence of an item.

Invocation:
CALL HDR_NUMB( PARAM, XNAME, ITEM, N, 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)
The name of an item or '*'. If this is '*' then a count of all the items is returned, otherwise the number of occurrences of the named item is returned.
N = INTEGER (Returned)
The number of header items or occurrences of an item.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:



next up previous 231
Next: HDR_OUT[x]- Write a header item
Up: HDR Fortran subroutines
Previous: HDR_NAME- Return a header item name

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