get_vector - Retrieves label vector from labeled table (LT)

SYNTAX

#include "ltable.h"

FUNCTION get_vector (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

The get_vector() routine retrieves the label vector from the LT. It assigns values to the LT structure. The following fields of structure TAB_DEF are assigned:

     1. Number of columns                 (ncol)
     2. Linked list                       (vector)
The structure VECTOR linked list is allocated to store a logical record of the LT. Each element of the linked list represents a column in the LT. The following fields of structure VECTOR are assigned:
     1. Name of the attribute                   (label)
     2. Data type of the attribute              (dtype)
     3. Description of the attribute            (desc)
     4. Number of rows and columns in matrix    (lt_size)
Since get_vector() allocates storage to store logical records read from the LT, it is required that an application program to call get_vector() prior to calling get_record().

RETURN VALUE

get_vector() has no return values.

SPECIAL CONSIDERATIONS:

The get_vector() call is for C only.