NCEPLIBS-bufr 11.7.1
setbmiss.f File Reference

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

Go to the source code of this file.

Functions/Subroutines

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.

Definition in file setbmiss.f.

Function/Subroutine Documentation

◆ setbmiss()

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.

Author
J. Woollen
Date
2012-09-15
Parameters
[in]XMISS– real*8: New placeholder value to represent "missing" data

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.

Program history log:

Date Programmer Comments
2012-09-15 J. Woollen Original author

Definition at line 39 of file setbmiss.f.

References modv_bmiss::bmiss, and openbf().