with_package()
attaches a package to the search path, executes the code, then
removes the package from the search path. The package namespace is not
unloaded however. with_namespace()
does the same thing, but attaches the
package namespace to the search path, so all objects (even unexported ones) are also
available on the search path.
with_package(package, code, help, pos = 2, lib.loc = NULL,
character.only = TRUE, logical.return = FALSE, warn.conflicts = FALSE,
quietly = TRUE, verbose = getOption("verbose"))local_package(package, help, pos = 2, lib.loc = NULL,
character.only = TRUE, logical.return = FALSE, warn.conflicts = FALSE,
quietly = TRUE, verbose = getOption("verbose"),
.local_envir = parent.frame())
with_namespace(package, code, warn.conflicts = FALSE)
local_namespace(package, .local_envir = parent.frame(),
warn.conflicts = FALSE)
with_environment(env, code, pos = 2L, name = format(env),
warn.conflicts = FALSE)
local_environment(env, pos = 2L, name = format(env),
warn.conflicts = FALSE, .local_envir = parent.frame())
[character(1)]
package name to load.
[any]
Code to execute in the temporary environment
the name of a package, given as a name or
literal character string, or a character string, depending on
whether character.only
is FALSE
(default) or
TRUE
).
the position on the search list at which to attach the
loaded namespace. Can also be the name of a position on the current
search list as given by search()
.
a character vector describing the location of R
library trees to search through, or NULL
. The default value
of NULL
corresponds to all libraries currently known to
.libPaths()
.
Non-existent library trees are silently ignored.
a logical indicating whether package
or
help
can be assumed to be character strings.
logical. If it is TRUE
, FALSE
or
TRUE
is returned to indicate success.
logical. If TRUE
, warnings are
printed about conflicts
from attaching the new
package. A conflict is a function masking a function,
or a non-function masking a non-function.
a logical. If TRUE
, no message confirming
package attaching is printed, and most often, no errors/warnings are
printed if package attaching fails.
a logical. If TRUE
, additional diagnostics are
printed.
[environment]
The environment to use for scoping.
[environment()]
Environment to attach.
name to use for the attached database. Names starting with
package:
are reserved for library
.
[any]
The results of the evaluation of the code
argument.
withr
for examples
# NOT RUN {
with_package("ggplot2", {
ggplot(mtcars) + geom_point(aes(wt, hp))
})
# }
Run the code above in your browser using DataLab