Classes with Reference Semantics

The R6 package allows the creation of classes with reference semantics, similar to R's built-in reference classes. Compared to reference classes, R6 classes are simpler and lighter-weight, and they are not built on S4 classes so they do not require the methods package. These classes allow public and private members, and they support inheritance, even when the classes are defined in different packages.


This package contains an implemention of classes with reference semantics, and it is a simpler, faster, lighter-weight alternative to R's built-in reference classes.

Additionally, these classes are not built on S4 classes, so they do not require the methods package. They allow public and private members, and they support inheritance. Unlike reference classes, R6 classes can be cleanly inherited across different packages, when used in portable mode (enabled by default).

Why the name R6? When R's reference classes were introduced, some users, following the names of R's existing class systems S3 and S4, called the new class system R5 in jest. Although reference classes are not actually called R5, the name of this package and its classes takes inspiration from that name.

The name R5 was also a code-name used for a different object system started by Simon Urbanek, meant to solve some issues with S4 relating to syntax and performance. However, the R5 branch was shelved after a little development, and it was never released.

To install R6 from CRAN:

install.packages('R6')

To install the development version (requires the devtools package):

devtools::install_github('wch/R6', build_vignettes = FALSE)

News

R6 2.2.0

  • Classes can define finalizers explicitly, by defining a public finalize method. (#92, #93)

  • Added function is.R6() and is.R6Class(). (#95)

  • Fixed #96: R6 now avoids using $ and [[ after the class has been assigned to the object. This allows the user to provide their own methods for $ and [[ without causing problems to R6's operation.

R6 2.1.3

  • The plot S3 method for R6 objects will call $plot on the object if present. (#77)

  • Fixed priting of members that are R6 objects. (#88)

  • Fixed deep cloning for non-portable classes. (#85)

  • Added as.list.R6 method. (#91)

R6 2.1.2

  • Implemented format.R6() and format.R6ClassGenerator, the former calls a public format method if defined. This might change the functionality of existing classes that define a public format method intended for other purposes (#73. Thanks to Kirill Müller)

  • Functions are shown with their interface in print and format, limited to one line (#76. Thanks to Kirill Müller)

  • R6 objects and generators print out which class they inherit from. (#67)

R6 2.1.1

  • Fixed a bug with printing R6 objects when a [[ method is defined for the class. (#70)

  • Fixed cloning of objects that call a super method which accesses private. (#72)

R6 2.1.0

  • Added support for making clones of R6 objects with a clone() method on R6 objects. The deep=TRUE option allows for making clones that have copies of fields with reference semantics (like other R6 objects). (#27)

  • Allow adding public or private members when there were no public or private members to begin with. (#51)

  • Previously, when an R6 object was printed, it accessed (and called) active bindings. Now it simply reports that a field is an active binding. (#37, #38. Thanks to Oscar de Lama)

  • Printing private members now works correctly for portable R6 objects. (#26)

  • The 'lock' argument has been renamed to 'lock_objects'. Also, there is a new argument, 'lock_class', which can prevent changes to the class. (#52)

  • Fixed printing of NULL fields.

R6 2.0.1

  • A superclass is validated on object instantation, not on class creation.

  • Added debug and undebug methods to generator object.

R6 2.0

  • [BREAKING CHANGE] Added portable option, which allows inheritance across different package namespaces, and made it the default.

  • Added set() method on class generator object, so new fields and methods can be added after the generator has been created.

  • All of the functions involved in instantiating objects are encapsulated in an environment separate from the R6 namespace. This means that if a generator is created with one version of R6, saved, then restored in a new R session that has a different version of R6, there shouldn't be any problems with compatibility.

  • Methods are locked so that they can't be changed. (Fixes #19)

  • Inheritance of superclasses is dynamic; instead of reading in the superclass when a class is created, this happens each time an object is instantiated. (Fixes #12)

  • Added trailing newline when printing R6 objects. (Thanks to Gabor Csardi)

  • The print method of R6 objects can be redefined. (Thanks to Gabor Csardi)

R6 1.0.1

  • First release on CRAN.

  • Removed pryr from suggested packages.

R6 1.0

  • First release

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.