svget (2) --- return the value of a shell variable       05/27/83


          | _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

          |      integer function svget (name, value, maxval)
          |      character name (ARB), value (maxval)
          |      integer maxval

          |      Library:  vshlib (shell routine library)


          | _F_u_n_c_t_i_o_n

          |      'Svget'  looks  up  and returns the value of the most recent
          |      declaration of the shell variable 'name'.   'Value'  is  the
          |      array  to  receive  the  value  and  'maxval' is the maximum
          |      amount of space (including the EOS) in the receiving string.
          |      The function returns  the  length  of  the  returned  string
          |      'value' if the variable is found and EOF otherwise.


          | _I_m_p_l_e_m_e_n_t_a_t_i_o_n

          |      'Svget'  searches  for  'name'  from the current lexic level
          |      back to the first lexic level, stopping when it locates  the
          |      first  (most  recent) definition.  Any previous declarations
          |      are ignored.  If the variable is not located then the  func-
          |      tion  returns  EOF;  otherwise, as much of the value as pos-
          |      sible is copied into the receiving buffer and the number  of
          |      characters transferred is returned.


          | _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

          |      value


          | _C_a_l_l_s

          |      ctoc


          | _B_u_g_s

          |      Should  probably  return  the  lexic  level  of the variable
          |      located.


          | _S_e_e _A_l_s_o

          |      other sv?* routines (2)









            svget (2)                     - 1 -                     svget (2)