R: Delete files, directories, or links

delete {fs} | R Documentation

## Delete files, directories, or links

### Description

`file_delete()` and `link_delete()` delete file and links. Compared to file.remove they always fail if they cannot delete the object rather than changing return value or signalling a warning. If any inputs are directories, they are passed to `dir_delete()`, so `file_delete()` can therefore be used to delete any filesystem object.

`dir_delete()` will first delete the contents of the directory, then remove the directory. Compared to unlink it will always throw an error if the directory cannot be deleted rather than being silent or signalling a warning.

### Usage

    file_delete(path)

    dir_delete(path)

    link_delete(path)

### Arguments

`path` | A character vector of one or more paths.

### Value

The deleted paths (invisibly).

### Examples

    # create a directory, with some files and a link to it
    dir_create("dir")
    files <- file_create(path("dir", letters[1:5]))
    link <- link_create(path_abs("dir"), "link")

    # All files created
    dir_exists("dir")
    file_exists(files)
    link_exists("link")
    file_exists(link_path("link"))

    # Delete a file
    file_delete(files[1])
    file_exists(files[1])

    # Delete the directory (which deletes the files as well)
    dir_delete("dir")
    file_exists(files)
    dir_exists("dir")

    # The link still exists, but what it points to does not.
    link_exists("link")
    dir_exists(link_path("link"))

    # Delete the link
    link_delete("link")
    link_exists("link")

[Package fs version 1.3.2 Index]