These functions are currently experimental and will change in the future. Note that processx connections are not compatible with R's built-in connection system.
conn_create_pipepair() creates a pair of connected connections, the
first one is writeable, the second one is readable.
conn_read_chars() reads UTF-8 characters from the connections. If the
connection itself is not UTF-8 encoded, it re-encodes it.
conn_read_lines() reads lines from a connection.
FALSE if the connection surely has no
conn_write() writes a character or raw vector to the connection.
It might not be able to write all bytes into the connection, in which
case it returns the leftover bytes in a raw vector. Call
again with this raw vector.
conn_create_file() creates a connection to a file.
conn_set_stdout() set the standard output of the R process, to the
conn_set_stderr() set the standard error of the R process, to the
conn_get_fileno() return the integer file desciptor that belongs to
The function is best effort to close the handles, it might still leave
some handles open. It should work for
conn_create_fd(fd, encoding = "", close = TRUE) conn_create_pipepair(encoding = "") conn_read_chars(con, n = -1) # S3 method for processx_connection conn_read_chars(con, n = -1) conn_read_lines(con, n = -1) # S3 method for processx_connection conn_read_lines(con, n = -1) conn_is_incomplete(con) # S3 method for processx_connection conn_is_incomplete(con) conn_write(con, str, sep = "\n", encoding = "") # S3 method for processx_connection conn_write(con, str, sep = "\n", encoding = "") conn_create_file(filename, read = NULL, write = NULL) conn_set_stdout(con, drop = TRUE) conn_set_stderr(con, drop = TRUE) conn_get_fileno(con) conn_disable_inheritance()
Integer scalar, a Unix file descriptor.
Encoding of the readable connection when reading.
Whether to close the OS file descriptor when closing
the connection. Sometimes you want to leave it open, and use it again
Processx connection object.
Number of characters or lines to read. -1 means all available characters or lines.
Character or raw vector to write.
Separator to use if
Whether the connection is readable.
Whethe the connection is writeable.
Whether to close the original stdout/stderr, or keep it open and return a connection to it.
conn_create_fd() creates a connection from a file descriptor.