NCEPLIBS-bufr  11.5.0
 All Data Structures Files Functions Variables Pages
gettagre.f File Reference

Check whether a Table B mnemonic references another Table B mnemonic via an internal bitmap. More...

Go to the source code of this file.

Functions/Subroutines

subroutine gettagre (LUNIT, TAGI, NTAGI, TAGRE, NTAGRE, IRET)
 This subroutine determines whether a specified Table B mnemonic references another Table B mnemonic within the same data subset via an internal bitmap, and if so returns the referenced mnemonic and its location within the subset. More...
 

Detailed Description

Check whether a Table B mnemonic references another Table B mnemonic via an internal bitmap.

Definition in file gettagre.f.

Function/Subroutine Documentation

subroutine gettagre (   LUNIT,
character*(*)  TAGI,
  NTAGI,
character*(*)  TAGRE,
  NTAGRE,
  IRET 
)

This subroutine determines whether a specified Table B mnemonic references another Table B mnemonic within the same data subset via an internal bitmap, and if so returns the referenced mnemonic and its location within the subset.

Author
J. Ator
Date
2016-06-07
Parameters
[in]LUNIT- integer: Fortran logical unit number for BUFR file
[in]TAGI- character*(*): Table B mnemonic
[in]NTAGI- integer: Ordinal occurrence of TAGI for which TAGRE is to be returned, counting from the beginning of the overall subset definition
[out]TAGRE- character*(*): Table B mnemonic referenced by TAGI via an internal bitmap
[out]NTAGRE- integer: Ordinal occurrence of TAGRE referenced by (NTAGI)th occurrence of TAGI, counting from the beginning of the overall subset definition
[out]IRET- integer: return code
  • 0 = normal return
  • -1 = TAGRE could not be found, or some other error occurred

A data subset must already be in scope within the BUFRLIB internal arrays for LUNIT, either via a previous call to one of the subset-reading subroutines (when reading BUFR data subsets) or via a previous call to one of the message-writing subroutines (when writing BUFR data subsets).

Program history log:

  • 2016-06-07 J. Ator – Original author

Definition at line 40 of file gettagre.f.

References fstag(), status(), and strsuc().