rawConnection              package:base              R Documentation

_R_a_w _C_o_n_n_e_c_t_i_o_n_s

_D_e_s_c_r_i_p_t_i_o_n:

     Input and output raw connections.

_U_s_a_g_e:

     rawConnection(object, open = "r")

     rawConnectionValue(con)

_A_r_g_u_m_e_n_t_s:

  object: character or raw vector.  A description of the connection. 
          For an input this is an R raw vector object, and for an
          output connection the name for the connection. 

    open: character.  Any of the standard connection open modes.

     con: An output raw connection.

_D_e_t_a_i_l_s:

     An input raw connection is opened and the raw vector is copied at
     the time the connection object is created, and 'close' destroys
     the copy.

     An output raw connection is opened and creates an R raw vector
     internally.  The raw vector can be retrieved _via_ 
     'rawConnectionValue'.

     If a connection is open for both input and output the initial raw
     vector supplied is copied when the connections is open

_V_a_l_u_e:

     For 'rawConnection', a connection object of class
     '"rawConnection"' which inherits from class '"connection"'.

     For 'rawConnectionValue', a raw vector.

_N_o_t_e:

     As output raw connections keep the internal raw vector up to date
     call-by-call, they are relatively expensive to use (although
     over-allocation is used), and it may be better to use an anonymous
     'file()' connection to collect output.

     On (rare) platforms where 'vsnprintf' does not return the needed
     length of output there is a 100,000 character limit on the length
     of line for output connections: longer lines will be truncated
     with a warning.

_S_e_e _A_l_s_o:

     'connections', 'showConnections'.

_E_x_a_m_p_l_e_s:

     zz <- rawConnection(raw(0), "r+") # start with empty raw vector
     writeBin(LETTERS, zz)
     seek(zz, 0)
     readLines(zz) # raw vector has embedded nuls
     seek(zz, 0)
     writeBin(letters[1:3], zz)
     rawConnectionValue(zz)
     close(zz)

