The R Project SVN R

Rev

Rev 88581 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 88581 Rev 89309
Line 24... Line 24...
24 
#ifdef unix
 24 
#ifdef unix
25 
    If it is \code{"|cmd"}, the output is piped to the command given
 25 
    If it is \code{"|cmd"}, the output is piped to the command given
26 
    by \file{cmd}, by opening a pipe connection.
 26 
    by \file{cmd}, by opening a pipe connection.
27 
#endif
 27 
#endif
28 
  }
 28 
  }
29 
  \item{sep}{a character vector of strings to append after each element.}
 29 
  \item{sep}{a character vector of strings to append after each element,
- 
 
 30 
    except the last. Elements of \code{sep} are used in turn and recycled
- 
 
 31 
    as needed.}
30 
  \item{fill}{a logical or (positive) numeric controlling how the output is
 32 
  \item{fill}{a logical or (positive) numeric controlling how the output is
31 
    broken into successive lines.  If \code{FALSE} (default), only newlines
 33 
    broken into successive lines.  If \code{FALSE} (default), only newlines
32 
    created explicitly by \samp{"\\n"} are printed.  Otherwise, the
 34 
    created explicitly by \samp{"\\n"} are printed.  Otherwise, the
33 
    output is broken into lines with print width equal to the option
 35 
    output is broken into lines with print width equal to the option
34 
    \code{width} if \code{fill} is \code{TRUE}, or the value of
 36 
    \code{width} if \code{fill} is \code{TRUE}, or the value of
Line 46... Line 48...
46 
}
 48 
}
47 
\details{
 49 
\details{
48 
  \code{cat} is useful for producing output in user-defined functions.
 50 
  \code{cat} is useful for producing output in user-defined functions.
49 
  It converts its arguments to character vectors, concatenates
 51 
  It converts its arguments to character vectors, concatenates
50 
  them to a single character vector, appends the given \code{sep = }
 52 
  them to a single character vector, appends the given \code{sep = }
51 
  string(s) to each element and then outputs them.
 53 
  string(s) to each element, except the last, and then outputs them.
52 
 
 54 
 
53 
  No line feeds (aka \dQuote{newline}s) are output unless explicitly
 55 
  No line feeds (aka \dQuote{newline}s) are output unless explicitly
54 
  requested by \samp{"\\n"}
 56 
  requested by \samp{"\\n"}
55 
  or if generated by filling (if argument \code{fill} is \code{TRUE} or
 57 
  or if generated by filling (if argument \code{fill} is \code{TRUE} or
56 
  numeric).
 58 
  numeric).
Line 75... Line 77...
75 
  \code{"digits"} and \code{"scipen"} are relevant.  However, it uses
 77 
  \code{"digits"} and \code{"scipen"} are relevant.  However, it uses
76 
  the minimum field width necessary for each element, rather than the
 78 
  the minimum field width necessary for each element, rather than the
77 
  same field width for all elements.
 79 
  same field width for all elements.
78 
}
 80 
}
79 
\note{
 81 
\note{
80 
  If any element of \code{sep} contains a newline character, it is
 82 
  If any element of \code{sep} contains a newline character,
81 
  treated as a vector of terminators rather than separators, an element
 83 
  an element is
82 
  being output after every vector element \emph{and} a newline after the
 84 
  output after every vector element, and only a newline after the
83 
  last.  Entries are recycled as needed.
 85 
  last.  Entries are recycled as needed.
84 
}
 86 
}
85 
\value{
 87 
\value{
86 
  None (invisible \code{NULL}).
 88 
  None (invisible \code{NULL}).
87 
}
 89 
}