Retrieves the value of an zephyr_option.
The value is looked up in the following order:
User defined option: {pkgname}.{name}
System variable: R_{PKGNAME}_{NAME}
Value of default argument (if not NULL)
Default value defined with create_option()
And returns the first set value.
get_option(name, .envir = sys.function(which = -1), default = NULL)[character(1)] Name of the option
Environment in which the option is defined. Default is suitable for use inside your package.
default value to return if the option is not set.
If NULL uses the default set with create_option().
Value of the option
Environment variables are always defined as character strings. In order to return consistent values the following conversions are applied:
If they contain a ";" they are split into a vector using ";" as the delimiter.
If the class of the default value is not character, the value is converted
to the same class using the naive as.{class} function. E.g. conversions to
numeric are done with as.numeric().
These conversions are simple in nature and will not cover advanced cases, but we should try to keep our options this simple.
# Retrieve the verbosity level option set by default in zephyr:
get_option(name = "verbosity_level", .envir = "zephyr")
#> [1] "verbose"
# Try to retrieve an unset option, which will return the default value:
get_option(
name = "my_unset_option",
.envir = "mypkg",
default = "my_default_value"
)
#> [1] "my_default_value"