pos.to.env
Convert Positions in the Search Path to Environments

Description

Gives the corresponding environment for the specified position from the search() list.

Usage

pos.to.env(x)

Arguments

x an integer value, or a vector of integer values. x is limited to the number of environments present in the search() list, plus environment: R_EmptyEnv.
Value
returns one object or a list of objects of the class "environment". These objects can have one or two attributes:
name the package name corresponding to environment. For example: "package:graphics"
path the absolute path of a package corresponding to environment. For example: "C:/xxxx/library/graphics"
Note
The path is not present for global environment, Autoloads, base and empty environments. The position after the last environment in search path is returned as empty environment.
See Also
as.environment, search
Examples
pos.to.env(1:5)

pos.to.env(4)

pos.to.env(10) # <environment: R_EmptyEnv>

pos.to.env(.GlobalEnv) # Error: environments cannot be coerced to other types

pos.to.env(c(1, 2, 3))

pos.to.env(-1) # Error in pos.to.env(-1) : no enclosing environment

f <- function() { pos.to.env(-1) } f() # <environment: R_GlobalEnv>

pos.to.env(0) # Error in pos.to.env(0) : invalid argument

pos.to.env(10) # <environment: R_EmptyEnv>

pos.to.env(11) # Error in pos.to.env(11) : invalid argument

# Passing a list object. pos.to.env(list(a = c(1:3), b = c(4:5))) # Error: (list) object cannot be coerced to type 'integer'

Package base version 6.1.1-7
Package Index