/
prefs.R
106 lines (97 loc) · 3.42 KB
/
prefs.R
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
#' Read Preference
#'
#' Reads a user preference, useful to remember preferences across different R
#' sessions for the same user.
#'
#' User preferences can have arbitrary names and values. You must write the
#' preference with \code{\link{writePreference}} before it can be read
#' (otherwise its default value will be returned).
#'
#' @param name The name of the preference.
#' @param default The default value to use when the preference is not
#' available.
#' @note The \code{readPreference} function was added in version 1.1.67 of
#' RStudio.
#' @seealso \code{\link{readRStudioPreference}}, which reads RStudio IDE
#' preferences.
#' @export readPreference
readPreference <- function(name, default) {
callFun("readPreference", name, default)
}
#' Write Preference
#'
#' Writes a user preference, useful to remember preferences across different R
#' sessions for the same user.
#'
#'
#' @param name The name of the preference.
#' @param value The value of the preference.
#' @note The \code{writePreference} function was added in version 1.1.67 of
#' RStudio.
#' @seealso \code{\link{writeRStudioPreference}}, which changes RStudio IDE
#' preferences.
#' @export writePreference
writePreference <- function(name, value) {
callFun("writePreference", name, value)
}
#' Write RStudio Preference
#'
#' Writes an internal RStudio IDE preference for the current user.
#'
#' RStudio IDE internal preferences include the values displayed in RStudio's
#' Global Options dialog as well as a number of additional settings. Set them
#' carefully; inappropriate values can cause unexpected behavior. See the
#' RStudio Server Professional Administration Guide appendix for your version
#' of RStudio for a full list of preference names and values.
#'
#' @param name The name of the preference.
#' @param value The value of the preference.
#' @note The \code{writeRStudioPreference} function was added in version
#' 1.3.387 of RStudio.
#' @seealso \code{\link{writePreference}}, which can be used to store arbitrary
#' user (non-RStudio) preferences.
#'
#' \code{\link{readRStudioPreference}}, which reads internal RStudio IDE
#' preferences.
#' @examples
#'
#' \dontrun{
#' # Hide RStudio's toolbar.
#' rstudioapi::writeRStudioPreference("toolbar_visible", FALSE)
#' }
#'
#'
#' @export writeRStudioPreference
writeRStudioPreference <- function(name, value) {
callFun("writeRStudioPreference", name, value)
}
#' Read RStudio Preference
#'
#' Reads an internal RStudio IDE preference for the current user.
#'
#' RStudio IDE internal preferences include the values displayed in RStudio's
#' Global Options dialog as well as a number of additional settings.
#'
#' @param name The name of the preference.
#' @param default The default value of the preference, returned if the
#' preference is not found.
#' @note The \code{readRStudioPreference} function was added in version 1.3.387
#' of RStudio.
#' @seealso \code{\link{readPreference}}, which can be used to read arbitrary
#' user (non-RStudio) preferences set with \code{\link{writePreference}}.
#'
#' \code{link{writeRStudioPreference}}, which can be used to write internal
#' RStudio IDE preferences.
#' @examples
#'
#' \dontrun{
#' # Get indentation settings
#' spaces <- rstudioapi::readRStudioPreference("num_spaces_for_tab", FALSE)
#' message("Using ", spaces, " per tab.")
#' }
#'
#'
#' @export readRStudioPreference
readRStudioPreference <- function(name, default) {
callFun("readRStudioPreference", name, default)
}