Execute code with a modified search pathSource:
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
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, pos = 2, lib.loc = NULL, character.only = TRUE, logical.return = FALSE, warn.conflicts = FALSE, quietly = TRUE, verbose = getOption("verbose") ) local_package( package, 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() )
package name to load.
Code to execute in the temporary environment
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
a character vector describing the location of R library trees to search through, or
NULL. The default value of
NULLcorresponds to all libraries currently known to
.libPaths(). Non-existent library trees are silently ignored.
a logical indicating whether
helpcan be assumed to be character strings.
logical. If it is
TRUEis returned to indicate success.
TRUE, warnings are printed about
conflictsfrom attaching the new package. A conflict is a function masking a function, or a non-function masking a non-function. The default is
TRUEunless specified as
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.
The environment to use for scoping.
Environment to attach.
name to use for the attached database. Names starting with
package:are reserved for
withr for examples