get(x, pos = -1, envir = as.environment(pos), mode = "any", inherits = TRUE) mget(x, envir, mode = "any", ifnotfound = list(function(x) stop(paste0("value for '", x, "' not found"), call. = FALSE)), inherits = FALSE)
get, an object name (given as a character string).
mget, a character vector of object names.
- where to look for the object (see ‘Details’); if omitted (for
get), the function will search as if the name of the object appeared unquoted in an expression.
- an alternative way to specify an environment to look in; see the ‘Details’ section.
- the mode or type of object sought: see the ‘Details’ section.
- should the enclosing frames of the environment be searched?
listof values to be used if the item is not found: it will be coerced to a list if necessary.
pos argument can specify the environment in which to look for the object in any of several ways: as a positive 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 default of
-1 indicates the current environment of the call to
envir argument is an alternative way to specify an environment.
These functions look to see if each of the name(s)
x have a value bound to it in the specified environment. If
TRUE and a value is not found for
x in the specified environment, the enclosing frames of the environment are searched until the name
x is encountered. See
environment and the ‘R Language Definition’ manual for details about the structure of environments and their enclosures.
mode is specified then only objects of that type are sought.
mode here is a mixture of the meanings of
"function" covers primitive functions and operators,
"double" all refer to any numeric type,
"name" are equivalent but
"language" must be used (and not
mget, the values of
ifnotfound can be either the same length as
x or of length 1. The argument
ifnotfound must be a list containing either the value to use if the requested item is not found or a function of one argument which will be called if the item is not found, with argument the name of the item being requested.
get, the object found. If no object is found an error results.
mget, a named list of objects (found or specified via
Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) The New S Language. Wadsworth & Brooks/Cole.
Documentation reproduced from R 2.15.3. License: GPL-2.