Type: Package
Title: Read and Write CSV Files with Selected Conventions
Version: 0.6.2
Author: Tim Bergsma
Maintainer: Tim Bergsma <bergsmat@gmail.com>
Description: Reads and writes CSV with selected conventions. Uses the same generic function for reading and writing to promote consistent formats.
License: GPL-3
Imports: data.table, stringi
RoxygenNote: 7.1.1
NeedsCompilation: no
Packaged: 2022-07-04 17:52:30 UTC; tim.bergsma
Repository: CRAN
Date/Publication: 2022-07-04 18:20:02 UTC

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))

Autoquote

Description

Autoquote. Generic, with default, character, and factor methods.

Usage

autoquote(x, ...)

Arguments

x

object

...

passed arguments

See Also

Other autoquote: autoquote.character(), autoquote.default(), autoquote.factor()

Autoquote Character

Description

Autoquote character. Quotes elements with commas or double quotes; the latter are doubled.

Usage

## S3 method for class 'character'
autoquote(x, ...)

Arguments

x

object

...

passed arguments

See Also

Other autoquote: autoquote.default(), autoquote.factor(), autoquote()

Autoquote Default

Description

Autoquote default. Returns its argument.

Usage

## Default S3 method:
autoquote(x, ...)

Arguments

x

object

...

passed arguments

See Also

Other autoquote: autoquote.character(), autoquote.factor(), autoquote()

Autoquote Factor

Description

Autoquote character. Quotes levels with commas or double quotes; the latter are doubled.

Usage

## S3 method for class 'factor'
autoquote(x, ...)

Arguments

x

object

...

passed arguments

See Also

Other autoquote: autoquote.character(), autoquote.default(), autoquote()