nwsFindTry                package:nws                R Documentation

_F_i_n_d _a _S_t_o_r_e_d _V_a_l_u_e (_N_o_n-_B_l_o_c_k_i_n_g _V_e_r_s_i_o_n)

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

     Attempt to find a value associated with a variable from the shared
     netWorkSpace;  a non-blocking version of 'nwsFind'.

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

     ## S4 method for signature 'netWorkSpace':
     nwsFindTry(.Object, xName, defaultVal=NULL)

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

 .Object: a netWorkSpace class object

   xName: name of variable to be found

defaultVal: value to return if xName is not found

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

     The 'nwsFindTry' method looks in the shared netWorkSpace '.Object'
     for a value bound to 'xName'; if it finds such a value,
     'nwsFindTry' returns it but does not remove it.  If it does not
     find a value, 'nwsFindTry' returns immediately, rather than 
     blocking as in the case of 'nwsFind'), and the value of argument
     'defaultVal' is returned.  By default, 'defaultVal' is 'NULL'.

     If there is more than one value associated with 'xName', the
     particular value returned depends on 'xName''s behavior. See
     'nwsDeclare' for details.

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

     'nwsDeclare', 'nwsFind'

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

     ## Not run: 
     ws <- netWorkSpace('nws example')
     x <- nwsFindTry(ws, 'abc', -1)
     ## End(Not run)

