showConnections             package:base             R Documentation

_D_i_s_p_l_a_y _C_o_n_n_e_c_t_i_o_n_s

_D_e_s_c_r_i_p_t_i_o_n:

     Display aspects of connections.

_U_s_a_g_e:

     showConnections(all = FALSE)
     getConnection(what)
     closeAllConnections()

     stdin()
     stdout()
     stderr()

_A_r_g_u_m_e_n_t_s:

     all: logical: if true all connections, including closed ones and
          the standard ones are displayed.  If false only open
          user-created connections are included.

    what: integer: a row number of the table given by
          'showConnections'.

_D_e_t_a_i_l_s:

     'stdin()', 'stdout()' and 'stderr()' are standard connections
     corresponding to input, output and error on the console
     respectively (and not necessarily to file streams).  They are
     text-mode connections of class '"terminal"' which cannot be opened
     or closed, and are read-only, write-only and write-only
     respectively. The 'stdout()' and 'stderr()' connections can be
     re-directed by 'sink' (and in some circumstances the output from
     'stdout()' can be split: see the help page).

     The encoding for 'stdin()' when redirected can be set by the
     command-line flag '--encoding'.

     'showConnections' returns a matrix of information.  If a
     connection object has been lost or forgotten, 'getConnection' will
     take a row number from the table and return a connection object
     for that connection, which can be used to close the connection,
     for example.  However, if there is no R level object referring to
     the connection it will be closed automatically at the next garbage
     collection.

     'closeAllConnections' closes (and destroys) all user connections,
     restoring all 'sink' diversions as it does so.

_V_a_l_u_e:

     'stdin()', 'stdout()' and 'stderr()' return connection objects.

     'showConnections' returns a character matrix of information with a
     row for each connection, by default only for open non-standard
     connections.

     'getConnection' returns a connection object, or 'NULL'.

_N_o_t_e:

     'stdin()' refers to the 'console' and not to the C-level 'stdin'
     of the process.  The distinction matters in GUI consoles (which
     may not have an active 'stdin', and if they do it may not be
     connected to console input), and also in embedded applications. If
     you want access to the C-level file stream 'stdin', use
     'file("stdin")'.

     When R is reading a script from a file, the _file_ is the
     'console': this is traditional usage to allow in-line data (see
     'An Introduction to R' for an example).

_S_e_e _A_l_s_o:

     'connections'

_E_x_a_m_p_l_e_s:

     showConnections(all = TRUE)

     textConnection(letters)
     # oops, I forgot to record that one
     showConnections()
     #  class     description      mode text   isopen   can read can write
     #3 "letters" "textConnection" "r"  "text" "opened" "yes"    "no"     
     ## Not run: close(getConnection(3))

     showConnections()