env_get

0th

Percentile

Get an object from an environment.

env_get() extracts an object from an enviroment env. By default, it does not look in the parent environments.

Usage
env_get(env = caller_env(), nm, 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.
nm
The name of a binding.
inherit
Whether to look for bindings in the parent environments.
Value

An object if it exists. Otherwise, throws an error.

Aliases
  • env_get
Examples
parent <- new_env(empty_env(), list(foo = "foo"))
env <- new_env(parent, list(bar = "bar"))

# This throws an error because `foo` is not directly defined in env:
# env_get(env, "foo")

# However `foo` can be fetched in the parent environment:
env_get(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.