nws (version 1.6.2)

nwsIFetch: netWorkSpace Class Method

Description

Create a function that acts as a destructive iterator over the values of the specified variable.

Usage

## S3 method for class 'netWorkSpace':
nwsIFetch(.Object, xName)

Arguments

.Object

a netWorkSpace class object

xName

name of the variable to be fetched

Details

The iterator function returned by the nwsIFetch method takes no arguments, and works just like the nwsFetch method, specified with the same arguments that were passed to nwsIFetch method. Note that the nwsIFind and nwsIFindTry methods are much more useful, since they provide the only way to iterate over values of a variable non-destructively. nwsIFetch and nwsIFetchTry are provided for completeness.

See Also

nwsFetch, nwsIFetchTry

Examples

ws <- netWorkSpace('nws example')
nwsStore(ws, 'x', 10)
it <- nwsIFetch(ws, 'x')
it()  # returns the value 10
it()  # blocks until another process stores a value in the variable