multiget {Biobase}R Documentation

Return a list containing the Values of the supplied variables.

Description

Search for an R objects with a given names and return the values found.

Usage

multiget(x, pos=-1, envir=as.environment(pos), mode="any",
inherits=TRUE, iffail)

Arguments

x a vector or list of variable names (given as a quoted character strings).
pos where to look for the object (see the details section); if omitted, the function will search, as if the name of the object appeared in unquoted in an expression.
envir an alternative way to specify an environment to look in; see the details section.
mode the mode of object sought.
inherits should the enclosing frames of the environment be inspected?
iffail A value to be used for items in the list that are not found.

Details

The pos argument can specify the environment in which to look for the object in any of several ways: as an integer (the position in the search list); as the character string name of an element in the search list; or as an environment (including using sys.frame to access the currently active function calls). The envir argument is an alternative way to specify an environment, but is primarily there for back compatibility.

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

Value

A named list (the names come from x) of the variables found. If iffail was specified then any object named in x that is not found will have the value of iffail as its value. Each variable lookup is wrappted in a try call so that failure to find one variable does not prevent finding others.
This function searches the specified environment for a bound variable whose name is given by the character 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.

See Also

exists, multiassign.

Examples

nam <- paste("r",1:6, sep=".")

multiassign(nam, 11:16)
rm("r.3")
multiget(nam, iffail=NA)


[Package Biobase version 1.4.15 Index]