S-PLUS read functions {Rstreams}R Documentation

Read an S-PLUS Binary File

Description

Reads binary data files or data.dump files that were produced in S-PLUS.

Usage

  data.restore(filename, print = FALSE, verbose = FALSE)
  readSfile(filename, swapbytes = FALSE)

  SModeNames

Arguments

filename the filename of the S-PLUS data.dump or binary file.
swapbytes whether to change big to little-endian or vice versa.
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.

Details

These functions were produced to test and demonstrate the stream functions in Rstreams. readSfile can read the binary files produced in recent 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.

Not all S-PLUS objects can be handled in the current version. The most frequently encountered exceptions are functions and expressions; you'll 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.

The SModeNames variable contains a list of the modes of variables as used in S-PLUS.

Value

an R version of the S-PLUS object.

Author(s)

Duncan Murdoch

See Also

openstream, data.restore.

Examples

pkgdir <- searchpaths()[match("package:Rstreams", search())]
readSfile(file.path(pkgdir, "example", "_Data", "myobj"))
data.restore(file.path(pkgdir, "example", "dumpdata"), print = TRUE)
myobj