serialize                package:base                R Documentation

_S_i_m_p_l_e _S_e_r_i_a_l_i_z_a_t_i_o_n _I_n_t_e_r_f_a_c_e

_D_e_s_c_r_i_p_t_i_o_n:

     A simple low level interface for serializing to connections.

_U_s_a_g_e:

     serialize(object, connection, ascii = FALSE, refhook = NULL)
     unserialize(connection, refhook = NULL)
     .saveRDS(object, file = "", ascii = FALSE, version = NULL,
              compress = FALSE, refhook = NULL)
     .readRDS(file, refhook = NULL)

_A_r_g_u_m_e_n_t_s:

  object: R object to serialize.

    file: a connection or the name of the file where the R object is
          saved to or read from, or 'NULL' for 'serialize' (see
          details).

   ascii: a logical.  If 'TRUE', an ASCII representation is written;
          otherwise (default), a more compact binary one is used.

 version: the workspace format version to use.  'NULL' specifies the
          current default format.  The version used from R 0.99.0 to R
          1.3.1 was version 1.  The default format as from R 1.4.0 is
          version 2.

compress: a logical specifying whether saving to a named file is to use
          compression.  Ignored when 'file' is a connection and for
          workspace format version 1.

connection: an open connection.

 refhook: a hook function for handling reference objects.

_D_e_t_a_i_l_s:

     The function 'serialize' writes 'object' to the specified
     connection.  Sharing of reference objects is preserved within the
     object but not across separate calls to serialize.  If
     'connection' is 'NULL' then 'object' is serialized to a scalar
     string, which is returned as the result of 'serialize'. For a text
     mode connection, the default value of 'ascii' is set to 'TRUE'.

     'unserialize' reads an object from 'connection'. 'connection' may
     also be a scalar string.

     The 'refhook' functions can be used to customize handling of
     non-system reference objects (all external pointers and weak
     references, and all environments other than name space and package
     environments and '.GlobalEnv').  The hook function for 'serialize'
     should return a character vector for references it wants to
     handle; otherwise it should return 'NULL'.  The hook for
     'unserialize' will be called with character vectors supplied to
     'serialize' and should return an appropriate object.

_V_a_l_u_e:

     For 'serialize', 'NULL' unless 'connection=NULL', when the result
     is stored in the first element of a character vector (but is not a
     normal character string unless 'ascii = TRUE' and should not be
     processed except by 'unserialize').

     For 'unserialize' and '.readRDS', an R object.

     For '.saveRDS', 'NULL' invisibly.

_W_a_r_n_i_n_g:

     These functions are still experimental.  Both names, interfaces
     and values might change in future versions.  '.saveRDS' and
     '.readRDS' are intended for internal use.

_E_x_a_m_p_l_e_s:

     x <- serialize(list(1,2,3), NULL)
     unserialize(x)

