| exists {base} | R Documentation |
Search for an R object of the given name on the search path.
exists(x, where = NULL, envir = sys.frame(sys.parent()),
frame = NULL, mode = "any", inherits = TRUE)
x |
a variable name (given as a character string). |
where, envir, frame |
an environment to be searched.
By default this is the
environment where the call to envir takes place. |
mode |
the type of interest for the object. |
inherits |
should the enclosing frames of the environment be inspected. |
This function looks to see if the name x has a value bound to it.
If inherits is TRUE and a value is not found for x,
then the parent frames of envir are searched until the name
x is encountered. Warning: This is the default behaviour
for R but not for S.
If mode is specified then only objects of that mode are sought.
The function returns TRUE if the variable is encountered and
FALSE if not.
get.
## Define a substitute function if necessary:
if(!exists("some.fun", mode="function"))
some.fun <- function(x) { cat("some.fun(x)\n"); x }
search()
exists("ls", 2) # true even though ls is in pos=3
exists("ls", 2, inherits=F) # false