nws (version 1.7.0.1)

nwsFetch: Fetch a Stored Value

Description

Fetch value associated with a variable from the shared netWorkSpace.

Usage

"nwsFetch"(.Object, xName)

Arguments

.Object

a netWorkSpace class object

xName

name of the variable to be fetched

Details

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.

See Also

nwsDeclare, nwsFetchTry

Examples

## 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)