get_field_ptr - Searches LT label vector for an attribute name

SYNTAX

#include "ltable.h"

FUNCTION struct VECTOR *get_field_ptr (tab,name)

     struct TAB_DEF     *tab;
     char               *name;

PARAMETERS

tab (Input, struct TAB DEF)

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

name (Input, char)

Attribute name defining the LT record field whose pointer is to be returned to the calling routine.

DESCRIPTION

Search the LT label vector to find the specified attribute name. The function returns the pointer to the record structure (defined by struct VECTOR) containing the value of the attribute name. If the attribute is not found, the NULL pointer is returned. Function get_vector() must be called prior to get_field_ptr().

RETURN VALUE

get_field_ptr() returns

     NULL    --> The attribute name was not found
     !(NULL) --> Pointer to structure of LT record field

SPECIAL CONSIDERATIONS:

The get_field_ptr() call is for C only.