get_record - Reads a logical record from the labeled table (LT)

SYNTAX

#include "ltable.h"

FUNCTION get_record (tab)

     struct TAB_DEF     *tab;

PARAMETERS

tab (Input, struct TAB_DEF)

Pointer to a structure defining the LT file structure. The structure is initialized by the open_tab() utility.

DESCRIPTION

Read a logical record from the LT defined by the label vector definition. The logical record is read into a linked list allocated by the routine get_vector(). The head of the linked list is defined to be the structure field vector of tab.

RETURN VALUE

get_record() returns

     E_SUCC (0) --> successful completion
     E_FAIL (1) --> operation failed
     E_EOF  (2) --> End of file encountered

SPECIAL CONSIDERATIONS:

The get_record() call is for C only.