| env_unbind {rlang} | R Documentation |
env_unbind() is the complement of env_bind(). Like env_has(),
it ignores the parent environments of env by default. Set
inherit to TRUE to track down bindings in parent environments.
env_unbind(env = caller_env(), nms, inherit = FALSE)
env |
An environment. |
nms |
A character vector of binding names to remove. |
inherit |
Whether to look for bindings in the parent environments. |
The input object env with its associated environment
modified in place, invisibly.
env <- env(foo = 1, bar = 2)
env_has(env, c("foo", "bar"))
# Remove bindings with `env_unbind()`
env_unbind(env, c("foo", "bar"))
env_has(env, c("foo", "bar"))
# With inherit = TRUE, it removes bindings in parent environments
# as well:
parent <- env(empty_env(), foo = 1, bar = 2)
env <- env(parent, foo = "b")
env_unbind(env, "foo", inherit = TRUE)
env_has(env, c("foo", "bar"))
env_has(env, c("foo", "bar"), inherit = TRUE)