rio (version 0.4.8)

convert: Convert from one file format to another

Description

This function constructs a data frame from a data file using codeimport 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

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. The app is featured in the RStudio Shiny Gallery.

Examples

# create a file to convert
export(iris, "iris.dta")

# convert Stata to CSV and open converted file
convert("iris.dta", "iris.csv")
head(import("iris.csv"))

# correct an erroneous file format
export(iris, "iris.csv", format = "tsv")
convert("iris.csv", "iris.csv", in_opts = list(format = "tsv"))

# convert serialized R data.frame to JSON
export(iris, "iris.rds")
convert("iris.rds", "iris.json")

# cleanup
unlink("iris.csv")
unlink("iris.dta")
unlink("iris.rds")
unlink("iris.json")

## Not run: 
# # convert from the command line:
# Rscript -e "rio::convert('iris.dta', 'iris.csv')"
# ## End(Not run)