atoc (2) --- convert an address to 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 atoc (ptr, str, size)
                 integer ptr (3), size
                 character str (ARB)

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Atoc' converts the 2 or 3 word 64V mode indirect pointer in
                 the  address  'ptr'  to a printable EOS-terminated string in
                 'str'.  No more  than  'size'  elements  of  'str'  will  be
                 modified, including the trailing EOS.

                 The pointer is converted into the format
                 
                    [f]<ring>.<segment>.<word>[.<bit>]
                 
                 <Ring>,  <segment>,  and <word> are positive octal integers.
                 The character "f" is present only if the fault  bit  in  the
                 pointer  is set, and <bit> is included only if the extension
                 bit is set.

                 The  function  return  is  the  number  characters  used  to
                 represent the address (the length of 'str').


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 Bits  are removed from the indirect pointer and converted to
                 character representation with calls to 'gitoc' in a straigh-
                 tforward manner.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 str


            _C_a_l_l_s

                 gitoc, ctoc


            _S_e_e _A_l_s_o

                 atoc (2), other conversion routines (?*toc (2), cto?* (2))









            atoc (2)                      - 1 -                      atoc (2)