nwsFetch                 package:nws                 R Documentation

_F_e_t_c_h _a _S_t_o_r_e_d _V_a_l_u_e

_D_e_s_c_r_i_p_t_i_o_n:

     Fetch value associated with a variable from the shared
     netWorkSpace.

_U_s_a_g_e:

     ## S4 method for signature 'netWorkSpace':
     nwsFetch(.Object, xName)

_A_r_g_u_m_e_n_t_s:

 .Object: a netWorkSpace class object

   xName: name of the variable to be fetched

_D_e_t_a_i_l_s:

     The 'nwsFetch' method looks in the shared netWorkSpace '.Object' 
     for a value bound to 'xName'; if it finds such a value, 'nwsFetch'
      returns it and removes it from the variable. If no value is
     found, 'nwsFetch' blocks until a value for 'xName' becomes
     available. This operation is atomic. If there are multiple
     'nwsFetch' or  'nwsFetchTry' requests for a given 'xName', any
     given value from  the set of values associated with 'xName' will
     be returned to just one requester.  If there is more than one
     value associated with 'xName', the particular value removed
     depends on 'xName''s behavior. See 'nwsDeclare' for details.

_S_e_e _A_l_s_o:

     'nwsDeclare', 'nwsFetchTry'

_E_x_a_m_p_l_e_s:

     ## Not run: 
     ws <- netWorkSpace('nws example')
     nwsStore(ws, 'x', 10)
     nwsFetch(ws, 'x')
     nwsFetch(ws, 'x') # no value for x; therefore block on fetch
     ## End(Not run)

