Package 'csv'

Read or Write CSV Using Selected Conventions

Description

Reads or writes CSV files in a conventional way. Generic, with methods for character and data.frame. A length-one character argument is treated as a filepath and tries to return a data.frame. A data.frame argument is written to the specified filepath. Typically, quote and row.names are FALSE and na is ".". When reading, white space and empty strings are treated as NA, and strip.white is TRUE. When writing, values with commas or double-quotes are double-quoted (and embedded double-quotes are doubled).

Usage

as.csv(x, ...)

Arguments

x	object
...	passed arguments

See Also

as.csv.character, as.csv.data.frame

Other as.csv: as.csv.character(), as.csv.data.frame()

Examples

data <- head(Theoph)
filepath <- file.path(tempdir(),'theoph.csv')
as.csv(data,filepath)
as.csv(filepath)

---

Treat Character as CSV filename.

Description

Treat a character string as a CSV filename.

Usage

## S3 method for class 'character'
as.csv(
  x,
  as.is = TRUE,
  na.strings = c("", "\\s", ".", "NA"),
  strip.white = TRUE,
  check.names = FALSE,
  source = getOption("csv_source", TRUE),
  ...
)

Arguments

x	character file path
as.is	passed to read.csv
na.strings	passed to read.csv
strip.white	passed to read.csv
check.names	passed to read.csv
source	whether to assign x as the source attribute of the return value
...	passed to read.csv if accepted by read.table

Details

If x is character, is length one, and is a path to a file, an attempt is made to read the file.

Value

data.frame, with attribute 'source' set to x

See Also

Other as.csv: as.csv.data.frame(), as.csv()

---

Save a Data Frame as CSV.

Description

Saves a data.frame as CSV, using selected conventions.

Usage

## S3 method for class 'data.frame'
as.csv(x, file, na = ".", quote = FALSE, auto = !quote, row.names = FALSE, ...)

Arguments

x	data.frame
file	passed to write.csv
na	passed to write.csv
quote	passed to write.csv
auto	double-quote column names and row values with embedded commas or double-quotes; the latter are escaped by doubling them
row.names	passed to write.csv
...	passed to write.csv if accepted by write.table

Value

invisible data.frame (x)

See Also

Other as.csv: as.csv.character(), as.csv()

Examples

x <- data.frame(
  check.names = FALSE,
  stringsAsFactors = TRUE,
  person = 1:3, 
  `name, suffix` = c("Bill Smith", 'Joseph "Joe" Hancock', "Mary Laguire, DDS")
)
file <- tempfile()
as.csv(x,file)
y <- as.csv(file,as.is=FALSE)
attr(y,'source')
attr(y,'source') <- NULL
x
y
stopifnot(identical(x,y))

---