NCEPLIBS-bufr  11.7.0
 All Data Structures Files Functions Variables Pages
ireadns.f File Reference

Read the next data subset from a BUFR file that was previously opened for reading. More...

Go to the source code of this file.

Functions/Subroutines

function ireadns (LUNIT, SUBSET, IDATE)
 This function calls BUFRLIB subroutine readns() and passes back its return code as the function value. More...
 

Detailed Description

Read the next data subset from a BUFR file that was previously opened for reading.

Definition in file ireadns.f.

Function/Subroutine Documentation

function ireadns (   LUNIT,
character*8  SUBSET,
  IDATE 
)

This function calls BUFRLIB subroutine readns() and passes back its return code as the function value.

Author
J. Woollen
Date
1994-01-06
Parameters
[in]LUNIT– integer: Fortran logical unit number for BUFR file
[out]SUBSET– character*8: Table A mnemonic for type of data subset that was read (see DX BUFR Tables for further information about Table A mnemonics)
[out]IDATE– integer: Date-time stored within Section 1 of BUFR message containing data subset that was read, in format of either YYMMDDHH or YYYYMMDDHH, depending on the most recent call to subroutine datelen()
Returns
ireadns – integer:
  • 0 = new BUFR data subset was successfully read into internal arrays
  • -1 = there are no more BUFR data subsets in the file connected to logical unit LUNIT
Remarks
  • The use of this function allows the return code from readns() to be used as the target variable within an iterative program loop.

Program history log:

Date Programmer Comments
1994-01-06 J. Woollen Original author
2002-05-14 J. Woollen Changed from an entry point to increase portability to other platforms

Definition at line 38 of file ireadns.f.

References readns().