as_env {rlang} | R Documentation |
as_env()
coerces named vectors (including lists) to an
environment. It first checks that x
is a dictionary (see
is_dictionaryish()
). If supplied an unnamed string, it returns the
corresponding package environment (see pkg_env()
).
as_env(x, parent = NULL)
x |
An object to coerce. |
parent |
A parent environment, |
If x
is an environment and parent
is not NULL
, the
environment is duplicated before being set a new parent. The return
value is therefore a different environment than x
.
# Coerce a named vector to an environment: env <- as_env(mtcars) # By default it gets the empty environment as parent: identical(env_parent(env), empty_env()) # With strings it is a handy shortcut for pkg_env(): as_env("base") as_env("rlang") # With NULL it returns the empty environment: as_env(NULL)