choose.files {utils}R Documentation

Choose a List of Files Interactively

Description

Use a Windows file dialog to choose a list of zero or more files interactively.

Usage

choose.files(default = "", caption = "Select files",
             multi = TRUE, filters = Filters,
             index = nrow(Filters))

Filters

choose.dir(default = "", caption = "Select folder")

Arguments

default which filename to show initially
caption the caption on the file selection dialog
multi whether to allow multiple files to be selected
filters a matrix of filename filters (see Details)
index which row of filters to use by default

Details

Unlike file.choose, choose.files will always attempt to return a character vector giving a list of files. If the user cancels the dialog, then zero files are returned, whereas file.choose would signal an error. choose.dir chooses a directory.

Windows file dialog boxes include a list of “filters”, which allow the file selection to be limited to files of specific types. The filters argument to choose.files allows the list of filters to be set. It should be an n by 2 character matrix. The first column gives, for each filter, the description the user will see, while the second column gives the mask(s) to select those files. If more than one mask is used, separate them by semicolons, with no spaces. The index argument chooses which filter will be used initially.

Filters is a matrix giving the descriptions and masks for the file types that R knows about. Print it to see typical formats for filter specifications. The examples below show how particular filters may be selected.

If you would like to display files in a particular directory, give a fully qualified file mask (e.g., 'c:\\*.*') in the default argument. If a directory is not given, the dialog will start in the current directory the first time, and “remember” the last directory on subsequent invocations.

Value

For choose.files, a character vector giving zero or more file paths.
For choose.dir, a character string, NA if ‘Cancel’ was selected.

See Also

file.choose

Examples

  if (interactive()) 
        choose.files(filters = Filters[c("zip", "All"),])

  if (interactive()) 
        choose.dir(getwd(), "Choose a suitable folder")

[Package utils version 2.4.1 Index]