file.copy
File and Directory Manipulation

Description

These functions provide file and directory manipulation from within Spotfire Enterprise Runtime for R. They can check for file existence; they can create, copy, rename, or remove files; and they can append to files and create directories.

Usage

file.create(..., showWarnings = TRUE)
file.exists(...)
file.remove(...)
file.rename(from, to)
file.append(file1, file2)
file.copy(from, to, overwrite = recursive, recursive = FALSE,
          copy.mode = TRUE, copy.date = FALSE)
file.symlink(from, to)
file.link(from, to)
dir.create(path, showWarnings = TRUE, recursive = FALSE, mode = "0777")
dir.exists(paths)
Sys.readlink(paths)

Arguments

..., from, to, file1, file2 character vectors containing file names. The ... arguments are concatenated to form one vector of character values.
showWarnings a logical value. If TRUE (the default), then warnings on file or directory creation are displayed.
overwrite a logical value. If TRUE, then the destination file(s) are overwritten if they exist. By default, FALSE.
recursive a logical value. If TRUE, then all elements in path are created if they do not already exist. By default, FALSE.
copy.mode a logical value. If TRUE (the default), then destination file(s) are given the same file mode as the sources.
copy.date a logical value. If TRUE, then destination file(s) are given the same file modification date as the sources. By default, FALSE.
path a character vector giving a single path name.
paths a character vector giving any number of path names.
mode a character vector. Sets the access limits on a directory or file.

Details

file.create creates files with the specified names. If the file already exists, it is truncated to length zero.
file.exists returns a logical vector the length of the combined arguments that is TRUE for each file that exists. For any file that does not exist, FALSE. This function can be applied to a folder.
dir.exists(paths) returns a logical vector the length of its paths argument. This vector contains TRUE for each path that exists and is a directory (folder). Otherwise, it contains FALSE.
file.remove removes the specified files.
file.rename renames the specified files given for from to the names given for to. This function can be applied on a folder.
file.append appends the contents of the files given for file2 to the files given for file1.
file.copy copies the files given for from to the names given for to. The to argument can specify a single existing directory.
file.symlink creates symbolic links on Unix-like platforms, which are not supported on the Windows platform. The specified to can be a file name or an existing directory.
file.link creates links on Unix-like platforms or hard links on Windows NTFS platform.
dir.create creates the single directory, unless recursive is TRUE, in which case all necessary directories specified for path are created. If the specified path exists, and showWarnings is TRUE, a warning message is displayed.
Sys.readlink for each character string in paths, return one of the following:
- If the string specifies a symbolic link, then return the name of the file linked to.
- If the string specifies an ordinary file or directory, then return an empty string.
- If the string specifies a nonexistent file or directory, then return NA.
Symbolic links are not supported on Windows. In that case, this function returns an empty string for each input string.
Value
returns a logical vector the length of the combined arguments. TRUE indicates a successful operation for that element.
Side Effects
Files or directories are created, removed, copied, or appended to.
See Also
file.access, file.show, basename, unlink.
Examples
tfile1 <- tempfile("a")
tfile2 <- tempfile("b")
tfile3 <- tempfile("c")
cat("This is file 1\n", file=tfile1)
cat("This is file 2\n", file=tfile2)
file.append(tfile1, tfile2)
file.copy(tfile1, tfile3)
file.remove(tfile1)

file.exists(tfile1) tdir <- tempfile("d") dir.create(tdir) file.copy(c(tfile2, tfile3), tdir) list.files(tdir)

file.create(file.path(tdir, c("tfile4", "tfile5"))) file.rename(file.path(tdir, c("tfile4", "tfile5")), file.path(tdir, c("tfile6", "tfile7"))) list.files(tdir)

# Clean up: unlink(c(tfile1, tfile2, tfile3, tdir))

Package base version 6.1.4-13
Package Index