substr (1) --- take a substring of a string              02/22/82


            _U_s_a_g_e

                 substr <start> <length> <string>


            _D_e_s_c_r_i_p_t_i_o_n

                 'Substr' is similar in function to the PL/I substr function;
                 it  prints  on  standard output a specified substring of its
                 third  argument.   The  substring  printed  is  taken   from
                 <string>  starting  at  position  <start> and continuing for
                 <length>  characters,  or  until  the  end  of  <string>  is
                 reached.   If  <start> is negative, the starting position is
                 -<start> characters from the end of <string>.   If  <length>
                 is negative, characters are extracted from right to left.

                 'Substr'   is   perhaps   excessively  general;  for  common
                 problems,  the  'take'  and  'drop'  commands  will  usually
                 suffice.


            _E_x_a_m_p_l_e_s

                 substr 1 2 11/27/84
                 substr [start] [len] [full_name]
                 set last_five = [substr -5 5 [variable]]


            _S_e_e _A_l_s_o

                 take  (1),  drop  (1), rot (1), substr (2), stake (2), sdrop
                 (2)


























            substr (1)                    - 1 -                    substr (1)