rio (version 0.5.29)

convert: Convert from one file format to another

Description

This function constructs a data frame from a data file using import and uses export to write the data to disk in the format indicated by the file extension.

Usage

convert(in_file, out_file, in_opts = list(), out_opts = list())

Arguments

in_file

A character string naming an input file.

out_file

A character string naming an output file.

in_opts

A named list of options to be passed to import.

out_opts

A named list of options to be passed to export.

Value

A character string containing the name of the output file (invisibly).

See Also

Luca Braglia has created a Shiny app called rioweb that provides access to the file conversion features of rio through a web browser.

Examples

Run this code
# NOT RUN {
# create a file to convert
export(mtcars, dta_file <- tempfile(fileext = ".dta"))

# convert Stata to CSV and open converted file
convert(dta_file, csv_file <- tempfile(fileext = ".csv"))
head(import(csv_file))

# correct an erroneous file format
export(mtcars, csv_file2 <- tempfile(fileext = ".csv"), format = "tsv")
convert(csv_file2, csv_file, in_opts = list(format = "tsv"))

# convert serialized R data.frame to JSON
export(mtcars, rds_file <- tempfile(fileext = ".rds"))
convert(rds_file, json_file <- tempfile(fileext = ".json"))

# cleanup
unlink(csv_file)
unlink(csv_file2)
unlink(rds_file)
unlink(dta_file)
unlink(json_file)

# }
# NOT RUN {
\donttest{
# convert from the command line:
## Rscript -e "rio::convert('mtcars.dta', 'mtcars.csv')"
}
# }
# NOT RUN {
# }

Run the code above in your browser using DataCamp Workspace