NCEPLIBS-bufr  12.0.0
readsb.f File Reference

Read the next data subset from a BUFR message. More...

Go to the source code of this file.

Functions/Subroutines

recursive subroutine readsb (LUNIT, IRET)
 Read the next data subset from a BUFR message. More...
 

Detailed Description

Read the next data subset from a BUFR message.

Author
J. Woollen
Date
1994-01-06

Definition in file readsb.f.

Function/Subroutine Documentation

◆ readsb()

recursive subroutine readsb (   LUNIT,
  IRET 
)

Read the next data subset from a BUFR message.

Logical unit LUNIT should have already been opened for input operations via a previous call to subroutine openbf(), and a BUFR message should have already been read into internal arrays via a previous call to one of the message-reading subroutines.

Whenever this subroutine returns with IRET = 0, this indicates that a new BUFR data subset (i.e. report) was successfully read into internal arrays within the BUFRLIB software, and from where it can be manipulated or further parsed via calls to any of the values-reading subroutines".

If the subroutine returns with IRET = -1 there are no more data subsets available within the current message; a new call needs to be made to one of the [message-reading subroutines](hierarchy) in order to read in the next message from logical unit LUNIT.

Parameters
[in]LUNIT- integer: Fortran logical unit number for BUFR file.
[out]IRET- integer: return code:
  • 0 new BUFR data subset was successfully read into internal arrays.
  • -1 there are no more BUFR data subsets in the BUFR message.
Author
J. Woollen
Date
1994-01-06

Definition at line 32 of file readsb.f.

References bort(), moda_bitbuf::ibit, modv_im8b::im8b, moda_stcode::iscodes, moda_bitmaps::linbtm, moda_bitmaps::lstnod, moda_bitmaps::lstnodct, moda_bitbuf::mbay, moda_bitbuf::mbyt, moda_unptyp::msgunp, moda_msgcwd::msub, moda_bitmaps::nbtm, moda_msgcwd::nsub, rdcmps(), rdtree(), status(), upb(), x48(), and x84().

Referenced by cmpbqm(), copysb(), ireadsb(), rdmems(), rdmgsb(), readns(), ufbinx(), and ufbpos().