pok$xs (4) --- change a location in memory               06/25/82


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 subroutine pok$xs (ptr_to_word, contents)
                 shortcall pok$xs (4)

                 pointer ptr_to_word
                 untyped contents

                 Library: shortlb
                 Also declared in =incl=/shortlb.r.i


            _F_u_n_c_t_i_o_n

                 The  subroutine  changes  the  contents  of  the word at the
                 address 'ptr_to_word'.  Effectively,

                            call pok$xs (loc(word), contents)

                 is equivalent to

                                     word = contents


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 Implemented as a simple  PMA  routine  entered  via  a  JSXB
                 (shortcall).

                 Note that any routine using this call must be compiled using
                 the "-q" option of 'fc'.


            _B_u_g_s

                 No validity check is done on the pointer.

                 The  user may do very peculiar things to his/her environment
                 if the call is not used with care.

                 Locally supported.


            _S_e_e _A_l_s_o

                 fc (1), pek$xs (4), s1c$xs (4), s2c$xs (4)












            pok$xs (4)                    - 1 -                    pok$xs (4)