NCEPLIBS-bufr  12.1.0
bufrlib::srchtbf_c Interface Reference

Public Member Functions

subroutine srchtbf_c (ifxyi, ivali, ifxyd, mxfxyd, ivald, meaning, mxmng, lnmng, iret)
 Search for a specified master Code/Flag table entry. More...
 

Detailed Description

Definition at line 287 of file bufrlib.F90.

Constructor & Destructor Documentation

◆ srchtbf_c()

bufrlib::srchtbf_c::srchtbf_c ( integer(c_int), intent(in), value  ifxyi,
integer(c_int), intent(in), value  ivali,
integer(c_int), intent(inout)  ifxyd,
integer(c_int), intent(in), value  mxfxyd,
integer(c_int), intent(in), value  ivald,
character(kind=c_char), dimension(*), intent(out)  meaning,
integer(c_int), intent(in), value  mxmng,
integer(c_int), intent(out)  lnmng,
integer(c_int), intent(out)  iret 
)

Search for a specified master Code/Flag table entry.

Wraps srchtbf() function.

Parameters
ifxyi- WMO bit-wise representation of FXY number to search for.
ivali- Value (code figure or bit number) associated with ifxyi.
ifxyd- Dependence indicator:
  • On input, ifxyd[0] is set to the WMO bit-wise representation of the FXY number upon which ifxyi and ivali depend, or else set to (-1) if ifxyi and ivali do not depend on the value associated with any other FXY number.
  • On output, if the initial search of the master Code/Flag table was unsuccessful, and if ifxyd[0] and ivald were both set to (-1) on input, and if a second search of the table determines that the meaning of ifxyi and ivali indeed depends on one or more other FXY numbers, then the WMO bit-wise representations of those FXY numbers are returned within the first iret elements of ifxyd.
ivald- Value (code figure or bit number) associated with the FXY number in ifxyd[0]; set to (-1) whenever ifxyd[0] is also set to (-1).
mxfxyd- Number of elements in ifxyd array; used by the function to ensure that it doesn't overflow the array.
mxmng- Number of elements in meaning array; used by the function to ensure that it doesn't overflow the string.
meaning- Meaning corresponding to ifxyi and ivali (and to ifxyd[0] and ivald, if specified on input).
lnmng- Length (in bytes) of string returned in CMEANG.
iret- Return code:
  • 0 = Meaning found and stored in meaning string.
  • -1 = Meaning not found.
  • >0 = Meaning not found, and ifxyd[0] and ivald were both set to (-1) on input, and the meaning of ifxyi and ivali depends on the the value associated with one of the FXY numbers whose WMO bit-wise representation is stored in the first iret elements of ifxyd.
Author
J. Ator
Date
2017-11-03

Definition at line 287 of file bufrlib.F90.


The documentation for this interface was generated from the following file: