mirai (version 1.2.0)

nextstream: Next >> Developer Interface

Description

nextstream retrieves the currently stored L'Ecuyer-CMRG RNG stream for the specified compute profile and advances it to the next stream.

nextget retrieves the specified item from the specified compute profile.

Usage

nextstream(.compute = "default")
nextget(x, .compute = "default")

Value

For nextstream: a length 7 integer vector, as given by

.Random.seed when the L'Ecuyer-CMRG RNG is in use (may be passed directly to the ‘rs’ argument of daemon), or else NULL if a stream has not yet been created.

For nextget: the requested item, or else NULL if not present.

Arguments

.compute

[default 'default'] character value for the compute profile to use (each compute profile has its own independent set of daemons).

x

character value of item to retrieve. One of ‘pid’ (dispatcher process ID), ‘urls’ (URLs dispatcher is listening at) or ‘tls’ (the stored client TLS configuration for use by daemons).

Details

These functions are exported for use by packages extending mirai with alternative launchers of daemon processes.

For nextstream: This function should be called for its return value when required. The function also has the side effect of automatically advancing the stream stored within the compute profile. This ensures that the next recursive stream is returned when the function is called again.

Examples

if (interactive()) {
# Only run examples in interactive R sessions

daemons(1L)
nextstream()
nextstream()

nextget("pid")
nextget("urls")

daemons(0)

}