NCEPLIBS-bufr
11.5.0
|
Read the next message from a BUFR file that was previously opened for reading. More...
Go to the source code of this file.
Functions/Subroutines | |
subroutine | readmg (LUNXX, SUBSET, JDATE, IRET) |
This subroutine reads the next BUFR message from logical unit ABS(LUNXX) into internal arrays. More... | |
Read the next message from a BUFR file that was previously opened for reading.
Definition in file readmg.f.
subroutine readmg | ( | LUNXX, | |
character*8 | SUBSET, | ||
JDATE, | |||
IRET | |||
) |
This subroutine reads the next BUFR message from logical unit ABS(LUNXX) into internal arrays.
Logical unit ABS(LUNXX) should have already been opened for input operations via a previous call to subroutine openbf().
[in] | LUNXX | - integer: Absolute value is Fortran logical unit number for BUFR file |
[out] | SUBSET | - character*8: Table A mnemonic for type of BUFR message that was read (see DX BUFR Tables for further information about Table A mnemonics) |
[out] | JDATE | - integer: Date-time stored within Section 1 of BUFR message that was read, in format of either YYMMDDHH or YYYYMMDDHH, depending on the most recent call to subroutine datelen() |
[out] | IRET | - integer: return code
|
Whenever this subroutine returns with IRET = 0, this indicates that a new BUFR message of type SUBSET and date-time JDATE was successfully read into internal arrays within the BUFRLIB software, and from where it can then be easily manipulated or further parsed via a call to one of the subset-reading subroutines. Otherwise, if the subroutine returns with IRET = -1, then this indicates that there are no more BUFR messages (i.e. end-of-file) within the file connected to logical unit ABS(LUNXX).
Program history log:
Definition at line 99 of file readmg.f.
References backbufr(), bort(), cktaba(), errwrt(), idxmsg(), rdbfdx(), rdmsgw(), reads3(), status(), and wtstat().
Referenced by ireadmg(), rdmgsb(), readns(), rewnbf(), ufbinx(), and ufbpos().