S3 read functions          package:foreign          R Documentation

_R_e_a_d _a_n _S_3 _B_i_n_a_r_y _o_r _d_a_t_a._d_u_m_p _F_i_l_e

_D_e_s_c_r_i_p_t_i_o_n:

     Reads binary data files or 'data.dump' files that were produced in
     S version 3.

_U_s_a_g_e:

       data.restore(file, print = FALSE, verbose = FALSE, env = .GlobalEnv)
       read.S(file)

_A_r_g_u_m_e_n_t_s:

    file: the filename of the S-PLUS 'data.dump' or binary file.

   print: whether to print the name of each object as read from the
          file.

 verbose: whether to print the name of every subitem within each
          object.

     env: environment within which to create the restored object(s).

_D_e_t_a_i_l_s:

     'read.S' can read the binary files produced in some older versions
     of S-PLUS on either Windows (versions 3.x, 4.x, 2000) or Unix
     (version 3.x with 4 byte integers).  It automatically detects
     whether the file was produced on a big- or little-endian machine
     and adapts itself accordingly.

     'data.restore' can read a similar range of files produced by
     'data.dump' and for newer versions of S-PLUS, those from
     'data.dump(....., oldStyle=TRUE)'.

     Not all S3 objects can be handled in the current version.  The
     most frequently encountered exceptions are functions and
     expressions; you will also have trouble with objects that contain
     model formulas.  In particular, comments will be lost from
     function bodies, and the argument lists of functions will often be
     changed.

_V_a_l_u_e:

     for 'read.S', an R version of the S3 object.

     for 'data.restore', the name of the file.

_A_u_t_h_o_r(_s):

     Duncan Murdoch

_E_x_a_m_p_l_e_s:

     ## Not run: 
     read.S(file.path("_Data", "myobj"))
     data.restore("dumpdata", print = TRUE)
     ## End(Not run)