sink diverts R output to a connection (and stops such diversions).
sink.number() reports how many diversions are in use.
sink.number(type = "message") reports the number of the
connection currently being used for error messages.
1 2 3 4
a writable connection or a character string naming the
file to write to, or
character string. Either the output stream or the messages stream. The name will be partially matched so can be abbreviated.
sink diverts R output to a connection (and must be used again
to finish such a diversion, see below!). If
file is a
character string, a file connection with that name will be established
for the duration of the diversion.
Normal R output (to connection
stdout) is diverted by
type = "output". Only prompts and (most)
messages continue to appear on the console. Messages sent to
stderr() (including those from
stop) can be diverted by
sink(type = "message") (see below).
sink(file = NULL) ends the last diversion (of
the specified type). There is a stack of diversions for normal
output, so output reverts to the previous diversion (if there was
one). The stack is of up to 21 connections (20 diversions).
file is a connection it will be opened if necessary (in
"wt" mode) and closed once it is removed from the stack of
split = TRUE only splits R output (via
the default output from
writeLines: it does not split
all output that might be sent to
Sink-ing the messages stream should be done only with great care.
For that stream
file must be an already open connection, and
there is no stack of connections.
file is a character string, the file will be opened using
the current encoding. If you want a different encoding (e.g., to
represent strings which have been stored in UTF-8), use a
file connection — but some ways to produce R output
will already have converted such strings to the current encoding.
sink.number() the number (0, 1, 2, ...) of diversions of
output in place.
sink.number("message") the connection number used for
messages, 2 if no diversion has been used.
Do not use a connection that is open for
sink for any other
purpose. The software will stop you closing one such inadvertently.
Do not sink the messages stream unless you understand the source code implementing it and hence the pitfalls.
Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) The New S Language. Wadsworth & Brooks/Cole.
Chambers, J. M. (1998) Programming with Data. A Guide to the S Language. Springer.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
We want your feedback!
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.