mapstr (2) --- map case of a string                      01/07/83


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function mapstr (str, case)
                 character str (ARB)
                 integer case

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Mapstr'  is  used  to  map the case of all the letters in a
                 string.  'Str' is the string to be mapped; 'case'  is  UPPER
                 if letters are to be mapped to upper case, anything else for
                 lower case (usually LOWER).

                 The  length  of  the  string  is  returned as the function's
                 value.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 A loop is used to examine each character in the string;  the
                 actual   mapping  is  done  by  adding  or  subtracting  the
                 difference between ASCII 'a' and ASCII 'A'.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 str


            _S_e_e _A_l_s_o

                 mapup (2), mapdn (2), tlit (1)























            mapstr (2)                    - 1 -                    mapstr (2)