[Rd] S4 object type available for testing

From: John Chambers <jmc_at_r-project.org>
Date: Mon 03 Jul 2006 - 15:14:21 GMT

The default prototype object for an S4 class up to now has been a zero-length list (nothing else worked). This is wrong in principle, because it makes the objects look like vectors to low-level C code, and they should not. It may also be the cause of some inefficiency.

A new low-level type has been added for these classes. It's currently available in the r-devel version, but not turned on by default. If you have code that makes use of S4 objects, or C-level code that tries to handle all internal types, please try to test out the new feature.

To turn the feature on, set environment variable R_S4_Type to anything non-empty, for example in bash

$ export R_S4_Type=TRUE

before starting up R. You can also turn the new type on and off in R by calling methods:::.useS4Prototype(TRUE) or FALSE. (This is a temporary situation, eventually the type will be made the default.)

Note the following points.

  1. The type affects the prototype object for the class. Therefore what matters is whether it's turned on when the call to setClass() takes place. It has NO effect on objects generated from an existing class. And turning the type off has no effect until a new setClass() call.
  2. Classes that contain any of the basic R object types ("character", "function", etc.) are unaffected by the change. Their prototype objects will still have the inherited basic type, as they should.
  3. To see what the current prototype is, use defaultPrototype(). If the new type is on you should see:

> defaultPrototype()

<S4 Type Object>

4. Not directly related, but some changes have been made to make automatic printing of S4 objects correspond more closely to a call to show(), as per the green book.


R-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel Received on Tue Jul 04 01:18:17 2006

Archive maintained by Robert King, hosted by the discipline of statistics at the University of Newcastle, Australia.
Archive generated by hypermail 2.1.8, at Tue 08 Aug 2006 - 14:29:16 GMT.

Mailing list information is available at https://stat.ethz.ch/mailman/listinfo/r-help. Please read the posting guide before posting to the list.