MemCom Reference Manual > MemCom ftn Fortran API > Relational Table Manager (TB) > mcf_tb_scan

Name

mcf_tb_scan — (Fortran API)

Synopsis

subroutine mcf_tb_scan(rt,code,key,type,size,status)

mcf_rtable rt
integer*4 code
character*(*) key
character*4 type
integer*4 size
integer*4 status

Description

mcf_tb_scan iterates over all keys the relational table identified by rt. For each keyword the name, the data type, and the number of data elements are returned.

Parameters

rt

Relational table identifier (input).

code

Iteration code (input, output). Setting code to 0 starts the iteration: Subsequent calls to mcf_tb_scan will return the next key. When the end of the table is reached, 1 is returned. A return value of -1 flags an error.

key

Next keyword (output). The string may not exceed the maximum key name length.

size

Number of data elements of key (output).

status

Status code returned (output). Upon successful completion of the operation, the status value 0 is returned. A negative value is returned, if an error has been detected.