browseURL
Displays the contents of a URL in a Web Browser
Description
Displays in a web browser the contents found at a URL or the contents
of a file or folder.
Usage
browseURL(url, browser = getOption("browser"), encodeIfNeeded = FALSE)
Arguments
| url |
a character string. Usually it is a file path or a URL. Cannot be
empty.
|
| browser |
the browser location. Must be either a character string, a function,
or (on Windows only) NULL.
|
| encodeIfNeeded |
a logical flag: If TRUE, encode url. The default is FALSE.
|
Details
Opens the specified browser or the default browser and displays the specified
URL.
- If browser is a function, it is called by browseURL, and
url is passed as an argument to the function.
- If browser is a populated character string, it is treated as the
path to the browser executable and is started by the system function,
passing url on the command line.
- If browser is NULL, the operating sytem launches
the default browser to display url. (This option is supported only
on Windows systems.)
Value
- If browser is a function, browseURL invisibly returns
the function's result.
- if browser is a character string, browseURL returns
0 if the command ran successfully.
- if browser is a character string, browseURL returns
1 if the command failed to run.
- If browser is NULL, browseURL returns NULL.
Differences between Spotfire Enterprise Runtime for R and Open-source R
In open-source R, when browser is not NULL, the
function "browseURL" fails to run.
See Also
Examples
## Not run:
browseURL("http://www.tibco.com/")
browseURL("http://www.tibco.com/", encodeIfNeeded=TRUE)
tfile <- tempfile()
cat("Example from browseURL help file\n", file=tfile)
ret <- browseURL(paste0("file://", tfile))
ret
## 0
## End(Not run)