multiget {Biobase} | R Documentation |
Search for an R objects with a given names and return the values found.
multiget(x, pos=-1, envir=as.environment(pos), mode="any", inherits=TRUE, iffail)
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. |
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.
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.
nam <- paste("r",1:6, sep=".") multiassign(nam, 11:16) rm("r.3") multiget(nam, iffail=NA)