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'.

     '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.

     'closeAllConnections' closes (and destroys) all open 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'.

_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()

