lookup (2) --- retrieve information from a symbol table  03/25/82


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function lookup (symbol, info, table)
                 character symbol (ARB)
                 untyped info (ARB)
                 pointer table

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Lookup'  examines  the  symbol  table  given  as  its third
                 argument for the presence  of  the  character-string  symbol
                 given  as its first argument.  If the symbol is not present,
                 'lookup' returns  'NO'.   If  the  symbol  is  present,  the
                 information  associated  with it is copied into the informa-
                 tion array passed as the second argument  to  'lookup',  and
                 'lookup' returns 'YES'.

                 The  symbol table used must have been created by the routine
                 'mktabl'.  The size of the  information  array  must  be  at
                 least  as  great as the symbol table node size, specified at
                 its creation.

                 Note that all symbol  table  routines  use  dynamic  storage
                 space, which must have been previously initialized by a call
                 to 'dsinit'.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Lookup' calls 'st$lu' to determine the location of the sym-
                 bol in the table.  If 'st$lu' returns NO, then the symbol is
                 not  present,  and 'lookup' returns NO.  Otherwise, 'lookup'
                 copies the information field from the  appropriate  node  of
                 the symbol table into the information array and returns YES.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 info


            _C_a_l_l_s

                 st$lu


            _S_e_e _A_l_s_o

                 enter  (2),  delete  (2), mktabl (2), rmtabl (2), st$lu (6),
                 sctabl (2), dsinit (2), dsget (2), dsfree (2)





            lookup (2)                    - 1 -                    lookup (2)