curl_download {curl} | R Documentation

## Download file to disk

### Description

Libcurl implementation of `C_download` (the "internal" download method) with added support for https, ftps, gzip, etc. Default behavior is identical to `download.file`, but request can be fully configured by passing a custom `handle`.

### Usage

    curl_download(url, destfile, quiet = TRUE, mode = "wb",
      handle = new_handle())

### Arguments

`url` | A character string naming the URL of a resource to be downloaded.
`destfile` | A character string with the name where the downloaded file is saved. Tilde-expansion is performed.
`quiet` | If `TRUE`, suppress status messages (if any), and the progress bar.
`mode` | A character string specifying the mode with which to write the file. Useful values are `"w"`, `"wb"` (binary), `"a"` (append) and `"ab"`.
`handle` | a curl handle object

### Details

The main difference between `curl_download` and `curl_fetch_disk` is that `curl_download` checks the http status code before starting the download, and raises an error when status is non-successful. The behavior of `curl_fetch_disk` on the other hand is to proceed as normal and write the error page to disk in case of a non success response.

### Value

Path of downloaded file (invisibly).

### Examples

    ## Not run: download large file
    url <- "http://www2.census.gov/acs2011_5yr/pums/csv_pus.zip"
    tmp <- tempfile()
    curl_download(url, tmp)

    ## End(Not run)

[Package curl version 3.3 Index]