with_rng_version: RNG version

In withr: Run Code 'With' Temporarily Modified Global State

RNG version

Description

Change the RNG version and restore it afterwards.

Usage

with_rng_version(version, code)

local_rng_version(version, .local_envir = parent.frame())

Arguments

version	⁠[character(1)]⁠ an R version number, e.g. "3.5.0", to switch to the RNG this version of R uses. See RNGversion().
code	[any] Code to execute in the temporary environment
.local_envir	The environment to apply the change to.

Details

with_rng_version() runs the code with the specified RNG version and resets it afterwards.

local_rng_version() changes the RNG version for the caller execution environment.

Value

[any]
The results of the evaluation of the code argument.

See Also

withr for examples

RNGversion(), RNGkind(), with_seed().

Examples

RNGkind()
with_rng_version("3.0.0", RNGkind())
with_rng_version("1.6.0", RNGkind())

with_rng_version("3.0.0",
  with_seed(42, sample(1:100, 3)))

with_rng_version("1.6.0",
  with_seed(42, sample(1:100, 3)))

RNGkind()

fun1 <- function() {
  local_rng_version("3.0.0")
  with_seed(42, sample(1:100, 3))
}

fun2 <- function() {
  local_rng_version("1.6.0")
  with_seed(42, sample(1:100, 3))
}

RNGkind()
fun1()
fun2()
RNGkind()

withr documentation built on Nov. 2, 2023, 5:24 p.m.