R: Coerce to an environment

as_env {rlang} | R Documentation

## Coerce to an environment

### Description

`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()`).

### Usage

    as_env(x, parent = NULL)

### Arguments

`x` | An object to coerce.
`parent` | A parent environment, `empty_env()` by default. This argument is only used when `x` is data actually coerced to an environment (as opposed to data representing an environment, like `NULL` representing the empty environment).

### Details

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`.

### Examples

    # 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)

[Package rlang version 0.1.6 Index]