The R Project SVN R

\name{write.table}
\alias{write.table}
\title{Data Output}
\description{
  \code{write.table} prints its required argument \code{x} (after
  converting it to a data frame if it is not one already) to
  \code{file}.  The entries in each line (row) are separated by the
  value of \code{sep}.
}
\usage{
write.table(x, file = "", append = FALSE, quote = TRUE, sep = " ",
            eol = "\n", na = "NA", dec = ".", row.names = TRUE,
        col.names = TRUE)
}
\arguments{
  \item{x}{the object to be written, typically a data frame.  If not, it
    is attempted to create one from it.}
  \item{file}{the name of the file which the data are to be written to.}
  \item{sep}{the field separator string.  Values on each line of the file
    are separated by this string.} 
  \item{col.names}{a logical value indicating whether the column names
    of \code{x} are to be written along with \code{x}, or a character
    vector of column names to be written.}
  \item{row.names}{a logical value indicating whether the row names of
    \code{x} are to be written along with \code{x}, or a character
    vector of row names to be written.}
  \item{quote}{a logical or a numeric vector.  If \code{TRUE}, any
    strings in the data will be surrounded by double quotes.  If a
    numeric vector, its elements are taken as the indices of the
    variable (columns) to quote.  In both cases, row and columns names
    are always quoted if they are written.} 
  \item{dec}{the string to use for decimal points}
  \item{na}{the string to use for missing values in the data.}
  \item{eol}{the character(s) to print at the end of each line (row).}
}
\details{
  Normally there is no column name for a column of row names
  If \code{col.names=NA} a blank column name is added. This can be
  used to write CSV files for input to spreadsheets.
}
\seealso{
  \code{\link{read.table}}.
}
\example{
\dontrun{
## To write a CSV file for input to Excel one might use
write.table(x, file="foo.csv", sep=",", col.names=NA)
## and to read this file back into R one needs
read.table("file.csv", header=TRUE, sep=",", row.names=1)
}}
\keyword{print}
\keyword{file}