vt$pos (6) --- position the cursor to row, col           11/06/84


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function vt$pos (row, col, crow, ccol)
                 integer row, col, crow, ccol

                 Library: vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Vt$pos'  positions  the  cursor  on  the terminal screen to
                 'row', 'col' from 'Crow', 'ccol'.  If the positioning can be
                 done faster  relatively,  a  relative  position  is  output,
                 otherwise  the  positioning is done absolutely.  'Vtinit' or
                 'vtterm' should have been called beforehand to  set  up  the
                 terminal  characteristics  in  the virtual terminal handler.
                 If the positioning can be done, 'vt$pos' returns OK.  If the
                 positioning can't be done, or the row and column are out  of
                 the terminal's screen boundary, ERR is returned.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Vt$pos'  after  checking to make sure the coordinates given
                 are actually on the  terminal's  screen,  computes  a  'row-
                 coordinate'  and a 'column-coordinate' that are output after
                 the lead-in absolute cursor  positioning  sequence  for  the
                 terminal.   There  are only a few different standard ways to
                 compute this character.  Based  on  how  the  terminal  does
                 absolute addressing, 'vt$pos' then outputs the characters in
                 the  correct  sequence to do the positioning.  A small delay
                 (usually nulls)  is  output  for  terminals  that  need  it.
                 Interested   users   should   look  at  the  code  for  more
                 information.


            _C_a_l_l_s

                 print, vt$del


            _B_u_g_s

                 Not meant to be called by the normal user.


            _S_e_e _A_l_s_o

                 other vt?* routines (2) and (6)









            vt$pos (6)                    - 1 -                    vt$pos (6)