check.options {grDevices} | R Documentation |
Utility function for setting options with some consistency checks.
The attributes
of the new settings in new
are
checked for consistency with the model (often default)
list in name.opt
.
check.options(new, name.opt, reset = FALSE, assign.opt = FALSE,
envir = .GlobalEnv,
check.attributes = c("mode", "length"),
override.check = FALSE)
new |
a named list |
name.opt |
character with the name of R object containing the default list. |
reset |
logical; if |
assign.opt |
logical; if |
envir |
the |
check.attributes |
character containing the attributes which
|
override.check |
logical vector of length |
A list of components with the same names as the one called
name.opt
.
The values of the components are changed from the new
list,
as long as these pass the checks (when these are not overridden
according to override.check
).
Option "names"
is exempt from all the checks or warnings, as in
the application it can be NULL
or a variable-length character
vector.
Martin Maechler
ps.options
and pdf.options
,
which use check.options
.
(L1 <- list(a=1:3, b=pi, ch="CH"))
check.options(list(a=0:2), name.opt = "L1")
check.options(NULL, reset = TRUE, name.opt = "L1")