ireadns.f File Reference

Read the next data subset from a BUFR file that was previously opened for reading. More...

Go to the source code of this file.

Functions/Subroutines
function	ireadns (LUNIT, SUBSET, IDATE)
	This function calls BUFRLIB subroutine readns() and passes back its return code as the function value. More...

Detailed Description

Read the next data subset from a BUFR file that was previously opened for reading.

Definition in file ireadns.f.

Function/Subroutine Documentation

function ireadns	(		LUNIT,
		character*8	SUBSET,
			IDATE
	)

This function calls BUFRLIB subroutine readns() and passes back its return code as the function value.

Author

J. Woollen

Date

1994-01-06

Parameters

[in]	LUNIT	- integer: Fortran logical unit number for BUFR file
[out]	SUBSET	- character*8: Table A mnemonic for type of data subset that was read (see DX BUFR Tables for further information about Table A mnemonics)
[out]	IDATE	- integer: Date-time stored within Section 1 of BUFR message containing data subset that was read, in format of either YYMMDDHH or YYYYMMDDHH, depending on the most recent call to subroutine datelen()

Returns

ireadns - integer:

• 0 = new BUFR data subset was successfully read into internal arrays
• -1 = there are no more BUFR data subsets in the file connected to logical unit LUNIT

Remarks

• The use of this function allows the return code from readns() to be used as the target variable within an iterative program loop.

Program history log:

• 1994-01-06 J. Woollen – Original author
• 2002-05-14 J. Woollen – Changed from an entry point to increase portability to other platforms

Definition at line 37 of file ireadns.f.

References readns().