get {base}R Documentation

Return a Variable's Value

Description

Search for an R object with a given name and return it if found.

Usage

get(x, pos=-1, envir=pos.to.env(pos), mode="any", inherits=TRUE)

Arguments

x a variable name (given as a quoted string).
pos position in search list, can be numerical or a quoted string.
envir the environment to be used.
mode the mode of object sought.
inherits should the enclosing frames of the environment be inspected?

Details

The mode includes collections such as "numeric" and "function": any member of the collection will suffice.

Value

This function searches the specified environment for a bound variable whose name is given by the string x. If the variable's value is not of the correct mode, it is ignored.
If inherits is FALSE, only the first frame of the specified environment is inspected. If inherits is TRUE, the search is continued up through the parent frames until a bound value of the right mode is found.
Using a NULL environment is equivalent to using the current environment.

Warning

Up to and including this release mode is interpreted as the value of typeof(x). This will change from R 1.2.0 to the value of mode(x), for compatibility with S.

See Also

exists.

Examples

get("%o%")