ireadns.f

Go to the documentation of this file.

C> @file
C> @brief Read the next data subset from a BUFR file that was
C> previously opened for reading.
C>
C> @author J. Woollen @date 1994-01-06
 
C> Read the next data subset from a BUFR file that was
C> previously opened for reading.
C>
C> This function calls BUFRLIB subroutine readns() and passes
C> back its return code as the function value.
C>
C> The use of this function allows the return code from readns() to be
C> used as the target variable within an iterative program loop.
C>
C> @param[in] LUNIT - integer: Fortran logical unit number for
C> BUFR file.
C> @param[out] SUBSET - character*8: Table A mnemonic for type of
C> data subset that was read (see [DX BUFR Tables](@ref dfbftab) for
C> further information about Table A mnemonics).
C> @param[out] IDATE - integer: Date-time stored within Section 1 of
C> BUFR message containing data subset that was read, in format of
C> either YYMMDDHH or YYYYMMDDHH, depending on the most
C> recent call to subroutine datelen().
C> @returns ireadns - integer:
C> - 0 = new BUFR data subset was successfully read into internal arrays
C> - -1 = there are no more BUFR data subsets in the file connected to
C> logical unit LUNIT
C>
C> @author J. Woollen @date 1994-01-06
      RECURSIVE FUNCTION ireadns(LUNIT,SUBSET,IDATE) RESULT(IRET)
 
      USE modv_im8b
 
      CHARACTER*8 subset
 
C-----------------------------------------------------------------------
C-----------------------------------------------------------------------
 
C     Check for I8 integers.
 
      IF(im8b) THEN
         im8b=.false.
 
         CALL x84(lunit,my_lunit,1)
         iret=ireadns(my_lunit,subset,idate)
         CALL x48(idate,idate,1)
 
         im8b=.true.
         RETURN
      ENDIF
 
      CALL readns(lunit,subset,idate,iret)
 
      RETURN
      END