ID EN
Environment & Scope

Sys.glob

R Base 3.6.2

Function to do wildcard expansion (also known as ‘globbing’) on file paths.

Syntax

R
Sys.glob(paths, dirmark = FALSE)

Arguments

Parameter Description
paths character vector of patterns for relative or absolute filepaths. Missing values will be ignored.
dirmark logical: should matches to directories from patterns that do not already end in / or \ have a slash appended? May not be supported on all platforms.

Return Value

A character vector of matched file paths. The order is system-specific (but in the order of the elements of paths): it is normally collated in either the current locale or in byte (ASCII) order; however, on Windows collation is in the order of Unicode points. Directory errors are normally ignored, so the matches are to accessible file paths (but not necessarily accessible files).

Details

This expands wildcards in file paths. For precise details, see your system's documentation on the glob system call. There is a POSIX 1003.2 standard (see http://pubs.opengroup.org/onlinepubs/9699919799/functions/glob.html) but some OSes will go beyond this. The R implementation will always do tilde expansion. All systems should interpret * (match zero or more characters), ? (match a single character) and (probably) [ (begin a character class or range). The handling of paths ending with a separator is system-dependent. On a POSIX-2008 compliant OS they will match directories (only), but as they are not valid filepaths on Windows, they match nothing there. (Earlier POSIX standards allowed them to match files.) The rest of these details are indicative (and based on the POSIX standard). If a f

Examples

Example
R
# NOT RUN {
Sys.glob(file.path(R.home(), "library", "*", "R", "*.rdx"))
# }

See Also

path.expand. Quotes for handling backslashes in character strings.