NCEPLIBS-bufr  12.0.0
setbmiss.f File Reference

Define a customized placeholder value for "missing" data. More...

Go to the source code of this file.

Functions/Subroutines

recursive subroutine setbmiss (XMISS)
 This subroutine allows the user to specify a customized value to represent "missing" data when reading from or writing to BUFR files. More...
 

Detailed Description

Define a customized placeholder value for "missing" data.

Author
J. Woollen
Date
2012-09-15

Definition in file setbmiss.f.

Function/Subroutine Documentation

◆ setbmiss()

recursive subroutine setbmiss ( real*8  XMISS)

This subroutine allows the user to specify a customized value to represent "missing" data when reading from or writing to BUFR files.

This subroutine can be called at any time from within an application program, and the value XMISS will then be treated as "missing" when reading or writing BUFR data during all future calls to any of the other BUFRLIB values-reading subroutines or values-writing subroutines. Otherwise, if this subroutine is never called, a default placeholder value of 10E10_8 is used for "missing".

Any data value can always be checked for equivalence to the current "missing" value via a call to function ibfms(). See also function getbmiss().

Remarks
  • The value XMISS is never actually encoded within a BUFR data subset; rather, XMISS is a user-friendly placeholder value to represent "missing" data values within the scope of the application program. In any actual BUFR data subset, "missing" values are always encoded as all bits set to 1, per WMO regulations.
Parameters
[in]XMISS– real*8: New placeholder value to represent "missing" data
Author
J. Woollen
Date
2012-09-15

Definition at line 34 of file setbmiss.f.

References modv_bmiss::bmiss, modv_im8b::im8b, and openbf().