Function:     FTSD_RCHAR

Purpose:      Reads a FITS character descriptor from a FITS header.

Category:     FITS

File:         ftsd_access.c

Author:       K.G. Begeman

Use:          INTEGER FTSD_RCHAR( HEADER,      Input     CHARACTER*(*)
                                  DESCRIPTOR,  Input     CHARACTER*(*)
                                  VALUE )      Output    CHARACTER*(*)

              FTSD_RCHAR    Returns:
                             >=0 : Offset of record in header
                             -1	 : FITS descriptor not present
                             -2	 : descriptor does not carry info
                             -3	 : conversion error
              HEADER        Contains FITS records where to look
                            for the descriptor.
              DESCRIPTOR    FITS descriptor to search for in HEADER.
              VALUE         If present, the contents of the FITS record
                            associated with DESCRIPTOR is returned.

Updates:
	Jun 25, 1990: KGB, Document created.
	Aug  7, 1990: Sjag; Max. 68 char's in value field (see Wells).
        Aug 14, 1990: Sjag; Offset of record is returned.
        Dec 19, 1991: KGB, SS bug removed, work around gcc bug.
        Oct  8, 2001: JPT, Allow free format character strings.