R: Associate a Value with a Variable in netWorkSpace

nwsStore {nws}

R Documentation

Associate a Value with a Variable in netWorkSpace

Description

Store value associated with a variable in the shared netWorkSpace.

Usage

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

Arguments

`.Object`	a netWorkSpace class object.
`xName`	character string to be used as the name of the stored variable.
`xVal`	value to be stored.

Details

The nwsStore method associates the value xVal with the variable xName in the shared netWorkSpace .Object, thereby making the value available to all the distributed R processes. If a mode has not already been set for xName, 'fifo' will be used (see nwsDeclare).

Note that, by default ('fifo' mode), nwsStore is not idempotent: repeating nwsStore (nws, xName, xVal) will add additional values to the set of values associated with the variable named xName. See the examples below for details.

Examples

## Not run: 
ws <- netWorkSpace('nws example')

# To store value 5 bound to variable 'x' on the netWorkSpace 'ws'
# (If 'x' was declared, then its mode is inherited, 
# otherwise 'x' uses the default mode 'fifo')
nwsStore(ws, 'x', 5)

# store 10 values associate with variable y to the netWorkSpace
for (i in 1:10)
  nwsStore(ws, 'y', i)

# retrieve 10 values associate with variable y from the netWorkSpace
for (i in 1:10)
  print(nwsFetch(ws, 'y'))
## End(Not run)