Create a function — new_function • rlang

This constructs a new function given its three components: list of arguments, body code and parent environment.

Usage

new_function(args, body, env = caller_env())

Arguments

args: A named list or pairlist of default arguments. Note that if you want arguments that don't have defaults, you'll need to use the special function pairlist2(). If you need quoted defaults, use exprs().
body: A language object representing the code inside the function. Usually this will be most easily generated with base::quote()
env: The parent environment of the function, defaults to the calling environment of new_function()

Examples

f <- function() letters
g <- new_function(NULL, quote(letters))
identical(f, g)
#> [1] TRUE

# Pass a list or pairlist of named arguments to create a function
# with parameters. The name becomes the parameter name and the
# argument the default value for this parameter:
new_function(list(x = 10), quote(x))
#> function (x = 10) 
#> x
#> <environment: 0x562ec0655690>
new_function(pairlist2(x = 10), quote(x))
#> function (x = 10) 
#> x
#> <environment: 0x562ec0655690>

# Use `exprs()` to create quoted defaults. Compare:
new_function(pairlist2(x = 5 + 5), quote(x))
#> function (x = 10) 
#> x
#> <environment: 0x562ec0655690>
new_function(exprs(x = 5 + 5), quote(x))
#> function (x = 5 + 5) 
#> x
#> <environment: 0x562ec0655690>

# Pass empty arguments to omit defaults. `list()` doesn't allow
# empty arguments but `pairlist2()` does:
new_function(pairlist2(x = , y = 5 + 5), quote(x + y))
#> function (x, y = 10) 
#> x + y
#> <environment: 0x562ec0655690>
new_function(exprs(x = , y = 5 + 5), quote(x + y))
#> function (x, y = 5 + 5) 
#> x + y
#> <environment: 0x562ec0655690>