Procedure

     DAFRCR ( DAF, read character record )

     SUBROUTINE DAFRCR ( HANDLE, RECNO, CREC )

Abstract

     Read the contents of a character record from a DAF.

Required_Reading

     DAF

Keywords

     FILES

Declarations

     IMPLICIT NONE

     INTEGER               HANDLE
     INTEGER               RECNO
     CHARACTER*(*)         CREC

Brief_I/O

     VARIABLE  I/O  DESCRIPTION
     --------  ---  --------------------------------------------------
     HANDLE     I   Handle of DAF.
     RECNO      I   Record number of character record.
     CREC       O   Character record.

Detailed_Input

     HANDLE   is the handle associated with a DAF.

     RECNO    is the record number of a character record within
              the file.

Detailed_Output

     CREC     contains the first 1000 characters of the specified
              record from the specified file.

Parameters

     None.

Exceptions

     1)  If the declared length of CREC is not 1000 characters,
         the error SPICE(DAFBADRECLEN) is signaled.

     2)  If the specified record cannot (for some reason) be read,
         the error SPICE(DAFCRNOTFOUND) is signaled.

Files

     None.

Particulars

     Unlike double precision records, character records are
     not buffered. Also, while failing to find a specific double
     precision record is indicated through the calling sequence,
     failing to find a character record results in an error.

Examples

     In the following example, matching summary and name records are
     read from a DAF:

        CALL DAFGDR ( HANDLE, NEXT,   DREC, FOUND )
        CALL DAFRCR ( HANDLE, NEXT+1, CREC        )

     Note that a character record always immediately follows a summary
     record.

Restrictions

     1)  This routine is only used to read records on environments
         whose characters are a single byte in size. Updates
         to this routine and routines in its call tree may be
         required to properly handle other cases.

Literature_References

     None.

Author_and_Institution

     J. Diaz del Rio    (ODC Space)
     H.A. Neilan        (JPL)
     W.L. Taber         (JPL)
     F.S. Turner        (JPL)
     I.M. Underwood     (JPL)

Version

    SPICELIB Version 2.1.0, 17-JUN-2021 (JDR)

        Added IMPLICIT NONE statement.

        Edited the header to comply with NAIF standard. Moved DAF
        required reading from $Literature_References to
        $Required_Reading section.

    SPICELIB Version 2.0.0, 16-NOV-2001 (FST)

        Updated this routine to make proper use of the new
        handle manager functionality installed underneath
        DAF.

    SPICELIB Version 1.0.2, 10-MAR-1992 (WLT)

        Comment section for permuted index source lines was added
        following the header.

    SPICELIB Version 1.0.1, 22-MAR-1990 (HAN)

        Literature references added to the header.

    SPICELIB Version 1.0.0, 31-JAN-1990 (IMU)