nwsFetch                 package:nws                 R Documentation

_n_e_t_W_o_r_k_S_p_a_c_e _C_l_a_s_s _M_e_t_h_o_d

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

     Fetch value associates with a variable from the shared
     netWorkSpace, .Object.

_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:

     Fetch method blocks until a value for xName is found in the shared
     netWorkSpace, .Object. Once found, remove a value associated with
     xName from the shared netWorkSpace. This operation is atomic. If
     there are multiple NetWorkSpaces clients nwsFetch or nwsFetchTry a
     given xName, any given value from the set of values associated
     with xName will be returned to just one client session.  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)

