env_unbind

0th

Percentile

Remove bindings from an environment.

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.

Usage
env_unbind(env = caller_env(), nms, inherit = FALSE)
Arguments
env
An environment or an object with a S3 method for env(). If missing, the environment of the current evaluation frame is returned.
nms
A character vector containing the names of the bindings to remove.
inherit
Whether to look for bindings in the parent environments.
Value

The input object env, with its associated environment modified in place.

Aliases
  • env_unbind
Examples
data <- stats::setNames(letters, letters)
env_bind(environment(), data)
env_has(environment(), letters)

# env_unbind() removes bindings:
env_unbind(environment(), letters)
env_has(environment(), letters)

# With inherit = TRUE, it removes bindings in parent environments
# as well:
parent <- new_env(empty_env(), list(foo = "a"))
env <- new_env(parent, list(foo = "b"))
env_unbind(env, "foo", inherit = TRUE)
env_has(env, "foo", inherit = TRUE)
Documentation reproduced from package rlang, version 0.0.0.9000, License: GPL-3

Community examples

Looks like there are no examples yet.